Skip to content

Releases

v1.3.0 — Full OKF v0.3 Interoperability

Choose a tag to compare

@adriantodorov adriantodorov released this 18 Nov 22:13
434e5a2

What's New in v1.3.0

Brings full Open Knowledge Format (OKF v0.3) ecosystem interoperability while keeping 100% backward compatibility with Obsidian [[wikilinks]] and OKF v0.2 vaults:

  • Standard OKF v0.3 Relative Markdown Links (--portable-links):
    • vault-lint strictly resolves and validates URL-decoded relative and /-rooted .md Markdown links (flagging broken .md links outside raw/), adds vault-lint --fix --portable-links to deterministically rewrite resolved [[wikilinks]] into RFC 3986 %20-encoded relative Markdown links and /wiki/... frontmatter paths, and prioritizes shallower root paths ([[index]] -> index.md).
    • vault-graph renders clickable relative .md links inside the WebGL Reader drawer, parses inline rel::[Label](path.md) epistemic edges, and unwraps Markdown links cleanly in graph and BM25 (vault-query) excerpts.
  • Unambiguous OKF v0.3 Bundle Root (.) & §8 Subdirectory Indexes (wiki/**/index.md):
    • vault-lint reports "bundle_root": "." and "concepts_dir": "wiki".
    • vault-init scaffolds a frontmatter-free wiki/index.md linked from root index.md, vault-lint --fix --migrate-v03 generates missing frontmatter-free wiki/index.md and wiki/<subdir>/index.md files, and vault-graph classifies subdirectory index.md/log.md files as anchors.
  • OKF v0.3 §4.1 Namespaced x-kc-* Epistemic Extensions:
    • Adopts x-kc-corroborates, x-kc-complements, x-kc-extends, x-kc-contradicts, and x-kc-supersedes across vault-lint, vault-graph, vault-sync-patterns, and vault-sanitize-check (migrated automatically by --fix --migrate-v03, with 100% read compatibility for legacy unprefixed keys).
  • Upgraded 21-Note Starter Vault & Verifiable Offline Check:
    • examples/starter-vault/ now ships with 434 inter-note relative Markdown links (0 prose wikilinks), 6 frontmatter-free wiki/**/index.md files, and 57 x-kc-* epistemic edges, passing the official OKF v0.3 validate.py --strict with 32 files checked: 0 errors, 0 warnings, 0 info.
    • README.md documents python3 -m unittest tests.test_v1_release_gates.TestV1ReleaseGates.test_gate1_offline_plane1_socket_blocked for one-command verification of the zero-network offline default.

Knowledge Compiler v1.2.0 (OKF v0.3 + 21-Note Starter Vault)

Choose a tag to compare

@adriantodorov adriantodorov released this 18 Nov 17:16
527e628

What's New in v1.2.0

Native Open Knowledge Format (OKF v0.3) Support (with Full v0.2 Compatibility)

  • Root Bundle Metadata & Reserved Files (§8–§9): Fresh vaults emit okf_version: "0.3" with title and description in root index.md and frontmatter-free log.md with newest-first ## YYYY-MM-DD date headings (union-merging both v0.3 and legacy v0.2 logs).
  • Verification Currency & Fail-Closed Staleness (§5.3, §5.5, §11.2): derive_trust_tier() ignores verifications older than generated.at (stale_verification_notes tracked in vault-lint --json), unparseable stale_after fails closed as stale, and RFC 3339 offsets are enforced.
  • Paths, superseded_by Edges, team: Actors & Attested Computations (§5.4, §6.2, §7, §10.2–§10.3): Supports relative vs leading-/ bundle-root path resolution with automatic v0.2 fallback, graphs superseded_by as SUPERSEDES edges, and validates team: actors and Attested Computation blocks.
  • One-Command Idempotent Migration: Run vault-lint <vault> --fix --migrate-v03 to upgrade an existing OKF v0.2 vault to OKF v0.3.

21-Note Clean-Room OKF v0.3 Starter Vault & First-Run Sample Preview

  • Expanded Sample Vault (examples/starter-vault/): 26 files (2 raw briefs, 21 wiki notes across sources/, entities/, concepts/, patterns/, synthesis/, and 3 anchors), 257 typed epistemic edges (0 orphans), 10 inline Mermaid diagrams (flowchart, sequenceDiagram, pie), and 33 GFM tables passing official OKF v0.3 validation with 0 errors and 0 warnings.
  • First-Run Onboarding & Read-Only Preview (vault-graph): Fresh vault-init vaults now link all 5 scaffold anchors via relative .md Markdown links (0 orphans) and show a dismissible welcome card with a 1-click read-only Explore 21-Note Sample Vault switcher (/api/graph?source=sample&slim=1, /api/note?source=sample) that never modifies your personal vault.

Verification

  • Full hermetic unit test suite passing with and without PyYAML (including Node VM browser DOM verification for inline Mermaid SVG, GFM tables, and sample-vault switching).
  • Zero-CDN strict CSP (default-src 'none') and Apache-2.0 clean-room compliance verified in CI.

Knowledge Compiler v1.1.3

Choose a tag to compare

@adriantodorov adriantodorov released this 17 Nov 21:27

Initial public open-source release of Knowledge Compiler (v1.1.3), a local-first Open Knowledge Format (OKF v0.2) compiler, interactive 2D/3D WebGL knowledge graph workbench, and agent skill evolution suite for coding agents.

Highlights

  • Multimodal OKF v0.2 Compiler (/ingest, /distill-session, /vault-correct): Compiles .pptx, .pdf, .docx, .xlsx, .html, transcripts, codebases, and coding sessions into a schema-validated Markdown wiki (raw/ -> wiki/ -> index.md & log.md) with zero-dependency stdlib OOXML fallbacks.
  • Interactive 60 FPS 2D/3D WebGL Graph & Zero-CDN Reader (/vault-graph): Local loopback server (127.0.0.1:8765) with lazy /api/note loading, inline CSP-safe SVG 1.1 rendering for Mermaid (flowchart/graph, sequenceDiagram, pie) with full-screen lightbox (Expand), and GFM Markdown tables.
  • In-Memory Multi-Field BM25 Retrieval & Graph Governance (/vault-query, /vault-lint): Zero-index-file BM25 search (--check-duplicate), synthesis staleness detection (--strict-drift), unlinked mention discovery (--mentions), and two-phase CAS deduplication (--dedup-manifest / --apply-manifest).
  • Sanitized Pattern Sharing & Fail-Closed DLP (/vault-share, /vault-pull, vault-sanitize-check): Rewrites private entity links into generic enterprise archetypes and runs fail-closed egress checks before pushing or opening isolated worktree PRs (--open-pr).
  • Closed-Loop Skill Evolution (/wikiskill, Stable): Redacted error-trace proposal clustering (vault-analyze-trace --propose) and deterministic offline Asymmetric Rollback Evaluation (vault-wikiskill-eval) recording SHA-256 CAS audit entries strictly in wiki/skill-impact.md.
  • Opt-In Lifecycle Hooks & Agent Plugins 1.0.0 Packaging: Ships 10 stable skills, 1 workspace rule, 1 local graph sidecar, and 3 opt-in hooks managed via vault-hooks (disabled by default).

This is not an officially supported Google product.