@mutmutco/cli 2.31.0 → 2.32.0

package/dist/index.cjs

@@ -62,7 +62,7 @@ function setInjectedStdin(payload) {
 }
 async function readStdin() {
   if (injectedStdin !== void 0) return injectedStdin;
-  if (process.stdin.isTTY) return "";
+  if (process.stdin.isTTY !== false) return "";
   const chunks = [];
   for await (const chunk of process.stdin) chunks.push(chunk);
   return Buffer.concat(chunks).toString("utf8");

package/dist/main.cjs

@@ -4112,7 +4112,7 @@ async function hubAuthToken(deps) {
 var injectedStdin;
 async function readStdin() {
   if (injectedStdin !== void 0) return injectedStdin;
-  if (process.stdin.isTTY) return "";
+  if (process.stdin.isTTY !== false) return "";
   const chunks = [];
   for await (const chunk of process.stdin) chunks.push(chunk);
   return Buffer.concat(chunks).toString("utf8");
@@ -5257,6 +5257,15 @@ function buildIngestPayload(args) {
 
 // src/honcho-client.ts
 var HONCHO_ASSISTANT_PEER = "assistant";
+function parseHonchoQueueStatus(json) {
+  const o = json && typeof json === "object" ? json : {};
+  const pendingRaw = o.pending_work_units ?? o.depth ?? o.queue_depth ?? o.pending;
+  const inProgressRaw = o.in_progress_work_units;
+  const pending = typeof pendingRaw === "number" ? pendingRaw : null;
+  const inProgress = typeof inProgressRaw === "number" ? inProgressRaw : null;
+  const stalled = (pending ?? 0) > 0 && (inProgress ?? 0) === 0;
+  return { pending, inProgress, stalled };
+}
 var enc = encodeURIComponent;
 var base = (apiUrl) => apiUrl.replace(/\/+$/, "");
 var honchoRoutes = {
@@ -5323,20 +5332,28 @@ async function fetchPeerCard(cfg, peer, opts = {}) {
   try {
     const path2 = honchoRoutes.peerCard(cfg.workspace, peer, opts.project);
     const res = await request(cfg, fetchImpl, "GET", path2, void 0, timeoutMs);
-    if (!res.ok) return null;
+    if (!res.ok) return { status: "error", httpStatus: res.status };
     const json = await res.json();
-    return formatPeerCardLines(json?.peer_card, maxChars);
-  } catch {
-    return null;
+    const profile = formatPeerCardLines(json?.peer_card, maxChars);
+    return profile ? { status: "ok", data: profile } : { status: "empty" };
+  } catch (e) {
+    return { status: "error", message: e.message };
   }
 }
 async function fetchPeerCardWithFallback(cfg, peer, project2, opts = {}) {
   if (project2) {
     const scoped = await fetchPeerCard(cfg, peer, { ...opts, project: project2 });
-    if (scoped) return { profile: scoped, scope: "project" };
+    if (scoped.status === "ok") return { profile: scoped.data, scope: "project", status: "ok" };
+    if (scoped.status === "error") {
+      return { profile: null, scope: null, status: "error", httpStatus: scoped.httpStatus, message: scoped.message };
+    }
   }
   const wide = await fetchPeerCard(cfg, peer, opts);
-  return { profile: wide, scope: wide ? "peer" : null };
+  if (wide.status === "ok") return { profile: wide.data, scope: "peer", status: "ok" };
+  if (wide.status === "error") {
+    return { profile: null, scope: null, status: "error", httpStatus: wide.httpStatus, message: wide.message };
+  }
+  return { profile: null, scope: null, status: "empty" };
 }
 async function dialecticChat(cfg, peer, query, opts = {}, fetchImpl = fetch) {
   try {
@@ -5346,25 +5363,44 @@ async function dialecticChat(cfg, peer, query, opts = {}, fetchImpl = fetch) {
       ...opts.target ? { target: opts.target } : {},
       ...opts.sessionId ? { session_id: opts.sessionId } : {}
     }, opts.timeoutMs ?? 15e3);
-    if (!res.ok) return null;
+    if (!res.ok) return { status: "error", httpStatus: res.status };
     const json = await res.json();
-    return (json?.content ?? "").trim() || null;
-  } catch {
-    return null;
+    const answer = (json?.content ?? "").trim();
+    return answer ? { status: "ok", data: answer } : { status: "empty" };
+  } catch (e) {
+    return { status: "error", message: e.message };
   }
 }
 async function probeHoncho(cfg, fetchImpl = fetch, timeoutMs = 3e3, opts = {}) {
+  const emptyQueue = { pending: null, inProgress: null, stalled: false };
   try {
     const healthRes = await request(cfg, fetchImpl, "GET", honchoRoutes.health(), void 0, timeoutMs);
     if (!healthRes.ok) {
-      return { reachable: false, status: healthRes.status, authOk: false, authStatus: void 0 };
+      return { reachable: false, status: healthRes.status, authOk: false, authStatus: void 0, queue: emptyQueue };
     }
     const authPath = opts.peer ? honchoRoutes.peerCard(cfg.workspace, opts.peer) : honchoRoutes.queueStatus(cfg.workspace);
     const authRes = await request(cfg, fetchImpl, "GET", authPath, void 0, timeoutMs);
     const authOk = authRes.status !== 401 && authRes.status !== 403;
-    return { reachable: true, status: healthRes.status, authOk, authStatus: authRes.status };
+    let queue = emptyQueue;
+    if (authPath.includes("/queue/status") && authRes.ok) {
+      try {
+        queue = parseHonchoQueueStatus(await authRes.json());
+      } catch {
+        queue = emptyQueue;
+      }
+    } else {
+      const queueRes = await request(cfg, fetchImpl, "GET", honchoRoutes.queueStatus(cfg.workspace), void 0, timeoutMs);
+      if (queueRes.ok) {
+        try {
+          queue = parseHonchoQueueStatus(await queueRes.json());
+        } catch {
+          queue = emptyQueue;
+        }
+      }
+    }
+    return { reachable: true, status: healthRes.status, authOk, authStatus: authRes.status, queue };
   } catch {
-    return { reachable: false, authOk: false };
+    return { reachable: false, authOk: false, queue: emptyQueue };
   }
 }
 
@@ -5552,8 +5588,21 @@ async function runHonchoContext(opts, io = consoleIo) {
     return;
   }
   const key = await sagaKey(cfg);
-  const { profile, scope } = await fetchPeerCardWithFallback(hc, peer, key.project);
-  if (opts.json) return io.log(JSON.stringify({ peer, project: key.project, cardScope: scope, profile }));
+  const { profile, scope, status, httpStatus, message } = await fetchPeerCardWithFallback(hc, peer, key.project);
+  if (opts.json) {
+    return io.log(JSON.stringify({
+      peer,
+      project: key.project,
+      cardScope: scope,
+      profile,
+      status,
+      ...status === "error" ? { error: { httpStatus, message } } : {}
+    }));
+  }
+  if (status === "error") {
+    io.err(`honcho context: peer card request failed${httpStatus ? ` (${httpStatus})` : ""}${message ? `: ${message}` : ""}`);
+    return;
+  }
   if (!profile) return;
   io.log(opts.banner ? profileBanner(profile, peer, scope === "project" ? key.project : void 0) : profile);
 }
@@ -5577,9 +5626,21 @@ async function runHonchoChat(query, opts, io = consoleIo) {
     io.err("honcho chat: query is empty after redaction");
     return;
   }
-  const answer = await dialecticChat(hc, peer, safeQuery, { target: opts.target });
-  if (opts.json) return io.log(JSON.stringify({ peer, query, answer }));
-  io.log(answer ?? "(no answer \u2014 the profile may be empty or the service is unreachable)");
+  const result = await dialecticChat(hc, peer, safeQuery, { target: opts.target });
+  if (opts.json) {
+    return io.log(JSON.stringify({
+      peer,
+      query,
+      answer: result.status === "ok" ? result.data : null,
+      status: result.status,
+      ...result.status === "error" ? { error: { httpStatus: result.httpStatus, message: result.message } } : {}
+    }));
+  }
+  if (result.status === "error") {
+    io.err(`honcho chat: request failed${result.httpStatus ? ` (${result.httpStatus})` : ""}${result.message ? `: ${result.message}` : ""}`);
+    return;
+  }
+  io.log(result.status === "ok" ? result.data : "(no answer \u2014 the profile may be empty or not yet built)");
 }
 async function runHonchoHealth(o, io = consoleIo) {
   const cfg = await loadConfig();
@@ -5587,12 +5648,19 @@ async function runHonchoHealth(o, io = consoleIo) {
   const apiKey = await honchoApiKey();
   const hc = apiKey ? { apiUrl, apiKey, workspace } : null;
   const peer = honchoPeerId(await honchoLogin(cfg), cfg);
-  const liveness = hc ? await probeHoncho(hc, fetch, 3e3, { peer: peer ?? void 0 }) : { reachable: false, status: void 0, authOk: false, authStatus: void 0 };
+  const liveness = hc ? await probeHoncho(hc, fetch, 3e3, { peer: peer ?? void 0 }) : {
+    reachable: false,
+    status: void 0,
+    authOk: false,
+    authStatus: void 0,
+    queue: { pending: null, inProgress: null, stalled: false }
+  };
   const pending = readHonchoPending().length;
   const ingestSkip = readIngestSkip();
   const ingestSkipMessage = formatIngestSkip(ingestSkip);
+  const deriverStalled = liveness.queue.stalled;
   const report = {
-    ok: !!hc && liveness.reachable && liveness.authOk,
+    ok: !!hc && liveness.reachable && liveness.authOk && !deriverStalled,
     configured: !!hc,
     apiUrl,
     apiKeyConfigured: !!apiKey,
@@ -5603,6 +5671,11 @@ async function runHonchoHealth(o, io = consoleIo) {
     peer: peer ?? null,
     workspace,
     pending,
+    deriverQueue: {
+      pending: liveness.queue.pending,
+      inProgress: liveness.queue.inProgress,
+      stalled: deriverStalled
+    },
     ingestSkip: ingestSkip ?? null,
     ingestSkipMessage: ingestSkipMessage ?? null
   };
@@ -5610,6 +5683,7 @@ async function runHonchoHealth(o, io = consoleIo) {
   if (o.banner) {
     if (report.configured && !report.reachable) io.log(`honcho: configured but unreachable (${pending} pending)`);
     if (report.configured && report.reachable && !report.authOk) io.log("honcho: configured but API key rejected (401/403)");
+    if (deriverStalled) io.log(`honcho: deriver stalled (${liveness.queue.pending} pending, 0 in progress)`);
     if (ingestSkipMessage) io.log(`honcho: ${ingestSkipMessage}`);
     return;
   }
@@ -5618,8 +5692,12 @@ async function runHonchoHealth(o, io = consoleIo) {
   if (report.configured && !report.reachable) io.log(" - service unreachable");
   if (report.configured && report.reachable && !report.authOk) io.log(" - API key rejected (401/403) \u2014 rotate or fix vault path");
   if (!report.peer) io.log(" - no peer identity resolved (gh login) \u2014 ingest will be skipped");
+  if (deriverStalled) io.log(` - deriver stalled (${liveness.queue.pending} pending, 0 in progress)`);
   if (ingestSkipMessage) io.log(` - ${ingestSkipMessage}`);
   if (pending > 0) io.log(` - ${pending} ingest(s) queued locally`);
+  if (liveness.queue.pending != null && liveness.queue.pending > 0) {
+    io.log(` - deriver queue: ${liveness.queue.pending} pending, ${liveness.queue.inProgress ?? 0} in progress`);
+  }
 }
 async function runHonchoKey(o, io = consoleIo) {
   const cfg = await loadConfig();
@@ -7151,7 +7229,7 @@ ${buildReportBody(body, sourceRepo)}`;
 
 // src/skill-lesson.ts
 var SKILL_LESSON_LABEL = "skill-lesson";
-var SKILL_NAMES = ["bootstrap", "grind", "hotfix", "mmi", "rcand", "release", "secrets", "stage"];
+var SKILL_NAMES = ["bootstrap", "browser-automation", "grind", "hotfix", "mmi", "rcand", "release", "secrets", "stage"];
 function assertSkillName(name) {
   const match = SKILL_NAMES.find((skill) => skill === name);
   if (!match) throw new Error(`unknown skill "${name}" \u2014 expected one of: ${SKILL_NAMES.join(", ")}`);
@@ -7277,6 +7355,129 @@ function buildPanelPlan(input) {
   };
 }
 
+// src/grind-policy.ts
+var DEFAULT_SEARCH_DENY_DOMAINS = [
+  "stackoverflow.com",
+  "stackexchange.com",
+  "github.com/issues",
+  "reddit.com"
+];
+
+// src/verify-fusion.ts
+var DEFAULT_MODELS = {
+  builder: "builder-slot",
+  verifier: "verifier-slot",
+  third: "third-slot",
+  synthesizer: "verifier-slot"
+};
+function resolveFusionProviderUrl(explicit) {
+  if (explicit) return explicit;
+  const env = process.env.MMI_FUSION_PROVIDER_URL?.trim();
+  return env || null;
+}
+function buildFusionPlan(input) {
+  const routing = input.routing;
+  const lenses = input.lenses ?? [...GRIND_LENSES];
+  const provider = resolveFusionProviderUrl(input.providerUrl ?? void 0);
+  const models = {
+    ...DEFAULT_MODELS,
+    ...input.models,
+    synthesizer: input.models?.synthesizer ?? input.models?.third ?? input.models?.verifier ?? DEFAULT_MODELS.synthesizer
+  };
+  if (models.verifier === models.builder) {
+    throw new Error("fusion plan: verifier must not equal builder");
+  }
+  if (models.synthesizer === models.builder) {
+    throw new Error("fusion plan: synthesizer must not equal builder");
+  }
+  const toolPolicy = {
+    webSearch: Boolean(input.toolPolicy?.webSearch),
+    maxQueriesPerLens: input.toolPolicy?.maxQueriesPerLens ?? 3,
+    denyDomains: input.toolPolicy?.denyDomains ?? []
+  };
+  return {
+    provider,
+    routing,
+    lenses,
+    models,
+    toolPolicy,
+    criteria: input.criteria,
+    diff: input.diff,
+    fallback: "host-panel",
+    instructions: "Hosted fusion when provider is configured; else spawn host lenses and pipe JSON to `mmi-cli verify synthesize`. Synthesizer slot must differ from builder."
+  };
+}
+function adaptFusionResponse(raw) {
+  if (raw.lenses) {
+    const lenses = parseLensResults(raw.lenses);
+    const base2 = synthesizePanelReport(lenses);
+    return {
+      ...base2,
+      consensus: raw.consensus?.length ? raw.consensus : base2.consensus,
+      contradictions: raw.contradictions ?? base2.contradictions,
+      partial_coverage: raw.partial_coverage ?? base2.partial_coverage,
+      unique_insights: raw.unique_insights ?? base2.unique_insights,
+      blind_spots: raw.blind_spots ?? base2.blind_spots,
+      nits: raw.nits ?? base2.nits
+    };
+  }
+  const blockers = (raw.blockers ?? []).map((b, i) => ({
+    id: `fusion-${i}`,
+    title: b.title,
+    file: b.file,
+    line: b.line,
+    why: b.why,
+    sources: b.sources ?? ["hosted-fusion"]
+  }));
+  return {
+    consensus: raw.consensus ?? [],
+    contradictions: raw.contradictions ?? [],
+    partial_coverage: raw.partial_coverage ?? [],
+    unique_insights: raw.unique_insights ?? [],
+    blind_spots: raw.blind_spots ?? [],
+    blockers,
+    nits: raw.nits ?? []
+  };
+}
+async function runFusionProvider(plan2, deps = {}) {
+  const url = resolveFusionProviderUrl(deps.providerUrl ?? plan2.provider ?? void 0);
+  if (!url) {
+    return { ok: false, source: "fallback", error: "no fusion provider configured" };
+  }
+  const fetchImpl = deps.fetch ?? fetch;
+  const apiKey = deps.apiKey ?? process.env.MMI_FUSION_API_KEY?.trim();
+  const headers = { "content-type": "application/json" };
+  if (apiKey) headers.authorization = `Bearer ${apiKey}`;
+  try {
+    const res = await fetchImpl(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        routing: plan2.routing,
+        lenses: plan2.lenses,
+        models: plan2.models,
+        toolPolicy: plan2.toolPolicy,
+        criteria: plan2.criteria,
+        diff: plan2.diff
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) {
+      return { ok: false, source: "fallback", error: `provider HTTP ${res.status}` };
+    }
+    const body = await res.json();
+    return { ok: true, source: "hosted-fusion", report: adaptFusionResponse(body) };
+  } catch (e) {
+    return { ok: false, source: "fallback", error: e.message };
+  }
+}
+function parseFusionLenses(raw) {
+  return raw.split(",").map((s) => assertGrindLens(s.trim()));
+}
+function parseFusionRouting(raw) {
+  return assertVerifyRouting(raw);
+}
+
 // src/gc.ts
 var DEFERRED_SWEEP_COMMAND = "mmi-cli gc --apply";
 var DEFERRED_NOTE = "Worktree cleanup deferred \u2014 close this folder in your editor (or run cleanup from a shell outside it), then rerun mmi-cli gc --apply.";
@@ -7626,9 +7827,10 @@ function selectPrMergeCleanupWorktree(branch, before, after, startingPath) {
   if (startingPath && before.some((w) => w.branch === branch && samePath(w.path, startingPath))) return startingPath;
   return void 0;
 }
-function selectSafeWorktreeCwd(worktrees, targetPath) {
+function selectSafeWorktreeCwd(worktrees, targetPath, options) {
   if (!targetPath) return void 0;
-  return worktrees.find((w) => !samePath(w.path, targetPath))?.path;
+  const exists = options?.pathExists ?? (() => true);
+  return worktrees.find((w) => !samePath(w.path, targetPath) && exists(w.path))?.path;
 }
 function branchMissingFromList(branch, stdout) {
   const names = stdout.split(/\r?\n/).map((line) => line.replace(/^\*\s*/, "").trim()).filter(Boolean);
@@ -7659,7 +7861,9 @@ async function cleanupPrMergeLocalBranch(branch, options) {
   }
   const beforeWorktrees = options.beforeWorktrees ?? [];
   const wtPath = selectPrMergeCleanupWorktree(branch, beforeWorktrees, afterWorktrees, options.startingPath);
-  const safeCwd = selectSafeWorktreeCwd([...afterWorktrees, ...beforeWorktrees], wtPath);
+  const safeCwd = selectSafeWorktreeCwd([...afterWorktrees, ...beforeWorktrees], wtPath, {
+    pathExists: options.pathExists
+  });
   const git = (args) => safeCwd ? options.execGit(["-C", safeCwd, ...args]) : options.execGit(args);
   const removeDeps = {
     git,
@@ -7688,23 +7892,36 @@ async function cleanupPrMergeLocalBranch(branch, options) {
     if (outcome.status === "removed") {
       report.worktree = { path: wtPath, status: "removed", stageTeardown, recovery: outcome.recovery };
     } else if (isPersistentWorktreeLockFailure(outcome) && options.deferredStore) {
-      const { newlyRegistered } = await registerDeferredWorktree(options.deferredStore, {
-        path: wtPath,
-        branch,
-        reason: "lock-held"
-      });
-      report.worktree = {
-        path: wtPath,
-        status: "deferred",
-        reason: "lock-held",
-        error: outcome.error,
-        deferredNote: DEFERRED_NOTE,
-        deferredSweepCommand: DEFERRED_SWEEP_COMMAND,
-        ...newlyRegistered ? { safeCleanupCommand: safeWorktreeRemoveCommand(safeCwd, wtPath) } : {},
-        stageTeardown
-      };
-      report.localBranch = { name: branch, status: "not-attempted", reason: "worktree-removal-deferred" };
-      return report;
+      try {
+        const { newlyRegistered } = await registerDeferredWorktree(options.deferredStore, {
+          path: wtPath,
+          branch,
+          reason: "lock-held"
+        });
+        report.worktree = {
+          path: wtPath,
+          status: "deferred",
+          reason: "lock-held",
+          error: outcome.error,
+          deferredNote: DEFERRED_NOTE,
+          deferredSweepCommand: DEFERRED_SWEEP_COMMAND,
+          ...newlyRegistered ? { safeCleanupCommand: safeWorktreeRemoveCommand(safeCwd, wtPath) } : {},
+          stageTeardown
+        };
+        report.localBranch = { name: branch, status: "not-attempted", reason: "worktree-removal-deferred" };
+        return report;
+      } catch (e) {
+        report.worktree = {
+          path: wtPath,
+          status: "failed",
+          reason: "deferred-registry-unavailable",
+          error: errorMessage(e),
+          safeCleanupCommand: safeWorktreeRemoveCommand(safeCwd, wtPath),
+          stageTeardown
+        };
+        report.localBranch = { name: branch, status: "not-attempted", reason: "worktree-removal-failed" };
+        return report;
+      }
     } else {
       report.worktree = {
         path: wtPath,
@@ -8583,6 +8800,48 @@ function buildHubCompatCheck(input) {
   }
   return { ok: versionAtLeast(input.installedVersion, min), label: `${label}: requires >= ${min}`, fix: HUB_COMPAT_FIX };
 }
+var PLAYWRIGHT_MCP_VISION_CAP_LABEL = "Playwright MCP vision caps (--caps=vision prohibited)";
+var PLAYWRIGHT_MCP_VISION_CAP_FIX = "remove --caps=vision (and vision-first defaults) from Playwright MCP args \u2014 use DOM-first tools; see skills/browser-automation/SKILL.md and bootstrap seed mcp-playwright.template.json";
+function textHasPlaywrightVisionCap(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  if (/(?:^|[\s"'`=])--caps=(?:[^"\s\n]*,)?vision\b/m.test(normalized)) return true;
+  if (/\b--caps\s*=\s*["']?vision\b/.test(normalized)) return true;
+  if (/"--caps"\s*,\s*"vision"/.test(normalized)) return true;
+  if (/"caps"\s*:\s*"vision"/.test(normalized)) return true;
+  const playwrightMcp = /@playwright\/mcp/.test(normalized) || /mcp_servers\.playwright/.test(normalized) || /"playwright"\s*:\s*\{/.test(normalized) || /\bmcpServers\b/.test(normalized);
+  if (!playwrightMcp) return false;
+  if (/\bvision[-_]?(?:first|only|mode)\b/i.test(normalized)) return true;
+  return false;
+}
+function buildPlaywrightMcpVisionCapCheck(input) {
+  const base2 = {
+    ok: true,
+    label: PLAYWRIGHT_MCP_VISION_CAP_LABEL,
+    fix: PLAYWRIGHT_MCP_VISION_CAP_FIX
+  };
+  if (!input.isOrgRepo) return base2;
+  const offending = input.configs.filter((c) => textHasPlaywrightVisionCap(c.content)).map((c) => c.path);
+  if (offending.length === 0) return base2;
+  return {
+    ...base2,
+    ok: false,
+    offendingPaths: offending,
+    fix: `${PLAYWRIGHT_MCP_VISION_CAP_FIX} \u2014 found in: ${offending.join(", ")}`
+  };
+}
+var STRAY_BROWSER_ARTIFACT_DIRS = [".playwright-mcp", "playwright-report", "test-results"];
+var BROWSER_ARTIFACTS_LABEL = "browser MCP artifacts outside tmp/ (use tmp/playwright-mcp)";
+var BROWSER_ARTIFACTS_FIX = "move or delete stray Playwright output at repo root; re-run MCP with --output-dir tmp/playwright-mcp \u2014 see skills/browser-automation/SKILL.md";
+function buildBrowserArtifactsCheck(input) {
+  const base2 = { ok: true, label: BROWSER_ARTIFACTS_LABEL, fix: BROWSER_ARTIFACTS_FIX };
+  if (!input.isOrgRepo || input.strayPaths.length === 0) return base2;
+  return {
+    ...base2,
+    ok: false,
+    strayPaths: [...input.strayPaths],
+    fix: `${BROWSER_ARTIFACTS_FIX} \u2014 found: ${input.strayPaths.join(", ")}`
+  };
+}
 
 // src/stage-live.ts
 var import_node_net = require("node:net");
@@ -8956,10 +9215,22 @@ function resolveDeployModel(meta, repo) {
 function projectTypeClearsWebProfile(projectType, deployModel) {
   return projectType === "content" || projectType === "desktop-game" || projectType === "non-deployable" || projectType === "cli-tool" || deployModel === "content" || deployModel === "none" || deployModel === "registry-publish";
 }
-function resolveReleaseTrack(meta) {
+function inferReleaseTrackFromBranches(hints) {
+  if (hints.hasRcBranch) return void 0;
+  if (hints.hasDevelopmentBranch && hints.hasMainBranch) return "direct";
+  return void 0;
+}
+function resolveBootstrapReleaseTrack(cls, explicit) {
+  if (isReleaseTrack(explicit)) return explicit;
+  if (cls === "content") return "trunk";
+  return "full";
+}
+function resolveReleaseTrack(meta, hints) {
   const raw = typeof meta?.releaseTrack === "string" ? meta.releaseTrack : void 0;
   if (isReleaseTrack(raw)) return raw;
   if (meta?.class === "content" || meta?.deployModel === "content") return "trunk";
+  const inferred = hints ? inferReleaseTrackFromBranches(hints) : void 0;
+  if (inferred) return inferred;
   return "full";
 }
 function branchesForTrack(track) {
@@ -9110,6 +9381,18 @@ function ensurePositiveCount(out, emptyMessage) {
   if (!Number.isFinite(count)) throw new Error(`could not parse ahead count: ${out.trim() || "(empty)"}`);
   if (count <= 0) throw new Error(emptyMessage);
 }
+async function remoteBranchExists(deps, branch) {
+  const out = clean(await deps.run("git", ["ls-remote", "origin", `refs/heads/${branch}`]));
+  return out.length > 0;
+}
+async function loadReleaseTrackBranchHints(deps) {
+  const [hasDevelopmentBranch, hasMainBranch, hasRcBranch] = await Promise.all([
+    remoteBranchExists(deps, "development"),
+    remoteBranchExists(deps, "main"),
+    remoteBranchExists(deps, "rc")
+  ]);
+  return { hasDevelopmentBranch, hasMainBranch, hasRcBranch };
+}
 async function buildTrainApplyContext(deps) {
   const repo = requireValue(clean(await deps.run("gh", ["repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"])), "repo");
   const [owner, name] = repo.split("/");
@@ -9543,7 +9826,8 @@ async function runTrainApply(command, deps, options = {}) {
   await requireCleanTree(deps);
   await deps.run("git", ["fetch", "origin"]);
   const meta = requireProjectMetaForTrain(await loadProjectMeta(deps, ctx), ctx.repo);
-  const directTrack = isHubControlRepo(ctx.repo) || resolveReleaseTrack(meta) === "direct";
+  const branchHints = await loadReleaseTrackBranchHints(deps);
+  const directTrack = isHubControlRepo(ctx.repo) || resolveReleaseTrack(meta, branchHints) === "direct";
   if (command === "rcand") {
     await requireBranch(deps, "development");
     if (directTrack) {
@@ -9635,13 +9919,16 @@ async function runTrainApply(command, deps, options = {}) {
   if (command === "release" && options.dev) {
     await requireBranch(deps, "development");
     await ffOnlyPull(deps, "development");
-    const rcOnlyOut = (await deps.run("git", ["rev-list", "--count", "--right-only", "--cherry-pick", "--no-merges", "origin/development...origin/rc"])).trim();
-    const rcOnly = Number.parseInt(rcOnlyOut, 10);
-    if (!Number.isFinite(rcOnly)) throw new Error(`release --dev: could not count rc-only commits for the guard: ${rcOnlyOut || "(empty)"}`);
-    if (rcOnly > 0) {
-      throw new Error(
-        `release --dev refused: origin/rc carries ${rcOnly} commit(s) not in origin/development \u2014 a development -> main release would drop that rc-only content. Land it on development first, or release the candidate via the default rc -> main path, then rerun.`
-      );
+    const hasRcBranch = branchHints.hasRcBranch ?? false;
+    if (hasRcBranch) {
+      const rcOnlyOut = (await deps.run("git", ["rev-list", "--count", "--right-only", "--cherry-pick", "--no-merges", "origin/development...origin/rc"])).trim();
+      const rcOnly = Number.parseInt(rcOnlyOut, 10);
+      if (!Number.isFinite(rcOnly)) throw new Error(`release --dev: could not count rc-only commits for the guard: ${rcOnlyOut || "(empty)"}`);
+      if (rcOnly > 0) {
+        throw new Error(
+          `release --dev refused: origin/rc carries ${rcOnly} commit(s) not in origin/development \u2014 a development -> main release would drop that rc-only content. Land it on development first, or release the candidate via the default rc -> main path, then rerun.`
+        );
+      }
     }
     ensurePositiveCount(
       await deps.run("git", ["rev-list", "--count", "origin/main..origin/development"]),
@@ -9649,7 +9936,7 @@ async function runTrainApply(command, deps, options = {}) {
     );
     const deployModel2 = await preflight(deps, ctx, "main", meta);
     const tag2 = requireValue(clean(await deps.run("node", ["scripts/next-version.mjs", "cycle"])), "release tag");
-    const rcShaAtRelease = clean(await deps.run("git", ["rev-parse", "origin/rc"]));
+    const rcShaAtRelease = hasRcBranch ? clean(await deps.run("git", ["rev-parse", "origin/rc"])) : "";
     const foldPaths2 = await resolveFoldPaths(deps, deployModel2);
     const tolerated2 = [...foldPaths2, ...RELEASE_TOLERATED_PATHS];
     const predicted2 = await predictMergeConflicts(deps, "origin/main", "origin/development");
@@ -9677,14 +9964,18 @@ async function runTrainApply(command, deps, options = {}) {
     const announceNote2 = deps.announce ? (await deps.announce({ repo: ctx.repo, tag: tag2, summaryFile: options.announceSummaryFile })).note : void 0;
     const autoRunSince2 = (deps.now ?? Date.now)();
     const d2 = await dispatchDeploy(deps, ctx, "main", "main", deployModel2, watch, autoRunSince2, releaseSha2, "report");
-    const retirement2 = await retireRcRuntime(deps, ctx, deployModel2, d2.deployStatus, rcShaAtRelease);
+    const retirement2 = hasRcBranch ? await retireRcRuntime(deps, ctx, deployModel2, d2.deployStatus, rcShaAtRelease) : { status: "not-applicable", note: "no origin/rc branch \u2014 rc runtime retirement skipped" };
     const devRollForward2 = await rollDevelopmentForward(deps, ctx, tag2);
     let rcAlignment2;
-    try {
-      await deps.run("git", ["push", "origin", "main:rc"]);
-      rcAlignment2 = "origin/rc aligned to the released main";
-    } catch (e) {
-      rcAlignment2 = `rc alignment push failed \u2014 align manually with \`git push origin main:rc\`: ${e instanceof Error ? e.message : String(e)}`;
+    if (hasRcBranch) {
+      try {
+        await deps.run("git", ["push", "origin", "main:rc"]);
+        rcAlignment2 = "origin/rc aligned to the released main";
+      } catch (e) {
+        rcAlignment2 = `rc alignment push failed \u2014 align manually with \`git push origin main:rc\`: ${e instanceof Error ? e.message : String(e)}`;
+      }
+    } else {
+      rcAlignment2 = "no origin/rc branch \u2014 rc alignment skipped";
     }
     const environments2 = await buildEnvironments(deps, ctx, deployModel2, d2.deployStatus, retirement2);
     return {
@@ -11298,8 +11589,9 @@ function parseOwnerRepo(repo) {
 }
 var DEFAULT_INSTALL_CMD = "npm ci";
 var DEFAULT_GATE_CMD = "npm run check";
-function gateSeedVars(cls) {
-  if (cls === "content") {
+function gateSeedVars(cls, releaseTrack) {
+  const track = releaseTrack ?? (cls === "content" ? "trunk" : "full");
+  if (track === "trunk") {
     return {
       GATE_CMD: DEFAULT_GATE_CMD,
       GATE_PUSH_BRANCHES_YAML: "[main]",
@@ -11307,6 +11599,14 @@ function gateSeedVars(cls) {
       GATE_RULESET_BRANCH_REFS_JSON: '["refs/heads/main"]'
     };
   }
+  if (track === "direct") {
+    return {
+      GATE_CMD: DEFAULT_GATE_CMD,
+      GATE_PUSH_BRANCHES_YAML: "[development, main]",
+      GATE_FULL_RUN_BRANCH: "development",
+      GATE_RULESET_BRANCH_REFS_JSON: '["refs/heads/development", "refs/heads/main"]'
+    };
+  }
   return {
     GATE_CMD: DEFAULT_GATE_CMD,
     GATE_PUSH_BRANCHES_YAML: "[development, rc, main]",
@@ -11314,13 +11614,14 @@ function gateSeedVars(cls) {
     GATE_RULESET_BRANCH_REFS_JSON: '["refs/heads/development", "refs/heads/rc", "refs/heads/main"]'
   };
 }
-function withDerivedRepoVars(vars, parsed, cls) {
+function withDerivedRepoVars(vars, parsed, cls, releaseTrack) {
   const out = { ...vars };
   out.REPO_NAME ??= parsed.name;
   out.REPO_SLUG ??= parsed.slug;
   out.CLASS ??= cls;
   out.INSTALL_CMD ??= DEFAULT_INSTALL_CMD;
-  for (const [key, value] of Object.entries(gateSeedVars(cls))) {
+  const track = releaseTrack ?? resolveBootstrapReleaseTrack(cls);
+  for (const [key, value] of Object.entries(gateSeedVars(cls, track))) {
     out[key] ??= value;
   }
   return out;
@@ -11432,8 +11733,8 @@ function buildRegisterPayload(repo, cls, vars, options = {}) {
     class: cls,
     projectType,
     deployModel,
-    // #917: only emit when explicitly direct/trunk; absent → registry resolves to `full` (no clobber).
-    releaseTrack: isReleaseTrack(options.releaseTrack) ? options.releaseTrack : void 0,
+    // #1359: always persist an explicit track so release tooling never guesses from absence alone.
+    releaseTrack: resolveBootstrapReleaseTrack(cls, options.releaseTrack),
     // Board coords (from GraphQL at bootstrap, passed as --var by the skill).
     projectOwner: vars.PROJECT_OWNER || void 0,
     projectNumber: num(vars.PROJECT_NUMBER),
@@ -11447,6 +11748,11 @@ function buildRegisterPayload(repo, cls, vars, options = {}) {
     kbPointer: `kb/projects/${slug}.md`
   };
   for (const k of Object.keys(payload)) if (payload[k] === void 0) delete payload[k];
+  if (payload.projectId && payload.projectNumber == null) {
+    throw new Error(
+      "bootstrap apply: PROJECT_ID is set but PROJECT_NUMBER is missing \u2014 pass --var PROJECT_NUMBER=<N> or ensure the live board GraphQL query succeeds"
+    );
+  }
   return payload;
 }
 var BOARD_FIELD_VAR_MAP = {
@@ -11459,9 +11765,18 @@ var BOARD_FIELD_VAR_MAP = {
     options: { Urgent: "PRIORITY_URGENT", High: "PRIORITY_HIGH", Medium: "PRIORITY_MEDIUM", Low: "PRIORITY_LOW" }
   }
 };
+function projectV2BoardNode(fieldsJson) {
+  if (Array.isArray(fieldsJson)) return { fields: { nodes: fieldsJson } };
+  const wrapped = fieldsJson;
+  return wrapped?.data?.node ?? wrapped?.node;
+}
 function extractBoardFieldVars(fieldsJson) {
   const out = {};
-  const nodes = Array.isArray(fieldsJson) ? fieldsJson : fieldsJson?.data?.node?.fields?.nodes ?? fieldsJson?.node?.fields?.nodes;
+  const projectNode = projectV2BoardNode(fieldsJson);
+  if (typeof projectNode?.number === "number" && Number.isFinite(projectNode.number)) {
+    out.PROJECT_NUMBER = String(projectNode.number);
+  }
+  const nodes = projectNode?.fields?.nodes;
   if (!Array.isArray(nodes)) return out;
   for (const node of nodes) {
     const field = node;
@@ -11479,7 +11794,7 @@ function extractBoardFieldVars(fieldsJson) {
   return out;
 }
 function boardFieldsQueryArgs(projectId) {
-  const query = "query($id: ID!) { node(id: $id) { ... on ProjectV2 { fields(first: 50) { nodes { ... on ProjectV2SingleSelectField { id name options { id name } } } } } } }";
+  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 serializeRegistry(obj) {
@@ -11724,6 +12039,14 @@ function dnsErrorToResolution(code) {
 }
 var STAGES = ["dev", "rc", "main"];
 var DEFAULT_RUNTIME_SECRET_NAMES2 = ["GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET"];
+function boardRegistryGaps(meta) {
+  if (!meta?.projectId) return [];
+  if (meta.projectNumber != null) return [];
+  return ["projectNumber"];
+}
+function boardRegistryGapMessage(repo) {
+  return `Board META incomplete for ${repo}: registry has projectId but no projectNumber \u2014 board claim and auto-add will fail until projectNumber is backfilled (re-run \`node infra/migrate/seed-registry.mjs\` or \`mmi-cli bootstrap apply --execute\` with board vars)`;
+}
 function slugOfRepo(repoOrSlug) {
   return (repoOrSlug.includes("/") ? repoOrSlug.split("/").pop() : repoOrSlug).toLowerCase();
 }
@@ -11922,6 +12245,7 @@ function buildV2HealPatch(repoOrSlug, meta) {
     }
   }
   const appOwnedGaps = confidentType ? appGapsFor(meta, model, slug, confidentType) : [`Project type is unset and not derivable \u2014 classify with \`mmi-cli project set ${repo} --project-type <web-app|hub-service|content|desktop-game|non-deployable|cli-tool|worker> --deploy-model <tenant-container|solo-container|hub-serverless|serverless|registry-publish|content|none>\` before heal completes the v2 fields (prevents defaulting a non-web repo to tenant-container).`];
+  if (boardRegistryGaps(meta).length) appOwnedGaps.unshift(boardRegistryGapMessage(repo));
   return { slug, patch, appOwnedGaps };
 }
 async function runV2Heal(repoOrSlug, opts, deps) {
@@ -12011,7 +12335,7 @@ async function buildV2Doctor(repoOrSlug, deps) {
     const missing = required.filter((key) => !presentSecrets.has(key));
     return [stage2, { required, present, missing }];
   }));
-  const metaMissing = ["class", "projectType", "deployModel", "vaultPath", "kbPointer"].filter((key) => meta[key] === void 0);
+  const metaMissing = ["class", "projectType", "deployModel", "vaultPath", "kbPointer"].filter((key) => meta[key] === void 0).concat(boardRegistryGaps(meta));
   const ok = !secretsError && metaMissing.length === 0 && Object.values(deployCoords).every((v) => v.ok) && Object.values(secrets2).every((v) => v.missing.length === 0);
   const edgeDomainWarnings = deps.resolveDns ? await probeEdgeDomains(meta, deps.resolveDns) : [];
   return {
@@ -12732,9 +13056,13 @@ async function relevantPlans(deps, signals, opts = {}) {
     deps.err(`northstar relevant: ${e.message}`);
     return;
   }
-  if (!plans.length) return deps.log("no North Stars for this repo yet");
+  if (!plans.length) {
+    if (opts.json) return deps.log(JSON.stringify({ ranked: [] }));
+    return deps.log("no North Stars for this repo yet");
+  }
   const ranked = rankPlansByRelevance(plans, signals, { includeAll: opts.includeAll });
   const top = (opts.includeAll ? ranked : ranked.filter((r) => r.score > 0)).slice(0, opts.limit ?? 5);
+  if (opts.json) return deps.log(JSON.stringify({ ranked: top }));
   if (!top.length) {
     return deps.log(`no task-relevant North Stars among ${plans.length} for this repo \u2014 \`mmi-cli northstar relevant --all\` lists recent ones`);
   }
@@ -12816,9 +13144,14 @@ async function planSync(deps, opts = {}) {
     if (!opts.quiet) deps.err(`northstar sync: list refresh failed: ${e.message}`);
   }
 }
-async function planStatus(deps) {
+async function planStatus(deps, opts = {}) {
   const queue = parseQueue(deps.readQueueRaw());
   const idx = parseIndex(deps.readIndexRaw());
+  if (opts.json) {
+    deps.log(JSON.stringify({ queue, index: idx }));
+    if (queue.some((e) => e.conflict || e.deadLettered)) process.exitCode = 1;
+    return;
+  }
   for (const e of queue) {
     if (e.conflict) deps.err(`${e.slug}  \xB7  CONFLICT \u2014 ${e.conflict}`);
     else if (e.deadLettered) deps.err(`${e.slug}  \xB7  DEAD-LETTER \u2014 ${e.deadLettered}`);
@@ -13277,7 +13610,7 @@ async function runWhoami(io = consoleIo) {
   io.log(JSON.stringify(report));
   return report;
 }
-program2.command("whoami").description('resolve the logged-in human: {login, source, sessionExpiresAt} JSON; source "unknown" (exit 0) when neither the Hub session nor gh can name them').action(async () => {
+program2.command("whoami").description('resolve the logged-in human: {login, source, sessionExpiresAt} JSON; source "unknown" (exit 0) when neither the Hub session nor gh can name them').option("--json", "machine-readable output (default)").action(async () => {
   await runWhoami();
 });
 program2.command("gc").description("dry-run cleanup for merged/closed PR branches and stale tracking refs").option("--dry-run", "show what would be deleted (default)").option("--apply", "delete only the listed clean merged/closed PR branches and stale tracking refs").option("--json", "machine-readable output").option("--remote <name>", "remote name", "origin").option("--limit <n>", "PRs to inspect per state", "200").action(async (o) => {
@@ -13560,12 +13893,12 @@ function registerNorthStarCommands(cmd) {
     if (!ok) process.exitCode = 1;
   }));
   cmd.command("list").description("list your North Star plans (cross-device)").option("--project <name>", "filter by project").option("--json", "machine-readable output").option("--quiet", "silent when unconfigured/empty/unreachable (SessionStart hook)").option("--fresh", "bypass the local cache and read from the server").action((o) => withPlan(o.quiet ?? false, (d) => planList(d, o)));
-  cmd.command("relevant").description("list North Stars relevant to your current task (branch + claimed issue + changed files)").option("--project <name>", "override the project key").option("--all", "include superseded/graduated and recent non-matching plans").option("--limit <n>", "max results (default 5)").option("--fresh", "bypass the local cache and read from the server").action((o) => withPlan(false, async (d) => {
+  cmd.command("relevant").description("list North Stars relevant to your current task (branch + claimed issue + changed files)").option("--project <name>", "override the project key").option("--all", "include superseded/graduated and recent non-matching plans").option("--limit <n>", "max results (default 5)").option("--fresh", "bypass the local cache and read from the server").option("--json", "machine-readable output").action((o) => withPlan(false, async (d) => {
     const signals = await gatherRelevanceSignals();
-    await relevantPlans(d, signals, { project: o.project, includeAll: o.all, limit: o.limit ? Number(o.limit) : void 0, fresh: o.fresh });
+    await relevantPlans(d, signals, { project: o.project, includeAll: o.all, limit: o.limit ? Number(o.limit) : void 0, fresh: o.fresh, json: o.json });
   }));
   cmd.command("sync").description("drain queued background pushes and refresh the local plan index").option("--quiet", "silent (background worker)").action((o) => withPlan(o.quiet ?? false, (d) => planSync(d, o)));
-  cmd.command("status").description("show pending/conflicted background pushes and the plan-cache age").action(() => withPlan(false, (d) => planStatus(d)));
+  cmd.command("status").description("show pending/conflicted background pushes and the plan-cache age").option("--json", "machine-readable output").action((o) => withPlan(false, (d) => planStatus(d, o)));
   cmd.command("reconcile").description("refresh stale local etags from the server without --force (recovers from an object-store re-stamp)").action(() => withPlan(false, (d) => planReconcile(d)));
   cmd.command("open <slug>").description("pull if needed, then open plans/<slug>.md in $EDITOR").option("--project <name>", "override the project key").action(
     (slug, o) => withPlan(false, async (d) => {
@@ -14204,6 +14537,41 @@ verify.command("synthesize").description("merge lens JSON array into a PanelRepo
     return fail(`verify synthesize: ${e.message}`);
   }
 });
+var fusion = verify.command("fusion").description("optional hosted fusion provider for grind verify (#1377)");
+fusion.command("plan").description("plan a hosted fusion job \u2014 print FusionPlan JSON (falls back to host panel when provider unset)").requiredOption("--criteria-file <path>", "UTF-8 file with success criteria").requiredOption("--diff-file <path>", "UTF-8 file with git diff output").option("--routing <routing>", "Balanced | Budget | Paranoid", "Balanced").option("--lenses <list>", `comma-separated lens names (default: ${GRIND_LENSES.join(",")})`, GRIND_LENSES.join(",")).option("--provider-url <url>", "fusion provider base URL (else MMI_FUSION_PROVIDER_URL)").option("--web-search", "enable bounded web search in fusion tool policy").action(async (o) => {
+  try {
+    const routing = parseFusionRouting(o.routing);
+    const lenses = parseFusionLenses(o.lenses);
+    const criteria = await (0, import_promises5.readFile)(o.criteriaFile, "utf8");
+    const diff = await (0, import_promises5.readFile)(o.diffFile, "utf8");
+    const plan2 = buildFusionPlan({
+      routing,
+      lenses,
+      criteria,
+      diff,
+      providerUrl: o.providerUrl ?? null,
+      toolPolicy: {
+        webSearch: Boolean(o.webSearch),
+        maxQueriesPerLens: 3,
+        denyDomains: [...DEFAULT_SEARCH_DENY_DOMAINS]
+      }
+    });
+    console.log(JSON.stringify(plan2));
+  } catch (e) {
+    return fail(`verify fusion plan: ${e.message}`);
+  }
+});
+fusion.command("run").description("execute hosted fusion from a FusionPlan JSON file; prints PanelReport or fallback envelope").requiredOption("--plan-file <path>", "UTF-8 FusionPlan JSON from verify fusion plan").option("--provider-url <url>", "override fusion provider URL (else plan.provider or MMI_FUSION_PROVIDER_URL)").action(async (o) => {
+  try {
+    const raw = await (0, import_promises5.readFile)(o.planFile, "utf8");
+    const plan2 = JSON.parse(raw);
+    const result = await runFusionProvider(plan2, { providerUrl: o.providerUrl ?? plan2.provider ?? null });
+    console.log(JSON.stringify(result));
+    if (!result.ok) process.exitCode = 1;
+  } catch (e) {
+    return fail(`verify fusion run: ${e.message}`);
+  }
+});
 program2.command("skill-lesson").description("file a skill-lesson on the Hub board (GitHub auth, dedups open lessons) and print {number,url} JSON").requiredOption("--skill <name>", `which skill misfired (${SKILL_NAMES.join(" | ")})`).option("--title <title>", "one-line summary of what misfired").option("--title-file <path|->", "read the one-line summary from a UTF-8 file, or from stdin with -").option("--body <body>", "lesson body: what misfired, the evidence, and the proposed amendment (markdown)").option("--body-file <path|->", "read the lesson body from a UTF-8 file, or from stdin with -").option("--priority <priority>", "urgent | high | medium | low (board Priority field when configured)", "medium").option("--repo <owner/repo>", `target repo (defaults to the org Hub: ${HUB_REPO})`).option("--force", "file a new issue even when an open lesson looks like a duplicate").option("--json", "machine-readable output (already the default \u2014 skill-lesson always prints JSON)").action(async (o) => {
   const targetRepo2 = o.repo ?? HUB_REPO;
   const sourceRepo = await resolveRepo(void 0);
@@ -14276,7 +14644,7 @@ pr.command("create").description("create a PR and print {number,url} JSON").opti
   const created = await ghCreate(buildPrArgs({ title, body, base: o.base, head: o.head, repo: o.repo }));
   console.log(JSON.stringify(created));
 });
-async function remoteBranchExists(branch, options = {}) {
+async function remoteBranchExists2(branch, options = {}) {
   return checkRemoteBranchExists(branch, {
     execGit: async (args) => (await execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })).stdout
   }, options);
@@ -14295,7 +14663,11 @@ async function createDeferredWorktreeStore() {
         }
       },
       write: async (entries) => {
-        await (0, import_promises5.writeFile)(registryPath, serializeDeferredWorktrees(entries), "utf8");
+        try {
+          await (0, import_promises5.mkdir)((0, import_node_path13.dirname)(registryPath), { recursive: true });
+          await (0, import_promises5.writeFile)(registryPath, serializeDeferredWorktrees(entries), "utf8");
+        } catch {
+        }
       }
     };
   } catch {
@@ -14330,7 +14702,7 @@ pr.command("merge <number>").description("merge a PR (squash by default) and cle
   const beforeWorktrees = parseWorktreePorcelain(
     (await execFileP2("git", ["worktree", "list", "--porcelain"], { timeout: GIT_TIMEOUT_MS }).catch(() => ({ stdout: "" }))).stdout
   );
-  const remoteBefore = repoArgs.length ? void 0 : await remoteBranchExists(headRef);
+  const remoteBefore = repoArgs.length ? void 0 : await remoteBranchExists2(headRef);
   let remoteDeleteAttempted = false;
   let remoteNotAttemptedReason = repoArgs.length ? "repo-option" : void 0;
   await execFileP2("gh", buildPrMergeArgs({ number, repoArgs, method, auto: o.auto }), { timeout: GH_MUTATION_TIMEOUT_MS }).catch((e) => {
@@ -14358,25 +14730,39 @@ pr.command("merge <number>").description("merge a PR (squash by default) and cle
     attempted: false,
     reason: remoteNotAttemptedReason
   }) : await buildPrMergeRemoteBranchCleanupReport(headRef, {
-    exists: remoteBranchExists
+    exists: remoteBranchExists2
   }, {
     attempted: remoteDeleteAttempted,
     existedBefore: remoteBefore,
     reason: remoteNotAttemptedReason
   });
   const deferredStore = await createDeferredWorktreeStore();
-  const localCleanup = repoArgs.length ? {
-    branch: headRef,
-    localBranch: { name: headRef, status: "not-attempted", reason: "repo-option" },
-    worktree: void 0
-  } : await cleanupPrMergeLocalBranch(headRef, {
-    beforeWorktrees,
-    startingPath,
-    execGit: async (args) => (await execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })).stdout,
-    teardownWorktreeStage,
-    deferredStore,
-    removeWorktreeDir: worktreeRemoveDeps(async (args) => (await execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })).stdout).removeWorktreeDir
-  });
+  let localCleanup;
+  try {
+    localCleanup = repoArgs.length ? {
+      branch: headRef,
+      localBranch: { name: headRef, status: "not-attempted", reason: "repo-option" },
+      worktree: void 0
+    } : await cleanupPrMergeLocalBranch(headRef, {
+      beforeWorktrees,
+      startingPath,
+      pathExists: (p) => (0, import_node_fs14.existsSync)(p),
+      execGit: async (args) => (await execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })).stdout,
+      teardownWorktreeStage,
+      deferredStore,
+      removeWorktreeDir: worktreeRemoveDeps(async (args) => (await execFileP2("git", args, { timeout: GIT_TIMEOUT_MS })).stdout).removeWorktreeDir
+    });
+  } catch (e) {
+    localCleanup = {
+      branch: headRef,
+      localBranch: {
+        name: headRef,
+        status: "failed",
+        reason: "cleanup-exception",
+        error: e instanceof Error ? e.message : String(e)
+      }
+    };
+  }
   console.log(JSON.stringify(buildPrMergeResultPayload({
     number,
     branch: headRef,
@@ -14938,6 +15324,7 @@ bootstrap.command("apply <repo>").description("idempotent seed apply from skills
     json: rawFlag("--json")
   };
   if (o.class !== "deployable" && o.class !== "content") return fail("bootstrap apply: --class must be deployable or content");
+  const bootstrapReleaseTrack = resolveBootstrapReleaseTrack(o.class, o.releaseTrack || void 0);
   let parsedRepo;
   try {
     parsedRepo = parseOwnerRepo(repo);
@@ -14957,7 +15344,7 @@ bootstrap.command("apply <repo>").description("idempotent seed apply from skills
     const eq = value.indexOf("=");
     if (eq > 0) rawVars[value.slice(0, eq)] = value.slice(eq + 1);
   }
-  const vars = withDerivedRepoVars(rawVars, parsedRepo, o.class);
+  const vars = withDerivedRepoVars(rawVars, parsedRepo, o.class, bootstrapReleaseTrack);
   if (vars.PROJECT_ID) {
     try {
       const r = await gh(boardFieldsQueryArgs(vars.PROJECT_ID));
@@ -15025,7 +15412,7 @@ bootstrap.command("apply <repo>").description("idempotent seed apply from skills
     registerPayload = buildRegisterPayload(repo, o.class, vars, {
       projectType: o.projectType || void 0,
       deployModel: o.deployModel || void 0,
-      releaseTrack: o.releaseTrack || void 0
+      releaseTrack: bootstrapReleaseTrack
     });
   } catch (e) {
     return fail(`bootstrap apply: ${e.message}`);
@@ -15329,6 +15716,39 @@ function quarantinePluginCacheDirs(plan2) {
   return moved;
 }
 var gitignorePath = () => (0, import_node_path13.join)(process.cwd(), ".gitignore");
+function readTextFile(path2) {
+  try {
+    if (!(0, import_node_fs14.existsSync)(path2)) return null;
+    return (0, import_node_fs14.readFileSync)(path2, "utf8");
+  } catch {
+    return null;
+  }
+}
+function playwrightMcpConfigSnapshots() {
+  const cwd = process.cwd();
+  const home = (0, import_node_os4.homedir)();
+  const candidates = [
+    (0, import_node_path13.join)(cwd, ".cursor", "mcp.json"),
+    (0, import_node_path13.join)(home, ".cursor", "mcp.json"),
+    (0, import_node_path13.join)(home, ".codex", "config.toml")
+  ];
+  const out = [];
+  for (const path2 of candidates) {
+    const content = readTextFile(path2);
+    if (content != null) out.push({ path: path2, content });
+  }
+  return out;
+}
+function strayBrowserArtifactPaths() {
+  const cwd = process.cwd();
+  return STRAY_BROWSER_ARTIFACT_DIRS.filter((rel) => {
+    try {
+      return (0, import_node_fs14.existsSync)((0, import_node_path13.join)(cwd, rel));
+    } catch {
+      return false;
+    }
+  });
+}
 function readGitignore() {
   try {
     return (0, import_node_fs14.readFileSync)(gitignorePath(), "utf8");
@@ -15525,6 +15945,18 @@ async function runDoctor(opts, io = consoleIo) {
       mmiCliOnPath: onPath
     })
   );
+  checks.push(
+    buildPlaywrightMcpVisionCapCheck({
+      isOrgRepo: Boolean(cfg.sagaApiUrl),
+      configs: playwrightMcpConfigSnapshots()
+    })
+  );
+  checks.push(
+    buildBrowserArtifactsCheck({
+      isOrgRepo: Boolean(cfg.sagaApiUrl),
+      strayPaths: strayBrowserArtifactPaths()
+    })
+  );
   const gaps = checks.filter((c) => !c.ok);
   if (opts.banner) {
     if (gaps.length) io.log(`\u26A0 MMI setup needed \u2014 ${gaps.map((g) => g.fix).join(" \xB7 ")} \xB7 guide: ${MMI_AGENTIC_ONBOARDING_GUIDE.url}`);
@@ -15553,7 +15985,7 @@ async function runDoctor(opts, io = consoleIo) {
   io.log(gaps.length ? `
 ${gaps.length} item(s) need attention.` : "\nAll set \u2014 you are ready.");
 }
-program2.command("doctor").description("check onboarding gates (GitHub auth, mmi-cli on PATH, Hub API default, plugin git clone, plugin install record, .gitignore managed block, plugin config drift, installed plugin version, Cursor Team Marketplace plugin install), print fixes, and report per-surface versions + update recipes").option("--banner", "one-line resume summary; silent when all gates pass").option("--guide", "print the MMI Agentic Onboarding guide URL").option("--json", "machine-readable output (read-only inspection \u2014 performs no repairs)").option("--apply", "perform the same auto-repairs as the interactive run (combine with --json for a machine-readable repair run)").option("--no-repo-writes", "env/plugin repairs only \u2014 never mutate the repo working tree; report pending managed .gitignore repairs with the follow-up command (for train preflights)").action((opts) => (
+program2.command("doctor").description("check onboarding gates (GitHub auth, mmi-cli on PATH, Hub API default, plugin git clone, plugin install record, .gitignore managed block, plugin config drift, installed plugin version, Cursor Team Marketplace plugin install, Playwright MCP vision caps, browser artifact hygiene), print fixes, and report per-surface versions + update recipes").option("--banner", "one-line resume summary; silent when all gates pass").option("--guide", "print the MMI Agentic Onboarding guide URL").option("--json", "machine-readable output (read-only inspection \u2014 performs no repairs)").option("--apply", "perform the same auto-repairs as the interactive run (combine with --json for a machine-readable repair run)").option("--no-repo-writes", "env/plugin repairs only \u2014 never mutate the repo working tree; report pending managed .gitignore repairs with the follow-up command (for train preflights)").action((opts) => (
   // Commander maps `--no-repo-writes` to `repoWrites: false`; translate to the explicit `noRepoWrites` flag.
   runDoctor({ ...opts, noRepoWrites: opts.repoWrites === false })
 ));

package/dist/saga.cjs

@@ -4058,7 +4058,7 @@ function setInjectedStdin(payload) {
 }
 async function readStdin() {
   if (injectedStdin !== void 0) return injectedStdin;
-  if (process.stdin.isTTY) return "";
+  if (process.stdin.isTTY !== false) return "";
   const chunks = [];
   for await (const chunk of process.stdin) chunks.push(chunk);
   return Buffer.concat(chunks).toString("utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.31.0",
+  "version": "2.32.0",
   "description": "MMI Future CLI — delivers the org rules (whole-file), plus saga and KB access. The cross-IDE engine the plugin's SessionStart hook drives.",
   "type": "module",
   "license": "UNLICENSED",