@cleocode/cleo 2026.5.93 → 2026.5.95

package/dist/cli/index.js

@@ -1577,6 +1577,13 @@ var init_changesets = __esm({
   }
 });
 
+// packages/contracts/src/cli-category.ts
+var init_cli_category = __esm({
+  "packages/contracts/src/cli-category.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/credentials.ts
 var init_credentials = __esm({
   "packages/contracts/src/credentials.ts"() {
@@ -2969,7 +2976,7 @@ var init_peer = __esm({
 
 // packages/contracts/src/release/evidence-atoms.ts
 import { z as z5 } from "zod";
-var parsedPrEvidenceAtomSchema, ghPrViewSchema, PR_REQUIRED_WORKFLOWS;
+var parsedPrEvidenceAtomSchema, prEvidenceStateModifierSchema, ghPrViewSchema, PR_REQUIRED_WORKFLOWS;
 var init_evidence_atoms = __esm({
   "packages/contracts/src/release/evidence-atoms.ts"() {
     "use strict";
@@ -2977,6 +2984,10 @@ var init_evidence_atoms = __esm({
       kind: z5.literal("pr"),
       prNumber: z5.number().int().positive()
     });
+    prEvidenceStateModifierSchema = z5.object({
+      kind: z5.literal("state"),
+      value: z5.literal("MERGED")
+    });
     ghPrViewSchema = z5.object({
       state: z5.enum(["OPEN", "CLOSED", "MERGED"]),
       mergedAt: z5.string().nullable(),
@@ -3374,6 +3385,7 @@ var init_src2 = __esm({
     init_attachment_schema();
     init_branch_lock();
     init_changesets();
+    init_cli_category();
     init_credentials();
     init_docs_taxonomy();
     init_engine_result();
@@ -3516,6 +3528,86 @@ var init_colors = __esm({
 });
 
 // packages/cleo/src/cli/renderers/format-helpers.ts
+function terminalWidth() {
+  const cols = process.stdout.columns ?? 100;
+  return Math.max(40, cols);
+}
+function visibleLength(s) {
+  return s.replace(ANSI_REGEX, "").length;
+}
+function padVisible(s, width) {
+  const visible = visibleLength(s);
+  if (visible >= width) return s;
+  return s + " ".repeat(width - visible);
+}
+function truncateVisible(s, max) {
+  if (max <= 0) return "";
+  if (visibleLength(s) <= max) return s;
+  const ellipsis = "\u2026";
+  const target = max - 1;
+  let out = "";
+  let visible = 0;
+  let i = 0;
+  while (i < s.length && visible < target) {
+    const ch = s[i];
+    if (ch === "\x1B" && s[i + 1] === "[") {
+      const end = s.indexOf("m", i + 2);
+      if (end === -1) break;
+      out += s.slice(i, end + 1);
+      i = end + 1;
+      continue;
+    }
+    out += ch;
+    visible++;
+    i++;
+  }
+  return `${out}${ellipsis}`;
+}
+function dataTable(rows, columns, opts = {}) {
+  if (rows.length === 0 || columns.length === 0) return "";
+  const indent = opts.indent ?? 2;
+  const sep2 = opts.separator ?? "  ";
+  const totalWidth = opts.totalWidth ?? terminalWidth();
+  const showHeader = opts.showHeader !== false;
+  const cells = rows.map((row, i) => columns.map((col) => col.get(row, i)));
+  const natWidths = columns.map((col, c) => {
+    const headerW = visibleLength(col.header);
+    const cellW = Math.max(...cells.map((r) => visibleLength(r[c] ?? "")));
+    return Math.max(headerW, cellW);
+  });
+  const capped = natWidths.map((w, c) => {
+    const cap = columns[c]?.maxWidth ?? Number.MAX_SAFE_INTEGER;
+    const min = columns[c]?.minWidth ?? 0;
+    return Math.max(min, Math.min(w, cap));
+  });
+  const sepW = sep2.length * (columns.length - 1) + indent;
+  let totalUsed = capped.reduce((a, b) => a + b, 0) + sepW;
+  const widths = [...capped];
+  while (totalUsed > totalWidth) {
+    let widest = 0;
+    for (let c = 1; c < widths.length; c++) {
+      if ((widths[c] ?? 0) > (widths[widest] ?? 0)) widest = c;
+    }
+    const wCur = widths[widest] ?? 0;
+    const minAllowed = columns[widest]?.minWidth ?? 6;
+    if (wCur <= minAllowed) break;
+    widths[widest] = wCur - 1;
+    totalUsed--;
+  }
+  const pad = " ".repeat(indent);
+  const lines = [];
+  if (showHeader) {
+    const header = columns.map(
+      (c, i) => `${BOLD}${padVisible(truncateVisible(c.header, widths[i] ?? 0), widths[i] ?? 0)}${NC}`
+    ).join(sep2);
+    lines.push(`${pad}${header}`);
+  }
+  for (const row of cells) {
+    const formatted = row.map((cell, i) => padVisible(truncateVisible(cell ?? "", widths[i] ?? 0), widths[i] ?? 0)).join(sep2);
+    lines.push(`${pad}${formatted}`);
+  }
+  return lines.join("\n");
+}
 function pagerFooter(input2) {
   const { shown, page } = input2;
   const total = page?.total ?? input2.total ?? shown;
@@ -3557,10 +3649,12 @@ function metaFooter(meta) {
   if (chips.length > 0) lines.push(`${DIM}[${chips.join(" \xB7 ")}]${NC}`);
   return lines.join("\n");
 }
+var ANSI_REGEX;
 var init_format_helpers = __esm({
   "packages/cleo/src/cli/renderers/format-helpers.ts"() {
     "use strict";
     init_colors();
+    ANSI_REGEX = /\x1b\[[0-9;]*m/g;
   }
 });
 
@@ -8023,6 +8117,36 @@ var init_registry = __esm({
           }
         ]
       },
+      {
+        gateway: "mutate",
+        domain: "tasks",
+        operation: "add-batch",
+        description: "tasks.add-batch (mutate) \u2014 bulk-create N tasks atomically in a single transaction (epic decomposition: 1 call instead of N)",
+        tier: 0,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["tasks"],
+        params: [
+          {
+            name: "tasks",
+            type: "array",
+            required: true,
+            description: "Array of task specs to insert atomically (each must have a title)"
+          },
+          {
+            name: "defaultParent",
+            type: "string",
+            required: false,
+            description: "Optional default parent task ID applied when a task spec omits parent"
+          },
+          {
+            name: "dryRun",
+            type: "boolean",
+            required: false,
+            description: "Validate and predict IDs without writing to the database"
+          }
+        ]
+      },
       {
         gateway: "mutate",
         domain: "tasks",
@@ -8067,7 +8191,9 @@ var init_registry = __esm({
         operation: "cancel",
         description: "tasks.cancel (mutate) \u2014 cancel task (soft terminal state; reversible via tasks.restore)",
         tier: 1,
-        idempotent: false,
+        // T9838: re-cancel returns `alreadyCancelled: true` instead of failing,
+        // so the operation is idempotent at the registry level.
+        idempotent: true,
         sessionRequired: false,
         requiredParams: ["taskId"],
         params: [
@@ -8077,6 +8203,15 @@ var init_registry = __esm({
             required: true,
             description: "taskId parameter",
             cli: { positional: true }
+          },
+          {
+            // T9838: reason was implicitly accepted by the dispatch handler but
+            // missing from the registry schema, so dispatch tooling treated it
+            // as an unknown param.
+            name: "reason",
+            type: "string",
+            required: false,
+            description: "Optional human-readable cancellation reason stored on the task"
           }
         ]
       },
@@ -9682,24 +9817,6 @@ var init_registry = __esm({
         requiredParams: [],
         params: []
       },
-      {
-        gateway: "query",
-        domain: "pipeline",
-        operation: "release.changelog.since",
-        description: "Generate CHANGELOG from git log since a given tag \u2014 parses T\\d+ task/epic IDs and groups by epic (T820 RELEASE-02)",
-        tier: 1,
-        idempotent: true,
-        sessionRequired: false,
-        requiredParams: ["sinceTag"],
-        params: [
-          {
-            name: "sinceTag",
-            type: "string",
-            required: true,
-            description: "sinceTag parameter"
-          }
-        ]
-      },
       {
         gateway: "query",
         domain: "pipeline",
@@ -13857,8 +13974,6 @@ __export(engine_exports, {
   queryHookProviders: () => queryHookProviders,
   readManifestEntries: () => readManifestEntries,
   releaseCancel: () => releaseCancel,
-  releaseChangelog: () => releaseChangelog,
-  releaseChangelogSince: () => releaseChangelogSince,
   releaseCommit: () => releaseCommit,
   releaseGateCheck: () => releaseGateCheck,
   releaseGatesRun: () => releaseGatesRun,
@@ -13951,6 +14066,7 @@ __export(engine_exports, {
   taskUnclaim: () => taskUnclaim,
   taskUpdate: () => taskUpdate,
   taskWorkHistory: () => taskWorkHistory,
+  tasksAddBatchOp: () => tasksAddBatchOp,
   validateBatchValidate: () => coreBatchValidate,
   validateCoherenceCheck: () => coreCoherenceCheck,
   validateComplianceRecord: () => coreComplianceRecord,
@@ -14083,8 +14199,6 @@ import {
   queryHookProviders,
   readManifestEntries,
   releaseCancel,
-  releaseChangelog,
-  releaseChangelogSince,
   releaseCommit,
   releaseGateCheck,
   releaseGatesRun,
@@ -14172,6 +14286,7 @@ import {
   taskSyncLinks,
   taskSyncLinksRemove,
   taskSyncReconcile,
+  tasksAddBatchOp,
   taskTree,
   taskUnarchive,
   taskUnclaim,
@@ -26137,8 +26252,8 @@ async function loadPlaybookByName(name) {
     return null;
   }
   try {
-    const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
-    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot44();
+    const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
+    const projectRoot = __playbookRuntimeOverrides.projectRoot ?? getProjectRoot43();
     const resolved = resolvePlaybook(name, {
       projectRoot,
       globalPlaybooksDir: __playbookRuntimeOverrides.globalPlaybooksDir,
@@ -26182,8 +26297,8 @@ async function acquireDb() {
 async function buildDefaultDispatcher() {
   if (__playbookRuntimeOverrides.dispatcher) return __playbookRuntimeOverrides.dispatcher;
   const { orchestrateSpawnExecute: orchestrateSpawnExecute2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
-  const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
-  const projectRoot = getProjectRoot44();
+  const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
+  const projectRoot = getProjectRoot43();
   return {
     async dispatch(input2) {
       try {
@@ -26373,8 +26488,8 @@ var init_playbook2 = __esm({
             projectRoot = __playbookRuntimeOverrides.projectRoot;
           } else {
             try {
-              const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
-              projectRoot = getProjectRoot44();
+              const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
+              projectRoot = getProjectRoot43();
             } catch {
               projectRoot = void 0;
             }
@@ -26438,14 +26553,14 @@ var init_playbook2 = __esm({
         const dispatcher = await buildDefaultDispatcher();
         let result;
         try {
-          const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core/internal");
+          const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core/internal");
           const opts = {
             db,
             playbook: parsed.definition,
             playbookHash: parsed.sourceHash,
             initialContext,
             dispatcher,
-            projectRoot: getProjectRoot44()
+            projectRoot: getProjectRoot43()
           };
           if (__playbookRuntimeOverrides.approvalSecret !== void 0) {
             opts.approvalSecret = __playbookRuntimeOverrides.approvalSecret;
@@ -26648,7 +26763,8 @@ async function orchestrateNextOp(params) {
 }
 async function orchestrateReadyOp(params) {
   return orchestrateReady(params.epicId, getProjectRoot10(), {
-    ignoreDepsValidate: params.ignoreDepsValidate
+    ignoreDepsValidate: params.ignoreDepsValidate,
+    via: params.via
   });
 }
 async function orchestrateAnalyzeOp(params) {
@@ -26694,7 +26810,7 @@ async function orchestrateContextOp(params) {
   return orchestrateContext(params.epicId, getProjectRoot10());
 }
 async function orchestrateWavesOp(params) {
-  return orchestrateWaves(params.epicId, getProjectRoot10());
+  return orchestrateWaves(params.epicId, getProjectRoot10(), { via: params.via });
 }
 async function orchestratePlanOp(params) {
   return orchestratePlan({
@@ -26807,7 +26923,7 @@ async function orchestrateRejectOp(params) {
 async function orchestrateClassify(request, context, projectRoot) {
   try {
     const { getCleoCantWorkflowsDir } = await import("@cleocode/core/internal");
-    const { readFileSync: readFileSync20, readdirSync: readdirSync4, existsSync: existsSync18 } = await import("node:fs");
+    const { readFileSync: readFileSync19, readdirSync: readdirSync4, existsSync: existsSync18 } = await import("node:fs");
     const { join: join35 } = await import("node:path");
     const workflowsDir = getCleoCantWorkflowsDir();
     const combined = `${request} ${context ?? ""}`.toLowerCase();
@@ -26816,7 +26932,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync4(workflowsDir).filter((f) => f.endsWith(".cant"));
       for (const file of files) {
         try {
-          const src = readFileSync20(join35(workflowsDir, file), "utf-8");
+          const src = readFileSync19(join35(workflowsDir, file), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -26836,7 +26952,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       const files = readdirSync4(localCantDir).filter((f) => f.endsWith(".cant"));
       for (const file of files) {
         try {
-          const src = readFileSync20(join35(localCantDir, file), "utf-8");
+          const src = readFileSync19(join35(localCantDir, file), "utf-8");
           const teamMatch = /^team\s+(\S+):/m.exec(src);
           if (!teamMatch) continue;
           const teamName = teamMatch[1];
@@ -27354,9 +27470,12 @@ var init_orchestrate2 = __esm({
                   "epicId is required",
                   startTime
                 );
+              const viaRaw = params.via;
+              const via = viaRaw === "parent" || viaRaw === "saga" || viaRaw === "both" ? viaRaw : void 0;
               const p = {
                 epicId: params.epicId,
-                ignoreDepsValidate: params.ignoreDepsValidate
+                ignoreDepsValidate: params.ignoreDepsValidate,
+                ...via !== void 0 && { via }
               };
               return wrapResult(await coreOps2.ready(p), "query", "orchestrate", operation, startTime);
             }
@@ -27430,7 +27549,12 @@ var init_orchestrate2 = __esm({
                   "epicId is required",
                   startTime
                 );
-              const p = { epicId: params.epicId };
+              const wavesViaRaw = params.via;
+              const wavesVia = wavesViaRaw === "parent" || wavesViaRaw === "saga" || wavesViaRaw === "both" ? wavesViaRaw : void 0;
+              const p = {
+                epicId: params.epicId,
+                ...wavesVia !== void 0 && { via: wavesVia }
+              };
               return wrapResult(await coreOps2.waves(p), "query", "orchestrate", operation, startTime);
             }
             case "plan": {
@@ -28035,9 +28159,6 @@ async function releaseChannelShowOp(_params) {
     data: { branch: currentBranch, channel: resolvedChannel, distTag, description }
   };
 }
-async function releaseChangelogSinceOp(params) {
-  return releaseChangelogSince(params.sinceTag, getProjectRoot11());
-}
 async function releasePrStatusOp(params) {
   return releasePrStatus(params.version, getProjectRoot11());
 }
@@ -28196,7 +28317,6 @@ var init_pipeline3 = __esm({
       "release.list": releaseListOp,
       "release.show": releaseShowOp,
       "release.channel.show": releaseChannelShowOp,
-      "release.changelog.since": releaseChangelogSinceOp,
       "release.pr-status": releasePrStatusOp,
       "release.cancel": releaseCancelOp,
       "release.rollback": releaseRollbackOp,
@@ -28332,15 +28452,6 @@ var init_pipeline3 = __esm({
       },
       // Always succeeds (git branch detection falls back to 'unknown') — no error path.
       "release.channel.show": async (_params) => lafsSuccess((await coreOps3["release.channel.show"](_params)).data, "release.channel.show"),
-      "release.changelog.since": async (params) => {
-        if (!params.sinceTag) {
-          return lafsError("E_INVALID_INPUT", "sinceTag is required", "release.changelog.since");
-        }
-        return wrapCoreResult(
-          await coreOps3["release.changelog.since"](params),
-          "release.changelog.since"
-        );
-      },
       // -------------------------------------------------------------------------
       // Release mutations
       //
@@ -28515,7 +28626,6 @@ var init_pipeline3 = __esm({
           "release.list",
           "release.show",
           "release.channel.show",
-          "release.changelog.since",
           "release.pr-status",
           "phase.show",
           "phase.list",
@@ -28630,7 +28740,6 @@ var init_pipeline3 = __esm({
             "release.list",
             "release.show",
             "release.channel.show",
-            "release.changelog.since",
             "phase.show",
             "phase.list",
             "chain.show",
@@ -28931,9 +29040,13 @@ var init_release2 = __esm({
               );
             }
             // release.plan — SPEC-T9345 §4.2 (T9525): build canonical Release Plan envelope
+            // T9838: --saga and --no-changelog flags forwarded; epicId no longer
+            // required at the dispatch layer — the core verb validates that
+            // (epicId XOR sagaId) is set.
             case "plan": {
               const version = typeof params?.version === "string" ? params.version : void 0;
               const epicId = typeof params?.epicId === "string" ? params.epicId : void 0;
+              const sagaId = typeof params?.sagaId === "string" ? params.sagaId : void 0;
               if (!version) {
                 return errorResult(
                   "mutate",
@@ -28944,23 +29057,25 @@ var init_release2 = __esm({
                   startTime
                 );
               }
-              if (!epicId) {
+              if (!epicId && !sagaId) {
                 return errorResult(
                   "mutate",
                   "release",
                   operation,
                   "E_INVALID_INPUT",
-                  "epicId is required",
+                  "--saga or --epic is required",
                   startTime
                 );
               }
               const typed = {
                 version,
-                epicId,
+                ...epicId ? { epicId } : {},
+                ...sagaId ? { sagaId } : {},
                 scheme: typeof params?.scheme === "string" ? params.scheme : void 0,
                 channel: typeof params?.channel === "string" ? params.channel : void 0,
                 hotfix: typeof params?.hotfix === "boolean" ? params.hotfix : false,
                 dryRun: typeof params?.dryRun === "boolean" ? params.dryRun : false,
+                writeChangelog: typeof params?.writeChangelog === "boolean" ? params.writeChangelog : true,
                 projectRoot: getProjectRoot13()
               };
               return wrapResult(await releasePlan(typed), "mutate", "release", operation, startTime);
@@ -30284,6 +30399,17 @@ var init_tasks3 = __esm({
       // -------------------------------------------------------------------------
       // Mutate ops
       // -------------------------------------------------------------------------
+      "add-batch": async (params) => {
+        const projectRoot = getProjectRoot17();
+        return wrapCoreResult(
+          await tasksAddBatchOp(projectRoot, {
+            tasks: params.tasks ?? [],
+            defaultParent: typeof params.defaultParent === "string" ? params.defaultParent : void 0,
+            dryRun: typeof params.dryRun === "boolean" ? params.dryRun : void 0
+          }),
+          "add-batch"
+        );
+      },
       add: async (params) => {
         const projectRoot = getProjectRoot17();
         return wrapCoreResult(
@@ -30524,6 +30650,7 @@ var init_tasks3 = __esm({
     ]);
     MUTATE_OPS10 = /* @__PURE__ */ new Set([
       "add",
+      "add-batch",
       "update",
       "complete",
       "cancel",
@@ -32118,11 +32245,11 @@ var init_security = __esm({
 });
 
 // packages/cleo/src/dispatch/middleware/sanitizer.ts
-function createSanitizer(getProjectRoot44) {
+function createSanitizer(getProjectRoot43) {
   return async (req, next) => {
     if (req.params) {
       try {
-        const root = getProjectRoot44 ? getProjectRoot44() : void 0;
+        const root = getProjectRoot43 ? getProjectRoot43() : void 0;
         req.params = sanitizeParams(req.params, root, {
           domain: req.domain,
           operation: req.operation
@@ -32669,7 +32796,10 @@ var init_add_batch = __esm({
     init_cli();
     init_renderers();
     addBatchCommand = defineCommand({
-      meta: { name: "add-batch", description: "Create multiple tasks atomically from a JSON file" },
+      meta: {
+        name: "add-batch",
+        description: "Create multiple tasks in a single atomic transaction from a JSON file"
+      },
       args: {
         file: {
           type: "string",
@@ -32691,21 +32821,16 @@ var init_add_batch = __esm({
         let raw;
         if (!filePath || filePath === "-") {
           const chunks = [];
-          for await (const chunk of process.stdin) {
-            chunks.push(chunk);
-          }
+          for await (const chunk of process.stdin) chunks.push(chunk);
           raw = Buffer.concat(chunks).toString("utf-8");
           if (!raw.trim()) {
             cliError(
               "No input provided. Pass --file <path> or pipe JSON to stdin.",
               "E_VALIDATION",
-              {
-                name: "E_VALIDATION",
-                fix: "cleo add-batch --file tasks.json"
-              },
+              { name: "E_VALIDATION", fix: "cleo add-batch --file tasks.json" },
               { operation: "tasks.add-batch" }
             );
-            process.exit(2);
+            process.exitCode = 2;
             return;
           }
         } else {
@@ -32713,13 +32838,10 @@ var init_add_batch = __esm({
             cliError(
               `File not found: ${filePath}`,
               "E_NOT_FOUND",
-              {
-                name: "E_NOT_FOUND",
-                fix: `Verify the file path exists: ${filePath}`
-              },
+              { name: "E_NOT_FOUND", fix: `Verify the file path exists: ${filePath}` },
               { operation: "tasks.add-batch" }
             );
-            process.exit(2);
+            process.exitCode = 2;
             return;
           }
           raw = readFileSync8(filePath, "utf-8");
@@ -32732,79 +32854,41 @@ var init_add_batch = __esm({
           cliError(
             "Invalid JSON input. Expected an array of task objects.",
             "E_VALIDATION",
-            {
-              name: "E_VALIDATION",
-              fix: "Ensure the input is a valid JSON array of task objects"
-            },
+            { name: "E_VALIDATION", fix: "Ensure the input is a valid JSON array of task objects" },
             { operation: "tasks.add-batch" }
           );
-          process.exit(2);
+          process.exitCode = 2;
           return;
         }
         if (tasks.length === 0) {
           cliError(
             "No tasks in input.",
             "E_VALIDATION",
+            { name: "E_VALIDATION", fix: "Provide at least one task object in the JSON array" },
+            { operation: "tasks.add-batch" }
+          );
+          process.exitCode = 2;
+          return;
+        }
+        const response = await dispatchRaw("mutate", "tasks", "add-batch", {
+          tasks,
+          ...defaultParent && { defaultParent },
+          ...dryRun && { dryRun: true }
+        });
+        if (!response.success) {
+          cliError(
+            response.error?.message ?? "Batch creation failed",
+            response.error?.code ?? "E_BATCH_FAILED",
             {
-              name: "E_VALIDATION",
-              fix: "Provide at least one task object in the JSON array"
+              name: response.error?.code ?? "E_BATCH_FAILED",
+              fix: response.error?.fix ?? "Check task specs and try again"
             },
             { operation: "tasks.add-batch" }
           );
-          process.exit(2);
+          process.exitCode = 1;
           return;
         }
-        const results = [];
-        let failed = 0;
-        for (const task of tasks) {
-          const params = {
-            title: task.title,
-            ...task.description && { description: task.description },
-            parent: task.parent ?? defaultParent,
-            ...task.type && { type: task.type },
-            ...task.priority && { priority: task.priority },
-            ...task.size && { size: task.size },
-            ...task.acceptance?.length && { acceptance: task.acceptance },
-            ...task.depends?.length && { depends: task.depends },
-            ...task.labels?.length && { labels: task.labels },
-            ...task.phase && { phase: task.phase },
-            ...task.notes && { notes: task.notes },
-            ...task.files?.length && { files: task.files },
-            ...dryRun && { dryRun: true }
-          };
-          const response = await dispatchRaw("mutate", "tasks", "add", params);
-          if (response.success) {
-            const data = response.data;
-            const taskData = data?.task;
-            results.push({ title: task.title, id: taskData?.id });
-          } else {
-            failed++;
-            results.push({
-              title: task.title,
-              error: response.error?.message ?? "Unknown error"
-            });
-          }
-        }
-        const output2 = {
-          total: tasks.length,
-          created: tasks.length - failed,
-          failed,
-          dryRun: dryRun ?? false,
-          results
-        };
-        if (failed > 0) {
-          cliOutput(output2, {
-            command: "add-batch",
-            message: `${failed} of ${tasks.length} tasks failed`,
-            operation: "tasks.add-batch"
-          });
-          process.exit(1);
-        } else {
-          cliOutput(output2, {
-            command: "add-batch",
-            operation: "tasks.add-batch"
-          });
-        }
+        cliOutput(response.data, { command: "add-batch", operation: "tasks.add-batch" });
       }
     });
   }
@@ -32830,7 +32914,8 @@ var init_add = __esm({
     addCommand = defineCommand({
       meta: {
         name: "add",
-        description: "Create a new task (requires active session)"
+        description: `Create a new task (requires active session)
+For 2+ tasks at once: cleo add-batch --file tasks.json (single transaction, atomic rollback)`
       },
       args: {
         title: {
@@ -32882,7 +32967,7 @@ var init_add = __esm({
         labels: {
           type: "string",
           alias: "l",
-          description: "Comma-separated labels"
+          description: 'Comma-separated labels (lowercase alphanumeric + hyphens + periods only, e.g. "track-b,wave.1") (gh-392)'
         },
         files: {
           type: "string",
@@ -34079,13 +34164,13 @@ var init_agent = __esm({
             transportConfig: {},
             isActive: true
           });
-          const { existsSync: existsSync18, mkdirSync: mkdirSync7, writeFileSync: writeFileSync7 } = await import("node:fs");
+          const { existsSync: existsSync18, mkdirSync: mkdirSync6, writeFileSync: writeFileSync6 } = await import("node:fs");
           const { join: join35 } = await import("node:path");
           const cantDir = join35(CLEO_DIR_NAME, AGENTS_SUBDIR);
           const cantPath = join35(cantDir, `${agentId}.cant`);
           let cantScaffolded = false;
           if (!existsSync18(cantPath)) {
-            mkdirSync7(cantDir, { recursive: true });
+            mkdirSync6(cantDir, { recursive: true });
             const role = classification ?? "specialist";
             const cantContent = `---
 kind: agent
@@ -34135,7 +34220,7 @@ agent ${agentId}:
   enforcement:
     1: TODO \u2014 what does this agent push back on?
 `;
-            writeFileSync7(cantPath, cantContent, "utf-8");
+            writeFileSync6(cantPath, cantContent, "utf-8");
             cantScaffolded = true;
           }
           cliOutput(
@@ -34265,7 +34350,7 @@ agent ${agentId}:
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { getDb: getDb3 } = await import("@cleocode/core/internal");
           const { createRuntime } = await import("@cleocode/runtime");
-          const { existsSync: existsSync18, readFileSync: readFileSync20 } = await import("node:fs");
+          const { existsSync: existsSync18, readFileSync: readFileSync19 } = await import("node:fs");
           const { join: join35 } = await import("node:path");
           await getDb3();
           const registry = new AgentRegistryAccessor(getProjectRoot23());
@@ -34288,7 +34373,7 @@ agent ${agentId}:
           let cantValidation = null;
           const cantPath = args.cant ?? join35(CLEO_DIR_NAME, AGENTS_SUBDIR, `${args.agentId}.cant`);
           if (existsSync18(cantPath)) {
-            profile = readFileSync20(cantPath, "utf-8");
+            profile = readFileSync19(cantPath, "utf-8");
             try {
               const cantModule = await import("@cleocode/cant");
               const validate = "validate" in cantModule ? cantModule.validate : null;
@@ -35699,7 +35784,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       async run({ args }) {
         let tempDir = null;
         try {
-          const { existsSync: existsSync18, mkdirSync: mkdirSync7, statSync, readdirSync: readdirSync4, copyFileSync } = await import("node:fs");
+          const { existsSync: existsSync18, mkdirSync: mkdirSync6, statSync, readdirSync: readdirSync4, copyFileSync } = await import("node:fs");
           const { join: join35, basename, resolve: resolve9, extname } = await import("node:path");
           const { tmpdir: tmpdir2 } = await import("node:os");
           const resolvedPath = resolve9(args.path);
@@ -35723,11 +35808,11 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           if (stat3.isFile() && ext === ".cant") {
             cantPath = resolvedPath;
           } else if (stat3.isFile() && ext === ".cantz") {
-            const { execFileSync: execFileSync5 } = await import("node:child_process");
+            const { execFileSync: execFileSync4 } = await import("node:child_process");
             tempDir = join35(tmpdir2(), `cleo-agent-install-${Date.now()}`);
-            mkdirSync7(tempDir, { recursive: true });
+            mkdirSync6(tempDir, { recursive: true });
             try {
-              execFileSync5("unzip", ["-o", "-q", resolvedPath, "-d", tempDir], {
+              execFileSync4("unzip", ["-o", "-q", resolvedPath, "-d", tempDir], {
                 encoding: "utf-8",
                 timeout: 3e4
               });
@@ -35798,7 +35883,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
               return;
             }
             tempDir = join35(tmpdir2(), `cleo-agent-install-${Date.now()}`);
-            mkdirSync7(tempDir, { recursive: true });
+            mkdirSync6(tempDir, { recursive: true });
             cantPath = join35(tempDir, `${agentName}.cant`);
             copyFileSync(personaPath, cantPath);
           } else {
@@ -35919,8 +36004,8 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       async run({ args }) {
         try {
           const { existsSync: existsSync18, statSync } = await import("node:fs");
-          const { resolve: resolve9, basename, dirname: dirname13 } = await import("node:path");
-          const { execFileSync: execFileSync5 } = await import("node:child_process");
+          const { resolve: resolve9, basename, dirname: dirname12 } = await import("node:path");
+          const { execFileSync: execFileSync4 } = await import("node:child_process");
           const resolvedDir = resolve9(args.dir);
           if (!existsSync18(resolvedDir) || !statSync(resolvedDir).isDirectory()) {
             cliOutput(
@@ -35955,9 +36040,9 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           const agentName = basename(resolvedDir);
           const archiveName = `${agentName}.cantz`;
           const archivePath = resolve9(archiveName);
-          const parentDir = dirname13(resolvedDir);
+          const parentDir = dirname12(resolvedDir);
           try {
-            execFileSync5("zip", ["-r", archivePath, agentName], {
+            execFileSync4("zip", ["-r", archivePath, agentName], {
               cwd: parentDir,
               encoding: "utf-8",
               timeout: 3e4
@@ -36054,7 +36139,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       },
       async run({ args }) {
         try {
-          const { existsSync: existsSync18, mkdirSync: mkdirSync7, writeFileSync: writeFileSync7 } = await import("node:fs");
+          const { existsSync: existsSync18, mkdirSync: mkdirSync6, writeFileSync: writeFileSync6 } = await import("node:fs");
           const { join: join35 } = await import("node:path");
           const { homedir: homedir8 } = await import("node:os");
           const name = args.name;
@@ -36136,7 +36221,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             process.exitCode = 6;
             return;
           }
-          mkdirSync7(agentDir, { recursive: true });
+          mkdirSync6(agentDir, { recursive: true });
           const personaContent = generatePersonaCant({
             name,
             role,
@@ -36145,9 +36230,9 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             domain,
             parent
           });
-          writeFileSync7(join35(agentDir, "persona.cant"), personaContent, "utf-8");
+          writeFileSync6(join35(agentDir, "persona.cant"), personaContent, "utf-8");
           const manifest = generateManifest({ name, role, tier, domain });
-          writeFileSync7(
+          writeFileSync6(
             join35(agentDir, "manifest.json"),
             `${JSON.stringify(manifest, null, 2)}
 `,
@@ -36159,14 +36244,14 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           ];
           if (team) {
             const teamConfigContent = generateTeamConfig(name, role, team);
-            writeFileSync7(join35(agentDir, "team-config.cant"), teamConfigContent, "utf-8");
+            writeFileSync6(join35(agentDir, "team-config.cant"), teamConfigContent, "utf-8");
             createdFiles.push(join35(agentDir, "team-config.cant"));
           }
           if (seedBrain) {
             const expertiseDir = join35(agentDir, "expertise");
-            mkdirSync7(expertiseDir, { recursive: true });
+            mkdirSync6(expertiseDir, { recursive: true });
             const seedContent = generateMentalModelSeed(name, role, domain);
-            writeFileSync7(join35(expertiseDir, "mental-model-seed.md"), seedContent, "utf-8");
+            writeFileSync6(join35(expertiseDir, "mental-model-seed.md"), seedContent, "utf-8");
             createdFiles.push(join35(expertiseDir, "mental-model-seed.md"));
             try {
               const { execFile: execFile2 } = await import("node:child_process");
@@ -36266,7 +36351,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       },
       async run({ args }) {
         try {
-          const { existsSync: existsSync18, readFileSync: readFileSync20, mkdirSync: mkdirSync7 } = await import("node:fs");
+          const { existsSync: existsSync18, readFileSync: readFileSync19, mkdirSync: mkdirSync6 } = await import("node:fs");
           const { resolve: resolve9, join: join35 } = await import("node:path");
           const specPath = resolve9(args.spec);
           if (!existsSync18(specPath)) {
@@ -36274,10 +36359,10 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             process.exitCode = 4;
             return;
           }
-          const specContent = readFileSync20(specPath, "utf-8");
+          const specContent = readFileSync19(specPath, "utf-8");
           const projectRoot = getProjectRoot23();
           const outputDir = args["output-dir"] ? resolve9(args["output-dir"]) : join35(projectRoot, ".cleo", "cant", "agents");
-          mkdirSync7(outputDir, { recursive: true });
+          mkdirSync6(outputDir, { recursive: true });
           if (args["dry-run"]) {
             cliOutput(
               {
@@ -37894,9 +37979,9 @@ var init_backup = __esm({
       async run({ args }) {
         const scope = args.scope;
         const { packBundle } = await import("@cleocode/core/store/backup-pack.js");
-        const { getProjectRoot: getProjectRoot44 } = await import("@cleocode/core");
+        const { getProjectRoot: getProjectRoot43 } = await import("@cleocode/core");
         const includesProject = scope === "project" || scope === "all";
-        const projectRoot = includesProject ? getProjectRoot44() : void 0;
+        const projectRoot = includesProject ? getProjectRoot43() : void 0;
         let passphrase;
         if (args.encrypt === true) {
           passphrase = process.env["CLEO_BACKUP_PASSPHRASE"];
@@ -37972,12 +38057,12 @@ var init_backup = __esm({
       },
       async run({ args }) {
         const bundlePath = args.bundle;
-        const { getProjectRoot: getProjectRoot44, getCleoHome: getCleoHome6, getCleoVersion } = await import("@cleocode/core");
+        const { getProjectRoot: getProjectRoot43, getCleoHome: getCleoHome6, getCleoVersion } = await import("@cleocode/core");
         const { BundleError, cleanupStaging, unpackBundle } = await import("@cleocode/core/store/backup-unpack.js");
         const { regenerateConfigJson, regenerateProjectContextJson, regenerateProjectInfoJson } = await import("@cleocode/core/store/regenerators.js");
         const { regenerateAndCompare } = await import("@cleocode/core/store/restore-json-merge.js");
         const { buildConflictReport, writeConflictReport } = await import("@cleocode/core/store/restore-conflict-report.js");
-        const projectRoot = getProjectRoot44();
+        const projectRoot = getProjectRoot43();
         if (args.force !== true) {
           const existing = checkForExistingData(projectRoot, getCleoHome6());
           if (existing.length > 0) {
@@ -39280,6 +39365,8 @@ var changeset_exports = {};
 __export(changeset_exports, {
   changesetCommand: () => changesetCommand
 });
+import { existsSync as existsSync11 } from "node:fs";
+import { join as join14 } from "node:path";
 import { changesets, getProjectRoot as getProjectRoot27 } from "@cleocode/core";
 function isValidKind(raw) {
   return typeof raw === "string" && CHANGESET_KINDS.includes(raw);
@@ -39300,12 +39387,13 @@ function parsePrsFlag(raw) {
   }
   return numbers.length > 0 ? numbers : void 0;
 }
-var addCommand4, changesetCommand;
+var addCommand4, listCommand6, changesetCommand;
 var init_changeset = __esm({
   "packages/cleo/src/cli/commands/changeset.ts"() {
     "use strict";
     init_src2();
     init_dist();
+    init_format_helpers();
     init_renderers();
     addCommand4 = defineCommand({
       meta: {
@@ -39394,13 +39482,66 @@ var init_changeset = __esm({
         cliOutput(result, { command: "changeset add", operation: "changeset.add" });
       }
     });
+    listCommand6 = defineCommand({
+      meta: {
+        name: "list",
+        description: "List every changeset entry under .changeset/*.md using the same parser the release-plan aggregator consumes. JSON envelope by default, aligned table on --human."
+      },
+      args: {},
+      async run() {
+        const projectRoot = getProjectRoot27();
+        const dir = join14(projectRoot, ".changeset");
+        if (!existsSync11(dir)) {
+          const empty = { entries: [], count: 0, dir, note: "no .changeset/ dir" };
+          if (isHumanOutput()) {
+            humanLine("No changeset entries found (.changeset/ directory absent).");
+          }
+          cliOutput(empty, { command: "changeset list", operation: "changeset.list" });
+          return;
+        }
+        let entries;
+        try {
+          entries = changesets.parseChangesetDir(dir);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          cliError(`Failed to parse .changeset directory: ${msg}`, 6 /* VALIDATION_ERROR */, {
+            name: "E_VALIDATION",
+            fix: "run `node scripts/lint-changesets.mjs` to surface every offending entry"
+          });
+          process.exit(6 /* VALIDATION_ERROR */);
+        }
+        if (isHumanOutput()) {
+          if (entries.length === 0) {
+            humanLine("No changeset entries found (.changeset/ has no *.md files).");
+          } else {
+            const rendered = dataTable(entries, [
+              { header: "SLUG", get: (e) => e.id, maxWidth: 40 },
+              { header: "KIND", get: (e) => e.kind, maxWidth: 10 },
+              { header: "TASKS", get: (e) => e.tasks.join(","), maxWidth: 22 },
+              {
+                header: "PR",
+                get: (e) => e.prs && e.prs.length > 0 ? `#${e.prs.join(",#")}` : "-",
+                maxWidth: 10
+              },
+              { header: "SUMMARY", get: (e) => e.summary }
+            ]);
+            humanLine(rendered);
+          }
+        }
+        cliOutput(
+          { entries, count: entries.length, dir },
+          { command: "changeset list", operation: "changeset.list" }
+        );
+      }
+    });
     changesetCommand = defineCommand({
       meta: {
         name: "changeset",
-        description: "Author task-anchored changeset entries that dual-write to .changeset/*.md AND the docs SSoT blob store (T9793)."
+        description: "Author + list task-anchored changeset entries \u2014 dual-writes go to .changeset/*.md AND the docs SSoT blob store (Saga T9782)."
       },
       subCommands: {
-        add: addCommand4
+        add: addCommand4,
+        list: listCommand6
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -39520,10 +39661,10 @@ var init_check2 = __esm({
         }
       },
       async run({ args }) {
-        const { readFileSync: readFileSync20 } = await import("node:fs");
+        const { readFileSync: readFileSync19 } = await import("node:fs");
         let chain;
         try {
-          chain = JSON.parse(readFileSync20(args.file, "utf8"));
+          chain = JSON.parse(readFileSync19(args.file, "utf8"));
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
           cliError(`Failed to read or parse chain file: ${message}`, 2, {
@@ -40795,7 +40936,7 @@ __export(config_exports, {
   configCommand: () => configCommand
 });
 import { CleoError as CleoError2, formatError as formatError4, loadConfig as loadConfig2 } from "@cleocode/core";
-var PRESET_DESCRIPTIONS, getCommand2, setCommand, setPresetCommand, presetsCommand, listCommand6, configCommand;
+var PRESET_DESCRIPTIONS, getCommand2, setCommand, setPresetCommand, presetsCommand, listCommand7, configCommand;
 var init_config2 = __esm({
   "packages/cleo/src/cli/commands/config.ts"() {
     "use strict";
@@ -40887,7 +41028,7 @@ var init_config2 = __esm({
         await dispatchFromCli("query", "admin", "config.presets", {}, { command: "config" });
       }
     });
-    listCommand6 = defineCommand({
+    listCommand7 = defineCommand({
       meta: { name: "list", description: "Show all resolved configuration" },
       async run() {
         try {
@@ -40909,7 +41050,7 @@ var init_config2 = __esm({
         set: setCommand,
         "set-preset": setPresetCommand,
         presets: presetsCommand,
-        list: listCommand6
+        list: listCommand7
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -41235,7 +41376,7 @@ var curator_exports = {};
 __export(curator_exports, {
   curatorCommand: () => curatorCommand
 });
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 import { getCleoHome } from "@cleocode/paths";
 async function loadCurator() {
   return import("@cleocode/core/sentient/curator.js");
@@ -41265,7 +41406,7 @@ var init_curator = __esm({
         try {
           const { runCuratorTick } = await loadCurator();
           const { readCuratorConfig } = await loadDaemon();
-          const configPath = join14(getCleoHome(), "config.json");
+          const configPath = join15(getCleoHome(), "config.json");
           const cfg = await readCuratorConfig(configPath);
           const result = await runCuratorTick({
             dryRun: args["dry-run"] === true,
@@ -41306,7 +41447,7 @@ var init_curator = __esm({
       async run() {
         try {
           const { readCuratorConfig, curatorCronExpression } = await loadDaemon();
-          const configPath = join14(getCleoHome(), "config.json");
+          const configPath = join15(getCleoHome(), "config.json");
           const cfg = await readCuratorConfig(configPath);
           cliOutput(
             {
@@ -41380,8 +41521,8 @@ var daemon_exports = {};
 __export(daemon_exports, {
   daemonCommand: () => daemonCommand
 });
-import { existsSync as existsSync11 } from "node:fs";
-import { join as join15 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { join as join16 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { getGCDaemonStatus, spawnGCDaemon, stopGCDaemon } from "@cleocode/core/gc/daemon.js";
 import {
@@ -41447,9 +41588,9 @@ async function showDaemonStatus(cleoDir, projectRoot) {
 }
 function resolveDaemonInstallerScript() {
   const filePath = fileURLToPath4(import.meta.url);
-  const candidate1 = join15(filePath, "..", "..", "..", "scripts", "install-daemon-service.mjs");
-  if (existsSync11(candidate1)) return candidate1;
-  const candidate2 = join15(
+  const candidate1 = join16(filePath, "..", "..", "..", "scripts", "install-daemon-service.mjs");
+  if (existsSync12(candidate1)) return candidate1;
+  const candidate2 = join16(
     filePath,
     "..",
     "..",
@@ -41521,13 +41662,13 @@ var init_daemon = __esm({
             {
               pid,
               cleoDir,
-              logs: join15(cleoDir, "logs", "gc.log"),
+              logs: join16(cleoDir, "logs", "gc.log"),
               message: `GC daemon started (PID ${pid})`
             },
             {
               command: "daemon",
               operation: "daemon.start",
-              message: `GC daemon started (PID ${pid}) \u2014 Logs: ${join15(cleoDir, "logs", "gc.log")}`
+              message: `GC daemon started (PID ${pid}) \u2014 Logs: ${join16(cleoDir, "logs", "gc.log")}`
             }
           );
         } catch (err) {
@@ -42156,12 +42297,12 @@ var detect_drift_exports = {};
 __export(detect_drift_exports, {
   detectDriftCommand: () => detectDriftCommand
 });
-import { existsSync as existsSync12, readdirSync, readFileSync as readFileSync13 } from "node:fs";
-import { dirname as dirname6, join as join16 } from "node:path";
+import { existsSync as existsSync13, readdirSync, readFileSync as readFileSync13 } from "node:fs";
+import { dirname as dirname6, join as join17 } from "node:path";
 function findProjectRoot() {
   let currentDir = process.cwd();
   while (currentDir !== "/") {
-    if (existsSync12(join16(currentDir, "package.json"))) {
+    if (existsSync13(join17(currentDir, "package.json"))) {
       return currentDir;
     }
     const parent = dirname6(currentDir);
@@ -42185,8 +42326,8 @@ var init_detect_drift = __esm({
       },
       async run() {
         const projectRoot = findProjectRoot();
-        const isCleoRepo = existsSync12(join16(projectRoot, "packages", "cleo", "src"));
-        const cleoSrcRoot = isCleoRepo ? join16(projectRoot, "packages", "cleo", "src") : join16(projectRoot, "src");
+        const isCleoRepo = existsSync13(join17(projectRoot, "packages", "cleo", "src"));
+        const cleoSrcRoot = isCleoRepo ? join17(projectRoot, "packages", "cleo", "src") : join17(projectRoot, "src");
         const safeRead = (filePath) => {
           try {
             return readFileSync13(filePath, "utf-8");
@@ -42200,8 +42341,8 @@ var init_detect_drift = __esm({
             checks: [],
             recommendations: []
           };
-          const injPath = join16(projectRoot, CLEO_DIR_NAME, TEMPLATES_SUBDIR, CLEO_INJECTION_MD);
-          if (existsSync12(injPath)) {
+          const injPath = join17(projectRoot, CLEO_DIR_NAME, TEMPLATES_SUBDIR, CLEO_INJECTION_MD);
+          if (existsSync13(injPath)) {
             const content = safeRead(injPath);
             userResult.checks.push({
               name: "Agent injection",
@@ -42252,10 +42393,10 @@ var init_detect_drift = __esm({
           }
         };
         try {
-          const specPath = join16(projectRoot, "docs", "specs", "CLEO-OPERATION-CONSTITUTION.md");
-          const registryPath = join16(cleoSrcRoot, "dispatch", "registry.ts");
-          const dispatchDomainsDir = join16(cleoSrcRoot, "dispatch", "domains");
-          if (!existsSync12(specPath)) {
+          const specPath = join17(projectRoot, "docs", "specs", "CLEO-OPERATION-CONSTITUTION.md");
+          const registryPath = join17(cleoSrcRoot, "dispatch", "registry.ts");
+          const dispatchDomainsDir = join17(cleoSrcRoot, "dispatch", "domains");
+          if (!existsSync13(specPath)) {
             addCheck("Gateway-to-spec sync", "fail", "CLEO-OPERATION-CONSTITUTION.md missing", [
               {
                 severity: "error",
@@ -42265,7 +42406,7 @@ var init_detect_drift = __esm({
                 recommendation: "Create docs/specs/CLEO-OPERATION-CONSTITUTION.md with canonical operation definitions"
               }
             ]);
-          } else if (!existsSync12(registryPath) || !existsSync12(dispatchDomainsDir)) {
+          } else if (!existsSync13(registryPath) || !existsSync13(dispatchDomainsDir)) {
             addCheck("Gateway-to-spec sync", "fail", "Dispatch registry or domains missing", [
               {
                 severity: "error",
@@ -42323,9 +42464,9 @@ var init_detect_drift = __esm({
           ]);
         }
         try {
-          const cliDir = join16(cleoSrcRoot, "cli", "commands");
-          const coreDir = isCleoRepo ? join16(projectRoot, "packages", "core", "src") : join16(projectRoot, "src", "core");
-          if (!existsSync12(cliDir)) {
+          const cliDir = join17(cleoSrcRoot, "cli", "commands");
+          const coreDir = isCleoRepo ? join17(projectRoot, "packages", "core", "src") : join17(projectRoot, "src", "core");
+          if (!existsSync13(cliDir)) {
             addCheck("CLI-to-core sync", "fail", "CLI commands directory missing", [
               {
                 severity: "error",
@@ -42334,7 +42475,7 @@ var init_detect_drift = __esm({
                 recommendation: "Verify TypeScript source structure is intact"
               }
             ]);
-          } else if (!existsSync12(coreDir)) {
+          } else if (!existsSync13(coreDir)) {
             addCheck("CLI-to-core sync", "fail", "Core directory missing", [
               {
                 severity: "error",
@@ -42351,8 +42492,8 @@ var init_detect_drift = __esm({
           addCheck("CLI-to-core sync", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const domainsDir = join16(cleoSrcRoot, "dispatch", "domains");
-          if (!existsSync12(domainsDir)) {
+          const domainsDir = join17(cleoSrcRoot, "dispatch", "domains");
+          if (!existsSync13(domainsDir)) {
             addCheck("Domain handler coverage", "fail", "Dispatch domains directory missing", [
               {
                 severity: "error",
@@ -42369,8 +42510,8 @@ var init_detect_drift = __esm({
           addCheck("Domain handler coverage", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const matrixPath = join16(cleoSrcRoot, "dispatch", "lib", "capability-matrix.ts");
-          if (!existsSync12(matrixPath)) {
+          const matrixPath = join17(cleoSrcRoot, "dispatch", "lib", "capability-matrix.ts");
+          if (!existsSync13(matrixPath)) {
             addCheck("Capability matrix", "fail", "Capability matrix missing", [
               {
                 severity: "error",
@@ -42386,8 +42527,8 @@ var init_detect_drift = __esm({
           addCheck("Capability matrix", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const schemaPath = join16(projectRoot, "src", "store", "schema.ts");
-          if (!existsSync12(schemaPath)) {
+          const schemaPath = join17(projectRoot, "src", "store", "schema.ts");
+          if (!existsSync13(schemaPath)) {
             addCheck("Schema validation", "fail", "Schema definition missing", [
               {
                 severity: "error",
@@ -42421,10 +42562,10 @@ var init_detect_drift = __esm({
           addCheck("Schema validation", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const visionPath = join16(projectRoot, "docs", "concepts", "CLEO-VISION.md");
-          const specPath = join16(projectRoot, "docs", "specs", "CLEO-PORTABLE-PROJECT-BRAIN-SPEC.md");
+          const visionPath = join17(projectRoot, "docs", "concepts", "CLEO-VISION.md");
+          const specPath = join17(projectRoot, "docs", "specs", "CLEO-PORTABLE-PROJECT-BRAIN-SPEC.md");
           const issues = [];
-          if (!existsSync12(visionPath)) {
+          if (!existsSync13(visionPath)) {
             issues.push({
               severity: "error",
               category: "vision",
@@ -42433,7 +42574,7 @@ var init_detect_drift = __esm({
               recommendation: "Create docs/concepts/CLEO-VISION.md with project vision"
             });
           }
-          if (!existsSync12(specPath)) {
+          if (!existsSync13(specPath)) {
             issues.push({
               severity: "error",
               category: "spec",
@@ -42477,8 +42618,8 @@ var init_detect_drift = __esm({
           addCheck("Canonical identity", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const injectionPath = join16(projectRoot, CLEO_DIR_NAME, TEMPLATES_SUBDIR, CLEO_INJECTION_MD);
-          if (!existsSync12(injectionPath)) {
+          const injectionPath = join17(projectRoot, CLEO_DIR_NAME, TEMPLATES_SUBDIR, CLEO_INJECTION_MD);
+          if (!existsSync13(injectionPath)) {
             addCheck("Agent injection", "fail", "Agent injection template missing", [
               {
                 severity: "error",
@@ -42507,8 +42648,8 @@ var init_detect_drift = __esm({
           addCheck("Agent injection", "fail", `Error: ${getErrorMessage(e)}`);
         }
         try {
-          const exitCodesPath = join16(cleoSrcRoot, "dispatch", "lib", "exit-codes.ts");
-          if (!existsSync12(exitCodesPath)) {
+          const exitCodesPath = join17(cleoSrcRoot, "dispatch", "lib", "exit-codes.ts");
+          if (!existsSync13(exitCodesPath)) {
             addCheck("Exit codes", "fail", "Exit codes definition missing", [
               {
                 severity: "error",
@@ -42678,10 +42819,10 @@ var init_diagnostics2 = __esm({
 
 // packages/cleo/src/viewer/pidfile.ts
 import { mkdir, readFile as readFile2, unlink, writeFile } from "node:fs/promises";
-import { dirname as dirname7, join as join17 } from "node:path";
+import { dirname as dirname7, join as join18 } from "node:path";
 import { getCleoHome as getCleoHome2 } from "@cleocode/core/internal";
 function viewerPidFilePath() {
-  return join17(getCleoHome2(), "viewer.pid");
+  return join18(getCleoHome2(), "viewer.pid");
 }
 async function writeViewerPidFile(record) {
   const path6 = viewerPidFilePath();
@@ -42781,7 +42922,7 @@ var init_port_allocator = __esm({
 // packages/cleo/src/viewer/server.ts
 import { createReadStream } from "node:fs";
 import { stat } from "node:fs/promises";
-import { dirname as dirname8, join as join18, normalize, resolve as resolve5 } from "node:path";
+import { dirname as dirname8, join as join19, normalize, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import {
   createAttachmentStore as createAttachmentStore2,
@@ -42820,7 +42961,7 @@ function inferTitle(markdown, fallback) {
 }
 async function serveStatic(res, assetsDir, relPath) {
   const safeRel = normalize(relPath).replace(/^[\\/]+/, "");
-  const absPath = join18(assetsDir, safeRel);
+  const absPath = join19(assetsDir, safeRel);
   const resolvedAssets = resolve5(assetsDir) + "/";
   const resolvedAbs = resolve5(absPath);
   if (`${resolvedAbs}/`.indexOf(resolvedAssets) !== 0 && resolvedAbs !== resolve5(assetsDir)) {
@@ -43021,12 +43162,12 @@ var init_server = __esm({
 // packages/cleo/src/cli/commands/docs-viewer.ts
 import { spawn } from "node:child_process";
 import { open as fsOpen } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot29 } from "@cleocode/core";
 function getCleoBinPath() {
   const thisFile = fileURLToPath6(import.meta.url);
-  return join19(thisFile, "..", "..", "index.js");
+  return join20(thisFile, "..", "..", "index.js");
 }
 async function waitForExit(pid, timeoutMs, intervalMs = 100) {
   const deadline = Date.now() + timeoutMs;
@@ -43055,7 +43196,7 @@ function openInBrowser(url) {
   }
 }
 async function spawnDetachedServer(opts) {
-  const logFile = join19(getCleoHome3(), "viewer.log");
+  const logFile = join20(getCleoHome3(), "viewer.log");
   const handle = await fsOpen(logFile, "a").catch(() => null);
   const stdio = handle ? ["ignore", handle.fd, handle.fd] : ["ignore", "ignore", "ignore"];
   const args = [
@@ -43502,7 +43643,7 @@ __export(docs_exports, {
   docsCommand: () => docsCommand
 });
 import { appendFile, mkdir as mkdir2, readdir, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname9, isAbsolute as isAbsolute2, join as join20, resolve as resolve6 } from "node:path";
+import { dirname as dirname9, isAbsolute as isAbsolute2, join as join21, resolve as resolve6 } from "node:path";
 import {
   buildDocsGraph,
   CleoError as CleoError3,
@@ -43526,7 +43667,7 @@ import {
   syncFromGit
 } from "@cleocode/core/internal";
 async function getScriptNames(projectRoot) {
-  const scriptsDir = join20(projectRoot, "scripts");
+  const scriptsDir = join21(projectRoot, "scripts");
   try {
     const files = await readdir(scriptsDir);
     return files.filter((f) => f.endsWith(".sh")).map((f) => f.replace(".sh", "")).sort();
@@ -43535,7 +43676,7 @@ async function getScriptNames(projectRoot) {
   }
 }
 async function getIndexedCommands(projectRoot) {
-  const indexPath = join20(projectRoot, "docs", "commands", "COMMANDS-INDEX.json");
+  const indexPath = join21(projectRoot, "docs", "commands", "COMMANDS-INDEX.json");
   const index = await readJson(indexPath);
   if (!index) return [];
   return index.commands.map((c) => c.name).sort();
@@ -43568,7 +43709,7 @@ async function runGapCheck(_projectRoot, filterId) {
     const reviewFiles = files.filter((f) => f.endsWith(".md"));
     for (const file of reviewFiles) {
       if (filterId && !file.includes(filterId)) continue;
-      const filePath = join20(reviewDir, file);
+      const filePath = join21(reviewDir, file);
       const content = await readFile3(filePath, "utf-8");
       const taskMatch = file.match(/^(T\d+)/);
       const taskId = taskMatch ? taskMatch[1] : "UNKNOWN";
@@ -43612,7 +43753,7 @@ function loadCliRegistry(projectRoot) {
     throw err;
   }
 }
-var addCommand5, listCommand7, fetchCommand, removeCommand2, generateCommand, exportCommand4, searchCommand, mergeCommand, graphCommand, rankCommand, versionsCommand, publishCommand2, publishPrCommand, syncCommand3, statusCommand7, gapCheckCommand, importCommand2, schemaCommand, listTypesCommand, docsCommand;
+var addCommand5, listCommand8, fetchCommand, removeCommand2, generateCommand, exportCommand4, searchCommand, mergeCommand, graphCommand, rankCommand, versionsCommand, publishCommand2, publishPrCommand, syncCommand3, statusCommand7, gapCheckCommand, importCommand2, schemaCommand, listTypesCommand, docsCommand;
 var init_docs3 = __esm({
   "packages/cleo/src/cli/commands/docs.ts"() {
     "use strict";
@@ -43691,7 +43832,7 @@ var init_docs3 = __esm({
         );
       }
     });
-    listCommand7 = defineCommand({
+    listCommand8 = defineCommand({
       meta: {
         name: "list",
         description: "List attachments. With no scope flag, defaults to project scope and surfaces a hint to narrow with --task, --session, or --observation. --type filters across any scope (T9637/T9638). --limit <N> (default 50) and --orderBy <newest|sha|slug> (default newest) control the browsing window (T9792)."
@@ -44507,9 +44648,9 @@ var init_docs3 = __esm({
           })}
 `;
           try {
-            await mkdir2(join20(projectRoot, ".cleo", "audit"), { recursive: true });
+            await mkdir2(join21(projectRoot, ".cleo", "audit"), { recursive: true });
             await appendFile(
-              join20(projectRoot, ".cleo", "audit", "import-force-bypass.jsonl"),
+              join21(projectRoot, ".cleo", "audit", "import-force-bypass.jsonl"),
               auditLine,
               "utf-8"
             );
@@ -44659,7 +44800,7 @@ var init_docs3 = __esm({
       },
       subCommands: {
         add: addCommand5,
-        list: listCommand7,
+        list: listCommand8,
         fetch: fetchCommand,
         remove: removeCommand2,
         generate: generateCommand,
@@ -44963,8 +45104,8 @@ __export(migrate_agents_v2_exports, {
   walkAgentsDir: () => walkAgentsDir
 });
 import { createHash as createHash2 } from "node:crypto";
-import { appendFileSync as appendFileSync2, existsSync as existsSync13, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync14 } from "node:fs";
-import { join as join21 } from "node:path";
+import { appendFileSync as appendFileSync2, existsSync as existsSync14, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync14 } from "node:fs";
+import { join as join22 } from "node:path";
 import { getProjectRoot as getProjectRoot31, installAgentFromCant } from "@cleocode/core/internal";
 import { openCleoDb } from "@cleocode/core/store/open-cleo-db";
 function sha256Hex(bytes) {
@@ -44984,15 +45125,15 @@ function extractAgentName(source) {
   return headerMatch[1] ?? null;
 }
 function appendAuditLog(projectRoot, entry) {
-  const auditPath = join21(projectRoot, AUDIT_LOG_RELATIVE);
-  const auditDir = join21(auditPath, "..");
-  if (!existsSync13(auditDir)) {
+  const auditPath = join22(projectRoot, AUDIT_LOG_RELATIVE);
+  const auditDir = join22(auditPath, "..");
+  if (!existsSync14(auditDir)) {
     mkdirSync3(auditDir, { recursive: true });
   }
   appendFileSync2(auditPath, JSON.stringify(entry) + "\n", "utf8");
 }
 function walkAgentsDir(db, scanDir, projectRoot, summary, verbose) {
-  if (!existsSync13(scanDir)) return;
+  if (!existsSync14(scanDir)) return;
   let files;
   try {
     files = readdirSync2(scanDir).filter((f) => f.endsWith(".cant"));
@@ -45003,7 +45144,7 @@ function walkAgentsDir(db, scanDir, projectRoot, summary, verbose) {
     return;
   }
   for (const filename of files) {
-    const cantPath = join21(scanDir, filename);
+    const cantPath = join22(scanDir, filename);
     const relPath = cantPath.replace(`${projectRoot}/`, "");
     let sourceBytes;
     let sourceText;
@@ -45100,9 +45241,9 @@ async function runMigrateAgentsV2(projectRoot, verbose = true) {
   const { db: _sdDb } = await openCleoDb("signaldock");
   const db = _sdDb;
   try {
-    const canonicalDir = join21(projectRoot, ".cleo", "cant", "agents");
+    const canonicalDir = join22(projectRoot, ".cleo", "cant", "agents");
     walkAgentsDir(db, canonicalDir, projectRoot, summary, verbose);
-    const legacyDir = join21(projectRoot, ".cleo", "agents");
+    const legacyDir = join22(projectRoot, ".cleo", "agents");
     walkAgentsDir(db, legacyDir, projectRoot, summary, verbose);
   } finally {
     db.close();
@@ -45110,8 +45251,8 @@ async function runMigrateAgentsV2(projectRoot, verbose = true) {
   return summary;
 }
 function readMigrationConflicts(projectRoot) {
-  const auditPath = join21(projectRoot, AUDIT_LOG_RELATIVE);
-  if (!existsSync13(auditPath)) return [];
+  const auditPath = join22(projectRoot, AUDIT_LOG_RELATIVE);
+  if (!existsSync14(auditPath)) return [];
   let raw;
   try {
     raw = readFileSync14(auditPath, "utf8");
@@ -45195,7 +45336,7 @@ __export(doctor_exports, {
   doctorCommand: () => doctorCommand2
 });
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 import { getProjectRoot as getProjectRoot32 } from "@cleocode/core";
 import {
   quarantineRogueCleoDir,
@@ -45234,8 +45375,8 @@ async function scanTestFixturesInProd(projectRoot) {
 }
 async function quarantineTestFixtures(projectRoot, matches) {
   if (matches.length === 0) return 0;
-  const cleoDir = join22(projectRoot, ".cleo");
-  const quarantineDir = join22(
+  const cleoDir = join23(projectRoot, ".cleo");
+  const quarantineDir = join23(
     cleoDir,
     "quarantine",
     `fixture-scan-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`
@@ -45243,7 +45384,7 @@ async function quarantineTestFixtures(projectRoot, matches) {
   mkdirSync4(quarantineDir, { recursive: true });
   const manifest = matches.map((m) => ({ ...m, quarantinedAt: (/* @__PURE__ */ new Date()).toISOString() }));
   writeFileSync4(
-    join22(quarantineDir, "manifest.jsonl"),
+    join23(quarantineDir, "manifest.jsonl"),
     manifest.map((m) => JSON.stringify(m)).join("\n") + "\n"
   );
   const { getNativeDb } = await import("@cleocode/core/store/sqlite.js");
@@ -45666,8 +45807,8 @@ var init_doctor = __esm({
               );
               return;
             }
-            const archiveDir = join22(projectRoot, ".cleo", "backups");
-            const auditLogPath = join22(projectRoot, ".cleo", "audit", "worktree-prune.jsonl");
+            const archiveDir = join23(projectRoot, ".cleo", "backups");
+            const auditLogPath = join23(projectRoot, ".cleo", "audit", "worktree-prune.jsonl");
             const result = await pruneWorktreeOrphans(orphans, {
               archiveDir,
               auditLogPath,
@@ -45769,7 +45910,7 @@ __export(event_exports, {
   orchestratorCommand: () => orchestratorCommand
 });
 import { readdir as readdir2 } from "node:fs/promises";
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 import { cwd as processCwd } from "node:process";
 import { appendEvent } from "@cleocode/core/events/event-bus.js";
 function resolveProjectRoot3(arg) {
@@ -45892,7 +46033,7 @@ var init_event = __esm({
         const agentIdFilter = args.agent;
         const showAll = args.all === true;
         const lines = parseInt(args.lines ?? "20", 10);
-        const eventsDir = join23(projectRoot, ".cleo", "agent-events");
+        const eventsDir = join24(projectRoot, ".cleo", "agent-events");
         try {
           let files = [];
           try {
@@ -45929,8 +46070,8 @@ var init_event = __esm({
           }
           for (const file of filesToTail) {
             const agentId = file.replace(".jsonl", "");
-            const { readFileSync: readFileSync20 } = await import("node:fs");
-            const content = readFileSync20(join23(eventsDir, file), "utf-8");
+            const { readFileSync: readFileSync19 } = await import("node:fs");
+            const content = readFileSync19(join24(eventsDir, file), "utf-8");
             const eventLines = content.trim().split("\n").filter(Boolean);
             const tail = eventLines.slice(-lines);
             if (jsonMode) {
@@ -46000,7 +46141,7 @@ var init_event = __esm({
         const epicFilter = args.epic;
         const follow = args.follow === true;
         const lines = parseInt(args.lines ?? "50", 10);
-        const eventsDir = join23(projectRoot, ".cleo", "agent-events");
+        const eventsDir = join24(projectRoot, ".cleo", "agent-events");
         let files = [];
         try {
           const entries = await readdir2(eventsDir);
@@ -46025,8 +46166,8 @@ var init_event = __esm({
         const printAgentLog = async (file) => {
           const agentId = file.replace(".jsonl", "");
           try {
-            const { readFileSync: readFileSync20 } = await import("node:fs");
-            const content = readFileSync20(join23(eventsDir, file), "utf-8");
+            const { readFileSync: readFileSync19 } = await import("node:fs");
+            const content = readFileSync19(join24(eventsDir, file), "utf-8");
             const eventLines = content.trim().split("\n").filter(Boolean);
             const tail = eventLines.slice(-lines);
             if (jsonMode) {
@@ -46319,7 +46460,7 @@ __export(federation_exports, {
   federationCommand: () => federationCommand
 });
 import { skills } from "@cleocode/core";
-var addFederationPeer, listFederationPeers, removeFederationPeer, addCommand6, removeCommand3, listCommand8, federationCommand;
+var addFederationPeer, listFederationPeers, removeFederationPeer, addCommand6, removeCommand3, listCommand9, federationCommand;
 var init_federation = __esm({
   "packages/cleo/src/cli/commands/federation.ts"() {
     "use strict";
@@ -46386,7 +46527,7 @@ var init_federation = __esm({
         }
       }
     });
-    listCommand8 = defineCommand({
+    listCommand9 = defineCommand({
       meta: {
         name: "list",
         description: "List all federation peers in ~/.cleo/federation.json"
@@ -46429,7 +46570,7 @@ var init_federation = __esm({
       subCommands: {
         add: addCommand6,
         remove: removeCommand3,
-        list: listCommand8
+        list: listCommand9
       },
       run({ rawArgs }) {
         const sub = rawArgs?.find((a) => !a.startsWith("-"));
@@ -46529,7 +46670,7 @@ __export(gc_exports, {
   gcCommand: () => gcCommand
 });
 import { homedir as homedir4, tmpdir } from "node:os";
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 import { pruneOrphanTempDirs, pruneOrphanWorktrees } from "@cleocode/core/gc/cleanup.js";
 import { runGC } from "@cleocode/core/gc/runner.js";
 import { readGCState } from "@cleocode/core/gc/state.js";
@@ -46612,7 +46753,7 @@ var init_gc = __esm({
       },
       async run({ args }) {
         const cleoDir = resolveLegacyCleoDir3(args["cleo-dir"]);
-        const statePath = join24(cleoDir, "gc-state.json");
+        const statePath = join25(cleoDir, "gc-state.json");
         try {
           const state = await readGCState(statePath);
           const diskStr = state.lastDiskUsedPct !== null ? `${state.lastDiskUsedPct.toFixed(1)}%` : "unknown";
@@ -46665,8 +46806,8 @@ var init_gc = __esm({
         }
       },
       async run({ args }) {
-        const xdgData = process.env["XDG_DATA_HOME"] ?? join24(homedir4(), ".local", "share");
-        const worktreesRoot = args["worktrees-root"] ?? join24(xdgData, "cleo", "worktrees");
+        const xdgData = process.env["XDG_DATA_HOME"] ?? join25(homedir4(), ".local", "share");
+        const worktreesRoot = args["worktrees-root"] ?? join25(xdgData, "cleo", "worktrees");
         const projectHash = args["project-hash"];
         const dryRun = args["dry-run"];
         const preserveRaw = args["preserve-tasks"];
@@ -46770,263 +46911,6 @@ var init_gc = __esm({
   }
 });
 
-// packages/cleo/src/cli/commands/generate-changelog.ts
-var generate_changelog_exports = {};
-__export(generate_changelog_exports, {
-  generateChangelogCommand: () => generateChangelogCommand
-});
-import { execFileSync as execFileSync2 } from "node:child_process";
-import { existsSync as existsSync14, mkdirSync as mkdirSync5, readFileSync as readFileSync15, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname10, join as join25 } from "node:path";
-import { CleoError as CleoError4, getConfigPath, getProjectRoot as getProjectRoot33, pushWarning as pushWarning2 } from "@cleocode/core";
-function getChangelogSource(cwd) {
-  const configPath = getConfigPath(cwd);
-  try {
-    const config = JSON.parse(readFileSync15(configPath, "utf-8"));
-    return config?.release?.changelog?.source ?? "CHANGELOG.md";
-  } catch {
-    return "CHANGELOG.md";
-  }
-}
-function getEnabledPlatforms(cwd) {
-  const configPath = getConfigPath(cwd);
-  try {
-    const config = JSON.parse(readFileSync15(configPath, "utf-8"));
-    const outputs = config?.release?.changelog?.outputs ?? [];
-    return outputs.filter((o) => o.enabled);
-  } catch {
-    return [];
-  }
-}
-function getDefaultOutputPath(platform) {
-  switch (platform) {
-    case "mintlify":
-      return "docs/changelog/overview.mdx";
-    case "docusaurus":
-      return "docs/changelog.md";
-    default:
-      return "CHANGELOG.md";
-  }
-}
-function getGitHubRepoSlug(cwd) {
-  const projectRoot = getProjectRoot33(cwd);
-  try {
-    const remoteUrl = execFileSync2("git", ["remote", "get-url", "origin"], {
-      cwd: projectRoot,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"]
-    }).trim();
-    return remoteUrl.replace(/.*github\.com[:/]/, "").replace(/\.git$/, "");
-  } catch {
-    return "";
-  }
-}
-function generateForPlatform(platform, sourceContent, repoSlug, limit) {
-  switch (platform) {
-    case "mintlify":
-      return generateMintlify(sourceContent, repoSlug, limit);
-    case "docusaurus":
-      return generateDocusaurus(sourceContent, limit);
-    default:
-      return sourceContent;
-  }
-}
-function generateMintlify(source, repoSlug, limit) {
-  const lines = [];
-  lines.push("---");
-  lines.push('title: "Changelog"');
-  lines.push('description: "CLEO release history and product updates"');
-  lines.push('icon: "clock-rotate-left"');
-  lines.push("rss: true");
-  lines.push("---");
-  lines.push("");
-  lines.push("# Changelog");
-  lines.push("");
-  const sourceLines = source.split("\n");
-  const blocks = [];
-  let currentBlock = null;
-  for (let i = 0; i < sourceLines.length; i++) {
-    const line = sourceLines[i];
-    const vMatch = line.match(/^## \[v?(\d+\.\d+\.\d+)\] - (\d{4}-\d{2}-\d{2})/);
-    if (vMatch) {
-      if (currentBlock) {
-        blocks.push({
-          version: currentBlock.version,
-          date: currentBlock.date,
-          content: sourceLines.slice(currentBlock.startLine + 1, i).join("\n").trim()
-        });
-      }
-      currentBlock = { version: vMatch[1], date: vMatch[2], startLine: i };
-    }
-  }
-  if (currentBlock) {
-    blocks.push({
-      version: currentBlock.version,
-      date: currentBlock.date,
-      content: sourceLines.slice(currentBlock.startLine + 1).join("\n").trim()
-    });
-  }
-  for (const block of blocks.slice(0, limit)) {
-    lines.push(`## v${block.version} - ${block.date}`);
-    lines.push("");
-    lines.push(block.content);
-    lines.push("");
-    if (repoSlug) {
-      lines.push(
-        `[View full release notes](https://github.com/${repoSlug}/releases/tag/v${block.version})`
-      );
-      lines.push("");
-    }
-  }
-  return lines.join("\n");
-}
-function generateDocusaurus(source, limit) {
-  const lines = [];
-  lines.push("---");
-  lines.push("id: changelog");
-  lines.push("title: Changelog");
-  lines.push("sidebar_label: Changelog");
-  lines.push("---");
-  lines.push("");
-  lines.push("# Changelog");
-  lines.push("");
-  const sourceLines = source.split("\n");
-  let versionCount = 0;
-  let inUnreleased = false;
-  for (const line of sourceLines) {
-    if (/^## \[Unreleased\]/.test(line)) {
-      inUnreleased = true;
-      continue;
-    }
-    if (/^## \[v?\d+\.\d+\.\d+\]/.test(line)) {
-      inUnreleased = false;
-      versionCount++;
-      if (versionCount > limit) break;
-    }
-    if (!inUnreleased && versionCount > 0) {
-      lines.push(line);
-    }
-  }
-  return lines.join("\n");
-}
-var generateChangelogCommand;
-var init_generate_changelog = __esm({
-  "packages/cleo/src/cli/commands/generate-changelog.ts"() {
-    "use strict";
-    init_src2();
-    init_dist();
-    init_renderers();
-    generateChangelogCommand = defineCommand({
-      meta: {
-        name: "generate-changelog",
-        description: "Generate platform-specific changelog from CHANGELOG.md"
-      },
-      args: {
-        platform: {
-          type: "string",
-          description: "Target platform (mintlify, docusaurus, plain, github)"
-        },
-        limit: {
-          type: "string",
-          description: "Max versions to include",
-          default: "15"
-        },
-        "dry-run": {
-          type: "boolean",
-          description: "Show what would be generated without writing"
-        }
-      },
-      async run({ args }) {
-        try {
-          pushWarning2({
-            code: "W_DEPRECATED_COMMAND",
-            message: "`cleo generate-changelog` is deprecated. Use `cleo changeset add` (T9793) + the aggregator (T9759 composer) instead.",
-            severity: "warn",
-            deprecated: "cleo generate-changelog",
-            replacement: "cleo changeset add",
-            removeBy: "v2026.6.0",
-            context: {
-              registryId: "generate-changelog-renderer",
-              task: "T9795",
-              saga: "T9787"
-            }
-          });
-          const limit = Number(args.limit ?? 15);
-          const targetPlatform = args.platform;
-          const dryRun = args["dry-run"] === true;
-          const sourceFile = getChangelogSource();
-          const sourcePath = join25(getProjectRoot33(), sourceFile);
-          if (!existsSync14(sourcePath)) {
-            throw new CleoError4(4 /* NOT_FOUND */, `Changelog source not found: ${sourcePath}`);
-          }
-          const sourceContent = readFileSync15(sourcePath, "utf-8");
-          const repoSlug = getGitHubRepoSlug();
-          const results = [];
-          if (targetPlatform) {
-            const platforms = getEnabledPlatforms();
-            const platformConfig = platforms.find((p) => p.platform === targetPlatform);
-            const outputPath = platformConfig?.path ?? getDefaultOutputPath(targetPlatform);
-            const content = generateForPlatform(targetPlatform, sourceContent, repoSlug, limit);
-            if (!dryRun) {
-              const fullPath = join25(getProjectRoot33(), outputPath);
-              mkdirSync5(dirname10(fullPath), { recursive: true });
-              writeFileSync5(fullPath, content, "utf-8");
-            }
-            results.push({ platform: targetPlatform, path: outputPath, written: !dryRun });
-          } else {
-            const platforms = getEnabledPlatforms();
-            if (platforms.length === 0) {
-              throw new CleoError4(
-                8 /* CONFIG_ERROR */,
-                "No changelog output platforms configured. Configure in .cleo/config.json under release.changelog.outputs"
-              );
-            }
-            for (const platformConfig of platforms) {
-              const content = generateForPlatform(
-                platformConfig.platform,
-                sourceContent,
-                repoSlug,
-                limit
-              );
-              if (!dryRun) {
-                const fullPath = join25(getProjectRoot33(), platformConfig.path);
-                mkdirSync5(dirname10(fullPath), { recursive: true });
-                writeFileSync5(fullPath, content, "utf-8");
-              }
-              results.push({
-                platform: platformConfig.platform,
-                path: platformConfig.path,
-                written: !dryRun
-              });
-            }
-          }
-          cliOutput(
-            {
-              dryRun,
-              source: sourceFile,
-              repoSlug: repoSlug || null,
-              generated: results
-            },
-            { command: "generate-changelog" }
-          );
-        } catch (err) {
-          if (err instanceof CleoError4) {
-            cliError(`generate-changelog failed: ${err.message}`, err.code, {
-              name: "E_GENERATE_CHANGELOG_FAILED"
-            });
-            process.exit(err.code);
-          }
-          const message = err instanceof Error ? err.message : String(err);
-          cliError(`generate-changelog failed: ${message}`, 1 /* GENERAL_ERROR */, {
-            name: "E_GENERATE_CHANGELOG_FAILED"
-          });
-          process.exit(1 /* GENERAL_ERROR */);
-        }
-      }
-    });
-  }
-});
-
 // packages/cleo/src/cli/commands/grade.ts
 var grade_exports = {};
 __export(grade_exports, {
@@ -48135,11 +48019,11 @@ __export(init_exports, {
   getWorkflowTemplatesDir: () => getWorkflowTemplatesDir,
   initCommand: () => initCommand2
 });
-import { existsSync as existsSync15, readFileSync as readFileSync16 } from "node:fs";
-import { dirname as dirname11, join as join26, resolve as resolve7 } from "node:path";
+import { existsSync as existsSync15, readFileSync as readFileSync15 } from "node:fs";
+import { dirname as dirname10, join as join26, resolve as resolve7 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 import {
-  CleoError as CleoError5,
+  CleoError as CleoError4,
   formatError as formatError5,
   initProject as initProject2,
   scaffoldWorkflows
@@ -48152,7 +48036,7 @@ function getGitignoreTemplate() {
     const monorepoTemplatePath = join26(packageRoot, "..", "..", "templates", "cleo-gitignore");
     const templatePath = existsSync15(localTemplatePath) ? localTemplatePath : monorepoTemplatePath;
     if (existsSync15(templatePath)) {
-      return readFileSync16(templatePath, "utf-8");
+      return readFileSync15(templatePath, "utf-8");
     }
   } catch {
   }
@@ -48160,7 +48044,7 @@ function getGitignoreTemplate() {
 }
 function getWorkflowTemplatesDir() {
   const thisFile = fileURLToPath7(import.meta.url);
-  const packageRoot = resolve7(dirname11(thisFile), "..", "..", "..", "..");
+  const packageRoot = resolve7(dirname10(thisFile), "..", "..", "..", "..");
   return join26(packageRoot, "templates", "workflows");
 }
 var initCommand2;
@@ -48260,7 +48144,7 @@ var init_init = __esm({
             { command: "init" }
           );
         } catch (err) {
-          if (err instanceof CleoError5) {
+          if (err instanceof CleoError4) {
             cliError(formatError5(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -48580,7 +48464,7 @@ var issue_exports = {};
 __export(issue_exports, {
   issueCommand: () => issueCommand
 });
-import { execFileSync as execFileSync3 } from "node:child_process";
+import { execFileSync as execFileSync2 } from "node:child_process";
 import { addIssue, BUILD_CONFIG } from "@cleocode/core/internal";
 async function handleIssueType(issueType, opts) {
   let result;
@@ -48603,7 +48487,7 @@ async function handleIssueType(issueType, opts) {
   if (opts["open"] && typeof result.url === "string" && result.url.startsWith("https://")) {
     const issueNumber = result.url.match(/(\d+)$/)?.[1] ?? "unknown";
     try {
-      execFileSync3("gh", ["issue", "view", issueNumber, "--repo", CLEO_REPO, "--web"], {
+      execFileSync2("gh", ["issue", "view", issueNumber, "--repo", CLEO_REPO, "--web"], {
         stdio: ["pipe", "pipe", "pipe"]
       });
     } catch {
@@ -48716,13 +48600,13 @@ var labels_exports = {};
 __export(labels_exports, {
   labelsCommand: () => labelsCommand
 });
-var listCommand9, showCommand5, statsCommand2, labelsCommand;
+var listCommand10, showCommand5, statsCommand2, labelsCommand;
 var init_labels = __esm({
   "packages/cleo/src/cli/commands/labels.ts"() {
     "use strict";
     init_dist();
     init_cli();
-    listCommand9 = defineCommand({
+    listCommand10 = defineCommand({
       meta: { name: "list", description: "List all labels with task counts (default)" },
       async run() {
         await dispatchFromCli("query", "tasks", "label.list", {}, { command: "labels" });
@@ -48749,7 +48633,7 @@ var init_labels = __esm({
         description: "List all labels with counts or show tasks with specific label"
       },
       subCommands: {
-        list: listCommand9,
+        list: listCommand10,
         show: showCommand5,
         stats: statsCommand2
       },
@@ -49015,10 +48899,10 @@ var init_lifecycle2 = __esm({
 // packages/cleo/src/cli/commands/list.ts
 var list_exports = {};
 __export(list_exports, {
-  listCommand: () => listCommand10
+  listCommand: () => listCommand11
 });
 import { createPage as createPage2 } from "@cleocode/core";
-var listArgs, listCommand10;
+var listArgs, listCommand11;
 var init_list2 = __esm({
   "packages/cleo/src/cli/commands/list.ts"() {
     "use strict";
@@ -49034,7 +48918,7 @@ var init_list2 = __esm({
         description: "Alias for --parent (legacy parentId compatibility)"
       }
     };
-    listCommand10 = defineCommand({
+    listCommand11 = defineCommand({
       meta: { name: "list", description: "List tasks with optional filters" },
       args: listArgs,
       async run({ args }) {
@@ -49076,7 +48960,7 @@ var llm_cost_exports = {};
 __export(llm_cost_exports, {
   costCommand: () => costCommand
 });
-import { getProjectRoot as getProjectRoot34 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot33 } from "@cleocode/core/internal";
 import { computeCost } from "@cleocode/core/llm/usage-pricing";
 function resolveSessionId(raw) {
   if (raw === "current") {
@@ -49149,7 +49033,7 @@ var init_llm_cost = __esm({
           process.exit(6);
         }
         const sessionId = resolveSessionId(rawSessionId);
-        const projectRoot = getProjectRoot34(process.cwd());
+        const projectRoot = getProjectRoot33(process.cwd());
         let breakdown;
         try {
           breakdown = await loadSessionCostBreakdown(projectRoot, sessionId);
@@ -49790,7 +49674,7 @@ var llm_exports = {};
 __export(llm_exports, {
   llmCommand: () => llmCommand
 });
-import { pushWarning as pushWarning3 } from "@cleocode/core";
+import { pushWarning as pushWarning2 } from "@cleocode/core";
 async function getListProviders() {
   const { listProviders } = await import(
     /* webpackIgnore: true */
@@ -49824,7 +49708,7 @@ function makeLlmSubcommand(opts) {
     }
   });
 }
-var API_KEY_FLAG_DEPRECATION, addCommand7, listCommand11, removeCommand4, useCommand, profileCommand, testCommand, whoamiCommand, listProvidersCommand, contextEnginesListCommand, contextEnginesCommand, loginCommand, refreshCatalogCommand, llmCommand;
+var API_KEY_FLAG_DEPRECATION, addCommand7, listCommand12, removeCommand4, useCommand, profileCommand, testCommand, whoamiCommand, listProvidersCommand, contextEnginesListCommand, contextEnginesCommand, loginCommand, refreshCatalogCommand, llmCommand;
 var init_llm3 = __esm({
   "packages/cleo/src/cli/commands/llm.ts"() {
     "use strict";
@@ -49921,7 +49805,7 @@ var init_llm3 = __esm({
           apiKey = envValue;
           source = "env";
         } else if (typeof a["api-key"] === "string" && a["api-key"]) {
-          pushWarning3({
+          pushWarning2({
             code: "W_DEPRECATED_FLAG",
             message: API_KEY_FLAG_DEPRECATION,
             deprecated: "--api-key=<value>",
@@ -49957,7 +49841,7 @@ var init_llm3 = __esm({
         });
       }
     });
-    listCommand11 = makeLlmSubcommand({
+    listCommand12 = makeLlmSubcommand({
       name: "list",
       description: "List redacted credentials from the multi-credential pool (tokens shown as last 4 chars only).",
       args: {
@@ -50252,7 +50136,7 @@ var init_llm3 = __esm({
         add: addCommand7,
         "context-engines": contextEnginesCommand,
         cost: costCommand,
-        list: listCommand11,
+        list: listCommand12,
         login: loginCommand,
         remove: removeCommand4,
         stream: streamCommand,
@@ -50350,7 +50234,7 @@ async function readStdin() {
     process.stdin.on("error", reject);
   });
 }
-var showCommand7, listCommand12, findCommand4, statsCommand3, appendCommand, archiveCommand2, manifestCommand;
+var showCommand7, listCommand13, findCommand4, statsCommand3, appendCommand, archiveCommand2, manifestCommand;
 var init_manifest = __esm({
   "packages/cleo/src/cli/commands/manifest.ts"() {
     "use strict";
@@ -50380,7 +50264,7 @@ var init_manifest = __esm({
         );
       }
     });
-    listCommand12 = defineCommand({
+    listCommand13 = defineCommand({
       meta: {
         name: "list",
         description: "List manifest entries with optional filters"
@@ -50644,7 +50528,7 @@ var init_manifest = __esm({
       },
       subCommands: {
         show: showCommand7,
-        list: listCommand12,
+        list: listCommand13,
         find: findCommand4,
         stats: statsCommand3,
         append: appendCommand,
@@ -50697,10 +50581,10 @@ __export(memory_exports, {
   memoryCommand: () => memoryCommand
 });
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync16, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync17, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync5, readdirSync as readdirSync3, readFileSync as readFileSync16, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { join as join27 } from "node:path";
-import { getProjectRoot as getProjectRoot35 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot34 } from "@cleocode/core";
 import {
   getBrainDb as getBrainDb2,
   getDreamStatus,
@@ -50743,7 +50627,7 @@ ${body}`).digest("hex").slice(0, 16);
 function loadImportHashes(stateFile) {
   try {
     if (!existsSync16(stateFile)) return /* @__PURE__ */ new Set();
-    const raw = readFileSync17(stateFile, "utf-8");
+    const raw = readFileSync16(stateFile, "utf-8");
     const parsed = JSON.parse(raw);
     return new Set(parsed.hashes);
   } catch {
@@ -50752,8 +50636,8 @@ function loadImportHashes(stateFile) {
 }
 function saveImportHashes(stateFile, hashes) {
   const dir = stateFile.slice(0, stateFile.lastIndexOf("/"));
-  if (!existsSync16(dir)) mkdirSync6(dir, { recursive: true });
-  writeFileSync6(stateFile, JSON.stringify({ hashes: [...hashes] }, null, 2), "utf-8");
+  if (!existsSync16(dir)) mkdirSync5(dir, { recursive: true });
+  writeFileSync5(stateFile, JSON.stringify({ hashes: [...hashes] }, null, 2), "utf-8");
 }
 function makeMemorySubcommand(opts) {
   const mergedArgs = {
@@ -51667,7 +51551,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         try {
           const result = await runConsolidation(root);
           cliOutput(result, { command: "memory-consolidate", operation: "memory.consolidate" });
@@ -51691,7 +51575,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         if (args.status) {
           try {
             const status = await getDreamStatus(root);
@@ -51728,7 +51612,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         try {
           const { runObserver, runReflector } = await import("@cleocode/core/memory");
           const observerResult = await runObserver(root, args.session, {
@@ -51768,7 +51652,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         try {
           await getBrainDb2(root);
           const { totalDuplicateRows, groups } = await scanDuplicateEntries();
@@ -51814,7 +51698,7 @@ var init_memory3 = __esm({
       async run({ args }) {
         const sourceDir = args.from ?? join27(homedir5(), ".claude", "projects", "-mnt-projects-cleocode", "memory");
         const isDryRun = !!args["dry-run"];
-        const projectRoot = getProjectRoot35();
+        const projectRoot = getProjectRoot34();
         const stateFile = join27(projectRoot, CLEO_DIR_NAME, MIGRATE_MEMORY_HASHES_JSON);
         if (!existsSync16(sourceDir)) {
           cliError(`Source directory not found: ${sourceDir}`, "E_NOT_FOUND", { name: "E_NOT_FOUND" });
@@ -51830,7 +51714,7 @@ var init_memory3 = __esm({
         for (const filePath of files) {
           const fileName = filePath.split("/").pop() ?? filePath;
           try {
-            const raw = readFileSync17(filePath, "utf-8");
+            const raw = readFileSync16(filePath, "utf-8");
             if (!raw.trim()) {
               stats.skipped++;
               skippedEntries.push({ file: fileName, reason: "empty file" });
@@ -52027,7 +51911,7 @@ var init_memory3 = __esm({
       },
       args: {},
       async run() {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         try {
           await getBrainDb2(root);
           const result = await getTierStats(root);
@@ -52070,7 +51954,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["medium", "long"];
@@ -52136,7 +52020,7 @@ var init_memory3 = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot35();
+        const root = getProjectRoot34();
         const targetTier = args.to;
         const reason = args.reason;
         const validTiers = ["short", "medium"];
@@ -52604,7 +52488,7 @@ var migrate_claude_mem_exports = {};
 __export(migrate_claude_mem_exports, {
   migrateClaudeMemCommand: () => migrateClaudeMemCommand
 });
-import { getProjectRoot as getProjectRoot36, migrateClaudeMem } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot35, migrateClaudeMem } from "@cleocode/core/internal";
 import { ingestLooseAgentOutputs, ingestRcasdDirectories } from "@cleocode/core/memory";
 import { getDb as getDb2 } from "@cleocode/core/store/sqlite";
 var storageCommand, claudeMemCommand, manifestIngestCommand, migrateClaudeMemCommand;
@@ -52667,7 +52551,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const root = getProjectRoot36();
+        const root = getProjectRoot35();
         try {
           const result = await migrateClaudeMem(root, {
             sourcePath: args.source,
@@ -52716,7 +52600,7 @@ var init_migrate_claude_mem = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot36();
+        const projectRoot = getProjectRoot35();
         try {
           const db = await getDb2(projectRoot);
           const rcasdFlag = Boolean(args.rcasd);
@@ -52820,7 +52704,7 @@ __export(nexus_exports, {
 import { appendFile as appendFile2, mkdir as mkdir3 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 import path4 from "node:path";
-import { getProjectRoot as getProjectRoot37 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot36 } from "@cleocode/core";
 import { generateGexf, getSymbolImpact } from "@cleocode/core/nexus";
 async function appendDeprecationTelemetry(op, replacement) {
   try {
@@ -52837,7 +52721,7 @@ function applyJsonFlag2(jsonFlag) {
     setFormatContext({ format: "json", source: "flag", quiet: false });
   }
 }
-var initCommand3, registerCommand2, unregisterCommand, listCommand13, statusCommand10, showCommand8, resolveCommand2, discoverCommand2, augmentCommand2, setupCommand, searchCommand3, depsCommand3, criticalPathCommand2, blockingCommand, orphansCommand2, syncCommand5, reconcileCommand2, graphCommand3, shareStatusCommand, transferPreviewCommand, transferCommand, permissionSetCommand, permissionCommand, shareExportCommand, shareImportCommand, shareCommand, clustersCommand2, flowsCommand2, contextCommand4, impactCommand3, analyzeCommand3, projectsListCommand, projectsRegisterCommand, projectsRemoveCommand, projectsScanCommand, projectsCleanCommand, projectsCommand, refreshBridgeCommand, exportCommand6, diffCommand2, queryCommand2, routeMapCommand2, shapeCheckCommand2, fullContextCommand, taskFootprintCommand, brainAnchorsCommand, whyCommand, impactFullCommand2, conduitScanCommand, taskSymbolsCommand, searchCodeCommand2, contractsSyncCommand, contractsShowCommand, contractsLinkTasksCommand, contractsCommand, groupCommand, wikiCommand2, hotPathsCommand2, hotNodesCommand2, coldSymbolsCommand2, sigilSyncCommand, sigilListCommand, sigilCommand, topEntriesCommand, nexusCommand;
+var initCommand3, registerCommand2, unregisterCommand, listCommand14, statusCommand10, showCommand8, resolveCommand2, discoverCommand2, augmentCommand2, setupCommand, searchCommand3, depsCommand3, criticalPathCommand2, blockingCommand, orphansCommand2, syncCommand5, reconcileCommand2, graphCommand3, shareStatusCommand, transferPreviewCommand, transferCommand, permissionSetCommand, permissionCommand, shareExportCommand, shareImportCommand, shareCommand, clustersCommand2, flowsCommand2, contextCommand4, impactCommand3, analyzeCommand3, projectsListCommand, projectsRegisterCommand, projectsRemoveCommand, projectsScanCommand, projectsCleanCommand, projectsCommand, refreshBridgeCommand, exportCommand6, diffCommand2, queryCommand2, routeMapCommand2, shapeCheckCommand2, fullContextCommand, taskFootprintCommand, brainAnchorsCommand, whyCommand, impactFullCommand2, conduitScanCommand, taskSymbolsCommand, searchCodeCommand2, contractsSyncCommand, contractsShowCommand, contractsLinkTasksCommand, contractsCommand, groupCommand, wikiCommand2, hotPathsCommand2, hotNodesCommand2, coldSymbolsCommand2, sigilSyncCommand, sigilListCommand, sigilCommand, topEntriesCommand, nexusCommand;
 var init_nexus4 = __esm({
   "packages/cleo/src/cli/commands/nexus.ts"() {
     "use strict";
@@ -52903,7 +52787,7 @@ var init_nexus4 = __esm({
         );
       }
     });
-    listCommand13 = defineCommand({
+    listCommand14 = defineCommand({
       meta: { name: "list", description: "List all registered projects" },
       async run() {
         await dispatchFromCli("query", "nexus", "list", {}, { command: "nexus" });
@@ -52932,7 +52816,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const startTime = Date.now();
         try {
           const [{ getNexusDb, nexusSchema }, { getIndexStats }] = await Promise.all([
@@ -53447,7 +53331,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "clusters", { projectId, repoPath });
         const durationMs = Date.now() - startTime;
@@ -53491,7 +53375,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "flows", { projectId, repoPath });
         const durationMs = Date.now() - startTime;
@@ -53534,7 +53418,7 @@ var init_nexus4 = __esm({
         void appendDeprecationTelemetry("nexus.context", "cleo graph context");
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = getProjectRoot37();
+        const repoPath = getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const limit = parseInt(args.limit, 10);
         const symbolName = args.symbol;
@@ -53597,7 +53481,7 @@ var init_nexus4 = __esm({
         const startTime = Date.now();
         const whyFlag = !!args.why;
         const projectIdOverride = args["project-id"];
-        const repoPath = getProjectRoot37();
+        const repoPath = getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const maxDepth = Math.min(parseInt(args.depth, 10), 5);
         const symbolName = args.symbol;
@@ -53669,7 +53553,7 @@ var init_nexus4 = __esm({
         const projectIdOverride = args["project-id"];
         const isIncremental = !!args.incremental;
         const ctx = getFormatContext();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         humanInfo(`[nexus] Analyzing: ${repoPath}${isIncremental ? " (incremental)" : ""}`);
         try {
           const [{ getNexusDb, nexusSchema }, { runPipeline }, { eq: eq2 }] = await Promise.all([
@@ -53821,7 +53705,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const name = args.name;
         const response = await dispatchRaw("mutate", "nexus", "projects.register", {
           path: repoPath,
@@ -54179,7 +54063,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "refresh-bridge", {
           repoPath,
@@ -54280,8 +54164,8 @@ var init_nexus4 = __esm({
             return;
           }
           if (outputFile) {
-            const { writeFileSync: writeFileSync7 } = await import("node:fs");
-            writeFileSync7(outputFile, output2, "utf-8");
+            const { writeFileSync: writeFileSync6 } = await import("node:fs");
+            writeFileSync6(outputFile, output2, "utf-8");
             const durationMs = Date.now() - startTime;
             cliOutput(
               { outputFile, nodeCount: nodes.length, edgeCount: relations.length },
@@ -54328,7 +54212,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectIdOverride = args["project-id"];
         const beforeRef = args.before ?? "HEAD~1";
         const afterRef = args.after ?? "HEAD";
@@ -54446,7 +54330,7 @@ var init_nexus4 = __esm({
         applyJsonFlag2(args.json);
         const startTime = Date.now();
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "route-map", { projectId });
         const durationMs = Date.now() - startTime;
@@ -54502,7 +54386,7 @@ var init_nexus4 = __esm({
         const startTime = Date.now();
         const routeSymbol = args.routeSymbol;
         const projectIdOverride = args["project-id"];
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("query", "nexus", "shape-check", { routeSymbol, projectId });
         const durationMs = Date.now() - startTime;
@@ -54892,7 +54776,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectIdOverride = args["project-id"];
         const projectId = projectIdOverride ?? Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "contracts-sync", {
@@ -54996,7 +54880,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot37();
+        const repoPath = args.path ? path4.resolve(args.path) : getProjectRoot36();
         const projectId = Buffer.from(repoPath).toString("base64url").slice(0, 32);
         const response = await dispatchRaw("mutate", "nexus", "contracts-link-tasks", {
           projectId,
@@ -55072,7 +54956,7 @@ var init_nexus4 = __esm({
       async run({ args }) {
         applyJsonFlag2(args.json);
         const startTime = Date.now();
-        const outputDir = args.output ?? path4.join(getProjectRoot37(), ".cleo", "wiki");
+        const outputDir = args.output ?? path4.join(getProjectRoot36(), ".cleo", "wiki");
         const communityFilter = args.community ?? void 0;
         const isIncremental = !!args.incremental;
         let loomProvider = null;
@@ -55096,11 +54980,11 @@ var init_nexus4 = __esm({
         }
         try {
           const { generateNexusWikiIndex } = await import("@cleocode/core/nexus/wiki-index.js");
-          const result = await generateNexusWikiIndex(outputDir, getProjectRoot37(), {
+          const result = await generateNexusWikiIndex(outputDir, getProjectRoot36(), {
             communityFilter,
             incremental: isIncremental,
             loomProvider,
-            projectRoot: getProjectRoot37()
+            projectRoot: getProjectRoot36()
           });
           const durationMs = Date.now() - startTime;
           if (!result.success) {
@@ -55337,7 +55221,7 @@ var init_nexus4 = __esm({
         init: initCommand3,
         register: registerCommand2,
         unregister: unregisterCommand,
-        list: listCommand13,
+        list: listCommand14,
         status: statusCommand10,
         show: showCommand8,
         resolve: resolveCommand2,
@@ -55576,7 +55460,10 @@ var init_orchestrate3 = __esm({
       }
     });
     readyCommand = defineCommand({
-      meta: { name: "ready", description: "Get parallel-safe ready tasks" },
+      meta: {
+        name: "ready",
+        description: "Get parallel-safe ready tasks. When the epic is a Saga (label='saga', ADR-073), traverses task_relations.type='groups' instead of parentId."
+      },
       args: {
         epicId: {
           type: "positional",
@@ -55586,6 +55473,10 @@ var init_orchestrate3 = __esm({
         "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."
+        },
+        via: {
+          type: "string",
+          description: "Traversal mode (gh-390/ADR-073): 'parent' walks parentId only, 'saga' walks task_relations.type='groups' only, 'both' (default) auto-detects saga-labeled epics."
         }
       },
       async run({ args }) {
@@ -55595,7 +55486,8 @@ var init_orchestrate3 = __esm({
           "ready",
           {
             epicId: args.epicId,
-            ignoreDepsValidate: args["ignore-deps-validate"] === true
+            ignoreDepsValidate: args["ignore-deps-validate"] === true,
+            ...args.via !== void 0 && { via: args.via }
           },
           { command: "orchestrate" }
         );
@@ -55621,12 +55513,19 @@ var init_orchestrate3 = __esm({
       }
     });
     wavesCommand2 = defineCommand({
-      meta: { name: "waves", description: "Compute dependency waves for an epic" },
+      meta: {
+        name: "waves",
+        description: "Compute dependency waves for an epic. When the epic is a Saga (label='saga', ADR-073), per-member wave plans are merged by index (wave N across all members \u2192 one unified wave N)."
+      },
       args: {
         epicId: {
           type: "positional",
           description: "Epic ID to compute waves for",
           required: true
+        },
+        via: {
+          type: "string",
+          description: "Traversal mode (gh-390/ADR-073): 'parent' walks parentId only, 'saga' walks task_relations.type='groups' only, 'both' (default) auto-detects saga-labeled epics."
         }
       },
       async run({ args }) {
@@ -55634,7 +55533,10 @@ var init_orchestrate3 = __esm({
           "query",
           "orchestrate",
           "waves",
-          { epicId: args.epicId },
+          {
+            epicId: args.epicId,
+            ...args.via !== void 0 && { via: args.via }
+          },
           { command: "orchestrate" }
         );
       }
@@ -56320,7 +56222,7 @@ __export(otel_exports, {
   otelCommand: () => otelCommand
 });
 import {
-  CleoError as CleoError6,
+  CleoError as CleoError5,
   clearOtelData,
   formatError as formatError6,
   getOtelSessions,
@@ -56342,7 +56244,7 @@ var init_otel = __esm({
           const result = await getOtelStatus();
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56357,7 +56259,7 @@ var init_otel = __esm({
           const result = await getOtelSummary();
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56385,7 +56287,7 @@ var init_otel = __esm({
           });
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56413,7 +56315,7 @@ var init_otel = __esm({
           });
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56441,7 +56343,7 @@ var init_otel = __esm({
           });
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56456,7 +56358,7 @@ var init_otel = __esm({
           const result = await clearOtelData();
           cliOutput(result, { command: "otel" });
         } catch (err) {
-          if (err instanceof CleoError6) {
+          if (err instanceof CleoError5) {
             cliError(formatError6(err), err.code, { name: "E_INTERNAL" });
             process.exit(err.code);
           }
@@ -56491,7 +56393,7 @@ var phase_exports = {};
 __export(phase_exports, {
   phaseCommand: () => phaseCommand
 });
-var showCommand9, listCommand14, setCommand2, startCommand6, completeCommand3, advanceCommand2, renameCommand, deleteCommand2, phaseCommand;
+var showCommand9, listCommand15, setCommand2, startCommand6, completeCommand3, advanceCommand2, renameCommand, deleteCommand2, phaseCommand;
 var init_phase = __esm({
   "packages/cleo/src/cli/commands/phase.ts"() {
     "use strict";
@@ -56511,7 +56413,7 @@ var init_phase = __esm({
         await dispatchFromCli("query", "pipeline", "phase.show", params, { command: "phase" });
       }
     });
-    listCommand14 = defineCommand({
+    listCommand15 = defineCommand({
       meta: { name: "list", description: "List all phases with status" },
       async run() {
         await dispatchFromCli("query", "pipeline", "phase.list", {}, { command: "phase" });
@@ -56669,7 +56571,7 @@ var init_phase = __esm({
       meta: { name: "phase", description: "Project-level phase lifecycle management" },
       subCommands: {
         show: showCommand9,
-        list: listCommand14,
+        list: listCommand15,
         set: setCommand2,
         start: startCommand6,
         complete: completeCommand3,
@@ -56775,7 +56677,7 @@ var playbook_exports = {};
 __export(playbook_exports, {
   playbookCommand: () => playbookCommand
 });
-var runCommand4, statusCommand13, resumeCommand, createCommand2, listCommand15, validateCommand7, playbookCommand;
+var runCommand4, statusCommand13, resumeCommand, createCommand2, listCommand16, validateCommand7, playbookCommand;
 var init_playbook3 = __esm({
   "packages/cleo/src/cli/commands/playbook.ts"() {
     "use strict";
@@ -56896,7 +56798,7 @@ var init_playbook3 = __esm({
         );
       }
     });
-    listCommand15 = defineCommand({
+    listCommand16 = defineCommand({
       meta: {
         name: "list",
         description: "List playbook runs (optionally filter by status: active|completed|pending|failed|cancelled)"
@@ -56966,7 +56868,7 @@ var init_playbook3 = __esm({
         run: runCommand4,
         status: statusCommand13,
         resume: resumeCommand,
-        list: listCommand15,
+        list: listCommand16,
         create: createCommand2,
         validate: validateCommand7
       },
@@ -57125,14 +57027,14 @@ var provider_exports = {};
 __export(provider_exports, {
   providerCommand: () => providerCommand
 });
-var listCommand16, detectCommand3, injectStatusCommand, supportsCommand, hooksCommand, injectCommand2, providerCommand;
+var listCommand17, detectCommand3, injectStatusCommand, supportsCommand, hooksCommand, injectCommand2, providerCommand;
 var init_provider = __esm({
   "packages/cleo/src/cli/commands/provider.ts"() {
     "use strict";
     init_dist();
     init_cli();
     init_subcommand_guard();
-    listCommand16 = defineCommand({
+    listCommand17 = defineCommand({
       meta: { name: "list", description: "List all registered CAAMP providers" },
       args: {
         limit: {
@@ -57290,7 +57192,7 @@ var init_provider = __esm({
         description: "CAAMP provider registry: list, detect, supports, hooks, inject"
       },
       subCommands: {
-        list: listCommand16,
+        list: listCommand17,
         detect: detectCommand3,
         "inject-status": injectStatusCommand,
         supports: supportsCommand,
@@ -57498,7 +57400,7 @@ var refresh_memory_exports = {};
 __export(refresh_memory_exports, {
   refreshMemoryCommand: () => refreshMemoryCommand
 });
-import { getProjectRoot as getProjectRoot38 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot37 } from "@cleocode/core";
 var refreshMemoryCommand;
 var init_refresh_memory = __esm({
   "packages/cleo/src/cli/commands/refresh-memory.ts"() {
@@ -57511,7 +57413,7 @@ var init_refresh_memory = __esm({
         description: "Regenerate .cleo/memory-bridge.md from brain.db"
       },
       async run() {
-        const projectDir = getProjectRoot38();
+        const projectDir = getProjectRoot37();
         const { writeMemoryBridge } = await import("@cleocode/core/internal");
         const result = await writeMemoryBridge(projectDir);
         if (result.written) {
@@ -57529,7 +57431,7 @@ var relates_exports = {};
 __export(relates_exports, {
   relatesCommand: () => relatesCommand
 });
-var suggestCommand2, addCommand8, discoverCommand3, removeCommand5, listCommand17, relatesCommand;
+var suggestCommand2, addCommand8, discoverCommand3, removeCommand5, listCommand18, relatesCommand;
 var init_relates = __esm({
   "packages/cleo/src/cli/commands/relates.ts"() {
     "use strict";
@@ -57647,7 +57549,7 @@ var init_relates = __esm({
         );
       }
     });
-    listCommand17 = defineCommand({
+    listCommand18 = defineCommand({
       meta: { name: "list", description: "Show existing relates entries for a task" },
       args: {
         taskId: {
@@ -57676,7 +57578,7 @@ var init_relates = __esm({
         add: addCommand8,
         remove: removeCommand5,
         discover: discoverCommand3,
-        list: listCommand17
+        list: listCommand18
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -57693,8 +57595,8 @@ __export(release_exports, {
   SHIP_DEPRECATION_NOTICE: () => SHIP_DEPRECATION_NOTICE,
   releaseCommand: () => releaseCommand
 });
-import { pushWarning as pushWarning4, release as release2 } from "@cleocode/core";
-var SHIP_DEPRECATION_NOTICE, shipCommand, listCommand18, showCommand10, cancelCommand2, changelogCommand, rollbackCommand, rollbackFullCommand, prStatusCommand, channelCommand, planCommand3, openCommand2, reconcileCommand4, releaseCommand;
+import { pushWarning as pushWarning3, release as release2 } from "@cleocode/core";
+var SHIP_DEPRECATION_NOTICE, shipCommand, listCommand19, showCommand10, cancelCommand2, rollbackCommand, rollbackFullCommand, prStatusCommand, channelCommand, planCommand3, openCommand2, reconcileCommand4, releaseCommand;
 var init_release3 = __esm({
   "packages/cleo/src/cli/commands/release.ts"() {
     "use strict";
@@ -57724,7 +57626,7 @@ var init_release3 = __esm({
         }
       },
       async run({ args }) {
-        pushWarning4({
+        pushWarning3({
           code: "W_DEPRECATED_COMMAND",
           message: SHIP_DEPRECATION_NOTICE,
           deprecated: "cleo release ship",
@@ -57755,7 +57657,7 @@ var init_release3 = __esm({
         );
       }
     });
-    listCommand18 = defineCommand({
+    listCommand19 = defineCommand({
       meta: { name: "list", description: "List all releases" },
       async run() {
         await dispatchFromCli("query", "pipeline", "release.list", {}, { command: "release" });
@@ -57802,57 +57704,6 @@ var init_release3 = __esm({
         );
       }
     });
-    changelogCommand = defineCommand({
-      meta: {
-        name: "changelog",
-        description: "Generate CHANGELOG from git log since a given tag, with task/epic grouping"
-      },
-      args: {
-        sinceTag: {
-          type: "positional",
-          description: "Git tag or ref to generate changelog from (e.g. v2026.4.75)",
-          required: false
-        },
-        since: {
-          type: "string",
-          description: "Git tag or ref to generate changelog from (e.g. v2026.4.75). Alias for the positional argument.",
-          required: false
-        }
-      },
-      async run({ args }) {
-        pushWarning4({
-          code: "W_DEPRECATED_COMMAND",
-          message: "`cleo release changelog <tag>` is deprecated. Use `cleo release plan <version> --epic <id>` (T9525) plus the T9759 LLM composer.",
-          severity: "warn",
-          deprecated: "cleo release changelog",
-          replacement: "cleo release plan",
-          removeBy: "v2026.6.0",
-          context: {
-            registryId: "cleo-release-changelog-verb-git-log",
-            task: "T9795",
-            saga: "T9787"
-          }
-        });
-        const sinceTag = typeof args["sinceTag"] === "string" && args["sinceTag"].length > 0 ? args["sinceTag"] : typeof args["since"] === "string" && args["since"].length > 0 ? args["since"] : void 0;
-        if (sinceTag === void 0) {
-          cliError(
-            "Missing required argument: <sinceTag> (or --since)",
-            2,
-            { name: "E_MISSING_ARGUMENT", fix: "Run: cleo release changelog <tag>" },
-            { operation: "release.changelog.since" }
-          );
-          process.exit(2);
-          return;
-        }
-        await dispatchFromCli(
-          "query",
-          "pipeline",
-          "release.changelog.since",
-          { sinceTag },
-          { command: "release" }
-        );
-      }
-    });
     rollbackCommand = defineCommand({
       meta: {
         name: "rollback",
@@ -57960,8 +57811,13 @@ var init_release3 = __esm({
         },
         epic: {
           type: "string",
-          description: "Epic task ID whose children are candidates for inclusion",
-          required: true
+          description: "Epic task ID \u2014 children (or leaf Epic itself per ADR-073) are candidates",
+          required: false
+        },
+        saga: {
+          type: "string",
+          description: "Saga task ID \u2014 walks task_relations type=groups to aggregate member Epics (ADR-073). Mutually exclusive with --epic. (T9838)",
+          required: false
         },
         scheme: {
           type: "string",
@@ -57978,6 +57834,10 @@ var init_release3 = __esm({
         "dry-run": {
           type: "boolean",
           description: "Compute plan + envelope without writing the plan file or DB row"
+        },
+        "no-changelog": {
+          type: "boolean",
+          description: "Skip CHANGELOG.md auto-write (default: write/replace the ## [<version>] section). (T9838)"
         }
       },
       async run({ args }) {
@@ -57988,10 +57848,12 @@ var init_release3 = __esm({
           {
             version: args.version,
             epicId: args.epic,
+            sagaId: args.saga,
             scheme: args.scheme,
             channel: args.channel,
             hotfix: args.hotfix === true,
-            dryRun: args["dry-run"] === true
+            dryRun: args["dry-run"] === true,
+            writeChangelog: args["no-changelog"] !== true
           },
           { command: "release" }
         );
@@ -58092,10 +57954,9 @@ var init_release3 = __esm({
         reconcile: reconcileCommand4,
         rollback: rollbackCommand,
         // Read-only helpers — not deprecated.
-        list: listCommand18,
+        list: listCommand19,
         show: showCommand10,
         cancel: cancelCommand2,
-        changelog: changelogCommand,
         "pr-status": prStatusCommand,
         channel: channelCommand,
         "rollback-full": rollbackFullCommand,
@@ -58121,7 +57982,7 @@ __export(remote_exports, {
 });
 import {
   addRemote,
-  CleoError as CleoError7,
+  CleoError as CleoError6,
   getRemoteSyncStatus as getRemoteGitStatus,
   listRemotes,
   pull,
@@ -58159,7 +58020,7 @@ var init_remote = __esm({
             { command: "remote", message: `Remote '${name}' added: ${args.url}` }
           );
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58188,7 +58049,7 @@ var init_remote = __esm({
             { command: "remote", message: `Remote '${args.name}' removed` }
           );
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58213,7 +58074,7 @@ var init_remote = __esm({
             }
           );
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58253,7 +58114,7 @@ var init_remote = __esm({
           }
           cliOutput({ ...status }, { command: "remote", message });
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58317,7 +58178,7 @@ var init_remote = __esm({
             { command: "push", message: result.message }
           );
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58360,7 +58221,7 @@ var init_remote = __esm({
             { command: "pull", message: result.message }
           );
         } catch (err) {
-          if (err instanceof CleoError7) {
+          if (err instanceof CleoError6) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -58485,7 +58346,7 @@ var req_exports = {};
 __export(req_exports, {
   reqCommand: () => reqCommand
 });
-var addCommand9, listCommand19, migrateCommand, reqCommand;
+var addCommand9, listCommand20, migrateCommand, reqCommand;
 var init_req = __esm({
   "packages/cleo/src/cli/commands/req.ts"() {
     "use strict";
@@ -58527,7 +58388,7 @@ var init_req = __esm({
         await dispatchFromCli("mutate", "tasks", "req.add", { taskId, gate }, { command: "req add" });
       }
     });
-    listCommand19 = defineCommand({
+    listCommand20 = defineCommand({
       meta: { name: "list", description: "List all REQ-ID-addressed acceptance gates on a task" },
       args: {
         "task-id": {
@@ -58570,10 +58431,13 @@ var init_req = __esm({
       }
     });
     reqCommand = defineCommand({
-      meta: { name: "req", description: "Manage REQ-ID-addressable acceptance gates on tasks" },
+      meta: {
+        name: "req",
+        description: "Manage REQ-ID-addressable acceptance gates on tasks (in-task gates only). For cross-task dependency edges, use `cleo update <id> --add-depends <ids>` or `cleo update <id> --add-relates <id>:blocks` (gh-394)."
+      },
       subCommands: {
         add: addCommand9,
-        list: listCommand19,
+        list: listCommand20,
         migrate: migrateCommand
       },
       async run({ cmd, rawArgs }) {
@@ -58593,7 +58457,7 @@ __export(research_exports, {
 function generateResearchId() {
   return `res_${Date.now()}`;
 }
-var addCommand10, showCommand11, listCommand20, pendingCommand2, linkCommand2, updateCommand, statsCommand5, linksCommand, archiveCommand3, manifestCommand2, researchCommand;
+var addCommand10, showCommand11, listCommand21, pendingCommand2, linkCommand2, updateCommand, statsCommand5, linksCommand, archiveCommand3, manifestCommand2, researchCommand;
 var init_research2 = __esm({
   "packages/cleo/src/cli/commands/research.ts"() {
     "use strict";
@@ -58675,7 +58539,7 @@ var init_research2 = __esm({
         );
       }
     });
-    listCommand20 = defineCommand({
+    listCommand21 = defineCommand({
       meta: { name: "list", description: "List research entries" },
       args: {
         task: {
@@ -58911,7 +58775,7 @@ var init_research2 = __esm({
       subCommands: {
         add: addCommand10,
         show: showCommand11,
-        list: listCommand20,
+        list: listCommand21,
         pending: pendingCommand2,
         link: linkCommand2,
         update: updateCommand,
@@ -58937,7 +58801,7 @@ __export(restore_exports, {
 });
 import fs3 from "node:fs";
 import path5 from "node:path";
-import { CleoError as CleoError8, getProjectRoot as getProjectRoot39, getTaskAccessor as getTaskAccessor3 } from "@cleocode/core";
+import { CleoError as CleoError7, getProjectRoot as getProjectRoot38, getTaskAccessor as getTaskAccessor3 } from "@cleocode/core";
 function parseMarkdownValue(raw) {
   const trimmed = raw.trim();
   if (trimmed === "_(not present)_" || trimmed === "") return void 0;
@@ -59057,7 +58921,7 @@ var init_restore = __esm({
         description: "Apply manually-resolved conflicts from .cleo/restore-conflicts.md"
       },
       async run() {
-        const projectRoot = getProjectRoot39();
+        const projectRoot = getProjectRoot38();
         const reportPath = path5.join(projectRoot, CLEO_DIR_NAME, RESTORE_CONFLICTS_MD);
         if (!fs3.existsSync(reportPath)) {
           humanLine("No pending restore conflicts. Nothing to finalize.");
@@ -59160,7 +59024,7 @@ var init_restore = __esm({
           });
           if (!response.success) {
             const code = ExitCode[response.error?.code] ?? 1 /* GENERAL_ERROR */;
-            throw new CleoError8(code, response.error?.message ?? "Backup restore failed");
+            throw new CleoError7(code, response.error?.message ?? "Backup restore failed");
           }
           const data = response.data;
           if (args["dry-run"]) {
@@ -59189,7 +59053,7 @@ var init_restore = __esm({
             { command: "restore", operation: "admin.backup.restore" }
           );
         } catch (err) {
-          if (err instanceof CleoError8) {
+          if (err instanceof CleoError7) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -59233,7 +59097,7 @@ var init_restore = __esm({
           const taskId = args.taskId;
           const idPattern = /^T\d{3,}$/;
           if (!idPattern.test(taskId)) {
-            throw new CleoError8(2 /* INVALID_INPUT */, `Invalid task ID: ${taskId}`);
+            throw new CleoError7(2 /* INVALID_INPUT */, `Invalid task ID: ${taskId}`);
           }
           const accessor = await getTaskAccessor3();
           const activeTask = await accessor.loadSingleTask(taskId);
@@ -59260,7 +59124,7 @@ var init_restore = __esm({
               const response = await dispatchRaw("mutate", "tasks", "restore", { taskId });
               if (!response.success) {
                 const code = ExitCode[response.error?.code] ?? 1 /* GENERAL_ERROR */;
-                throw new CleoError8(code, response.error?.message ?? "Task restore failed");
+                throw new CleoError7(code, response.error?.message ?? "Task restore failed");
               }
               const resultData = response.data;
               cliOutput(
@@ -59302,7 +59166,7 @@ var init_restore = __esm({
               });
               if (!response.success) {
                 const code = ExitCode[response.error?.code] ?? 1 /* GENERAL_ERROR */;
-                throw new CleoError8(code, response.error?.message ?? "Task restore failed");
+                throw new CleoError7(code, response.error?.message ?? "Task restore failed");
               }
               const resultData = response.data;
               cliOutput(
@@ -59317,7 +59181,7 @@ var init_restore = __esm({
               );
               return;
             } else {
-              throw new CleoError8(
+              throw new CleoError7(
                 6 /* VALIDATION_ERROR */,
                 `Task ${taskId} is already active with status: ${activeTask.status}`
               );
@@ -59349,7 +59213,7 @@ var init_restore = __esm({
                 }
               }
             }
-            throw new CleoError8(
+            throw new CleoError7(
               4 /* NOT_FOUND */,
               `Task ${taskId} not found in active tasks or archive`,
               {
@@ -59367,7 +59231,7 @@ var init_restore = __esm({
             });
             if (!response.success) {
               const code = ExitCode[response.error?.code] ?? 1 /* GENERAL_ERROR */;
-              throw new CleoError8(code, response.error?.message ?? "Task unarchive failed");
+              throw new CleoError7(code, response.error?.message ?? "Task unarchive failed");
             }
             const resultData = response.data;
             cliOutput(
@@ -59381,7 +59245,7 @@ var init_restore = __esm({
               { command: "restore", operation: "tasks.restore" }
             );
           } catch {
-            throw new CleoError8(
+            throw new CleoError7(
               4 /* NOT_FOUND */,
               `Task ${taskId} not found in active tasks or archive`,
               {
@@ -59390,7 +59254,7 @@ var init_restore = __esm({
             );
           }
         } catch (err) {
-          if (err instanceof CleoError8) {
+          if (err instanceof CleoError7) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -59754,7 +59618,8 @@ var saga_exports = {};
 __export(saga_exports, {
   sagaCommand: () => sagaCommand
 });
-var createCommand3, addCommand11, listCommand21, membersCommand, rollupCommand2, sagaCommand;
+import { parseAcceptanceCriteria } from "@cleocode/core";
+var createCommand3, addCommand11, listCommand22, membersCommand, rollupCommand2, sagaCommand;
 var init_saga = __esm({
   "packages/cleo/src/cli/commands/saga.ts"() {
     "use strict";
@@ -59791,7 +59656,9 @@ var init_saga = __esm({
           {
             title: args.title,
             description: args.description,
-            acceptance: args.acceptance ? args.acceptance.split("|") : void 0
+            // T9839/gh-409: route through bracket+quote-aware parser so criteria
+            // containing `ENUM (a|b|c)` or quoted unions aren't shredded.
+            acceptance: args.acceptance ? parseAcceptanceCriteria(args.acceptance) : void 0
           },
           { command: "saga", operation: "tasks.saga.create" }
         );
@@ -59824,7 +59691,7 @@ var init_saga = __esm({
         );
       }
     });
-    listCommand21 = defineCommand({
+    listCommand22 = defineCommand({
       meta: {
         name: "list",
         description: "List all Sagas (labeled top-level Epics)"
@@ -59883,7 +59750,7 @@ var init_saga = __esm({
       subCommands: {
         create: createCommand3,
         add: addCommand11,
-        list: listCommand21,
+        list: listCommand22,
         members: membersCommand,
         rollup: rollupCommand2
       },
@@ -60000,7 +59867,7 @@ import * as readline2 from "node:readline";
 import { promisify } from "node:util";
 import {
   BUILD_CONFIG as BUILD_CONFIG2,
-  CleoError as CleoError9,
+  CleoError as CleoError8,
   checkAllRegisteredProjects as checkAllRegisteredProjects2,
   checkStorageMigration,
   getCleoHome as getCleoHome4,
@@ -60335,7 +60202,7 @@ var init_self_update = __esm({
           const currentVersion = isDev ? await getCurrentVersion() : await getNpmInstalledVersion() ?? await getCurrentVersion();
           const rawChannel = args.channel?.toLowerCase();
           if (rawChannel && rawChannel !== "stable" && rawChannel !== "beta") {
-            throw new CleoError9(
+            throw new CleoError8(
               6 /* VALIDATION_ERROR */,
               `Invalid --channel '${rawChannel}'. Expected stable|beta`
             );
@@ -60377,7 +60244,7 @@ var init_self_update = __esm({
             progress.step(2, "Querying npm registry");
             const latest2 = await getDistTagVersion(requestedChannel === "beta" ? "beta" : "latest");
             if (!latest2) {
-              throw new CleoError9(
+              throw new CleoError8(
                 5 /* DEPENDENCY_ERROR */,
                 "Failed to check latest version from GitHub"
               );
@@ -60407,7 +60274,7 @@ var init_self_update = __esm({
           progress.step(2, "Querying npm registry");
           const latest = args.version ?? await getDistTagVersion(requestedChannel === "beta" ? "beta" : "latest");
           if (!latest) {
-            throw new CleoError9(
+            throw new CleoError8(
               5 /* DEPENDENCY_ERROR */,
               "Failed to check latest version from GitHub"
             );
@@ -60452,7 +60319,7 @@ var init_self_update = __esm({
           });
           progress.complete(`Updated to ${latest}`);
         } catch (err) {
-          if (err instanceof CleoError9) {
+          if (err instanceof CleoError8) {
             progress.error(err.message);
             cliError(
               err.message,
@@ -61460,7 +61327,7 @@ var sequence_exports = {};
 __export(sequence_exports, {
   sequenceCommand: () => sequenceCommand
 });
-import { getProjectRoot as getProjectRoot40 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot39 } from "@cleocode/core/internal";
 var showCommand12, checkCommand6, repairCommand, sequenceCommand;
 var init_sequence = __esm({
   "packages/cleo/src/cli/commands/sequence.ts"() {
@@ -61496,7 +61363,7 @@ var init_sequence = __esm({
       meta: { name: "repair", description: "Reset counter to max + 1 if behind" },
       async run() {
         const { repairSequence } = await import("@cleocode/core/internal");
-        const projectRoot = getProjectRoot40();
+        const projectRoot = getProjectRoot39();
         const repair = await repairSequence(projectRoot);
         const result = {
           repaired: repair.repaired,
@@ -61585,7 +61452,7 @@ async function promptOwnerAuthPassword(sessionName) {
   const token = deriveOwnerAuthToken(sessionName, password);
   return token;
 }
-var startCommand7, endCommand, handoffCommand2, statusCommand14, resumeCommand2, findCommand6, listCommand22, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, lintCommand, sessionCommand;
+var startCommand7, endCommand, handoffCommand2, statusCommand14, resumeCommand2, findCommand6, listCommand23, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, lintCommand, sessionCommand;
 var init_session4 = __esm({
   "packages/cleo/src/cli/commands/session.ts"() {
     "use strict";
@@ -61851,7 +61718,7 @@ var init_session4 = __esm({
         );
       }
     });
-    listCommand22 = defineCommand({
+    listCommand23 = defineCommand({
       meta: { name: "list", description: "List sessions" },
       args: {
         status: {
@@ -61939,8 +61806,8 @@ var init_session4 = __esm({
         "audit-scope": { type: "string", description: "Audit log scope (global|local)" }
       },
       async run({ args }) {
-        const { detectSessionDrift, getProjectRoot: getProjectRoot44 } = await import("@cleocode/core");
-        const projectRoot = await getProjectRoot44();
+        const { detectSessionDrift, getProjectRoot: getProjectRoot43 } = await import("@cleocode/core");
+        const projectRoot = await getProjectRoot43();
         const scope = args["audit-scope"] === "local" ? "local" : "global";
         const report = await detectSessionDrift({ projectRoot, auditScope: scope });
         cliOutput(report, { command: "session drift", operation: "session.drift" });
@@ -62138,7 +62005,7 @@ var init_session4 = __esm({
         status: statusCommand14,
         resume: resumeCommand2,
         find: findCommand6,
-        list: listCommand22,
+        list: listCommand23,
         gc: gcCommand2,
         show: showCommand13,
         "context-drift": contextDriftCommand,
@@ -62862,7 +62729,7 @@ function buildSkillsDoctorAdoptAdapters() {
     }
   };
 }
-var listCommand23, searchCommand4, findCommand7, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, doctorBridgeCommand, doctorAdoptOrphansCommand, statsCommand6, importHermesCommand, migrateCommand2, pruneTelemetryCommand, spawnProvidersCommand, doctorDiagnoseCommand, doctorCommand4, proposePatchCommand, skillsCommand2;
+var listCommand24, searchCommand4, findCommand7, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, doctorBridgeCommand, doctorAdoptOrphansCommand, statsCommand6, importHermesCommand, migrateCommand2, pruneTelemetryCommand, spawnProvidersCommand, doctorDiagnoseCommand, doctorCommand4, proposePatchCommand, skillsCommand2;
 var init_skills2 = __esm({
   "packages/cleo/src/cli/commands/skills.ts"() {
     "use strict";
@@ -62870,7 +62737,7 @@ var init_skills2 = __esm({
     init_cli();
     init_subcommand_guard();
     init_renderers();
-    listCommand23 = defineCommand({
+    listCommand24 = defineCommand({
       meta: { name: "list", description: "List installed skills" },
       args: {
         global: {
@@ -63603,7 +63470,7 @@ var init_skills2 = __esm({
     skillsCommand2 = defineCommand({
       meta: { name: "skills", description: "Skill management: list, search, validate, info, install" },
       subCommands: {
-        list: listCommand23,
+        list: listCommand24,
         search: searchCommand4,
         find: findCommand7,
         validate: validateCommand8,
@@ -63981,8 +63848,8 @@ var sticky_exports = {};
 __export(sticky_exports, {
   stickyCommand: () => stickyCommand
 });
-import { CleoError as CleoError10 } from "@cleocode/core";
-var addCommand12, listCommand24, showCommand15, convertCommand, archiveCommand4, purgeCommand2, stickyCommand;
+import { CleoError as CleoError9 } from "@cleocode/core";
+var addCommand12, listCommand25, showCommand15, convertCommand, archiveCommand4, purgeCommand2, stickyCommand;
 var init_sticky3 = __esm({
   "packages/cleo/src/cli/commands/sticky.ts"() {
     "use strict";
@@ -64030,7 +63897,7 @@ var init_sticky3 = __esm({
             { command: "sticky", operation: "sticky.add" }
           );
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64038,7 +63905,7 @@ var init_sticky3 = __esm({
         }
       }
     });
-    listCommand24 = defineCommand({
+    listCommand25 = defineCommand({
       meta: { name: "list", description: "List active sticky notes" },
       args: {
         tag: {
@@ -64085,7 +63952,7 @@ var init_sticky3 = __esm({
           }
           cliOutput(data, { command: "sticky list", operation: "sticky.list", page: response.page });
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64126,7 +63993,7 @@ var init_sticky3 = __esm({
           }
           cliOutput({ sticky: data }, { command: "sticky show", operation: "sticky.show" });
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64204,7 +64071,7 @@ var init_sticky3 = __esm({
             operation: "sticky.convert"
           });
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64231,7 +64098,7 @@ var init_sticky3 = __esm({
             { command: "sticky archive", operation: "sticky.archive" }
           );
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64258,7 +64125,7 @@ var init_sticky3 = __esm({
             { command: "sticky purge", operation: "sticky.purge" }
           );
         } catch (err) {
-          if (err instanceof CleoError10) {
+          if (err instanceof CleoError9) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -64274,8 +64141,8 @@ var init_sticky3 = __esm({
       subCommands: {
         add: addCommand12,
         jot: addCommand12,
-        list: listCommand24,
-        ls: listCommand24,
+        list: listCommand25,
+        ls: listCommand25,
         show: showCommand15,
         convert: convertCommand,
         archive: archiveCommand4,
@@ -64403,10 +64270,10 @@ var init_sync = __esm({
         }
       },
       async run({ args }) {
-        const { readFileSync: readFileSync20 } = await import("node:fs");
+        const { readFileSync: readFileSync19 } = await import("node:fs");
         let externalTasks;
         try {
-          externalTasks = JSON.parse(readFileSync20(args.file, "utf8"));
+          externalTasks = JSON.parse(readFileSync19(args.file, "utf8"));
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
           cliError(`Failed to read or parse external tasks file: ${message}`, 2, {
@@ -64792,15 +64659,15 @@ var token_exports = {};
 __export(token_exports, {
   tokenCommand: () => tokenCommand
 });
-import { readFileSync as readFileSync18 } from "node:fs";
-import { getProjectRoot as getProjectRoot41, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
+import { readFileSync as readFileSync17 } from "node:fs";
+import { getProjectRoot as getProjectRoot40, measureTokenExchange, recordTokenExchange as recordTokenExchange2 } from "@cleocode/core/internal";
 function readPayload(args, textKey, fileKey) {
   const text = args[textKey];
   const file = args[fileKey];
-  if (file) return readFileSync18(file, "utf-8");
+  if (file) return readFileSync17(file, "utf-8");
   return text;
 }
-var filterArgs, summaryCommand3, listCommand25, showCommand16, deleteCommand3, clearCommand2, estimateCommand, tokenCommand;
+var filterArgs, summaryCommand3, listCommand26, showCommand16, deleteCommand3, clearCommand2, estimateCommand, tokenCommand;
 var init_token = __esm({
   "packages/cleo/src/cli/commands/token.ts"() {
     "use strict";
@@ -64836,7 +64703,7 @@ var init_token = __esm({
         );
       }
     });
-    listCommand25 = defineCommand({
+    listCommand26 = defineCommand({
       meta: { name: "list", description: "List recorded token telemetry" },
       args: {
         ...filterArgs,
@@ -64957,7 +64824,7 @@ var init_token = __esm({
           domain: args.domain,
           operation: args.operation
         };
-        const result = args.record ? await recordTokenExchange2(getProjectRoot41(), input2) : await measureTokenExchange(input2);
+        const result = args.record ? await recordTokenExchange2(getProjectRoot40(), input2) : await measureTokenExchange(input2);
         cliOutput(result, {
           command: "token",
           operation: args.record ? "admin.token.record" : "token.estimate"
@@ -64971,7 +64838,7 @@ var init_token = __esm({
       },
       subCommands: {
         summary: summaryCommand3,
-        list: listCommand25,
+        list: listCommand26,
         show: showCommand16,
         delete: deleteCommand3,
         clear: clearCommand2,
@@ -64993,7 +64860,7 @@ __export(transcript_exports, {
 });
 import { homedir as homedir7 } from "node:os";
 import { join as join31 } from "node:path";
-import { getProjectRoot as getProjectRoot42 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot41 } from "@cleocode/core";
 import {
   parseDurationMs,
   pruneTranscripts,
@@ -65023,7 +64890,7 @@ var init_transcript = __esm({
       async run({ args }) {
         if (args.pending) {
           try {
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const { scanPendingTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
             const pending = await scanPendingTranscripts(projectRoot);
             cliOutput(
@@ -65120,7 +64987,7 @@ var init_transcript = __esm({
       async run({ args }) {
         const tier = args.tier ?? "warm";
         const dryRun = args["dry-run"] ?? false;
-        const projectRoot = getProjectRoot42();
+        const projectRoot = getProjectRoot41();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { findSessionTranscriptPath, listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -65232,7 +65099,7 @@ var init_transcript = __esm({
         const dryRun = args["dry-run"] ?? false;
         const olderThanHours = args["older-than-hours"] ? Number.parseInt(args["older-than-hours"], 10) : 24;
         const limit = args.limit ? Number.parseInt(args.limit, 10) : void 0;
-        const projectRoot = getProjectRoot42();
+        const projectRoot = getProjectRoot41();
         try {
           const { extractTranscript } = await import("@cleocode/core/memory/transcript-extractor.js");
           const { listAllTranscripts } = await import("@cleocode/core/memory/transcript-scanner.js");
@@ -65411,7 +65278,7 @@ var update_exports = {};
 __export(update_exports, {
   updateCommand: () => updateCommand2
 });
-import { appendSignedSeverityAttestation as appendSignedSeverityAttestation2 } from "@cleocode/core";
+import { appendSignedSeverityAttestation as appendSignedSeverityAttestation2, parseAcceptanceCriteria as parseAcceptanceCriteria2 } from "@cleocode/core";
 var updateCommand2;
 var init_update = __esm({
   "packages/cleo/src/cli/commands/update.ts"() {
@@ -65420,7 +65287,10 @@ var init_update = __esm({
     init_cli();
     init_renderers();
     updateCommand2 = defineCommand({
-      meta: { name: "update", description: "Update a task" },
+      meta: {
+        name: "update",
+        description: "Update a task. Safe under concurrent invocation \u2014 retries on SQLITE_BUSY up to 4 attempts (gh#391)."
+      },
       args: {
         taskId: {
           type: "positional",
@@ -65462,12 +65332,12 @@ var init_update = __esm({
         },
         labels: {
           type: "string",
-          description: "Set labels (comma-separated)",
+          description: 'Set labels (comma-separated; lowercase alphanumeric + hyphens + periods only, e.g. "track-b,wave.1") (gh-392)',
           alias: "l"
         },
         "add-labels": {
           type: "string",
-          description: "Add labels (comma-separated)"
+          description: 'Add labels (comma-separated; lowercase alphanumeric + hyphens + periods only, e.g. "track-b,wave.1") (gh-392)'
         },
         "remove-labels": {
           type: "string",
@@ -65589,20 +65459,30 @@ var init_update = __esm({
          */
         "depends-waiver": {
           type: "string",
-          description: "Justification for promoting a task to critical priority without --depends (T1856). Records waiver in task metadata."
+          description: 'Justification (string) to waive the "--depends required for critical priority" check. Only consulted when the task is being promoted to --priority critical AND no existing or new --depends are declared. Stored verbatim in task metadata as audit trail; ignored for non-critical updates. (gh-405 / T1856)'
         },
         /**
          * Related tasks — semantic relationships (non-dependency).
-         * Comma-separated task IDs with optional type suffix (e.g. "T001:blocks,T002").
-         * Default type is 'related'. Replaces existing relates list.
+         *
+         * Direction convention (gh-403):
+         *   `cleo update <fromId> --add-relates <toId>:<type>`
+         * creates a directed edge FROM `<fromId>` TO `<toId>` with the given type.
+         * Example: `cleo update T127 --add-relates T123:blocks` means
+         * "T127 blocks T123" (the task being updated is the source).
+         *
+         * For dependency edges (T127 must complete before T128 can start), prefer
+         * `--add-depends T128` on T127 — `depends` is the canonical dep primitive
+         * and is what `cleo orchestrate ready`/`waves` walks. `--add-relates` is for
+         * semantic relationships (blocks/supersedes/groups/related) that don't
+         * affect wave-order scheduling.
          */
         relates: {
           type: "string",
-          description: 'Set related tasks (comma-separated, optional type suffix: "T001:blocks,T002")'
+          description: 'Set related tasks (comma-separated, optional type suffix: "T001:blocks,T002"). Direction: <current task> \u2192 <relate>. For dep edges, prefer --add-depends. (gh-403)'
         },
         "add-relates": {
           type: "string",
-          description: "Add related tasks without overwriting existing (comma-separated, optional type suffix)"
+          description: 'Add related tasks without overwriting (comma-separated, optional type suffix: "T001:blocks"). Direction: <current task> \u2192 <relate>. For dep edges, prefer --add-depends. (gh-403)'
         },
         "remove-relates": {
           type: "string",
@@ -65649,8 +65529,7 @@ var init_update = __esm({
         }
         if (args.notes !== void 0) params["notes"] = args.notes;
         if (args.note !== void 0) params["notes"] = params["notes"] ?? args.note;
-        if (args.acceptance)
-          params["acceptance"] = args.acceptance.split("|").map((s) => s.trim()).filter(Boolean);
+        if (args.acceptance) params["acceptance"] = parseAcceptanceCriteria2(args.acceptance);
         if (args.files) params["files"] = args.files.split(",").map((s) => s.trim());
         if (args["add-files"])
           params["addFiles"] = args["add-files"].split(",").map((s) => s.trim());
@@ -65717,7 +65596,7 @@ __export(upgrade_exports, {
   upgradeCommand: () => upgradeCommand
 });
 import { resolve as resolve8 } from "node:path";
-import { CleoError as CleoError11, diagnoseUpgrade, runUpgrade as runUpgrade2, upgradeWorkflows as upgradeWorkflows2 } from "@cleocode/core/internal";
+import { CleoError as CleoError10, diagnoseUpgrade, runUpgrade as runUpgrade2, upgradeWorkflows as upgradeWorkflows2 } from "@cleocode/core/internal";
 var workflowsSubcommand, upgradeCommand;
 var init_upgrade2 = __esm({
   "packages/cleo/src/cli/commands/upgrade.ts"() {
@@ -65784,7 +65663,7 @@ var init_upgrade2 = __esm({
             process.exit(1);
           }
         } catch (err) {
-          if (err instanceof CleoError11) {
+          if (err instanceof CleoError10) {
             cliError(err.message, err.code, { name: "CleoError", fix: err.fix });
             process.exit(err.code);
           }
@@ -65910,7 +65789,7 @@ var init_upgrade2 = __esm({
           }
           progress.complete(isDryRun ? "Preview complete" : "Upgrade complete");
         } catch (err) {
-          if (err instanceof CleoError11) {
+          if (err instanceof CleoError10) {
             progress.error(err.message);
             cliError(
               err.message,
@@ -66015,10 +65894,10 @@ var web_exports = {};
 __export(web_exports, {
   webCommand: () => webCommand
 });
-import { execFileSync as execFileSync4, spawn as spawn3 } from "node:child_process";
+import { execFileSync as execFileSync3, spawn as spawn3 } from "node:child_process";
 import { mkdir as mkdir4, open, readFile as readFile6, rm, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join32 } from "node:path";
-import { CleoError as CleoError12, formatError as formatError7, getCleoHome as getCleoHome5 } from "@cleocode/core";
+import { CleoError as CleoError11, formatError as formatError7, getCleoHome as getCleoHome5 } from "@cleocode/core";
 function getWebPaths() {
   const cleoHome = getCleoHome5();
   return {
@@ -66061,7 +65940,7 @@ async function startWebServer(port, host) {
   const { pidFile, configFile, logFile, logDir } = getWebPaths();
   const status = await getStatus();
   if (status.running) {
-    throw new CleoError12(1 /* GENERAL_ERROR */, `Server already running (PID: ${status.pid})`);
+    throw new CleoError11(1 /* GENERAL_ERROR */, `Server already running (PID: ${status.pid})`);
   }
   const projectRoot = process.env["CLEO_ROOT"] ?? process.cwd();
   const studioDir = process.env["CLEO_STUDIO_DIR"] ?? join32(projectRoot, "packages", "studio", "build");
@@ -66079,12 +65958,12 @@ async function startWebServer(port, host) {
     await stat2(webIndexPath);
   } catch {
     try {
-      execFileSync4("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
+      execFileSync3("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
         cwd: projectRoot,
         stdio: "ignore"
       });
     } catch {
-      throw new CleoError12(
+      throw new CleoError11(
         1 /* GENERAL_ERROR */,
         `Studio build failed. Run: pnpm --filter @cleocode/studio run build
 Logs: ${logFile}`
@@ -66130,7 +66009,7 @@ Logs: ${logFile}`
     } catch {
     }
     await rm(pidFile, { force: true });
-    throw new CleoError12(1 /* GENERAL_ERROR */, "Server failed to start within 15 seconds");
+    throw new CleoError11(1 /* GENERAL_ERROR */, "Server failed to start within 15 seconds");
   }
   cliOutput(
     {
@@ -66170,7 +66049,7 @@ var init_web = __esm({
         try {
           await startWebServer(Number.parseInt(args.port, 10), args.host);
         } catch (err) {
-          if (err instanceof CleoError12) {
+          if (err instanceof CleoError11) {
             console.error(formatError7(err));
             process.exit(err.code);
           }
@@ -66214,7 +66093,7 @@ var init_web = __esm({
           await rm(pidFile, { force: true });
           cliOutput({ stopped: true }, { command: "web", message: "CLEO Web UI stopped" });
         } catch (err) {
-          if (err instanceof CleoError12) {
+          if (err instanceof CleoError11) {
             console.error(formatError7(err));
             process.exit(err.code);
           }
@@ -66267,7 +66146,7 @@ var init_web = __esm({
           }
           await startWebServer(Number.parseInt(args.port, 10), args.host);
         } catch (err) {
-          if (err instanceof CleoError12) {
+          if (err instanceof CleoError11) {
             console.error(formatError7(err));
             process.exit(err.code);
           }
@@ -66282,7 +66161,7 @@ var init_web = __esm({
           const status = await getStatus();
           cliOutput(status, { command: "web" });
         } catch (err) {
-          if (err instanceof CleoError12) {
+          if (err instanceof CleoError11) {
             console.error(formatError7(err));
             process.exit(err.code);
           }
@@ -66296,7 +66175,7 @@ var init_web = __esm({
         try {
           const status = await getStatus();
           if (!status.running || !status.url) {
-            throw new CleoError12(
+            throw new CleoError11(
               1 /* GENERAL_ERROR */,
               "Web server is not running. Start with: cleo web start"
             );
@@ -66315,7 +66194,7 @@ var init_web = __esm({
           }
           cliOutput({ url }, { command: "web", message: `Open browser to: ${url}` });
         } catch (err) {
-          if (err instanceof CleoError12) {
+          if (err instanceof CleoError11) {
             console.error(formatError7(err));
             process.exit(err.code);
           }
@@ -66347,7 +66226,7 @@ __export(worktree_exports, {
   worktreeCommand: () => worktreeCommand
 });
 import readline4 from "node:readline";
-import { getProjectRoot as getProjectRoot43, listWorktrees as listWorktrees2 } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot42, listWorktrees as listWorktrees2 } from "@cleocode/core/internal";
 async function promptYesNo2(question) {
   return new Promise((resolve9) => {
     const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
@@ -66368,7 +66247,7 @@ function renderOrphanPreamble(wt) {
     ""
   ].join("\n");
 }
-var VALID_STATUS_VALUES, listCommand26, pruneCommand3, forceUnlockCommand, worktreeCommand;
+var VALID_STATUS_VALUES, listCommand27, pruneCommand3, forceUnlockCommand, worktreeCommand;
 var init_worktree3 = __esm({
   "packages/cleo/src/cli/commands/worktree.ts"() {
     "use strict";
@@ -66376,7 +66255,7 @@ var init_worktree3 = __esm({
     init_cli();
     init_renderers();
     VALID_STATUS_VALUES = ["active", "stale", "merged", "orphan", "locked"];
-    listCommand26 = defineCommand({
+    listCommand27 = defineCommand({
       meta: {
         name: "list",
         description: "List worktrees attached to this project with status classification (active|stale|merged|orphan|locked)."
@@ -66446,7 +66325,7 @@ var init_worktree3 = __esm({
         const yes = args["yes"] === true;
         const staleDaysRaw = typeof args["days"] === "string" ? args["days"] : void 0;
         const staleDays = staleDaysRaw !== void 0 ? Number.parseInt(staleDaysRaw, 10) : void 0;
-        const projectRoot = getProjectRoot43();
+        const projectRoot = getProjectRoot42();
         const listResult = await listWorktrees2({
           projectRoot,
           ...staleDays !== void 0 && !Number.isNaN(staleDays) ? { staleDays } : {}
@@ -66559,7 +66438,7 @@ var init_worktree3 = __esm({
         description: "Inspect and manage CLEO-attached git worktrees. See `cleo worktree <subcommand> --help` for details."
       },
       subCommands: {
-        list: listCommand26,
+        list: listCommand27,
         prune: pruneCommand3,
         "force-unlock": forceUnlockCommand
       },
@@ -66580,8 +66459,8 @@ var init_worktree3 = __esm({
 init_dist();
 init_field_context();
 init_format_context();
-import { readFileSync as readFileSync19 } from "node:fs";
-import { dirname as dirname12, join as join34 } from "node:path";
+import { readFileSync as readFileSync18 } from "node:fs";
+import { dirname as dirname11, join as join34 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 
 // packages/cleo/src/cli/generated/command-manifest.ts
@@ -66595,13 +66474,13 @@ var COMMAND_MANIFEST = [
   {
     exportName: "addBatchCommand",
     name: "add-batch",
-    description: "Create multiple tasks atomically from a JSON file",
+    description: "Create multiple tasks in a single atomic transaction from a JSON file",
     load: async () => (await Promise.resolve().then(() => (init_add_batch(), add_batch_exports))).addBatchCommand
   },
   {
     exportName: "addCommand",
     name: "add",
-    description: "Create a new task (requires active session)",
+    description: "Create a new task (requires active session)\nFor 2+ tasks at once: cleo add-batch --file tasks.json (single transaction, atomic rollback)",
     load: async () => (await Promise.resolve().then(() => (init_add(), add_exports))).addCommand
   },
   {
@@ -66721,7 +66600,7 @@ var COMMAND_MANIFEST = [
   {
     exportName: "changesetCommand",
     name: "changeset",
-    description: "Author task-anchored changeset entries that dual-write to ",
+    description: "Author + list task-anchored changeset entries \u2014 dual-writes go to ",
     load: async () => (await Promise.resolve().then(() => (init_changeset(), changeset_exports))).changesetCommand
   },
   {
@@ -66940,12 +66819,6 @@ var COMMAND_MANIFEST = [
     description: "Transcript garbage collection: manual trigger and status",
     load: async () => (await Promise.resolve().then(() => (init_gc(), gc_exports))).gcCommand
   },
-  {
-    exportName: "generateChangelogCommand",
-    name: "generate-changelog",
-    description: "Generate platform-specific changelog from CHANGELOG.md",
-    load: async () => (await Promise.resolve().then(() => (init_generate_changelog(), generate_changelog_exports))).generateChangelogCommand
-  },
   {
     exportName: "gradeCommand",
     name: "grade",
@@ -67412,6 +67285,7 @@ var COMMAND_MANIFEST = [
 
 // packages/cleo/src/cli/help-renderer.ts
 init_dist();
+import { buildCommandGroups } from "@cleocode/core/internal";
 var noColor2 = (() => {
   const env = globalThis.process?.env ?? {};
   return env.NO_COLOR === "1" || env.TERM === "dumb" || env.TEST || env.CI;
@@ -67424,116 +67298,6 @@ var underline2 = ansi2(4, 24);
 var IMPLICIT_ALIASES = {
   tags: "labels"
 };
-var COMMAND_GROUPS = [
-  {
-    name: "Task Management",
-    commands: [
-      "add",
-      "show",
-      "find",
-      "list",
-      "update",
-      "complete",
-      "delete",
-      "start",
-      "stop",
-      "current",
-      "next",
-      "exists"
-    ]
-  },
-  {
-    name: "Task Organization",
-    commands: [
-      "archive",
-      "labels",
-      "promote",
-      "relates",
-      "reorder",
-      "reparent",
-      "deps",
-      "tree",
-      "blockers"
-    ]
-  },
-  {
-    name: "Sessions & Planning",
-    commands: ["session", "briefing", "dash", "plan", "safestop", "context"]
-  },
-  {
-    name: "Phases & Lifecycle",
-    commands: ["phase", "lifecycle", "release", "roadmap"]
-  },
-  {
-    name: "Memory & Notes",
-    commands: ["memory", "brain", "refresh-memory", "sticky", "reason"]
-  },
-  {
-    name: "Analysis & Stats",
-    commands: ["analyze", "stats", "history", "archive-stats"]
-  },
-  {
-    name: "Validation & Compliance",
-    commands: [
-      "check",
-      "verify",
-      "testing",
-      "compliance",
-      "consensus",
-      "contribution",
-      "decomposition",
-      "backfill"
-    ]
-  },
-  {
-    name: "Code & Documentation",
-    commands: ["code", "docs", "detect-drift", "map"]
-  },
-  {
-    name: "Research & Orchestration",
-    commands: ["research", "orchestrate", "conduit"]
-  },
-  {
-    name: "Import / Export",
-    commands: ["export", "import", "export-tasks", "import-tasks", "snapshot", "inject"]
-  },
-  {
-    name: "Collaboration",
-    commands: ["nexus", "remote", "push", "pull", "checkpoint"]
-  },
-  {
-    name: "Agents",
-    commands: ["agent", "grade"]
-  },
-  {
-    name: "System & Admin",
-    commands: [
-      "version",
-      "init",
-      "config",
-      "admin",
-      "doctor",
-      "upgrade",
-      "self-update",
-      "ops",
-      "schema",
-      "log",
-      "sequence",
-      "adr",
-      "cant",
-      "token",
-      "otel",
-      "migrate",
-      "detect",
-      "generate-changelog",
-      "issue",
-      "skills",
-      "web",
-      "backup",
-      "restore"
-    ]
-  }
-];
 function resolveMeta(cmd) {
   if (typeof cmd.meta === "function") {
     const result = cmd.meta();
@@ -67580,8 +67344,9 @@ function renderGroupedHelp(version, subCommands2, aliasMap) {
     existing.push(alias2);
     cmdAliases.set(primary, existing);
   }
+  const commandGroups = buildCommandGroups(new Set(descMap.keys()));
   let maxCmdWidth = 0;
-  const allGroupedCmds = COMMAND_GROUPS.flatMap((g) => g.commands);
+  const allGroupedCmds = commandGroups.flatMap((g) => g.commands);
   const allCmds = [.../* @__PURE__ */ new Set([...allGroupedCmds, ...descMap.keys()])];
   for (const cmd of allCmds) {
     if (!descMap.has(cmd) || aliasMap.has(cmd)) continue;
@@ -67595,7 +67360,7 @@ function renderGroupedHelp(version, subCommands2, aliasMap) {
   lines.push(`${underline2(bold2("USAGE"))} ${cyan2("cleo <command> [OPTIONS]")}`);
   lines.push("");
   const rendered = /* @__PURE__ */ new Set();
-  for (const group of COMMAND_GROUPS) {
+  for (const group of commandGroups) {
     const groupLines = [];
     for (const cmd of group.commands) {
       if (!descMap.has(cmd)) continue;
@@ -67833,8 +67598,8 @@ Or via NodeSource: https://github.com/nodesource/distributions
   }
 }
 function getPackageVersion() {
-  const pkgPath = join34(dirname12(fileURLToPath8(import.meta.url)), "../../package.json");
-  const pkg = JSON.parse(readFileSync19(pkgPath, "utf-8"));
+  const pkgPath = join34(dirname11(fileURLToPath8(import.meta.url)), "../../package.json");
+  const pkg = JSON.parse(readFileSync18(pkgPath, "utf-8"));
   return pkg.version;
 }
 var CLI_VERSION = getPackageVersion();
@@ -67986,7 +67751,7 @@ async function runStartupMaintenance() {
     detectAndRemoveStrayProjectNexus,
     getGlobalSalt,
     getLogger: getLogger20,
-    getProjectRoot: getProjectRoot44,
+    getProjectRoot: getProjectRoot43,
     isCleanupMarkerSet,
     migrateSignaldockToConduit,
     needsSignaldockToConduitMigration,
@@ -67995,7 +67760,7 @@ async function runStartupMaintenance() {
   } = await import("@cleocode/core/internal");
   let projectRootForCleanup = "";
   try {
-    projectRootForCleanup = getProjectRoot44();
+    projectRootForCleanup = getProjectRoot43();
   } catch {
   }
   if (!isCleanupMarkerSet(CLI_VERSION, projectRootForCleanup)) {
@@ -68015,7 +67780,7 @@ async function runStartupMaintenance() {
   const isInitInvocation = process.argv.slice(2).some((a) => a === "init");
   if (!isInitInvocation) {
     try {
-      const _projectRootForMigration = getProjectRoot44();
+      const _projectRootForMigration = getProjectRoot43();
       if (needsSignaldockToConduitMigration(_projectRootForMigration)) {
         const migrationResult = migrateSignaldockToConduit(_projectRootForMigration);
         if (migrationResult.status === "failed") {