@dosu/cli 0.67.1 → 0.67.2

package/bin/dosu.js

@@ -961,6 +961,10 @@ function mcpHeaders(apiKey) {
   }
   return { "X-Dosu-API-Key": apiKey };
 }
+function npxRemoteEntry(url, apiKey, npx, path) {
+  const remote = mcpRemoteServer(url, apiKey);
+  return { command: npx, args: remote.args, env: { PATH: path, ...remote.env } };
+}
 function mcpRemoteServer(url, apiKey) {
   const env = {};
   const headerArgs = Object.entries(mcpHeaders(apiKey)).flatMap(([key, value]) => {
@@ -1081,6 +1085,12 @@ function isJSONKeyConfigured(configPath, topLevelKey) {
     return false;
   return "dosu" in section;
 }
+function readJSONServer(configPath, topLevelKey) {
+  const section = loadJSONConfig(configPath)[topLevelKey];
+  if (typeof section !== "object" || section === null)
+    return;
+  return section.dosu;
+}
 function installJSONServer(configPath, topKey, server) {
   const jsonCfg = readJSONConfig(configPath);
   let section = jsonCfg[topKey];
@@ -1118,7 +1128,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.67.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.67.2", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -14323,7 +14333,7 @@ var init_conflicts = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "152ccbaa-13cc-83fc-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "fa693edb-14f4-abcb-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -62482,6 +62492,65 @@ var init_topics = __esm(() => {
   import_picocolors31 = __toESM(require_picocolors(), 1);
 });
 
+// src/mcp/shape.ts
+function shapeEndpoint(cfg) {
+  const url = cfg?.mode === MODE_OSS ? mcpEndpoint(cfg) : mcpURL(ANY);
+  return ANY + url.slice(getBackendURL().length);
+}
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function hasShape(expected, actual) {
+  if (typeof expected === "string") {
+    if (typeof actual !== "string")
+      return false;
+    if (!expected.includes(ANY))
+      return expected === actual;
+    const pattern = expected.split(ANY).map(escapeRegExp).join("[\\s\\S]*");
+    return new RegExp(`^${pattern}$`).test(actual);
+  }
+  if (Array.isArray(expected)) {
+    return Array.isArray(actual) && actual.length === expected.length && expected.every((item, i) => hasShape(item, actual[i]));
+  }
+  if (typeof expected === "object" && expected !== null) {
+    if (typeof actual !== "object" || actual === null || Array.isArray(actual))
+      return false;
+    const expectedKeys = Object.keys(expected);
+    const actualRecord = actual;
+    return expectedKeys.length === Object.keys(actualRecord).length && expectedKeys.every((key) => (key in actualRecord) && hasShape(expected[key], actualRecord[key]));
+  }
+  return expected === actual;
+}
+function withoutUserChoices(entry) {
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+    return entry;
+  return Object.fromEntries(Object.entries(entry).filter(([key]) => !USER_CHOICE_KEYS.has(key)));
+}
+function entryHasShape(expected, actual) {
+  return hasShape(withoutUserChoices(expected), withoutUserChoices(actual));
+}
+var ANY = "\x00any\x00", USER_CHOICE_KEYS;
+var init_shape = __esm(() => {
+  init_config();
+  init_config_helpers();
+  USER_CHOICE_KEYS = new Set([
+    "disabled",
+    "enabled",
+    "autoApprove",
+    "disabledTools",
+    "timeout",
+    "trust",
+    "includeTools",
+    "excludeTools",
+    "enabled_tools",
+    "disabled_tools",
+    "default_tools_approval_mode",
+    "required",
+    "startup_timeout_sec",
+    "tool_timeout_sec"
+  ]);
+});
+
 // src/mcp/providers/base.ts
 function createJSONProvider(opts) {
   const buildServer = opts.buildServer ?? defaultBuildServer;
@@ -62494,6 +62563,7 @@ function createJSONProvider(opts) {
     isInstalled: () => isInstalled(opts.paths),
     globalConfigPath: () => expandHome(opts.globalPath),
     isConfigured: () => isJSONKeyConfigured(expandHome(opts.globalPath), opts.topKey),
+    isCurrent: (cfg) => entryHasShape(buildServer({ url: shapeEndpoint(cfg), headers: mcpHeaders(ANY) }), readJSONServer(expandHome(opts.globalPath), opts.topKey)),
     install(cfg, global2) {
       const endpoint = {
         url: mcpEndpoint(cfg),
@@ -62507,7 +62577,7 @@ function createJSONProvider(opts) {
       } else {
         throw new Error(`${opts.providerName} does not support local installation`);
       }
-      installJSONServer(configPath, opts.topKey, buildServer(endpoint, cfg));
+      installJSONServer(configPath, opts.topKey, buildServer(endpoint));
     },
     remove(global2) {
       let configPath;
@@ -62530,6 +62600,7 @@ var defaultBuildServer = ({ url, headers }) => ({
 var init_base = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/antigravity.ts
@@ -62581,17 +62652,13 @@ var ClaudeDesktopProvider = () => ({
   isInstalled: () => isInstalled([join26(appSupportDir(), "Claude")]),
   globalConfigPath: () => configPath(),
   isConfigured: () => isJSONKeyConfigured(configPath(), "mcpServers"),
+  isCurrent: (cfg) => entryHasShape(npxRemoteEntry(shapeEndpoint(cfg), ANY, ANY, npxPathEnv(join26(ANY, "npx"))), readJSONServer(configPath(), "mcpServers")),
   install(cfg, global2) {
     if (!global2)
       throw new Error("Claude Desktop does not support local installation");
     const url = mcpEndpoint(cfg);
     const npx = findNpx();
-    const remote = mcpRemoteServer(url, cfg.active_account?.target?.api_key);
-    installJSONServer(configPath(), "mcpServers", {
-      command: npx,
-      args: remote.args,
-      env: { PATH: npxPathEnv(npx), ...remote.env }
-    });
+    installJSONServer(configPath(), "mcpServers", npxRemoteEntry(url, cfg.active_account?.target?.api_key, npx, npxPathEnv(npx)));
   },
   remove(global2) {
     if (!global2)
@@ -62602,6 +62669,7 @@ var ClaudeDesktopProvider = () => ({
 var init_claude_desktop = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/cline.ts
@@ -62673,25 +62741,70 @@ function writeTOML(path, content) {
 function tomlString(value) {
   return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
 }
+function tomlValue(value) {
+  return Array.isArray(value) ? `[${value.map(tomlString).join(", ")}]` : tomlString(value);
+}
+function dosuEntry(url, apiKey, npx, path) {
+  return npxRemoteEntry(url, apiKey, npx, path);
+}
+function renderDosuEntry(entry) {
+  const tables = [["mcp_servers.dosu", {}]];
+  for (const [key, value] of Object.entries(entry)) {
+    if (typeof value === "string" || Array.isArray(value))
+      tables[0][1][key] = value;
+    else
+      tables.push([`mcp_servers.dosu.${key}`, value]);
+  }
+  return tables.map(([name, keys]) => {
+    const lines = Object.entries(keys).map(([key, value]) => `${key} = ${tomlValue(value)}`);
+    return `
+[${name}]
+${lines.join(`
+`)}
+`;
+  }).join("");
+}
+function isToolApproval(name) {
+  return name.startsWith("mcp_servers.dosu.tools.");
+}
+function readDosuEntry(content) {
+  let entry;
+  let table;
+  for (const line of content.split(`
+`)) {
+    const name = sectionName(line);
+    if (name !== null) {
+      table = undefined;
+      if (!isDosuSection(name) || isToolApproval(name))
+        continue;
+      entry ??= {};
+      if (name === "mcp_servers.dosu") {
+        table = entry;
+      } else {
+        table = {};
+        entry[name.slice("mcp_servers.dosu.".length)] = table;
+      }
+      continue;
+    }
+    const text = line.trim();
+    if (!table || !text || text.startsWith("#"))
+      continue;
+    const eq = text.indexOf("=");
+    const key = eq === -1 ? text : text.slice(0, eq).trim();
+    const raw = eq === -1 ? "" : text.slice(eq + 1).trim();
+    try {
+      table[key] = JSON.parse(raw);
+    } catch {
+      table[key] = raw;
+    }
+  }
+  return entry;
+}
 function installDosuToTOML(path, cfg) {
-  let content = readTOML(path);
-  content = removeDosuFromTOML(content);
+  const content = removeDosuFromTOML(readTOML(path));
   const npx = findNpx();
-  const remote = mcpRemoteServer(mcpEndpoint(cfg), cfg.active_account?.target?.api_key);
-  const env = { PATH: npxPathEnv(npx), ...remote.env };
-  const envEntries = Object.entries(env).map(([key, value]) => `${key} = ${tomlString(value)}`).join(`
-`);
-  const args = remote.args.map(tomlString).join(", ");
-  const section = `
-[mcp_servers.dosu]
-command = ${tomlString(npx)}
-args = [${args}]
-` + `
-[mcp_servers.dosu.env]
-${envEntries}
-`;
-  content += section;
-  writeTOML(path, content);
+  const entry = dosuEntry(mcpEndpoint(cfg), cfg.active_account?.target?.api_key, npx, npxPathEnv(npx));
+  writeTOML(path, content + renderDosuEntry(entry));
 }
 function sectionName(line) {
   const header = line.trim();
@@ -62769,6 +62882,7 @@ var REMOTE_HTTP_KEY, CodexProvider = () => ({
     const content = readTOML(join29(codexHome3(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
+  isCurrent: (cfg) => entryHasShape(dosuEntry(shapeEndpoint(cfg), ANY, ANY, npxPathEnv(join29(ANY, "npx"))), readDosuEntry(readTOML(join29(codexHome3(), "config.toml")))),
   install(cfg, global2) {
     if (cfg.mode !== MODE_OSS && !cfg.active_account?.target?.deployment_id)
       throw new Error("deployment ID is required");
@@ -62793,11 +62907,15 @@ var init_codex = __esm(() => {
   init_config();
   init_config_helpers();
   init_detect();
+  init_shape();
   REMOTE_HTTP_KEY = /^(url|type|bearer_token_env_var)\s*=/;
 });
 
 // src/mcp/providers/copilot.ts
 import { join as join30 } from "node:path";
+function globalServer(url, apiKey) {
+  return { type: "http", url, tools: ["*"], headers: mcpHeaders(apiKey) };
+}
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
     return join30(process.env.XDG_CONFIG_HOME, "mcp-config.json");
@@ -62813,16 +62931,11 @@ var CopilotProvider = () => ({
   isInstalled: () => isInstalled([expandHome("~/.copilot")]),
   globalConfigPath: () => globalPath(),
   isConfigured: () => isJSONKeyConfigured(globalPath(), "mcpServers"),
+  isCurrent: (cfg) => entryHasShape(globalServer(shapeEndpoint(cfg), ANY), readJSONServer(globalPath(), "mcpServers")),
   install(cfg, global2) {
     const url = mcpEndpoint(cfg);
     if (global2) {
-      const server = {
-        type: "http",
-        url,
-        tools: ["*"],
-        headers: mcpHeaders(cfg.active_account.target.api_key)
-      };
-      installJSONServer(globalPath(), "mcpServers", server);
+      installJSONServer(globalPath(), "mcpServers", globalServer(url, cfg.active_account?.target?.api_key));
     } else {
       const configPath = join30(process.cwd(), ".vscode", "mcp.json");
       const server = {
@@ -62845,6 +62958,7 @@ var CopilotProvider = () => ({
 var init_copilot = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/cursor.ts
@@ -62937,6 +63051,9 @@ var init_manual = __esm(() => {
 // src/mcp/providers/mcporter.ts
 import { existsSync as existsSync23 } from "node:fs";
 import { join as join34 } from "node:path";
+function server(url, apiKey) {
+  return { type: "http", url, headers: mcpHeaders(apiKey) };
+}
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
   if (existsSync23(jsonPath))
@@ -62955,14 +63072,10 @@ var MCPorterProvider = () => ({
   isInstalled: () => isInstalled(["~/.mcporter"]),
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
+  isCurrent: (cfg) => entryHasShape(server(shapeEndpoint(cfg), ANY), readJSONServer(resolveGlobalConfigPath(), "mcpServers")),
   install(cfg, global2) {
     const configPath = global2 ? resolveGlobalConfigPath() : join34(process.cwd(), "config", "mcporter.json");
-    const server = {
-      type: "http",
-      url: mcpEndpoint(cfg),
-      headers: mcpHeaders(cfg.active_account.target.api_key)
-    };
-    installJSONServer(configPath, "mcpServers", server);
+    installJSONServer(configPath, "mcpServers", server(mcpEndpoint(cfg), cfg.active_account?.target?.api_key));
   },
   remove(global2) {
     const configPath = global2 ? resolveGlobalConfigPath() : join34(process.cwd(), "config", "mcporter.json");
@@ -62972,6 +63085,7 @@ var MCPorterProvider = () => ({
 var init_mcporter = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/opencode.ts
@@ -63085,6 +63199,7 @@ var ZedProvider = (legacyPath = legacyDarwinSettingsPath()) => {
     return provider;
   return {
     ...provider,
+    isCurrent: (cfg) => provider.isCurrent(cfg) && readJSONServer(legacyPath, "context_servers") === undefined,
     install(cfg, global2) {
       provider.install(cfg, global2);
       if (global2)
@@ -63163,9 +63278,21 @@ function configuredProviders() {
     }
   });
 }
+function staleProviders(cfg) {
+  return configuredProviders().filter((provider) => {
+    try {
+      return !provider.isCurrent(cfg);
+    } catch {
+      return true;
+    }
+  });
+}
 function refreshConfiguredProviders(cfg) {
+  return refreshProviders(cfg, configuredProviders());
+}
+function refreshProviders(cfg, providers) {
   const result = { updated: [], failed: [] };
-  for (const provider of configuredProviders()) {
+  for (const provider of providers) {
     try {
       provider.install(cfg, true);
       logger.info("mcp", `Refreshed ${provider.name()} MCP entry`);
@@ -63377,199 +63504,18 @@ var init_auto_update = __esm(() => {
   VERSION_PATTERN = /^[0-9A-Za-z.+-]{1,64}$/;
 });
 
-// src/version/update-check.ts
+// src/version/mcp-refresh-check.ts
 import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync24, writeFileSync as writeFileSync16 } from "node:fs";
 import { join as join40 } from "node:path";
-function isValidVersion2(value) {
-  return typeof value === "string" && SEMVER_PATTERN.test(value);
-}
-function stripPrerelease(version) {
-  return version.replace(/[-+].*$/, "");
-}
-function isNewerVersion(latest, current) {
-  const a = stripPrerelease(latest).split(".").map(Number);
-  const b = stripPrerelease(current).split(".").map(Number);
-  const len = Math.max(a.length, b.length);
-  for (let i = 0;i < len; i++) {
-    const av = a[i] ?? 0;
-    const bv = b[i] ?? 0;
-    if (av > bv)
-      return true;
-    if (av < bv)
-      return false;
-  }
-  return false;
-}
 function getCachePath2() {
   return join40(getConfigDir(), CACHE_FILENAME3);
 }
-function readCache() {
+function readMcpRefreshCache() {
   try {
     const path = getCachePath2();
     if (!existsSync25(path))
       return null;
     const data = JSON.parse(readFileSync24(path, "utf-8"));
-    if (typeof data.lastCheck === "number" && isValidVersion2(data.latestVersion)) {
-      return data;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function writeCache(cache) {
-  try {
-    const dir = getConfigDir();
-    if (!existsSync25(dir)) {
-      mkdirSync15(dir, { recursive: true, mode: 448 });
-    }
-    writeFileSync16(getCachePath2(), JSON.stringify(cache), { mode: 384 });
-  } catch {}
-}
-async function fetchLatestVersion() {
-  const controller = new AbortController;
-  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
-  try {
-    const resp = await fetch(REGISTRY_URL, { signal: controller.signal });
-    if (!resp.ok)
-      return null;
-    const data = await resp.json();
-    const latest = data.latest;
-    return isValidVersion2(latest) ? latest : null;
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-function buildUpdateHint(channel, npx = false) {
-  if (channel === "npm" && npx) {
-    return 'Use "npx -y @dosu/cli@latest" for the next Dosu command';
-  }
-  return 'Run "dosu upgrade"';
-}
-function styleHint(hint) {
-  const match = hint.match(/^(.*)("[^"]+")(.*)$/);
-  if (!match)
-    return import_picocolors32.default.dim(hint);
-  const [, before, command, after] = match;
-  return [before && import_picocolors32.default.dim(before), import_picocolors32.default.cyan(command), after && import_picocolors32.default.dim(after)].filter(Boolean).join("");
-}
-function framedNotice(content, width) {
-  const innerWidth = Math.max(...content.map(visibleWidth2)) + BOX_PADDING * 2;
-  const framed = (line) => {
-    const pad = innerWidth - visibleWidth2(line);
-    const left = Math.floor(pad / 2);
-    return `${import_picocolors32.default.yellow("│")}${" ".repeat(left)}${line}${" ".repeat(pad - left)}${import_picocolors32.default.yellow("│")}`;
-  };
-  const box = [
-    import_picocolors32.default.yellow(`╭${"─".repeat(innerWidth)}╮`),
-    framed(""),
-    ...content.map(framed),
-    framed(""),
-    import_picocolors32.default.yellow(`╰${"─".repeat(innerWidth)}╯`)
-  ];
-  return `
-${centerBlock(box, width).join(`
-`)}
-`;
-}
-function versionArrow(current, latest) {
-  return `${import_picocolors32.default.dim(current)} ${import_picocolors32.default.dim("→")} ${import_picocolors32.default.bold(brand(latest))}`;
-}
-function buildAutoUpdateNotice(current, latest, interactive, width = process.stderr.columns ?? 80) {
-  if (interactive) {
-    return framedNotice([
-      `Updating Dosu: ${versionArrow(current, latest)}`,
-      import_picocolors32.default.dim("Installing in the background; your next command uses it")
-    ], width);
-  }
-  return `
-[dosu:update] Installing Dosu ${latest} in the background (running ${current}). ` + `The next Dosu command uses it; no action needed.
-`;
-}
-function buildUpdateNotice(current, latest, channel, interactive, npx = false, width = process.stderr.columns ?? 80) {
-  const hint = buildUpdateHint(channel, npx);
-  if (interactive) {
-    return framedNotice([`Update available: ${versionArrow(current, latest)}`, styleHint(hint)], width);
-  }
-  const agentAction = hint[0].toLowerCase() + hint.slice(1);
-  const verifyCommand = npx ? "npx -y @dosu/cli@latest --version" : "dosu --version";
-  return `
-[dosu:update] Update available: ${current} → ${latest}
-` + `Tell the user Dosu CLI is outdated. After they approve, ${agentAction}, ` + `then verify with "${verifyCommand}".
-`;
-}
-function getAvailableUpdate() {
-  const cache = readCache();
-  return cache && isNewerVersion(cache.latestVersion, VERSION) ? cache.latestVersion : null;
-}
-function handleNewerVersion(latest, notify) {
-  const autoUpdate = startAutoUpdate(latest);
-  if (!notify)
-    return;
-  const interactive = process.stderr.isTTY === true;
-  console.error(autoUpdate === "unavailable" ? buildUpdateNotice(VERSION, latest, INSTALL_CHANNEL, interactive, isNpxInvocation()) : buildAutoUpdateNotice(VERSION, latest, interactive));
-}
-async function checkForUpdates(options = {}) {
-  const notify = options.notify ?? true;
-  try {
-    const cache = readCache();
-    const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS2;
-    if (!isStale) {
-      if (isNewerVersion(cache.latestVersion, VERSION)) {
-        handleNewerVersion(cache.latestVersion, notify);
-      }
-      return;
-    }
-    const latest = await fetchLatestVersion();
-    const latestKnownVersion = latest ?? cache?.latestVersion ?? VERSION;
-    writeCache({
-      lastCheck: Date.now(),
-      latestVersion: latestKnownVersion
-    });
-    if (latest) {
-      logger.debug("update-check", `Cached latest version: ${latest}`);
-    }
-    if (isNewerVersion(latestKnownVersion, VERSION)) {
-      handleNewerVersion(latestKnownVersion, notify);
-    }
-  } catch (err) {
-    logger.error("update-check", `Update check failed: ${err}`);
-  }
-}
-var import_picocolors32, CACHE_FILENAME3 = "update-check.json", CHECK_INTERVAL_MS2, FETCH_TIMEOUT_MS2 = 1000, REGISTRY_URL = "https://registry.npmjs.org/-/package/@dosu/cli/dist-tags", SEMVER_PATTERN, BOX_PADDING = 3;
-var init_update_check = __esm(() => {
-  init_config();
-  init_logger();
-  init_styles();
-  init_layout();
-  init_auto_update();
-  import_picocolors32 = __toESM(require_picocolors(), 1);
-  CHECK_INTERVAL_MS2 = 6 * 60 * 60 * 1000;
-  SEMVER_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-});
-
-// src/version/mcp-refresh-check.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync16, readFileSync as readFileSync25, writeFileSync as writeFileSync17 } from "node:fs";
-import { join as join41 } from "node:path";
-function needsMcpRefresh(previous, current) {
-  if (previous === null)
-    return true;
-  if (previous === current)
-    return false;
-  const [older, newer] = isNewerVersion(current, previous) ? [previous, current] : [current, previous];
-  return MCP_FORMAT_CHANGES.some((change) => isNewerVersion(change, older) && !isNewerVersion(change, newer));
-}
-function getCachePath3() {
-  return join41(getConfigDir(), CACHE_FILENAME4);
-}
-function readMcpRefreshCache() {
-  try {
-    const path = getCachePath3();
-    if (!existsSync26(path))
-      return null;
-    const data = JSON.parse(readFileSync25(path, "utf-8"));
     if (typeof data?.version === "string")
       return { version: data.version };
     return null;
@@ -63580,10 +63526,10 @@ function readMcpRefreshCache() {
 function writeMcpRefreshCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync26(dir)) {
-      mkdirSync16(dir, { recursive: true, mode: 448 });
+    if (!existsSync25(dir)) {
+      mkdirSync15(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync17(getCachePath3(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync16(getCachePath2(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 function canRefreshMcp(cfg) {
@@ -63594,26 +63540,21 @@ function canRefreshMcp(cfg) {
 }
 function displayNotice(names) {
   console.error(`
-${import_picocolors33.default.green(`✓ Dosu ${VERSION}: refreshed MCP config for ${names.join(", ")}`)}
-` + `${import_picocolors33.default.dim(`  Run ${import_picocolors33.default.cyan('"dosu setup"')} to also update hooks and rules, then restart your AI agents.`)}
+${import_picocolors32.default.green(`✓ Dosu ${VERSION}: refreshed MCP config for ${names.join(", ")}`)}
+` + `${import_picocolors32.default.dim(`  Run ${import_picocolors32.default.cyan('"dosu setup"')} to also update hooks and rules, then restart your AI agents.`)}
 `);
 }
 function checkForMcpRefresh(options = {}) {
   const notify = options.notify ?? true;
   try {
-    const previous = readMcpRefreshCache()?.version ?? null;
-    if (previous === VERSION)
-      return;
-    if (!needsMcpRefresh(previous, VERSION)) {
-      writeMcpRefreshCache({ version: VERSION });
+    if (readMcpRefreshCache()?.version === VERSION)
       return;
-    }
     const cfg = loadConfigNonBlocking();
     if (!cfg || !canRefreshMcp(cfg)) {
       logger.debug("mcp-refresh", "Skipping MCP refresh: no API key or deployment configured");
       return;
     }
-    const result = refreshConfiguredProviders(cfg);
+    const result = refreshProviders(cfg, staleProviders(cfg));
     writeMcpRefreshCache({ version: VERSION });
     logger.info("mcp-refresh", `Version ${VERSION}: refreshed ${result.updated.length}, failed ${result.failed.length}`);
     if (notify && result.updated.length > 0) {
@@ -63623,24 +63564,19 @@ function checkForMcpRefresh(options = {}) {
     logger.error("mcp-refresh", `MCP refresh check failed: ${err}`);
   }
 }
-var import_picocolors33, CACHE_FILENAME4 = "mcp-refresh.json", MCP_FORMAT_CHANGES;
+var import_picocolors32, CACHE_FILENAME3 = "mcp-refresh.json";
 var init_mcp_refresh_check = __esm(() => {
   init_config();
   init_logger();
   init_refresh();
-  init_update_check();
-  import_picocolors33 = __toESM(require_picocolors(), 1);
-  MCP_FORMAT_CHANGES = [
-    "0.53.0",
-    "0.62.0"
-  ];
+  import_picocolors32 = __toESM(require_picocolors(), 1);
 });
 
 // src/version/skill-update-check.ts
 function displayNotice2() {
   console.error(`
-${import_picocolors34.default.green(`✓ Dosu ${VERSION}: refreshed the bundled agent skills`)}
-` + `${import_picocolors34.default.dim("  Restart your AI agents to pick up the new skill content.")}
+${import_picocolors33.default.green(`✓ Dosu ${VERSION}: refreshed the bundled agent skills`)}
+` + `${import_picocolors33.default.dim("  Restart your AI agents to pick up the new skill content.")}
 `);
 }
 function checkForSkillUpdates(options = {}) {
@@ -63661,11 +63597,11 @@ function checkForSkillUpdates(options = {}) {
     logger.error("skill-update-check", `Skill update check failed: ${err}`);
   }
 }
-var import_picocolors34;
+var import_picocolors33;
 var init_skill_update_check = __esm(() => {
   init_skill();
   init_logger();
-  import_picocolors34 = __toESM(require_picocolors(), 1);
+  import_picocolors33 = __toESM(require_picocolors(), 1);
 });
 
 // src/auth/errors.ts
@@ -63731,15 +63667,15 @@ function createLogFollower(path, emit) {
 var init_follow = () => {};
 
 // src/sessions/session-title.ts
-import { existsSync as existsSync27, mkdirSync as mkdirSync17, readFileSync as readFileSync26, renameSync as renameSync7, statSync as statSync10, writeFileSync as writeFileSync18 } from "node:fs";
+import { existsSync as existsSync26, mkdirSync as mkdirSync16, readFileSync as readFileSync25, renameSync as renameSync7, statSync as statSync10, writeFileSync as writeFileSync17 } from "node:fs";
 import { homedir as homedir11 } from "node:os";
-import { join as join42 } from "node:path";
+import { join as join41 } from "node:path";
 function cachePath2(configDir) {
-  return join42(configDir, CACHE_FILENAME5);
+  return join41(configDir, CACHE_FILENAME4);
 }
 function loadCacheFile2(configDir) {
   try {
-    const raw = JSON.parse(readFileSync26(cachePath2(configDir), "utf-8"));
+    const raw = JSON.parse(readFileSync25(cachePath2(configDir), "utf-8"));
     if (raw.schema_version !== CACHE_SCHEMA_VERSION2 || typeof raw.entries !== "object")
       return {};
     return raw.entries;
@@ -63749,12 +63685,12 @@ function loadCacheFile2(configDir) {
 }
 function saveCacheFile2(configDir, entries) {
   try {
-    if (!existsSync27(configDir))
-      mkdirSync17(configDir, { recursive: true, mode: 448 });
+    if (!existsSync26(configDir))
+      mkdirSync16(configDir, { recursive: true, mode: 448 });
     const path = cachePath2(configDir);
     const tmp = `${path}.${process.pid}.tmp`;
     const file = { schema_version: CACHE_SCHEMA_VERSION2, entries };
-    writeFileSync18(tmp, JSON.stringify(file), { mode: 384 });
+    writeFileSync17(tmp, JSON.stringify(file), { mode: 384 });
     renameSync7(tmp, path);
   } catch {}
 }
@@ -63787,15 +63723,15 @@ function claudeSummaryFromHead(text) {
   }
   return null;
 }
-function reconstructSession(harness, id, slug, home = homedir11(), exists = existsSync27) {
+function reconstructSession(harness, id, slug, home = homedir11(), exists = existsSync26) {
   if (!slug)
     return null;
   const candidates = [];
   if (harness === "claude") {
-    candidates.push(join42(home, ".claude", "projects", slug, `${id}.jsonl`));
+    candidates.push(join41(home, ".claude", "projects", slug, `${id}.jsonl`));
   } else if (harness === "cursor") {
-    const project = join42(home, ".cursor", "projects", slug);
-    candidates.push(join42(project, "agent-transcripts", id, `${id}.jsonl`), join42(project, "agent-transcripts", `${id}.jsonl`));
+    const project = join41(home, ".cursor", "projects", slug);
+    candidates.push(join41(project, "agent-transcripts", id, `${id}.jsonl`), join41(project, "agent-transcripts", `${id}.jsonl`));
   } else {
     return null;
   }
@@ -63807,7 +63743,7 @@ function reconstructSession(harness, id, slug, home = homedir11(), exists = exis
 }
 function readHead2(path) {
   try {
-    return readFileSync26(path, "utf-8").slice(0, 128 * 1024);
+    return readFileSync25(path, "utf-8").slice(0, 128 * 1024);
   } catch {
     return null;
   }
@@ -63858,7 +63794,7 @@ function createSessionTitleResolver(configDir = getConfigDir(), deps = {}) {
     }
   };
 }
-var CACHE_FILENAME5 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
+var CACHE_FILENAME4 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
 var init_session_title = __esm(() => {
   init_config();
   init_read();
@@ -63887,7 +63823,7 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { existsSync as existsSync28, readFileSync as readFileSync27 } from "node:fs";
+import { existsSync as existsSync27, readFileSync as readFileSync26 } from "node:fs";
 import { basename as basename6 } from "node:path";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
@@ -64028,15 +63964,15 @@ function statusLine(status) {
   if (status.running) {
     const since = status.startedAt ? ` · since ${localTime(status.startedAt)}` : "";
     const pid = status.pid !== undefined ? ` (pid ${status.pid})` : "";
-    return `\uD83D\uDCDA ${import_picocolors35.default.bold(brand("Studying sessions..."))}${import_picocolors35.default.dim(`${pid}${since}`)}`;
+    return `\uD83D\uDCDA ${import_picocolors34.default.bold(brand("Studying sessions..."))}${import_picocolors34.default.dim(`${pid}${since}`)}`;
   }
   if (status.state.paused) {
-    return `${import_picocolors35.default.yellow("○")} ${import_picocolors35.default.bold("Paused")} ${import_picocolors35.default.dim("· studying stays off until you resume")}`;
+    return `${import_picocolors34.default.yellow("○")} ${import_picocolors34.default.bold("Paused")} ${import_picocolors34.default.dim("· studying stays off until you resume")}`;
   }
   if (status.staleLock) {
-    return `${import_picocolors35.default.yellow("○")} ${import_picocolors35.default.bold("Not running")} ${import_picocolors35.default.dim("· a previous run exited without cleaning up")}`;
+    return `${import_picocolors34.default.yellow("○")} ${import_picocolors34.default.bold("Not running")} ${import_picocolors34.default.dim("· a previous run exited without cleaning up")}`;
   }
-  return `${import_picocolors35.default.dim("○")} ${import_picocolors35.default.bold("Idle")} ${import_picocolors35.default.dim("· hooks study new sessions automatically")}`;
+  return `${import_picocolors34.default.dim("○")} ${import_picocolors34.default.bold("Idle")} ${import_picocolors34.default.dim("· hooks study new sessions automatically")}`;
 }
 function progressLine(done, ready, width, notes = 0) {
   const total = done + ready;
@@ -64045,7 +63981,7 @@ function progressLine(done, ready, width, notes = 0) {
   const cells = Math.max(10, Math.min(30, width - 44));
   const ratio = Math.max(0, Math.min(1, done / total));
   const filled = Math.min(cells, Math.round(ratio * cells));
-  const bar = brand("█".repeat(filled)) + import_picocolors35.default.dim("░".repeat(cells - filled));
+  const bar = brand("█".repeat(filled)) + import_picocolors34.default.dim("░".repeat(cells - filled));
   const pct = Math.floor(ratio * 100);
   const suffix = notes > 0 ? ` · ${notes} suggested page${notes === 1 ? "" : "s"}` : "";
   return `${bar} ${done}/${total} studied · ${pct}%${suffix}`;
@@ -64084,17 +64020,17 @@ function confirmBox(queuedCount, backlog, width, mode = "start") {
   const verb = mode === "clear" ? "clear" : mode === "stop" ? "stop" : mode === "resume" ? "resume" : "start";
   const maxInner = Math.max(20, Math.min(width, contentWidth()) - 4);
   const rows = [
-    import_picocolors35.default.bold(brand(title)),
-    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors35.default.dim(line)),
+    import_picocolors34.default.bold(brand(title)),
+    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors34.default.dim(line)),
     "",
-    `${import_picocolors35.default.bold("enter")} ${verb} · ${import_picocolors35.default.bold("esc")} cancel`
+    `${import_picocolors34.default.bold("enter")} ${verb} · ${import_picocolors34.default.bold("esc")} cancel`
   ];
   const inner = Math.min(maxInner, Math.max(...rows.map(visibleWidth2)));
   const pad = (row) => row + " ".repeat(Math.max(0, inner - visibleWidth2(row)));
   return [
-    import_picocolors35.default.dim(`╭${"─".repeat(inner + 2)}╮`),
-    ...rows.map((row) => `${import_picocolors35.default.dim("│")} ${pad(row)} ${import_picocolors35.default.dim("│")}`),
-    import_picocolors35.default.dim(`╰${"─".repeat(inner + 2)}╯`)
+    import_picocolors34.default.dim(`╭${"─".repeat(inner + 2)}╮`),
+    ...rows.map((row) => `${import_picocolors34.default.dim("│")} ${pad(row)} ${import_picocolors34.default.dim("│")}`),
+    import_picocolors34.default.dim(`╰${"─".repeat(inner + 2)}╯`)
   ];
 }
 function buildActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], studiedBeforeRun = 0, open = [], runProgress = null, projectNames = {}, sessionNames = {}, frameLines) {
@@ -64110,7 +64046,7 @@ function buildActivityFrame(status, activity, width, backlog = null, pane = DEFA
     progress = progressLine(studiedDelta + stepDone, Math.max(0, backlog.ready - stepDone), width, runProgress?.notes ?? 0);
   }
   const refusal = !status.running && status.state.last_refusal;
-  const refusalLines = refusal ? wrapLine(`! Studying paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors35.default.yellow(line)) : [];
+  const refusalLines = refusal ? wrapLine(`! Studying paused: ${refusal.message} (${localTime(refusal.at)})`, width).map((line) => import_picocolors34.default.yellow(line)) : [];
   const fullRows = Boolean(pane.fullRows);
   const withName = (item, key) => projectNames[key] ? { ...item, project: projectNames[key] } : item;
   const latestPass = new Map;
@@ -64136,8 +64072,8 @@ function buildActivityFrame(status, activity, width, backlog = null, pane = DEFA
     breadcrumb(["home", "activity"], width),
     "",
     statusLine(status),
-    import_picocolors35.default.dim(studied),
-    ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors35.default.dim(line)) : [],
+    import_picocolors34.default.dim(studied),
+    ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors34.default.dim(line)) : [],
     ...progress ? [progress] : [],
     ...refusalLines,
     "",
@@ -64153,7 +64089,7 @@ function buildActivityFrame(status, activity, width, backlog = null, pane = DEFA
         status.running ? "s stop" : status.state.paused ? "s resume" : "s sync now",
         ...!status.running && status.state.watermark ? ["c clear"] : [],
         "esc back"
-      ].join(" · "), width, "").map((line) => import_picocolors35.default.dim(line))
+      ].join(" · "), width, "").map((line) => import_picocolors34.default.dim(line))
     ]
   ];
   const defaultHeight = fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
@@ -64166,7 +64102,7 @@ function buildActivityFrame(status, activity, width, backlog = null, pane = DEFA
     ({ visible, above, below } = windowList(source, pane.scroll, height));
     display = visible.flatMap((row) => wrapRow(row, width));
   }
-  const listRows = display.length > 0 ? display.map((row) => import_picocolors35.default.dim(row)) : [import_picocolors35.default.dim(empty)];
+  const listRows = display.length > 0 ? display.map((row) => import_picocolors34.default.dim(row)) : [import_picocolors34.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
@@ -64175,7 +64111,7 @@ function buildActivityFrame(status, activity, width, backlog = null, pane = DEFA
   const lines = [
     ...header,
     ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors35.default.dim(clip(scrollParts.join(" · "), width))] : [],
+    ...scrollParts.length > 0 ? [import_picocolors34.default.dim(clip(scrollParts.join(" · "), width))] : [],
     ...footer
   ];
   return { lines, listHeight: height };
@@ -64208,7 +64144,7 @@ function createRowNamer() {
         names.titles[key] = t;
     };
     for (const s of [...backlog.queued, ...backlog.open]) {
-      if (!existsSync28(s.path))
+      if (!existsSync27(s.path))
         continue;
       const key = `${s.harness}/${s.id}`;
       const dir = dirs.resolve(s);
@@ -64245,7 +64181,7 @@ function createRowNamer() {
 }
 function defaultReadLog2() {
   try {
-    return readFileSync27(logger.getLogPath(), "utf-8");
+    return readFileSync26(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -64430,7 +64366,7 @@ ${CLEAR_BELOW}`);
     input.on("data", onData);
   });
 }
-var import_picocolors35, ESC7, HIDE_CURSOR3, SHOW_CURSOR3, CTRL_C4, KEY_UP4, KEY_DOWN4, KEY_RIGHT3, KEY_LEFT3, CURSOR_HOME, CLEAR_BELOW, CLEAR_EOL, ACTIVITY_VIEW_POLL_MS = 500, ACTIVITY_VIEW_LIST_LINES = 10, ACTIVITY_VIEW_FULL_LIST_ROWS = 5, ACTIVITY_VIEW_BUFFER_LINES = 200, ACTIVITY_VIEW_TABS, DEFAULT_PANE, TITLE_READS_PER_DRAW = 25;
+var import_picocolors34, ESC7, HIDE_CURSOR3, SHOW_CURSOR3, CTRL_C4, KEY_UP4, KEY_DOWN4, KEY_RIGHT3, KEY_LEFT3, CURSOR_HOME, CLEAR_BELOW, CLEAR_EOL, ACTIVITY_VIEW_POLL_MS = 500, ACTIVITY_VIEW_LIST_LINES = 10, ACTIVITY_VIEW_FULL_LIST_ROWS = 5, ACTIVITY_VIEW_BUFFER_LINES = 200, ACTIVITY_VIEW_TABS, DEFAULT_PANE, TITLE_READS_PER_DRAW = 25;
 var init_activity_view = __esm(() => {
   init_follow();
   init_logger();
@@ -64445,7 +64381,7 @@ var init_activity_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors35 = __toESM(require_picocolors(), 1);
+  import_picocolors34 = __toESM(require_picocolors(), 1);
   ESC7 = String.fromCharCode(27);
   HIDE_CURSOR3 = `${ESC7}[?25l`;
   SHOW_CURSOR3 = `${ESC7}[?25h`;
@@ -64462,14 +64398,14 @@ var init_activity_view = __esm(() => {
 });
 
 // src/rules/installer.ts
-import { existsSync as existsSync29, mkdirSync as mkdirSync18, readFileSync as readFileSync28, unlinkSync as unlinkSync5, writeFileSync as writeFileSync19 } from "node:fs";
+import { existsSync as existsSync28, mkdirSync as mkdirSync17, readFileSync as readFileSync27, unlinkSync as unlinkSync5, writeFileSync as writeFileSync18 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
-import { dirname as dirname12, join as join43 } from "node:path";
+import { dirname as dirname12, join as join42 } from "node:path";
 function claudeConfigDir4() {
-  return process.env.CLAUDE_CONFIG_DIR || join43(homedir12(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join42(homedir12(), ".claude");
 }
 function codexHome4() {
-  return process.env.CODEX_HOME || join43(homedir12(), ".codex");
+  return process.env.CODEX_HOME || join42(homedir12(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -64495,17 +64431,17 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path) {
-  mkdirSync18(dirname12(path), { recursive: true });
+  mkdirSync17(dirname12(path), { recursive: true });
 }
 function writeIfChanged(path, content) {
-  if (!existsSync29(path)) {
+  if (!existsSync28(path)) {
     ensureParent(path);
-    writeFileSync19(path, content, "utf-8");
+    writeFileSync18(path, content, "utf-8");
     return "created";
   }
-  if (readFileSync28(path, "utf-8") === content)
+  if (readFileSync27(path, "utf-8") === content)
     return "unchanged";
-  writeFileSync19(path, content, "utf-8");
+  writeFileSync18(path, content, "utf-8");
   return "updated";
 }
 function findSection(content) {
@@ -64531,14 +64467,14 @@ function buildSection(content, lineEnding = `
   return `${DOSU_RULE_SECTION_START}${lineEnding}${body}${lineEnding}${DOSU_RULE_SECTION_END}`;
 }
 function upsertSection(path, content) {
-  if (!existsSync29(path)) {
+  if (!existsSync28(path)) {
     const section = buildSection(content);
     ensureParent(path);
-    writeFileSync19(path, `${section}
+    writeFileSync18(path, `${section}
 `, "utf-8");
     return "created";
   }
-  const existing = readFileSync28(path, "utf-8");
+  const existing = readFileSync27(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const section = buildSection(content, lineEnding);
   const location = findSection(existing);
@@ -64551,7 +64487,7 @@ function upsertSection(path, content) {
   }
   if (next === existing)
     return "unchanged";
-  writeFileSync19(path, next, "utf-8");
+  writeFileSync18(path, next, "utf-8");
   return "updated";
 }
 function installRuleForAgent(agent, content) {
@@ -64568,13 +64504,13 @@ function removeRuleForAgent(agent) {
     return null;
   const target = RULE_TARGETS[agent];
   const path = target.path();
-  if (!existsSync29(path))
+  if (!existsSync28(path))
     return { agent, path, action: "not_found" };
   if (target.kind === "file") {
     unlinkSync5(path);
     return { agent, path, action: "removed" };
   }
-  const existing = readFileSync28(path, "utf-8");
+  const existing = readFileSync27(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const location = findSection(existing);
   if (!location)
@@ -64583,7 +64519,7 @@ function removeRuleForAgent(agent) {
   if (!next) {
     unlinkSync5(path);
   } else {
-    writeFileSync19(path, `${next}${lineEnding}`, "utf-8");
+    writeFileSync18(path, `${next}${lineEnding}`, "utf-8");
   }
   return { agent, path, action: "removed" };
 }
@@ -64611,36 +64547,36 @@ var init_installer = __esm(() => {
   RULE_TARGETS = {
     claude: {
       kind: "file",
-      path: () => join43(claudeConfigDir4(), "rules", "dosu.md")
+      path: () => join42(claudeConfigDir4(), "rules", "dosu.md")
     },
     cursor: {
       kind: "file",
-      path: () => join43(homedir12(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join42(homedir12(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
       kind: "section",
-      path: () => join43(codexHome4(), "AGENTS.md")
+      path: () => join42(codexHome4(), "AGENTS.md")
     },
     opencode: {
       kind: "section",
-      path: () => join43(homedir12(), ".config", "opencode", "AGENTS.md")
+      path: () => join42(homedir12(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join43(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir12(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join43(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join42(homedir12(), ".gemini", "GEMINI.md")
     }
   };
 });
 
 // src/setup/agents-md-step.ts
 import { execSync as execSync2 } from "node:child_process";
-import { existsSync as existsSync30, readFileSync as readFileSync29, writeFileSync as writeFileSync20 } from "node:fs";
-import { join as join44 } from "node:path";
+import { existsSync as existsSync29, readFileSync as readFileSync28, writeFileSync as writeFileSync19 } from "node:fs";
+import { join as join43 } from "node:path";
 function inGitWorkTree(cwd = process.cwd()) {
   try {
     const stdout = execSync2("git rev-parse --is-inside-work-tree", {
@@ -64654,10 +64590,10 @@ function inGitWorkTree(cwd = process.cwd()) {
 }
 function dosuAgentsSectionState(cwd = process.cwd()) {
   try {
-    const path = join44(cwd, "AGENTS.md");
-    if (!existsSync30(path))
+    const path = join43(cwd, "AGENTS.md");
+    if (!existsSync29(path))
       return "missing";
-    const content = readFileSync29(path, "utf-8");
+    const content = readFileSync28(path, "utf-8");
     const startMatch = content.match(SECTION_START_RE);
     if (!startMatch || !content.includes(DOSU_SECTION_END))
       return "missing";
@@ -64692,14 +64628,14 @@ function findSection2(content) {
   return { start, end };
 }
 function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RULE) {
-  const path = join44(cwd, "AGENTS.md");
-  if (!existsSync30(path)) {
+  const path = join43(cwd, "AGENTS.md");
+  if (!existsSync29(path)) {
     const section = buildDosuAgentsSection(content);
-    writeFileSync20(path, `${section}
+    writeFileSync19(path, `${section}
 `);
     return { path, action: "created" };
   }
-  const existing = readFileSync29(path, "utf-8");
+  const existing = readFileSync28(path, "utf-8");
   const lineEnding = lineEndingFor2(existing);
   const section = renderDosuAgentsSection(content, lineEnding);
   const location = findSection2(existing);
@@ -64711,7 +64647,7 @@ function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RU
   }
   if (next === existing)
     return { path, action: "unchanged" };
-  writeFileSync20(path, next);
+  writeFileSync19(path, next);
   return { path, action: "updated" };
 }
 async function stepUpdateAgentsMd(cwd = process.cwd(), content) {
@@ -66163,7 +66099,7 @@ async function stepSelectTools(detected) {
     initialValues: preselected,
     statusFor: (id, picked) => {
       if (configuredMap.get(id))
-        return picked ? dim("configured") : import_picocolors36.default.yellow("will remove");
+        return picked ? dim("configured") : import_picocolors35.default.yellow("will remove");
       return picked ? brand("will configure") : undefined;
     },
     summary: (picked) => {
@@ -66338,7 +66274,7 @@ ${dim(wrapLog("Type it in a chat to keep that chat out of Dosu. To keep a whole
     log2.success("All agents already configured. No changes needed.");
   }
 }
-var import_picocolors36, OAUTH_ANALYTICS_REASONS, SETUP_HANDSHAKE_TIMEOUT_MS = 1800000, LIBRARY_SELECT_CANCELLED;
+var import_picocolors35, OAUTH_ANALYTICS_REASONS, SETUP_HANDSHAKE_TIMEOUT_MS = 1800000, LIBRARY_SELECT_CANCELLED;
 var init_flow2 = __esm(() => {
   init_errors4();
   init_client();
@@ -66361,7 +66297,7 @@ var init_flow2 = __esm(() => {
   init_analytics2();
   init_rules_step();
   init_styles();
-  import_picocolors36 = __toESM(require_picocolors(), 1);
+  import_picocolors35 = __toESM(require_picocolors(), 1);
   OAUTH_ANALYTICS_REASONS = new Set([
     "access_denied",
     "bad_oauth_state",
@@ -66525,7 +66461,7 @@ Could not update Dosu automatically.`);
   ${plan.manualCommand}`);
     return result.status && result.status > 0 ? result.status : 1;
   }
-  console.log(import_picocolors37.default.green(`
+  console.log(import_picocolors36.default.green(`
 ✓ Update command completed.`));
   console.log('Run "dosu --version" to verify.');
   return 0;
@@ -66567,12 +66503,13 @@ async function completeUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   finishWithNewBinary(channel, options);
   return 0;
 }
-async function finishUpgrade(from, options = {}) {
-  const previous = SEMVER.test(from) ? from : null;
-  if (!needsMcpRefresh(previous, VERSION)) {
+async function finishUpgrade(_from, options = {}) {
+  const cfg = loadConfigNonBlocking();
+  const stale = staleProviders(cfg);
+  if (stale.length === 0) {
     checkForSkillUpdates();
     writeMcpRefreshCache({ version: VERSION });
-    console.log(import_picocolors37.default.green(`✓ Dosu ${VERSION} is ready. Your AI agents need no changes.`));
+    console.log(import_picocolors36.default.green(`✓ Dosu ${VERSION} is ready. Your AI agents need no changes.`));
     return 0;
   }
   if (options.interactive ?? isInteractiveTerminal()) {
@@ -66584,14 +66521,13 @@ This update changes how agents connect to Dosu. Running setup...
     return 0;
   }
   checkForSkillUpdates();
-  const cfg = loadConfigNonBlocking();
   if (!cfg || !canRefreshMcp(cfg)) {
     console.error(SETUP_FALLBACK);
     return 0;
   }
   console.log(`
 Refreshing agent MCP configs with the new version...`);
-  const result = refreshConfiguredProviders(cfg);
+  const result = refreshProviders(cfg, stale);
   writeMcpRefreshCache({ version: VERSION });
   for (const provider of result.updated)
     console.log(`  ✓ ${provider.name()}`);
@@ -66637,7 +66573,7 @@ function upgradeCommand() {
       process.exitCode = status;
   });
 }
-var import_picocolors37, PACKAGE_NAME = "@dosu/cli", LATEST_PACKAGE, BREW_MANUAL_COMMAND = "brew upgrade dosu-ai/dosu/dosu", NPX_COMMAND = "npx -y @dosu/cli@latest", PROBE_TIMEOUT_MS = 5000, RELEASES_URL = "https://github.com/dosu-ai/dosu-cli/releases/latest", PACKAGE_MANAGERS, SETUP_FALLBACK = 'Run "dosu setup" to finish updating your AI agents.', SEMVER;
+var import_picocolors36, PACKAGE_NAME = "@dosu/cli", LATEST_PACKAGE, BREW_MANUAL_COMMAND = "brew upgrade dosu-ai/dosu/dosu", NPX_COMMAND = "npx -y @dosu/cli@latest", PROBE_TIMEOUT_MS = 5000, RELEASES_URL = "https://github.com/dosu-ai/dosu-cli/releases/latest", PACKAGE_MANAGERS, SETUP_FALLBACK = 'Run "dosu setup" to finish updating your AI agents.';
 var init_upgrade = __esm(() => {
   init_commander();
   init_config();
@@ -66645,7 +66581,7 @@ var init_upgrade = __esm(() => {
   init_auto_update();
   init_mcp_refresh_check();
   init_skill_update_check();
-  import_picocolors37 = __toESM(require_picocolors(), 1);
+  import_picocolors36 = __toESM(require_picocolors(), 1);
   LATEST_PACKAGE = `${PACKAGE_NAME}@latest`;
   PACKAGE_MANAGERS = {
     npm: {
@@ -66664,31 +66600,30 @@ var init_upgrade = __esm(() => {
       installArgs: ["global", "add", LATEST_PACKAGE]
     }
   };
-  SEMVER = /^\d+\.\d+\.\d+/;
 });
 
 // src/version/incognito-backfill-check.ts
-import { existsSync as existsSync31, mkdirSync as mkdirSync19, writeFileSync as writeFileSync21 } from "node:fs";
-import { join as join45 } from "node:path";
+import { existsSync as existsSync30, mkdirSync as mkdirSync18, writeFileSync as writeFileSync20 } from "node:fs";
+import { join as join44 } from "node:path";
 function markerPath() {
-  return join45(getConfigDir(), MARKER_FILENAME);
+  return join44(getConfigDir(), MARKER_FILENAME);
 }
 function writeMarker() {
   const dir = getConfigDir();
-  if (!existsSync31(dir))
-    mkdirSync19(dir, { recursive: true, mode: 448 });
-  writeFileSync21(markerPath(), JSON.stringify({ done: true }), { mode: 384 });
+  if (!existsSync30(dir))
+    mkdirSync18(dir, { recursive: true, mode: 448 });
+  writeFileSync20(markerPath(), JSON.stringify({ done: true }), { mode: 384 });
 }
 function displayNotice3(names) {
   console.error(`
-${import_picocolors38.default.green(`✓ Dosu: added the /${INCOGNITO_COMMAND_NAME} command to ${names.join(", ")}`)}
-` + `${import_picocolors38.default.dim(`  Type /${INCOGNITO_COMMAND_NAME} in a chat to keep that chat out of Dosu.`)}
+${import_picocolors37.default.green(`✓ Dosu: added the /${INCOGNITO_COMMAND_NAME} command to ${names.join(", ")}`)}
+` + `${import_picocolors37.default.dim(`  Type /${INCOGNITO_COMMAND_NAME} in a chat to keep that chat out of Dosu.`)}
 `);
 }
 function checkForIncognitoBackfill(options = {}) {
   const notify = options.notify ?? true;
   try {
-    if (existsSync31(markerPath()))
+    if (existsSync30(markerPath()))
       return;
     const added = [];
     let failed = false;
@@ -66715,14 +66650,187 @@ function checkForIncognitoBackfill(options = {}) {
     logger.error("incognito-backfill", `Incognito backfill failed: ${err}`);
   }
 }
-var import_picocolors38, MARKER_FILENAME = "incognito-backfill.json";
+var import_picocolors37, MARKER_FILENAME = "incognito-backfill.json";
 var init_incognito_backfill_check = __esm(() => {
   init_config();
   init_logger();
   init_agents();
   init_agents3();
   init_incognito();
+  import_picocolors37 = __toESM(require_picocolors(), 1);
+});
+
+// src/version/update-check.ts
+import { existsSync as existsSync31, mkdirSync as mkdirSync19, readFileSync as readFileSync29, writeFileSync as writeFileSync21 } from "node:fs";
+import { join as join45 } from "node:path";
+function isValidVersion2(value) {
+  return typeof value === "string" && SEMVER_PATTERN.test(value);
+}
+function stripPrerelease(version) {
+  return version.replace(/[-+].*$/, "");
+}
+function isNewerVersion(latest, current) {
+  const a = stripPrerelease(latest).split(".").map(Number);
+  const b = stripPrerelease(current).split(".").map(Number);
+  const len = Math.max(a.length, b.length);
+  for (let i = 0;i < len; i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av > bv)
+      return true;
+    if (av < bv)
+      return false;
+  }
+  return false;
+}
+function getCachePath3() {
+  return join45(getConfigDir(), CACHE_FILENAME5);
+}
+function readCache() {
+  try {
+    const path = getCachePath3();
+    if (!existsSync31(path))
+      return null;
+    const data = JSON.parse(readFileSync29(path, "utf-8"));
+    if (typeof data.lastCheck === "number" && isValidVersion2(data.latestVersion)) {
+      return data;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync31(dir)) {
+      mkdirSync19(dir, { recursive: true, mode: 448 });
+    }
+    writeFileSync21(getCachePath3(), JSON.stringify(cache), { mode: 384 });
+  } catch {}
+}
+async function fetchLatestVersion() {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
+  try {
+    const resp = await fetch(REGISTRY_URL, { signal: controller.signal });
+    if (!resp.ok)
+      return null;
+    const data = await resp.json();
+    const latest = data.latest;
+    return isValidVersion2(latest) ? latest : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function buildUpdateHint(channel, npx = false) {
+  if (channel === "npm" && npx) {
+    return 'Use "npx -y @dosu/cli@latest" for the next Dosu command';
+  }
+  return 'Run "dosu upgrade"';
+}
+function styleHint(hint) {
+  const match = hint.match(/^(.*)("[^"]+")(.*)$/);
+  if (!match)
+    return import_picocolors38.default.dim(hint);
+  const [, before, command, after] = match;
+  return [before && import_picocolors38.default.dim(before), import_picocolors38.default.cyan(command), after && import_picocolors38.default.dim(after)].filter(Boolean).join("");
+}
+function framedNotice(content, width) {
+  const innerWidth = Math.max(...content.map(visibleWidth2)) + BOX_PADDING * 2;
+  const framed = (line) => {
+    const pad = innerWidth - visibleWidth2(line);
+    const left = Math.floor(pad / 2);
+    return `${import_picocolors38.default.yellow("│")}${" ".repeat(left)}${line}${" ".repeat(pad - left)}${import_picocolors38.default.yellow("│")}`;
+  };
+  const box = [
+    import_picocolors38.default.yellow(`╭${"─".repeat(innerWidth)}╮`),
+    framed(""),
+    ...content.map(framed),
+    framed(""),
+    import_picocolors38.default.yellow(`╰${"─".repeat(innerWidth)}╯`)
+  ];
+  return `
+${centerBlock(box, width).join(`
+`)}
+`;
+}
+function versionArrow(current, latest) {
+  return `${import_picocolors38.default.dim(current)} ${import_picocolors38.default.dim("→")} ${import_picocolors38.default.bold(brand(latest))}`;
+}
+function buildAutoUpdateNotice(current, latest, interactive, width = process.stderr.columns ?? 80) {
+  if (interactive) {
+    return framedNotice([
+      `Updating Dosu: ${versionArrow(current, latest)}`,
+      import_picocolors38.default.dim("Installing in the background; your next command uses it")
+    ], width);
+  }
+  return `
+[dosu:update] Installing Dosu ${latest} in the background (running ${current}). ` + `The next Dosu command uses it; no action needed.
+`;
+}
+function buildUpdateNotice(current, latest, channel, interactive, npx = false, width = process.stderr.columns ?? 80) {
+  const hint = buildUpdateHint(channel, npx);
+  if (interactive) {
+    return framedNotice([`Update available: ${versionArrow(current, latest)}`, styleHint(hint)], width);
+  }
+  const agentAction = hint[0].toLowerCase() + hint.slice(1);
+  const verifyCommand = npx ? "npx -y @dosu/cli@latest --version" : "dosu --version";
+  return `
+[dosu:update] Update available: ${current} → ${latest}
+` + `Tell the user Dosu CLI is outdated. After they approve, ${agentAction}, ` + `then verify with "${verifyCommand}".
+`;
+}
+function getAvailableUpdate() {
+  const cache = readCache();
+  return cache && isNewerVersion(cache.latestVersion, VERSION) ? cache.latestVersion : null;
+}
+function handleNewerVersion(latest, notify) {
+  const autoUpdate = startAutoUpdate(latest);
+  if (!notify)
+    return;
+  const interactive = process.stderr.isTTY === true;
+  console.error(autoUpdate === "unavailable" ? buildUpdateNotice(VERSION, latest, INSTALL_CHANNEL, interactive, isNpxInvocation()) : buildAutoUpdateNotice(VERSION, latest, interactive));
+}
+async function checkForUpdates(options = {}) {
+  const notify = options.notify ?? true;
+  try {
+    const cache = readCache();
+    const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS2;
+    if (!isStale) {
+      if (isNewerVersion(cache.latestVersion, VERSION)) {
+        handleNewerVersion(cache.latestVersion, notify);
+      }
+      return;
+    }
+    const latest = await fetchLatestVersion();
+    const latestKnownVersion = latest ?? cache?.latestVersion ?? VERSION;
+    writeCache({
+      lastCheck: Date.now(),
+      latestVersion: latestKnownVersion
+    });
+    if (latest) {
+      logger.debug("update-check", `Cached latest version: ${latest}`);
+    }
+    if (isNewerVersion(latestKnownVersion, VERSION)) {
+      handleNewerVersion(latestKnownVersion, notify);
+    }
+  } catch (err) {
+    logger.error("update-check", `Update check failed: ${err}`);
+  }
+}
+var import_picocolors38, CACHE_FILENAME5 = "update-check.json", CHECK_INTERVAL_MS2, FETCH_TIMEOUT_MS2 = 1000, REGISTRY_URL = "https://registry.npmjs.org/-/package/@dosu/cli/dist-tags", SEMVER_PATTERN, BOX_PADDING = 3;
+var init_update_check = __esm(() => {
+  init_config();
+  init_logger();
+  init_styles();
+  init_layout();
+  init_auto_update();
   import_picocolors38 = __toESM(require_picocolors(), 1);
+  CHECK_INTERVAL_MS2 = 6 * 60 * 60 * 1000;
+  SEMVER_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 });
 
 // src/cli/fatal-error.ts
@@ -69109,4 +69217,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=152ccbaa-13cc-83fc-6475-6e2164756e21
+//# debugId=fa693edb-14f4-abcb-6475-6e2164756e21