@mutmutco/cli 4.1.5 → 4.1.7

package/dist/main.cjs

@@ -13152,10 +13152,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.5",
-    tag: "v4.1.5",
-    commit: "1cc8a83f5646",
-    npm: "@mutmutco/cli@4.1.5"
+    version: "4.1.7",
+    tag: "v4.1.7",
+    commit: "3811b46c48ba",
+    npm: "@mutmutco/cli@4.1.7"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -13172,14 +13172,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.1.5"
+          v3Target: "v4.1.7"
         }
       ],
       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.5 and redeploy the Hub Lambda from tag v4.1.5 (1cc8a83f5646); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.1.5 (@mutmutco/cli@4.1.5, tag commit 1cc8a83f5646 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.1.7 and redeploy the Hub Lambda from tag v4.1.7 (3811b46c48ba); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.1.7 (@mutmutco/cli@4.1.7, tag commit 3811b46c48ba \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -15941,6 +15941,40 @@ var HUB_REPO3 = "mutmutco/MMI-Hub";
 function isHubControlRepo(repo) {
   return repo.toLowerCase() === HUB_REPO3.toLowerCase();
 }
+function supportsReleaseAbort(repo, meta, branchHints) {
+  if (isHubControlRepo(repo)) return true;
+  if (meta.deployModel !== "registry-publish") return false;
+  return resolveReleaseTrack(meta, branchHints, repo) === "direct";
+}
+function resolveReleaseAbortNpmPackage(meta, repo) {
+  if (isHubControlRepo(repo)) return "@mutmutco/cli";
+  const publishDir = typeof meta.publishDir === "string" && meta.publishDir.trim() ? meta.publishDir.trim() : ".";
+  try {
+    const pkg = JSON.parse((0, import_node_fs15.readFileSync)((0, import_node_path14.join)(publishDir, "package.json"), "utf8"));
+    const name = pkg.name?.trim();
+    if (!name) throw new Error("missing name field");
+    return name;
+  } catch (e) {
+    throw new Error(
+      `release --abort: cannot read npm publish name from ${publishDir}/package.json (${e instanceof Error ? e.message : String(e)}); nothing was written`
+    );
+  }
+}
+async function proveNpmVersionUnpublished(deps, packageName, version, tag) {
+  try {
+    const published = clean2(await deps.run("npm", ["view", `${packageName}@${version}`, "version", "--json"]));
+    if (published) {
+      throw new Error(`release --abort: ${packageName}@${version} is already published; ${tag} cannot be reused`);
+    }
+    throw new Error("npm registry returned an empty successful response");
+  } catch (error) {
+    const detail = `${error instanceof Error ? error.message : String(error)} ${String(error.stderr ?? "")}`;
+    if (!/E404|not found|No match found/i.test(detail)) {
+      if (/already published/.test(detail)) throw error;
+      throw new Error(`release --abort: npm publish absence could not be proven (${detail.trim()}); nothing was written`);
+    }
+  }
+}
 function projectGetFailureText(e) {
   const err = e;
   return [err.message, err.stderr, err.stdout].filter(Boolean).join(" ");
@@ -16387,8 +16421,9 @@ function partialTrainRecoveryError(cause, input) {
   - origin/${branch}: NOT pushed
   - ${releaseState}
 ` + deployLine;
-  const failedHubMainGate = input.stage === "main" && input.repo.toLowerCase() === HUB_REPO3.toLowerCase() && /^required train check failed:/i.test(causeMessage);
-  if (failedHubMainGate) {
+  const releaseAbortEligible = input.meta ? supportsReleaseAbort(input.repo, input.meta, input.branchHints) : isHubControlRepo(input.repo);
+  const failedAbortEligibleMainGate = input.stage === "main" && releaseAbortEligible && /^required train check failed:/i.test(causeMessage);
+  if (failedAbortEligibleMainGate) {
     return new Error(
       `${causeMessage}
 
@@ -17229,7 +17264,7 @@ async function gateTrueMergeCommit(deps, ctx, tag, releaseSha, requiredChecks) {
     }
   }
 }
-async function completeMainRelease(deps, ctx, meta, deployModel, watch, options, tag, releaseSha, startBranch, preFold, tagProbe) {
+async function completeMainRelease(deps, ctx, meta, deployModel, watch, options, tag, releaseSha, startBranch, preFold, tagProbe, branchHints) {
   const resumeCommand = options.dev ? "mmi-cli devops release --dev --apply" : "mmi-cli devops release --apply";
   try {
     await verifyPublishDryRun(deps, ctx, meta, deployModel);
@@ -17265,16 +17300,17 @@ async function completeMainRelease(deps, ctx, meta, deployModel, watch, options,
   }
   const tagPushSince = (deps.now ?? Date.now)();
   let checks;
+  const recoveryInput = { repo: ctx.repo, tag, stage: "main", deployModel, meta, branchHints };
   try {
     checks = await waitForRequiredTrainChecks(deps, ctx, releaseSha, requiredChecks, tagPush.pushed ? tagPushSince : void 0);
   } catch (e) {
-    throw partialTrainRecoveryError(e, { repo: ctx.repo, tag, stage: "main", deployModel });
+    throw partialTrainRecoveryError(e, recoveryInput);
   }
   if (trueMergeGateNote) checks = `${trueMergeGateNote}; ${checks}`;
   try {
     await runGitPush(deps, ["push", "origin", "main"]);
   } catch (e) {
-    throw partialTrainRecoveryError(e, { repo: ctx.repo, tag, stage: "main", deployModel });
+    throw partialTrainRecoveryError(e, recoveryInput);
   }
   const releaseUrl = clean2(await deps.run("gh", ["release", "create", tag, "--target", "main", "--generate-notes", "--latest", "--repo", ctx.repo])) || void 0;
   await verifyPublishedRelease(deps, ctx.repo, tag, "main", releaseSha);
@@ -17446,16 +17482,17 @@ async function runReleaseResume(deps, options = {}) {
   }
   const steps = [];
   let requiredChecks;
+  const recoveryInput = { repo: ctx.repo, tag, stage: "main", deployModel, meta, branchHints };
   try {
     requiredChecks = await discoverRequiredCheckContexts(deps, ctx, "main");
   } catch (e) {
-    throw partialTrainRecoveryError(e, { repo: ctx.repo, tag, stage: "main", deployModel });
+    throw partialTrainRecoveryError(e, recoveryInput);
   }
   assertTagAddressableRequiredContexts(deps, requiredChecks, ctx.repo);
   try {
     steps.push(await waitForRequiredTrainChecks(deps, ctx, tagSha, requiredChecks, void 0));
   } catch (e) {
-    throw partialTrainRecoveryError(e, { repo: ctx.repo, tag, stage: "main", deployModel });
+    throw partialTrainRecoveryError(e, recoveryInput);
   }
   await runGitPush(deps, ["push", "origin", `${tagSha}:refs/heads/main`]);
   steps.push(`pushed ${tagSha.slice(0, 12)} to origin/main`);
@@ -17500,8 +17537,12 @@ async function runReleaseAbort(deps, options = {}) {
     throw new Error("release --abort requires --apply after explicit approval; nothing was written");
   }
   const ctx = await buildTrainApplyContext(deps);
-  if (!isHubControlRepo(ctx.repo)) {
-    throw new Error("release --abort is limited to mutmutco/MMI-Hub until other release tracks define equivalent publish-absence proof");
+  const meta = requireProjectMetaForTrain(await loadProjectMeta(deps, ctx), ctx.repo);
+  const branchHints = await loadReleaseTrackBranchHints(deps);
+  if (!supportsReleaseAbort(ctx.repo, meta, branchHints)) {
+    throw new Error(
+      "release --abort is limited to mutmutco/MMI-Hub and eligible direct-track registry-publish repos until other release tracks define equivalent publish-absence proof"
+    );
   }
   await requireCleanTree(deps);
   if (await currentBranch(deps) !== "main") {
@@ -17536,19 +17577,8 @@ async function runReleaseAbort(deps, options = {}) {
     throw new Error(`release --abort: ${tag} is released or its unpublished state could not be proven; nothing was written`);
   }
   const version = tag.slice(1);
-  try {
-    const published = clean2(await deps.run("npm", ["view", `@mutmutco/cli@${version}`, "version", "--json"]));
-    if (published) {
-      throw new Error(`release --abort: @mutmutco/cli@${version} is already published; ${tag} cannot be reused`);
-    }
-    throw new Error("npm registry returned an empty successful response");
-  } catch (error) {
-    const detail = `${error instanceof Error ? error.message : String(error)} ${String(error.stderr ?? "")}`;
-    if (!/E404|not found|No match found/i.test(detail)) {
-      if (/already published/.test(detail)) throw error;
-      throw new Error(`release --abort: npm publish absence could not be proven (${detail.trim()}); nothing was written`);
-    }
-  }
+  const npmPackage = resolveReleaseAbortNpmPackage(meta, ctx.repo);
+  await proveNpmVersionUnpublished(deps, npmPackage, version, tag);
   await runGitPush(deps, ["push", "origin", "--delete", tag]);
   if (await probeRemoteTag(deps, tag)) {
     throw new Error(`release --abort: origin still reports ${tag} after deletion; local state was preserved`);
@@ -17710,7 +17740,7 @@ async function runTrainApplyPipeline(mode, input) {
       const releaseSha3 = requireValue(clean2(await deps.run("git", ["rev-parse", "main"])), "release sha");
       return { versionFold: versionFold3, releaseSha: releaseSha3 };
     });
-    const { checks: checks2, releaseUrl: releaseUrl2, announceNote: announceNote2, dispatch: d2 } = await completeMainRelease(deps, ctx, meta, deployModel2, watch, options, tag2, releaseSha2, "development", preFold2, tagProbe2);
+    const { checks: checks2, releaseUrl: releaseUrl2, announceNote: announceNote2, dispatch: d2 } = await completeMainRelease(deps, ctx, meta, deployModel2, watch, options, tag2, releaseSha2, "development", preFold2, tagProbe2, branchHints);
     const devRollForward2 = await rollDevelopmentForward(deps, ctx, tag2);
     if (directTrack) {
       return {
@@ -17797,7 +17827,7 @@ async function runTrainApplyPipeline(mode, input) {
     const releaseSha2 = requireValue(clean2(await deps.run("git", ["rev-parse", "main"])), "release sha");
     return { versionFold: versionFold2, releaseSha: releaseSha2 };
   });
-  const { checks, releaseUrl, announceNote, dispatch: d } = await completeMainRelease(deps, ctx, meta, deployModel, watch, options, tag, releaseSha, "rc", preFold, tagProbe);
+  const { checks, releaseUrl, announceNote, dispatch: d } = await completeMainRelease(deps, ctx, meta, deployModel, watch, options, tag, releaseSha, "rc", preFold, tagProbe, branchHints);
   const retirement = await retireRcRuntime(deps, ctx, deployModel, d.deployStatus, releasedRcSha);
   const devRollForward = await rollDevelopmentForward(deps, ctx, tag);
   const rcAlignment = await alignRcForward(deps, ctx, tag);
@@ -26381,17 +26411,28 @@ async function gcRepoIndexCloud(deps) {
       { attempts: 1, timeoutMs, sleep: deps.retrySleep }
     );
     const body = await res.json().catch(() => ({}));
-    if (!res.ok) return { ok: false, error: body.error ?? `gc HTTP ${res.status}` };
+    if (!res.ok) {
+      const detail = typeof body.error === "string" ? body.error : `gc HTTP ${res.status}`;
+      return { ok: false, error: detail };
+    }
+    if (body.ok === false) {
+      return { ok: false, error: typeof body.error === "string" ? body.error : "repo-index gc failed" };
+    }
     const removed = Array.isArray(body.removed) ? body.removed.filter((repo) => typeof repo === "string") : [];
     const kept = Number(body.kept);
+    const pendingRepos = Array.isArray(body.pendingRepos) ? body.pendingRepos.filter((repo) => typeof repo === "string") : void 0;
+    const repoErrors = body.repoErrors && typeof body.repoErrors === "object" && !Array.isArray(body.repoErrors) ? Object.fromEntries(Object.entries(body.repoErrors).filter((entry) => typeof entry[1] === "string")) : void 0;
     return {
       ok: true,
+      ...body.partial === true ? { partial: true } : {},
       removed,
       kept: Number.isFinite(kept) ? kept : 0,
       v4: {
         dryRun: body.v4?.dryRun === true,
         repos: normalizeGcV4Repos(body.v4?.repos)
-      }
+      },
+      ...pendingRepos?.length ? { pendingRepos } : {},
+      ...repoErrors && Object.keys(repoErrors).length ? { repoErrors } : {}
     };
   } catch (e) {
     const msg = e.message || String(e);
@@ -35423,6 +35464,7 @@ Next command: ${report.nextCommand}`);
 // src/explain-command.ts
 init_cli_shared();
 init_error_codes();
+init_house_map();
 var LOOP_PLAYBOOKS = {
   agent: {
     title: "Agent",
@@ -35613,7 +35655,50 @@ function explainCommandManifest(manifest, command, opts = {}) {
     }
   };
 }
+function houseEntryAsChild(entry, house) {
+  return {
+    name: entry.path.split(" ").pop() ?? entry.path,
+    path: entry.canonical,
+    flat_path: entry.path,
+    house,
+    canonical: entry.canonical,
+    ...entry.description ? { description: entry.description } : {},
+    arguments: [],
+    options: [],
+    subcommands: [],
+    category: "core",
+    discovery: "primary",
+    help_group: "Plan and work",
+    module_owner: "unclassified",
+    consumer: "unclassified"
+  };
+}
+function houseRootAsParent(manifest, house) {
+  const subcommands = house.commands.map(
+    (entry) => findCommandInManifest(manifest, entry.canonical) ?? houseEntryAsChild(entry, house.root)
+  );
+  return {
+    name: house.root,
+    path: house.root,
+    flat_path: house.root,
+    house: house.root,
+    canonical: house.root,
+    description: HOUSE_QUESTIONS[house.root],
+    arguments: [],
+    options: [],
+    subcommands,
+    category: "core",
+    discovery: "primary",
+    help_group: "Plan and work",
+    module_owner: "unclassified",
+    consumer: "unclassified"
+  };
+}
 function findCommandInManifest(manifest, commandPath3) {
+  if (isHouseRoot(commandPath3)) {
+    const house = manifest.houses.find((entry) => entry.root === commandPath3);
+    return house ? houseRootAsParent(manifest, house) : void 0;
+  }
   const visit = (command) => {
     if (command.path === commandPath3 || command.flat_path === commandPath3) return command;
     for (const child2 of command.subcommands) {
@@ -40687,6 +40772,13 @@ repoIndex.command("gc").description("remove v4 cloud authority material for repo
     console.log(
       `repo-index: gc tombstoned ${res.removed.length} orphan authorit${res.removed.length === 1 ? "y" : "ies"}, removed ${artifactsRemoved} artifact(s); kept ${res.kept} authorit${res.kept === 1 ? "y" : "ies"}, ${artifactsKept} artifact(s)`
     );
+    if (res.partial) {
+      const pending = res.pendingRepos?.length ?? 0;
+      const errors = res.repoErrors ? Object.keys(res.repoErrors).length : 0;
+      console.warn(
+        `repo-index: gc partial \u2014 ${pending} repo(s) pending${errors ? `, ${errors} repo error(s)` : ""}; retry gc until pendingRepos is empty`
+      );
+    }
   } catch (e) {
     return await failGraceful(e.message);
   }
@@ -42714,7 +42806,7 @@ for (const commandName of ["rcand", "release"]) {
     { flags: "--announce-summary-file <path>", description: "agent-curated 3-6 line Hub Slack summary; required for a new MMI-Hub --apply (#883/#3901)" },
     { flags: "--ack <shas>", description: "comma-separated dev shas a human verified are in the candidate, overriding the hotfix-coverage guard for a conflicted port whose -x trailer was lost (#958)" },
     { flags: "--dev", description: "full-track repos release development -> main directly, skipping rc (refuses if rc carries content not in development; no-op on direct-track repos) (#1062)" },
-    { flags: "--abort", description: "with --apply, delete only a proven unpublished failed Hub tag and restore local main for a clean recut (#3944)" },
+    { flags: "--abort", description: "with --apply, delete only a proven unpublished failed release tag on MMI-Hub or an eligible direct-track registry-publish repo and restore local main for a clean recut (#3944/#5650)" },
     { flags: "--retry-publish <run-id>", description: "with --apply, retry failed jobs of one proven Hub publish release run (#3949)" }
   ];
   for (const f of RELEASE_ONLY_FLAGS) {
@@ -42740,7 +42832,7 @@ for (const commandName of ["rcand", "release"]) {
       return fail(`${commandName}: --announce-summary-file applies only to release \u2014 rcand posts no Hub Slack announcement. Run: mmi-cli devops release --announce-summary-file <path>`);
     }
     if (o.abort && commandName !== "release") {
-      return fail(`${commandName}: --abort applies only to release \u2014 it rolls back a proven unpublished Hub release tag. Run: mmi-cli devops release --abort --apply`);
+      return fail(`${commandName}: --abort applies only to release \u2014 it rolls back a proven unpublished release tag. Run: mmi-cli devops release --abort --apply`);
     }
     if (o.retryPublish && commandName !== "release") {
       return fail(`${commandName}: --retry-publish applies only to release. Run: mmi-cli devops release --retry-publish <run-id> --apply --watch`);

package/package.json

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