Part of the Brain ⇄ OKF compatibility effort (plan: docs/brain-okf-compat.md).
Why
The payoff of OKF compatibility is interop: a scope's memory tree exported as a portable, vendor-neutral OKF bundle (readable by Obsidian/Notion/MkDocs/Dataplex/the OKF graph viewer, or re-importable elsewhere). This proves we are a true OKF superset and gives the Brain an export/exchange surface.
Scope
brain.export_okf tool: emit a scope's memory tree as an OKF-conformant bundle (directory and/or tarball), generating any missing index.md, an okf_version, and an optional bundle-level log.md synthesized from 70-weekly/.
- Validate the emitted bundle against OKF §9 conformance before returning.
- Docs: update
brain-implementation.md + brain README.md to state "files tier is an OKF superset"; add an OKF section to the public strategy doc.
- Stretch:
brain.import_okf to ingest an external OKF bundle into a scope (indexer + graph wiring).
Acceptance criteria
Files (likely)
packages/@boringos/brain/src/okf.ts (new), packages/@boringos/core/src/modules/brain.ts, scripts/verify-okf.mjs, docs.
Part of the Brain ⇄ OKF compatibility effort (plan:
docs/brain-okf-compat.md).Why
The payoff of OKF compatibility is interop: a scope's memory tree exported as a portable, vendor-neutral OKF bundle (readable by Obsidian/Notion/MkDocs/Dataplex/the OKF graph viewer, or re-importable elsewhere). This proves we are a true OKF superset and gives the Brain an export/exchange surface.
Scope
brain.export_okftool: emit a scope's memory tree as an OKF-conformant bundle (directory and/or tarball), generating any missingindex.md, anokf_version, and an optional bundle-levellog.mdsynthesized from70-weekly/.brain-implementation.md+ brainREADME.mdto state "files tier is an OKF superset"; add an OKF section to the public strategy doc.brain.import_okfto ingest an external OKF bundle into a scope (indexer + graph wiring).Acceptance criteria
brain.export_okfproduces a bundle that passes §9 conformance.type/links/citations).Files (likely)
packages/@boringos/brain/src/okf.ts(new),packages/@boringos/core/src/modules/brain.ts,scripts/verify-okf.mjs, docs.