@cleocode/cleo 2026.5.11 → 2026.5.13

package/dist/cli/index.js

@@ -9608,6 +9608,363 @@ var init_registry = __esm({
             description: "Task ID whose worktree should be pruned (omit for bulk prune)"
           }
         ]
+      },
+      // ---------------------------------------------------------------------------
+      // Sentient domain — T1726 SDK surface parity
+      //
+      // Sentient ops were dispatched via SentientHandler (registered under 'sentient'
+      // in the DomainHandler map) but absent from OPERATIONS, making them invisible
+      // to public SDK consumers using @cleocode/core. Adding all 10 ops here.
+      // ---------------------------------------------------------------------------
+      // sentient query: propose.list
+      {
+        gateway: "query",
+        domain: "sentient",
+        operation: "propose.list",
+        description: "sentient.propose.list (query) \u2014 list all pending Tier-2 proposals (status=proposed)",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "limit",
+            type: "number",
+            required: false,
+            description: "Maximum number of proposals to return (default: 50)"
+          }
+        ]
+      },
+      // sentient query: propose.diff
+      {
+        gateway: "query",
+        domain: "sentient",
+        operation: "propose.diff",
+        description: "sentient.propose.diff (query) \u2014 show what a proposal would change (Tier-3 stub)",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["id"],
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: true,
+            description: "Proposal task ID",
+            cli: { positional: true }
+          }
+        ]
+      },
+      // sentient query: allowlist.list
+      {
+        gateway: "query",
+        domain: "sentient",
+        operation: "allowlist.list",
+        description: "sentient.allowlist.list (query) \u2014 list owner pubkeys in the sentient allowlist",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      // sentient mutate: propose.accept
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "propose.accept",
+        description: "sentient.propose.accept (mutate) \u2014 accept a Tier-2 proposal, transitioning proposed \u2192 pending",
+        tier: 2,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["id"],
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: true,
+            description: "Proposal task ID to accept",
+            cli: { positional: true }
+          }
+        ]
+      },
+      // sentient mutate: propose.reject
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "propose.reject",
+        description: "sentient.propose.reject (mutate) \u2014 reject a Tier-2 proposal, transitioning proposed \u2192 cancelled",
+        tier: 2,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["id"],
+        params: [
+          {
+            name: "id",
+            type: "string",
+            required: true,
+            description: "Proposal task ID to reject",
+            cli: { positional: true }
+          },
+          {
+            name: "reason",
+            type: "string",
+            required: false,
+            description: "Human-readable reason for rejection"
+          }
+        ]
+      },
+      // sentient mutate: propose.run
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "propose.run",
+        description: "sentient.propose.run (mutate) \u2014 manually trigger a single Tier-2 propose tick in-process",
+        tier: 2,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      // sentient mutate: propose.enable
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "propose.enable",
+        description: "sentient.propose.enable (mutate) \u2014 enable Tier-2 autonomous proposal generation (M7 gate)",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      // sentient mutate: propose.disable
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "propose.disable",
+        description: "sentient.propose.disable (mutate) \u2014 disable Tier-2 autonomous proposal generation",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      // sentient mutate: allowlist.add
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "allowlist.add",
+        description: "sentient.allowlist.add (mutate) \u2014 add a base64-encoded owner pubkey to the sentient allowlist",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["pubkey"],
+        params: [
+          {
+            name: "pubkey",
+            type: "string",
+            required: true,
+            description: "Base64-encoded public key to add"
+          }
+        ]
+      },
+      // sentient mutate: allowlist.remove
+      {
+        gateway: "mutate",
+        domain: "sentient",
+        operation: "allowlist.remove",
+        description: "sentient.allowlist.remove (mutate) \u2014 remove a base64-encoded owner pubkey from the sentient allowlist",
+        tier: 2,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["pubkey"],
+        params: [
+          {
+            name: "pubkey",
+            type: "string",
+            required: true,
+            description: "Base64-encoded public key to remove"
+          }
+        ]
+      },
+      // ---------------------------------------------------------------------------
+      // Release domain — T1726 SDK surface parity
+      //
+      // Release ops dispatched via ReleaseHandler (registered under 'release' in
+      // the DomainHandler map) were absent from OPERATIONS. Adding gate +
+      // ivtr-suggest (the two ops ReleaseHandler serves) plus the canonical
+      // 4-step pipeline ops (start, verify, publish, reconcile) introduced by
+      // T1597 / ADR-063 that route through the core release module directly.
+      // ---------------------------------------------------------------------------
+      // release query: gate
+      {
+        gateway: "query",
+        domain: "release",
+        operation: "gate",
+        description: "release.gate (query) \u2014 check all IVTR loops in a release epic have reached the released phase before allowing release.ship (T820 RELEASE-03)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["epicId"],
+        params: [
+          {
+            name: "epicId",
+            type: "string",
+            required: true,
+            description: "Epic ID whose child tasks should be inspected"
+          },
+          {
+            name: "force",
+            type: "boolean",
+            required: false,
+            description: "Bypass the IVTR gate \u2014 requires explicit owner confirmation"
+          }
+        ]
+      },
+      // release mutate: gate
+      {
+        gateway: "mutate",
+        domain: "release",
+        operation: "gate",
+        description: "release.gate (mutate) \u2014 same IVTR gate check as query.gate; safe in both gateways (no DB writes)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["epicId"],
+        params: [
+          {
+            name: "epicId",
+            type: "string",
+            required: true,
+            description: "Epic ID whose child tasks should be inspected"
+          },
+          {
+            name: "force",
+            type: "boolean",
+            required: false,
+            description: "Bypass the IVTR gate \u2014 requires explicit owner confirmation"
+          }
+        ]
+      },
+      // release query: ivtr-suggest
+      {
+        gateway: "query",
+        domain: "release",
+        operation: "ivtr-suggest",
+        description: "release.ivtr-suggest (query) \u2014 check if all epic tasks are released and suggest cleo release ship (T820 RELEASE-07)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["taskId"],
+        params: [
+          {
+            name: "taskId",
+            type: "string",
+            required: true,
+            description: "Task ID that just reached the released phase"
+          }
+        ]
+      },
+      // release mutate: ivtr-suggest
+      {
+        gateway: "mutate",
+        domain: "release",
+        operation: "ivtr-suggest",
+        description: "release.ivtr-suggest (mutate) \u2014 same auto-suggest as query.ivtr-suggest; safe in both gateways (no DB writes)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: ["taskId"],
+        params: [
+          {
+            name: "taskId",
+            type: "string",
+            required: true,
+            description: "Task ID that just reached the released phase"
+          }
+        ]
+      },
+      // release mutate: start (T1597 / ADR-063 canonical step 1)
+      {
+        gateway: "mutate",
+        domain: "release",
+        operation: "start",
+        description: "release.start (mutate) \u2014 Step 1 of 4: validate version, capture branch, persist release handle (T1597 / ADR-063)",
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: ["version"],
+        params: [
+          {
+            name: "version",
+            type: "string",
+            required: true,
+            description: "Version to release (e.g. 2026.5.4)",
+            cli: { positional: true }
+          },
+          {
+            name: "epicId",
+            type: "string",
+            required: false,
+            description: "Epic ID this release ships"
+          },
+          {
+            name: "branch",
+            type: "string",
+            required: false,
+            description: "Override detected branch"
+          }
+        ]
+      },
+      // release query: verify (T1597 / ADR-063 canonical step 2)
+      {
+        gateway: "query",
+        domain: "release",
+        operation: "verify",
+        description: "release.verify (query) \u2014 Step 2 of 4: run gates + audit child tasks of the active release epic (T1597 / ADR-063)",
+        tier: 1,
+        idempotent: true,
+        sessionRequired: false,
+        requiredParams: [],
+        params: []
+      },
+      // release mutate: publish (T1597 / ADR-063 canonical step 3)
+      {
+        gateway: "mutate",
+        domain: "release",
+        operation: "publish",
+        description: "release.publish (mutate) \u2014 Step 3 of 4: invoke project-context publish.command to publish the release artifact (T1597 / ADR-063)",
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "dryRun",
+            type: "boolean",
+            required: false,
+            description: "Print command without executing"
+          }
+        ]
+      },
+      // release mutate: reconcile (T1597 / ADR-063 canonical step 4)
+      {
+        gateway: "mutate",
+        domain: "release",
+        operation: "reconcile",
+        description: "release.reconcile (mutate) \u2014 Step 4 of 4: run post-release invariants, auto-complete tasks for the active release (T1597 / ADR-063)",
+        tier: 1,
+        idempotent: false,
+        sessionRequired: false,
+        requiredParams: [],
+        params: [
+          {
+            name: "dryRun",
+            type: "boolean",
+            required: false,
+            description: "Preview without mutations"
+          }
+        ]
       }
     ];
     counts = getCounts();
@@ -9957,6 +10314,7 @@ __export(engine_exports, {
   lifecycleReset: () => lifecycleReset,
   lifecycleSkip: () => lifecycleSkip,
   lifecycleStatus: () => lifecycleStatus,
+  loadActiveReleaseHandle: () => loadActiveReleaseHandle,
   mapCodebase: () => mapCodebase,
   memoryBrainStats: () => memoryBrainStats,
   memoryContradictions: () => memoryContradictions,
@@ -10035,12 +10393,16 @@ __export(engine_exports, {
   releaseIvtrAutoSuggest: () => releaseIvtrAutoSuggest,
   releaseList: () => releaseList,
   releasePrepare: () => releasePrepare,
+  releasePublish: () => releasePublish,
   releasePush: () => releasePush,
+  releaseReconcile: () => releaseReconcile,
   releaseRollback: () => releaseRollback,
   releaseRollbackFull: () => releaseRollbackFull,
   releaseShip: () => releaseShip,
   releaseShow: () => releaseShow,
+  releaseStart: () => releaseStart,
   releaseTag: () => releaseTag,
+  releaseVerify: () => releaseVerify,
   sessionArchive: () => sessionArchive,
   sessionBriefing: () => sessionBriefing,
   sessionChainShow: () => sessionChainShow,
@@ -10165,6 +10527,7 @@ import {
   lifecycleReset,
   lifecycleSkip,
   lifecycleStatus,
+  loadActiveReleaseHandle,
   mapCodebase,
   orchestrateAnalyze,
   orchestrateBootstrap,
@@ -10212,12 +10575,16 @@ import {
   releaseIvtrAutoSuggest,
   releaseList,
   releasePrepare,
+  releasePublish,
   releasePush,
+  releaseReconcile,
   releaseRollback,
   releaseRollbackFull,
   releaseShip,
   releaseShow,
+  releaseStart,
   releaseTag,
+  releaseVerify,
   sessionArchive,
   sessionBriefing,
   sessionChainShow,
@@ -23986,6 +24353,7 @@ var init_release2 = __esm({
     "use strict";
     init_engine();
     init_base();
+    init_meta2();
     log2 = getLogger11("domain:release");
     coreOps3 = {
       gate: releaseGateOp,
@@ -24001,6 +24369,7 @@ var init_release2 = __esm({
        * Supported operations:
        * - `gate`         — check IVTR phase state for all tasks in a release epic
        * - `ivtr-suggest` — check if all epic tasks are released and suggest `release ship`
+       * - `verify`       — Step 2 of 4: run gates + audit child tasks (T1597 / ADR-063)
        */
       async query(operation, params) {
         const startTime = Date.now();
@@ -24043,6 +24412,16 @@ var init_release2 = __esm({
                 startTime
               );
             }
+            // 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);
+              return {
+                success: true,
+                data: result,
+                meta: dispatchMeta("query", "release", operation, startTime)
+              };
+            }
             default:
               return unsupportedOp("query", "release", operation, startTime);
           }
@@ -24064,6 +24443,9 @@ var init_release2 = __esm({
        * Supported operations:
        * - `gate`         — same IVTR gate check as query.gate (no DB writes)
        * - `ivtr-suggest` — same auto-suggest as query.ivtr-suggest (no DB writes)
+       * - `start`        — Step 1 of 4: validate version, capture branch, persist handle
+       * - `publish`      — Step 3 of 4: invoke project-context publish.command
+       * - `reconcile`    — Step 4 of 4: run post-release invariants, auto-complete tasks
        */
       async mutate(operation, params) {
         const startTime = Date.now();
@@ -24106,6 +24488,52 @@ var init_release2 = __esm({
                 startTime
               );
             }
+            // release.start — Step 1 of 4 (T1597 / ADR-063)
+            case "start": {
+              const version = typeof params?.version === "string" ? params.version : void 0;
+              if (!version)
+                return errorResult(
+                  "mutate",
+                  "release",
+                  operation,
+                  "E_INVALID_INPUT",
+                  "version is required",
+                  startTime
+                );
+              const result = await releaseStart(version, {
+                epicId: typeof params?.epicId === "string" ? params.epicId : void 0,
+                branch: typeof params?.branch === "string" ? params.branch : void 0
+              });
+              return {
+                success: true,
+                data: result,
+                meta: dispatchMeta("mutate", "release", operation, startTime)
+              };
+            }
+            // release.publish — Step 3 of 4 (T1597 / ADR-063)
+            case "publish": {
+              const handle = loadActiveReleaseHandle(getProjectRoot11());
+              const result = await releasePublish(handle, {
+                dryRun: typeof params?.dryRun === "boolean" ? params.dryRun : false
+              });
+              return {
+                success: true,
+                data: result,
+                meta: dispatchMeta("mutate", "release", operation, startTime)
+              };
+            }
+            // release.reconcile — Step 4 of 4 (T1597 / ADR-063)
+            case "reconcile": {
+              const handle = loadActiveReleaseHandle(getProjectRoot11());
+              const result = await releaseReconcile(handle, {
+                dryRun: typeof params?.dryRun === "boolean" ? params.dryRun : false
+              });
+              return {
+                success: true,
+                data: result,
+                meta: dispatchMeta("mutate", "release", operation, startTime)
+              };
+            }
             default:
               return unsupportedOp("mutate", "release", operation, startTime);
           }
@@ -24120,8 +24548,8 @@ var init_release2 = __esm({
       /** Return declared operations for introspection and registry validation. */
       getSupportedOperations() {
         return {
-          query: ["gate", "ivtr-suggest"],
-          mutate: ["gate", "ivtr-suggest"]
+          query: ["gate", "ivtr-suggest", "verify"],
+          mutate: ["gate", "ivtr-suggest", "start", "publish", "reconcile"]
         };
       }
     };
@@ -42353,7 +42781,7 @@ var analyzeCommand3 = defineCommand({
       try {
         const { runGitLogTaskLinker } = await import("@cleocode/core/nexus");
         const sweeperResult = await runGitLogTaskLinker(repoPath);
-        if (ctx.format !== "json" && sweeperResult.commitsProcessed > 0) {
+        if (sweeperResult.commitsProcessed > 0) {
           process.stderr.write(
             `[nexus] Task-symbol sweep: ${sweeperResult.commitsProcessed} commit(s), ${sweeperResult.tasksFound} task(s), ${sweeperResult.linked} edge(s) linked.
 `