Skip to content

v0.26.0

Choose a tag to compare

@github-actions github-actions released this 26 Jun 09:53
3730df6

Knowns v0.26.0

image

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 initial and on-demand help, keeping repo instruction shims lightweight
  • Global setup guidance - Installation, quick start, platform, sync, and configuration docs now recommend knowns setup <target> --global for normal personal assistant setup
  • Approved-spec workflow - kn-flow is documented as the recommended approved-spec orchestration path, while kn-go is positioned as the legacy no-review-gates path
  • Runtime memory serialization - Injected memory prompt text now includes compact score= and trust= 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

@howznguyen

Full Changelog: v0.25.0...v0.26.0