unitbob 0.4.1 → 0.4.2

package/README.md

@@ -30,7 +30,7 @@ claude plugin install unitbob@unitbob
 ```
 codex plugin marketplace add sergeygershun/unitbob-connector
 codex plugin add unitbob@unitbob
-npx -y unitbob@0.4.1 codex-install
+npx -y unitbob@0.4.2 codex-install
 ```
 
 Start a new Claude Code or Codex thread so the installed skill and named agents

package/dist/verbs/validateWorkerCheckpoints.js

@@ -74,14 +74,25 @@ function validateCompactFacts(value, label, errors) {
         return;
     }
     for (const [index, entry] of value.entries()) {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            errors.push(`${label}: $.facts[${index}] must be an object with fact and source_refs; got ${jsonType(entry)}`);
+            continue;
+        }
         const fact = entry;
-        if (!fact || typeof fact.fact !== 'string' || !fact.fact.trim())
+        if (typeof fact.fact !== 'string' || !fact.fact.trim())
             errors.push(`${label}: facts[${index}].fact must be non-empty`);
-        if (!Array.isArray(fact?.source_refs) || fact.source_refs.some((ref) => typeof ref !== 'string' || !ref.trim())) {
+        if (!Array.isArray(fact.source_refs) || fact.source_refs.some((ref) => typeof ref !== 'string' || !ref.trim())) {
             errors.push(`${label}: facts[${index}].source_refs must be compact source references`);
         }
-        if ('source' in (fact ?? {}) || 'transcript' in (fact ?? {}) || 'suite' in (fact ?? {})) {
+        if ('source' in fact || 'transcript' in fact || 'suite' in fact) {
             errors.push(`${label}: facts[${index}] may not embed source, transcript, or suite copies`);
         }
     }
 }
+function jsonType(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unitbob",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Unitbob connector — thin local hands for the Unitbob Rails brain. Owns no domain logic: it runs tools, relays bytes over the wire, and prints what the server returns.",
   "type": "module",
   "bin": {

package/plugin/codex/agents/suite-repair-worker.toml

@@ -13,7 +13,14 @@ not edit host-owned shared files, the connector-owned harness, application
 production code, or another slice.
 
 Update the same checkpoint as promises complete. Keep facts compact and
-source-referenced. Never run the suite or boot the application; the coordinator
+source-referenced. The normative JSON shape of one facts entry is:
+```json
+{"fact":"The route creates an order.","source_refs":["app/orders.rb:12"]}
+```
+Every facts entry is an object in that shape, never a string. Before handoff,
+make one final read of the checkpoint and confirm every `facts` entry is an
+object in the normative shape above. Never run the suite or boot the
+application; the coordinator
 owns the single final run. Do not delegate a second repair, continue another
 agent, or request another repair round. If work remains at the turn ceiling,
 record it in `unresolved_promises` so the coordinator can produce an honest

package/plugin/codex/agents/suite-worker.toml

@@ -16,7 +16,12 @@ native budget stop, preserve the supplied checkpoint and completed files and
 continue only its `unresolved_promises`; never initialize that checkpoint again.
 Update the checkpoint after every completed promise. Also keep `known_problems` as a compact
 array of precise unresolved harness problems (empty when none are known). Facts are short statements with
-source references; never embed source files, suite copies, or transcript.
+source references. The normative JSON shape of one facts entry is:
+```json
+{"fact":"The route creates an order.","source_refs":["app/orders.rb:12"]}
+```
+Every facts entry is an object in that shape, never a string. Never embed source
+files, suite copies, or transcript.
 
 Read only the initial `source_paths` and dependencies needed for the finite
 planned cases. Ask closed questions with the files to look in. For a closed
@@ -31,7 +36,9 @@ copy it into an owned file.
 
 Never run the suite, boot the application, or perform branch-global duplicate,
 marker, metadata, or surface validation. You may make one final read of your
-owned files before handoff. Do not create temporary self-validation scripts or
+owned files before handoff. During that final read, confirm every `facts` entry
+is an object in the normative shape above and correct the checkpoint if it is
+not. Do not create temporary self-validation scripts or
 loop over repeated rereads. If the turn ceiling arrives, leave partial files and
 an accurate checkpoint; the coordinator will rotate unresolved work into one
 fresh repair task.