@mutmutco/cli 4.1.1 → 4.1.2

package/dist/main.cjs

@@ -2306,7 +2306,8 @@ __export(index_exports, {
   positionalTargetForm: () => positionalTargetForm,
   registryClientDeps: () => registryClientDeps,
   repoSlug: () => repoSlug,
-  suggestCommandPath: () => suggestCommandPath
+  suggestCommandPath: () => suggestCommandPath,
+  unknownCommandCandidates: () => unknownCommandCandidates
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -12867,10 +12868,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.1.1",
-    tag: "v4.1.1",
-    commit: "df9ba86cbdba",
-    npm: "@mutmutco/cli@4.1.1"
+    version: "4.1.2",
+    tag: "v4.1.2",
+    commit: "bb1a56a57cda",
+    npm: "@mutmutco/cli@4.1.2"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -12887,14 +12888,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.1.1"
+          v3Target: "v4.1.2"
         }
       ],
       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.1.1 and redeploy the Hub Lambda from tag v4.1.1 (df9ba86cbdba); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.1.1 (@mutmutco/cli@4.1.1, tag commit df9ba86cbdba \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.1.2 and redeploy the Hub Lambda from tag v4.1.2 (bb1a56a57cda); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.1.2 (@mutmutco/cli@4.1.2, tag commit bb1a56a57cda \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -25946,8 +25947,9 @@ function verifiedReadyBase(statusValue, repo) {
   if (!v4 || typeof v4 !== "object" || Array.isArray(v4)) return null;
   const pointer = v4;
   const artifactDigests = pointer.artifactDigests;
+  const expectedArtifactDigests = pointer.materialLayout === 2 ? 1 : pointer.materialLayout === void 0 || pointer.materialLayout === 1 ? 2 : 0;
   const counts = [pointer.chunkCount, pointer.embeddingCount, pointer.tombstoneCount];
-  const structurallyVerified = status.repo === repo && pointer.repo === repo && pointer.state === "ready" && pointer.integrity === "verified" && typeof pointer.commit === "string" && COMMIT3.test(pointer.commit) && typeof pointer.digest === "string" && SHA256.test(pointer.digest) && Array.isArray(artifactDigests) && artifactDigests.length === 2 && new Set(artifactDigests).size === artifactDigests.length && artifactDigests.every((digest) => typeof digest === "string" && SHA256.test(digest)) && counts.every((count) => Number.isInteger(count) && Number(count) >= 0) && pointer.embeddingCount === pointer.chunkCount && typeof pointer.activatedAt === "string" && UTC_MILLIS.test(pointer.activatedAt) && Number.isFinite(Date.parse(pointer.activatedAt)) && new Date(pointer.activatedAt).toISOString() === pointer.activatedAt;
+  const structurallyVerified = status.repo === repo && pointer.repo === repo && pointer.state === "ready" && pointer.integrity === "verified" && typeof pointer.commit === "string" && COMMIT3.test(pointer.commit) && typeof pointer.digest === "string" && SHA256.test(pointer.digest) && Array.isArray(artifactDigests) && artifactDigests.length === expectedArtifactDigests && new Set(artifactDigests).size === artifactDigests.length && artifactDigests.every((digest) => typeof digest === "string" && SHA256.test(digest)) && counts.every((count) => Number.isInteger(count) && Number(count) >= 0) && pointer.embeddingCount === pointer.chunkCount && typeof pointer.activatedAt === "string" && UTC_MILLIS.test(pointer.activatedAt) && Number.isFinite(Date.parse(pointer.activatedAt)) && new Date(pointer.activatedAt).toISOString() === pointer.activatedAt;
   return structurallyVerified && typeof pointer.commit === "string" && typeof pointer.digest === "string" ? { commit: pointer.commit, digest: pointer.digest } : null;
 }
 function activePointerDigest(statusValue) {
@@ -34448,15 +34450,68 @@ function formatExplainLoop(playbook) {
   }
   return lines.join("\n");
 }
-function explainCommandManifest(manifest, command) {
-  return {
+function catalogCommandPaths(manifest) {
+  const acc = [];
+  const walk2 = (command) => {
+    if (command.path) acc.push(command.path);
+    for (const child2 of command.subcommands) walk2(child2);
+  };
+  walk2(manifest.tree);
+  return acc;
+}
+function nearestExplainTargets(query, paths, limit = 5) {
+  const all = [...paths];
+  const leafOf = (p) => p.slice(p.lastIndexOf(" ") + 1);
+  const leaf = leafOf(query);
+  const exactLeaf = all.filter((p) => p !== query && leafOf(p) === leaf).sort();
+  if (exactLeaf.length) return exactLeaf.slice(0, limit);
+  const out = [];
+  const nearPath = didYouMean(query, all);
+  if (nearPath) out.push(nearPath);
+  const nearLeaf = didYouMean(leaf, new Set(all.map(leafOf)));
+  if (nearLeaf) {
+    for (const p of all.filter((candidate2) => leafOf(candidate2) === nearLeaf).sort()) {
+      if (!out.includes(p)) out.push(p);
+      if (out.length >= limit) break;
+    }
+  }
+  return out.slice(0, limit);
+}
+function explainCommandManifest(manifest, command, opts = {}) {
+  const base = {
     schema_version: 1,
     scope: "command",
     name: manifest.name,
-    ...manifest.version ? { version: manifest.version } : {},
+    ...manifest.version ? { version: manifest.version } : {}
+  };
+  if (!command.subcommands.length) {
+    return {
+      ...base,
+      command: { ...command, subcommands: [] }
+    };
+  }
+  if (opts.recursive) {
+    return {
+      ...base,
+      command: {
+        ...command,
+        subcommands: command.subcommands.map((child2) => ({ ...child2, subcommands: [] }))
+      }
+    };
+  }
+  return {
+    ...base,
     command: {
       ...command,
-      subcommands: command.subcommands.map((child2) => ({ ...child2, subcommands: [] }))
+      subcommands: []
+    },
+    children: command.subcommands.map((child2) => ({
+      path: child2.path,
+      ...child2.description ? { summary: child2.description } : {},
+      detail: `mmi-cli explain ${child2.path} --json`
+    })),
+    next: {
+      recursive: `mmi-cli explain ${command.path} --json --recursive`
     }
   };
 }
@@ -34472,7 +34527,7 @@ 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").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("--recursive", "include full schemas for immediate children (default: compact child index)").option("--full", "alias for --recursive").action((commandArgs, opts) => {
     if (opts.loop) {
       if (!LOOP_PLAYBOOKS[opts.loop]) {
         const valid = Object.keys(LOOP_PLAYBOOKS).join(", ");
@@ -34490,10 +34545,19 @@ function registerExplainCommand(program3) {
     const commandPath3 = commandArgs.join(" ");
     const command = findCommandInManifest(manifest, commandPath3);
     if (!command) {
-      fail(`explain: unknown command "${commandPath3}"`, { code: ERROR_CODES.ERR_NOT_FOUND });
+      const nearest = nearestExplainTargets(commandPath3, catalogCommandPaths(manifest));
+      fail(`explain: unknown command "${commandPath3}"`, {
+        code: ERROR_CODES.ERR_NOT_FOUND,
+        ...nearest.length ? {
+          expected: nearest,
+          did_you_mean: nearest[0],
+          corrected_command: `mmi-cli explain ${nearest[0]} --json`
+        } : {}
+      });
       return;
     }
-    console.log(opts.json ? JSON.stringify(explainCommandManifest(manifest, command), null, 2) : command.subcommands.length ? formatExplainGroup(command, manifest.name) : formatExplainCommand(command, manifest.name));
+    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));
   });
 }
 
@@ -38932,13 +38996,28 @@ function positionalTargetForm(cmd, opts = {}) {
   if (!first) return void 0;
   return formatPositionalTarget(canonicalPathFor(commandPath2(cmd)) ?? commandPath2(cmd), first.name(), opts);
 }
+function unknownCommandCandidates(parent, allPaths) {
+  if (!parent) return [...allPaths];
+  const scoped = parent.commands.length ? parent.commands.filter((child2) => commandMetadata(child2)?.category !== "internal").map(commandPath2) : [];
+  const house = houseForPath(commandPath2(parent));
+  const sameHouse = house ? allPaths.filter((p) => houseForPath(p) === house) : [...allPaths];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const p of [...scoped, ...sameHouse]) {
+    if (seen.has(p)) continue;
+    seen.add(p);
+    out.push(p);
+  }
+  return out;
+}
 function resolveParseHint() {
   if (lastParseErrorKind === "unknown-command") {
     const parent = resolveCommandFromArgv(program2, process.argv.slice(2));
-    const candidates = parent && parent.commands.length ? parent.commands.filter((child2) => commandMetadata(child2)?.category !== "internal").map(commandPath2) : allCommandPaths();
+    const candidates = unknownCommandCandidates(parent, allCommandPaths());
     const path3 = lastUnknownCommand ? suggestCommandPath(lastUnknownCommand, candidates) : void 0;
     const canonical = path3 ? canonicalPathFor(path3) ?? path3 : void 0;
-    return canonical ? `(did you mean \`mmi-cli ${canonical}\`? ${DISCOVERY_HINT})` : STALE_HINT;
+    if (canonical) return `(did you mean \`mmi-cli ${canonical}\`? ${DISCOVERY_HINT})`;
+    return parent ? `(${DISCOVERY_HINT})` : STALE_HINT;
   }
   if (lastParseErrorKind !== "bad-arguments") return STALE_HINT;
   const cmd = resolveCommandFromArgv(program2, process.argv.slice(2));
@@ -42085,5 +42164,6 @@ program2.parseAsync(process.argv).then(() => finishCliRun()).catch((e) => failGr
   positionalTargetForm,
   registryClientDeps,
   repoSlug,
-  suggestCommandPath
+  suggestCommandPath,
+  unknownCommandCandidates
 });

package/package.json

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