Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Main reset: post-stable v0.12.0 (#1837)

inkeep-internal-ci[bot]85696da841b1
diff --git a/.changeset/calmer-auto-sync-warning.md b/.changeset/calmer-auto-sync-warning.md
deleted file mode 100644
index 5a1ef7e90..000000000
--- a/.changeset/calmer-auto-sync-warning.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Soften the git auto-sync enable warning. The dialog shown before turning on auto-sync (onboarding and the settings/badge toggle) previously presented its caveats as an amber alert box with a bulleted "Before you enable it" list — alarming for what is a routine, reversible choice. It now reads as a calm "Heads up" section: three titled rows (Uncommitted changes, Commits happen automatically, Shared repositories), each with an icon and a short muted description. Same information, friendlier delivery; screen readers also no longer treat it as an interruption-priority alert.
diff --git a/.changeset/cascade-editor-windows.md b/.changeset/cascade-editor-windows.md
deleted file mode 100644
index adb3a2df2..000000000
--- a/.changeset/cascade-editor-windows.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Cascade new editor windows instead of stacking them dead-center. Electron centers every window that has no explicit position, so opening several projects — most visibly the post-update relaunch, which restores every previously open project at once — produced one indistinguishable pile of windows. Each new editor window now opens offset down-right from the focused (or most recently opened) window, macOS-document-app style, wrapping back to the top-left of the work area when it would run off the screen edge. The first window of a session still opens centered.
diff --git a/.changeset/desktop-silent-path-install-restored.md b/.changeset/desktop-silent-path-install-restored.md
deleted file mode 100644
index 1ef6c449e..000000000
--- a/.changeset/desktop-silent-path-install-restored.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Open Knowledge Desktop again puts the `ok` command on your PATH automatically — politely. Launching the packaged app installs silent terminal shims (`~/.ok/bin/ok` and `~/.ok/bin/open-knowledge` symlinks into the app bundle, a `~/.ok/env.sh` PATH shim, and a clearly marked managed block in your shell rc files — `.zshrc`, plus `.bash_profile` and fish config where present) with no admin prompt. Any user who has run Desktop at least once can type `ok` in a new terminal.
-
-Good-manners guarantees: the edit is disclosed in-app via a sticky toast that names the exact file(s) touched; the block is padded with blank lines and carries an inline opt-out hint; and deleting the block from an rc file is honored permanently — Open Knowledge records the opt-out and never re-adds it to that file. The `~/.ok/bin` shims themselves still self-heal on every startup, and `OK_RECLAIM_DISABLE=1` disables the whole mechanism.
-
-Unlike the earlier incarnation of this feature, Desktop no longer seeds `ok` symlinks into other writable PATH directories (`~/.cargo/bin`, `~/.local/bin`, and the like) to make the command visible in already-open shells — that surprised users more than it helped. Startup now cleans up the symlinks earlier builds recorded, removing each one only while it still points at the recorded bundle target; anything re-pointed or foreign is left alone. The `/usr/local/bin` admin-prompt installer remains retired.
diff --git a/.changeset/divergent-fallback-settlement-rederive.md b/.changeset/divergent-fallback-settlement-rederive.md
deleted file mode 100644
index 6c78e0752..000000000
--- a/.changeset/divergent-fallback-settlement-rederive.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-server": patch
----
-
-Divergent degraded-fallback content no longer overwrites the source bytes it stands for on WYSIWYG interaction. When a parse-error fallback block's editor content diverges from its underlying source region (possible only via dependency or plugin drift producing an unknown, position-unresolvable block), typing into the fallback followed by any later edit — including a remote peer's — previously rewrote the document source wholesale to the fallback-derived text, silently destroying the original bytes. The server bridge now detects when a sync drain would settle with the WYSIWYG view and the source text divergent beyond tolerance, keeps the source bytes authoritative, and re-derives the WYSIWYG view from source in the same drain (restoring the broken-block chrome as well).
diff --git a/.changeset/exec-honors-explicit-subdir-cwd.md b/.changeset/exec-honors-explicit-subdir-cwd.md
deleted file mode 100644
index 98b3a08f6..000000000
--- a/.changeset/exec-honors-explicit-subdir-cwd.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-server": patch
----
-
-The MCP `exec` tool now runs commands in the explicit `cwd` you pass, even when it points at a subdirectory of an OK project. Previously the resolver walked `cwd` up to the enclosing `.ok/config.yml` and ran bash from the project root, so a subdir-relative command like `cat notes.md` (cwd `<project>/subdir`) failed with a spurious "No such file or directory" and `structuredContent.cwd` reported the root instead of the directory you asked for — agents had to work around it with project-root-relative paths. The walk-up still resolves which project owns the call (config, server URL, lock, and enrichment stay project-anchored), but the execution directory is now the literal path passed. `structuredContent.cwd` reports where the command actually ran, and referenced-file enrichment resolves correctly regardless of which subdirectory bash ran in.
diff --git a/.changeset/fix-discord-resource-link.md b/.changeset/fix-discord-resource-link.md
deleted file mode 100644
index a2f0639c3..000000000
--- a/.changeset/fix-discord-resource-link.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-app": patch
----
-
-Update the Resources menu's Discord item to open the Discord invite directly instead of the stale Inkeep shortlink.
diff --git a/.changeset/flake-extinction-bun-tiers.md b/.changeset/flake-extinction-bun-tiers.md
deleted file mode 100644
index b28e67b2b..000000000
--- a/.changeset/flake-extinction-bun-tiers.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Extinguish the non-Playwright flake classes that were dropping merge-queue runs and breaking local tiers. Integration tests can now await the shadow-repo WIP commit deterministically via a new dev-only `POST /api/test-flush-git` route instead of racing the fire-and-forget git pipeline against a 20-second budget (the rename-history class behind three queue drops in six days). Parse-health metrics split wall-clock parse-budget aborts (`parseFallback.wholeDocBudget`, an environmental signal) from structural whole-doc fallbacks (`parseFallback.wholeDoc`, a content-health signal), so fixed-corpus "zero whole-doc" assertions and operator alerts no longer trip when a loaded machine crosses the 500ms defense budget on content that parses fine when idle. The two long-broken a11y PropPanel tests hover-reveal the chrome before clicking the gear. Full audit: `reports/nonplaywright-flake-audit-2026-06/`.
diff --git a/.changeset/fm-fence-trailing-whitespace.md b/.changeset/fm-fence-trailing-whitespace.md
deleted file mode 100644
index e94dadde2..000000000
--- a/.changeset/fm-fence-trailing-whitespace.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fixed: a trailing space or tab typed at the end of a frontmatter fence line in source mode no longer destroys the document's frontmatter on the next visual edit. Frontmatter fence recognition now tolerates trailing spaces/tabs on the `---` lines (matching CommonMark / remark-frontmatter behavior), so documents whose fences carry trailing whitespace are recognized consistently across the editor bridge, the property panel, templates, search heading extraction, outline navigation, skill bundle metadata, the CLI, and source-mode syntax styling. Leading whitespace before a fence still disqualifies it, as before.
-
-For maintainers — mechanism: `FRONTMATTER_RE` rejected fence lines with trailing whitespace while the bridge tolerance layer (`normalizeBridge` step 7b, the per-line trailing-whitespace strip) declared exactly those bytes equivalent, violating partition invariance: an in-tolerance W2 keystroke (`---` → `--- `) silently changed FM-region recognition, so Observer A Path B's recompose (`prependFrontmatter(readCurrentFm(), serialize(fragment))`) fabricated an FM deletion that the three-way merge then applied and settled. The recognition predicate is widened to `/^---[ \t]*\r?\n([\s\S]*?\r?\n)?---[ \t]*(\r?\n|$)/` at its definition boundary in core, with every sibling recognition site (server template/heading/enrichment/page-identity/templates-listing/skill-metadata parsers, CLI parser, CodeMirror decoration scoping and outline navigation) either rewired through the core functions or sharing the line-scoped form of the same contract.
diff --git a/.changeset/fresh-install-skips-whats-new.md b/.changeset/fresh-install-skips-whats-new.md
deleted file mode 100644
index 215eabcbd..000000000
--- a/.changeset/fresh-install-skips-whats-new.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Skip the "Updated to Version ..." release-notes notice on a fresh install. A brand-new install has no prior version, so everything is new — popping release notes at first launch was noise. The first launch now silently records the installed version as the baseline; the notice fires only on a real version transition (the next update).
diff --git a/.changeset/frozen-table-headers.md b/.changeset/frozen-table-headers.md
deleted file mode 100644
index 909c70c03..000000000
--- a/.changeset/frozen-table-headers.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Freeze table header row and first column when scrolling
-
-Long tables now keep the top row (column headers) visible at the top of the editor as you scroll past it, and the first column always stays visible during horizontal scrolling.
diff --git a/.changeset/hide-edit-with-ai-when-embedded.md b/.changeset/hide-edit-with-ai-when-embedded.md
deleted file mode 100644
index 5a8eac199..000000000
--- a/.changeset/hide-edit-with-ai-when-embedded.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Hide the "Edit with AI" button in the WYSIWYG bubble menu when Open Knowledge is embedded inside an agent host (Cursor, Codex, Claude Desktop). The button opens the header's "Open with AI" menu, but that menu is already hidden in embedded hosts — so clicking the bubble button there did nothing. The button (and its Cmd+Shift+I shortcut) now hide in lockstep with the header menu, matching the rest of the embedded-host chrome.
diff --git a/.changeset/hide-empty-new-from-template.md b/.changeset/hide-empty-new-from-template.md
deleted file mode 100644
index 0e7768ad9..000000000
--- a/.changeset/hide-empty-new-from-template.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Hide the sidebar "New from template" entry when a folder or the project has no templates. Previously, right-clicking a folder always showed a "New from template" submenu that opened to an empty list, and the project empty-space menu showed the entry greyed-out rather than hidden. Both surfaces now drop the entry entirely when there are no templates to pick, matching the toolbar and the editor empty-state.
diff --git a/.changeset/markdown-fidelity-e2e.md b/.changeset/markdown-fidelity-e2e.md
deleted file mode 100644
index 5ce0d4821..000000000
--- a/.changeset/markdown-fidelity-e2e.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-"@inkeep/open-knowledge-core": minor
-"@inkeep/open-knowledge-server": minor
----
-
-feat(markdown): end-to-end byte fidelity — markdown round-trips byte-exact, agents' untouched bytes survive concurrent edits
-
-The markdown engine no longer canonicalizes source formatting on the WYSIWYG/cross-surface edit path. In plain terms: the exact bytes you type are the exact bytes saved — editing one paragraph in WYSIWYG no longer re-formats the rest of the file, and only blocks you actually edit can change shape on save. Every producer-fixable byte-residual axis now round-trips byte-exact through `serialize(parse(x))`: table outer pipes, delimiter-row dashes and alignment padding, ordered-list numbering (`1. 1. 1.` stays), list marker spacing and continuation indents, fence length and info-string padding, strikethrough delimiter (`~` vs `~~`), task-checkbox case, wiki-link inner padding, opaque-extension embeds (`![[notes.foo]]` no longer downcasts to a plain link), inline math (`$x$` stays `$x$` instead of rewriting to `$$x$$`, with currency safety preserved), doc-start `---` thematic breaks (no longer rewritten to `***`, and a doc-start `---` no longer corrupts adjacent blocks), BOM, leading/trailing blank lines, inter-block blank-line counts, and tab-indented code. One visible consequence: a literal frontmatter-shaped block (`---`/`key: val`/`---`) ingested directly into the parse engine now renders as visible markdown (thematic break + setext heading) instead of being silently dropped.
-
-Silent data-loss fixes: boundary-whitespace emphasis (`<em>foo </em>`) now serializes to a re-parseable form instead of degrading to plain text; entity references in a fenced-code info string survive instead of being stripped; `[link](</my uri>)` parses as a link instead of literal text; inline code containing `|` inside a table cell keeps its escape instead of corrupting the table. The serializer also stops escaping bare `*`/`_`/`~` and line-start `=` where CommonMark does not require it.
-
-Agent find-fidelity (PRD-6654): a concurrent human WYSIWYG edit no longer rewrites an agent's untouched blocks in `Y.Text` — the map-driven Observer A splice is now the default path and a parse-equivalent `row-no-trailing-pipe` divergence no longer forces a canonicalizing write-back — so exact-match find-and-replace on previously written content keeps succeeding.
-
-Clipboard/export rendering: `img`/`video`/`audio` compat components render as real HTML elements instead of placeholders, and entity references and `<>` destinations in link/image URLs and titles decode correctly (with URL sanitization preserved).
diff --git a/.changeset/mcp-consent-menu-immediate-dialog.md b/.changeset/mcp-consent-menu-immediate-dialog.md
deleted file mode 100644
index 31d2d1f01..000000000
--- a/.changeset/mcp-consent-menu-immediate-dialog.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-desktop": patch
----
-
-File → Configure AI Tool Integrations… now opens the consent dialog immediately in the focused window (editor or project switcher). Previously the click armed the dialog silently and it only appeared in the next window the app opened, so clicking the menu item with a window already in front did nothing visible.
diff --git a/.changeset/mermaid-render-warnings.md b/.changeset/mermaid-render-warnings.md
deleted file mode 100644
index 75a21316b..000000000
--- a/.changeset/mermaid-render-warnings.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-"@inkeep/open-knowledge": minor
----
-
-Agent writes now get advisory mermaid feedback, delivered on a new unified `warnings` channel. The `write`/`edit` MCP tools (and the underlying `POST /api/agent-write-md` / `POST /api/agent-patch` routes) validate every ` ```mermaid ` fence of the post-write document with the same mermaid version the editor renders with, and report parse failures as `warnings` entries (`kind: "mermaid-parse-error"` — fence locator + mermaid's line-numbered message) plus a `⚠` line in the tool response text — so the authoring agent can fix a broken diagram in the same session instead of the reader discovering the error chrome. Strictly advisory: writes land byte-faithfully regardless.
-
-The `warnings` array is the one advisory channel going forward: it also carries the existing write-integrity kinds (`content-divergence`, `disk-edit-reconciled`) on every mutating write surface (write, write-md, patch, frontmatter-patch, rollback / `restore_version`), so co-occurring advisories no longer mask one another. The single-valued `warning` field and the MCP `structuredContent.document.contentDivergence` nesting are deprecated — `warning` keeps emitting its highest-precedence integrity entry in parallel for one deprecation window; new consumers should read `warnings`.
-
-The `palette` tool's Mermaid entry now teaches the grammar sharp edges (raw `;`/`#` terminate sequence-family message text — use commas or `#59;`/`#35;`; quote flowchart labels containing punctuation), and the tool-description footer points at it.
diff --git a/.changeset/observer-a-baseline-routing.md b/.changeset/observer-a-baseline-routing.md
deleted file mode 100644
index 4ee5d1759..000000000
--- a/.changeset/observer-a-baseline-routing.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fixed: the first WYSIWYG edit to a freshly loaded document no longer misroutes through a concurrent-edit merge that falsely reported divergence, and byte-unsafe constructs the canonical serializer would rewrite (un-padded GFM tables, inline-math delimiter form, PUA sentinels, multi-blank-line runs) are now preserved across WYSIWYG edits and editor mount — visually editing such a document no longer rewrites untouched constructs, and a mere editor mount no longer mutates the file on disk. Whitespace-only differences within bridge tolerance on untouched lines (e.g. the blank line between the frontmatter closer and the body that most real-world docs carry) are normalized on that first WYSIWYG edit — the documented transition behavior of the Y.Text-is-truth contract's architectural floor.
-
-For maintainers — mechanism: the sync baseline previously recorded the canonical serialization where the router strict-compares raw Y.Text bytes, so the first WYSIWYG edit after loading a non-round-trip-byte-stable doc (and after any source-mode edit Observer B absorbed) misrouted through Path B's three-way merge with telemetry falsely asserting `ytextDiverged: true`. The baseline is now split into two witnesses — canonical serialization for the fragment-unchanged short-circuit; raw Y.Text bytes for the router and the divergence-merge base — and the in-sync leg splits on residual tolerance: within tolerance routes Path A's canonical rewrite; beyond tolerance applies only the fragment's canonical-space delta onto the raw bytes via a canonical-base three-way merge. Source-mode edits within bridge tolerance (e.g. trailing whitespace) are still real divergence and still merge byte-preservingly through Path B.
-
-For operators: `observer-a-path-b-fired` and the `observerAPathBFires` / `observerAPathBFiresSuppressed` counters are now scoped strictly to real unabsorbed Y.Text divergence, and the event's `ytextDiverged` attribute is derived from the routing decision instead of hardcoded — dashboards keyed on the event will see the rate drop on residual-bearing docs whose first-edit fires were previously misclassified. The in-sync canonical-base residual merge is not a divergence fire; its volume is visible via the new `observerAResidualMergeRuns` counter and the `observer.a.path` span attribute (`path-a` | `residual-merge` | `path-b`).
diff --git a/.changeset/paragraph-continuation-indent-tolerance.md b/.changeset/paragraph-continuation-indent-tolerance.md
deleted file mode 100644
index f619e490a..000000000
--- a/.changeset/paragraph-continuation-indent-tolerance.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge-core": patch
----
-
-fix: documents containing CommonMark lazy-continuation lines (an indented line continuing the paragraph above it) no longer rest in a permanent bridge-divergence state. `normalizeBridge` gained a `paragraph-continuation-indent` tolerance class that treats the parser's indent-stripping on paragraph continuation lines as a comparison-equivalence, ending the perpetual split-brain telemetry, fuzz stalls, and stale-witness block duplication this construct could trigger. Comparison-only — stored bytes are never rewritten.
diff --git a/.changeset/pattern-d-schema-identity.md b/.changeset/pattern-d-schema-identity.md
deleted file mode 100644
index 6ebfd9652..000000000
--- a/.changeset/pattern-d-schema-identity.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fix silent loss of unchanged content after a document editor opens. The editor's pre-warm fast path built its node cache against a throwaway internal schema instance; because the editor matches content by schema-instance identity, the first incremental collaborative or agent edit after opening could silently drop unchanged sibling paragraphs from the visible editor, and the next click or keystroke could republish that truncated copy over the shared document — erasing the content for every peer and on disk. The pre-warm walk now runs during editor construction against the editor's own schema, so cached nodes always match and unchanged content survives incremental updates.
diff --git a/.changeset/pre.json b/.changeset/pre.json
index 590990eba..ce28cffa3 100644
--- a/.changeset/pre.json
+++ b/.changeset/pre.json
@@ -3,12 +3,13 @@
"tag": "beta",
"initialVersions": {
"@inkeep/open-knowledge-docs": "0.0.1",
- "@inkeep/open-knowledge-app": "0.11.0",
- "@inkeep/open-knowledge": "0.11.0",
- "@inkeep/open-knowledge-core": "0.11.0",
- "@inkeep/open-knowledge-desktop": "0.11.0",
+ "@inkeep/open-knowledge-app": "0.12.0",
+ "@inkeep/open-knowledge": "0.12.0",
+ "@inkeep/open-knowledge-core": "0.12.0",
+ "@inkeep/open-knowledge-desktop": "0.12.0",
+ "@inkeep/md-conformance": "0.0.1",
"@inkeep/open-knowledge-plugin": "0.3.1",
- "@inkeep/open-knowledge-server": "0.11.0"
+ "@inkeep/open-knowledge-server": "0.12.0"
},
"changesets": []
}
diff --git a/.changeset/preview-url-demand-starts-backend.md b/.changeset/preview-url-demand-starts-backend.md
deleted file mode 100644
index 1218e55cb..000000000
--- a/.changeset/preview-url-demand-starts-backend.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-`preview_url` now treats a preview request as demand for a backend. When no Open Knowledge server is running for the project, the tool auto-starts one through the same machinery the read/write tools use (`OK_MCP_AUTOSTART` gate, spawn timeout, spawn-error log) and waits briefly for the preview UI sibling to bind, so an agent whose first action is "open the preview" gets a working URL instead of `running: false`. The ensure also runs when a UI is already up, which revives the backend for a surviving preview UI whose server idle-shut-down. When no UI can be reached the recovery hint now names the right command for the actual state: `ok start` when nothing is running (previously the hint said `ok ui`, which produces a backend-less UI shell in that state) and `ok ui` when the server is alive but no UI is bound. Auto-start opt-out (`OK_MCP_AUTOSTART=0`) keeps today's soft not-running answer; spawn failures surface as tool errors with the spawn log attached.
diff --git a/.changeset/relaunch-failure-watchdog.md b/.changeset/relaunch-failure-watchdog.md
deleted file mode 100644
index 1d9331452..000000000
--- a/.changeset/relaunch-failure-watchdog.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Surface update-relaunch failures that happen after the relaunch was committed. Squirrel.Mac reports install failures asynchronously (through the updater's error event, or by silently never quitting) — previously every window stayed stuck on the terminal "Relaunching to install the update…" card with no button and no dismiss while the app kept running. Now the main process treats an updater error while a relaunch is in flight as that relaunch failing, backed by a watchdog that fires if the app is still alive 15 seconds after a clean quitAndInstall return. Either trigger restores the staged update, swaps every window back to the actionable "Version X ready to install" banner, and shows a "Relaunch failed — please restart manually" notice with the failure detail. A false watchdog alarm self-heals: if the app does relaunch, the restored state is cleared on the next boot.
diff --git a/.changeset/relaunch-notice-all-windows.md b/.changeset/relaunch-notice-all-windows.md
deleted file mode 100644
index 76a3673a6..000000000
--- a/.changeset/relaunch-notice-all-windows.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fix the update "Relaunch" notice so it propagates to every open window. Previously, clicking "Relaunch" on the "Version X ready to install" banner swapped only that one window to "Relaunching to install the update…"; any other open windows kept showing the stale, still-clickable "ready to install" banner for the several seconds it takes to tear down each project's server before the app quits and reinstalls. Now the relaunch fans out to all windows the instant it commits in the main process, so every window swaps to the in-progress "Relaunching…" card in lockstep and the Relaunch button can't be fired a second time from another window.
diff --git a/.changeset/sync-gh-token-credential-relay.md b/.changeset/sync-gh-token-credential-relay.md
deleted file mode 100644
index 7c210b145..000000000
--- a/.changeset/sync-gh-token-credential-relay.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Sync now authenticates to GitHub using your `gh` CLI login, matching how clone already works. Previously the background sync engine only consulted Open Knowledge's own credential store, so users who were signed in with `gh` but had never completed a separate Open Knowledge sign-in saw a persistent "GitHub sign-in is missing or expired" error in the sync popover even though their `gh` session was valid. The server now resolves the `gh` token (the same source the push-permission check already used) and relays it to the git credential helper, which prefers it over its own stored token. A fresh `gh auth login` or a reconnect is picked up on the next sync cycle without a restart.
-
-Also fixes `ok clone` so its `gh`-based authentication works on installs where `gh` lives outside the default PATH (e.g. Homebrew at `/opt/homebrew/bin`): clone now inherits your shell environment instead of replacing it, so the `gh` credential helper can locate `gh` and its config.
diff --git a/.changeset/table-cell-handle-layer-layout-shift.md b/.changeset/table-cell-handle-layer-layout-shift.md
deleted file mode 100644
index 96d216c86..000000000
--- a/.changeset/table-cell-handle-layer-layout-shift.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Fixed: placing the cursor in a table cell no longer pushes the whole document down. The invisible positioning layer for the table's column/row handle pills (`ok-table-cell-handle-layer`) claimed its own row in the editor's layout grid, and on documents shorter than the window that empty row was stretched to an equal share of the leftover height — a blank band appeared above the document whenever a table was focused. The layer is now pinned into the content's own grid row at zero height, so the handle pills render in exactly the same place with no layout shift.
-
-For maintainers — mechanism: `.tiptap-editor` is a CSS grid with implicit auto rows, and the default `align-content: stretch` distributes leftover block-size equally across in-flow auto tracks; any zero-height direct child still generates a stretchable track. The layer now carries `grid-row: 1; align-self: start`, and `.tiptap-editor-portal-content` declares `grid-row: 1` explicitly so auto-placement doesn't bump the editor body to row 2.
diff --git a/.changeset/tolerance-telemetry-wired.md b/.changeset/tolerance-telemetry-wired.md
deleted file mode 100644
index bfdfb7df7..000000000
--- a/.changeset/tolerance-telemetry-wired.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@inkeep/open-knowledge-core": patch
-"@inkeep/open-knowledge-server": patch
----
-
-fix: `OK_BRIDGE_TOLERANCE_TELEMETRY=1` now produces output — the tolerance-telemetry writer is wired into server boot (it was previously documented but never initialized), and writes through a rotating sink (~16 MB cap) instead of an unbounded append. The JSONL receives the full un-rate-limited fire stream (bounded on disk by rotation) so aggregate counts reflect real fire frequency; the console event and metric counter stay rate-limited per (site, class). Bridge drains on large documents also got cheaper: the residual-merge classification now runs its full-document normalize passes only on the drains where the classification can matter.
diff --git a/.changeset/whats-new-notice-green.md b/.changeset/whats-new-notice-green.md
deleted file mode 100644
index c0ef58562..000000000
--- a/.changeset/whats-new-notice-green.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Color the "Updated to Version X" sidebar notice green. The post-update confirmation previously used the same gray styling as the "Version X ready to install" notice, making the two easy to confuse at a glance. The confirmation card now renders with a green border, tint, and text so a completed update reads differently from one that is still waiting on a relaunch.
diff --git a/.changeset/worktree-sticky-cwd.md b/.changeset/worktree-sticky-cwd.md
deleted file mode 100644
index 0e829150b..000000000
--- a/.changeset/worktree-sticky-cwd.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-MCP project routing now sticks to the worktree you name. Pass `cwd` once on an OK tool call and later `cwd`-less calls in the same session reuse it, so an agent working in a git worktree no longer has its reads, writes, and preview silently target the main checkout. When a `cwd`-less call resolves into a repo that has multiple git worktrees via the client's single advertised root, the server emits a one-time, non-blocking nudge to pass `cwd` — it does not refuse, so working in the main checkout while feature worktrees exist is unaffected.
diff --git a/bun.lock b/bun.lock
index b4ef7650c..35b8cf829 100644
--- a/bun.lock
+++ b/bun.lock
@@ -53,7 +53,7 @@
},
"packages/app": {
"name": "@inkeep/open-knowledge-app",
- "version": "0.11.0",
+ "version": "0.12.0",
"dependencies": {
"@codemirror/autocomplete": "^6.20.1",
"@codemirror/commands": "^6.10.3",
@@ -191,7 +191,7 @@
},
"packages/cli": {
"name": "@inkeep/open-knowledge",
- "version": "0.11.0",
+ "version": "0.12.0",
"bin": {
"open-knowledge": "dist/cli.mjs",
"ok": "dist/cli.mjs",
@@ -233,7 +233,7 @@
},
"packages/core": {
"name": "@inkeep/open-knowledge-core",
- "version": "0.11.0",
+ "version": "0.12.0",
"dependencies": {
"@handlewithcare/remark-prosemirror": "0.1.5",
"@opentelemetry/api": "^1.9.0",
@@ -309,7 +309,7 @@
},
"packages/desktop": {
"name": "@inkeep/open-knowledge-desktop",
- "version": "0.11.0",
+ "version": "0.12.0",
"dependencies": {
"@inkeep/open-knowledge": "workspace:*",
"@inkeep/open-knowledge-core": "workspace:*",
@@ -342,7 +342,7 @@
},
"packages/server": {
"name": "@inkeep/open-knowledge-server",
- "version": "0.11.0",
+ "version": "0.12.0",
"dependencies": {
"@hocuspocus/server": "4.0.0-rc.1",
"@inkeep/open-knowledge-core": "workspace:*",
diff --git a/packages/app/package.json b/packages/app/package.json
index 47ea0c851..f6443ed1b 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-app",
- "version": "0.11.0",
+ "version": "0.12.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 189ff2a31..d1682d6d7 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge",
- "version": "0.11.0",
+ "version": "0.12.0",
"license": "GPL-3.0-or-later",
"private": false,
"type": "module",
diff --git a/packages/core/package.json b/packages/core/package.json
index 445d06abd..946d53490 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-core",
- "version": "0.11.0",
+ "version": "0.12.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/desktop/package.json b/packages/desktop/package.json
index 6ec51eb22..f54c6918d 100644
--- a/packages/desktop/package.json
+++ b/packages/desktop/package.json
@@ -1,7 +1,7 @@
{
"name": "@inkeep/open-knowledge-desktop",
"productName": "Open Knowledge",
- "version": "0.11.0",
+ "version": "0.12.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/server/assets/skills/discovery/SKILL.md b/packages/server/assets/skills/discovery/SKILL.md
index b588067c0..147c05104 100644
--- a/packages/server/assets/skills/discovery/SKILL.md
+++ b/packages/server/assets/skills/discovery/SKILL.md
@@ -3,7 +3,7 @@ name: open-knowledge-discovery
description: "Read when the user asks what Open Knowledge is, wants to install it on a repository, wants to share an Open Knowledge project with collaborators, or asks how `ok init` / `ok install-skill` / OK Desktop set up a project. Do NOT load to perform Open Knowledge reads/writes — the runtime guidance for editing markdown inside an initialized OK project ships as a separate project-local skill at `.claude/skills/open-knowledge/` whenever `ok init` runs. If the user appears to be editing markdown inside a `.ok/` project and this is the only OK skill loaded, advise them to re-run `ok init` to install the project-local skill."
compatibility: "Any agent host — no MCP server required. Pure discovery + install guidance."
metadata:
- version: "0.11.0"
+ version: "0.12.0"
author: "Inkeep"
repository: "https://github.com/inkeep/open-knowledge"
---
diff --git a/packages/server/assets/skills/project/SKILL.md b/packages/server/assets/skills/project/SKILL.md
index f26b0eb85..6347f4d94 100644
--- a/packages/server/assets/skills/project/SKILL.md
+++ b/packages/server/assets/skills/project/SKILL.md
@@ -3,7 +3,7 @@ name: open-knowledge
description: "MUST invoke before reading or editing any `.md` / `.mdx` file, and before any `mcp__open-knowledge__*` tool call (`exec`, `search`, `write`, `edit`, and the rest). This skill is installed into the repository by `ok init`, so its presence alone means this is an Open Knowledge project — its runtime contract governs every markdown file here, with no need to probe for a `.ok/` directory. Authoritative agent-runtime contract; supersedes the overlapping MCP server `instructions` echo."
compatibility: "Claude Code, Claude Desktop, Claude Cowork, Claude.ai web. Requires Open Knowledge MCP server + code execution."
metadata:
- version: "0.11.0"
+ version: "0.12.0"
author: "Inkeep"
repository: "https://github.com/inkeep/open-knowledge"
---
diff --git a/packages/server/package.json b/packages/server/package.json
index dfdd2dd9d..dc497e763 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-server",
- "version": "0.11.0",
+ "version": "0.12.0",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",