@dosu/cli 0.56.1 → 0.57.1

package/bin/dosu.js

@@ -636,7 +636,18 @@ function numberValue(value) {
 var init_config_v1_migration = () => {};
 
 // src/config/config.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import {
+  closeSync,
+  constants,
+  existsSync as existsSync2,
+  fstatSync,
+  mkdirSync,
+  openSync,
+  readFileSync,
+  readSync,
+  renameSync,
+  writeFileSync
+} from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 function getConfigUserID(cfg) {
@@ -701,6 +712,26 @@ function loadConfig() {
   } catch {}
   return parsed;
 }
+function loadConfigNonBlocking() {
+  let fd;
+  try {
+    fd = openSync(getConfigPath(), constants.O_RDONLY | constants.O_NONBLOCK);
+    const file = fstatSync(fd);
+    if (!file.isFile() || file.size > MAX_BACKGROUND_CONFIG_BYTES)
+      return;
+    const content = Buffer.alloc(MAX_BACKGROUND_CONFIG_BYTES);
+    const bytesRead = readSync(fd, content, 0, content.byteLength, 0);
+    return parseConfig(JSON.parse(content.subarray(0, bytesRead).toString("utf8")));
+  } catch {
+    return;
+  } finally {
+    if (fd !== undefined) {
+      try {
+        closeSync(fd);
+      } catch {}
+    }
+  }
+}
 function parseConfig(raw) {
   if (isConfigV2(raw))
     return normalizeV2(raw);
@@ -796,8 +827,10 @@ function stringValue2(value) {
 function numberValue2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
+var MAX_BACKGROUND_CONFIG_BYTES;
 var init_config = __esm(() => {
   init_config_v1_migration();
+  MAX_BACKGROUND_CONFIG_BYTES = 64 * 1024;
 });
 
 // src/mcp/config-helpers.ts
@@ -1050,7 +1083,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.56.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.57.1", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -1829,21 +1862,21 @@ var init_read = __esm(() => {
 });
 
 // src/sync/incognito.ts
-import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+import { closeSync as closeSync2, fstatSync as fstatSync2, openSync as openSync2, readSync as readSync2 } from "node:fs";
 function textHasIncognitoMarker(text) {
   return text.includes(INCOGNITO_MARKER) || text.includes(COMMAND_NAME_MARKER);
 }
 function transcriptHasIncognitoMarker(path, maxBytes = MAX_SCAN_BYTES) {
   let fd;
   try {
-    fd = openSync(path, "r");
-    const size = Math.min(fstatSync(fd).size, maxBytes);
+    fd = openSync2(path, "r");
+    const size = Math.min(fstatSync2(fd).size, maxBytes);
     if (size === 0)
       return false;
     const buffer = Buffer.allocUnsafe(size);
     let offset = 0;
     while (offset < size) {
-      const read = readSync(fd, buffer, offset, size - offset, offset);
+      const read = readSync2(fd, buffer, offset, size - offset, offset);
       if (read === 0)
         break;
       offset += read;
@@ -1854,7 +1887,7 @@ function transcriptHasIncognitoMarker(path, maxBytes = MAX_SCAN_BYTES) {
   } finally {
     if (fd !== undefined) {
       try {
-        closeSync(fd);
+        closeSync2(fd);
       } catch {}
     }
   }
@@ -4205,11 +4238,11 @@ var init_session_errors = __esm(() => {
 // src/config/config-lock.ts
 import { randomUUID } from "node:crypto";
 import {
-  closeSync as closeSync2,
+  closeSync as closeSync3,
   existsSync as existsSync8,
   linkSync,
   mkdirSync as mkdirSync5,
-  openSync as openSync2,
+  openSync as openSync3,
   readFileSync as readFileSync7,
   statSync as statSync3,
   unlinkSync,
@@ -4262,12 +4295,12 @@ async function acquireConfigRefreshLock(options) {
   }
 }
 function createLockFile(lockPath, metadata) {
-  const fd = openSync2(lockPath, "wx", 384);
+  const fd = openSync3(lockPath, "wx", 384);
   try {
     writeFileSync4(fd, JSON.stringify(metadata));
   } catch (cause) {
     try {
-      closeSync2(fd);
+      closeSync3(fd);
     } catch {}
     try {
       unlinkSync(lockPath);
@@ -4275,7 +4308,7 @@ function createLockFile(lockPath, metadata) {
     throw cause;
   }
   try {
-    closeSync2(fd);
+    closeSync3(fd);
   } catch (cause) {
     try {
       unlinkSync(lockPath);
@@ -8515,6 +8548,9 @@ function layoutMargin(columns = process.stdout.columns ?? 80) {
 function frameTopMargin(rows = process.stdout.rows ?? 24) {
   return Math.max(2, Math.min(6, Math.floor(rows / 8)));
 }
+function frameMaxLines(rows = process.stdout.rows ?? 24) {
+  return Math.max(1, rows - frameTopMargin(rows) - 2);
+}
 function breadcrumb(segments, width = contentWidth()) {
   const head = segments.slice(0, -1);
   const leaf = segments[segments.length - 1] ?? "";
@@ -11821,12 +11857,12 @@ var init_integrations = __esm(() => {
 
 // src/sessions/project-dir.ts
 import {
-  closeSync as closeSync3,
+  closeSync as closeSync4,
   existsSync as existsSync11,
   mkdirSync as mkdirSync7,
-  openSync as openSync3,
+  openSync as openSync4,
   readFileSync as readFileSync11,
-  readSync as readSync2,
+  readSync as readSync3,
   renameSync as renameSync3,
   statSync as statSync4,
   writeFileSync as writeFileSync7
@@ -11859,18 +11895,18 @@ function saveCacheFile(configDir, entries) {
 function readHead(path, bytes = HEAD_BYTES) {
   let fd;
   try {
-    fd = openSync3(path, "r");
+    fd = openSync4(path, "r");
   } catch {
     return null;
   }
   try {
     const buf = Buffer.alloc(bytes);
-    const read = readSync2(fd, buf, 0, bytes, 0);
+    const read = readSync3(fd, buf, 0, bytes, 0);
     return buf.subarray(0, read).toString("utf-8");
   } catch {
     return null;
   } finally {
-    closeSync3(fd);
+    closeSync4(fd);
   }
 }
 function cwdFromJsonlHead(text) {
@@ -13680,7 +13716,7 @@ var init_sync = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "93db7db7-907f-4d14-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "ca9e58ba-ed30-6875-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -15205,7 +15241,7 @@ var init_env = __esm(() => {
 });
 
 // src/learner/executable.ts
-import { accessSync, constants, existsSync as existsSync16 } from "node:fs";
+import { accessSync, constants as constants2, existsSync as existsSync16 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { homedir as homedir6 } from "node:os";
 import { delimiter as delimiter2, dirname as dirname6, join as join16 } from "node:path";
@@ -15224,7 +15260,7 @@ function sdkNativeBinaryExists() {
 }
 function isExecutable(path) {
   try {
-    accessSync(path, constants.X_OK);
+    accessSync(path, constants2.X_OK);
     return true;
   } catch {
     return false;
@@ -60724,6 +60760,10 @@ function runUpgrade(channel = INSTALL_CHANNEL, options = {}) {
     }
     manager = owningPackageManager(options.entrypoint ?? process.argv[1], platform, options.comSpec, env, cwd);
     if (!manager) {
+      if (env.DOSU_DEV === "true") {
+        console.log("DOSU_DEV=true and this copy is not a global package: skipping the package install.");
+        return 0;
+      }
       printNonGlobalPackageGuidance();
       return 1;
     }
@@ -60756,6 +60796,41 @@ Could not update Dosu automatically.`);
   console.log('Run "dosu --version" to verify.');
   return 0;
 }
+function postUpgradeArgs(interactive) {
+  return interactive ? ["setup"] : ["mcp", "refresh"];
+}
+function newBinaryInvocation(channel, args, entrypoint = process.argv[1], execPath = process.execPath) {
+  if (channel === "npm") {
+    return entrypoint ? { command: execPath, args: [entrypoint, ...args] } : null;
+  }
+  if (channel === "homebrew") {
+    return { command: "dosu", args };
+  }
+  return null;
+}
+function isInteractiveTerminal() {
+  return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+function setupAgentsWithNewBinary(channel, options) {
+  const interactive = options.interactive ?? isInteractiveTerminal();
+  const invocation = newBinaryInvocation(channel, postUpgradeArgs(interactive), options.entrypoint ?? process.argv[1]);
+  if (!invocation) {
+    console.error(SETUP_FALLBACK);
+    return;
+  }
+  console.log(interactive ? `
+Running setup with the new version to update your AI agents...
+` : `
+Refreshing agent MCP configs with the new version...`);
+  const result = spawnSync(invocation.command, invocation.args, {
+    cwd: options.cwd ?? homedir9(),
+    shell: false,
+    stdio: "inherit"
+  });
+  if (result.error || result.status !== 0) {
+    console.error(SETUP_FALLBACK);
+  }
+}
 async function completeUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   const status = runUpgrade(channel, options);
   if (status !== 0)
@@ -60771,16 +60846,17 @@ async function completeUpgrade(channel = INSTALL_CHANNEL, options = {}) {
   } catch {
     console.error('Skills could not be refreshed. Run "dosu skill update" to retry.');
   }
+  setupAgentsWithNewBinary(channel, options);
   return 0;
 }
 function upgradeCommand() {
-  return new Command("upgrade").description("Update Dosu to the latest version and refresh agent skills").action(async () => {
+  return new Command("upgrade").description("Update Dosu to the latest version, then re-run setup to update your AI agents").action(async () => {
     const status = await completeUpgrade();
     if (status !== 0)
       process.exitCode = status;
   });
 }
-var import_picocolors31, 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;
+var import_picocolors31, 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_skill();
@@ -60806,7 +60882,7 @@ var init_upgrade = __esm(() => {
 });
 
 // src/debug/follow.ts
-import { closeSync as closeSync5, openSync as openSync5, readSync as readSync4, statSync as statSync8 } from "node:fs";
+import { closeSync as closeSync6, openSync as openSync6, readSync as readSync5, statSync as statSync8 } from "node:fs";
 function createLogFollower(path, emit) {
   const sizeOf = () => {
     try {
@@ -60824,15 +60900,15 @@ function createLogFollower(path, emit) {
       if (size === offset)
         return;
       try {
-        const fd = openSync5(path, "r");
+        const fd = openSync6(path, "r");
         try {
           const buf = Buffer.alloc(size - offset);
-          const read = readSync4(fd, buf, 0, buf.length, offset);
+          const read = readSync5(fd, buf, 0, buf.length, offset);
           offset += read;
           if (read > 0)
             emit(buf.toString("utf-8", 0, read));
         } finally {
-          closeSync5(fd);
+          closeSync6(fd);
         }
       } catch {}
     }
@@ -61510,6 +61586,36 @@ var init_providers = __esm(() => {
   init_zed();
 });
 
+// src/mcp/refresh.ts
+function configuredProviders() {
+  return allSetupProviders().filter((provider) => {
+    try {
+      return provider.isInstalled() && provider.isConfigured();
+    } catch {
+      return false;
+    }
+  });
+}
+function refreshConfiguredProviders(cfg) {
+  const result = { updated: [], failed: [] };
+  for (const provider of configuredProviders()) {
+    try {
+      provider.install(cfg, true);
+      logger.info("mcp", `Refreshed ${provider.name()} MCP entry`);
+      result.updated.push(provider);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      logger.error("mcp", `Refresh failed for ${provider.name()}: ${error.message}`);
+      result.failed.push({ provider, error });
+    }
+  }
+  return result;
+}
+var init_refresh = __esm(() => {
+  init_logger();
+  init_providers();
+});
+
 // src/version/update-check.ts
 import { existsSync as existsSync23, mkdirSync as mkdirSync13, readFileSync as readFileSync22, writeFileSync as writeFileSync14 } from "node:fs";
 import { join as join39 } from "node:path";
@@ -61665,15 +61771,98 @@ var init_update_check = __esm(() => {
   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 existsSync24, mkdirSync as mkdirSync14, readFileSync as readFileSync23, writeFileSync as writeFileSync15 } from "node:fs";
+import { join as join40 } 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 getCachePath4() {
+  return join40(getConfigDir(), CACHE_FILENAME5);
+}
+function readMcpRefreshCache() {
+  try {
+    const path = getCachePath4();
+    if (!existsSync24(path))
+      return null;
+    const data = JSON.parse(readFileSync23(path, "utf-8"));
+    if (typeof data?.version === "string")
+      return { version: data.version };
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeMcpRefreshCache(cache) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync24(dir)) {
+      mkdirSync14(dir, { recursive: true, mode: 448 });
+    }
+    writeFileSync15(getCachePath4(), JSON.stringify(cache), { mode: 384 });
+  } catch {}
+}
+function canRefreshMcp(cfg) {
+  const target = cfg.active_account?.target;
+  if (!target?.api_key)
+    return false;
+  return cfg.mode === MODE_OSS || Boolean(target.deployment_id);
+}
+function displayNotice3(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 skills, 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 });
+      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);
+    writeMcpRefreshCache({ version: VERSION });
+    logger.info("mcp-refresh", `Version ${VERSION}: refreshed ${result.updated.length}, failed ${result.failed.length}`);
+    if (notify && result.updated.length > 0) {
+      displayNotice3(result.updated.map((provider) => provider.name()));
+    }
+  } catch (err) {
+    logger.error("mcp-refresh", `MCP refresh check failed: ${err}`);
+  }
+}
+var import_picocolors33, CACHE_FILENAME5 = "mcp-refresh.json", MCP_FORMAT_CHANGES;
+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"];
+});
+
 // src/rules/installer.ts
-import { existsSync as existsSync24, mkdirSync as mkdirSync14, readFileSync as readFileSync23, unlinkSync as unlinkSync5, writeFileSync as writeFileSync15 } from "node:fs";
+import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync24, unlinkSync as unlinkSync5, writeFileSync as writeFileSync16 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
-import { dirname as dirname11, join as join40 } from "node:path";
+import { dirname as dirname11, join as join41 } from "node:path";
 function claudeConfigDir4() {
-  return process.env.CLAUDE_CONFIG_DIR || join40(homedir12(), ".claude");
+  return process.env.CLAUDE_CONFIG_DIR || join41(homedir12(), ".claude");
 }
 function codexHome4() {
-  return process.env.CODEX_HOME || join40(homedir12(), ".codex");
+  return process.env.CODEX_HOME || join41(homedir12(), ".codex");
 }
 function isRuleAgent(agent) {
   return Object.hasOwn(RULE_TARGETS, agent);
@@ -61699,17 +61888,17 @@ async function fetchDosuRule(fetchImpl = globalThis.fetch) {
   return normalizeRule(FALLBACK_DOSU_RULE);
 }
 function ensureParent(path) {
-  mkdirSync14(dirname11(path), { recursive: true });
+  mkdirSync15(dirname11(path), { recursive: true });
 }
 function writeIfChanged(path, content) {
-  if (!existsSync24(path)) {
+  if (!existsSync25(path)) {
     ensureParent(path);
-    writeFileSync15(path, content, "utf-8");
+    writeFileSync16(path, content, "utf-8");
     return "created";
   }
-  if (readFileSync23(path, "utf-8") === content)
+  if (readFileSync24(path, "utf-8") === content)
     return "unchanged";
-  writeFileSync15(path, content, "utf-8");
+  writeFileSync16(path, content, "utf-8");
   return "updated";
 }
 function findSection(content) {
@@ -61735,14 +61924,14 @@ function buildSection(content, lineEnding = `
   return `${DOSU_RULE_SECTION_START}${lineEnding}${body}${lineEnding}${DOSU_RULE_SECTION_END}`;
 }
 function upsertSection(path, content) {
-  if (!existsSync24(path)) {
+  if (!existsSync25(path)) {
     const section = buildSection(content);
     ensureParent(path);
-    writeFileSync15(path, `${section}
+    writeFileSync16(path, `${section}
 `, "utf-8");
     return "created";
   }
-  const existing = readFileSync23(path, "utf-8");
+  const existing = readFileSync24(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const section = buildSection(content, lineEnding);
   const location = findSection(existing);
@@ -61755,7 +61944,7 @@ function upsertSection(path, content) {
   }
   if (next === existing)
     return "unchanged";
-  writeFileSync15(path, next, "utf-8");
+  writeFileSync16(path, next, "utf-8");
   return "updated";
 }
 function installRuleForAgent(agent, content) {
@@ -61772,13 +61961,13 @@ function removeRuleForAgent(agent) {
     return null;
   const target = RULE_TARGETS[agent];
   const path = target.path();
-  if (!existsSync24(path))
+  if (!existsSync25(path))
     return { agent, path, action: "not_found" };
   if (target.kind === "file") {
     unlinkSync5(path);
     return { agent, path, action: "removed" };
   }
-  const existing = readFileSync23(path, "utf-8");
+  const existing = readFileSync24(path, "utf-8");
   const lineEnding = lineEndingFor(existing);
   const location = findSection(existing);
   if (!location)
@@ -61787,7 +61976,7 @@ function removeRuleForAgent(agent) {
   if (!next) {
     unlinkSync5(path);
   } else {
-    writeFileSync15(path, `${next}${lineEnding}`, "utf-8");
+    writeFileSync16(path, `${next}${lineEnding}`, "utf-8");
   }
   return { agent, path, action: "removed" };
 }
@@ -61815,36 +62004,36 @@ var init_installer = __esm(() => {
   RULE_TARGETS = {
     claude: {
       kind: "file",
-      path: () => join40(claudeConfigDir4(), "rules", "dosu.md")
+      path: () => join41(claudeConfigDir4(), "rules", "dosu.md")
     },
     cursor: {
       kind: "file",
-      path: () => join40(homedir12(), ".cursor", "rules", "dosu.mdc"),
+      path: () => join41(homedir12(), ".cursor", "rules", "dosu.mdc"),
       cursorFrontmatter: true
     },
     codex: {
       kind: "section",
-      path: () => join40(codexHome4(), "AGENTS.md")
+      path: () => join41(codexHome4(), "AGENTS.md")
     },
     opencode: {
       kind: "section",
-      path: () => join40(homedir12(), ".config", "opencode", "AGENTS.md")
+      path: () => join41(homedir12(), ".config", "opencode", "AGENTS.md")
     },
     gemini: {
       kind: "section",
-      path: () => join40(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
     },
     antigravity: {
       kind: "section",
-      path: () => join40(homedir12(), ".gemini", "GEMINI.md")
+      path: () => join41(homedir12(), ".gemini", "GEMINI.md")
     }
   };
 });
 
 // src/setup/agents-md-step.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync25, readFileSync as readFileSync24, writeFileSync as writeFileSync16 } from "node:fs";
-import { join as join41 } from "node:path";
+import { existsSync as existsSync26, readFileSync as readFileSync25, writeFileSync as writeFileSync17 } from "node:fs";
+import { join as join42 } from "node:path";
 function inGitWorkTree(cwd = process.cwd()) {
   try {
     const stdout = execSync3("git rev-parse --is-inside-work-tree", {
@@ -61858,10 +62047,10 @@ function inGitWorkTree(cwd = process.cwd()) {
 }
 function dosuAgentsSectionState(cwd = process.cwd()) {
   try {
-    const path = join41(cwd, "AGENTS.md");
-    if (!existsSync25(path))
+    const path = join42(cwd, "AGENTS.md");
+    if (!existsSync26(path))
       return "missing";
-    const content = readFileSync24(path, "utf-8");
+    const content = readFileSync25(path, "utf-8");
     const startMatch = content.match(SECTION_START_RE);
     if (!startMatch || !content.includes(DOSU_SECTION_END))
       return "missing";
@@ -61896,14 +62085,14 @@ function findSection2(content) {
   return { start, end };
 }
 function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RULE) {
-  const path = join41(cwd, "AGENTS.md");
-  if (!existsSync25(path)) {
+  const path = join42(cwd, "AGENTS.md");
+  if (!existsSync26(path)) {
     const section = buildDosuAgentsSection(content);
-    writeFileSync16(path, `${section}
+    writeFileSync17(path, `${section}
 `);
     return { path, action: "created" };
   }
-  const existing = readFileSync24(path, "utf-8");
+  const existing = readFileSync25(path, "utf-8");
   const lineEnding = lineEndingFor2(existing);
   const section = renderDosuAgentsSection(content, lineEnding);
   const location = findSection2(existing);
@@ -61915,7 +62104,7 @@ function upsertDosuAgentsSection(cwd = process.cwd(), content = FALLBACK_DOSU_RU
   }
   if (next === existing)
     return { path, action: "unchanged" };
-  writeFileSync16(path, next);
+  writeFileSync17(path, next);
   return { path, action: "updated" };
 }
 async function stepUpdateAgentsMd(cwd = process.cwd(), content) {
@@ -61971,15 +62160,15 @@ var init_errors3 = __esm(() => {
 var MCP_PROVIDER_SLUG2 = "dosu_mcp";
 
 // src/sessions/session-title.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync15, readFileSync as readFileSync25, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync17 } from "node:fs";
+import { existsSync as existsSync27, mkdirSync as mkdirSync16, readFileSync as readFileSync26, renameSync as renameSync6, statSync as statSync9, writeFileSync as writeFileSync18 } from "node:fs";
 import { homedir as homedir13 } from "node:os";
-import { join as join42 } from "node:path";
+import { join as join43 } from "node:path";
 function cachePath2(configDir) {
-  return join42(configDir, CACHE_FILENAME5);
+  return join43(configDir, CACHE_FILENAME6);
 }
 function loadCacheFile2(configDir) {
   try {
-    const raw = JSON.parse(readFileSync25(cachePath2(configDir), "utf-8"));
+    const raw = JSON.parse(readFileSync26(cachePath2(configDir), "utf-8"));
     if (raw.schema_version !== CACHE_SCHEMA_VERSION2 || typeof raw.entries !== "object")
       return {};
     return raw.entries;
@@ -61989,12 +62178,12 @@ function loadCacheFile2(configDir) {
 }
 function saveCacheFile2(configDir, entries) {
   try {
-    if (!existsSync26(configDir))
-      mkdirSync15(configDir, { recursive: true, mode: 448 });
+    if (!existsSync27(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 };
-    writeFileSync17(tmp, JSON.stringify(file), { mode: 384 });
+    writeFileSync18(tmp, JSON.stringify(file), { mode: 384 });
     renameSync6(tmp, path);
   } catch {}
 }
@@ -62027,15 +62216,15 @@ function claudeSummaryFromHead(text) {
   }
   return null;
 }
-function reconstructSession(harness, id, slug, home = homedir13(), exists = existsSync26) {
+function reconstructSession(harness, id, slug, home = homedir13(), exists = existsSync27) {
   if (!slug)
     return null;
   const candidates = [];
   if (harness === "claude") {
-    candidates.push(join42(home, ".claude", "projects", slug, `${id}.jsonl`));
+    candidates.push(join43(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 = join43(home, ".cursor", "projects", slug);
+    candidates.push(join43(project, "agent-transcripts", id, `${id}.jsonl`), join43(project, "agent-transcripts", `${id}.jsonl`));
   } else {
     return null;
   }
@@ -62047,7 +62236,7 @@ function reconstructSession(harness, id, slug, home = homedir13(), exists = exis
 }
 function readHead2(path) {
   try {
-    return readFileSync25(path, "utf-8").slice(0, 128 * 1024);
+    return readFileSync26(path, "utf-8").slice(0, 128 * 1024);
   } catch {
     return null;
   }
@@ -62098,7 +62287,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_FILENAME6 = "session-titles.json", CACHE_SCHEMA_VERSION2 = 3, HEAD_LINES2 = 50, SESSION_NAME_MAX = 80;
 var init_session_title = __esm(() => {
   init_config();
   init_read();
@@ -62127,7 +62316,7 @@ var init_alt_screen = __esm(() => {
 });
 
 // src/tui/activity-view.ts
-import { existsSync as existsSync27, readFileSync as readFileSync26 } from "node:fs";
+import { existsSync as existsSync28, readFileSync as readFileSync27 } from "node:fs";
 import { basename as basename5 } from "node:path";
 function reduceActivityViewKey(key) {
   if (key === "q" || key === ESC7 || key === CTRL_C4)
@@ -62268,15 +62457,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_picocolors33.default.bold(brand("Studying sessions..."))}${import_picocolors33.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_picocolors33.default.yellow("○")} ${import_picocolors33.default.bold("Paused")} ${import_picocolors33.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_picocolors33.default.yellow("○")} ${import_picocolors33.default.bold("Not running")} ${import_picocolors33.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_picocolors33.default.dim("○")} ${import_picocolors33.default.bold("Idle")} ${import_picocolors33.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;
@@ -62285,7 +62474,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_picocolors33.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}`;
@@ -62324,20 +62513,20 @@ 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_picocolors33.default.bold(brand(title)),
-    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors33.default.dim(line)),
+    import_picocolors34.default.bold(brand(title)),
+    ...wrapLine(scope, maxInner, "").map((line) => import_picocolors34.default.dim(line)),
     "",
-    `${import_picocolors33.default.bold("enter")} ${verb} · ${import_picocolors33.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_picocolors33.default.dim(`╭${"─".repeat(inner + 2)}╮`),
-    ...rows.map((row) => `${import_picocolors33.default.dim("│")} ${pad(row)} ${import_picocolors33.default.dim("│")}`),
-    import_picocolors33.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 renderActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], studiedBeforeRun = 0, open = [], runProgress = null, projectNames = {}, sessionNames = {}) {
+function buildActivityFrame(status, activity, width, backlog = null, pane = DEFAULT_PANE, queued = [], studiedBeforeRun = 0, open = [], runProgress = null, projectNames = {}, sessionNames = {}, frameLines) {
   const studied = status.state.watermark ? `Studied sessions up to ${localTime(status.state.watermark)}` : "Nothing studied yet";
   const queueDetail = [];
   if (status.backoffUntil) {
@@ -62350,7 +62539,7 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
     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_picocolors33.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;
@@ -62372,27 +62561,18 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
   const source = pane.tab === "activity" ? activity.map((line) => formatActivityLine(line, width, fullRows)) : pane.tab === "queued" ? queuedRows : pane.tab === "open" ? openRows : studiedRows;
   const emptyStudied = status.state.watermark ? "No sessions recorded yet. History starts with the next study run." : "No studied sessions yet.";
   const empty = pane.tab === "activity" ? "No sync activity in the log yet." : pane.tab === "queued" ? "Queue empty. Finished agent sessions appear here." : pane.tab === "open" ? "No open sessions. Live agent sessions sit here until they go quiet." : emptyStudied;
-  const height = fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
-  const { visible, above, below } = windowList(source, pane.scroll, height);
-  const display = fullRows ? visible.flatMap((row) => wrapRow(row, width)) : visible;
-  const listRows = display.length > 0 ? display.map((row) => import_picocolors33.default.dim(row)) : [import_picocolors33.default.dim(empty)];
-  const scrollParts = [];
-  if (above > 0)
-    scrollParts.push(`↑ ${above} earlier`);
-  if (below > 0)
-    scrollParts.push(`↓ ${below} newer`);
-  const lines = [
+  const header = [
     breadcrumb(["home", "activity"], width),
     "",
     statusLine(status),
-    import_picocolors33.default.dim(studied),
-    ...queueDetail.length > 0 ? wrapLine(queueDetail.join(" · "), width).map((line) => import_picocolors33.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,
     "",
-    ...tabBar(pane.tab, queued.length, open.length, latestPass.size, width),
-    ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors33.default.dim(clip(scrollParts.join(" · "), width))] : [],
+    ...tabBar(pane.tab, queued.length, open.length, latestPass.size, width)
+  ];
+  const footer = [
     "",
     ...pane.confirm ? centerBlock(confirmBox(queued.length, backlog, width, pane.confirm), width) : [
       ...wrapLine([
@@ -62402,11 +62582,32 @@ function renderActivityFrame(status, activity, width, backlog = null, pane = DEF
         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_picocolors33.default.dim(line))
+      ].join(" · "), width, "").map((line) => import_picocolors34.default.dim(line))
     ]
   ];
-  return lines.join(`
-`);
+  const defaultHeight = fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
+  const listBudget = frameLines === undefined ? defaultHeight : Math.max(1, Math.min(defaultHeight, frameLines - header.length - footer.length - 1));
+  let height = listBudget;
+  let { visible, above, below } = windowList(source, pane.scroll, height);
+  let display = fullRows ? visible.flatMap((row) => wrapRow(row, width)) : visible;
+  while (fullRows && frameLines !== undefined && display.length > listBudget && height > 1) {
+    height -= 1;
+    ({ visible, above, below } = windowList(source, pane.scroll, height));
+    display = visible.flatMap((row) => wrapRow(row, width));
+  }
+  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`);
+  if (below > 0)
+    scrollParts.push(`↓ ${below} newer`);
+  const lines = [
+    ...header,
+    ...listRows,
+    ...scrollParts.length > 0 ? [import_picocolors34.default.dim(clip(scrollParts.join(" · "), width))] : [],
+    ...footer
+  ];
+  return { lines, listHeight: height };
 }
 function createRowNamer() {
   const dirs = createProjectDirResolver();
@@ -62436,7 +62637,7 @@ function createRowNamer() {
         names.titles[key] = t;
     };
     for (const s of [...backlog.queued, ...backlog.open]) {
-      if (!existsSync27(s.path))
+      if (!existsSync28(s.path))
         continue;
       const key = `${s.harness}/${s.id}`;
       const dir = dirs.resolve(s);
@@ -62473,7 +62674,7 @@ function createRowNamer() {
 }
 function defaultReadLog2() {
   try {
-    return readFileSync26(logger.getLogPath(), "utf-8");
+    return readFileSync27(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -62518,7 +62719,7 @@ function runActivityView(io = {}) {
       return sessions.open.length;
     return (status.state.mined_sessions ?? []).length;
   };
-  const listHeight = () => fullRows ? ACTIVITY_VIEW_FULL_LIST_ROWS : ACTIVITY_VIEW_LIST_LINES;
+  let listHeight = ACTIVITY_VIEW_LIST_LINES;
   let lastFrame = null;
   let studiedBeforeRun = null;
   const draw = () => {
@@ -62543,7 +62744,11 @@ function runActivityView(io = {}) {
       confirmSync = null;
     const width = activityWidth(output.columns ?? 80);
     const rowNames = rowNamesFor(status, sessions);
-    const frame = renderActivityFrame(status, activity, width, backlog, { tab, scroll, confirm: confirmSync ?? undefined, fullRows }, sessions.queued, studiedBeforeRun ?? 0, sessions.open, runProgress, rowNames.projects, rowNames.titles);
+    scroll = Math.min(scroll, Math.max(0, activeListLength() - listHeight));
+    const built = buildActivityFrame(status, activity, width, backlog, { tab, scroll, confirm: confirmSync ?? undefined, fullRows }, sessions.queued, studiedBeforeRun ?? 0, sessions.open, runProgress, rowNames.projects, rowNames.titles, frameMaxLines(output.rows ?? 24));
+    listHeight = built.listHeight;
+    const frame = built.lines.join(`
+`);
     if (frame === lastFrame)
       return;
     lastFrame = frame;
@@ -62638,7 +62843,7 @@ ${CLEAR_BELOW}`);
           scroll = 0;
           draw();
         } else if (action === "up") {
-          const maxScroll = Math.max(0, activeListLength() - listHeight());
+          const maxScroll = Math.max(0, activeListLength() - listHeight);
           if (scroll < maxScroll) {
             scroll += 1;
             draw();
@@ -62654,7 +62859,7 @@ ${CLEAR_BELOW}`);
     input.on("data", onData);
   });
 }
-var import_picocolors33, 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();
@@ -62669,7 +62874,7 @@ var init_activity_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors33 = __toESM(require_picocolors(), 1);
+  import_picocolors34 = __toESM(require_picocolors(), 1);
   ESC7 = String.fromCharCode(27);
   HIDE_CURSOR3 = `${ESC7}[?25l`;
   SHOW_CURSOR3 = `${ESC7}[?25h`;
@@ -63450,6 +63655,7 @@ async function runSetupFlow(opts = {}) {
     }));
     return;
   }
+  writeMcpRefreshCache({ version: VERSION });
   const configuredProviders = configured.filter((result) => (result.action === "install" || result.action === "skip") && !result.error);
   const mcpCompleted = configuredProviders.length > 0;
   if (mcpCompleted) {
@@ -63894,25 +64100,14 @@ async function runSwitchTarget(scope = "org") {
     return;
   updateTarget(cfg, { api_key: apiKey });
   saveConfig(cfg);
-  const configured = allSetupProviders().filter((provider) => {
-    try {
-      return provider.isInstalled() && provider.isConfigured();
-    } catch {
-      return false;
-    }
-  });
-  for (const provider of configured) {
-    try {
-      provider.install(cfg, true);
-      logger.info("setup", `Switch: updated ${provider.name()}`);
-      log2.success(`${provider.name()} ${dim("· updated")}`);
-    } catch (err) {
-      const error = err instanceof Error ? err : new Error(String(err));
-      logger.error("setup", `Switch: update failed for ${provider.name()}: ${error.message}`);
-      log2.error(`Failed to update ${provider.name()}: ${error.message}`);
-    }
+  const refreshed = refreshConfiguredProviders(cfg);
+  for (const provider of refreshed.updated) {
+    log2.success(`${provider.name()} ${dim("· updated")}`);
+  }
+  for (const { provider, error } of refreshed.failed) {
+    log2.error(`Failed to update ${provider.name()}: ${error.message}`);
   }
-  if (configured.length > 0) {
+  if (refreshed.updated.length + refreshed.failed.length > 0) {
     log2.info("Restart your AI agents so they pick up the new MCP target.");
   }
 }
@@ -64162,7 +64357,7 @@ async function stepSelectTools(detected) {
     initialValues: preselected,
     statusFor: (id, picked) => {
       if (configuredMap.get(id))
-        return picked ? dim("configured") : import_picocolors34.default.yellow("will remove");
+        return picked ? dim("configured") : import_picocolors35.default.yellow("will remove");
       return picked ? brand("will configure") : undefined;
     },
     summary: (picked) => {
@@ -64337,7 +64532,7 @@ ${dim(wrapLog("Run it inside a session to keep that session out of studying. Rem
     log2.success("All agents already configured. No changes needed.");
   }
 }
-var import_picocolors34, 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_dist();
   init_errors3();
@@ -64348,6 +64543,7 @@ var init_flow2 = __esm(() => {
   init_agents();
   init_agents3();
   init_providers();
+  init_refresh();
   init_agents4();
   init_detach();
   init_sync();
@@ -64355,12 +64551,13 @@ var init_flow2 = __esm(() => {
   init_activity_view();
   init_layout();
   init_prompts();
+  init_mcp_refresh_check();
   init_agents_md_step();
   init_analytics2();
   init_github_step();
   init_rules_step();
   init_styles();
-  import_picocolors34 = __toESM(require_picocolors(), 1);
+  import_picocolors35 = __toESM(require_picocolors(), 1);
   OAUTH_ANALYTICS_REASONS = new Set([
     "access_denied",
     "bad_oauth_state",
@@ -64375,6 +64572,10 @@ var init_flow2 = __esm(() => {
 });
 
 // src/tui/analytics-view.ts
+function analyticsListHeight(rows) {
+  const room = frameMaxLines(rows) - ANALYTICS_VIEW_CHROME_LINES;
+  return Math.max(1, Math.min(ANALYTICS_VIEW_LINES, room));
+}
 function reduceAnalyticsViewKey(key) {
   if (key === "q" || key === ESC8 || key === CTRL_C5)
     return "back";
@@ -64484,11 +64685,11 @@ function analyticsTabRows(tab, state, pageStats) {
     return projectRows(state);
   return pageRows(pageStats);
 }
-function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending = false, width = contentWidth()) {
+function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending = false, width = contentWidth(), height = ANALYTICS_VIEW_LINES) {
   const rows = analyticsTabRows(tab, state, pageStats);
-  const { visible, above, below } = windowReport(rows, scroll);
+  const { visible, above, below } = windowReport(rows, scroll, height);
   const empty = tab === "overview" ? "No analytics yet. They appear after the first study run." : tab === "projects" ? "No per-project history yet. It fills in as sessions are studied." : pagesPending ? "Loading page analytics..." : "No page analytics yet.";
-  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors35.default.dim(row)) : [import_picocolors35.default.dim(empty)];
+  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors36.default.dim(row)) : [import_picocolors36.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
@@ -64504,9 +64705,9 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
     ], tab, width, { spread: false }),
     "",
     ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors35.default.dim(scrollParts.join(" · "))] : [],
+    ...scrollParts.length > 0 ? [import_picocolors36.default.dim(scrollParts.join(" · "))] : [],
     "",
-    import_picocolors35.default.dim("tab switch · ↑↓ scroll · esc back")
+    import_picocolors36.default.dim("tab switch · ↑↓ scroll · esc back")
   ];
   return lines.join(`
 `);
@@ -64526,10 +64727,13 @@ function runAnalyticsView(io = {}) {
   let pagesPending = true;
   let closed = false;
   let lastFrame = null;
+  const listHeight = () => analyticsListHeight(output.rows ?? 24);
+  const maxScroll = () => Math.max(0, analyticsTabRows(tab, status.state, pageStats).length - listHeight());
   const draw = () => {
     status = getStatus();
+    scroll = Math.min(scroll, maxScroll());
     const width = Math.min(contentWidth(output.columns ?? 80), (output.columns ?? 80) - 1);
-    const frame = renderAnalyticsFrame(status.state, tab, scroll, pageStats, pagesPending, width);
+    const frame = renderAnalyticsFrame(status.state, tab, scroll, pageStats, pagesPending, width, listHeight());
     if (frame === lastFrame)
       return;
     lastFrame = frame;
@@ -64590,8 +64794,7 @@ ${CLEAR_BELOW2}`);
             draw();
           }
         } else if (action === "down") {
-          const maxScroll = Math.max(0, analyticsTabRows(tab, status.state, pageStats).length - ANALYTICS_VIEW_LINES);
-          if (scroll < maxScroll) {
+          if (scroll < maxScroll()) {
             scroll += 1;
             draw();
           }
@@ -64601,7 +64804,7 @@ ${CLEAR_BELOW2}`);
     input.on("data", onData);
   });
 }
-var import_picocolors35, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 14, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
+var import_picocolors36, ESC8, HIDE_CURSOR4, SHOW_CURSOR4, CTRL_C5, KEY_UP5, KEY_DOWN5, KEY_RIGHT4, KEY_LEFT4, CURSOR_HOME2, CLEAR_BELOW2, CLEAR_EOL2, ANALYTICS_VIEW_POLL_MS = 1000, ANALYTICS_VIEW_LINES = 14, ANALYTICS_VIEW_CHROME_LINES = 8, ANALYTICS_VIEW_TABS, TOP_PAGES_LIMIT = 5, TOP_CITED_DAYS = 30, label = (text) => text.padEnd(26);
 var init_analytics_view = __esm(() => {
   init_trpc();
   init_config();
@@ -64609,7 +64812,7 @@ var init_analytics_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors35 = __toESM(require_picocolors(), 1);
+  import_picocolors36 = __toESM(require_picocolors(), 1);
   ESC8 = String.fromCharCode(27);
   HIDE_CURSOR4 = `${ESC8}[?25l`;
   SHOW_CURSOR4 = `${ESC8}[?25h`;
@@ -64627,7 +64830,7 @@ var init_analytics_view = __esm(() => {
 // src/tui/banner.ts
 function paintLogoRow(row) {
   return row.map(([tone, art]) => {
-    if (!import_picocolors36.default.isColorSupported)
+    if (!import_picocolors37.default.isColorSupported)
       return art;
     const { fg, fallback } = LOGO_TONES[tone];
     return hasTruecolor() ? `${fg}${art}\x1B[39m` : fallback(art);
@@ -64635,14 +64838,14 @@ function paintLogoRow(row) {
 }
 function checklistRows(ctx) {
   const on = brand(CHECK2);
-  const off = import_picocolors36.default.dim(CIRCLE);
+  const off = import_picocolors37.default.dim(CIRCLE);
   const rows = [["workspace", ctx.directory]];
   rows.push([
     "account",
-    ctx.sessionExpired ? `${off} ${import_picocolors36.default.yellow("session expired")} ${import_picocolors36.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors36.default.dim(`not signed in ${DOT3} run Setup`)}`
+    ctx.sessionExpired ? `${off} ${import_picocolors37.default.yellow("session expired")} ${import_picocolors37.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors37.default.dim(`not signed in ${DOT3} run Setup`)}`
   ]);
   const missing = new Set(ctx.setupMissing ?? []);
-  const warnRow = `${off} ${import_picocolors36.default.yellow("not configured")} ${import_picocolors36.default.dim(`${DOT3} run Setup`)}`;
+  const warnRow = `${off} ${import_picocolors37.default.yellow("not configured")} ${import_picocolors37.default.dim(`${DOT3} run Setup`)}`;
   if (missing.has("MCP"))
     rows.push(["mcp", warnRow]);
   else if (ctx.deploymentName)
@@ -64654,7 +64857,7 @@ function checklistRows(ctx) {
   if (ctx.repoAgentsMd) {
     rows.push([
       "repo",
-      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors36.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors36.default.dim(`${DOT3} run Setup`)}`
+      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors37.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors37.default.dim(`${DOT3} run Setup`)}`
     ]);
   }
   if (missing.has("agents"))
@@ -64666,24 +64869,24 @@ function checklistRows(ctx) {
   if (ctx.studying) {
     rows.push([
       "sync",
-      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors36.default.dim(`${DOT3} see activity`)}`
+      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors37.default.dim(`${DOT3} see activity`)}`
     ]);
   }
   if (ctx.update) {
     rows.push([
       "update",
-      `${import_picocolors36.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors36.default.dim(`${DOT3} ${ctx.update.hint}`)}`
+      `${import_picocolors37.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors37.default.dim(`${DOT3} ${ctx.update.hint}`)}`
     ]);
   }
   const labelWidth = Math.max(...rows.map(([label]) => label.length));
-  return rows.map(([label, value]) => `${import_picocolors36.default.dim(label.padEnd(labelWidth))}  ${value}`);
+  return rows.map(([label, value]) => `${import_picocolors37.default.dim(label.padEnd(labelWidth))}  ${value}`);
 }
 function renderBanner(ctx) {
   const logo = LOGO_ROWS.map(paintLogoRow);
   const text = [
     ...checklistRows(ctx),
     "",
-    `${brandBadge("dosu-cli")} ${import_picocolors36.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
+    `${brandBadge("dosu-cli")} ${import_picocolors37.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
   ];
   const height = Math.max(logo.length, text.length);
   const combined = [];
@@ -64696,10 +64899,10 @@ function renderBanner(ctx) {
   return ["", ...combined, ""].join(`
 `);
 }
-var import_picocolors36, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ";
+var import_picocolors37, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ";
 var init_banner = __esm(() => {
   init_styles();
-  import_picocolors36 = __toESM(require_picocolors(), 1);
+  import_picocolors37 = __toESM(require_picocolors(), 1);
   LOGO_ROWS = [
     [["sage", "▄▄▄▄▄▄"]],
     [["sage", "██    ▀▄"]],
@@ -64710,8 +64913,8 @@ var init_banner = __esm(() => {
   LOGO_MARK = LOGO_ROWS.map((row) => row.map(([, art]) => art).join(""));
   LOGO_WIDTH = Math.max(...LOGO_MARK.map((row) => row.length));
   LOGO_TONES = {
-    sage: { fg: "\x1B[38;2;180;187;145m", fallback: import_picocolors36.default.green },
-    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors36.default.dim(import_picocolors36.default.green(art)) }
+    sage: { fg: "\x1B[38;2;180;187;145m", fallback: import_picocolors37.default.green },
+    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors37.default.dim(import_picocolors37.default.green(art)) }
   };
 });
 
@@ -64823,16 +65026,16 @@ function renderPagesFrame(model, width, selected) {
   const body = [];
   let scrollHint = "";
   if (model.phase === "loading") {
-    body.push(import_picocolors37.default.dim("Loading pages…"));
+    body.push(import_picocolors38.default.dim("Loading pages…"));
   } else if (model.phase === "error") {
-    body.push(import_picocolors37.default.yellow(clip3(model.message, width)));
+    body.push(import_picocolors38.default.yellow(clip3(model.message, width)));
   } else if (model.pages.length === 0) {
-    body.push(import_picocolors37.default.dim("No pages in this Library yet."));
+    body.push(import_picocolors38.default.dim("No pages in this Library yet."));
   } else {
     const rows = pageRows2(model.pages, width - 2);
     const { start, above } = windowSelection(rows.length, selected);
     const visible = rows.slice(start, start + PAGES_VIEW_LINES);
-    body.push(...visible.map((row, i) => start + i === selected ? `${brand("▸")} ${import_picocolors37.default.bold(row)}` : `  ${import_picocolors37.default.dim(row)}`));
+    body.push(...visible.map((row, i) => start + i === selected ? `${brand("▸")} ${import_picocolors38.default.bold(row)}` : `  ${import_picocolors38.default.dim(row)}`));
     const below = Math.max(0, Math.max(model.total, rows.length) - start - PAGES_VIEW_LINES);
     const parts = [];
     if (above > 0)
@@ -64841,14 +65044,14 @@ function renderPagesFrame(model, width, selected) {
       parts.push(`↓ ${below} more`);
     scrollHint = parts.join(" · ");
   }
-  const count = model.phase === "ready" ? ` ${import_picocolors37.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
+  const count = model.phase === "ready" ? ` ${import_picocolors38.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
   const lines = [
     `${breadcrumb(["home", "pages"], width)}${count}`,
     "",
     ...body,
-    ...scrollHint ? [import_picocolors37.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors38.default.dim(scrollHint)] : [],
     "",
-    import_picocolors37.default.dim("↑↓ move · enter open · esc back")
+    import_picocolors38.default.dim("↑↓ move · enter open · esc back")
   ];
   return lines.join(`
 `);
@@ -64857,9 +65060,9 @@ function renderPageFrame(page, content, width, scroll) {
   const body = [];
   let scrollHint = "";
   if (content.phase === "loading") {
-    body.push(import_picocolors37.default.dim("Loading page…"));
+    body.push(import_picocolors38.default.dim("Loading page…"));
   } else if (content.phase === "error") {
-    body.push(import_picocolors37.default.yellow(clip3(content.message, width)));
+    body.push(import_picocolors38.default.yellow(clip3(content.message, width)));
   } else {
     const rows = wrapBody(content.body, width);
     const { visible, above, below } = windowReport(rows, scroll, PAGE_BODY_LINES);
@@ -64874,12 +65077,12 @@ function renderPageFrame(page, content, width, scroll) {
   const meta = `${page.type} · ${page.published ? "published" : "draft"} · updated ${page.updated_at.slice(0, 10)}`;
   const lines = [
     breadcrumb(["home", "pages", page.title], width),
-    import_picocolors37.default.dim(clip3(meta, width)),
+    import_picocolors38.default.dim(clip3(meta, width)),
     "",
     ...body,
-    ...scrollHint ? [import_picocolors37.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors38.default.dim(scrollHint)] : [],
     "",
-    import_picocolors37.default.dim("↑↓ scroll · esc back to pages")
+    import_picocolors38.default.dim("↑↓ scroll · esc back to pages")
   ];
   return lines.join(`
 `);
@@ -65028,7 +65231,7 @@ ${CLEAR_BELOW3}`);
     input.on("data", onData);
   });
 }
-var import_picocolors37, ESC9, HIDE_CURSOR5, SHOW_CURSOR5, CTRL_C6, KEY_UP6, KEY_DOWN6, CURSOR_HOME3, CLEAR_BELOW3, CLEAR_EOL3, PAGES_VIEW_LINES = 12, PAGE_BODY_LINES = 14, PAGES_FETCH_BATCH = 100;
+var import_picocolors38, ESC9, HIDE_CURSOR5, SHOW_CURSOR5, CTRL_C6, KEY_UP6, KEY_DOWN6, CURSOR_HOME3, CLEAR_BELOW3, CLEAR_EOL3, PAGES_VIEW_LINES = 12, PAGE_BODY_LINES = 14, PAGES_FETCH_BATCH = 100;
 var init_pages_view = __esm(() => {
   init_trpc();
   init_config();
@@ -65038,7 +65241,7 @@ var init_pages_view = __esm(() => {
   init_analytics_view();
   init_layout();
   init_menu();
-  import_picocolors37 = __toESM(require_picocolors(), 1);
+  import_picocolors38 = __toESM(require_picocolors(), 1);
   ESC9 = String.fromCharCode(27);
   HIDE_CURSOR5 = `${ESC9}[?25l`;
   SHOW_CURSOR5 = `${ESC9}[?25h`;
@@ -65152,7 +65355,7 @@ function isSetUp(cfg) {
 }
 function setupHint(cfg) {
   const started = Boolean(cfg.active_account?.target);
-  return import_picocolors38.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
+  return import_picocolors39.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
 }
 function isStudying() {
   try {
@@ -65398,7 +65601,7 @@ function handleLogout(cfg) {
   saveConfig(cfg);
   log2.success("Credentials cleared.");
 }
-var import_picocolors38, ESC10, CLEAR_SCREEN;
+var import_picocolors39, ESC10, CLEAR_SCREEN;
 var init_tui = __esm(() => {
   init_client();
   init_config();
@@ -65421,7 +65624,7 @@ var init_tui = __esm(() => {
   init_menu();
   init_pages_view();
   init_prompts();
-  import_picocolors38 = __toESM(require_picocolors(), 1);
+  import_picocolors39 = __toESM(require_picocolors(), 1);
   ESC10 = String.fromCharCode(27);
   CLEAR_SCREEN = `${ESC10}[2J${ESC10}[H`;
 });
@@ -66025,18 +66228,15 @@ var init_flow3 = __esm(() => {
 });
 
 // src/cli/cli.ts
-import {
-  closeSync as closeSync6,
-  constants as constants3,
-  fstatSync as fstatSync2,
-  openSync as openSync6,
-  readFileSync as readFileSync27,
-  readSync as readSync5,
-  unlinkSync as unlinkSync6
-} from "node:fs";
+import { readFileSync as readFileSync28, unlinkSync as unlinkSync6 } from "node:fs";
 function shouldRunBackgroundChecks(actionName) {
   return actionName !== "upgrade";
 }
+function shouldRunMcpRefreshCheck(actionCommand) {
+  if (actionCommand.name() === "setup")
+    return false;
+  return !(actionCommand.name() === "refresh" && actionCommand.parent?.name() === "mcp");
+}
 function commandTelemetryName(actionCommand) {
   const segments = [];
   let current = actionCommand;
@@ -66053,7 +66253,7 @@ function shouldTrackCommand(command) {
 }
 function commandTelemetryContext() {
   try {
-    const cfg = loadConfigForTelemetry();
+    const cfg = loadConfigNonBlocking();
     if (!cfg)
       return { mode: "cloud", isAuthenticated: false };
     const authenticated = isAuthenticated(cfg);
@@ -66073,29 +66273,6 @@ function commandTelemetryContext() {
     return { mode: "cloud", isAuthenticated: false };
   }
 }
-function loadConfigForTelemetry() {
-  let fd;
-  try {
-    const nonblocking = typeof constants3.O_NONBLOCK === "number" ? constants3.O_NONBLOCK : 0;
-    fd = openSync6(getConfigPath(), constants3.O_RDONLY | nonblocking);
-    const file = fstatSync2(fd);
-    if (!file.isFile() || file.size > MAX_TELEMETRY_CONFIG_BYTES)
-      return;
-    const content = Buffer.alloc(MAX_TELEMETRY_CONFIG_BYTES + 1);
-    const bytesRead = readSync5(fd, content, 0, content.byteLength, 0);
-    if (bytesRead > MAX_TELEMETRY_CONFIG_BYTES)
-      return;
-    return parseConfig(JSON.parse(content.subarray(0, bytesRead).toString("utf8")));
-  } catch {
-    return;
-  } finally {
-    if (fd !== undefined) {
-      try {
-        closeSync6(fd);
-      } catch {}
-    }
-  }
-}
 function startTelemetry(telemetry, command, context) {
   if (!telemetry)
     return false;
@@ -66154,12 +66331,15 @@ function createProgram(options = {}) {
     const opts = thisCommand.optsWithGlobals();
     logger.init({ debug: opts.debug });
     if (shouldRunBackgroundChecks(actionCommand.name())) {
+      const launchesTUI = actionCommand.parent === null;
       if (!process.env.CI) {
-        const launchesTUI = actionCommand.parent === null;
         await checkForUpdates({ notify: !launchesTUI });
       }
       checkForSkillUpdates();
       checkForReadyTasks();
+      if (shouldRunMcpRefreshCheck(actionCommand)) {
+        checkForMcpRefresh({ notify: !launchesTUI });
+      }
     }
     const command = commandTelemetryName(actionCommand);
     if (options.telemetry && shouldTrackCommand(command)) {
@@ -66386,6 +66566,31 @@ Start ${provider.name()} in any project to use the Dosu MCP.`);
 Start ${provider.name()} in this project directory to use the Dosu MCP.`);
     }
   });
+  mcp.command("refresh").description("Rewrite the Dosu MCP entry in every configured AI tool from the current setup").action(() => {
+    const cfg = loadConfig();
+    if (!canRefreshMcp(cfg)) {
+      throw new CliUsageError("Dosu is not set up yet. Run 'dosu setup' first");
+    }
+    const configured = configuredProviders();
+    if (configured.length === 0) {
+      console.log("No AI tools with Dosu configured. Run 'dosu setup' to add Dosu to a tool.");
+      return;
+    }
+    console.log(`Refreshing Dosu MCP config for configured AI tools...
+`);
+    const result = refreshConfiguredProviders(cfg);
+    writeMcpRefreshCache({ version: VERSION });
+    for (const provider of result.updated) {
+      console.log(`  ✓ ${provider.name()}`);
+    }
+    for (const { provider, error } of result.failed) {
+      console.log(`  ✗ ${provider.name()}: ${error.message}`);
+    }
+    console.log(`
+Restart your AI agents so they pick up the change.`);
+    if (result.failed.length > 0)
+      process.exitCode = 1;
+  });
   mcp.command("list").description("List available AI tools").action(() => {
     console.log(`Available AI tools:
 `);
@@ -66466,7 +66671,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     }
     if (opts.follow) {
       try {
-        const lines = readFileSync27(logPath, "utf-8").split(`
+        const lines = readFileSync28(logPath, "utf-8").split(`
 `);
         if (lines.at(-1) === "")
           lines.pop();
@@ -66482,7 +66687,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync27(logPath, "utf-8");
+        const content = readFileSync28(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n).join(`
@@ -66534,7 +66739,7 @@ function processCommandTelemetry() {
     return;
   }
 }
-var TELEMETRY_FLUSH_TIMEOUT_MS = 750, MAX_TELEMETRY_CONFIG_BYTES, CliUsageError, FOLLOW_POLL_MS = 500, DEFAULT_TAIL_LINES = 50;
+var TELEMETRY_FLUSH_TIMEOUT_MS = 750, CliUsageError, FOLLOW_POLL_MS = 500, DEFAULT_TAIL_LINES = 50;
 var init_cli = __esm(() => {
   init_commander();
   init_client();
@@ -66560,13 +66765,14 @@ var init_cli = __esm(() => {
   init_follow();
   init_logger();
   init_providers();
+  init_refresh();
   init_styles();
   init_settings();
   init_telemetry();
+  init_mcp_refresh_check();
   init_pending_tasks_check();
   init_skill_update_check();
   init_update_check();
-  MAX_TELEMETRY_CONFIG_BYTES = 64 * 1024;
   CliUsageError = class CliUsageError extends Error {
     exitCode = 1;
     constructor(message) {
@@ -66607,4 +66813,4 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=93db7db7-907f-4d14-6475-6e2164756e21
+//# debugId=ca9e58ba-ed30-6875-6475-6e2164756e21