Skip to content

v1.3.0 — Full OKF v0.3 Interoperability

Latest

Choose a tag to compare

@adriantodorov adriantodorov released this 18 Nov 22:13
· 4 commits to main since this release
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.