@cleocode/cleo 2026.5.28 → 2026.5.29

package/dist/cli/index.js

@@ -468,6 +468,7 @@ var init_exit_codes = __esm({
       ExitCode2[ExitCode2["TESTS_SKIPPED"] = 103] = "TESTS_SKIPPED";
       ExitCode2[ExitCode2["DUPLICATE_TASK_LIKELY"] = 105] = "DUPLICATE_TASK_LIKELY";
       ExitCode2[ExitCode2["LAFS_VIOLATION"] = 104] = "LAFS_VIOLATION";
+      ExitCode2[ExitCode2["DECISION_VALIDATOR_FAILED"] = 106] = "DECISION_VALIDATOR_FAILED";
       return ExitCode2;
     })(ExitCode || {});
   }
@@ -562,6 +563,13 @@ var init_facade = __esm({
   }
 });
 
+// packages/contracts/src/graph.ts
+var init_graph = __esm({
+  "packages/contracts/src/graph.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/lafs.ts
 var init_lafs = __esm({
   "packages/contracts/src/lafs.ts"() {
@@ -1010,6 +1018,7 @@ var init_src = __esm({
     init_evidence_record_schema();
     init_exit_codes();
     init_facade();
+    init_graph();
     init_lafs();
     init_operations();
     init_params();
@@ -3538,6 +3547,54 @@ var init_registry = __esm({
         requiredParams: [],
         params: []
       },
+      {
+        gateway: "query",
+        domain: "tasks",
+        operation: "deps.validate",
+        description: "tasks.deps.validate (query) \u2014 validate dependency graph integrity for an epic or all tasks",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "epicId",
+            type: "string",
+            required: false,
+            description: "Scope validation to direct children of this epic (optional)"
+          },
+          {
+            name: "scope",
+            type: "string",
+            required: false,
+            description: "Which tasks to include: 'all', 'open', or 'critical' (default: 'all')"
+          }
+        ]
+      },
+      {
+        gateway: "query",
+        domain: "tasks",
+        operation: "deps.tree",
+        description: "tasks.deps.tree (query) \u2014 render dependency tree for an epic in text, mermaid, or json format",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["epicId"],
+        params: [
+          {
+            name: "epicId",
+            type: "string",
+            required: true,
+            description: "Epic ID to visualize (required)"
+          },
+          {
+            name: "format",
+            type: "string",
+            required: false,
+            description: "Output format: 'text', 'mermaid', or 'json' (default: 'text')"
+          }
+        ]
+      },
       {
         gateway: "query",
         domain: "tasks",
@@ -10581,6 +10638,8 @@ __export(engine_exports, {
   taskDeps: () => taskDeps,
   taskDepsCycles: () => taskDepsCycles,
   taskDepsOverview: () => taskDepsOverview,
+  taskDepsTree: () => taskDepsTree,
+  taskDepsValidate: () => taskDepsValidate,
   taskExists: () => taskExists,
   taskExport: () => taskExport,
   taskFind: () => taskFind,
@@ -10763,6 +10822,8 @@ import {
   taskDeps,
   taskDepsCycles,
   taskDepsOverview,
+  taskDepsTree,
+  taskDepsValidate,
   taskExists,
   taskExport,
   taskFind,
@@ -14720,7 +14781,9 @@ var init_memory2 = __esm({
                 {
                   query: paramString(params, "query"),
                   taskId: paramString(params, "taskId"),
-                  limit: paramNumber(params, "limit")
+                  limit: paramNumber(params, "limit"),
+                  // T1830: opt-in to AGT-* dispatch rows; excluded by default
+                  includeAgentDispatch: paramBool(params, "includeAgentDispatch") ?? false
                 },
                 projectRoot
               );
@@ -22481,7 +22544,9 @@ async function orchestrateNextOp(params) {
   return orchestrateNext(params.epicId, getProjectRoot9());
 }
 async function orchestrateReadyOp(params) {
-  return orchestrateReady(params.epicId, getProjectRoot9());
+  return orchestrateReady(params.epicId, getProjectRoot9(), {
+    ignoreDepsValidate: params.ignoreDepsValidate
+  });
 }
 async function orchestrateAnalyzeOp(params) {
   if (params.mode === "parallel-safety") {
@@ -23179,7 +23244,10 @@ var init_orchestrate2 = __esm({
                   "epicId is required",
                   startTime
                 );
-              const p = { epicId: params.epicId };
+              const p = {
+                epicId: params.epicId,
+                ignoreDepsValidate: params.ignoreDepsValidate
+              };
               return wrapResult(await coreOps.ready(p), "query", "orchestrate", operation, startTime);
             }
             case "analyze": {
@@ -25683,6 +25751,23 @@ var init_tasks3 = __esm({
           "depends"
         );
       },
+      "deps.validate": async (params) => {
+        const projectRoot = getProjectRoot15();
+        return wrapCoreResult(
+          await taskDepsValidate(projectRoot, params.epicId, params.scope),
+          "deps.validate"
+        );
+      },
+      "deps.tree": async (params) => {
+        const projectRoot = getProjectRoot15();
+        if (!params.epicId) {
+          return lafsError("E_INVALID_INPUT", "epicId is required for deps.tree", "deps.tree");
+        }
+        return wrapCoreResult(
+          await taskDepsTree(projectRoot, params.epicId, params.format),
+          "deps.tree"
+        );
+      },
       analyze: async (params) => {
         const projectRoot = getProjectRoot15();
         return wrapCoreResult(
@@ -25943,6 +26028,8 @@ var init_tasks3 = __esm({
       "tree",
       "blockers",
       "depends",
+      "deps.validate",
+      "deps.tree",
       "analyze",
       "impact",
       "next",
@@ -26054,6 +26141,8 @@ var init_tasks3 = __esm({
             "tree",
             "blockers",
             "depends",
+            "deps.validate",
+            "deps.tree",
             "analyze",
             "impact",
             "next",
@@ -36105,6 +36194,71 @@ var cyclesCommand = defineCommand({
     );
   }
 });
+var validateCommand5 = defineCommand({
+  meta: {
+    name: "validate",
+    description: "Validate dep graph \u2014 orphan, circular, cross-epic gap, stale-dep detection"
+  },
+  args: {
+    epic: {
+      type: "string",
+      description: "Scope validation to direct children of this epic ID"
+    },
+    scope: {
+      type: "string",
+      description: "Which tasks to include: all (default), open, or critical",
+      default: "all"
+    }
+  },
+  async run({ args }) {
+    await dispatchFromCli(
+      "query",
+      "tasks",
+      "deps.validate",
+      {
+        epicId: args.epic,
+        scope: args.scope
+      },
+      { command: "deps", operation: "tasks.deps.validate" }
+    );
+  }
+});
+var depsTreeCommand = defineCommand({
+  meta: {
+    name: "tree",
+    description: "Render the dep-graph tree for an epic (text/mermaid/json)"
+  },
+  args: {
+    epic: {
+      type: "string",
+      description: "Epic ID to visualize",
+      required: true
+    },
+    json: {
+      type: "boolean",
+      description: "Emit machine-readable JSON tree",
+      default: false
+    },
+    mermaid: {
+      type: "boolean",
+      description: "Emit Mermaid graph TD block",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const format = args.json ? "json" : args.mermaid ? "mermaid" : "text";
+    await dispatchFromCli(
+      "query",
+      "tasks",
+      "deps.tree",
+      {
+        epicId: args.epic,
+        format
+      },
+      { command: "deps", operation: "tasks.deps.tree" }
+    );
+  }
+});
 var depsCommand = defineCommand({
   meta: { name: "deps", description: "Dependency visualization and analysis" },
   subCommands: {
@@ -36113,7 +36267,9 @@ var depsCommand = defineCommand({
     waves: wavesCommand,
     "critical-path": criticalPathCommand,
     impact: impactCommand,
-    cycles: cyclesCommand
+    cycles: cyclesCommand,
+    validate: validateCommand5,
+    tree: depsTreeCommand
   },
   async run({ cmd, rawArgs }) {
     const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -40306,6 +40462,10 @@ var decisionFindCommand = defineCommand({
       type: "string",
       description: "Maximum results"
     },
+    "include-agent-dispatch": {
+      type: "boolean",
+      description: "Include AGT-* agent dispatch rows (excluded by default \u2014 use to surface execution history)"
+    },
     json: {
       type: "boolean",
       description: "Output as JSON"
@@ -40318,7 +40478,9 @@ var decisionFindCommand = defineCommand({
       "decision.find",
       {
         query: args.query ?? "",
-        limit: args.limit !== void 0 ? parseInt(args.limit, 10) : void 0
+        limit: args.limit !== void 0 ? parseInt(args.limit, 10) : void 0,
+        // T1830: pass flag so the engine can filter by decision_category
+        includeAgentDispatch: args["include-agent-dispatch"] === true
       },
       { command: "memory", operation: "memory.decision.find" }
     );
@@ -44777,6 +44939,10 @@ var readyCommand = defineCommand({
       type: "positional",
       description: "Epic ID to query",
       required: true
+    },
+    "ignore-deps-validate": {
+      type: "boolean",
+      description: "Skip dep-graph validation and proceed even if issues exist (audit-logged bypass). CLI-only \u2014 sentient mode does not support this flag."
     }
   },
   async run({ args }) {
@@ -44784,7 +44950,10 @@ var readyCommand = defineCommand({
       "query",
       "orchestrate",
       "ready",
-      { epicId: args.epicId },
+      {
+        epicId: args.epicId,
+        ignoreDepsValidate: args["ignore-deps-validate"] === true
+      },
       { command: "orchestrate" }
     );
   }
@@ -44897,7 +45066,7 @@ var spawnCommand2 = defineCommand({
     );
   }
 });
-var validateCommand5 = defineCommand({
+var validateCommand6 = defineCommand({
   meta: { name: "validate", description: "Validate subagent output" },
   args: {
     taskId: {
@@ -45462,7 +45631,7 @@ var orchestrateCommand = defineCommand({
     waves: wavesCommand2,
     plan: planCommand,
     spawn: spawnCommand2,
-    validate: validateCommand5,
+    validate: validateCommand6,
     context: contextCommand4,
     ivtr: ivtrCommand,
     parallel: parallelCommand,
@@ -46060,7 +46229,7 @@ var listCommand13 = defineCommand({
     );
   }
 });
-var validateCommand6 = defineCommand({
+var validateCommand7 = defineCommand({
   meta: {
     name: "validate",
     description: "Parse and validate a .cantbook file \u2014 exit 0 on success, exit 70 on parse error (T1261)"
@@ -46094,7 +46263,7 @@ var playbookCommand = defineCommand({
     resume: resumeCommand,
     list: listCommand13,
     create: createCommand2,
-    validate: validateCommand6
+    validate: validateCommand7
   },
   async run({ cmd, rawArgs }) {
     const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -50115,7 +50284,7 @@ var searchCommand3 = defineCommand({
     );
   }
 });
-var validateCommand7 = defineCommand({
+var validateCommand8 = defineCommand({
   meta: { name: "validate", description: "Validate skill against protocol" },
   args: {
     "skill-name": {
@@ -50382,7 +50551,7 @@ var skillsCommand2 = defineCommand({
   subCommands: {
     list: listCommand20,
     search: searchCommand3,
-    validate: validateCommand7,
+    validate: validateCommand8,
     info: infoCommand,
     install: installCommand3,
     uninstall: uninstallCommand2,
@@ -51004,7 +51173,7 @@ var syncCommand5 = defineCommand({
 
 // packages/cleo/src/cli/commands/testing.ts
 init_cli();
-var validateCommand8 = defineCommand({
+var validateCommand9 = defineCommand({
   meta: { name: "validate", description: "Validate testing protocol compliance for a task" },
   args: {
     taskId: {
@@ -51104,7 +51273,7 @@ var runCommand4 = defineCommand({
 var testingCommand = defineCommand({
   meta: { name: "testing", description: "Validate testing protocol compliance" },
   subCommands: {
-    validate: validateCommand8,
+    validate: validateCommand9,
     check: checkCommand7,
     status: statusCommand12,
     coverage: coverageCommand,