@mutmutco/cli 4.3.28 → 4.3.30

package/dist/main.cjs

@@ -11896,7 +11896,10 @@ function laneResumeEvidence(evidence) {
   return `prior claim by lane ${describeClaimMarker(evidence.marker)} (@${evidence.markerBy}, ${formatClaimAge(evidence.markerAgeMs)} old) is verifiably not running on this host \u2014 its local session transcript is gone or stale${artifacts.length ? `; resuming over ${artifacts.join("; ")}` : ""}`;
 }
 async function checkLaneContest(client, item, actor = describeSessionIdentity(), viewerLogin) {
-  const evidence = await gatherClaimLiveness(client, item.repository, item.number, openPullsFetcher(client));
+  let evidence = await gatherClaimLiveness(client, item.repository, item.number, openPullsFetcher(client));
+  if (evidence.failed.some((channel) => channel !== "session")) {
+    evidence = await gatherClaimLiveness(client, item.repository, item.number, openPullsFetcher(client));
+  }
   const ownership = laneOwnership(evidence.marker, actor);
   const sameOwner = Boolean(viewerLogin && evidence.markerBy && evidence.markerBy.toLowerCase() === viewerLogin.toLowerCase());
   const resume = ownership !== "mine" && sameOwner ? laneResumeEvidence(evidence) : void 0;
@@ -15581,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.28",
-    tag: "v4.3.28",
-    commit: "9a58493b4404",
-    npm: "@mutmutco/cli@4.3.28"
+    version: "4.3.30",
+    tag: "v4.3.30",
+    commit: "a8f898264f6e",
+    npm: "@mutmutco/cli@4.3.30"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -15601,14 +15604,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.3.28"
+          v3Target: "v4.3.30"
         }
       ],
       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.28 and redeploy the Hub Lambda from tag v4.3.28 (9a58493b4404); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.3.28 (@mutmutco/cli@4.3.28, tag commit 9a58493b4404 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.3.30 and redeploy the Hub Lambda from tag v4.3.30 (a8f898264f6e); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.3.30 (@mutmutco/cli@4.3.30, tag commit a8f898264f6e \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -16473,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) {
@@ -16588,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 });
@@ -16620,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 });
@@ -21290,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) {
@@ -21393,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;
@@ -23644,6 +23658,12 @@ function refPatternCovers(pattern, ref) {
 function uncoveredTrackBranches(liveIncludes, trackBranches) {
   return trackBranches.filter((branch) => !liveIncludes.some((pattern) => refPatternCovers(pattern, `refs/heads/${branch}`)));
 }
+function unreachableTrackBranches(uncovered, requiredContexts, emittedByBranch) {
+  return uncovered.filter((branch) => {
+    const emitted = emittedByBranch[branch];
+    return emitted !== void 0 && !requiredContexts.every((context) => emitted.includes(context));
+  });
+}
 function rulesetCoversReleaseBranches(payload, track) {
   const conditions = payload.conditions;
   const include = conditions?.ref_name?.include;
@@ -23945,14 +23965,19 @@ async function auditRepoCi(repo, deps) {
       }
     }
     if (productRuleset != null) {
-      const missingTrackBranches = [];
+      const presentTrackBranches = [];
       for (const branch of uncoveredTrackBranches(liveBranchIncludes, branchesForTrack(resolveReleaseTrack(meta, void 0, repo)))) {
-        if (await branchPresence(deps, repo, branch) === true) missingTrackBranches.push(branch);
+        if (await branchPresence(deps, repo, branch) === true) presentTrackBranches.push(branch);
       }
+      const emittedByTrackBranch = {};
+      for (const branch of presentTrackBranches) emittedByTrackBranch[branch] = await resolveEmittedPrContexts(deps, repo, branch);
+      const toleratedTrackBranches = unreachableTrackBranches(presentTrackBranches, liveContexts, emittedByTrackBranch);
+      const missingTrackBranches = presentTrackBranches.filter((branch) => !toleratedTrackBranches.includes(branch));
+      const toleratedNote = toleratedTrackBranches.length ? ` (tolerated until first release: [${toleratedTrackBranches.join(", ")}] \u2014 their trees cannot emit every one of [${liveContexts.join(", ")}], #6385)` : "";
       checks.push({
         ok: missingTrackBranches.length === 0,
         label: RULESET_TRACK_SCOPE_LABEL,
-        detail: missingTrackBranches.length ? `live ${PRODUCT_RULESET_NAME} includes [${liveBranchIncludes.join(", ")}] but the release track also requires [${missingTrackBranches.join(", ")}] \u2014 those branches tag and merge with no required check` : void 0,
+        detail: missingTrackBranches.length ? `live ${PRODUCT_RULESET_NAME} includes [${liveBranchIncludes.join(", ")}] but the release track also requires [${missingTrackBranches.join(", ")}] \u2014 those branches tag and merge with no required check${toleratedNote}` : toleratedNote ? toleratedNote.trim().replace(/^\(|\)$/g, "") : void 0,
         remediation: missingTrackBranches.length ? `mmi-cli oracle org project set ${repo} --var requiredCheckBranches=${JSON.stringify(branchesForTrack(resolveReleaseTrack(meta, void 0, repo)))} then mmi-cli devops bootstrap apply ${repo} --execute` : void 0
       });
     }
@@ -27593,7 +27618,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")
             }]
           });
         }
@@ -40040,7 +40065,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;
@@ -43293,7 +43319,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.28",
+  "version": "4.3.30",
   "description": "MMI Future CLI — the org dev toolbox and shared cross-IDE engine for every registry-declared MMI coding surface.",
   "type": "module",
   "license": "UNLICENSED",