Repository navigation
Releases
Releases · GoogleCloudPlatform/knowledge-compiler
v1.3.0 — Full OKF v0.3 Interoperability
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-lintstrictly resolves and validates URL-decoded relative and/-rooted.mdMarkdown links (flagging broken.mdlinks outsideraw/), addsvault-lint --fix --portable-linksto 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-graphrenders clickable relative.mdlinks inside the WebGL Reader drawer, parses inlinerel::[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-lintreports"bundle_root": "."and"concepts_dir": "wiki".vault-initscaffolds a frontmatter-freewiki/index.mdlinked from rootindex.md,vault-lint --fix --migrate-v03generates missing frontmatter-freewiki/index.mdandwiki/<subdir>/index.mdfiles, andvault-graphclassifies subdirectoryindex.md/log.mdfiles 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, andx-kc-supersedesacrossvault-lint,vault-graph,vault-sync-patterns, andvault-sanitize-check(migrated automatically by--fix --migrate-v03, with 100% read compatibility for legacy unprefixed keys).
- Adopts
- 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-freewiki/**/index.mdfiles, and 57x-kc-*epistemic edges, passing the official OKF v0.3validate.py --strictwith32 files checked: 0 errors, 0 warnings, 0 info.README.mddocumentspython3 -m unittest tests.test_v1_release_gates.TestV1ReleaseGates.test_gate1_offline_plane1_socket_blockedfor one-command verification of the zero-network offline default.
Knowledge Compiler v1.2.0 (OKF v0.3 + 21-Note Starter Vault)
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"withtitleanddescriptionin rootindex.mdand frontmatter-freelog.mdwith newest-first## YYYY-MM-DDdate headings (union-merging bothv0.3and legacyv0.2logs). - Verification Currency & Fail-Closed Staleness (§5.3, §5.5, §11.2):
derive_trust_tier()ignores verifications older thangenerated.at(stale_verification_notestracked invault-lint --json), unparseablestale_afterfails closed as stale, and RFC 3339 offsets are enforced. - Paths,
superseded_byEdges,team:Actors & Attested Computations (§5.4, §6.2, §7, §10.2–§10.3): Supports relative vs leading-/bundle-root path resolution with automaticv0.2fallback, graphssuperseded_byasSUPERSEDESedges, and validatesteam:actors and Attested Computation blocks. - One-Command Idempotent Migration: Run
vault-lint <vault> --fix --migrate-v03to upgrade an existingOKF v0.2vault toOKF v0.3.
21-Note Clean-Room OKF v0.3 Starter Vault & First-Run Sample Preview
- Expanded Sample Vault (
examples/starter-vault/): 26 files (2raw briefs,21wiki notes acrosssources/,entities/,concepts/,patterns/,synthesis/, and3anchors),257typed epistemic edges (0orphans),10inline Mermaid diagrams (flowchart,sequenceDiagram,pie), and33GFM tables passing official OKF v0.3 validation with0errors and0warnings. - First-Run Onboarding & Read-Only Preview (
vault-graph): Freshvault-initvaults now link all 5 scaffold anchors via relative.mdMarkdown links (0orphans) 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
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/noteloading, 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 inwiki/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(disabledby default).
This is not an officially supported Google product.