@rafinery/cli 0.7.0 → 0.8.0

package/lib/push.mjs

@@ -14,6 +14,7 @@ import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { runCompile } from "./gate/compile.mjs";
 import { runVerifyCitations } from "./gate/verify-citations.mjs";
+import { runOkfEmit } from "./gate/okf-emit.mjs";
 import { ensureBrainRepo, remoteDefaultBranch, inDir, die } from "./brain-repo.mjs";
 import { CLI_VERSION } from "./releases.mjs";
 
@@ -40,6 +41,38 @@ export default async function push(args = []) {
     /* no origin — manifest.repo stays "" */
   }
 
+  // ── stamped contract copy rides the push (before emit so the root index
+  // lists it from the very first push) ──
+  const canonical = join(ROOT, ".claude", "rafa", "contract.md");
+  if (existsSync(canonical)) {
+    // The copy is itself a generated concept (contract §11): it self-describes.
+    const stampFm =
+      `---\n` +
+      `type: Reference\n` +
+      `title: "rafa brain contract (stamped copy)"\n` +
+      `description: "the file protocol this bundle conforms to — canonical: .claude/rafa/contract.md in the code repo"\n` +
+      `timestamp: ${new Date().toISOString()}\n` +
+      `---\n\n`;
+    const stampHeader =
+      `<!-- STAMPED COPY — canonical: .claude/rafa/contract.md in the code repo.\n` +
+      `     cli: ${CLI_VERSION} · brain-for: ${codeSha} · stamped: ${new Date().toISOString()} -->\n\n`;
+    writeFileSync(join(rafaDir, "contract.md"), stampFm + stampHeader + readFileSync(canonical, "utf8"));
+  } else {
+    console.log(
+      "  ! no .claude/rafa/contract.md in this repo — pushing without the stamped contract copy " +
+        "(run `rafa update` to vendor it)",
+    );
+  }
+
+  // ── OKF surface (in-process, contract §11) ──
+  // Materialize the interchange surface BEFORE the gates so everything the
+  // emitter writes is checked like any authored file: stamps (type/description/
+  // timestamp/tags where derivable), wikilink→markdown-link transpile, generated
+  // `# Citations` sections, and the index.md tree. A pushed brain repo is a
+  // conformant OKF v0.1 bundle any foreign consumer can read without rafa.
+  console.log("• rafa okf — materializing the OKF surface (stamps · links · citations · indexes) …");
+  runOkfEmit([`--repo=${repoFull}`]);
+
   // ── citation gate (in-process) ──
   // Re-run the checker HERE so the record that rides the push is the record of
   // THIS push — a stale/hand-stamped citation-check.json can never ship
@@ -70,23 +103,6 @@ export default async function push(args = []) {
         "authoring agent (atlas/bloom/prism) correct them, then re-push.",
     );
 
-  // ── stamped contract copy rides the push ──
-  // The canonical contract lives in the CODE repo (.claude/rafa/contract.md);
-  // the brain repo carries a stamped copy so any reader of the brain repo knows
-  // exactly which contract version this brain conforms to.
-  const canonical = join(ROOT, ".claude", "rafa", "contract.md");
-  if (existsSync(canonical)) {
-    const stampHeader =
-      `<!-- STAMPED COPY — canonical: .claude/rafa/contract.md in the code repo.\n` +
-      `     cli: ${CLI_VERSION} · brain-for: ${codeSha} · stamped: ${new Date().toISOString()} -->\n\n`;
-    writeFileSync(join(rafaDir, "contract.md"), stampHeader + readFileSync(canonical, "utf8"));
-  } else {
-    console.log(
-      "  ! no .claude/rafa/contract.md in this repo — pushing without the stamped contract copy " +
-        "(run `rafa update` to vendor it)",
-    );
-  }
-
   inRafa("git add -A");
   try {
     inRafa(`git commit -m "brain: scan" -m "brain-for: ${codeSha}"`);

package/lib/releases.mjs

@@ -168,6 +168,41 @@ export const RELEASES = [
       "never ship). Brain data schema unchanged; no re-scan; adopt with `rafa update` " +
       "(re-vendors hooks, merges settings + statusline, installs the pre-push boundary).",
   },
+  {
+    version: "0.8.0",
+    contract: 1,
+    plans: 2,
+    requires: "update",
+    recommends: ["push"],
+    summary:
+      "THE OKF SURFACE (contract §11): every generated .md self-describes, and a pushed " +
+      "brain repo is a conformant Open Knowledge Format v0.1 bundle any foreign agent can " +
+      "read without rafa tooling. New @rafinery/okf package (zero-dep: strict parser · " +
+      "concept primitives · links · citations · indexes · §9 validator · generator) — the " +
+      "gate now imports the parser from it. New `rafa okf` (emit — runs inside push, before " +
+      "the gates, so its output is gate-checked) · `rafa okf check` (conformance walk; " +
+      "documented exemptions surface as warnings) · `rafa okf new <class> <id>` (mint a " +
+      "conformant concept skeleton; the rafa-okf skill is the SOP). Emit stamps ONLY " +
+      "derivable values (description from summary · singleton type/title from the class " +
+      "registry · timestamp from authored created:/found: → brain-repo git history → the " +
+      "emit run; never a guess), renders `# Citations` (sha-pinned GitHub URLs when the " +
+      "repo is known) inside okf:citations markers, transpiles resolvable [[wikilinks]] to " +
+      "bundle-relative markdown links (the authored form going forward — SOPs updated), and " +
+      "generates the index.md tree (root index carries okf_version + repo + codeSha). " +
+      "Plan items carry the surface too (type: Plan Epic|Task|Subtask derived from kind; " +
+      "per-epic plans/index.md). " +
+      "Checker: non-failing LINKS warn lane (dangling link = not-yet-written knowledge, " +
+      "OKF §5.3 — prism's worklist; closes the 2026-06-19 [[…]]-lint ratchet) and the " +
+      "citation-check.md report now self-describes. index.md/log.md are reserved names " +
+      "(skipped by every walker). Agent cards: okf-surface duty on atlas · bloom · prism · " +
+      "sage; okf-awareness on compass (bundles are PORTABLE — person-scoped content never " +
+      "lands in one); the conductor verb map carries the protocol note. TOTALITY: "
+      + "*.theirs.md conflicts fail compile with a typed rule (walkers skip them); "
+      + "shipped SOPs (rafa-* skills + conductor) and sage learnings are compile-gated "
+      + "local classes beside the agent cards. WIRE UNCHANGED: " +
+      "manifest shape + schemaVersion 1 + checker v2 — all additive " +
+      "(§8); no re-scan, adopt with `rafa update`, then `rafa push` materializes the bundle.",
+  },
 ];
 
 // The release this CLI build ships (last entry).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafinery/cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "rafa — the AI engineer CLI. Vendors the rafa blueprint into your repo (shadcn-style) and runs the deterministic contract gates.",
   "type": "module",
   "bin": {
@@ -15,13 +15,12 @@
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "@rafinery/okf": "0.1.0"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "bundle": "node scripts/bundle-blueprint.mjs",
-    "prepare": "node scripts/bundle-blueprint.mjs"
-  },
   "keywords": [
     "rafa",
     "rafinery",
@@ -37,5 +36,9 @@
     "url": "git+https://github.com/rafinery-ai/rafinery.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://github.com/rafinery-ai/rafinery/tree/main/packages/cli"
-}
+  "homepage": "https://github.com/rafinery-ai/rafinery/tree/main/packages/cli",
+  "scripts": {
+    "bundle": "node scripts/bundle-blueprint.mjs",
+    "test": "node --test"
+  }
+}