Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

main reset: post-stable v0.35.5 (#2806)

inkeep-internal-ci[bot]c30facfc8a6d
diff --git a/.changeset/crash-capture-and-mcp-log-mirror.md b/.changeset/crash-capture-and-mcp-log-mirror.md
deleted file mode 100644
index 297afb217..000000000
--- a/.changeset/crash-capture-and-mcp-log-mirror.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-Bug-report bundles now capture why the server died and what the MCP server was doing. A fatal server crash (uncaught exception or unhandled rejection) writes a synchronous `last-server-crash.json` record — timestamp, error name/message/stack, pid, uptime — under `.ok/local/` plus a final fatal line in the server log, both collected into `ok bug-report` and `ok diagnose bundle` output; previously a hard crash lost the async log sink's tail and bundles could only say "server not running". The global MCP stdio server's `[mcp]` stderr diagnostics are now also mirrored to `~/.ok/logs/mcp.<date>.log` (pruned at each startup by a 7-day age window and an aggregate size cap), so bundles include the agent-ingress diagnostics that previously landed only in the MCP host's own log folder.
diff --git a/.changeset/exec-mtime-sweep-bounding.md b/.changeset/exec-mtime-sweep-bounding.md
deleted file mode 100644
index d9c0d504c..000000000
--- a/.changeset/exec-mtime-sweep-bounding.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-The `exec` MCP tool's post-command mutation safety sweep is now scoped to the paths the command can actually touch (its own path operands), instead of statting up to 1000 files across the whole knowledge base twice on every call. Path-scoped commands like `cat notes/a.md` or `grep -rn oauth articles/` now sweep only those paths, making exec noticeably cheaper on large knowledge bases. When the sweep does cover the whole tree (bare `ls`, `find`, recursive `grep` with no directory) and the corpus exceeds the 1000-file scan cap, the response now carries an explicit warning that mutation detection was partial, instead of silently presenting a capped sweep as full coverage.
diff --git a/.changeset/pagelist-push-refetch-coalescing.md b/.changeset/pagelist-push-refetch-coalescing.md
deleted file mode 100644
index e6992b1c4..000000000
--- a/.changeset/pagelist-push-refetch-coalescing.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-The sidebar's page directory no longer storms the server during bulk agent writes. File-change pushes now coalesce into a single trailing refetch (~300 ms window) instead of refiring the full page-list and document-list walk on every push, so an agent writing many files per second no longer triggers ~10 full corpus refetches and index rebuilds per second. The initial load and manual refreshes stay immediate.
diff --git a/.changeset/pre.json b/.changeset/pre.json
index b77fe7e96..6845e4887 100644
--- a/.changeset/pre.json
+++ b/.changeset/pre.json
@@ -2,15 +2,15 @@
"mode": "pre",
"tag": "beta",
"initialVersions": {
- "@inkeep/open-knowledge-docs": "0.0.28",
- "@inkeep/open-knowledge-app": "0.35.4",
- "@inkeep/open-knowledge": "0.35.4",
- "@inkeep/open-knowledge-core": "0.35.4",
- "@inkeep/open-knowledge-desktop": "0.35.4",
- "@inkeep/md-conformance": "0.0.36",
+ "@inkeep/open-knowledge-docs": "0.0.29",
+ "@inkeep/open-knowledge-app": "0.35.5",
+ "@inkeep/open-knowledge": "0.35.5",
+ "@inkeep/open-knowledge-core": "0.35.5",
+ "@inkeep/open-knowledge-desktop": "0.35.5",
+ "@inkeep/md-conformance": "0.0.37",
"@inkeep/open-knowledge-native-config": "0.0.0",
"@inkeep/open-knowledge-plugin": "0.3.1",
- "@inkeep/open-knowledge-server": "0.35.4"
+ "@inkeep/open-knowledge-server": "0.35.5"
},
"changesets": []
}
diff --git a/.changeset/server-observability-quick-wins.md b/.changeset/server-observability-quick-wins.md
deleted file mode 100644
index 137ed8a59..000000000
--- a/.changeset/server-observability-quick-wins.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@inkeep/open-knowledge": patch
----
-
-New operational metrics for cloud/server operators (all zero-overhead when telemetry is disabled): event-loop delay percentiles (`ok.server.event_loop.delay_ms`), CPU utilization (`ok.server.cpu.utilization`), extended memory sections (`external`, `array_buffers`) on `ok.server.memory.usage_megabytes`, a loaded-documents gauge (`ok.server.docs.loaded`), and write-spine queue depths (`ok.persistence.queue.depth`, `ok.bridge.drain_backlog`). Error responses now stamp their correlation UUID on the active trace span (`ok.error.instance`) so a client-reported error can be joined against its trace. The standard `OTEL_TRACES_SAMPLER` / `OTEL_TRACES_SAMPLER_ARG` sampling contract is now pinned by tests and documented, including its interaction with the local bug-bundle span sink.
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index aee81020a..e06f43dff 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,11 @@
# @inkeep/open-knowledge-docs
+## 0.0.29
+
+### Patch Changes
+
+
## 0.0.28
### Patch Changes
diff --git a/docs/package.json b/docs/package.json
index 531c6e5d9..19caf528a 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-docs",
- "version": "0.0.28",
+ "version": "0.0.29",
"license": "GPL-3.0-or-later",
"private": true,
"packageManager": "[email protected]",
diff --git a/packages/app/package.json b/packages/app/package.json
index 42668b59e..38d731cf4 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-app",
- "version": "0.35.4",
+ "version": "0.35.5",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index b655f5612..6ab79aad3 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge",
- "version": "0.35.4",
+ "version": "0.35.5",
"license": "GPL-3.0-or-later",
"private": false,
"type": "module",
diff --git a/packages/core/package.json b/packages/core/package.json
index 527a5c723..a999d164b 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-core",
- "version": "0.35.4",
+ "version": "0.35.5",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",
diff --git a/packages/desktop/package.json b/packages/desktop/package.json
index a66f2e1e2..243e9380d 100644
--- a/packages/desktop/package.json
+++ b/packages/desktop/package.json
@@ -1,7 +1,7 @@
{
"name": "@inkeep/open-knowledge-desktop",
"productName": "OpenKnowledge",
- "version": "0.35.4",
+ "version": "0.35.5",
"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 cbea20bf1..934874c86 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 OpenKnowledge is, wants to install it on a repository, wants to share an OpenKnowledge project with collaborators, or asks how `ok init` / `ok cowork` / OK Desktop set up a project. Do NOT load to perform OpenKnowledge 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.35.4"
+ version: "0.35.5"
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 ae832a71b..901d3ed56 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: "Authoritative agent-runtime contract for working inside an OpenKnowledge project — a markdown-CRDT knowledge base exposed over MCP. Use whenever reading, listing, searching, editing, or linting any `.md` or `.mdx` file in the project, and before any `mcp__open-knowledge__*` tool call (`exec`, `search`, `write`, `edit`, `lint`, and the rest). Installed by `ok init`, so its presence means this is an OpenKnowledge project and it governs every markdown file here. Covers the read/write tool surface, grounding and linking rules, folder/template conventions, the live browser preview, and the rule that OK's MCP tools — never native file tools — handle in-scope markdown."
compatibility: "Claude Code, Claude Desktop, Claude Cowork, Claude.ai web. Requires OpenKnowledge MCP server + code execution."
metadata:
- version: "0.35.4"
+ version: "0.35.5"
author: "Inkeep"
repository: "https://github.com/inkeep/open-knowledge"
---
diff --git a/packages/server/assets/skills/write-skill/SKILL.md b/packages/server/assets/skills/write-skill/SKILL.md
index b9d35ade7..c05fff0dd 100644
--- a/packages/server/assets/skills/write-skill/SKILL.md
+++ b/packages/server/assets/skills/write-skill/SKILL.md
@@ -3,7 +3,7 @@ name: open-knowledge-write-skill
description: "Use when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md) — for OpenKnowledge or for their editors — including requests like 'help me write a skill', 'make a skill that…', 'turn this workflow into a skill', or improving an existing skill's triggering and discipline. Also use when capturing reusable agent guidance that should live as an installable skill rather than a one-off prompt. Covers choosing scope (project vs global), the SKILL.md frontmatter contract, progressive-disclosure structure, evaluating the skill, and installing it into the user's editors."
compatibility: "OpenKnowledge project recommended (uses the `write` / `edit` / `install` MCP verbs). Authoring + validation are pure file ops; live preview + eval want a running server (`ok start`)."
metadata:
- version: "0.35.4"
+ version: "0.35.5"
author: "Inkeep"
repository: "https://github.com/inkeep/open-knowledge"
---
diff --git a/packages/server/package.json b/packages/server/package.json
index 23764ea2e..ba198baca 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,6 +1,6 @@
{
"name": "@inkeep/open-knowledge-server",
- "version": "0.35.4",
+ "version": "0.35.5",
"license": "GPL-3.0-or-later",
"private": true,
"type": "module",