v0.26.0
Knowns v0.26.0
Highlights
This release adds first-class document history. Docs now keep stable revision identity across renames, record section-level diffs when possible, expose structured timeline/diff/restore APIs, and include a WebUI history panel for inspecting and restoring previous content. Agent workflow docs were refreshed around MCP initial/help, Codex skill syntax, global setup, and kn-flow. Runtime memory payloads also expose trust metadata so agents can distinguish active context from supplemental or proposed knowledge.
Added
- Document revision history - Docs now store stable revision history with document IDs, path continuity across renames, hashes, checkpoint revisions, changed scopes, and legacy history compatibility
- Section-level doc diffs - Markdown section edits can be recorded as scoped changes without duplicating the full document body for every revision
- Doc restore flows - Added section restore and whole-doc restore behavior that updates the current doc and records a normal follow-up restore revision
- History retention markers - Retention policy support can bound stored history by version count or age while preserving checkpoint coherence and surfacing structured retention gaps
- CLI, MCP, and API history surfaces - Doc history output now includes structured revision metadata, changed scopes, checkpoint state, audit/session links, hashes, diff data, and restore actions
- WebUI history sheet - Docs now expose a History control with timeline entries, readable diffs, copy changed content, retention gap messaging, unavailable audit states, and restore section/whole-doc actions
- Sensitive-history guide - Added guidance explaining doc history retention risk, checkpoints, retention gaps, and the fact that restore creates a new revision instead of erasing old content
- Runtime memory trust metadata - Runtime memory capture and injection now include score, threshold, trusted state, trust reason, and review matches where applicable
- Knownedge research brief - Added product research notes for a separate self-hosted team knowledge and memory server built on Knowns primitives
- Upstream dispatch workflow - Added a GitHub workflow for upstream dispatch automation
Fixed
- Doc history compatibility - Existing path-keyed doc history files remain readable and migrate safely on subsequent writes instead of silently losing older snapshots
- Missing audit resilience - History, diff, and restore responses remain valid when audit links are absent or no longer available
- MCP section update formatting - Section replacement preserves the separator before the next Markdown heading so adjacent sections do not collapse together
Changed
- Agent setup docs - Public and Knowns-managed docs now clarify that MCP tools and agent skills are separate surfaces, with Claude using
/kn-*and Codex using$kn-* - Bootstrap guidance - Documentation now routes agents through MCP
initialand on-demandhelp, keeping repo instruction shims lightweight - Global setup guidance - Installation, quick start, platform, sync, and configuration docs now recommend
knowns setup <target> --globalfor normal personal assistant setup - Approved-spec workflow -
kn-flowis documented as the recommended approved-spec orchestration path, whilekn-gois positioned as the legacy no-review-gates path - Runtime memory serialization - Injected memory prompt text now includes compact
score=andtrust=metadata without exposing verbose debug scoring details - Serena config cleanup - Removed stale repo-local Serena project files from the maintained project setup
Testing
- Added storage coverage for stable doc IDs, create/update/rename continuity, legacy migration, section diffs, section restore, whole-doc restore, max-version retention, max-age retention, and retention gaps
- Added CLI, MCP, and server route tests for history metadata, include-history responses, diff responses, restore behavior, missing audit links, and retention-gap response shapes
- Added WebUI build and browser verification for opening history, selecting revisions, rendering diffs, copying changed content, and restore action wiring
- Added runtime memory tests for capture score, threshold, trusted state, and serialized trust metadata
Contributors
Full Changelog: v0.25.0...v0.26.0