@cleocode/cleo 2026.5.0 → 2026.5.1

package/dist/cli/commands/complete.d.ts

@@ -13,8 +13,13 @@
  * when a task touches symbols with CRITICAL impact risk. The acknowledgment is
  * audited to `.cleo/audit/nexus-risk-ack.jsonl`.
  *
+ * As of T1632, `cleo complete <epicId>` is REJECTED with E_EPIC_HAS_PENDING_CHILDREN
+ * when the epic has pending or active children. Pass `--override-reason "<reason>"`
+ * to bypass (audited to `.cleo/audit/premature-close.jsonl`).
+ *
  * @task T4461
  * @task T832
+ * @task T1632
  * @adr ADR-051
  * @epic T4454
  */
@@ -45,5 +50,9 @@ export declare const completeCommand: import("citty").CommandDef<{
         readonly type: "string";
         readonly description: "Reason for acknowledging CRITICAL impact risk (bypasses nexusImpact gate)";
     };
+    readonly 'override-reason': {
+        readonly type: "string";
+        readonly description: "Reason for bypassing E_EPIC_HAS_PENDING_CHILDREN guard (audited to .cleo/audit/premature-close.jsonl)";
+    };
 }>;
 //# sourceMappingURL=complete.d.ts.map

package/dist/cli/commands/complete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;EAwD1B,CAAC"}
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/complete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;EA8D1B,CAAC"}

package/dist/cli/index.js

@@ -416,6 +416,7 @@ var init_exit_codes = __esm({
       ExitCode2[ExitCode2["VERIFICATION_LOCKED"] = 46] = "VERIFICATION_LOCKED";
       ExitCode2[ExitCode2["ROUND_MISMATCH"] = 47] = "ROUND_MISMATCH";
       ExitCode2[ExitCode2["AC_LOCKED"] = 48] = "AC_LOCKED";
+      ExitCode2[ExitCode2["EPIC_HAS_PENDING_CHILDREN"] = 49] = "EPIC_HAS_PENDING_CHILDREN";
       ExitCode2[ExitCode2["CONTEXT_WARNING"] = 50] = "CONTEXT_WARNING";
       ExitCode2[ExitCode2["CONTEXT_CAUTION"] = 51] = "CONTEXT_CAUTION";
       ExitCode2[ExitCode2["CONTEXT_CRITICAL"] = 52] = "CONTEXT_CRITICAL";
@@ -465,6 +466,7 @@ var init_exit_codes = __esm({
       ExitCode2[ExitCode2["ALREADY_EXISTS"] = 101] = "ALREADY_EXISTS";
       ExitCode2[ExitCode2["NO_CHANGE"] = 102] = "NO_CHANGE";
       ExitCode2[ExitCode2["TESTS_SKIPPED"] = 103] = "TESTS_SKIPPED";
+      ExitCode2[ExitCode2["DUPLICATE_TASK_LIKELY"] = 105] = "DUPLICATE_TASK_LIKELY";
       ExitCode2[ExitCode2["LAFS_VIOLATION"] = 104] = "LAFS_VIOLATION";
       return ExitCode2;
     })(ExitCode || {});
@@ -24218,7 +24220,9 @@ var init_tasks3 = __esm({
             // T944: orthogonal axes — role is the canonical wire field (ADR-057 D2)
             role: params.role,
             scope: params.scope,
-            severity: params.severity
+            severity: params.severity,
+            // T1633: BRAIN duplicate-bypass flag
+            forceDuplicate: params.forceDuplicate
           }),
           "add"
         );
@@ -24260,7 +24264,11 @@ var init_tasks3 = __esm({
             "complete"
           );
         }
-        const result = await completeTaskStrict(projectRoot, params.taskId, params.notes);
+        const result = await completeTaskStrict(projectRoot, params.taskId, {
+          notes: params.notes,
+          overrideReason: params.overrideReason,
+          acknowledgeRisk: params.acknowledgeRisk
+        });
         setImmediate(async () => {
           try {
             const { trackMemoryUsage } = await import("@cleocode/core/internal");
@@ -26882,6 +26890,19 @@ var addCommand = defineCommand({
     severity: {
       type: "string",
       description: "Bug severity (P0|P1|P2|P3) \u2014 only valid with --role bug (T944)"
+    },
+    /**
+     * Bypass the E_DUPLICATE_TASK_LIKELY rejection guard.
+     *
+     * When passed, `cleo add` proceeds even if BRAIN similarity scoring
+     * determines the task is very likely a duplicate (score >= 0.92).
+     * The bypass is audited to `.cleo/audit/duplicate-bypass.jsonl`.
+     *
+     * @task T1633
+     */
+    "force-duplicate": {
+      type: "boolean",
+      description: "Bypass BRAIN duplicate-task rejection (audited to .cleo/audit/duplicate-bypass.jsonl) (T1633)"
     }
   },
   async run({ args, cmd }) {
@@ -26916,6 +26937,7 @@ var addCommand = defineCommand({
       params["role"] = params["role"] ?? args.kind;
     if (args.scope !== void 0) params["scope"] = args.scope;
     if (args.severity !== void 0) params["severity"] = args.severity;
+    if (args["force-duplicate"] !== void 0) params["forceDuplicate"] = args["force-duplicate"];
     const inferred = await inferTaskAddParams(getProjectRoot18(), {
       title: args.title,
       description: args.description ?? args.desc,
@@ -33013,6 +33035,10 @@ var completeCommand = defineCommand({
     "acknowledge-risk": {
       type: "string",
       description: "Reason for acknowledging CRITICAL impact risk (bypasses nexusImpact gate)"
+    },
+    "override-reason": {
+      type: "string",
+      description: "Reason for bypassing E_EPIC_HAS_PENDING_CHILDREN guard (audited to .cleo/audit/premature-close.jsonl)"
     }
   },
   async run({ args }) {
@@ -33021,7 +33047,8 @@ var completeCommand = defineCommand({
       notes: args.notes,
       changeset: args.changeset,
       verificationNote: args["verification-note"],
-      acknowledgeRisk: args["acknowledge-risk"]
+      acknowledgeRisk: args["acknowledge-risk"],
+      overrideReason: args["override-reason"]
     });
     if (!response.success) {
       handleRawError(response, { command: "complete", operation: "tasks.complete" });
@@ -34000,30 +34027,88 @@ var currentCommand = defineCommand({
 import { homedir as homedir2 } from "node:os";
 import { join as join9 } from "node:path";
 import { getGCDaemonStatus, spawnGCDaemon, stopGCDaemon } from "@cleocode/core/gc/daemon.js";
-async function showDaemonStatus(cleoDir, json2) {
+import { getSentientDaemonStatus } from "@cleocode/core/sentient";
+async function showDaemonStatus(cleoDir, projectRoot, json2) {
   try {
-    const status = await getGCDaemonStatus(cleoDir);
-    const result = { success: true, data: status };
+    const gcStatus = await getGCDaemonStatus(cleoDir);
+    let hygieneLastRunAt = null;
+    let hygieneSummary = null;
+    let hygieneStats = {
+      projectsChecked: 0,
+      projectsHealthy: 0,
+      tempGcCandidates: 0,
+      duplicateEpicGroups: 0,
+      worktreesPruned: 0
+    };
+    try {
+      const sentientStatus = await getSentientDaemonStatus(projectRoot);
+      hygieneLastRunAt = sentientStatus.hygieneLastRunAt;
+      hygieneSummary = sentientStatus.hygieneSummary;
+      hygieneStats = sentientStatus.hygieneStats;
+    } catch {
+    }
+    const result = {
+      success: true,
+      data: {
+        gc: gcStatus,
+        hygiene: {
+          lastRunAt: hygieneLastRunAt,
+          summary: hygieneSummary,
+          stats: hygieneStats
+        }
+      }
+    };
     if (json2) {
       process.stdout.write(JSON.stringify(result) + "\n");
     } else {
-      const runningStr = status.running ? `running (PID ${status.pid})` : "stopped";
-      process.stdout.write(`Daemon:       ${runningStr}
+      const runningStr = gcStatus.running ? `running (PID ${gcStatus.pid})` : "stopped";
+      process.stdout.write(`GC Daemon:       ${runningStr}
 `);
-      process.stdout.write(`Started at:   ${status.startedAt ?? "never"}
+      process.stdout.write(`Started at:      ${gcStatus.startedAt ?? "never"}
 `);
-      process.stdout.write(`Last GC run:  ${status.lastRunAt ?? "never"}
+      process.stdout.write(`Last GC run:     ${gcStatus.lastRunAt ?? "never"}
 `);
-      const diskStr = status.lastDiskUsedPct !== null ? `${status.lastDiskUsedPct.toFixed(1)}%` : "unknown";
-      process.stdout.write(`Disk used:    ${diskStr}
+      const diskStr = gcStatus.lastDiskUsedPct !== null ? `${gcStatus.lastDiskUsedPct.toFixed(1)}%` : "unknown";
+      process.stdout.write(`Disk used:       ${diskStr}
 `);
-      if (status.escalationNeeded) {
+      if (gcStatus.escalationNeeded) {
         process.stdout.write(
           `
 WARNING: Disk threshold breached. Run 'cleo gc run' to reclaim space.
 `
         );
       }
+      process.stdout.write(`
+Hygiene Loop (cross-project):
+`);
+      process.stdout.write(`  Last run:        ${hygieneLastRunAt ?? "never"}
+`);
+      process.stdout.write(`  Summary:         ${hygieneSummary ?? "not yet run"}
+`);
+      if (hygieneStats.projectsChecked > 0) {
+        process.stdout.write(
+          `  Projects:        ${hygieneStats.projectsHealthy}/${hygieneStats.projectsChecked} healthy
+`
+        );
+        if (hygieneStats.tempGcCandidates > 0) {
+          process.stdout.write(
+            `  Temp GC:         ${hygieneStats.tempGcCandidates} candidate(s) pending approval
+`
+          );
+        }
+        if (hygieneStats.duplicateEpicGroups > 0) {
+          process.stdout.write(
+            `  Duplicate epics: ${hygieneStats.duplicateEpicGroups} group(s) detected
+`
+          );
+        }
+        if (hygieneStats.worktreesPruned > 0) {
+          process.stdout.write(
+            `  Worktrees:       ${hygieneStats.worktreesPruned} stale worktree(s) pruned
+`
+          );
+        }
+      }
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -34144,7 +34229,7 @@ var stopCommand3 = defineCommand({
 var statusCommand4 = defineCommand({
   meta: {
     name: "status",
-    description: "Show daemon running state, PID, last GC run, and disk usage"
+    description: "Show daemon running state, PID, last GC run, disk usage, and cross-project hygiene summary"
   },
   args: {
     "cleo-dir": {
@@ -34158,7 +34243,7 @@ var statusCommand4 = defineCommand({
   },
   async run({ args }) {
     const cleoDir = args["cleo-dir"] ?? join9(homedir2(), ".cleo");
-    await showDaemonStatus(cleoDir, args.json ?? false);
+    await showDaemonStatus(cleoDir, process.cwd(), args.json ?? false);
   }
 });
 var daemonCommand = defineCommand({
@@ -34184,7 +34269,7 @@ var daemonCommand = defineCommand({
   async run({ args, cmd, rawArgs }) {
     if (isSubCommandDispatch(rawArgs, cmd.subCommands)) return;
     const cleoDir = args["cleo-dir"] ?? join9(homedir2(), ".cleo");
-    await showDaemonStatus(cleoDir, args.json ?? false);
+    await showDaemonStatus(cleoDir, process.cwd(), args.json ?? false);
   }
 });
 
@@ -34199,6 +34284,10 @@ var dashCommand = defineCommand({
     "blocked-limit": {
       type: "string",
       description: "Max blocked tasks to show"
+    },
+    "no-hygiene": {
+      type: "boolean",
+      description: "Suppress the hygiene section note"
     }
   },
   async run({ args }) {
@@ -34211,6 +34300,11 @@ var dashCommand = defineCommand({
       },
       { command: "dash" }
     );
+    if (!args["no-hygiene"]) {
+      process.stdout.write(
+        "\n--- Sentient Hygiene (T1636) ---\nBackground scan runs every 4h (dream cycle). Run `cleo memory digest --hygiene` to see the latest hygiene observations (orphan tasks, top-level tasks without an epic, content defects, premature-close leaks).\n"
+      );
+    }
   }
 });
 
@@ -40266,21 +40360,49 @@ var backfillCommand3 = defineCommand({
     await showUsage(cmd);
   }
 });
-var digestCommand = makeMemorySubcommand({
-  name: "digest",
-  description: "Summarized top-N brain observations for session briefing (T1006). Sorted by citation_count + quality_score.",
+var digestCommand = defineCommand({
+  meta: {
+    name: "digest",
+    description: "Summarized top-N brain observations for session briefing (T1006). Pass --hygiene to show latest hygiene scan results from the sentient background loop (T1636)."
+  },
   args: {
     limit: {
       type: "string",
       description: "Maximum number of observations to include (default: 10)."
+    },
+    hygiene: {
+      type: "boolean",
+      description: "Show only hygiene observations (hygiene:orphan, hygiene:top-level-orphan, hygiene:content-defect, hygiene:premature-close-leak) from the sentient background loop (T1636)."
+    },
+    json: {
+      type: "boolean",
+      description: "Output as JSON"
     }
   },
-  gateway: "query",
-  operation: "digest",
-  output: { command: "memory-digest", operation: "memory.digest" },
-  paramBuilder: (args) => ({
-    ...args["limit"] !== void 0 && { limit: parseInt(args["limit"], 10) }
-  })
+  async run({ args }) {
+    if (args.hygiene) {
+      await dispatchFromCli(
+        "query",
+        "memory",
+        "find",
+        {
+          query: "hygiene:",
+          limit: args.limit !== void 0 ? parseInt(args.limit, 10) : 20
+        },
+        { command: "memory-hygiene-digest", operation: "memory.find" }
+      );
+    } else {
+      await dispatchFromCli(
+        "query",
+        "memory",
+        "digest",
+        {
+          ...args["limit"] !== void 0 && { limit: parseInt(args["limit"], 10) }
+        },
+        { command: "memory-digest", operation: "memory.digest" }
+      );
+    }
+  }
 });
 var recentCommand = makeMemorySubcommand({
   name: "recent",
@@ -48696,7 +48818,7 @@ async function runPostUpdateDiagnostics(opts) {
 import { join as join16 } from "node:path";
 import { cwd as processCwd } from "node:process";
 import {
-  getSentientDaemonStatus,
+  getSentientDaemonStatus as getSentientDaemonStatus2,
   resumeSentientDaemon,
   SENTIENT_STATE_FILE,
   spawnSentientDaemon,
@@ -48754,7 +48876,7 @@ var startSub = defineCommand({
     const jsonMode = args.json === true;
     const dryRun = args["dry-run"] === true;
     try {
-      const existing = await getSentientDaemonStatus(projectRoot);
+      const existing = await getSentientDaemonStatus2(projectRoot);
       if (existing.running && existing.pid) {
         emitSuccess(
           { running: true, pid: existing.pid, message: "daemon already running" },
@@ -48822,7 +48944,7 @@ var statusSub = defineCommand({
     const projectRoot = resolveProjectRoot4(args.project);
     const jsonMode = args.json === true;
     try {
-      const status = await getSentientDaemonStatus(projectRoot);
+      const status = await getSentientDaemonStatus2(projectRoot);
       if (jsonMode) {
         process.stdout.write(`${JSON.stringify({ success: true, data: status })}
 `);
@@ -49334,7 +49456,7 @@ var sentientCommand = defineCommand({
     const projectRoot = resolveProjectRoot4(args.project);
     const jsonMode = args.json === true;
     try {
-      const status = await getSentientDaemonStatus(projectRoot);
+      const status = await getSentientDaemonStatus2(projectRoot);
       if (jsonMode) {
         process.stdout.write(`${JSON.stringify({ success: true, data: status })}
 `);