@rafinery/cli 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -4,6 +4,17 @@ The machine-readable version of this lives in [`lib/releases.mjs`](lib/releases.
 CLI reads it to tell a client, on `rafa update`, exactly what an upgrade requires (nothing,
 a re-scan, or a `rafa migrate`).
 
+## 0.8.1 — honest empty: absence is never conformance
+
+`rafa okf check` over a root with zero `.md` files used to print a green "conforms" —
+a vacuous truth over nothing, the exact silent-empty class the contract bans. Now:
+zero files → loud failure ("nothing to check") with root guidance (a brain-repo clone
+wants `--root=.`; a code repo's `.rafa` is lazy until `rafa pull --full`/a scan).
+`rafa okf` (emit) on an empty root writes no scaffold and returns 1 — push logs it and
+continues (a lazy `.rafa` is legitimate there); standalone exits loud.
+`@rafinery/okf` 0.1.1 adds the additive `empty` flag to `validateBundle` so library
+consumers distinguish "checked and clean" from "nothing to check."
+
 ## 0.8.0 — the OKF surface: every brain is an Open Knowledge Format bundle
 
 **Adopt with:** `npx @rafinery/cli@latest update`, then `rafa push` — the next push

package/lib/gate/okf-emit.mjs

@@ -146,6 +146,18 @@ export function runOkfEmit(argv = []) {
     }
   }
 
+  // Nothing to materialize is ABSENCE, not success: write no scaffold over an
+  // empty root (wrong --root, or a lazy .rafa before pull/scan). Standalone
+  // `rafa okf` exits 1 on this; push logs it and continues — a lazy instance
+  // is a legitimate state there, and the gates behind it stay honest.
+  if (concepts.length === 0) {
+    console.log(
+      `! rafa okf: no concepts under ${ROOT} — nothing to materialize ` +
+        `(brain-repo clone → --root=. · code repo → .rafa after \`rafa pull --full\` or a scan)`,
+    );
+    return 1;
+  }
+
   // id → { title, bundlePath } for wikilink transpilation.
   const resolve = new Map();
   for (const c of concepts) {

package/lib/okf.mjs

@@ -36,9 +36,19 @@ export default async function okf(args = []) {
   }
 
   if (sub === "check") {
-    const { conformant, checked, errors, warnings } = validateBundle(ROOT, {
+    const { conformant, empty, checked, errors, warnings } = validateBundle(ROOT, {
       exempt: RAFA_EXEMPT,
     });
+    // Zero files is ABSENCE, never conformance — a green over an empty root
+    // would be the silent-empty failure class (no assumed values, outward).
+    if (empty) {
+      console.error(
+        `✗ rafa okf check: no .md files under ${ROOT} — nothing to check.\n` +
+          `  Wrong --root? In a brain-repo clone the bundle IS the directory: --root=.\n` +
+          `  In a code repo the bundle is .rafa/ (lazy — \`rafa pull --full\` mirrors it).`,
+      );
+      process.exit(1);
+    }
     for (const e of errors) console.log(`✗ ${e.path} — ${e.rule}`);
     for (const w of warnings) console.log(`⚠ ${w.path} — ${w.rule}`);
     console.log(

package/lib/releases.mjs

@@ -203,6 +203,19 @@ export const RELEASES = [
       "manifest shape + schemaVersion 1 + checker v2 — all additive " +
       "(§8); no re-scan, adopt with `rafa update`, then `rafa push` materializes the bundle.",
   },
+  {
+    version: "0.8.1",
+    contract: 1,
+    plans: 2,
+    requires: "update",
+    summary:
+      "Honest-empty patch: `rafa okf check` on a root with zero .md files now FAILS " +
+      "loudly (\"nothing to check\" + root guidance) instead of printing a vacuous " +
+      "conformance green — absence is never conformance. `rafa okf` (emit) on an empty " +
+      "root materializes nothing and returns 1 (push logs + continues past a lazy " +
+      ".rafa; standalone exits loud). @rafinery/okf 0.1.1: validateBundle gains the " +
+      "additive `empty` flag so library consumers can make the same distinction.",
+  },
 ];
 
 // The release this CLI build ships (last entry).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafinery/cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "rafa — the AI engineer CLI. Vendors the rafa blueprint into your repo (shadcn-style) and runs the deterministic contract gates.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@rafinery/okf": "0.1.0"
+    "@rafinery/okf": "0.1.1"
   },
   "publishConfig": {
     "access": "public"