@mutmutco/cli 2.49.0 → 2.50.1

package/dist/main.cjs

@@ -4582,18 +4582,32 @@ async function ffOnlyPull(deps, branch) {
   await deps.run("git", ["pull", "--ff-only", "origin", branch]);
 }
 var RELEASE_TOLERATED_PATHS = [".gitignore"];
-async function predictMergeConflicts(deps, ours, theirs) {
-  try {
-    await deps.run("git", ["merge-tree", "--write-tree", "--name-only", "--no-messages", ours, theirs]);
-    return [];
-  } catch (e) {
-    const out = String(e.stdout ?? "");
-    const files = out.split("\n").map((s) => s.trim()).filter(Boolean).slice(1);
-    if (files.length === 0) {
-      throw new Error(`could not preflight the ${theirs} -> ${ours} merge (git merge-tree failed: ${e.message ?? e})`);
+var MERGE_TREE_PREFLIGHT_ATTEMPTS = 3;
+var MERGE_TREE_PREFLIGHT_DELAY_MS = 250;
+function mergeTreeConflictFiles(stdout) {
+  return stdout.split("\n").map((s) => s.trim()).filter(Boolean).slice(1);
+}
+async function runMergeTreePreflight(deps, ours, theirs) {
+  const sleep = resolveSleep(deps);
+  let lastError;
+  for (let attempt = 0; attempt < MERGE_TREE_PREFLIGHT_ATTEMPTS; attempt++) {
+    try {
+      await deps.run("git", ["merge-tree", "--write-tree", "--name-only", "--no-messages", ours, theirs]);
+      return [];
+    } catch (e) {
+      lastError = e;
+      const files = mergeTreeConflictFiles(String(e.stdout ?? ""));
+      if (files.length > 0) return files;
+      if (attempt + 1 < MERGE_TREE_PREFLIGHT_ATTEMPTS) await sleep(MERGE_TREE_PREFLIGHT_DELAY_MS);
     }
-    return files;
   }
+  const msg = lastError?.message ?? String(lastError);
+  throw new Error(
+    `could not preflight the ${theirs} -> ${ours} merge (git merge-tree failed after ${MERGE_TREE_PREFLIGHT_ATTEMPTS} attempts: ${msg})`
+  );
+}
+async function predictMergeConflicts(deps, ours, theirs) {
+  return runMergeTreePreflight(deps, ours, theirs);
 }
 async function mergeWithSpineResolution(deps, sourceRef, label, resolve5, extraTolerated = []) {
   try {
@@ -17660,6 +17674,7 @@ async function applyCursorPluginCacheSeed(input) {
 
 // src/doctor.ts
 var GH_PROJECT_LOGIN_FIX = 'run: gh auth login --hostname github.com --git-protocol https --web --scopes "project"';
+var AWS_CROSS_ACCOUNT_LABEL = "AWS cross-account identity (master-agent audits)";
 var AWS_CROSS_ACCOUNT_FIX = "use a non-root IAM user/session profile for master-agent AWS checks; set AWS_PROFILE or AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY (plus AWS_SESSION_TOKEN for temporary credentials), then verify `aws sts get-caller-identity` does not end in :root";
 var MMI_AGENTIC_ONBOARDING_GUIDE = {
   label: "MMI Agentic Onboarding",
@@ -17680,7 +17695,7 @@ function buildAwsCrossAccountCheck(input) {
   const callerArn = input.callerArn?.trim();
   return {
     ok: !callerArn || !callerArn.endsWith(":root"),
-    label: "AWS cross-account identity (master-agent audits)",
+    label: AWS_CROSS_ACCOUNT_LABEL,
     fix: AWS_CROSS_ACCOUNT_FIX
   };
 }
@@ -18002,7 +18017,7 @@ function detectSurface(env) {
   if (env.MMI_AGENT_SURFACE === "cursor" || has("CURSOR_TRACE_ID") || has("CURSOR_USER") || has("CURSOR_SESSION_ID") || env.CURSOR_AGENT === "1" || has("CURSOR_EXTENSION_HOST_ROLE")) {
     return "cursor";
   }
-  if (env.MMI_AGENT_SURFACE === "opencode") return "opencode";
+  if (env.MMI_AGENT_SURFACE === "opencode" || has("OPENCODE_CLIENT") || has("OPENCODE_SERVER_USERNAME")) return "opencode";
   const isClaude = has("CLAUDECODE") || has("CLAUDE_CODE_ENTRYPOINT") || has("CLAUDE_PLUGIN_ROOT") || env.MMI_AGENT_SURFACE === "claude";
   const isVscode = env.TERM_PROGRAM === "vscode" || has("VSCODE_PID") || has("VSCODE_GIT_ASKPASS_NODE");
   if (isClaude && isVscode) return "claude-vscode";
@@ -18027,7 +18042,10 @@ function reloadAction(surface) {
 }
 var CLAUDE_RECOVERY = `claude plugin marketplace remove ${LEGACY_MMI_MARKETPLACE} && claude plugin marketplace remove mutmutco && claude plugin marketplace add mutmutco/MMI-Hub && claude plugin install mmi@mutmutco`;
 var CODEX_RECOVERY = `codex plugin marketplace remove ${LEGACY_MMI_MARKETPLACE} && codex plugin marketplace remove mutmutco && codex plugin marketplace add mutmutco/MMI-Hub --ref main && codex plugin add mmi@mutmutco`;
-var OPENCODE_RECOVERY = "npm install @mutmutco/opencode-mmi@latest";
+var OPENCODE_PLUGIN_PACKAGE = "@mutmutco/opencode-mmi";
+var OPENCODE_PLUGIN_SPEC = `${OPENCODE_PLUGIN_PACKAGE}@latest`;
+var OPENCODE_PLUGIN_INSTALL_COMMAND = `opencode plugin ${OPENCODE_PLUGIN_SPEC} --global --force`;
+var OPENCODE_RECOVERY = `${OPENCODE_PLUGIN_INSTALL_COMMAND}   # then restart OpenCode to load MMI commands`;
 var PLUGIN_SURFACE_HEAL = {
   claude: {
     delivery: "plugin-cli",
@@ -18067,8 +18085,8 @@ var PLUGIN_SURFACE_HEAL = {
     delivery: "npm",
     recovery: OPENCODE_RECOVERY,
     healSteps: null,
-    fix: (surface) => `${OPENCODE_RECOVERY}   # then ${reloadAction(surface)} to reload MMI skills`,
-    updateRecipe: [OPENCODE_RECOVERY, "npm ls @mutmutco/opencode-mmi   # verify the installed version, then restart OpenCode"]
+    fix: () => OPENCODE_RECOVERY,
+    updateRecipe: [OPENCODE_RECOVERY, "restart OpenCode, then run mmi-cli doctor to verify OpenCode plugin reports the released version"]
   }
 };
 var CLAUDE_PLUGIN_RECOVERY = PLUGIN_SURFACE_HEAL.claude.recovery;
@@ -18220,6 +18238,94 @@ function buildOpencodeVersionCheck(input) {
   }
   return { ...base, ok: false, installedVersion: input.installedVersion, releasedVersion: input.releasedVersion };
 }
+var OPENCODE_CONFIG_PLUGIN_LABEL = "OpenCode MMI adapter config wiring";
+function opencodePluginEntryMatches(entry) {
+  return entry === OPENCODE_PLUGIN_PACKAGE || entry === OPENCODE_PLUGIN_SPEC || Array.isArray(entry) && (entry[0] === OPENCODE_PLUGIN_PACKAGE || entry[0] === OPENCODE_PLUGIN_SPEC);
+}
+function stripJsonc(text) {
+  let out = "";
+  let inString = false;
+  let quote = "";
+  let escaped = false;
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text[i];
+    const next = text[i + 1];
+    if (inString) {
+      out += ch;
+      if (escaped) escaped = false;
+      else if (ch === "\\") escaped = true;
+      else if (ch === quote) inString = false;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      inString = true;
+      quote = ch;
+      out += ch;
+      continue;
+    }
+    if (ch === "/" && next === "/") {
+      while (i < text.length && text[i] !== "\n") i += 1;
+      out += "\n";
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      i += 2;
+      while (i < text.length && !(text[i] === "*" && text[i + 1] === "/")) i += 1;
+      i += 1;
+      out += " ";
+      continue;
+    }
+    out += ch;
+  }
+  return out.replace(/,\s*([}\]])/g, "$1");
+}
+function planOpencodeConfigWrite(raw) {
+  if (raw === void 0) {
+    return {
+      action: "create",
+      text: `${JSON.stringify({ $schema: "https://opencode.ai/config.json", plugin: [OPENCODE_PLUGIN_SPEC] }, null, 2)}
+`
+    };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(stripJsonc(raw));
+  } catch {
+    return { action: "unsafe" };
+  }
+  const hasPluginField = Object.prototype.hasOwnProperty.call(parsed, "plugin");
+  if (hasPluginField) {
+    if (!Array.isArray(parsed.plugin)) return { action: "unsafe" };
+    if (parsed.plugin.some(opencodePluginEntryMatches)) return { action: "already" };
+    const next2 = raw.replace(/("plugin"\s*:\s*\[)([\s\S]*?)(\])/m, (_m, start, body, end) => {
+      const prefix = body.trim() ? `${body.replace(/\s*$/, "")}, ` : "";
+      return `${start}${prefix}"${OPENCODE_PLUGIN_SPEC}"${end}`;
+    });
+    if (next2 === raw) return { action: "unsafe" };
+    return { action: "append", text: next2.endsWith("\n") ? next2 : `${next2}
+` };
+  }
+  const brace = raw.indexOf("{");
+  if (brace < 0) return { action: "unsafe" };
+  const insertAt = brace + 1;
+  const next = `${raw.slice(0, insertAt)}
+  "plugin": ["${OPENCODE_PLUGIN_SPEC}"],${raw.slice(insertAt)}`;
+  return { action: "insert", text: next.endsWith("\n") ? next : `${next}
+` };
+}
+function buildOpencodeConfigPluginCheck(input) {
+  const fix = OPENCODE_RECOVERY;
+  const base = { ok: true, label: OPENCODE_CONFIG_PLUGIN_LABEL, fix };
+  if (!input.isOrgRepo) return base;
+  if (!input.hasConfig) return { ...base, ok: false, configPath: input.configPath, reason: "missing-config" };
+  if (!input.parseOk) return { ...base, ok: false, configPath: input.configPath, reason: "unreadable-config" };
+  if (!input.hasPluginField) return { ...base, ok: false, configPath: input.configPath, reason: "missing-plugin-entry" };
+  if (!Array.isArray(input.pluginEntries)) return { ...base, ok: false, configPath: input.configPath, reason: "invalid-plugin-shape" };
+  if (!input.pluginEntries.some(opencodePluginEntryMatches)) {
+    return { ...base, ok: false, configPath: input.configPath, reason: "missing-plugin-entry" };
+  }
+  return { ...base, configPath: input.configPath };
+}
 var OPENCODE_DESKTOP_BOOTSTRAP_LABEL = "OpenCode Desktop stale project bootstrap";
 var OPENCODE_DESKTOP_BOOTSTRAP_FIX = "OpenCode Desktop is bootstrapping a deleted MMI worktree; open an existing checkout in OpenCode, remove/select away from the stale project entry, then restart OpenCode";
 function decodeLogUrlDirectory(value) {
@@ -18243,6 +18349,38 @@ function buildOpencodeDesktopBootstrapCheck(input) {
   const dirs = input.issues.map((i) => i.directory).join(", ");
   return { ...base, ok: false, fix: `${OPENCODE_DESKTOP_BOOTSTRAP_FIX} (stale: ${dirs})`, issues: [...input.issues] };
 }
+var OPENCODE_LEGACY_CONFIG_LABEL = "OpenCode legacy ~/.opencode config (stale plugin entries)";
+var OPENCODE_LEGACY_CONFIG_FIX = 'remove or rename ~/.opencode/opencode.json (legacy path); configure OpenCode at ~/.config/opencode/opencode.jsonc with "plugin": ["@mutmutco/opencode-mmi"] \u2014 see docs/Guides/opencode-saga.md';
+function parseOpencodeLegacyConfigPlugins(content) {
+  try {
+    const parsed = JSON.parse(content);
+    if (!Array.isArray(parsed.plugin)) return null;
+    return parsed.plugin.filter((entry) => typeof entry === "string");
+  } catch {
+    return null;
+  }
+}
+function isStaleOpencodePluginEntry(entry) {
+  const trimmed = entry.trim();
+  if (!trimmed) return false;
+  if (trimmed.startsWith("@") || trimmed.includes("/")) return false;
+  return /^[a-z][a-z0-9-]*$/i.test(trimmed);
+}
+function buildOpencodeLegacyConfigCheck(input) {
+  const base = {
+    ok: true,
+    label: OPENCODE_LEGACY_CONFIG_LABEL,
+    fix: OPENCODE_LEGACY_CONFIG_FIX,
+    legacyPath: input.legacyPath
+  };
+  if (!input.isOrgRepo || !input.stalePlugins?.length) return base;
+  return {
+    ...base,
+    ok: false,
+    stalePlugins: [...input.stalePlugins],
+    fix: `${OPENCODE_LEGACY_CONFIG_FIX} \u2014 stale entries: ${input.stalePlugins.join(", ")}`
+  };
+}
 var CURSOR_PLUGIN_INSTALL_LABEL = "Cursor Team Marketplace plugin install";
 var CURSOR_MARKETPLACE_INSTALL_GUIDE = "https://github.com/mutmutco/MMI-Hub/blob/development/docs/Guides/cursor-marketplace-install.md";
 var CURSOR_PLUGIN_JSON_REL = ".cursor-plugin/plugin.json";
@@ -18491,6 +18629,35 @@ function doctorPreflightDoneLine(surface) {
 function pluginAutonomousHaltLine(reloadHint) {
   return `\u26A0 PLUGIN RELOAD REQUIRED \u2014 mmi:* skills and agent types are unavailable until you ${reloadHint}. Halt autonomous /grind and /build until then.`;
 }
+function renderPluginUpdateReportStaleOnly(report) {
+  const v = report.versions;
+  const released = v.released;
+  if (!released) return [];
+  const isStale = (current) => Boolean(current && isSemverVersion2(current) && compareVersions(current, released) < 0);
+  const recipeLines = [];
+  if (isStale(v.cli)) recipeLines.push(`  npm CLI:  ${report.recipes.cli.join(" ; ")}`);
+  if (isStale(v.claudePlugin)) recipeLines.push(`  Claude:   ${report.recipes.claude.join(" ; ")}`);
+  if (isStale(v.codexMarketplace) || isStale(v.codexActiveCache)) {
+    recipeLines.push(`  Codex:    ${report.recipes.codex.join(" ; ")}`);
+  }
+  if (isStale(v.opencodePlugin)) recipeLines.push(`  OpenCode: ${report.recipes.opencode.join(" ; ")}`);
+  if (!recipeLines.length) return [];
+  return ["Update recipes (stale surfaces):", ...recipeLines];
+}
+function renderTerseDoctorReport(input) {
+  if (!input.gaps.length) return [];
+  const lines = [];
+  for (const c of input.gaps) {
+    lines.push(`\u2717 ${c.label}`);
+    lines.push(`   \u2192 ${c.fix}`);
+  }
+  const stale = renderPluginUpdateReportStaleOnly(input.updateReport);
+  if (stale.length) {
+    lines.push("");
+    lines.push(...stale);
+  }
+  return lines;
+}
 
 // src/kb-drift-report.ts
 var import_node_fs23 = require("node:fs");
@@ -18917,6 +19084,42 @@ function backupAndWriteInstalledPlugins(records, pluginId) {
     return false;
   }
 }
+function opencodeConfigPath() {
+  return (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".config", "opencode", "opencode.jsonc");
+}
+function opencodeConfigSnapshot() {
+  const path2 = opencodeConfigPath();
+  if (!(0, import_node_fs26.existsSync)(path2)) return { path: path2, hasConfig: false, hasPluginField: false, parseOk: true };
+  try {
+    const raw = (0, import_node_fs26.readFileSync)(path2, "utf8");
+    const parsed = JSON.parse(stripJsonc(raw));
+    const hasPluginField = Object.prototype.hasOwnProperty.call(parsed, "plugin");
+    return {
+      path: path2,
+      hasConfig: true,
+      hasPluginField,
+      parseOk: true,
+      raw,
+      ...Array.isArray(parsed.plugin) ? { pluginEntries: parsed.plugin } : parsed.plugin === void 0 ? {} : { pluginEntries: void 0 }
+    };
+  } catch {
+    return { path: path2, hasConfig: true, hasPluginField: false, parseOk: false };
+  }
+}
+function writeOpencodeConfigPlugin(snapshot) {
+  try {
+    const path2 = snapshot.path;
+    const plan2 = planOpencodeConfigWrite(snapshot.hasConfig ? snapshot.raw : void 0);
+    if (plan2.action === "already") return true;
+    if (!plan2.text || plan2.action === "unsafe") return false;
+    (0, import_node_fs26.mkdirSync)((0, import_node_path22.dirname)(path2), { recursive: true });
+    if (snapshot.hasConfig) (0, import_node_fs26.copyFileSync)(path2, `${path2}.bak`);
+    (0, import_node_fs26.writeFileSync)(path2, plan2.text, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
 function opencodeDesktopLogsRoot() {
   if (process.platform === "win32") {
     const base = process.env.APPDATA || (0, import_node_path22.join)((0, import_node_os5.homedir)(), "AppData", "Roaming");
@@ -18940,6 +19143,27 @@ function opencodeDesktopBootstrapSnapshot() {
     return [];
   }
 }
+function opencodeLegacyConfigSnapshot() {
+  const legacyPath = (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".opencode", "opencode.json");
+  if (!(0, import_node_fs26.existsSync)(legacyPath)) return {};
+  const content = readTextFile(legacyPath);
+  if (content == null) return {};
+  const plugins = parseOpencodeLegacyConfigPlugins(content);
+  if (!plugins) return {};
+  const stalePlugins = plugins.filter(isStaleOpencodePluginEntry);
+  if (!stalePlugins.length) return {};
+  return { legacyPath, stalePlugins };
+}
+function quarantineOpencodeLegacyConfig(legacyPath) {
+  try {
+    const backupPath = `${legacyPath}.bak`;
+    if ((0, import_node_fs26.existsSync)(backupPath)) return false;
+    (0, import_node_fs26.renameSync)(legacyPath, backupPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function cursorPluginCacheRoot() {
   return (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".cursor", "plugins", "cache", "mutmutco", "mmi");
 }
@@ -19160,6 +19384,8 @@ async function runDoctor(opts, io = consoleIo) {
   }
   const repairLocal = !opts.json || Boolean(opts.apply) || Boolean(opts.preflight);
   const repoWritesAllowed = !opts.noRepoWrites;
+  const runExtended = Boolean(opts.verbose) || Boolean(opts.json);
+  const terseOutput = !opts.verbose && !opts.json && !opts.banner && !opts.preflight;
   const checks = [];
   const REWRITE_KEY = "url.https://github.com/.insteadOf";
   const CLONE_FIX = 'run: git config --global url."https://github.com/".insteadOf "git@github.com:"';
@@ -19238,15 +19464,19 @@ async function runDoctor(opts, io = consoleIo) {
       installedVersion
     })
   );
-  checks.push(
-    buildHubDeployFreshnessCheck({
-      isOrgRepo: Boolean(cfg.sagaApiUrl),
-      deployedHubVersion: hubVersionInfo?.hubVersion,
-      installedVersion,
-      releasedVersion
-    })
-  );
-  checks.push(buildAwsCrossAccountCheck({ callerArn }));
+  if (runExtended) {
+    checks.push(
+      buildHubDeployFreshnessCheck({
+        isOrgRepo: Boolean(cfg.sagaApiUrl),
+        deployedHubVersion: hubVersionInfo?.hubVersion,
+        installedVersion,
+        releasedVersion
+      })
+    );
+  }
+  if (runExtended) {
+    checks.push(buildAwsCrossAccountCheck({ callerArn }));
+  }
   let cloneOk = cloneProbe;
   if (!cloneOk && repairFull) {
     try {
@@ -19368,7 +19598,35 @@ async function runDoctor(opts, io = consoleIo) {
     }
   }
   checks.push(installedVersionCheck);
-  if (surface === "opencode") {
+  const openCodeConfigSnapshot = opencodeConfigSnapshot();
+  const inspectOpenCode = surface === "opencode" || openCodeConfigSnapshot.hasConfig || runExtended;
+  if (inspectOpenCode) {
+    let opencodeConfigCheck = buildOpencodeConfigPluginCheck({
+      isOrgRepo: Boolean(cfg.sagaApiUrl),
+      configPath: openCodeConfigSnapshot.path,
+      hasConfig: openCodeConfigSnapshot.hasConfig,
+      hasPluginField: openCodeConfigSnapshot.hasPluginField,
+      pluginEntries: openCodeConfigSnapshot.pluginEntries,
+      parseOk: openCodeConfigSnapshot.parseOk
+    });
+    if (!opencodeConfigCheck.ok && opencodeConfigCheck.reason !== "unreadable-config" && opencodeConfigCheck.reason !== "invalid-plugin-shape" && repairLocal) {
+      if (writeOpencodeConfigPlugin(openCodeConfigSnapshot)) {
+        const refreshed = opencodeConfigSnapshot();
+        opencodeConfigCheck = buildOpencodeConfigPluginCheck({
+          isOrgRepo: Boolean(cfg.sagaApiUrl),
+          configPath: refreshed.path,
+          hasConfig: refreshed.hasConfig,
+          hasPluginField: refreshed.hasPluginField,
+          pluginEntries: refreshed.pluginEntries,
+          parseOk: refreshed.parseOk
+        });
+        if (opencodeConfigCheck.ok) {
+          markPluginReloadRequired();
+          io.err(`  \u21BB repaired: wired ${OPENCODE_PLUGIN_PACKAGE} in OpenCode config \u2014 ${reloadAction("opencode")} to load MMI commands`);
+        }
+      }
+    }
+    checks.push(opencodeConfigCheck);
     checks.push(buildOpencodeVersionCheck({
       isOrgRepo: Boolean(cfg.sagaApiUrl),
       installedVersion: process.env.MMI_OPENCODE_PLUGIN_VERSION,
@@ -19380,6 +19638,21 @@ async function runDoctor(opts, io = consoleIo) {
       issues: opencodeDesktopBootstrapSnapshot()
     }));
   }
+  const legacyOpenCodeConfig = opencodeLegacyConfigSnapshot();
+  if (Boolean(cfg.sagaApiUrl) && legacyOpenCodeConfig.stalePlugins?.length) {
+    let legacyOpenCodeCheck = buildOpencodeLegacyConfigCheck({
+      isOrgRepo: true,
+      legacyPath: legacyOpenCodeConfig.legacyPath,
+      stalePlugins: legacyOpenCodeConfig.stalePlugins
+    });
+    if (!legacyOpenCodeCheck.ok && repairLocal && legacyOpenCodeConfig.legacyPath) {
+      if (quarantineOpencodeLegacyConfig(legacyOpenCodeConfig.legacyPath)) {
+        legacyOpenCodeCheck = buildOpencodeLegacyConfigCheck({ isOrgRepo: true });
+        io.err(`  \u21BB quarantined legacy OpenCode config \u2192 ${legacyOpenCodeConfig.legacyPath}.bak \u2014 restart OpenCode`);
+      }
+    }
+    checks.push(legacyOpenCodeCheck);
+  }
   let cacheCleanupCheck = buildMmiPluginCacheCleanupCheck({
     isOrgRepo: Boolean(cfg.sagaApiUrl),
     roots: mmiPluginCacheRootSnapshots(),
@@ -19492,53 +19765,62 @@ async function runDoctor(opts, io = consoleIo) {
       mmiCliOnPath: onPath
     })
   );
-  const playwrightMcpConfigs = playwrightMcpConfigSnapshots();
-  checks.push(
-    buildPlaywrightMcpVisionCapCheck({
-      isOrgRepo: Boolean(cfg.sagaApiUrl),
-      configs: playwrightMcpConfigs
-    })
-  );
-  checks.push(
-    buildPlaywrightMcpOutputDirCheck({
-      isOrgRepo: Boolean(cfg.sagaApiUrl),
-      configs: playwrightMcpConfigs
-    })
-  );
-  checks.push(
-    buildBrowserArtifactsCheck({
-      isOrgRepo: Boolean(cfg.sagaApiUrl),
-      strayPaths: strayBrowserArtifactPaths()
-    })
-  );
-  if (!opts.banner && Boolean(cfg.sagaApiUrl)) {
+  if (runExtended) {
+    const playwrightMcpConfigs = playwrightMcpConfigSnapshots();
+    checks.push(
+      buildPlaywrightMcpVisionCapCheck({
+        isOrgRepo: Boolean(cfg.sagaApiUrl),
+        configs: playwrightMcpConfigs
+      })
+    );
+    checks.push(
+      buildPlaywrightMcpOutputDirCheck({
+        isOrgRepo: Boolean(cfg.sagaApiUrl),
+        configs: playwrightMcpConfigs
+      })
+    );
+    checks.push(
+      buildBrowserArtifactsCheck({
+        isOrgRepo: Boolean(cfg.sagaApiUrl),
+        strayPaths: strayBrowserArtifactPaths()
+      })
+    );
+  }
+  if (runExtended && !opts.banner && Boolean(cfg.sagaApiUrl)) {
     const repoRoot = (await execFileP2("git", ["rev-parse", "--show-toplevel"], { timeout: GIT_TIMEOUT_MS }).catch(() => ({ stdout: "" }))).stdout.trim() || process.cwd();
     const driftReport = await fetchLatestKbDriftReport(execFileP2, repoRoot);
     checks.push(buildKbDriftAdvisoryCheck({ isOrgRepo: true, report: driftReport }));
   }
   if (!opts.banner) {
     const repoRoot = (await execFileP2("git", ["rev-parse", "--show-toplevel"], { timeout: GIT_TIMEOUT_MS }).catch(() => ({ stdout: "" }))).stdout.trim() || process.cwd();
-    let scratchRun = executeScratchGc(repoRoot, { apply: false });
-    if (opts.apply && repoWritesAllowed && scratchRun.plan.safeAuto.length > 0) {
-      scratchRun = executeScratchGc(repoRoot, { apply: true });
+    if (runExtended) {
+      let scratchRun = executeScratchGc(repoRoot, { apply: false });
+      if (opts.apply && repoWritesAllowed && scratchRun.plan.safeAuto.length > 0) {
+        scratchRun = executeScratchGc(repoRoot, { apply: true });
+        if (scratchRun.applied?.pruned.length) {
+          io.err(`  \u21BB pruned ${scratchRun.applied.pruned.length} scratch item(s) (${scratchRun.applied.bytes} bytes)`);
+        }
+        scratchRun = executeScratchGc(repoRoot, { apply: false });
+      }
+      checks.push(buildScratchGcCheck(scratchRun.plan));
+      try {
+        checks.push(buildGitGcCheck(await gcPlan("origin", 200)));
+      } catch {
+      }
+    } else if (opts.apply && repoWritesAllowed) {
+      const scratchRun = executeScratchGc(repoRoot, { apply: true });
       if (scratchRun.applied?.pruned.length) {
         io.err(`  \u21BB pruned ${scratchRun.applied.pruned.length} scratch item(s) (${scratchRun.applied.bytes} bytes)`);
       }
-      scratchRun = executeScratchGc(repoRoot, { apply: false });
-    }
-    checks.push(buildScratchGcCheck(scratchRun.plan));
-    try {
-      checks.push(buildGitGcCheck(await gcPlan("origin", 200)));
-    } catch {
     }
   }
-  if (opts.banner) {
+  if (opts.banner && runExtended) {
     try {
       checks.push(buildGitGcCheck(await gcPlan("origin", 50)));
     } catch {
     }
   }
-  if (!opts.banner) {
+  if (runExtended && !opts.banner) {
     const continuity = readContinuityStamp();
     checks.push(
       buildContinuityFreshnessCheck({
@@ -19549,38 +19831,40 @@ async function runDoctor(opts, io = consoleIo) {
       })
     );
   }
-  const dashboardConsumer = await resolveDashboardConsumer(cfg);
-  const isDashboardConsumer = dashboardConsumer.isConsumer;
-  const uiSnapshot = designSystemSnapshot(process.cwd());
-  const uiLatestVersion = isDashboardConsumer && uiSnapshot.packageName ? await fetchUiPackageLatestVersion(uiSnapshot.packageName) : void 0;
-  let designSystemCheck = dashboardConsumer.registryReadFailed ? buildDesignSystemRegistryReadCheck(dashboardConsumer.registryReadFailed) : buildDesignSystemVersionCheck({
-    ...uiSnapshot,
-    isConsumerRepo: isDashboardConsumer,
-    latestVersion: uiLatestVersion
-  });
-  if (!designSystemCheck.ok && (repairFull || repairLocal) && designSystemCheck.packageName) {
-    designSystemCheck = await applyDesignSystemUpdate(designSystemCheck, (m) => io.err(m));
-    if (designSystemCheck.ok) {
-      io.err(`  \u21BB updated ${designSystemCheck.packageName} \u2192 ${designSystemCheck.installedVersion ?? designSystemCheck.latestVersion ?? "latest"}`);
+  if (runExtended) {
+    const dashboardConsumer = await resolveDashboardConsumer(cfg);
+    const isDashboardConsumer = dashboardConsumer.isConsumer;
+    const uiSnapshot = designSystemSnapshot(process.cwd());
+    const uiLatestVersion = isDashboardConsumer && uiSnapshot.packageName ? await fetchUiPackageLatestVersion(uiSnapshot.packageName) : void 0;
+    let designSystemCheck = dashboardConsumer.registryReadFailed ? buildDesignSystemRegistryReadCheck(dashboardConsumer.registryReadFailed) : buildDesignSystemVersionCheck({
+      ...uiSnapshot,
+      isConsumerRepo: isDashboardConsumer,
+      latestVersion: uiLatestVersion
+    });
+    if (!designSystemCheck.ok && (repairFull || repairLocal) && designSystemCheck.packageName) {
+      designSystemCheck = await applyDesignSystemUpdate(designSystemCheck, (m) => io.err(m));
+      if (designSystemCheck.ok) {
+        io.err(`  \u21BB updated ${designSystemCheck.packageName} \u2192 ${designSystemCheck.installedVersion ?? designSystemCheck.latestVersion ?? "latest"}`);
+      }
     }
-  }
-  checks.push(designSystemCheck);
-  const registryTargetVersion = designSystemCheck.latestVersion ?? designSystemCheck.installedVersion ?? uiLatestVersion;
-  let registryComponentsCheck = dashboardConsumer.registryReadFailed ? buildRegistryComponentsRegistryReadCheck(dashboardConsumer.registryReadFailed) : buildRegistryComponentsCheck({
-    ...await gatherRegistryComponentsState(process.cwd(), registryTargetVersion, { fetch }),
-    isConsumerRepo: isDashboardConsumer
-  });
-  if (!registryComponentsCheck.ok && (repairFull || repairLocal) && repoWritesAllowed && registryComponentsCheck.components?.length) {
-    registryComponentsCheck = await applyRegistryComponentsSyncCheck(
-      registryComponentsCheck,
-      registryTargetVersion,
-      (m) => io.err(m)
-    );
-    if (registryComponentsCheck.ok) {
-      io.err(`  \u21BB synced ${registryComponentsCheck.components?.length ?? 0} registry component(s) \u2192 .mmi/design-system/components`);
+    checks.push(designSystemCheck);
+    const registryTargetVersion = designSystemCheck.latestVersion ?? designSystemCheck.installedVersion ?? uiLatestVersion;
+    let registryComponentsCheck = dashboardConsumer.registryReadFailed ? buildRegistryComponentsRegistryReadCheck(dashboardConsumer.registryReadFailed) : buildRegistryComponentsCheck({
+      ...await gatherRegistryComponentsState(process.cwd(), registryTargetVersion, { fetch }),
+      isConsumerRepo: isDashboardConsumer
+    });
+    if (!registryComponentsCheck.ok && (repairFull || repairLocal) && repoWritesAllowed && registryComponentsCheck.components?.length) {
+      registryComponentsCheck = await applyRegistryComponentsSyncCheck(
+        registryComponentsCheck,
+        registryTargetVersion,
+        (m) => io.err(m)
+      );
+      if (registryComponentsCheck.ok) {
+        io.err(`  \u21BB synced ${registryComponentsCheck.components?.length ?? 0} registry component(s) \u2192 .mmi/design-system/components`);
+      }
     }
+    checks.push(registryComponentsCheck);
   }
-  checks.push(registryComponentsCheck);
   const gaps = checks.filter((c) => !c.ok);
   if (opts.preflight) {
     if (healPlan.needsEagerHeal) io.err(doctorPreflightDoneLine(surface));
@@ -19609,6 +19893,12 @@ async function runDoctor(opts, io = consoleIo) {
     io.log(JSON.stringify(buildDoctorJsonPayload({ checks, updateReport, resources }), null, 2));
     return;
   }
+  if (terseOutput) {
+    if (pluginReloadRequired) io.err(pluginAutonomousHaltLine(reloadHint));
+    for (const line of renderTerseDoctorReport({ gaps, updateReport })) io.log(line);
+    for (const r of resources) io.log(`Resource: ${r.label} \u2014 ${r.url}`);
+    return;
+  }
   for (const c of checks) io.log(c.ok ? `\u2713 ${c.label}` : `\u2717 ${c.label}
    \u2192 ${c.fix}`);
   for (const r of resources) io.log(`Resource: ${r.label} \u2014 ${r.url}`);
@@ -22450,7 +22740,7 @@ designSystem.command("registry").description("compare .mmi/design-system/compone
   if (!check.ok) console.log(`  fix: ${check.fix}`);
   process.exitCode = check.ok ? 0 : 1;
 });
-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, @mutmutco UI npm package freshness, @mutmutco registry component cache, Playwright MCP vision caps, Playwright MCP output dir, browser artifact hygiene, scratch housekeeping, stale git worktrees/branches), print fixes, and report per-surface versions + update recipes").option("--banner", "one-line resume summary; silent when all gates pass").option("--preflight", "eager version/plugin heal with upfront notice when stale; silent when healthy (#1871)").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 and auto-heal CLI/plugin wiring; use --verbose for the full audit checklist").option("--banner", "one-line resume summary; silent when all gates pass").option("--preflight", "eager version/plugin heal with upfront notice when stale; silent when healthy (#1871)").option("--verbose", "run extended audit checks and print the full checklist + version report (#1989)").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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.49.0",
+  "version": "2.50.1",
   "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",