@cleocode/cleo 2026.5.75 → 2026.5.76

package/dist/cli/index.js

@@ -7371,6 +7371,115 @@ var init_registry = __esm({
           }
         ]
       },
+      // === saga sub-domain (ADR-073 — above-epic grouping tier) ===
+      {
+        gateway: "mutate",
+        domain: "tasks",
+        operation: "saga.create",
+        description: "tasks.saga.create (mutate) \u2014 create a labeled top-level Epic as a Saga",
+        tier: 0,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["title"],
+        params: [
+          {
+            name: "title",
+            type: "string",
+            required: true,
+            description: "Saga title (3\u2013500 characters)",
+            cli: { flag: "title" }
+          },
+          {
+            name: "description",
+            type: "string",
+            required: false,
+            description: "Saga description",
+            cli: { flag: "description", short: "-d" }
+          },
+          {
+            name: "acceptance",
+            type: "array",
+            required: false,
+            description: "Pipe-separated acceptance criteria",
+            cli: { flag: "acceptance" }
+          }
+        ]
+      },
+      {
+        gateway: "mutate",
+        domain: "tasks",
+        operation: "saga.add",
+        description: "tasks.saga.add (mutate) \u2014 link an Epic to a Saga via task_relations type=groups",
+        tier: 0,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["sagaId", "epicId"],
+        params: [
+          {
+            name: "sagaId",
+            type: "string",
+            required: true,
+            description: "Saga task ID (must have label=saga)",
+            cli: { positional: true }
+          },
+          {
+            name: "epicId",
+            type: "string",
+            required: true,
+            description: "Epic task ID to link as member",
+            cli: { positional: true }
+          }
+        ]
+      },
+      {
+        gateway: "query",
+        domain: "tasks",
+        operation: "saga.list",
+        description: "tasks.saga.list (query) \u2014 list all Sagas (labeled top-level Epics)",
+        tier: 0,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      {
+        gateway: "query",
+        domain: "tasks",
+        operation: "saga.members",
+        description: "tasks.saga.members (query) \u2014 list member Epics linked to a Saga",
+        tier: 0,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["sagaId"],
+        params: [
+          {
+            name: "sagaId",
+            type: "string",
+            required: true,
+            description: "Saga task ID",
+            cli: { positional: true }
+          }
+        ]
+      },
+      {
+        gateway: "query",
+        domain: "tasks",
+        operation: "saga.rollup",
+        description: "tasks.saga.rollup (query) \u2014 aggregate member Epic statuses (total/done/active/blocked/pending + completionPct)",
+        tier: 0,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["sagaId"],
+        params: [
+          {
+            name: "sagaId",
+            type: "string",
+            required: true,
+            description: "Saga task ID",
+            cli: { positional: true }
+          }
+        ]
+      },
       {
         gateway: "mutate",
         domain: "tasks",
@@ -12612,6 +12721,7 @@ __export(engine_exports, {
   lifecycleSkip: () => lifecycleSkip,
   lifecycleStatus: () => lifecycleStatus,
   loadActiveReleaseHandle: () => loadActiveReleaseHandle,
+  makeAdr061GateRunner: () => makeAdr061GateRunner,
   mapCodebase: () => mapCodebase,
   memoryBrainStats: () => memoryBrainStats,
   memoryContradictions: () => memoryContradictions,
@@ -12842,6 +12952,7 @@ import {
   lifecycleSkip,
   lifecycleStatus,
   loadActiveReleaseHandle,
+  makeAdr061GateRunner,
   mapCodebase,
   memoryBrainStats,
   memoryContradictions,
@@ -27083,8 +27194,11 @@ var init_release2 = __esm({
             }
             // release.verify — Step 2 of 4: run gates + audit child tasks (T1597 / ADR-063)
             case "verify": {
-              const handle = loadActiveReleaseHandle(getProjectRoot11());
-              const result = await releaseVerify(handle);
+              const projectRoot = getProjectRoot11();
+              const handle = loadActiveReleaseHandle(projectRoot);
+              const result = await releaseVerify(handle, {
+                runGate: makeAdr061GateRunner(projectRoot)
+              });
               return {
                 success: true,
                 data: result,
@@ -28107,6 +28221,139 @@ var init_sticky2 = __esm({
 
 // packages/cleo/src/dispatch/domains/tasks.ts
 import { getLogger as getLogger14, getProjectRoot as getProjectRoot15 } from "@cleocode/core";
+async function sagaCreate(params) {
+  const projectRoot = getProjectRoot15();
+  const title = typeof params.title === "string" ? params.title : "";
+  const description = typeof params.description === "string" ? params.description : void 0;
+  const acceptance = Array.isArray(params.acceptance) ? params.acceptance : void 0;
+  return wrapCoreResult(
+    await addTaskWithSessionScope(projectRoot, {
+      title,
+      description,
+      labels: ["saga"],
+      type: "epic",
+      acceptance
+    }),
+    "saga.create"
+  );
+}
+async function sagaAdd(params) {
+  const projectRoot = getProjectRoot15();
+  const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
+  const epicId = typeof params.epicId === "string" ? params.epicId : "";
+  if (!sagaId || !epicId) {
+    return lafsError("E_INVALID_INPUT", "sagaId and epicId are required", "saga.add");
+  }
+  const sagaResult = await taskShow(projectRoot, sagaId);
+  if (!sagaResult.success || !sagaResult.data) {
+    return lafsError("E_NOT_FOUND", `Saga not found: ${sagaId}`, "saga.add");
+  }
+  const sagaTask = sagaResult.data.task;
+  const sagaLabels = sagaTask?.labels ?? [];
+  if (!sagaLabels.includes("saga")) {
+    return lafsError("E_INVALID_INPUT", `Task ${sagaId} does not have label='saga'`, "saga.add");
+  }
+  const epicResult = await taskShow(projectRoot, epicId);
+  if (!epicResult.success || !epicResult.data) {
+    return lafsError("E_NOT_FOUND", `Epic not found: ${epicId}`, "saga.add");
+  }
+  const epicType = epicResult.data.task?.type;
+  if (epicType !== "epic") {
+    return lafsError(
+      "E_INVALID_INPUT",
+      `Task ${epicId} has type='${String(epicType)}', expected type='epic'`,
+      "saga.add"
+    );
+  }
+  const relResult = await taskRelatesAdd(projectRoot, sagaId, epicId, "groups", void 0);
+  if (!relResult.success) {
+    return lafsError(
+      "E_GENERAL",
+      relResult.error?.message ?? "Failed to link Epic to Saga",
+      "saga.add"
+    );
+  }
+  return lafsSuccess({ sagaId, epicId, added: relResult.data?.added ?? true }, "saga.add");
+}
+async function sagaList() {
+  const projectRoot = getProjectRoot15();
+  const result = await taskList(projectRoot, { type: "epic", label: "saga" });
+  if (!result.success) {
+    return lafsError("E_GENERAL", result.error?.message ?? "Failed to list Sagas", "saga.list");
+  }
+  const tasks = result.data?.tasks ?? [];
+  const topLevel = tasks.filter((t) => {
+    const parentId = t.parentId;
+    return !parentId;
+  });
+  return lafsSuccess({ sagas: topLevel, total: topLevel.length }, "saga.list");
+}
+async function sagaMembers(params) {
+  const projectRoot = getProjectRoot15();
+  const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
+  if (!sagaId) {
+    return lafsError("E_INVALID_INPUT", "sagaId is required", "saga.members");
+  }
+  const result = await taskRelates(projectRoot, sagaId);
+  if (!result.success) {
+    return lafsError(
+      "E_GENERAL",
+      result.error?.message ?? "Failed to list Saga members",
+      "saga.members"
+    );
+  }
+  const relations = result.data?.relations ?? [];
+  const members = relations.filter((r) => r.type === "groups");
+  return lafsSuccess(
+    {
+      sagaId,
+      members: members.map((r) => ({ epicId: r.taskId, type: r.type, reason: r.reason })),
+      total: members.length
+    },
+    "saga.members"
+  );
+}
+async function sagaRollup(params) {
+  const projectRoot = getProjectRoot15();
+  const sagaId = typeof params.sagaId === "string" ? params.sagaId : "";
+  if (!sagaId) {
+    return lafsError("E_INVALID_INPUT", "sagaId is required", "saga.rollup");
+  }
+  const relResult = await taskRelates(projectRoot, sagaId);
+  if (!relResult.success) {
+    return lafsError(
+      "E_GENERAL",
+      relResult.error?.message ?? "Failed to fetch Saga members for rollup",
+      "saga.rollup"
+    );
+  }
+  const members = (relResult.data?.relations ?? []).filter((r) => r.type === "groups");
+  const total = members.length;
+  if (total === 0) {
+    return lafsSuccess(
+      { sagaId, total: 0, done: 0, active: 0, blocked: 0, pending: 0, completionPct: 0 },
+      "saga.rollup"
+    );
+  }
+  const shows = await Promise.all(members.map((m) => taskShow(projectRoot, m.taskId)));
+  let done = 0;
+  let active = 0;
+  let blocked = 0;
+  let pending = 0;
+  for (const r of shows) {
+    if (!r.success) continue;
+    const status = r.data?.task?.status ?? "pending";
+    if (status === "done") done++;
+    else if (status === "active") active++;
+    else if (status === "blocked") blocked++;
+    else pending++;
+  }
+  const completionPct = total > 0 ? Math.round(done / total * 100) : 0;
+  return lafsSuccess(
+    { sagaId, total, done, active, blocked, pending, completionPct },
+    "saga.rollup"
+  );
+}
 var _tasksTypedHandler, QUERY_OPS10, MUTATE_OPS10, TasksHandler;
 var init_tasks3 = __esm({
   "packages/cleo/src/dispatch/domains/tasks.ts"() {
@@ -28512,7 +28759,11 @@ var init_tasks3 = __esm({
       "history",
       "current",
       "label.list",
-      "sync.links"
+      "sync.links",
+      // Saga sub-domain (ADR-073)
+      "saga.list",
+      "saga.members",
+      "saga.rollup"
     ]);
     MUTATE_OPS10 = /* @__PURE__ */ new Set([
       "add",
@@ -28531,7 +28782,10 @@ var init_tasks3 = __esm({
       "sync.reconcile",
       "sync.links.remove",
       "claim",
-      "unclaim"
+      "unclaim",
+      // Saga sub-domain (ADR-073)
+      "saga.create",
+      "saga.add"
     ]);
     TasksHandler = class {
       // -----------------------------------------------------------------------
@@ -28558,6 +28812,26 @@ var init_tasks3 = __esm({
             startTime
           );
         }
+        try {
+          if (operation === "saga.list") {
+            const envelope = await sagaList();
+            return wrapResult(envelopeToEngineResult(envelope), "query", "tasks", operation, startTime);
+          }
+          if (operation === "saga.members") {
+            const envelope = await sagaMembers(params ?? {});
+            return wrapResult(envelopeToEngineResult(envelope), "query", "tasks", operation, startTime);
+          }
+          if (operation === "saga.rollup") {
+            const envelope = await sagaRollup(params ?? {});
+            return wrapResult(envelopeToEngineResult(envelope), "query", "tasks", operation, startTime);
+          }
+        } catch (error) {
+          getLogger14("domain:tasks").error(
+            { gateway: "query", domain: "tasks", operation, err: error },
+            error instanceof Error ? error.message : String(error)
+          );
+          return handleErrorResult("query", "tasks", operation, error, startTime);
+        }
         try {
           const envelope = await typedDispatch(
             _tasksTypedHandler,
@@ -28587,6 +28861,34 @@ var init_tasks3 = __esm({
         if (!MUTATE_OPS10.has(operation)) {
           return unsupportedOp("mutate", "tasks", operation, startTime);
         }
+        try {
+          if (operation === "saga.create") {
+            const envelope = await sagaCreate(params ?? {});
+            return wrapResult(
+              envelopeToEngineResult(envelope),
+              "mutate",
+              "tasks",
+              operation,
+              startTime
+            );
+          }
+          if (operation === "saga.add") {
+            const envelope = await sagaAdd(params ?? {});
+            return wrapResult(
+              envelopeToEngineResult(envelope),
+              "mutate",
+              "tasks",
+              operation,
+              startTime
+            );
+          }
+        } catch (error) {
+          getLogger14("domain:tasks").error(
+            { gateway: "mutate", domain: "tasks", operation, err: error },
+            error instanceof Error ? error.message : String(error)
+          );
+          return handleErrorResult("mutate", "tasks", operation, error, startTime);
+        }
         try {
           const envelope = await typedDispatch(
             _tasksTypedHandler,
@@ -28626,7 +28928,11 @@ var init_tasks3 = __esm({
             "history",
             "current",
             "label.list",
-            "sync.links"
+            "sync.links",
+            // Saga sub-domain (ADR-073)
+            "saga.list",
+            "saga.members",
+            "saga.rollup"
           ],
           mutate: [
             "add",
@@ -28645,7 +28951,10 @@ var init_tasks3 = __esm({
             "sync.reconcile",
             "sync.links.remove",
             "claim",
-            "unclaim"
+            "unclaim",
+            // Saga sub-domain (ADR-073)
+            "saga.create",
+            "saga.add"
           ]
         };
       }
@@ -53092,7 +53401,11 @@ var init_release3 = __esm({
     verifyCommand2 = defineCommand({
       meta: { name: "verify", description: "Verify release gates + child task gate state" },
       async run() {
-        const result = await release2.releaseVerify(release2.loadActiveReleaseHandle(process.cwd()));
+        const projectRoot = process.cwd();
+        const handle = release2.loadActiveReleaseHandle(projectRoot);
+        const result = await release2.releaseVerify(handle, {
+          runGate: release2.makeAdr061GateRunner(projectRoot)
+        });
         cliOutput(result, { command: "release", operation: "release.verify" });
         if (!result.passed) process.exit(1);
       }
@@ -54784,6 +55097,153 @@ var init_safestop = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/saga.ts
+var saga_exports = {};
+__export(saga_exports, {
+  sagaCommand: () => sagaCommand
+});
+var createCommand3, addCommand9, listCommand20, membersCommand, rollupCommand2, sagaCommand;
+var init_saga = __esm({
+  "packages/cleo/src/cli/commands/saga.ts"() {
+    "use strict";
+    init_dist();
+    init_cli();
+    init_renderers();
+    createCommand3 = defineCommand({
+      meta: {
+        name: "create",
+        description: "Create a new Saga (labeled top-level Epic with label=saga)"
+      },
+      args: {
+        title: {
+          type: "string",
+          description: "Saga title",
+          required: true
+        },
+        description: {
+          type: "string",
+          description: "Saga description",
+          required: false
+        },
+        acceptance: {
+          type: "string",
+          description: 'Pipe-separated acceptance criteria (e.g. "AC1|AC2")',
+          required: false
+        }
+      },
+      async run({ args }) {
+        await dispatchFromCli(
+          "mutate",
+          "tasks",
+          "saga.create",
+          {
+            title: args.title,
+            description: args.description,
+            acceptance: args.acceptance ? args.acceptance.split("|") : void 0
+          },
+          { command: "saga", operation: "tasks.saga.create" }
+        );
+      }
+    });
+    addCommand9 = defineCommand({
+      meta: {
+        name: "add",
+        description: "Link a member Epic to a Saga (writes task_relations type=groups)"
+      },
+      args: {
+        sagaId: {
+          type: "positional",
+          description: "Saga task ID (must have label=saga)",
+          required: true
+        },
+        epicId: {
+          type: "positional",
+          description: "Epic task ID to add as a member",
+          required: true
+        }
+      },
+      async run({ args }) {
+        await dispatchFromCli(
+          "mutate",
+          "tasks",
+          "saga.add",
+          { sagaId: args.sagaId, epicId: args.epicId },
+          { command: "saga", operation: "tasks.saga.add" }
+        );
+      }
+    });
+    listCommand20 = defineCommand({
+      meta: {
+        name: "list",
+        description: "List all Sagas (labeled top-level Epics)"
+      },
+      async run() {
+        await dispatchFromCli("query", "tasks", "saga.list", {}, { command: "saga" });
+      }
+    });
+    membersCommand = defineCommand({
+      meta: {
+        name: "members",
+        description: "List all member Epics linked to a Saga via type=groups"
+      },
+      args: {
+        sagaId: {
+          type: "positional",
+          description: "Saga task ID",
+          required: true
+        }
+      },
+      async run({ args }) {
+        await dispatchFromCli(
+          "query",
+          "tasks",
+          "saga.members",
+          { sagaId: args.sagaId },
+          { command: "saga" }
+        );
+      }
+    });
+    rollupCommand2 = defineCommand({
+      meta: {
+        name: "rollup",
+        description: "Aggregate member Epic statuses: total/done/active/blocked/pending + completionPct"
+      },
+      args: {
+        sagaId: {
+          type: "positional",
+          description: "Saga task ID",
+          required: true
+        }
+      },
+      async run({ args }) {
+        const response = await dispatchRaw("query", "tasks", "saga.rollup", {
+          sagaId: args.sagaId
+        });
+        handleRawError(response, { command: "saga", operation: "tasks.saga.rollup" });
+        cliOutput(response.data ?? {}, { command: "saga", operation: "tasks.saga.rollup" });
+      }
+    });
+    sagaCommand = defineCommand({
+      meta: {
+        name: "saga",
+        description: "Saga management \u2014 above-Epic grouping tier (ADR-073)"
+      },
+      subCommands: {
+        create: createCommand3,
+        add: addCommand9,
+        list: listCommand20,
+        members: membersCommand,
+        rollup: rollupCommand2
+      },
+      async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands) return;
+        await showUsage(cmd);
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/schema.ts
 var schema_exports = {};
 __export(schema_exports, {
@@ -56192,7 +56652,7 @@ async function promptOwnerAuthPassword(sessionName) {
   const token = deriveOwnerAuthToken(sessionName, password);
   return token;
 }
-var startCommand8, endCommand, handoffCommand2, statusCommand12, resumeCommand2, findCommand6, listCommand20, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, sessionCommand;
+var startCommand8, endCommand, handoffCommand2, statusCommand12, resumeCommand2, findCommand6, listCommand21, gcCommand2, showCommand13, driftCommand, contextDriftCommand, suspendCommand, recordAssumptionCommand, recordDecisionCommand, decisionLogCommand, sessionCommand;
 var init_session4 = __esm({
   "packages/cleo/src/cli/commands/session.ts"() {
     "use strict";
@@ -56458,7 +56918,7 @@ var init_session4 = __esm({
         );
       }
     });
-    listCommand20 = defineCommand({
+    listCommand21 = defineCommand({
       meta: { name: "list", description: "List sessions" },
       args: {
         status: {
@@ -56723,7 +57183,7 @@ var init_session4 = __esm({
         status: statusCommand12,
         resume: resumeCommand2,
         find: findCommand6,
-        list: listCommand20,
+        list: listCommand21,
         gc: gcCommand2,
         show: showCommand13,
         "context-drift": contextDriftCommand,
@@ -56782,14 +57242,14 @@ var skills_exports = {};
 __export(skills_exports, {
   skillsCommand: () => skillsCommand2
 });
-var listCommand21, searchCommand4, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, spawnProvidersCommand, skillsCommand2;
+var listCommand22, searchCommand4, validateCommand8, infoCommand, installCommand3, uninstallCommand2, enableCommand2, disableCommand2, refreshCommand, dispatchCommand, catalogCommand, precedenceCommand, depsCommand4, spawnProvidersCommand, skillsCommand2;
 var init_skills2 = __esm({
   "packages/cleo/src/cli/commands/skills.ts"() {
     "use strict";
     init_dist();
     init_cli();
     init_subcommand_guard();
-    listCommand21 = defineCommand({
+    listCommand22 = defineCommand({
       meta: { name: "list", description: "List installed skills" },
       args: {
         global: {
@@ -57104,7 +57564,7 @@ var init_skills2 = __esm({
     skillsCommand2 = defineCommand({
       meta: { name: "skills", description: "Skill management: list, search, validate, info, install" },
       subCommands: {
-        list: listCommand21,
+        list: listCommand22,
         search: searchCommand4,
         validate: validateCommand8,
         info: infoCommand,
@@ -57348,7 +57808,7 @@ __export(sticky_exports, {
   stickyCommand: () => stickyCommand
 });
 import { CleoError as CleoError10 } from "@cleocode/core";
-var addCommand9, listCommand22, showCommand15, convertCommand, archiveCommand4, purgeCommand2, stickyCommand;
+var addCommand10, listCommand23, showCommand15, convertCommand, archiveCommand4, purgeCommand2, stickyCommand;
 var init_sticky3 = __esm({
   "packages/cleo/src/cli/commands/sticky.ts"() {
     "use strict";
@@ -57356,7 +57816,7 @@ var init_sticky3 = __esm({
     init_dist();
     init_cli();
     init_renderers();
-    addCommand9 = defineCommand({
+    addCommand10 = defineCommand({
       meta: { name: "add", description: "Create a new sticky note" },
       args: {
         content: {
@@ -57404,7 +57864,7 @@ var init_sticky3 = __esm({
         }
       }
     });
-    listCommand22 = defineCommand({
+    listCommand23 = defineCommand({
       meta: { name: "list", description: "List active sticky notes" },
       args: {
         tag: {
@@ -57638,10 +58098,10 @@ var init_sticky3 = __esm({
         description: "Manage sticky notes - quick project-wide ephemeral captures"
       },
       subCommands: {
-        add: addCommand9,
-        jot: addCommand9,
-        list: listCommand22,
-        ls: listCommand22,
+        add: addCommand10,
+        jot: addCommand10,
+        list: listCommand23,
+        ls: listCommand23,
         show: showCommand15,
         convert: convertCommand,
         archive: archiveCommand4,
@@ -58062,7 +58522,7 @@ function readPayload(args, textKey, fileKey) {
   if (file) return readFileSync15(file, "utf-8");
   return text;
 }
-var filterArgs, summaryCommand3, listCommand23, showCommand16, deleteCommand3, clearCommand2, estimateCommand, tokenCommand;
+var filterArgs, summaryCommand3, listCommand24, showCommand16, deleteCommand3, clearCommand2, estimateCommand, tokenCommand;
 var init_token = __esm({
   "packages/cleo/src/cli/commands/token.ts"() {
     "use strict";
@@ -58098,7 +58558,7 @@ var init_token = __esm({
         );
       }
     });
-    listCommand23 = defineCommand({
+    listCommand24 = defineCommand({
       meta: { name: "list", description: "List recorded token telemetry" },
       args: {
         ...filterArgs,
@@ -58233,7 +58693,7 @@ var init_token = __esm({
       },
       subCommands: {
         summary: summaryCommand3,
-        list: listCommand23,
+        list: listCommand24,
         show: showCommand16,
         delete: deleteCommand3,
         clear: clearCommand2,
@@ -60170,6 +60630,12 @@ var COMMAND_MANIFEST = [
     description: "Graceful shutdown for agents approaching context limits",
     load: async () => (await Promise.resolve().then(() => (init_safestop(), safestop_exports))).safestopCommand
   },
+  {
+    exportName: "sagaCommand",
+    name: "saga",
+    description: "Saga management \u2014 above-Epic grouping tier (ADR-073)",
+    load: async () => (await Promise.resolve().then(() => (init_saga(), saga_exports))).sagaCommand
+  },
   {
     exportName: "schemaCommand",
     name: "schema",