@mutmutco/cli 3.52.0 → 3.54.0

package/dist/main.cjs

@@ -6229,11 +6229,27 @@ function resolveReleaseTrack(meta, hints, repo) {
   if (inferred) return inferred;
   return "full";
 }
+function metaWithDeclaredClass(meta, declaredClass) {
+  if (!declaredClass) return meta;
+  const stated = typeof meta?.releaseTrack === "string" || typeof meta?.class === "string" || typeof meta?.deployModel === "string";
+  if (stated) return meta;
+  return { ...meta ?? {}, class: declaredClass };
+}
 function branchesForTrack(track) {
   if (track === "trunk") return ["main"];
   if (track === "direct") return ["development", "main"];
   return ["development", "rc", "main"];
 }
+function promotionBranchesForTrack(track) {
+  if (track === "trunk") return [];
+  if (track === "direct") return ["main"];
+  return ["rc", "main"];
+}
+function isPromotionBase(base, track) {
+  if (!base) return false;
+  if (!track) return base !== "development";
+  return promotionBranchesForTrack(track).includes(base);
+}
 
 // src/readiness-audit.ts
 var TENANT_DEPLOY_RUN_SCAN_LIMIT = 100;
@@ -9092,6 +9108,7 @@ function cachedReadNote(cachedAt, now = Date.now()) {
 // src/marketplace-autoupdate.ts
 var KNOWN_MARKETPLACES_RELATIVE = [".claude", "plugins", "known_marketplaces.json"];
 var MMI_MARKETPLACE_NAME = "mutmutco";
+var JERV_MARKETPLACE_NAME = "jervaise";
 function readFileSyncSafe(path2, read) {
   try {
     return read(path2, "utf8");
@@ -9128,6 +9145,49 @@ function resolveAutoUpdate(probe) {
     reason: "undeclared \u2014 third-party marketplaces are OFF by default, so nothing auto-updates and no update notice ever prints"
   };
 }
+function captureMarketplacePins(raw, names) {
+  const out = /* @__PURE__ */ new Map();
+  for (const name of names) {
+    const { registered, declared, ref } = readKnownMarketplace(raw, name);
+    if (!registered) continue;
+    const pins = {
+      ...typeof declared === "boolean" ? { autoUpdate: declared } : {},
+      ...ref ? { ref } : {}
+    };
+    if (Object.keys(pins).length) out.set(name, pins);
+  }
+  return out;
+}
+function restoreMarketplacePins(raw, pins) {
+  if (!raw || pins.size === 0) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const root = parsed;
+  let changed = false;
+  for (const [name, want] of pins) {
+    const entry = root[name];
+    if (!entry || typeof entry !== "object") continue;
+    const e = entry;
+    if (typeof want.autoUpdate === "boolean" && e.autoUpdate !== want.autoUpdate) {
+      e.autoUpdate = want.autoUpdate;
+      changed = true;
+    }
+    if (want.ref && e.source && typeof e.source === "object") {
+      const source = e.source;
+      if (source.ref !== want.ref) {
+        source.ref = want.ref;
+        changed = true;
+      }
+    }
+  }
+  return changed ? `${JSON.stringify(root, null, 2)}
+` : null;
+}
 function readKnownMarketplace(raw, name) {
   if (!raw) return { registered: false };
   let parsed;
@@ -10018,6 +10078,112 @@ function planManagedGitignore(current) {
   return { changed, content, added, removed };
 }
 
+// src/docs-index-command.ts
+var import_node_fs15 = require("node:fs");
+var import_node_path13 = require("node:path");
+var DOCS_INDEX_PATH = "docs/index.md";
+function isRoutableDocsPath(relPath) {
+  const normalized = relPath.replace(/\\/g, "/");
+  return normalized !== "index.md" && normalized.split("/")[0]?.toLowerCase() !== "archive";
+}
+var GENERATED_HEADER = "<!-- Generated by `mmi-cli docs index --write`. Do not edit by hand. -->";
+function plainInline(text) {
+  return text.replace(/\r?\n/g, " ").replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").replace(/`/g, "").replace(/\*+/g, "").replace(/~~/g, "").replace(/__([^_]+)__/g, "$1").replace(/(^|[\s(])_([^_]+)_($|[\s).,!?:;])/g, "$1$2$3").replace(/^>\s*/, "").replace(/\\([\\`*_\[\]{}()#+.!|>-])/g, "$1").replace(/\s+/g, " ").trim();
+}
+function extractDocMeta(relPath, raw) {
+  const lines = raw.split(/\r?\n/);
+  let i = 0;
+  if (lines[i]?.trim() === "---") {
+    i++;
+    while (i < lines.length && lines[i].trim() !== "---") i++;
+    if (i < lines.length) i++;
+  }
+  let title = "";
+  let scope = "";
+  for (; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    if (trimmed === "") continue;
+    if (trimmed.startsWith("<!--")) {
+      while (i < lines.length && !lines[i].includes("-->")) i++;
+      continue;
+    }
+    if (!title && trimmed.startsWith("# ")) {
+      title = trimmed.slice(2).trim();
+      continue;
+    }
+    if (!title) {
+      break;
+    }
+    if (trimmed.startsWith("#")) continue;
+    scope = plainInline(trimmed);
+    break;
+  }
+  if (!title) {
+    const base = relPath.split("/").pop() ?? relPath;
+    title = base.replace(/\.md$/, "");
+  }
+  return { path: relPath, title, scope };
+}
+function renderDocsIndex(entries) {
+  const lines = [
+    GENERATED_HEADER,
+    "",
+    "# Documentation index",
+    "",
+    "Generated from the `docs/` tree by `mmi-cli docs index --write`. `--check` fails on drift, so this index",
+    "can never diverge from the records it lists.",
+    ""
+  ];
+  for (const entry of entries) {
+    const link = `[${plainInline(entry.title)}](${entry.path})`;
+    lines.push(entry.scope ? `- ${link} \u2014 ${plainInline(entry.scope)}` : `- ${link}`);
+  }
+  return lines.join("\n") + "\n";
+}
+function sameContent(a, b) {
+  const normalize = (text) => text.replace(/\r\n/g, "\n");
+  return normalize(a) === normalize(b);
+}
+function docsIndex(deps, opts = {}) {
+  const entries = deps.listDocs().slice().sort().map((relPath) => extractDocMeta(relPath, deps.readDoc(relPath)));
+  const content = renderDocsIndex(entries);
+  const current = deps.readIndex();
+  const drift = current === null || !sameContent(current, content);
+  let wrote = false;
+  if (!opts.check && drift) {
+    deps.writeIndex(content);
+    wrote = true;
+  }
+  return { content, drift, wrote };
+}
+function walkMarkdown(dir) {
+  const out = [];
+  const stack = [dir];
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of (0, import_node_fs15.readdirSync)(current, { withFileTypes: true })) {
+      const full = (0, import_node_path13.join)(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(full);
+      } else if (entry.isFile() && entry.name.endsWith(".md")) {
+        out.push((0, import_node_path13.relative)(dir, full).split(import_node_path13.sep).join("/"));
+      }
+    }
+  }
+  return out;
+}
+function createDocsIndexDeps(repoRoot2) {
+  const docsDir = (0, import_node_path13.join)(repoRoot2, "docs");
+  const indexPath = (0, import_node_path13.join)(repoRoot2, DOCS_INDEX_PATH);
+  return {
+    listDocs: () => (0, import_node_fs15.existsSync)(docsDir) ? walkMarkdown(docsDir).filter(isRoutableDocsPath).sort() : [],
+    readDoc: (relPath) => (0, import_node_fs15.readFileSync)((0, import_node_path13.join)(docsDir, relPath), "utf8"),
+    readIndex: () => (0, import_node_fs15.existsSync)(indexPath) ? (0, import_node_fs15.readFileSync)(indexPath, "utf8") : null,
+    writeIndex: (content) => (0, import_node_fs15.writeFileSync)(indexPath, content, "utf8")
+  };
+}
+
 // src/gate-budget.ts
 var BLESSED_RUN_WITH_BUDGET_SHA = "ea2cf8710949dec53566c29836e29cd7515a4e23";
 var REMOTE_USE = /^mutmutco\/MMI-Hub\/\.github\/actions\/run-with-budget@(\S+)$/;
@@ -10264,6 +10430,7 @@ function withDerivedRepoVars(vars, parsed, cls, releaseTrack) {
   out.REPO_NAME ??= parsed.name;
   out.REPO_SLUG ??= parsed.slug;
   out.CLASS ??= cls;
+  out.PROJECT_OWNER ??= parsed.owner;
   const track = releaseTrack ?? resolveBootstrapReleaseTrack(cls);
   const runtime = out.GATE_RUNTIME === "python" ? "python" : "node";
   for (const [key, value] of Object.entries(gateSeedVars(cls, track, runtime))) {
@@ -10464,6 +10631,26 @@ function boardFieldsQueryArgs(projectId) {
   const query = "query($id: ID!) { node(id: $id) { ... on ProjectV2 { number fields(first: 50) { nodes { ... on ProjectV2SingleSelectField { id name options { id name } } } } } } }";
   return ["api", "graphql", "-f", `query=${query}`, "-f", `id=${projectId}`];
 }
+function seededDocsIndex(seeds) {
+  const docs2 = seeds.map((s) => ({ rel: s.path.replace(/\\/g, "/"), content: s.content })).filter((s) => s.rel.startsWith("docs/") && s.rel.endsWith(".md")).map((s) => ({ rel: s.rel.slice("docs/".length), content: s.content })).filter((s) => isRoutableDocsPath(s.rel));
+  if (!docs2.length) return null;
+  const entries = docs2.slice().sort((a, b) => a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0).map((s) => extractDocMeta(s.rel, s.content));
+  return renderDocsIndex(entries);
+}
+function linkedProjectsQueryArgs(owner, name) {
+  const query = "query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { projectsV2(first: 10) { nodes { id number title } } } }";
+  return ["api", "graphql", "-f", `query=${query}`, "-f", `owner=${owner}`, "-f", `name=${name}`];
+}
+function pickLinkedProject(json) {
+  const nodes = json?.data?.repository?.projectsV2?.nodes;
+  if (!Array.isArray(nodes)) return void 0;
+  const usable = nodes.filter(
+    (n) => typeof n?.id === "string" && Boolean(n.id)
+  );
+  if (usable.length !== 1) return void 0;
+  const only = usable[0];
+  return typeof only.number === "number" && Number.isFinite(only.number) ? { id: only.id, number: only.number } : { id: only.id };
+}
 function decideSeedPrAction(openPrs) {
   const list = Array.isArray(openPrs) ? openPrs : [];
   for (const pr2 of list) {
@@ -11112,12 +11299,12 @@ async function runPrLand(prNumber, options, deps) {
 }
 
 // src/wave-status.ts
-var import_node_fs16 = require("node:fs");
+var import_node_fs17 = require("node:fs");
 
 // src/stage-runner.ts
 var import_node_child_process7 = require("node:child_process");
-var import_node_fs15 = require("node:fs");
-var import_node_path13 = require("node:path");
+var import_node_fs16 = require("node:fs");
+var import_node_path14 = require("node:path");
 var import_node_net = require("node:net");
 var import_node_util6 = require("node:util");
 
@@ -11256,11 +11443,11 @@ function appendForceRecreate(up) {
   return `${up.trimEnd()} --force-recreate`;
 }
 function stageStatePath(cwd = process.cwd()) {
-  return (0, import_node_path13.join)(cwd, "tmp", "stage", "state.json");
+  return (0, import_node_path14.join)(cwd, "tmp", "stage", "state.json");
 }
 function stageGlobalStatePath(cwd = process.cwd(), gitCommonDir = ".git") {
-  const dir = (0, import_node_path13.isAbsolute)(gitCommonDir) ? gitCommonDir : (0, import_node_path13.resolve)(cwd, gitCommonDir);
-  return (0, import_node_path13.join)(dir, "mmi", "stage", "state.json");
+  const dir = (0, import_node_path14.isAbsolute)(gitCommonDir) ? gitCommonDir : (0, import_node_path14.resolve)(cwd, gitCommonDir);
+  return (0, import_node_path14.join)(dir, "mmi", "stage", "state.json");
 }
 function normPath2(path2) {
   return path2.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
@@ -11484,14 +11671,14 @@ function stageProcessEnv(stagePort, extraEnv) {
 }
 async function ensureStageRuntimeEnv(config, opts, cwd) {
   if (!config.ensureEnv) return;
-  const target = (0, import_node_path13.join)(cwd, config.ensureEnv.target);
-  const example = (0, import_node_path13.join)(cwd, config.ensureEnv.example);
-  if (!(0, import_node_fs15.existsSync)(target) && (0, import_node_fs15.existsSync)(example)) {
-    (0, import_node_fs15.copyFileSync)(example, target);
-  } else if ((0, import_node_fs15.existsSync)(target) && (0, import_node_fs15.existsSync)(example)) {
-    const stale = detectStaleEnvFile((0, import_node_fs15.readFileSync)(example, "utf8"), (0, import_node_fs15.readFileSync)(target, "utf8"), {
-      exampleMtimeMs: (0, import_node_fs15.statSync)(example).mtimeMs,
-      targetMtimeMs: (0, import_node_fs15.statSync)(target).mtimeMs
+  const target = (0, import_node_path14.join)(cwd, config.ensureEnv.target);
+  const example = (0, import_node_path14.join)(cwd, config.ensureEnv.example);
+  if (!(0, import_node_fs16.existsSync)(target) && (0, import_node_fs16.existsSync)(example)) {
+    (0, import_node_fs16.copyFileSync)(example, target);
+  } else if ((0, import_node_fs16.existsSync)(target) && (0, import_node_fs16.existsSync)(example)) {
+    const stale = detectStaleEnvFile((0, import_node_fs16.readFileSync)(example, "utf8"), (0, import_node_fs16.readFileSync)(target, "utf8"), {
+      exampleMtimeMs: (0, import_node_fs16.statSync)(example).mtimeMs,
+      targetMtimeMs: (0, import_node_fs16.statSync)(target).mtimeMs
     });
     if (stale) {
       const msg = `stale ${config.ensureEnv.target} (${stale}) \u2014 delete it or refresh from ${config.ensureEnv.example} before re-running /stage`;
@@ -11499,8 +11686,8 @@ async function ensureStageRuntimeEnv(config, opts, cwd) {
       console.error(`mmi-cli stage: ${msg} (allowed via --allow-stale-env)`);
     }
   }
-  if (opts.vaultEnvMerge && Object.keys(opts.vaultEnvMerge).length && (0, import_node_fs15.existsSync)(target)) {
-    (0, import_node_fs15.writeFileSync)(target, mergeEnvSecretsIntoFile((0, import_node_fs15.readFileSync)(target, "utf8"), opts.vaultEnvMerge), "utf8");
+  if (opts.vaultEnvMerge && Object.keys(opts.vaultEnvMerge).length && (0, import_node_fs16.existsSync)(target)) {
+    (0, import_node_fs16.writeFileSync)(target, mergeEnvSecretsIntoFile((0, import_node_fs16.readFileSync)(target, "utf8"), opts.vaultEnvMerge), "utf8");
   }
 }
 async function gitText(cwd, args) {
@@ -11530,20 +11717,20 @@ async function resolveGlobalStatePath(cwd, explicit) {
   return void 0;
 }
 function readState(path2) {
-  if (!(0, import_node_fs15.existsSync)(path2)) return null;
+  if (!(0, import_node_fs16.existsSync)(path2)) return null;
   try {
-    return JSON.parse((0, import_node_fs15.readFileSync)(path2, "utf8"));
+    return JSON.parse((0, import_node_fs16.readFileSync)(path2, "utf8"));
   } catch {
     return null;
   }
 }
 function mkdirFor(path2) {
   const dir = path2.slice(0, Math.max(path2.lastIndexOf("/"), path2.lastIndexOf("\\")));
-  (0, import_node_fs15.mkdirSync)(dir, { recursive: true });
+  (0, import_node_fs16.mkdirSync)(dir, { recursive: true });
 }
 function writeState(path2, state) {
   mkdirFor(path2);
-  (0, import_node_fs15.writeFileSync)(path2, JSON.stringify(state, null, 2), "utf8");
+  (0, import_node_fs16.writeFileSync)(path2, JSON.stringify(state, null, 2), "utf8");
 }
 function writeStagePortReservation(port, cwd, statePath, globalStatePath, now) {
   const reservation = {
@@ -11563,7 +11750,7 @@ async function cleanupStageState(state, paths, timeoutMs, fallbackCwd) {
     await shell(state.teardown.command.trim(), state.teardown.cwd || state.cwd || fallbackCwd, Math.max(timeoutMs, 1e4));
   }
   for (const path2 of [...new Set(paths.filter((p) => Boolean(p)))]) {
-    (0, import_node_fs15.rmSync)(path2, { force: true });
+    (0, import_node_fs16.rmSync)(path2, { force: true });
   }
 }
 async function killTree(pid) {
@@ -11721,8 +11908,8 @@ async function runStage(config = {}, opts = {}) {
     await ensureStageRuntimeEnv(config, opts, cwd);
     if (build) await shell(sub(build), cwd, timeoutMs, stageProcessEnv(stagePort, extraEnv));
   } catch (e) {
-    (0, import_node_fs15.rmSync)(statePath, { force: true });
-    if (globalStatePath && globalStatePath !== statePath) (0, import_node_fs15.rmSync)(globalStatePath, { force: true });
+    (0, import_node_fs16.rmSync)(statePath, { force: true });
+    if (globalStatePath && globalStatePath !== statePath) (0, import_node_fs16.rmSync)(globalStatePath, { force: true });
     throw e;
   }
   const started = await startStage(config, {
@@ -11743,9 +11930,9 @@ function parseNextFromHead(headText) {
 }
 function readStageSummary(worktreePath) {
   const statePath = stageStatePath(worktreePath);
-  if (!(0, import_node_fs16.existsSync)(statePath)) return void 0;
+  if (!(0, import_node_fs17.existsSync)(statePath)) return void 0;
   try {
-    const state = JSON.parse((0, import_node_fs16.readFileSync)(statePath, "utf8"));
+    const state = JSON.parse((0, import_node_fs17.readFileSync)(statePath, "utf8"));
     const port = typeof state.port === "number" ? state.port : void 0;
     if (port == null || !Number.isInteger(port) || port <= 0) return void 0;
     return { port, url: typeof state.url === "string" ? state.url : void 0 };
@@ -11864,7 +12051,7 @@ async function resolveAutoAddBoardAttach(client, cfg, selector, priority, warn =
 // src/gh-create.ts
 var import_promises = require("node:fs/promises");
 var import_node_os3 = require("node:os");
-var import_node_path14 = require("node:path");
+var import_node_path15 = require("node:path");
 var import_node_crypto3 = require("node:crypto");
 var ISSUE_TYPES = ["bug", "feature", "task"];
 var GH_MUTATION_TIMEOUT_MS = 12e4;
@@ -11918,8 +12105,8 @@ async function bodyArgsViaFile(args, deps = {}) {
   const remove2 = deps.remove ?? import_promises.unlink;
   const ensureDir = deps.ensureDir ?? import_promises.mkdir;
   const dir = deps.dir ?? (0, import_node_os3.tmpdir)();
-  const file = (0, import_node_path14.join)(dir, `mmi-gh-body-${process.pid}-${(0, import_node_crypto3.randomBytes)(4).toString("hex")}.md`);
-  await ensureDir((0, import_node_path14.dirname)(file), { recursive: true }).catch(() => {
+  const file = (0, import_node_path15.join)(dir, `mmi-gh-body-${process.pid}-${(0, import_node_crypto3.randomBytes)(4).toString("hex")}.md`);
+  await ensureDir((0, import_node_path15.dirname)(file), { recursive: true }).catch(() => {
   });
   await write(file, args[i + 1], "utf8");
   return {
@@ -13194,8 +13381,8 @@ function parseVerifyBroker(stdout) {
 }
 
 // src/train-apply.ts
-var import_node_fs17 = require("node:fs");
-var import_node_path15 = require("node:path");
+var import_node_fs18 = require("node:fs");
+var import_node_path16 = require("node:path");
 function resolveDeployModel2(meta, repo) {
   const m = meta?.deployModel;
   if (isDeployModel(m)) return m;
@@ -14103,17 +14290,17 @@ async function dispatchDeploy(deps, ctx, stage, ref, model, watch, autoRunSince,
   return { note: `no manual dispatch: ${model} repo deploys via its own push-triggered workflow`, deployStatus: "pending" };
 }
 function readLocalGateWorkflows() {
-  const dir = (0, import_node_path15.join)(".github", "workflows");
+  const dir = (0, import_node_path16.join)(".github", "workflows");
   let names;
   try {
-    names = (0, import_node_fs17.readdirSync)(dir);
+    names = (0, import_node_fs18.readdirSync)(dir);
   } catch {
     return null;
   }
   const files = [];
   for (const name of names.filter(isGateWorkflowPath)) {
     try {
-      files.push({ path: `${dir}/${name}`.replace(/\\/g, "/"), body: (0, import_node_fs17.readFileSync)((0, import_node_path15.join)(dir, name), "utf8") });
+      files.push({ path: `${dir}/${name}`.replace(/\\/g, "/"), body: (0, import_node_fs18.readFileSync)((0, import_node_path16.join)(dir, name), "utf8") });
     } catch {
     }
   }
@@ -16009,112 +16196,6 @@ function renderAccessReport(report) {
   return lines.join("\n");
 }
 
-// src/docs-index-command.ts
-var import_node_fs18 = require("node:fs");
-var import_node_path16 = require("node:path");
-var DOCS_INDEX_PATH = "docs/index.md";
-function isRoutableDocsPath(relPath) {
-  const normalized = relPath.replace(/\\/g, "/");
-  return normalized !== "index.md" && normalized.split("/")[0]?.toLowerCase() !== "archive";
-}
-var GENERATED_HEADER = "<!-- Generated by `mmi-cli docs index --write`. Do not edit by hand. -->";
-function plainInline(text) {
-  return text.replace(/\r?\n/g, " ").replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").replace(/`/g, "").replace(/\*+/g, "").replace(/~~/g, "").replace(/__([^_]+)__/g, "$1").replace(/(^|[\s(])_([^_]+)_($|[\s).,!?:;])/g, "$1$2$3").replace(/^>\s*/, "").replace(/\\([\\`*_\[\]{}()#+.!|>-])/g, "$1").replace(/\s+/g, " ").trim();
-}
-function extractDocMeta(relPath, raw) {
-  const lines = raw.split(/\r?\n/);
-  let i = 0;
-  if (lines[i]?.trim() === "---") {
-    i++;
-    while (i < lines.length && lines[i].trim() !== "---") i++;
-    if (i < lines.length) i++;
-  }
-  let title = "";
-  let scope = "";
-  for (; i < lines.length; i++) {
-    const line = lines[i];
-    const trimmed = line.trim();
-    if (trimmed === "") continue;
-    if (trimmed.startsWith("<!--")) {
-      while (i < lines.length && !lines[i].includes("-->")) i++;
-      continue;
-    }
-    if (!title && trimmed.startsWith("# ")) {
-      title = trimmed.slice(2).trim();
-      continue;
-    }
-    if (!title) {
-      break;
-    }
-    if (trimmed.startsWith("#")) continue;
-    scope = plainInline(trimmed);
-    break;
-  }
-  if (!title) {
-    const base = relPath.split("/").pop() ?? relPath;
-    title = base.replace(/\.md$/, "");
-  }
-  return { path: relPath, title, scope };
-}
-function renderDocsIndex(entries) {
-  const lines = [
-    GENERATED_HEADER,
-    "",
-    "# Documentation index",
-    "",
-    "Generated from the `docs/` tree by `mmi-cli docs index --write`. `--check` fails on drift, so this index",
-    "can never diverge from the records it lists.",
-    ""
-  ];
-  for (const entry of entries) {
-    const link = `[${plainInline(entry.title)}](${entry.path})`;
-    lines.push(entry.scope ? `- ${link} \u2014 ${plainInline(entry.scope)}` : `- ${link}`);
-  }
-  return lines.join("\n") + "\n";
-}
-function sameContent(a, b) {
-  const normalize = (text) => text.replace(/\r\n/g, "\n");
-  return normalize(a) === normalize(b);
-}
-function docsIndex(deps, opts = {}) {
-  const entries = deps.listDocs().slice().sort().map((relPath) => extractDocMeta(relPath, deps.readDoc(relPath)));
-  const content = renderDocsIndex(entries);
-  const current = deps.readIndex();
-  const drift = current === null || !sameContent(current, content);
-  let wrote = false;
-  if (!opts.check && drift) {
-    deps.writeIndex(content);
-    wrote = true;
-  }
-  return { content, drift, wrote };
-}
-function walkMarkdown(dir) {
-  const out = [];
-  const stack = [dir];
-  while (stack.length) {
-    const current = stack.pop();
-    for (const entry of (0, import_node_fs18.readdirSync)(current, { withFileTypes: true })) {
-      const full = (0, import_node_path16.join)(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(full);
-      } else if (entry.isFile() && entry.name.endsWith(".md")) {
-        out.push((0, import_node_path16.relative)(dir, full).split(import_node_path16.sep).join("/"));
-      }
-    }
-  }
-  return out;
-}
-function createDocsIndexDeps(repoRoot2) {
-  const docsDir = (0, import_node_path16.join)(repoRoot2, "docs");
-  const indexPath = (0, import_node_path16.join)(repoRoot2, DOCS_INDEX_PATH);
-  return {
-    listDocs: () => (0, import_node_fs18.existsSync)(docsDir) ? walkMarkdown(docsDir).filter(isRoutableDocsPath).sort() : [],
-    readDoc: (relPath) => (0, import_node_fs18.readFileSync)((0, import_node_path16.join)(docsDir, relPath), "utf8"),
-    readIndex: () => (0, import_node_fs18.existsSync)(indexPath) ? (0, import_node_fs18.readFileSync)(indexPath, "utf8") : null,
-    writeIndex: (content) => (0, import_node_fs18.writeFileSync)(indexPath, content, "utf8")
-  };
-}
-
 // src/doc-refs-core.ts
 var import_node_child_process9 = require("node:child_process");
 var import_node_fs19 = require("node:fs");
@@ -19345,7 +19426,7 @@ var import_node_fs22 = require("node:fs");
 
 // src/bootstrap-verify.ts
 var TRAIN_BRANCHES2 = ["development", "rc", "main"];
-var requiredDocs = ["README.md", "architecture.md", "docs/decisions/README.md"];
+var requiredDocs = ["README.md", "architecture.md", "docs/decisions/README.md", "docs/index.md"];
 var requiredIssueTemplates = [
   ".github/ISSUE_TEMPLATE/bug.yml",
   ".github/ISSUE_TEMPLATE/feature.yml",
@@ -19502,6 +19583,11 @@ function unfilledDocPlaceholders(text) {
   for (const prompt of DOC_PLACEHOLDER_PROMPTS) if (text.includes(prompt)) found.add(prompt);
   return [...found];
 }
+function filledDocCheck(label, text, path2) {
+  if (text === null) return { ok: false, label, detail: `${path2} not readable via API` };
+  const unfilled = unfilledDocPlaceholders(text);
+  return { ok: unfilled.length === 0, label, detail: unfilled.length ? `unfilled: ${unfilled.join(", ")}` : void 0 };
+}
 async function verifyBootstrap(repo, repoClass, deps, releaseTrack) {
   const branchesWanted = expectedBranches(repoClass, releaseTrack);
   const baseBranch = releaseTrack === "trunk" || repoClass === "content" ? "main" : "development";
@@ -19575,19 +19661,9 @@ async function verifyBootstrap(repo, repoClass, deps, releaseTrack) {
     label: "README has Agent context section",
     detail: readme === null ? "README.md not readable via API" : void 0
   });
-  const readmePlaceholders = unfilledDocPlaceholders(readme);
-  checks.push({
-    ok: readmePlaceholders.length === 0,
-    label: "README Agent context is filled (no template placeholders)",
-    detail: readmePlaceholders.length ? `unfilled: ${readmePlaceholders.join(", ")}` : void 0
-  });
+  checks.push(filledDocCheck("README Agent context is filled (no template placeholders)", readme, "README.md"));
   const architecture = await contentText(deps, repo, baseBranch, "architecture.md");
-  const archPlaceholders = unfilledDocPlaceholders(architecture);
-  checks.push({
-    ok: archPlaceholders.length === 0,
-    label: "architecture.md is filled (no template placeholders)",
-    detail: archPlaceholders.length ? `unfilled: ${archPlaceholders.join(", ")}` : void 0
-  });
+  checks.push(filledDocCheck("architecture.md is filled (no template placeholders)", architecture, "architecture.md"));
   const labels = await restPagedJson2(deps, `repos/${repo}/labels`, []);
   const labelNames = new Set(labels.map((l) => l.name));
   for (const label of requiredLabels) {
@@ -19910,7 +19986,11 @@ function registerBootstrapCommands(program3) {
           return null;
         }
       }
-    }, resolveReleaseTrack(meta));
+      // #3537: verify runs BEFORE registration by construction (skill Step 0a), so `meta` is null on every
+      // fresh repo and `resolveReleaseTrack` falls through to `full` — which then outranks the operator's
+      // own `--class content` inside expectedBranches, and the report demands a development and an rc the
+      // track forbids. The declared class fills that gap only when the registry states nothing itself.
+    }, resolveReleaseTrack(metaWithDeclaredClass(meta, o.class), void 0, repo));
     console.log(o.json ? JSON.stringify(report, null, 2) : renderBootstrapVerifyReport(report));
     if (!report.ok) process.exitCode = 1;
   });
@@ -19958,6 +20038,17 @@ function registerBootstrapCommands(program3) {
     } catch {
     }
     const vars = withDerivedRepoVars(rawVars, parsedRepo, o.class, bootstrapReleaseTrack);
+    if (!vars.PROJECT_ID) {
+      try {
+        const r = await gh(linkedProjectsQueryArgs(parsedRepo.owner, parsedRepo.name));
+        const linked = pickLinkedProject(JSON.parse(r.stdout));
+        if (linked) {
+          vars.PROJECT_ID = linked.id;
+          if (linked.number != null && vars.PROJECT_NUMBER == null) vars.PROJECT_NUMBER = String(linked.number);
+        }
+      } catch {
+      }
+    }
     if (vars.PROJECT_ID) {
       try {
         const r = await gh(boardFieldsQueryArgs(vars.PROJECT_ID));
@@ -19999,6 +20090,7 @@ function registerBootstrapCommands(program3) {
         }
       }
     }
+    const docsForIndex = [];
     for (const seed of manifest.seeds) {
       if (!seed.classes.includes(o.class)) continue;
       if (!seedMatchesDeployModel(seed, applyDeployModel)) continue;
@@ -20026,12 +20118,38 @@ function registerBootstrapCommands(program3) {
       const content = planned.action === "create" || planned.action === "update" ? isBlock ? upsertManagedGitignoreBlock(remoteContent).content : resolveSeedContent(resolved, vars, readFile7) : null;
       const action = reconcileSeedAction(planned, content, isBlock, remoteContent);
       actions.push(action);
+      const docBody = content ?? remoteContent;
+      if (resolved.target.startsWith("docs/") && resolved.target.endsWith(".md") && docBody !== null) {
+        docsForIndex.push({ path: resolved.target, content: docBody });
+      }
       if (o.execute && (action.action === "create" || action.action === "update")) {
         await gh(contentPutArgs(repo, resolved.target, content, seedPlan.ref, action.action === "update" ? sha : void 0));
         applied.push(`${action.action} ${resolved.target}`);
         if (seedPlan.mode === "pr") seededToBranch++;
       }
     }
+    const indexContent = seededDocsIndex(docsForIndex);
+    if (indexContent) {
+      let indexCurrent = null;
+      try {
+        const r = await gh(["api", `repos/${repo}/contents/${enc(DOCS_INDEX_PATH)}?ref=${seedPlan.ref}`]);
+        const parsed = JSON.parse(r.stdout);
+        indexCurrent = parsed.encoding === "base64" && typeof parsed.content === "string" ? Buffer.from(parsed.content, "base64").toString("utf8") : "";
+      } catch {
+      }
+      const indexAction = indexCurrent === null ? "create" : "skip";
+      actions.push({
+        target: DOCS_INDEX_PATH,
+        action: indexAction,
+        ownership: "org",
+        reason: indexCurrent === null ? "generated routing index (#3545)" : "routing index present \u2014 regenerate with `mmi-cli docs index --write`, which sees the whole tree"
+      });
+      if (o.execute && indexAction === "create") {
+        await gh(contentPutArgs(repo, DOCS_INDEX_PATH, indexContent, seedPlan.ref, void 0));
+        applied.push(`${indexAction} ${DOCS_INDEX_PATH}`);
+        if (seedPlan.mode === "pr") seededToBranch++;
+      }
+    }
     let seedPrUrl;
     if (o.execute && seedPlan.mode === "pr" && seedPlan.branch && seededToBranch > 0) {
       await gh(["api", "-X", "PATCH", `repos/${repo}`, "-f", "allow_auto_merge=true", "-f", "allow_squash_merge=true", "-f", "delete_branch_on_merge=true"]).catch(() => {
@@ -22668,12 +22786,40 @@ async function healClaudePluginForDoctor(surface = detectSurface(process.env)) {
     return { ok: false, detail: `not a Claude surface (${surface}) \u2014 no Hub-shipped plugin to reinstall` };
   }
   const steps = [];
+  const pinsPath = (0, import_node_path26.join)((0, import_node_os6.homedir)(), ...KNOWN_MARKETPLACES_RELATIVE);
+  const before = readKnownMarketplacesFile(pinsPath);
+  const pins = captureMarketplacePins(before, [MMI_MARKETPLACE_NAME, JERV_MARKETPLACE_NAME]);
   const ok = await applyPluginHeal(surface, (msg) => steps.push(msg.trim()));
+  const restored = ok ? restoreMarketplacePinsOnDisk(pinsPath, pins) : void 0;
   return {
     ok,
-    detail: ok ? "marketplace remove \u2192 add \u2192 install succeeded" : `\`claude plugin\` reinstall failed or was skipped${steps.length ? ` (${steps[steps.length - 1]})` : ""}`
+    detail: ok ? `marketplace remove \u2192 add \u2192 install succeeded${restored ? `; ${restored}` : ""}` : `\`claude plugin\` reinstall failed or was skipped${steps.length ? ` (${steps[steps.length - 1]})` : ""}`
   };
 }
+function readKnownMarketplacesFile(path2) {
+  try {
+    return (0, import_node_fs28.existsSync)(path2) ? (0, import_node_fs28.readFileSync)(path2, "utf8") : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function restoreMarketplacePinsOnDisk(path2, pins) {
+  if (pins.size === 0) return void 0;
+  const after = readKnownMarketplacesFile(path2);
+  const next = restoreMarketplacePins(after, pins);
+  if (next === null) return void 0;
+  try {
+    (0, import_node_fs28.writeFileSync)(path2, next, "utf8");
+  } catch {
+    return `could NOT restore ${[...pins.keys()].join(", ")} \u2014 re-pin by hand`;
+  }
+  const verify = readKnownMarketplacesFile(path2);
+  const failed = [...pins].filter(([name, want]) => {
+    const got = readKnownMarketplace(verify, name);
+    return typeof want.autoUpdate === "boolean" && got.declared !== want.autoUpdate || want.ref !== void 0 && got.ref !== want.ref;
+  });
+  return failed.length ? `restore did NOT take for ${failed.map(([n]) => n).join(", ")} \u2014 re-pin by hand` : `re-pinned ${[...pins.keys()].join(", ")} (auto-update + catalog ref survive the reinstall)`;
+}
 async function runGuard(readOrigin) {
   try {
     const surface = detectSurface(process.env);
@@ -26323,11 +26469,18 @@ pr.command("land <number>").description("agent merge path (#1440): train probe \
       const args = repoOpt ? ["--repo", repoOpt] : repoArgs;
       const viewed = (await execFileP2("gh", ["pr", "view", prNumber, ...args, "--json", "headRepository,baseRefName", "--jq", '.headRepository.nameWithOwner + " " + .baseRefName'], { timeout: GC_GH_TIMEOUT_MS2 })).stdout.trim();
       const [repoFromGh, base] = viewed.split(/\s+/);
-      if (base && base !== "development") {
-        throw new Error(`pr land: base branch must be development (got ${base}) \u2014 promotion merges stay human-only`);
-      }
       const repo = repoOpt ?? repoFromGh;
       if (!repo) throw new Error("pr land: could not resolve PR repo");
+      let track;
+      try {
+        const meta = await fetchProjectBySlug(slugOf(repo), registryClientDeps(await loadConfig()));
+        if (meta) track = resolveReleaseTrack(meta, void 0, repo);
+      } catch {
+      }
+      if (isPromotionBase(base, track)) {
+        const shape = track ? `${track} track` : "unresolved track \u2014 strict reading";
+        throw new Error(`pr land: base branch ${base} is a promotion target (${shape}) \u2014 promotion merges stay human-only`);
+      }
       return repo;
     },
     fetchTrainAuthority: async (repo) => fetchTrainAuthority(repo, registryClientDeps(await loadConfig())),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "3.52.0",
+  "version": "3.54.0",
   "description": "MMI Future CLI — the org dev toolbox (board, registry, keyless secrets, release train, bootstrap, doctor) and the cross-IDE engine the plugin's session-start hook drives.",
   "type": "module",
   "license": "UNLICENSED",