@mutmutco/cli 4.3.29 → 4.3.31

package/dist/main.cjs

@@ -15584,10 +15584,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.29",
-    tag: "v4.3.29",
-    commit: "5a5b64c2d604",
-    npm: "@mutmutco/cli@4.3.29"
+    version: "4.3.31",
+    tag: "v4.3.31",
+    commit: "d171389927fd",
+    npm: "@mutmutco/cli@4.3.31"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -15604,14 +15604,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.3.29"
+          v3Target: "v4.3.31"
         }
       ],
       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.29 and redeploy the Hub Lambda from tag v4.3.29 (5a5b64c2d604); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.3.29 (@mutmutco/cli@4.3.29, tag commit 5a5b64c2d604 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.3.31 and redeploy the Hub Lambda from tag v4.3.31 (d171389927fd); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.3.31 (@mutmutco/cli@4.3.31, tag commit d171389927fd \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -16476,6 +16476,13 @@ function validateEnum(flag, allowed, value, command) {
   }
   return v;
 }
+function caseInsensitiveChoices(option, allowed) {
+  return option.choices(allowed).argParser((value) => {
+    const folded = value.toLowerCase();
+    if (!allowed.includes(folded)) throw new InvalidArgumentError(`Allowed choices are ${allowed.join(", ")}.`);
+    return folded;
+  });
+}
 var ISSUE_STATES = ["open", "closed", "all"];
 var PR_STATES = ["open", "all"];
 async function resolveBoardProjectId(repoOption) {
@@ -16591,7 +16598,7 @@ function registerQueryCommands(program3) {
   const project2 = program3.commands.find((c) => c.name() === "project");
   if (!issue || !pr) return;
   const deps = queryDeps();
-  issue.command("list").description("bounded issue read \u2014 filter by text, label, state, or assignee; always prints JSON").option("--label <label>", "filter by label").option("--search <query>", "free-text issue search").addOption(new Option("--state <state>", "open | closed | all").default("open").choices(ISSUE_STATES)).option("--assignee <login>", "filter by assignee login").option("--limit <n>", "max issues to return (capped at 100)", (v) => Number(v), DEFAULT_LIMIT).option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json", "machine-readable output (already the default \u2014 accepted for contract uniformity)").action(async (o) => {
+  issue.command("list").description("bounded issue read \u2014 filter by text, label, state, or assignee; always prints JSON").option("--label <label>", "filter by label").option("--search <query>", "free-text issue search").addOption(caseInsensitiveChoices(new Option("--state <state>", "open | closed | all").default("open"), ISSUE_STATES)).option("--assignee <login>", "filter by assignee login").option("--limit <n>", "max issues to return (capped at 100)", (v) => Number(v), DEFAULT_LIMIT).option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json", "machine-readable output (already the default \u2014 accepted for contract uniformity)").action(async (o) => {
     try {
       const state = validateEnum("--state", ISSUE_STATES, o.state, "issue list");
       const rows = await runIssueList(deps, { label: o.label, search: o.search, state, assignee: o.assignee, limit: o.limit, repo: o.repo });
@@ -16623,7 +16630,7 @@ function registerQueryCommands(program3) {
       queryFail("issue frontier", e);
     }
   });
-  pr.command("list").description("bounded PR read \u2014 --mine scopes to the viewer's own PRs (resolves the viewer via gh); always prints JSON").option("--mine", "only the caller's own PRs (resolves the viewer via `gh api user`)").addOption(new Option("--state <state>", "open | all").default("open").choices(PR_STATES)).option("--limit <n>", "max PRs to return (capped at 100)", (v) => Number(v), DEFAULT_LIMIT).option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json", "machine-readable output (already the default \u2014 accepted for contract uniformity)").action(async (o) => {
+  pr.command("list").description("bounded PR read \u2014 --mine scopes to the viewer's own PRs (resolves the viewer via gh); always prints JSON").option("--mine", "only the caller's own PRs (resolves the viewer via `gh api user`)").addOption(caseInsensitiveChoices(new Option("--state <state>", "open | all").default("open"), PR_STATES)).option("--limit <n>", "max PRs to return (capped at 100)", (v) => Number(v), DEFAULT_LIMIT).option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json", "machine-readable output (already the default \u2014 accepted for contract uniformity)").action(async (o) => {
     try {
       const state = validateEnum("--state", PR_STATES, o.state, "pr list");
       const rows = await runPrList(deps, { mine: o.mine, state, limit: o.limit, repo: o.repo });
@@ -21293,6 +21300,10 @@ async function selfConvergeTrainCli(input) {
 // src/train-doctor.ts
 var TRAIN_LANES = ["release", "rcand", "hotfix"];
 var TROUBLESHOOTING_GUIDE = "docs/Guides/train-troubleshooting.md";
+var TROUBLESHOOTING_GUIDE_URL = `https://github.com/mutmutco/MMI-Hub/blob/development/${TROUBLESHOOTING_GUIDE}`;
+function troubleshootingAnchor(code) {
+  return `${TROUBLESHOOTING_GUIDE_URL}#${code}`;
+}
 var SCRATCH_BRANCH_GLOBS = ["train/check/*", "hotfix-fold/*--port-*"];
 var COMPOSE_GUARD_HARD_FAIL = /^secrets preflight: .*noEnvFile is (not )?true.*$/m;
 function readOriginWorkflowsDefault(root, ref) {
@@ -21396,7 +21407,7 @@ async function runTrainDoctor(input) {
   const findings = [];
   let originUnverified = false;
   const add = (f) => {
-    findings.push({ ...f, anchor: `${TROUBLESHOOTING_GUIDE}#${f.code}` });
+    findings.push({ ...f, anchor: troubleshootingAnchor(f.code) });
   };
   const unverified = (what, e) => {
     originUnverified = true;
@@ -22594,6 +22605,29 @@ async function latestRemoteRcTag(deps) {
   const tag = [...tags.keys()].sort(compareRcTagsNewestFirst)[0];
   return tag ? { tag, sha: tags.get(tag) } : void 0;
 }
+async function activeRcandLedgerCandidate(deps, cwd) {
+  let path2;
+  try {
+    path2 = releaseLedgerPath(cwd);
+  } catch {
+    return void 0;
+  }
+  let prior;
+  try {
+    prior = parseReleaseLedger((0, import_node_fs24.readFileSync)(path2, "utf8"));
+  } catch {
+    return void 0;
+  }
+  if (prior.lane !== "rcand") return void 0;
+  let liveSha = "";
+  try {
+    liveSha = clean2(await runGitRemoteRead(deps, ["ls-remote", "origin", `refs/tags/${prior.tag}`])).split(/\s+/)[0] ?? "";
+  } catch {
+    return void 0;
+  }
+  if (liveSha.toLowerCase() !== prior.tagSha.toLowerCase()) return void 0;
+  return { tag: prior.tag, sha: prior.tagSha };
+}
 async function probeAncestor(deps, ancestor, descendant, label) {
   try {
     await deps.run("git", ["merge-base", "--is-ancestor", ancestor, descendant]);
@@ -22617,7 +22651,7 @@ async function runRcandResume(deps, options = {}) {
     throw new Error("rcand --resume: origin/rc does not exist \u2014 there is no candidate branch to resume");
   }
   const deployModel = await preflight(deps, ctx, "rc", meta);
-  const candidate = await latestRemoteRcTag(deps);
+  const candidate = await activeRcandLedgerCandidate(deps, process.cwd()) ?? await latestRemoteRcTag(deps);
   if (!candidate) {
     throw new Error("rcand --resume: no public v*-rc.* tag found on origin \u2014 there is no tagged candidate to resume");
   }
@@ -27607,7 +27641,7 @@ function registerBootstrapCommands(program3) {
               source: "origin",
               title: `bootstrap verify could not run train doctor: ${e.message}`,
               remedy: `run mmi-cli devops train doctor --lane ${lane} --repo ${repo} --json`,
-              anchor: "docs/Guides/train-troubleshooting.md#origin-unverified"
+              anchor: troubleshootingAnchor("origin-unverified")
             }]
           });
         }
@@ -40054,7 +40088,8 @@ ${list}`);
     "--head and --base default to the current branch and the repo default; only pass them to override.",
     "Use --body-file for multiline PR bodies instead of shell-escaped inline markdown.",
     "Write that file under .jerv/ inside the host workspace (#4405); host policy governs untracked files.",
-    'Keep closing keywords on a dedicated line ("Closes #N") \u2014 GitHub parses close/fix/resolve + #N even mid-sentence, so pr create rewrites such prose to "part of #N" (#6039).'
+    'Keep closing keywords on a dedicated line ("Closes #N") \u2014 GitHub parses close/fix/resolve + #N even mid-sentence, so pr create rewrites such prose to "part of #N" (#6039).',
+    'When acceptance is only provable AFTER deploy, link with "Part of #N", never "Closes" \u2014 a closing reference closes the issue and advances its board card to Done on merge, before the acceptance evidence exists. Close it on that evidence instead (#6407).'
   ]);
   pr.command("view <ref>").description("read a PR as structured JSON (merged state, head/base, URL, merge commit) \u2014 the mmi-cli read path (#2347). --comments folds in every comment; --context also adds linkedIssues (the issues it closes/references, #2894)").option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--json [fields...]", 'gh --json field list (overrides the default field set). Accepts commas, spaces, or repeated --json flags \u2014 in PowerShell an unquoted comma list is an array literal, so QUOTE it: --json "state,baseRefName,mergeCommit"').option("--comments", "include every comment (body + comments in one call) \u2014 read the whole PR before landing it (#2894)").option("--context", "full working context in one call: implies --comments and also adds linkedIssues (the issues the PR closes/references) (#2894)").action(async (ref, o) => {
     let parsed;
@@ -43307,7 +43342,7 @@ function readRepoVersion() {
 }
 function registerTrainCommands(program3, trainDeps) {
   const train = program3.command("train").description("release-train observability \u2014 track position, version lag, and the shared preflight-and-heal doctor (#2688, #6067)");
-  train.command("doctor").description("one shared preflight-and-heal verdict for the release, rcand and hotfix lanes; read-only unless --heal (#6067)").addOption(new Option("--lane <lane>", "train lane to check (defaults from the release track: direct \u2192 release)").choices([...TRAIN_LANES])).option("--dev", "judge the `release --dev` lane (development -> main, skipping rc): the lane starts from development and is read on development's workflows (#6318)").option("--heal", "repair safe local reconstructible state (scratch gitignore, churn, stray local tags, ff-only branch lag, finished scratch branches, stale alignment ledger leg)").option("--repo <owner/repo>", "target repo (defaults to the current checkout)").option("--json", "machine-readable output").addHelpText("after", "\nExit codes:\n  0  ready \u2014 no blocker and origin verified\n  1  a blocker remains, or origin could not be verified (never green on an unread origin)\n\nEvery finding carries code, severity (blocker|warning|healed|info), source (local|origin), remedy and a\ndocs/Guides/train-troubleshooting.md#<code> anchor. `release --apply` and `rcand --apply` run this at step 0 with --heal.\n").action(async (o) => {
+  train.command("doctor").description("one shared preflight-and-heal verdict for the release, rcand and hotfix lanes; read-only unless --heal (#6067)").addOption(new Option("--lane <lane>", "train lane to check (defaults from the release track: direct \u2192 release)").choices([...TRAIN_LANES])).option("--dev", "judge the `release --dev` lane (development -> main, skipping rc): the lane starts from development and is read on development's workflows (#6318)").option("--heal", "repair safe local reconstructible state (scratch gitignore, churn, stray local tags, ff-only branch lag, finished scratch branches, stale alignment ledger leg); it never clears a ledger-pending, ledger-failed or branch-mismatch blocker (#6404, #6401, #6399) \u2014 those need `mmi-cli devops release --resume` (or, with fresh approval, `--abort --apply`) and `git checkout <start branch>`, so exit 1 after --heal is the gate working, not a failed heal").option("--repo <owner/repo>", "target repo (defaults to the current checkout)").option("--json", "machine-readable output").addHelpText("after", "\nExit codes:\n  0  ready \u2014 no blocker and origin verified\n  1  a blocker remains, or origin could not be verified (never green on an unread origin)\n\nEvery finding carries code, severity (blocker|warning|healed|info), source (local|origin), remedy and a\ndocs/Guides/train-troubleshooting.md#<code> anchor. `release --apply` and `rcand --apply` run this at step 0 with --heal.\n").action(async (o) => {
     try {
       if (o.dev && o.lane && o.lane !== "release") {
         return failGraceful(`train doctor: --dev applies only to the release lane \u2014 it names the development -> main variant that skips rc, which the ${o.lane} lane does not have`);

package/package.json

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