@mutmutco/cli 3.128.0 → 3.130.0

package/dist/main.cjs

@@ -16037,10 +16037,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: "3.128.0",
-    tag: "v3.128.0",
-    commit: "95241fa22be9",
-    npm: "@mutmutco/cli@3.128.0"
+    version: "3.130.0",
+    tag: "v3.130.0",
+    commit: "4092383c82be",
+    npm: "@mutmutco/cli@3.130.0"
   },
   exitCriterion: "fleet-n-of-n",
   hubOnlyShortcut: "forbidden",
@@ -16057,14 +16057,14 @@ var rollout_plan_default = {
           repo: "mutmutco/mmi-hub",
           role: "canary",
           schedule: "train",
-          v3Target: "v3.128.0"
+          v3Target: "v3.130.0"
         }
       ],
       rollbackTrigger: "Any red inside the post-cut soak window: `devops train gate` FAIL attributable to the v4 doors, Hub endpoint health probe failure, a v3 client refused while the compat window must still admit it (SUPPORTED_MINOR_WINDOW=2, MIN_CLIENT_VERSION 0.0.0 \u2014 D6a), or npm consumer install/doctor failure on the v4 dist.",
       rollback: {
         independent: true,
-        mechanism: "npm dist-tag latest -> 3.128.0 and redeploy the Hub Lambda from tag v3.128.0 (95241fa22be9); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
-        v3Target: "v3.128.0 (@mutmutco/cli@3.128.0, tag commit 95241fa22be9 \u2014 the preserved latest-v3 distribution, D6b)"
+        mechanism: "npm dist-tag latest -> 3.130.0 and redeploy the Hub Lambda from tag v3.130.0 (4092383c82be); installed clients repair via `mmi-cli doctor`. No other cohort is touched.",
+        v3Target: "v3.130.0 (@mutmutco/cli@3.130.0, tag commit 4092383c82be \u2014 the preserved latest-v3 distribution, D6b)"
       }
     },
     {
@@ -16253,7 +16253,7 @@ function formatTrainStatus(r) {
     "",
     `release track: ${r.releaseTrack} \u2014 stages: ${r.branches.join(" -> ")}`,
     `cli version: ${r.cliVersion}${r.repoVersion ? ` (repo: ${r.repoVersion})` : ""}${r.releasedVersion ? ` (released: ${r.releasedVersion})` : ""}`,
-    `release bump intent: ${r.bumpIntent ?? "not declared \u2014 set MMI_BUMP_INTENT=major|minor|patch before an ordinary train"}`
+    `release bump intent: ${r.bumpIntent ?? "not declared \u2014 an ordinary train defaults to patch (#4929); set MMI_BUMP_INTENT=major|minor to override"}`
   ];
   if (r.versionLag.ok) {
     lines.push("version lag: none \u2014 CLI is current");
@@ -17065,7 +17065,7 @@ async function runIssueViewContext(deps, opts) {
 }
 async function runPrViewContext(deps, opts) {
   let fields = opts.jsonFields;
-  if (opts.comments || opts.context) fields = ensureField(fields, "comments");
+  if (opts.comments || opts.context) fields = ensureField(ensureField(fields, "body"), "comments");
   if (opts.context) fields = ensureField(fields, "closingIssuesReferences");
   const base = await deps.ghJson(["pr", "view", String(opts.number), "--repo", opts.repo, "--json", fields], GH_LIST_TIMEOUT_MS);
   if (!opts.context) return base;
@@ -20417,21 +20417,7 @@ async function resolveTrainBumpIntent(deps, env = process.env) {
     }
     return explicit.major > latest.major ? "major" : explicit.minor > latest.minor ? "minor" : "patch";
   }
-  try {
-    return requireValue(
-      clean2(await deps.run("node", ["scripts/next-version.mjs", "intent"])),
-      "release bump intent"
-    );
-  } catch (e) {
-    const message = e instanceof Error ? e.message : String(e);
-    const usage = /usage: next-version\.mjs <([^>]+)>/.exec(message);
-    if (usage && !usage[1].split("|").includes("intent")) {
-      throw new Error(
-        `release bump intent: this repo's seeded scripts/next-version.mjs predates the \`intent\` verb (its usage lists <${usage[1]}>), so unset-intent derivation cannot run here. Declare the intent explicitly and rerun \u2014 MMI_BUMP_INTENT=major|minor|patch (or MMI_RELEASE_VERSION=X.Y.Z for an exact target); the train then resolves it in the CLI without shelling this script. The durable fix is refreshing the seeded script from the Hub via seed propagation.`
-      );
-    }
-    throw e;
-  }
+  return "patch";
 }
 async function runTrainApply(command, deps, options = {}) {
   const watch = options.watch ?? false;
@@ -22817,9 +22803,6 @@ var BOARD_GIT_TIMEOUT_MS = 1e4;
 var WRITE_PROBE_CONCURRENCY = 8;
 var CLAIM_CONCURRENCY = 5;
 var BOARD_ACTIVE_READ_MAX_PAGES = 100;
-var BOARD_PROJECTION_STALE_MS = 24 * 60 * 6e4;
-var BOARD_PROJECTION_RECONCILE_STALE_MS = 3 * 60 * 6e4;
-var BOARD_PROJECTION_TIMEOUT_MS = 8e3;
 var execFileP4 = (file, args, options = {}) => (
   // encoding 'utf8' guarantees string output at runtime; the cast pins the type (promisify's
   // overloads widen to string|Buffer when options is spread in).
@@ -23087,7 +23070,7 @@ function renderBoardItem(item) {
   return lines.join("\n");
 }
 function renderBoardReport(report) {
-  const lines = [`Board \xB7 ${report.project.title} \xB7 @${report.viewer}`, renderBoardSource(report)];
+  const lines = [`Board \xB7 ${report.project.title} \xB7 @${report.viewer}`, renderBoardSource()];
   renderScope(lines, "PRIMARY", report.repo, report.primary, report.viewer);
   renderScope(lines, "SECONDARY", "Other repos on this project", report.secondary, report.viewer);
   if (report.warnings.length) {
@@ -23191,132 +23174,13 @@ async function resolveWritableReposForClaimables(items, client) {
 function writableOrUnknown(writable) {
   return /* @__PURE__ */ new Set([...writable.repos, ...writable.unknown]);
 }
-async function defaultFetchBoardProjection(owner, number, baseUrl) {
-  if (!baseUrl) throw new Error("Hub API URL not configured");
-  const token = await hubAuthToken({ baseUrl, githubToken });
-  if (!token) throw new Error("no Hub session token");
-  const url = new URL("/board-projection", `${baseUrl.replace(/\/$/, "")}/`);
-  url.searchParams.set("owner", owner);
-  url.searchParams.set("number", String(number));
-  const res = await fetch(url, {
-    method: "GET",
-    headers: { ...clientVersionHeaders(), Authorization: `Bearer ${token}` },
-    signal: AbortSignal.timeout(BOARD_PROJECTION_TIMEOUT_MS)
-  });
-  if (res.status === 404) return null;
-  if (res.status === 426) throw new Error(upgradeRequiredError(res, await res.json().catch(() => null)));
-  if (!res.ok) throw new Error(`board projection HTTP ${res.status}`);
-  return await res.json();
-}
-function projectionItems(row) {
-  if (!row.items || typeof row.items !== "object" || Array.isArray(row.items)) {
-    throw new Error("malformed projection items");
-  }
-  const items = [];
-  for (const raw of Object.values(row.items)) {
-    if (!raw || typeof raw !== "object") throw new Error("malformed projection item");
-    if (raw.tombstone === true) continue;
-    const item = raw;
-    if (typeof item.itemId !== "string" || typeof item.contentId !== "string" || item.contentType !== "Issue" && item.contentType !== "PullRequest" || typeof item.repository !== "string" || typeof item.number !== "number" || !Number.isFinite(item.number) || typeof item.ref !== "string" || typeof item.url !== "string" || typeof item.title !== "string" || typeof item.state !== "string" || !BOARD_STATUSES.includes(item.status) || !Array.isArray(item.assignees) || item.assignees.some((value) => typeof value !== "string") || !Array.isArray(item.labels) || item.labels.some((value) => typeof value !== "string") || typeof item.sourceTimestamp !== "string") {
-      throw new Error("malformed projection item");
-    }
-    if (item.state.toUpperCase() === "CLOSED" || item.status === "Done") continue;
-    items.push(withLoopState({
-      itemId: item.itemId,
-      contentId: item.contentId,
-      contentType: item.contentType,
-      repository: item.repository,
-      number: item.number,
-      ref: item.ref,
-      url: item.url,
-      title: item.title,
-      state: item.state,
-      // #4441: the reconciler stamps each item's content updatedAt as sourceTimestamp — the same
-      // idle-age evidence the live read carries, so projection reads derive staleness too.
-      updatedAt: item.sourceTimestamp,
-      status: item.status,
-      statusOptionId: item.statusOptionId,
-      priority: item.priority,
-      priorityOptionId: item.priorityOptionId,
-      assignees: [...item.assignees],
-      labels: [...item.labels],
-      type: item.type
-    }));
-  }
-  return items;
-}
-async function readViewerLogin(client) {
-  const user = await client.rest("GET", "user");
-  if (!user?.login) throw new Error("viewer login unavailable");
-  return user.login;
-}
-function projectionFreshness(row, now) {
-  const projectedAtMs = Date.parse(row.watermark?.projectedAt);
-  const sourceTimestampMs = Date.parse(row.watermark?.sourceTimestamp);
-  if (!Number.isFinite(projectedAtMs) || !Number.isFinite(sourceTimestampMs)) {
-    throw new Error("malformed projection watermark");
-  }
-  const projectedAgeMs = Math.max(0, now - projectedAtMs);
-  const sourceAgeMs = Math.max(0, now - sourceTimestampMs);
-  return {
-    projectedAt: row.watermark.projectedAt,
-    projectedAgeMs,
-    sourceTimestamp: row.watermark.sourceTimestamp,
-    sourceAgeMs,
-    // #4774: health must agree with BOTH ages a caller can see on the source line — a projection whose
-    // rebuild (projectedAt) went stale is exactly as unreliable as one whose source events did, even
-    // while recent webhook activity keeps sourceAgeMs looking fresh.
-    health: row.watermark.health === "stale" || sourceAgeMs > BOARD_PROJECTION_STALE_MS || projectedAgeMs > BOARD_PROJECTION_RECONCILE_STALE_MS ? "stale" : "fresh"
-  };
-}
-function renderBoardSource(report) {
-  if (report.source === "projection" && report.freshness) {
-    return `source: projection \xB7 projected ${formatClaimAge(report.freshness.projectedAgeMs)} ago \xB7 source events through ${report.freshness.sourceTimestamp} \xB7 health ${report.freshness.health}`;
-  }
-  return `source: live${report.sourceReason ? ` (${report.sourceReason})` : ""}`;
+function renderBoardSource() {
+  return "source: live";
 }
 async function readBoard(options, deps = {}) {
   const cfg = resolveBoardConfig(options.config);
   const client = deps.client ?? defaultGitHubClient();
-  let collected;
-  let source = "live";
-  let freshness = null;
-  let sourceReason;
-  if (!options.live) {
-    try {
-      const baseUrl = options.config.sagaApiUrl;
-      const row = await (deps.fetchProjection ?? defaultFetchBoardProjection)(cfg.projectOwner, cfg.projectNumber, baseUrl);
-      if (!row) {
-        sourceReason = "projection absent";
-      } else if (row.schemaVersion !== 1) {
-        sourceReason = `unsupported projection schema ${String(row.schemaVersion)}`;
-      } else if (row.watermark?.health === "oversize") {
-        sourceReason = "projection oversize";
-      } else {
-        const [viewer, repo] = await Promise.all([
-          readViewerLogin(client),
-          resolveCurrentRepo(options, deps)
-        ]);
-        const now = (deps.now ?? Date.now)();
-        collected = {
-          items: projectionItems(row),
-          viewer,
-          repo,
-          projectId: cfg.projectId,
-          projectTitle: String(cfg.projectNumber),
-          warnings: [],
-          partial: false
-        };
-        freshness = projectionFreshness(row, now);
-        source = "projection";
-      }
-    } catch {
-      sourceReason = "projection read error";
-    }
-  }
-  if (!collected) {
-    collected = await collectBoardItems(cfg, { repo: options.repo, allowPartial: options.allowPartial, activeOnly: true }, deps);
-  }
+  const collected = await collectBoardItems(cfg, { repo: options.repo, allowPartial: options.allowPartial, activeOnly: true }, deps);
   const writable = await resolveWritableReposForClaimables(collected.items, client);
   collected.warnings.push(...writable.warnings);
   collected.partial = collected.partial || writable.partial;
@@ -23328,9 +23192,7 @@ async function readBoard(options, deps = {}) {
     ...groups,
     warnings: collected.warnings,
     partial: collected.partial,
-    source,
-    freshness,
-    ...sourceReason ? { sourceReason } : {}
+    source: "live"
   };
   if (options.includeBundleDetails || options.includeAllBodies) {
     await attachBundleDetails(report, client, options.allowPartial ?? false, { all: options.includeAllBodies });
@@ -32691,8 +32553,7 @@ function registerBoardCommands(program3) {
         repo: o.repo,
         includeBundleDetails: o.bundleDetails,
         includeAllBodies: o.bodies,
-        allowPartial: o.allowPartial,
-        live: o.live
+        allowPartial: o.allowPartial
       });
       console.log(o.json ? JSON.stringify(report) : renderBoardReport(report));
     } catch (e) {
@@ -32703,7 +32564,7 @@ function registerBoardCommands(program3) {
     return alreadyClaimed ? `Check ${ref}: claimed and In Progress, no live contest - claim would renew the lease (nothing written)` : `Check ${ref}: free - claim would proceed (nothing written)`;
   }
   const board = program3.command("board").description("read, claim, show, and move Project v2 work items for the current repo");
-  board.command("read", { isDefault: true }).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("--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("--live", "bypass the projection and read the authoritative GitHub Project v2 board").addHelpText("after", "\nBy default, read uses the explicitly-stale Hub projection and prints its watermark. --live is authoritative.\n--allow-partial applies to the live paginated path and detail reads; the projection row itself is atomic.\n").action((o) => runBoardRead(o));
+  board.command("read", { isDefault: true }).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("--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").addHelpText("after", "\nread is always the authoritative live GitHub Project v2 board (#4926).\n--allow-partial applies to the paginated path and detail reads.\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)").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] ?? [] })
@@ -36286,12 +36147,8 @@ var LOOP_PLAYBOOKS = {
     ]
   }
 };
-function formatExplainCommand(cmd, rootName) {
+function formatOwnDetail(cmd) {
   const lines = [];
-  if (cmd.description) {
-    lines.push(cmd.description);
-    lines.push("");
-  }
   const args = cmd.arguments;
   if (args.length) {
     lines.push("Arguments:");
@@ -36302,10 +36159,10 @@ function formatExplainCommand(cmd, rootName) {
     }
     lines.push("");
   }
-  if (cmd.options.length) {
+  const ownOptions = cmd.options.filter((opt) => opt.flags !== "--help" && opt.flags !== "-V, --version");
+  if (ownOptions.length) {
     lines.push("Options:");
-    for (const opt of cmd.options) {
-      if (opt.flags === "--help" || opt.flags === "-V, --version") continue;
+    for (const opt of ownOptions) {
       const tags = [];
       if (opt.mandatory) tags.push("required");
       if (opt.default !== void 0) tags.push(`default: ${JSON.stringify(opt.default)}`);
@@ -36330,6 +36187,15 @@ function formatExplainCommand(cmd, rootName) {
     }
     lines.push("");
   }
+  return lines;
+}
+function formatExplainCommand(cmd, rootName) {
+  const lines = [];
+  if (cmd.description) {
+    lines.push(cmd.description);
+    lines.push("");
+  }
+  lines.push(...formatOwnDetail(cmd));
   return lines.join("\n").trimEnd();
 }
 function formatExplainGroup(cmd, rootName) {
@@ -36337,9 +36203,10 @@ function formatExplainGroup(cmd, rootName) {
   const lines = [
     `${rootName} ${canonical(cmd)}${cmd.description ? ` \u2014 ${cmd.description}` : ""}`,
     `Category: ${cmd.category} \xB7 Discovery: ${cmd.discovery}`,
-    "",
-    "Commands:"
+    ""
   ];
+  lines.push(...formatOwnDetail(cmd));
+  lines.push("Commands:");
   for (const child2 of cmd.subcommands) {
     const args = child2.arguments.map((arg) => {
       const name = arg.variadic ? `${arg.name}...` : arg.name;
@@ -43860,6 +43727,23 @@ installProcessBackstop();
 consolidateCommandNamespaces(program2);
 registerOrgHealthQuery(program2);
 applyCommandTaxonomy(program2);
+function registeredPathPrefix(path2) {
+  const tokens2 = path2.split(" ");
+  let node = program2;
+  let depth = 0;
+  while (depth < tokens2.length) {
+    const next = node.commands.find((c) => c.name() === tokens2[depth]);
+    if (!next) break;
+    node = next;
+    depth += 1;
+  }
+  return tokens2.slice(0, Math.max(depth, 1)).join(" ");
+}
+function recoveryPointerFor(path2) {
+  const runnable = registeredPathPrefix(path2);
+  if (runnable === path2) return `run: mmi-cli ${canonicalPathFor(runnable)} \u2026`;
+  return `'${path2}' is not a registered command \u2014 run \`mmi-cli ${canonicalPathFor(runnable)} --help\` for what lives under it`;
+}
 function resolveHouseShim(argv) {
   const houseToken = argv[2];
   if (!houseToken) return;
@@ -43869,7 +43753,7 @@ function resolveHouseShim(argv) {
     const flatHouse = houseForPath(flatPath);
     if (!flatHouse || flatHouse === "core") return;
     process.stderr.write(
-      `mmi-cli: the flat '${flatPath}' alias was removed in ${COMPAT_SHIM_DEATH_WAVE} (#4316) \u2014 run: mmi-cli ${canonicalPathFor(flatPath)} \u2026
+      `mmi-cli: the flat '${flatPath}' alias was removed in ${COMPAT_SHIM_DEATH_WAVE} (#4316) \u2014 ${recoveryPointerFor(flatPath)}
 `
     );
     hardExit(2);
@@ -43893,7 +43777,7 @@ function resolveHouseShim(argv) {
   }
   if (actual) {
     process.stderr.write(
-      `mmi-cli ${houseToken}: '${lookupPath}' lives in house '${actual}' \u2014 run: mmi-cli ${canonicalPathFor(lookupPath)} \u2026
+      `mmi-cli ${houseToken}: '${lookupPath}' lives in house '${actual}' \u2014 ${recoveryPointerFor(lookupPath)}
 `
     );
   } else {

package/package.json

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