@mutmutco/cli 4.3.34 → 4.3.36

package/dist/main.cjs

@@ -15617,10 +15617,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.34",
-    tag: "v4.3.34",
-    commit: "09818c6f3de7",
-    npm: "@mutmutco/cli@4.3.34"
+    version: "4.3.36",
+    tag: "v4.3.36",
+    commit: "6309473a245d",
+    npm: "@mutmutco/cli@4.3.36"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -15637,14 +15637,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v4.3.34"
+          v3Target: "v4.3.36"
         }
       ],
       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.34 and redeploy the Hub Lambda from tag v4.3.34 (09818c6f3de7); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v4.3.34 (@mutmutco/cli@4.3.34, tag commit 09818c6f3de7 \u2014 last known-good release carrying the repo-index v4-only contract)"
+        mechanism: "npm dist-tag latest -> 4.3.36 and redeploy the Hub Lambda from tag v4.3.36 (6309473a245d); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v4.3.36 (@mutmutco/cli@4.3.36, tag commit 6309473a245d \u2014 last known-good release carrying the repo-index v4-only contract)"
       }
     },
     {
@@ -21625,6 +21625,17 @@ async function runTrainDoctor(input) {
       } catch (e) {
         add({ code: "contexts-not-tag-addressable", severity: "blocker", source: "local", title: `required ${stage} check(s) cannot materialize on a tag push (#5428)`, remedy: message(e) });
       }
+      if (startBranch) {
+        const tip = await git3(["rev-parse", "--verify", "--quiet", `refs/remotes/origin/${startBranch}`]);
+        const checkRuns = JSON.parse(await train.run("gh", ["api", `repos/${repo}/commits/${tip}/check-runs`, "--jq", TRAIN_CHECK_RUNS_JQ]));
+        const statuses = JSON.parse(await train.run("gh", ["api", `repos/${repo}/commits/${tip}/status`, "--jq", TRAIN_COMMIT_STATUS_JQ]));
+        const observed = required.filter((c) => checkRuns.some((r) => r.name === c) || statuses.some((s) => s.context === c));
+        const red = observed.filter((c) => resolveContextState(c, checkRuns, statuses) === "failed");
+        const inFlight = observed.filter((c) => resolveContextState(c, checkRuns, statuses) === "pending");
+        const at = `${startBranch}@${tip.slice(0, 12)}`;
+        if (red.length) add({ code: "required-check-red", severity: "blocker", source: "origin", title: `required ${stage} check(s) failed on the lane's start branch tip: ${red.join(", ")} at ${at}`, remedy: `--heal never clears this one \u2014 a red trunk needs a fix, not a heal: land the failure's fix on ${startBranch} through a CI-gated PR, then rerun once its run is green (#6461)` });
+        else if (inFlight.length) add({ code: "required-check-red", severity: "warning", source: "origin", title: `required ${stage} check(s) still in flight on the lane's start branch tip: ${inFlight.join(", ")} at ${at}`, remedy: `wait for the run to conclude and rerun \u2014 the tip's verdict is not known yet, and the train would tag before it is` });
+      }
     }
   } catch (e) {
     unverified(`required status checks on ${stage}`, e);
@@ -25684,13 +25695,13 @@ function invalidateStatuslineBoardCache() {
 function refuseRateLimited(e, json) {
   if (!isRateLimitedError(e)) return false;
   if (json) console.log(JSON.stringify(e.receipt));
-  else console.error(`mmi-cli board claim failed: ${e.receipt.message} \u2014 retry: ${e.receipt.retryCommand}`);
+  else console.error(`mmi-cli oracle board claim failed: ${e.receipt.message} \u2014 retry: ${e.receipt.retryCommand}`);
   process.exitCode = 1;
   return true;
 }
 function refuseNotClaimable(e, json) {
   if (!isNotClaimable(e)) return false;
-  const message2 = `board claim failed: ${e.message}`;
+  const message2 = `oracle board claim failed: ${e.message}`;
   if (json) {
     console.log(formatErrorEnvelope(message2, {
       code: ERROR_CODES.ERR_STATE_CONFLICT,
@@ -25765,7 +25776,7 @@ function registerBoardCommands(program3) {
   board.command("read", { isDefault: true }).alias("list").description("read the board and print user-owned, claimable, and taken items").option("--json", "machine-readable output").option("--repo <owner/repo>", "current repo (defaults to git origin)").option("--direct", "bypass the Hub snapshot and read the live board through direct GitHub GraphQL").option("--bundle-details", "fetch body/comments only for user-owned and claimable issues").option("--bodies", "fetch body/comments for EVERY scoped row, including taken and unowned in-flight ones \u2014 for consumers that scope by Status rather than ownership (#4861); implies --bundle-details and costs one extra read per row").option("--allow-partial", "return partial board results when later page/detail reads fail").option("--out <path>", "write the output to this file as UTF-8 (no BOM) instead of stdout \u2014 the shell-free receipt path (#5802)").addHelpText("after", "\nread is always the authoritative live GitHub Project v2 board (#4926).\n--direct skips the Hub snapshot and uses the existing direct GitHub GraphQL read immediately.\n--allow-partial applies to the paginated path and detail reads.\n\nNever capture the JSON with a shell redirect on Windows: PowerShell 5.1's `> file.json` is Out-File,\nwhich writes UTF-16LE with a BOM, and Node reading it as 'utf8' then fails JSON.parse at position 1\n(#5802). Use --out instead \u2014 the CLI writes the file itself as UTF-8:\n  mmi-cli oracle board read --json --out .jerv/tmp/board.json\n").action((o) => runBoardRead(o));
   withExamples(mutating(
     board.command("claim <issues...>").description("claim issues: assign them and move their Project v2 Status to In Progress \u2014 idempotent, so an item already yours and In Progress succeeds unchanged (one or more refs); the board scan rides the Hub snapshot, same as board read").addHelpText("after", "\nclaim reads the board through the same Hub snapshot leg as `board read` (the App-installation\ncredential, never your personal GraphQL pool); the direct user-auth read is an emergency fallback\nand is named in a Warning line after the verdict (#6162).\n\nevery claim stamps a lane-identity marker comment on the issue (`<!-- mmi-claim: \u2026 -->`,\nsurface/session@host) so other agents can attribute the hold (#3727). The session is the\nhost-exported id when the surface provides one, otherwise a per-process `synth-` fallback \u2014\na claim is never anonymous (#5245). `board show`, doctor and unclaim read the latest marker.\n\nsame-owner resume (#6035): when the prior marker was posted by YOUR login on THIS host and its\nlocal session is verifiably dead (transcript probe), the claim proceeds as a resume without\n--force and names the evidence. A live, foreign-host, or unprobeable prior lane still refuses.\n\nreclaim from In Review (#6339): an In Review item with no holder, or one held by the claiming\nlogin, is claimable \u2014 it moves back to In Progress and the receipt names the status it came from.\nAn In Review item another login holds is refused (ask the holder, or wait for the review to land),\nand Done stays refused. The board status is the authority; no PR state is consulted.\n").option("--json", "machine-readable output").option("--repo <owner/repo>", "current repo for local issue numbers (defaults to git origin)").option("--for <login>", "assign to this login instead of @me \u2014 agent claims on behalf of the master").option("--force", "take an item already claimed by another lane that shows live evidence of active work (#3727)").option("--check", "read-only: run every claim gate and report the verdict, writing nothing \u2014 exits 1 with the same refusal a real claim would raise (#4511)").option("--allow-partial", "return success JSON if assignment succeeds but the status move fails"),
-    (_opts, args) => ({ command: "board claim", issues: args[0] ?? [] })
+    (_opts, args) => ({ command: "oracle board claim", issues: args[0] ?? [] })
   ).action(async (issueRefs, o) => {
     if (issueRefs.length === 1) {
       const issueRef = issueRefs[0];
@@ -25787,7 +25798,7 @@ function registerBoardCommands(program3) {
       } catch (e) {
         if (refuseRateLimited(e, o.json)) return;
         if (refuseNotClaimable(e, o.json)) return;
-        return failGraceful(`board claim failed: ${e.message}`);
+        return failGraceful(`oracle board claim failed: ${e.message}`);
       }
       return;
     }
@@ -25815,7 +25826,7 @@ function registerBoardCommands(program3) {
       if (bulk.failed > 0) process.exitCode = 1;
     } catch (e) {
       if (refuseRateLimited(e, o.json)) return;
-      return failGraceful(`board claim failed: ${e.message}`);
+      return failGraceful(`oracle board claim failed: ${e.message}`);
     }
   }), [
     "mmi-cli oracle board claim 2680",
@@ -25827,7 +25838,9 @@ function registerBoardCommands(program3) {
     "Multiple refs are handled as a batch and return per-item results.",
     "--check is the live gate read (it calls GitHub); --dry-run only echoes the parsed argv plan.",
     // #5552: agents guess `oracle issue claim`; that route does not exist — board claim is the only write.
-    "Never run `oracle issue claim` \u2014 claims are board mutations; only `oracle board claim <ref>` is valid."
+    "Never run `oracle issue claim` \u2014 claims are board mutations; only `oracle board claim <ref>` is valid.",
+    // Flat Wave 0 alias: agents still type `mmi-cli board claim` and treat the refusal as a tool fault.
+    "Never run the flat `board claim` \u2014 that Wave 0 alias was removed; only `mmi-cli oracle board claim <ref>` parses."
   ]);
   board.command("show <issue>").description("print one board item (status, assignees, type, url) with its body and comments").option("--json", "machine-readable output").option("--repo <owner/repo>", "current repo for local issue numbers (defaults to git origin)").option("--allow-partial", "return the item even if its body/comments fetch fails").option("--out <path>", "write the output to this file as UTF-8 (no BOM) instead of stdout \u2014 the shell-free receipt path (#5802)").action(async (issueRef, o) => {
     try {
@@ -32468,7 +32481,7 @@ var LOOP_PLAYBOOKS = {
       { label: "Read the next board item", command: "mmi-cli oracle board read" },
       // #5552: claim is a board mutation only — never guess `oracle issue claim`. Ground unknown write
       // routes with `mmi-cli commands` / `mmi-cli explain` before invoking them.
-      { label: "Claim board work (board mutation only \u2014 never `oracle issue claim`; ground unknown write routes via `commands` / `explain` first)", command: "mmi-cli oracle board claim <ref>" },
+      { label: "Claim board work (board mutation only \u2014 never `oracle issue claim` or the flat `board claim`; ground unknown write routes via `commands` / `explain` first)", command: "mmi-cli oracle board claim <ref>" },
       { label: "Prepare the local workspace through the host surface" },
       { label: "Before broad docs rewrites, follow docs/Guides/doc-ceremony-cut.md" },
       { label: "Apply the repository test policy, then build the touched package", command: "mmi-cli tests policy --base origin/development && npm run build" },
@@ -32485,7 +32498,7 @@ var LOOP_PLAYBOOKS = {
     steps: [
       { label: "Orient in the current repository", command: "mmi-cli onboard" },
       { label: "Read the board item", command: "mmi-cli oracle board show <issue-number>" },
-      { label: "Claim the item (board mutation only \u2014 never `oracle issue claim`)", command: "mmi-cli oracle board claim <issue-number>" },
+      { label: "Claim the item (board mutation only \u2014 never `oracle issue claim` or the flat `board claim`)", command: "mmi-cli oracle board claim <issue-number>" },
       { label: "Prepare the local workspace through the host surface" },
       { label: "Start a local stage (deployable repos)", command: "mmi-cli stage run --apply" }
     ]
@@ -39707,7 +39720,7 @@ function registerCollaborationCommands(program3) {
   function surfaceWaived() {
     return rawFlag("--no-surface");
   }
-  const issue = program3.command("issue").description("issues \u2014 create and view with structured JSON (view; show, get and read alias view for board-verb/gh-shaped callers). Claims are board mutations: use `oracle board claim`, never `oracle issue claim`");
+  const issue = program3.command("issue").description("issues \u2014 create and view with structured JSON (view; show, get and read alias view for board-verb/gh-shaped callers). Claims are board mutations: use `oracle board claim`, never `oracle issue claim` or the flat `board claim`");
   withExamples(mutating(
     issue.command("create").description("create an issue (type \u2014 label) and print {number,url,label} JSON").addOption(new Option("--type <type>", "bug | feature | task (sets the matching label; required unless --batch)").choices([...ISSUE_TYPES])).option("--title <title>", "issue title").option("--title-file <path|->", "read the issue title from a UTF-8 file, or from stdin with -").option("--body <body>", "issue body (markdown)").option("--body-file <path|->", "read issue body from a UTF-8 file. `-` (stdin) needs a heredoc, which the agent inline-body guard denies (#1473/#2125) \u2014 prefer a real path; a title with backticks needs --title-file for the same reason (#3381)").option("--priority <priority>", "urgent | high | medium | low (defaults to medium; sets the board Priority field only \u2014 never a priority:* label, #416)").option("--repo <owner/repo>", "target repo (defaults to the current repo)").option("--label <label...>", "extra label(s) to attach (repeatable; auto-created if missing)").option("--surface <surface>", "issue surface, with or without the surface: prefix (#3789). Required when the target repo runs the one-surface-label board rule; any value satisfies it, so this is not a closed enum").option("--no-surface", "file without a surface label on a repo that requires one \u2014 for a genuinely exempt filing (e.g. a coop proof issue that spans every surface)").option("--parent <ref>", "file as a native sub-issue of this parent (#123, owner/repo#123, or URL)").option("--no-related", "skip the auto related-issues comment"),
     // --dry-run/--validate-only plan: resolve the same title source and validate the same type, priority,

package/package.json

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