Skip to content

Migration: v0.9 → v0.10

v0.10 is the Semantic Workspace release: incremental indexing, multi-root LSP workspaces, a stable ontocore::Workspace API, semantic diff (CLI + LSP + VS Code panel), and optional disk cache.

Highlights

Feature Notes
Incremental index LSP reindex reuses unchanged documents by content hash
Multi-root workspaces All VS Code workspace folders are indexed; path jail accepts any registered root
Stable Workspace API open_with_options, reindex_incremental, import_graph, diff, stats
Semantic diff ontocore diff, ontocore/semanticDiff, React Semantic Diff panel
Disk cache Optional .ontocore/cache/ via WorkspaceOptions::disk_cache or ontocode.indexCache

Rust library users

ontocore = "0.10"
ontocore-diff = "0.10"

use ontocore::{Workspace, WorkspaceOptions};
use ontocore::diff::{diff_git_refs, format_diff_markdown};

let ws = Workspace::open_with_options(
    WorkspaceOptions::single("./ontologies").with_disk_cache(true),
)?;
let stats = ws.stats();
let diff = ws.diff_against_path("./other")?;

CLI

ontocore diff main..feature
ontocore diff --format markdown --breaking-only HEAD..WORKTREE
ontocore diff --left-ref ./a --right-ref ./b

LSP

  • New method: ontocore/semanticDiff (alias ontocore/getSemanticDiff)
  • ontocore/indexWorkspace accepts disk_cache: boolean
  • Workspace folder add/remove triggers reindex (workspace/didChangeWorkspaceFolders)

VS Code extension

  • Command OntoCode: Semantic Diff…
  • Setting ontocode.indexCache enables persistent parse cache
  • Multi-root workspaces are fully supported (remove single-folder workarounds)

Breaking changes

  • ontocore::Workspace is stable in v0.10 (experimental banner removed); pre-1.0 policy still applies to other crates until v1.0.
  • Bump all ontocore-* dependencies to 0.10.0 together.