@mutmutco/cli 4.3.60 → 4.3.61

package/dist/main.cjs

@@ -15788,10 +15788,10 @@ var rollout_plan_default = {
     note: "The v4.0.0 stamp happens at cut time (D6e #4463); until then the candidate is the origin/development head artifacts (built cli/dist + npm pack), identity proven by dist content hash (D6a)."
   },
   baseline: {
-    version: "4.3.60",
-    tag: "v4.3.60",
-    commit: "7602c0b24dc9",
-    npm: "@mutmutco/cli@4.3.60"
+    version: "4.3.61",
+    tag: "v4.3.61",
+    commit: "f4f05eb96516",
+    npm: "@mutmutco/cli@4.3.61"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -15808,14 +15808,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.3.60"
+          v3Target: "v4.3.61"
         }
       ],
       rollbackTrigger: "Any red inside the post-contract soak window: `devops train gate` FAIL attributable to the v4 doors, Hub endpoint health probe failure, a pre-v4 client admitted instead of receiving actionable HTTP 426, or npm consumer install/doctor failure on the v4-only dist.",
       rollback: {
         independent: true,
-        mechanism: "npm dist-tag latest -> 4.3.60 and redeploy the Hub Lambda from tag v4.3.60 (7602c0b24dc9); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.3.60 (@mutmutco/cli@4.3.60, tag commit 7602c0b24dc9 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.3.61 and redeploy the Hub Lambda from tag v4.3.61 (f4f05eb96516); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.3.61 (@mutmutco/cli@4.3.61, tag commit f4f05eb96516 \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -33190,19 +33190,23 @@ function findCommandInManifest(manifest, commandPath3) {
   return visit(manifest.tree);
 }
 function registerExplainCommand(program3) {
-  program3.command("explain").description("print a command's purpose, flags, and examples from the live schema \u2014 one grounding call replaces trial-and-error").argument("[command...]", 'the command path to explain (e.g. "issue create")').addOption(new Option("--loop <name>", "print the canonical command sequence: agent | start-work | ship-pr | hotfix").choices(Object.keys(LOOP_PLAYBOOKS))).option("--json", "machine-readable focused command, route, or loop detail").option("--recursive", "include full schemas for immediate children (default: compact child index)").option("--full", "alias for --recursive").action((commandArgs, opts) => {
+  program3.command("explain").description("print a command's purpose, flags, and examples from the live schema \u2014 one grounding call replaces trial-and-error").argument("[command...]", 'the command path to explain (e.g. "issue create")').addOption(new Option("--loop <name>", "print the canonical command sequence: agent | start-work | ship-pr | hotfix").choices(Object.keys(LOOP_PLAYBOOKS))).option("--json", "machine-readable focused command, route, or loop detail").option("--out <path>", "write the output to a UTF-8 file instead of stdout (#5802 byte contract)").option("--recursive", "include full schemas for immediate children (default: compact child index)").option("--full", "alias for --recursive").action((commandArgs, opts) => {
+    const emit = (output) => {
+      if (!opts.out) console.log(output);
+      else console.log(`Wrote explain output to ${opts.out} (UTF-8, ${writeUtf8Receipt(opts.out, output)} bytes)`);
+    };
     if (opts.loop) {
       if (!LOOP_PLAYBOOKS[opts.loop]) {
         const valid = Object.keys(LOOP_PLAYBOOKS).join(", ");
         fail(`explain --loop: unknown loop "${opts.loop}"; expected one of: ${valid}`, { code: ERROR_CODES.ERR_BAD_ENUM, expected: Object.keys(LOOP_PLAYBOOKS) });
         return;
       }
-      console.log(opts.json ? JSON.stringify({ schema_version: 1, scope: "loop", name: opts.loop, playbook: LOOP_PLAYBOOKS[opts.loop] }, null, 2) : formatExplainLoop(LOOP_PLAYBOOKS[opts.loop]));
+      emit(opts.json ? JSON.stringify({ schema_version: 1, scope: "loop", name: opts.loop, playbook: LOOP_PLAYBOOKS[opts.loop] }, null, 2) : formatExplainLoop(LOOP_PLAYBOOKS[opts.loop]));
       return;
     }
     const manifest = buildCommandManifest(program3);
     if (!commandArgs.length) {
-      console.log(opts.json ? JSON.stringify(compactRouteManifest(manifest), null, 2) : formatManifestHuman(manifest));
+      emit(opts.json ? JSON.stringify(compactRouteManifest(manifest), null, 2) : formatManifestHuman(manifest));
       return;
     }
     const commandPath3 = commandArgs.join(" ");
@@ -33225,7 +33229,7 @@ function registerExplainCommand(program3) {
       return;
     }
     const recursive = Boolean(opts.recursive || opts.full);
-    console.log(opts.json ? JSON.stringify(explainCommandManifest(manifest, command, { recursive }), null, 2) : command.subcommands.length ? formatExplainGroup(command, manifest.name) : formatExplainCommand(command, manifest.name));
+    emit(opts.json ? JSON.stringify(explainCommandManifest(manifest, command, { recursive }), null, 2) : command.subcommands.length ? formatExplainGroup(command, manifest.name) : formatExplainCommand(command, manifest.name));
   });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "4.3.60",
+  "version": "4.3.61",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",