Skip to content

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
· 5 commits to main since this release
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.