@cleocode/core 2026.9.2 → 2026.9.4

package/dist/dispatch/suggested-next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suggested-next.d.ts","sourceRoot":"","sources":["../../src/dispatch/suggested-next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAqClD;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;AAEhG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,OAAO,GACb,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,OAAO,GACb,MAAM,EAAE,CAEV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAKV;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAMxF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,GACjC,WAAW,CAAC,CAAC,CAAC,CAQhB"}
+{"version":3,"file":"suggested-next.d.ts","sourceRoot":"","sources":["../../src/dispatch/suggested-next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAqClD;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;AAEhG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,OAAO,GACb,MAAM,EAAE,CAUV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,OAAO,GACb,MAAM,EAAE,CAEV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,OAAO,GACZ,MAAM,EAAE,CAKV;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAMxF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EACxB,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,GACjC,WAAW,CAAC,CAAC,CAAC,CAQhB"}

package/dist/dispatch/suggested-next.js

@@ -65,7 +65,13 @@ export function buildTasksAddBatchSuggestedNext(params, _data) {
     const parentId = params.defaultParent;
     if (typeof parentId !== 'string' || parentId.length === 0)
         return [];
-    return [`cleo list --parent ${parentId}`, `cleo orchestrate ready --epic ${parentId}`];
+    // gh#1373: `--epic` is not a flag on `orchestrate ready` — the command takes
+    // EPICID as a POSITIONAL (`USAGE orchestrate ready [OPTIONS] <EPICID>`). mri
+    // defaults an undeclared flag to boolean, so `--epic T9` set a no-op `true`
+    // and `T9` fell through to the positional: the suggestion worked by accident.
+    // CLEO emitting its own unrunnable-by-design advice is worse than a stale
+    // doc, because an agent reads a `suggestedNext` as authoritative.
+    return [`cleo list --parent ${parentId}`, `cleo orchestrate ready ${parentId}`];
 }
 /**
  * Build a `suggestedNext` array for the `tasks.update` operation.

package/dist/dispatch/suggested-next.js.map

@@ -1 +1 @@
-{"version":3,"file":"suggested-next.js","sourceRoot":"","sources":["../../src/dispatch/suggested-next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAmDH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAgC,EAChC,IAAa;IAEb,MAAM,EAAE,GAAI,IAAwC,EAAE,IAAI,EAAE,EAAE,CAAC;IAC/D,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAA+B,EAC/B,KAAc;IAEd,MAAM,QAAQ,GAAI,MAAmC,CAAC,aAAa,CAAC;IACpE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrE,OAAO,CAAC,sBAAsB,QAAQ,EAAE,EAAE,iCAAiC,QAAQ,EAAE,CAAC,CAAC;AACzF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAgC,EAChC,IAAa;IAEb,MAAM,EAAE,GAAI,IAAyC,EAAE,IAAI,EAAE,EAAE,CAAC;IAChE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAgC,EAChC,KAAc;IAEd,OAAO,CAAC,WAAW,EAAE,yCAAyC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAgC,EAChC,IAAa;IAEb,MAAM,KAAK,GAAI,IAAyC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;IACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAmD;IAC3F,GAAG,EAAE,0BAA0B;IAC/B,WAAW,EAAE,+BAA+B;IAC5C,MAAM,EAAE,6BAA6B;IACrC,QAAQ,EAAE,+BAA+B;IACzC,IAAI,EAAE,2BAA2B;CAClC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,WAAkC;IAElC,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE;YACJ,GAAG,QAAQ,CAAC,IAAI;YAChB,aAAa,EAAE,CAAC,GAAG,WAAW,CAAC;SAChC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"suggested-next.js","sourceRoot":"","sources":["../../src/dispatch/suggested-next.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAmDH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAgC,EAChC,IAAa;IAEb,MAAM,EAAE,GAAI,IAAwC,EAAE,IAAI,EAAE,EAAE,CAAC;IAC/D,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAA+B,EAC/B,KAAc;IAEd,MAAM,QAAQ,GAAI,MAAmC,CAAC,aAAa,CAAC;IACpE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrE,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,8EAA8E;IAC9E,0EAA0E;IAC1E,kEAAkE;IAClE,OAAO,CAAC,sBAAsB,QAAQ,EAAE,EAAE,0BAA0B,QAAQ,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAgC,EAChC,IAAa;IAEb,MAAM,EAAE,GAAI,IAAyC,EAAE,IAAI,EAAE,EAAE,CAAC;IAChE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAgC,EAChC,KAAc;IAEd,OAAO,CAAC,WAAW,EAAE,yCAAyC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAgC,EAChC,IAAa;IAEb,MAAM,KAAK,GAAI,IAAyC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;IACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzD,OAAO,CAAC,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAmD;IAC3F,GAAG,EAAE,0BAA0B;IAC/B,WAAW,EAAE,+BAA+B;IAC5C,MAAM,EAAE,6BAA6B;IACrC,QAAQ,EAAE,+BAA+B;IACzC,IAAI,EAAE,2BAA2B;CAClC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,WAAkC;IAElC,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE;YACJ,GAAG,QAAQ,CAAC,IAAI;YAChB,aAAa,EAAE,CAAC,GAAG,WAAW,CAAC;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/docs/export-document.js

@@ -1024,6 +1024,83 @@ var init_docs = __esm({
   }
 });
 
+// packages/contracts/src/operations/check.ts
+var VERIFICATION_SCHEMA, GATE_RESULT_SCHEMA, GATE_FIELD_POINTERS, checkGateSetOutputContract, checkGateStatusOutputContract;
+var init_check = __esm({
+  "packages/contracts/src/operations/check.ts"() {
+    "use strict";
+    VERIFICATION_SCHEMA = {
+      type: "object",
+      additionalProperties: true,
+      properties: {
+        passed: { type: "boolean", description: "True when every required gate is set." },
+        round: { type: "number", description: "IVTR round counter." },
+        gates: {
+          type: "object",
+          additionalProperties: { type: "boolean" },
+          description: "Gate name \u2192 whether it is recorded as passed."
+        },
+        evidence: {
+          type: "object",
+          additionalProperties: true,
+          description: "Gate name \u2192 the evidence atom kinds validated for it."
+        }
+      }
+    };
+    GATE_RESULT_SCHEMA = {
+      type: "object",
+      required: ["taskId", "verification", "verificationStatus", "passed"],
+      additionalProperties: true,
+      properties: {
+        taskId: { type: "string", description: "The task the gates belong to." },
+        title: { type: "string", description: "Task title, for operator display." },
+        status: { type: "string", description: "Task lifecycle status." },
+        type: { type: "string", description: "Task type (epic | task | subtask)." },
+        verification: VERIFICATION_SCHEMA,
+        verificationStatus: {
+          type: "string",
+          enum: ["passed", "pending"],
+          description: "Whether every required gate is now recorded."
+        },
+        passed: { type: "boolean", description: "Mirror of verification.passed." },
+        round: { type: "number", description: "IVTR round counter." },
+        requiredGates: {
+          type: "array",
+          items: { type: "string" },
+          description: "Gates this project requires before complete."
+        },
+        missingGates: {
+          type: "array",
+          items: { type: "string" },
+          description: "Required gates not yet recorded \u2014 empty means ready to complete."
+        }
+      }
+    };
+    GATE_FIELD_POINTERS = [
+      "/data/taskId",
+      "/data/verification",
+      "/data/verification/passed",
+      "/data/verification/gates",
+      "/data/verificationStatus",
+      "/data/passed",
+      "/data/missingGates",
+      "/data/requiredGates"
+    ];
+    checkGateSetOutputContract = {
+      operation: "check.gate.set",
+      shapeNote: "FLAT record, not the nested read shape. The verification object is at /data/verification \u2014 NEVER /data/task/verification, which is how `cleo show` nests a task and does not exist here. The response is self-confirming: it returns the full verification after the write, so there is no need to re-read.",
+      dataSchema: { ...GATE_RESULT_SCHEMA },
+      fieldPointers: [...GATE_FIELD_POINTERS]
+    };
+    checkGateStatusOutputContract = {
+      operation: "check.gate.status",
+      shapeNote: "FLAT record identical in shape to check.gate.set. Read-only: reports which gates are recorded and which are still missing. /data/missingGates being empty is the precondition for `cleo complete`.",
+      dataSchema: { ...GATE_RESULT_SCHEMA },
+      fieldPointers: [...GATE_FIELD_POINTERS]
+    };
+  }
+});
+
 // packages/contracts/src/operations/entities.ts
 var ACCOUNT_VIEW_SCHEMA, accountAddOutputContract, accountListOutputContract, accountRemoveOutputContract, PROVIDER_VIEW_SCHEMA, providerListOutputContract, providerShowOutputContract, providerConnectOutputContract, MODEL_VIEW_SCHEMA, modelQueryOutputContract, modelShowOutputContract, profileCreateOutputContract, profileListOutputContract, profilePinOutputContract, profileUseOutputContract;
 var init_entities = __esm({
@@ -1471,6 +1548,7 @@ var tasksShowOutputContract, tasksListOutputContract, tasksFindOutputContract, T
 var init_output_contracts_data = __esm({
   "packages/contracts/src/operations/output-contracts-data.ts"() {
     "use strict";
+    init_check();
     init_entities();
     init_service();
     tasksShowOutputContract = {
@@ -1822,6 +1900,11 @@ var init_output_contracts_data = __esm({
       fieldPointers: ["/data/key", "/data/scope", "/data/removed"]
     };
     OUTPUT_CONTRACTS = {
+      // gate verification (T12192 · gh#1420 · gh#1423) — `cleo verify`, the op
+      // every agent is told to run before every `cleo complete`, previously fell
+      // through to the generic contract with an EMPTY pointer list.
+      "check.gate.set": checkGateSetOutputContract,
+      "check.gate.status": checkGateStatusOutputContract,
       "tasks.show": tasksShowOutputContract,
       "tasks.list": tasksListOutputContract,
       "tasks.find": tasksFindOutputContract,
@@ -13691,6 +13774,7 @@ var init_operations = __esm({
     init_agent_operation_contract();
     init_attention();
     init_brain();
+    init_check();
     init_conduit();
     init_dialectic();
     init_docs();