@dosu/cli 0.67.0 → 0.67.2

package/bin/dosu.js

@@ -47,6 +47,111 @@ var __esm = (fn, res, err) => () => {
 };
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// node_modules/picocolors/picocolors.js
+var require_picocolors = __commonJS(function(exports, module) {
+  var p = process || {};
+  var argv = p.argv || [];
+  var env = p.env || {};
+  var isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
+  var formatter = (open, close, replace = open) => (input) => {
+    let string = "" + input, index = string.indexOf(close, open.length);
+    return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
+  };
+  var replaceClose = (string, close, replace, index) => {
+    let result = "", cursor = 0;
+    do {
+      result += string.substring(cursor, index) + replace;
+      cursor = index + close.length;
+      index = string.indexOf(close, cursor);
+    } while (~index);
+    return result + string.substring(cursor);
+  };
+  var createColors = (enabled = isColorSupported) => {
+    let f = enabled ? formatter : () => String;
+    return {
+      isColorSupported: enabled,
+      reset: f("\x1B[0m", "\x1B[0m"),
+      bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
+      dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
+      italic: f("\x1B[3m", "\x1B[23m"),
+      underline: f("\x1B[4m", "\x1B[24m"),
+      inverse: f("\x1B[7m", "\x1B[27m"),
+      hidden: f("\x1B[8m", "\x1B[28m"),
+      strikethrough: f("\x1B[9m", "\x1B[29m"),
+      black: f("\x1B[30m", "\x1B[39m"),
+      red: f("\x1B[31m", "\x1B[39m"),
+      green: f("\x1B[32m", "\x1B[39m"),
+      yellow: f("\x1B[33m", "\x1B[39m"),
+      blue: f("\x1B[34m", "\x1B[39m"),
+      magenta: f("\x1B[35m", "\x1B[39m"),
+      cyan: f("\x1B[36m", "\x1B[39m"),
+      white: f("\x1B[37m", "\x1B[39m"),
+      gray: f("\x1B[90m", "\x1B[39m"),
+      bgBlack: f("\x1B[40m", "\x1B[49m"),
+      bgRed: f("\x1B[41m", "\x1B[49m"),
+      bgGreen: f("\x1B[42m", "\x1B[49m"),
+      bgYellow: f("\x1B[43m", "\x1B[49m"),
+      bgBlue: f("\x1B[44m", "\x1B[49m"),
+      bgMagenta: f("\x1B[45m", "\x1B[49m"),
+      bgCyan: f("\x1B[46m", "\x1B[49m"),
+      bgWhite: f("\x1B[47m", "\x1B[49m"),
+      blackBright: f("\x1B[90m", "\x1B[39m"),
+      redBright: f("\x1B[91m", "\x1B[39m"),
+      greenBright: f("\x1B[92m", "\x1B[39m"),
+      yellowBright: f("\x1B[93m", "\x1B[39m"),
+      blueBright: f("\x1B[94m", "\x1B[39m"),
+      magentaBright: f("\x1B[95m", "\x1B[39m"),
+      cyanBright: f("\x1B[96m", "\x1B[39m"),
+      whiteBright: f("\x1B[97m", "\x1B[39m"),
+      bgBlackBright: f("\x1B[100m", "\x1B[49m"),
+      bgRedBright: f("\x1B[101m", "\x1B[49m"),
+      bgGreenBright: f("\x1B[102m", "\x1B[49m"),
+      bgYellowBright: f("\x1B[103m", "\x1B[49m"),
+      bgBlueBright: f("\x1B[104m", "\x1B[49m"),
+      bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
+      bgCyanBright: f("\x1B[106m", "\x1B[49m"),
+      bgWhiteBright: f("\x1B[107m", "\x1B[49m")
+    };
+  };
+  module.exports = createColors();
+  module.exports.createColors = createColors;
+});
+
+// src/cli/command-error.ts
+function isCommandError(error) {
+  return error instanceof CommandError;
+}
+var COMMAND_ERROR_CODES, CommandError;
+var init_command_error = __esm(() => {
+  COMMAND_ERROR_CODES = [
+    "NOT_LOGGED_IN",
+    "NO_ORG_SELECTED",
+    "NO_API_KEY",
+    "NO_LIBRARY_SELECTED",
+    "NO_DEPLOYMENT_SELECTED",
+    "ORG_UNAVAILABLE",
+    "LIBRARY_UNAVAILABLE",
+    "DEPLOYMENT_UNAVAILABLE",
+    "SCOPE_MISMATCH",
+    "DEPLOYMENT_NOT_FOUND",
+    "DEPLOYMENT_AMBIGUOUS",
+    "NOT_MCP_DEPLOYMENT",
+    "REVIEW_ITEM_NOT_FOUND",
+    "INVALID_ARGUMENT"
+  ];
+  CommandError = class CommandError extends Error {
+    code;
+    details;
+    exitCode = 1;
+    constructor(code, message, details = []) {
+      super(message);
+      this.code = code;
+      this.details = details;
+      this.name = "CommandError";
+    }
+  };
+});
+
 // src/statusline/argv.ts
 function agentFromArgv(argv) {
   for (let i = 0;i < argv.length; i++) {
@@ -856,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]) => {
@@ -976,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];
@@ -1006,76 +1121,6 @@ var init_config_helpers = __esm(() => {
   writeFileAtomic = import_write_file_atomic.default;
 });
 
-// node_modules/picocolors/picocolors.js
-var require_picocolors = __commonJS(function(exports, module) {
-  var p = process || {};
-  var argv = p.argv || [];
-  var env = p.env || {};
-  var isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
-  var formatter = (open, close, replace = open) => (input) => {
-    let string = "" + input, index = string.indexOf(close, open.length);
-    return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
-  };
-  var replaceClose = (string, close, replace, index) => {
-    let result = "", cursor = 0;
-    do {
-      result += string.substring(cursor, index) + replace;
-      cursor = index + close.length;
-      index = string.indexOf(close, cursor);
-    } while (~index);
-    return result + string.substring(cursor);
-  };
-  var createColors = (enabled = isColorSupported) => {
-    let f = enabled ? formatter : () => String;
-    return {
-      isColorSupported: enabled,
-      reset: f("\x1B[0m", "\x1B[0m"),
-      bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
-      dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
-      italic: f("\x1B[3m", "\x1B[23m"),
-      underline: f("\x1B[4m", "\x1B[24m"),
-      inverse: f("\x1B[7m", "\x1B[27m"),
-      hidden: f("\x1B[8m", "\x1B[28m"),
-      strikethrough: f("\x1B[9m", "\x1B[29m"),
-      black: f("\x1B[30m", "\x1B[39m"),
-      red: f("\x1B[31m", "\x1B[39m"),
-      green: f("\x1B[32m", "\x1B[39m"),
-      yellow: f("\x1B[33m", "\x1B[39m"),
-      blue: f("\x1B[34m", "\x1B[39m"),
-      magenta: f("\x1B[35m", "\x1B[39m"),
-      cyan: f("\x1B[36m", "\x1B[39m"),
-      white: f("\x1B[37m", "\x1B[39m"),
-      gray: f("\x1B[90m", "\x1B[39m"),
-      bgBlack: f("\x1B[40m", "\x1B[49m"),
-      bgRed: f("\x1B[41m", "\x1B[49m"),
-      bgGreen: f("\x1B[42m", "\x1B[49m"),
-      bgYellow: f("\x1B[43m", "\x1B[49m"),
-      bgBlue: f("\x1B[44m", "\x1B[49m"),
-      bgMagenta: f("\x1B[45m", "\x1B[49m"),
-      bgCyan: f("\x1B[46m", "\x1B[49m"),
-      bgWhite: f("\x1B[47m", "\x1B[49m"),
-      blackBright: f("\x1B[90m", "\x1B[39m"),
-      redBright: f("\x1B[91m", "\x1B[39m"),
-      greenBright: f("\x1B[92m", "\x1B[39m"),
-      yellowBright: f("\x1B[93m", "\x1B[39m"),
-      blueBright: f("\x1B[94m", "\x1B[39m"),
-      magentaBright: f("\x1B[95m", "\x1B[39m"),
-      cyanBright: f("\x1B[96m", "\x1B[39m"),
-      whiteBright: f("\x1B[97m", "\x1B[39m"),
-      bgBlackBright: f("\x1B[100m", "\x1B[49m"),
-      bgRedBright: f("\x1B[101m", "\x1B[49m"),
-      bgGreenBright: f("\x1B[102m", "\x1B[49m"),
-      bgYellowBright: f("\x1B[103m", "\x1B[49m"),
-      bgBlueBright: f("\x1B[104m", "\x1B[49m"),
-      bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
-      bgCyanBright: f("\x1B[106m", "\x1B[49m"),
-      bgWhiteBright: f("\x1B[107m", "\x1B[49m")
-    };
-  };
-  module.exports = createColors();
-  module.exports.createColors = createColors;
-});
-
 // src/version/version.ts
 function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
   return channel === "npm" && (env.npm_lifecycle_event === "npx" || env.npm_command === "exec");
@@ -1083,7 +1128,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.67.0", INSTALL_CHANNEL = "npm";
+var VERSION = "0.67.2", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -1173,18 +1218,18 @@ function writeEntry(level, mod, message) {
   } catch {}
   if (debugToConsole) {
     const colorize = {
-      DEBUG: import_picocolors.default.dim,
-      INFO: import_picocolors.default.cyan,
-      WARN: import_picocolors.default.yellow,
-      ERROR: import_picocolors.default.red
+      DEBUG: import_picocolors2.default.dim,
+      INFO: import_picocolors2.default.cyan,
+      WARN: import_picocolors2.default.yellow,
+      ERROR: import_picocolors2.default.red
     }[level];
     console.error(colorize(line.trimEnd()));
   }
 }
-var import_picocolors, MAX_LOG_SIZE = 1048576, TRUNCATE_KEEP = 524288, LOG_FILENAME = "debug.log", REDACTED = "[REDACTED]", SECRET_QUERY_KEYS, initialized = false, debugToConsole = false, logFilePath = null, ANSI_PATTERN, logger;
+var import_picocolors2, MAX_LOG_SIZE = 1048576, TRUNCATE_KEEP = 524288, LOG_FILENAME = "debug.log", REDACTED = "[REDACTED]", SECRET_QUERY_KEYS, initialized = false, debugToConsole = false, logFilePath = null, ANSI_PATTERN, logger;
 var init_logger = __esm(() => {
   init_config();
-  import_picocolors = __toESM(require_picocolors(), 1);
+  import_picocolors2 = __toESM(require_picocolors(), 1);
   SECRET_QUERY_KEYS = [
     "access_token",
     "refresh_token",
@@ -7187,8 +7232,7 @@ var init_arguments = __esm(() => {
 function requireLoginConfig() {
   const cfg = loadConfig();
   if (!cfg.active_account?.session.access_token) {
-    console.error(import_picocolors2.default.red("Not logged in. Run 'dosu login' first."));
-    process.exit(1);
+    throw new CommandError("NOT_LOGGED_IN", "Not logged in. Run 'dosu login' first.");
   }
   return cfg;
 }
@@ -7196,22 +7240,20 @@ function requireOrgConfig() {
   const cfg = requireLoginConfig();
   const orgId = cfg.active_account?.target?.org_id;
   if (!orgId) {
-    console.error(import_picocolors2.default.red("Missing org config. Run 'dosu setup' to reconfigure."));
-    process.exit(1);
+    throw new CommandError("NO_ORG_SELECTED", "Missing org config. Run 'dosu setup' to reconfigure.");
   }
   return { cfg, orgId };
 }
 function requireAPIKey(cfg) {
-  if (!cfg.active_account?.target?.api_key) {
-    console.error(import_picocolors2.default.red("API key not configured. Run 'dosu setup' first."));
-    process.exit(1);
+  const apiKey = cfg.active_account?.target?.api_key;
+  if (!apiKey) {
+    throw new CommandError("NO_API_KEY", "API key not configured. Run 'dosu setup' first.");
   }
-  return cfg.active_account?.target?.api_key;
+  return apiKey;
 }
-var import_picocolors2;
 var init_auth = __esm(() => {
+  init_command_error();
   init_config();
-  import_picocolors2 = __toESM(require_picocolors(), 1);
 });
 
 // node_modules/fast-string-truncated-width/dist/utils.js
@@ -11430,8 +11472,16 @@ function requireConfig4() {
   return requireLoginConfig();
 }
 async function listAccessibleDeployments(client, activeOrgId) {
-  if (activeOrgId)
-    return client.workspaces.listForOrg.query(activeOrgId);
+  if (activeOrgId) {
+    const deployments = await client.workspaces.listForOrg.query(activeOrgId);
+    if (deployments.length > 0)
+      return deployments;
+    const orgs = await client.organization.getOrganizations.query({});
+    if (!orgs.some((org) => org.org_id === activeOrgId)) {
+      throw new CommandError("ORG_UNAVAILABLE", "The saved organization is not available to this account.", ["Run 'dosu setup' to choose an organization and MCP deployment."]);
+    }
+    return deployments;
+  }
   const orgs = await client.organization.getOrganizations.query({});
   const deployments = await Promise.all(orgs.map((org) => client.workspaces.listForOrg.query(org.org_id)));
   return deployments.flat();
@@ -11445,15 +11495,11 @@ async function resolveDeploymentId(client, activeOrgId, id) {
   if (matches.length === 1)
     return matches[0].deployment_id;
   if (matches.length === 0) {
-    console.error(import_picocolors15.default.red(`Deployment not found: ${id}`));
-    console.error(import_picocolors15.default.dim("Expected a full deployment ID (UUID). Run 'dosu deployments list --json' to see full IDs."));
-    process.exit(1);
-  }
-  console.error(import_picocolors15.default.red(`Ambiguous deployment ID prefix: ${id} matches ${matches.length}:`));
-  for (const d of matches) {
-    console.error(import_picocolors15.default.dim(`  ${d.deployment_id}  ${d.name}`));
+    throw new CommandError("DEPLOYMENT_NOT_FOUND", `Deployment not found: ${id}`, [
+      "Expected a full deployment ID (UUID). Run 'dosu deployments list --json' to see full IDs."
+    ]);
   }
-  process.exit(1);
+  throw new CommandError("DEPLOYMENT_AMBIGUOUS", `Ambiguous deployment ID prefix: ${id} matches ${matches.length}:`, matches.map((d) => `  ${d.deployment_id}  ${d.name}`));
 }
 function deploymentsCommand() {
   const cmd = new Command("deployments").description("Select the MCP deployment (and its Library) this CLI uses; not for Agents");
@@ -11484,14 +11530,12 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
   cmd.command("info").description("Show the selected MCP deployment").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = requireConfig4();
     if (!cfg.active_account?.target?.deployment_id) {
-      console.error(import_picocolors15.default.red("No deployment selected. Run 'dosu setup' or 'dosu deployments switch'."));
-      process.exit(1);
+      throw new CommandError("NO_DEPLOYMENT_SELECTED", "No deployment selected. Run 'dosu setup' or 'dosu deployments switch'.");
     }
     const client = createTypedClient(cfg);
     const deployment = await client.workspaces.get.query(cfg.active_account?.target?.deployment_id);
     if (!deployment) {
-      console.error(import_picocolors15.default.red(`Deployment not found: ${cfg.active_account?.target?.deployment_id}`));
-      process.exit(1);
+      throw new CommandError("DEPLOYMENT_UNAVAILABLE", `Deployment not found: ${cfg.active_account?.target?.deployment_id}`);
     }
     if (opts.json) {
       printResult(deployment, opts);
@@ -11514,12 +11558,10 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
     const id = await resolveDeploymentId(client, cfg.active_account?.target?.org_id, rawId);
     const deployment = await client.workspaces.get.query(id);
     if (!deployment) {
-      console.error(import_picocolors15.default.red(`Deployment not found: ${id}`));
-      process.exit(1);
+      throw new CommandError("DEPLOYMENT_NOT_FOUND", `Deployment not found: ${id}`);
     }
     if (deployment.provider_slug !== MCP_PROVIDER_SLUG) {
-      console.error(import_picocolors15.default.red(`Not a Dosu MCP deployment: ${id}`));
-      process.exit(1);
+      throw new CommandError("NOT_MCP_DEPLOYMENT", `Not a Dosu MCP deployment: ${id}`);
     }
     const apiKey = await new Client(cfg).createAPIKey(deployment.deployment_id, "dosu-cli");
     updateTarget(cfg, {
@@ -11542,6 +11584,7 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
 var import_picocolors15, MCP_PROVIDER_SLUG = "dosu_mcp";
 var init_deployments = __esm(() => {
   init_commander();
+  init_command_error();
   init_client();
   init_trpc();
   init_config();
@@ -14290,7 +14333,7 @@ var init_conflicts = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "5d3e9365-4283-2b42-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "fa693edb-14f4-abcb-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -15089,10 +15132,11 @@ function createCommandTelemetry(settings, dependencies = {}) {
   };
 }
 function shouldSendToSentry(error) {
-  return !["SESSION_EXPIRED", "SESSION_PERSISTENCE_ERROR"].includes(error.code ?? "");
+  return !EXPECTED_STATE_ERROR_CODES.has(error.code ?? "");
 }
-var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES, SYNC_TRIGGERS, SYNC_STATUSES, LEARNER_OUTCOMES, GATEWAY_REASONS, CLAUDE_CODE_SOURCES, SETTINGS_CONFLICT_KEYS, SETTINGS_CONFLICT_FAMILIES, MAX_CONFLICT_KEYS_LENGTH = 200, CLAUDE_CODE_VERSION_PATTERN, LEARNER_MODEL_PATTERN, BACKFILL_OFFERS, SENTRY_FACET_TAGS, pendingFacets;
+var REQUEST_TIMEOUT_MS = 500, MAX_RESPONSE_BYTES, MAX_STACK_FRAMES = 20, UNKNOWN_COMMAND = "unknown", FALLBACK_INSTALL_ID = "00000000-0000-4000-8000-000000000000", BUNDLE_CODE_FILE = "app:///bin/dosu.js", CLI_PACKAGE_ROOT, SAFE_ERROR_TYPES, SAFE_ERROR_CODES, EXPECTED_STATE_ERROR_CODES, SYNC_TRIGGERS, SYNC_STATUSES, LEARNER_OUTCOMES, GATEWAY_REASONS, CLAUDE_CODE_SOURCES, SETTINGS_CONFLICT_KEYS, SETTINGS_CONFLICT_FAMILIES, MAX_CONFLICT_KEYS_LENGTH = 200, CLAUDE_CODE_VERSION_PATTERN, LEARNER_MODEL_PATTERN, BACKFILL_OFFERS, SENTRY_FACET_TAGS, pendingFacets;
 var init_telemetry = __esm(() => {
+  init_command_error();
   init_conflicts();
   MAX_RESPONSE_BYTES = 1024 * 1024;
   CLI_PACKAGE_ROOT = detectCliPackageRoot();
@@ -15173,7 +15217,13 @@ var init_telemetry = __esm(() => {
     "commander.missingMandatoryOptionValue",
     "commander.optionMissingArgument",
     "commander.unknownCommand",
-    "commander.unknownOption"
+    "commander.unknownOption",
+    ...COMMAND_ERROR_CODES
+  ]);
+  EXPECTED_STATE_ERROR_CODES = new Set([
+    "SESSION_EXPIRED",
+    "SESSION_PERSISTENCE_ERROR",
+    ...COMMAND_ERROR_CODES
   ]);
   SYNC_TRIGGERS = new Set(["hook", "manual", "bootstrap"]);
   SYNC_STATUSES = new Set([
@@ -60317,25 +60367,27 @@ function bareMessageId(id) {
 function truncateId(id) {
   return (isDraftId(id) ? bareMessageId(id) : id).slice(0, 8);
 }
+function reviewItemNotFound(id) {
+  return new CommandError("REVIEW_ITEM_NOT_FOUND", `No review item found for '${id}'. Run 'dosu review list' to see pending items.`);
+}
 async function requireChange(client, id) {
   try {
     return await client.review.getChange.query({ id });
   } catch (err) {
-    if (isNotFound(err) || isInvalidId(err)) {
-      console.error(import_picocolors27.default.red(`No review item found for '${id}'. Run 'dosu review list' to see pending items.`));
-      process.exit(1);
-    }
+    if (isNotFound(err) || isInvalidId(err))
+      throw reviewItemNotFound(id);
     throw err;
   }
 }
 async function requireDraft(client, id) {
   const draft = await client.messages.getMessage.query(bareMessageId(id));
-  if (!draft) {
-    console.error(import_picocolors27.default.red(`No review item found for '${id}'. Run 'dosu review list' to see pending items.`));
-    process.exit(1);
-  }
+  if (!draft)
+    throw reviewItemNotFound(id);
   return draft;
 }
+function invalidArgument(message) {
+  return new CommandError("INVALID_ARGUMENT", message);
+}
 function humanizeSource(origin, version) {
   switch (origin) {
     case "manual_update":
@@ -60387,10 +60439,8 @@ function printDraftPreview(draft) {
   console.log();
   console.log(draft.body ?? "");
 }
-function failScope(message, hint = SELECT_LIBRARY_HINT) {
-  console.error(import_picocolors27.default.red(message));
-  console.error(import_picocolors27.default.dim(hint));
-  process.exit(1);
+function failScope(code, message, hint = SELECT_LIBRARY_HINT) {
+  throw new CommandError(code, message, [hint]);
 }
 async function lookupLibrary(client, spaceId) {
   try {
@@ -60409,13 +60459,13 @@ async function resolveReviewScope(client, spaceId, deploymentId) {
     deploymentId ? client.workspaces.get.query(deploymentId) : Promise.resolve(undefined)
   ]);
   if (deploymentId && !deployment) {
-    failScope(`The selected MCP deployment (${deploymentId}) is unavailable: it was deleted, or the ` + "signed-in account cannot access it.");
+    failScope("DEPLOYMENT_UNAVAILABLE", `The selected MCP deployment (${deploymentId}) is unavailable: it was deleted, or the ` + "signed-in account cannot access it.");
   }
   if (deployment && deployment.space_id !== spaceId) {
-    failScope(`The saved Library (${spaceId}) does not match the Library of the selected MCP ` + `deployment (${deployment.space_id}).`, `Run 'dosu deployments switch ${deployment.deployment_id}' to save that deployment's ` + "Library again, or choose another MCP deployment with 'dosu deployments list'.");
+    failScope("SCOPE_MISMATCH", `The saved Library (${spaceId}) does not match the Library of the selected MCP ` + `deployment (${deployment.space_id}).`, `Run 'dosu deployments switch ${deployment.deployment_id}' to save that deployment's ` + "Library again, or choose another MCP deployment with 'dosu deployments list'.");
   }
   if (!library.found || !store) {
-    failScope(`The selected Library (${spaceId}) is unavailable: it was deleted, or the signed-in ` + "account cannot access it.");
+    failScope("LIBRARY_UNAVAILABLE", `The selected Library (${spaceId}) is unavailable: it was deleted, or the signed-in ` + "account cannot access it.");
   }
   return {
     knowledgeStoreId: store.id,
@@ -60443,15 +60493,14 @@ function reviewCommand() {
     try {
       range = resolveTimeRange(opts.since, opts.until);
     } catch (err) {
-      console.error(import_picocolors27.default.red(`${err.message}.`));
-      process.exit(1);
+      throw invalidArgument(`${err.message}.`);
     }
     const rangeLabel = describeTimeRange(range);
     const inRange = rangeLabel ? ` ${rangeLabel}` : "";
     const cfg = requireConfig10();
     const target = cfg.active_account?.target;
     if (!target?.space_id) {
-      failScope("No Library selected. The review list reads the Library of the selected MCP deployment.");
+      failScope("NO_LIBRARY_SELECTED", "No Library selected. The review list reads the Library of the selected MCP deployment.");
     }
     const client = createTypedClient(cfg);
     const scope = await resolveReviewScope(client, target.space_id, target.deployment_id);
@@ -60532,30 +60581,22 @@ function reviewCommand() {
     const cfg = requireConfig10();
     const client = createTypedClient(cfg);
     if (opts.body !== undefined && opts.bodyFile !== undefined) {
-      console.error(import_picocolors27.default.red("Pass only one of --body or --body-file."));
-      process.exit(1);
+      throw invalidArgument("Pass only one of --body or --body-file.");
     }
     let body = opts.body;
     if (opts.bodyFile) {
       try {
         body = readFileSync19(opts.bodyFile, "utf-8");
       } catch (err) {
-        console.error(import_picocolors27.default.red(`Failed to read --body-file: ${err.message}`));
-        process.exit(1);
+        throw invalidArgument(`Failed to read --body-file: ${err.message}`);
       }
     }
     if (body === undefined && opts.title === undefined) {
-      console.error(import_picocolors27.default.red("Nothing to edit. Pass --title and/or --body/--body-file."));
-      process.exit(1);
+      throw invalidArgument("Nothing to edit. Pass --title and/or --body/--body-file.");
     }
     if (isDraftId(id)) {
-      if (opts.title !== undefined) {
-        console.error(import_picocolors27.default.red("Draft replies support --body only (no --title)."));
-        process.exit(1);
-      }
-      if (body === undefined) {
-        console.error(import_picocolors27.default.red("Draft replies require --body or --body-file."));
-        process.exit(1);
+      if (opts.title !== undefined || body === undefined) {
+        throw invalidArgument("Draft replies support --body only (no --title).");
       }
       await requireDraft(client, id);
       await client.messages.saveDraft.mutate({
@@ -60571,8 +60612,7 @@ function reviewCommand() {
         });
       } catch (err) {
         if (isNotFound(err)) {
-          console.error(import_picocolors27.default.red(`No pending review item found for '${id}'. Run 'dosu review list' to see editable items.`));
-          process.exit(1);
+          throw new CommandError("REVIEW_ITEM_NOT_FOUND", `No pending review item found for '${id}'. Run 'dosu review list' to see editable items.`);
         }
         throw err;
       }
@@ -60653,8 +60693,7 @@ function reviewCommand() {
     const client = createTypedClient(cfg);
     if (isDraftId(id)) {
       await requireDraft(client, id);
-      console.error(import_picocolors27.default.red("Revert is not supported for draft replies. A rejected draft is regenerated on the next agent run."));
-      process.exit(1);
+      throw invalidArgument("Revert is not supported for draft replies. A rejected draft is regenerated on the next agent run.");
     }
     await requireChange(client, id);
     await client.page.updatePublicationStatus.mutate({
@@ -60674,6 +60713,7 @@ var import_picocolors27, DRAFT_MESSAGE_ID_PREFIX = "draft_message:", SELECT_LIBR
 var init_review = __esm(() => {
   init_dist();
   init_commander();
+  init_command_error();
   init_trpc();
   init_auth();
   init_confirmation();
@@ -60767,7 +60807,7 @@ Use [commands.md](references/commands.md) as the sole detailed command and flag
 ## Handle failures literally
 
 - \`Not logged in\` or an unrecoverable expired session: run \`dosu login\` (agent setup may instead return a ticket flow).
-- Missing organization, Library, deployment, or API-key context: run the appropriate \`dosu setup\` flow.
+- Missing or unavailable organization, Library, deployment, or API-key context: tell the user which \`dosu setup\` flow fixes it. Plain \`dosu setup\` is interactive, so don't start it for them unless they ask.
 - Wrong or unexpected Library context: read \`dosu status --json\` and \`dosu deployments info --json\` before changing anything. Switch only to an MCP deployment the user named or confirmed; never pick the first one listed, and never switch just because a list came back empty.
 - Skill guidance out of date: \`dosu skill update\` rewrites the installed skill from the running CLI version. Some agents read skills only when a session starts, so start a new session if the change does not appear. Installed files show the skill is on disk, not that the agent loaded it.
 - \`confirmRequired\`: no write occurred.
@@ -62452,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;
@@ -62464,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),
@@ -62477,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;
@@ -62500,6 +62600,7 @@ var defaultBuildServer = ({ url, headers }) => ({
 var init_base = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/antigravity.ts
@@ -62551,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)
@@ -62572,6 +62669,7 @@ var ClaudeDesktopProvider = () => ({
 var init_claude_desktop = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/cline.ts
@@ -62643,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();
@@ -62739,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");
@@ -62763,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");
@@ -62783,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 = {
@@ -62815,6 +62958,7 @@ var CopilotProvider = () => ({
 var init_copilot = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/cursor.ts
@@ -62907,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))
@@ -62925,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");
@@ -62942,6 +63085,7 @@ var MCPorterProvider = () => ({
 var init_mcporter = __esm(() => {
   init_config_helpers();
   init_detect();
+  init_shape();
 });
 
 // src/mcp/providers/opencode.ts
@@ -63055,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)
@@ -63133,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`);
@@ -63347,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;
@@ -63550,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) {
@@ -63564,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) {
@@ -63593,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 = {}) {
@@ -63631,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
@@ -63701,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;
@@ -63719,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 {}
 }
@@ -63757,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;
   }
@@ -63777,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;
   }
@@ -63828,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();
@@ -63857,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)
@@ -63998,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;
@@ -64015,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}`;
@@ -64054,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) {
@@ -64080,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;
@@ -64106,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,
     "",
@@ -64123,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;
@@ -64136,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`);
@@ -64145,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 };
@@ -64178,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);
@@ -64215,7 +64181,7 @@ function createRowNamer() {
 }
 function defaultReadLog2() {
   try {
-    return readFileSync27(logger.getLogPath(), "utf-8");
+    return readFileSync26(logger.getLogPath(), "utf-8");
   } catch {
     return "";
   }
@@ -64400,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();
@@ -64415,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`;
@@ -64432,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);
@@ -64465,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) {
@@ -64501,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);
@@ -64521,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) {
@@ -64538,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)
@@ -64553,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" };
 }
@@ -64581,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", {
@@ -64624,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";
@@ -64662,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);
@@ -64681,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) {
@@ -66133,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) => {
@@ -66308,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();
@@ -66331,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",
@@ -66495,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;
@@ -66537,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()) {
@@ -66554,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()}`);
@@ -66607,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();
@@ -66615,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: {
@@ -66634,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;
@@ -66685,14 +66650,244 @@ 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
+function read2(value, key) {
+  if (typeof value !== "object" && typeof value !== "function" || value === null) {
+    return;
+  }
+  try {
+    return Reflect.get(value, key);
+  } catch {
+    return;
+  }
+}
+function tokenOf2(data, key) {
+  const value = read2(data, key);
+  if (typeof value !== "string")
+    return;
+  const trimmed = value.trim();
+  return REQUEST_ID_PATTERN2.test(trimmed) ? trimmed : undefined;
+}
+function statusOf2(data) {
+  const value = read2(data, "httpStatus");
+  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : undefined;
+}
+function fatalErrorDiagnostics2(err) {
+  const data = read2(err, "data");
+  if (!data)
+    return;
+  const code = tokenOf2(data, "code");
+  const path = tokenOf2(data, "path");
+  const status = statusOf2(data);
+  const requestId = tokenOf2(data, "requestId");
+  const parts = [
+    code && `code=${code}`,
+    path && `path=${path}`,
+    status && `status=${status}`,
+    requestId && `request_id=${requestId}`
+  ].filter(Boolean);
+  return parts.length > 0 ? parts.join(" ") : undefined;
+}
+function printFatalError2(err) {
+  if (isCommandError(err)) {
+    console.error(import_picocolors39.default.red(err.message));
+    for (const line of err.details)
+      console.error(import_picocolors39.default.dim(line));
+    return;
+  }
+  console.error(read2(err, "message") ?? err);
+  const diagnostics = fatalErrorDiagnostics2(err);
+  if (diagnostics)
+    console.error(diagnostics);
+}
+var import_picocolors39, REQUEST_ID_PATTERN2;
+var init_fatal_error = __esm(() => {
+  init_command_error();
+  import_picocolors39 = __toESM(require_picocolors(), 1);
+  REQUEST_ID_PATTERN2 = /^[A-Za-z0-9][A-Za-z0-9:._-]{0,127}$/;
 });
 
 // src/tui/analytics-view.ts
@@ -66813,7 +67008,7 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
   const rows = analyticsTabRows(tab, state, pageStats);
   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_picocolors39.default.dim(row)) : [import_picocolors39.default.dim(empty)];
+  const listRows = visible.length > 0 ? visible.map((row) => import_picocolors40.default.dim(row)) : [import_picocolors40.default.dim(empty)];
   const scrollParts = [];
   if (above > 0)
     scrollParts.push(`↑ ${above} earlier`);
@@ -66829,9 +67024,9 @@ function renderAnalyticsFrame(state, tab, scroll, pageStats = null, pagesPending
     ], tab, width, { spread: false }),
     "",
     ...listRows,
-    ...scrollParts.length > 0 ? [import_picocolors39.default.dim(scrollParts.join(" · "))] : [],
+    ...scrollParts.length > 0 ? [import_picocolors40.default.dim(scrollParts.join(" · "))] : [],
     "",
-    import_picocolors39.default.dim("tab switch · ↑↓ scroll · esc back")
+    import_picocolors40.default.dim("tab switch · ↑↓ scroll · esc back")
   ];
   return lines.join(`
 `);
@@ -66928,7 +67123,7 @@ ${CLEAR_BELOW2}`);
     input.on("data", onData);
   });
 }
-var import_picocolors39, 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 import_picocolors40, 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();
@@ -66936,7 +67131,7 @@ var init_analytics_view = __esm(() => {
   init_alt_screen();
   init_layout();
   init_menu();
-  import_picocolors39 = __toESM(require_picocolors(), 1);
+  import_picocolors40 = __toESM(require_picocolors(), 1);
   ESC8 = String.fromCharCode(27);
   HIDE_CURSOR4 = `${ESC8}[?25l`;
   SHOW_CURSOR4 = `${ESC8}[?25h`;
@@ -66954,7 +67149,7 @@ var init_analytics_view = __esm(() => {
 // src/tui/banner.ts
 function paintLogoRow(row) {
   return row.map(([tone, art]) => {
-    if (!import_picocolors40.default.isColorSupported)
+    if (!import_picocolors41.default.isColorSupported)
       return art;
     const { fg, fallback } = LOGO_TONES[tone];
     return hasTruecolor() ? `${fg}${art}\x1B[39m` : fallback(art);
@@ -66985,14 +67180,14 @@ function wrapValue(text, room) {
 }
 function checklistRows(ctx, width) {
   const on = brand(CHECK2);
-  const off = import_picocolors40.default.dim(CIRCLE);
+  const off = import_picocolors41.default.dim(CIRCLE);
   const rows = [["workspace", ctx.directory]];
   rows.push([
     "account",
-    ctx.sessionExpired ? `${off} ${import_picocolors40.default.yellow("session expired")} ${import_picocolors40.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors40.default.dim(`not signed in ${DOT3} run Setup`)}`
+    ctx.sessionExpired ? `${off} ${import_picocolors41.default.yellow("session expired")} ${import_picocolors41.default.dim(`${DOT3} run Log in`)}` : ctx.signedIn ? `${on} signed in` : `${off} ${import_picocolors41.default.dim(`not signed in ${DOT3} run Setup`)}`
   ]);
   const missing = new Set(ctx.setupMissing ?? []);
-  const warnRow = `${off} ${import_picocolors40.default.yellow("not configured")} ${import_picocolors40.default.dim(`${DOT3} run Setup`)}`;
+  const warnRow = `${off} ${import_picocolors41.default.yellow("not configured")} ${import_picocolors41.default.dim(`${DOT3} run Setup`)}`;
   if (missing.has("MCP"))
     rows.push(["mcp", warnRow]);
   else if (ctx.deploymentName)
@@ -67004,7 +67199,7 @@ function checklistRows(ctx, width) {
   if (ctx.repoAgentsMd) {
     rows.push([
       "repo",
-      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors40.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors40.default.dim(`${DOT3} run Setup`)}`
+      ctx.repoAgentsMd === "current" ? `${on} AGENTS.md has the Dosu section` : `${off} ${import_picocolors41.default.yellow(ctx.repoAgentsMd === "outdated" ? "AGENTS.md Dosu section outdated" : "AGENTS.md missing the Dosu section")} ${import_picocolors41.default.dim(`${DOT3} run Setup`)}`
     ]);
   }
   if (missing.has("agents"))
@@ -67016,20 +67211,20 @@ function checklistRows(ctx, width) {
   if (ctx.studying) {
     rows.push([
       "sync",
-      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors40.default.dim(`${DOT3} see activity`)}`
+      `\uD83D\uDCDA ${brand("studying sessions...")} ${import_picocolors41.default.dim(`${DOT3} see activity`)}`
     ]);
   }
   if (ctx.update) {
     rows.push([
       "update",
-      `${import_picocolors40.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors40.default.dim(`${DOT3} ${ctx.update.hint}`)}`
+      `${import_picocolors41.default.yellow(`↑ ${ctx.update.version} available`)} ${import_picocolors41.default.dim(`${DOT3} ${ctx.update.hint}`)}`
     ]);
   }
   const labelWidth = Math.max(...rows.map(([label]) => label.length));
   const valueColumn = LOGO_WIDTH + COLUMN_GAP.length + labelWidth + LABEL_GAP.length;
   const room = Math.max(1, width - valueColumn);
   const indent = " ".repeat(labelWidth + LABEL_GAP.length);
-  return rows.flatMap(([label, value]) => wrapValue(value, room).map((line, i) => i === 0 ? `${import_picocolors40.default.dim(label.padEnd(labelWidth))}${LABEL_GAP}${line}` : `${indent}${line}`));
+  return rows.flatMap(([label, value]) => wrapValue(value, room).map((line, i) => i === 0 ? `${import_picocolors41.default.dim(label.padEnd(labelWidth))}${LABEL_GAP}${line}` : `${indent}${line}`));
 }
 function bannerWidth(columns = process.stdout.columns ?? 80) {
   return columns - layoutMargin(columns) - 1;
@@ -67039,7 +67234,7 @@ function renderBanner(ctx, width = bannerWidth()) {
   const text = [
     ...checklistRows(ctx, width),
     "",
-    `${brandBadge("dosu-cli")} ${import_picocolors40.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
+    `${brandBadge("dosu-cli")} ${import_picocolors41.default.dim(`${ctx.version} ${DOT3} ${ctx.webAppHost}`)}`
   ];
   const height = Math.max(logo.length, text.length);
   const combined = [];
@@ -67052,11 +67247,11 @@ function renderBanner(ctx, width = bannerWidth()) {
   return ["", ...combined, ""].join(`
 `);
 }
-var import_picocolors40, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ", LABEL_GAP = "  ", LIST_SEP;
+var import_picocolors41, CHECK2 = "✔", CIRCLE = "○", DOT3 = "·", LOGO_ROWS, LOGO_MARK, LOGO_WIDTH, LOGO_TONES, COLUMN_GAP = "   ", LABEL_GAP = "  ", LIST_SEP;
 var init_banner = __esm(() => {
   init_styles();
   init_layout();
-  import_picocolors40 = __toESM(require_picocolors(), 1);
+  import_picocolors41 = __toESM(require_picocolors(), 1);
   LOGO_ROWS = [
     [["sage", "▄▄▄▄▄▄"]],
     [["sage", "██    ▀▄"]],
@@ -67067,8 +67262,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_picocolors40.default.green },
-    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors40.default.dim(import_picocolors40.default.green(art)) }
+    sage: { fg: "\x1B[38;2;180;187;145m", fallback: import_picocolors41.default.green },
+    moss: { fg: "\x1B[38;2;119;133;97m", fallback: (art) => import_picocolors41.default.dim(import_picocolors41.default.green(art)) }
   };
   LIST_SEP = ` ${DOT3} `;
 });
@@ -67181,16 +67376,16 @@ function renderPagesFrame(model, width, selected) {
   const body = [];
   let scrollHint = "";
   if (model.phase === "loading") {
-    body.push(import_picocolors41.default.dim("Loading pages…"));
+    body.push(import_picocolors42.default.dim("Loading pages…"));
   } else if (model.phase === "error") {
-    body.push(import_picocolors41.default.yellow(clip3(model.message, width)));
+    body.push(import_picocolors42.default.yellow(clip3(model.message, width)));
   } else if (model.pages.length === 0) {
-    body.push(import_picocolors41.default.dim("No pages in this Library yet."));
+    body.push(import_picocolors42.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_picocolors41.default.bold(row)}` : `  ${import_picocolors41.default.dim(row)}`));
+    body.push(...visible.map((row, i) => start + i === selected ? `${brand("▸")} ${import_picocolors42.default.bold(row)}` : `  ${import_picocolors42.default.dim(row)}`));
     const below = Math.max(0, Math.max(model.total, rows.length) - start - PAGES_VIEW_LINES);
     const parts = [];
     if (above > 0)
@@ -67199,14 +67394,14 @@ function renderPagesFrame(model, width, selected) {
       parts.push(`↓ ${below} more`);
     scrollHint = parts.join(" · ");
   }
-  const count = model.phase === "ready" ? ` ${import_picocolors41.default.dim(model.pages.length < model.total ? `(${model.pages.length} of ${model.total})` : `(${model.pages.length})`)}` : "";
+  const count = model.phase === "ready" ? ` ${import_picocolors42.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_picocolors41.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors42.default.dim(scrollHint)] : [],
     "",
-    import_picocolors41.default.dim("↑↓ move · enter open · esc back")
+    import_picocolors42.default.dim("↑↓ move · enter open · esc back")
   ];
   return lines.join(`
 `);
@@ -67215,9 +67410,9 @@ function renderPageFrame(page, content, width, scroll) {
   const body = [];
   let scrollHint = "";
   if (content.phase === "loading") {
-    body.push(import_picocolors41.default.dim("Loading page…"));
+    body.push(import_picocolors42.default.dim("Loading page…"));
   } else if (content.phase === "error") {
-    body.push(import_picocolors41.default.yellow(clip3(content.message, width)));
+    body.push(import_picocolors42.default.yellow(clip3(content.message, width)));
   } else {
     const rows = wrapBody(content.body, width);
     const { visible, above, below } = windowReport(rows, scroll, PAGE_BODY_LINES);
@@ -67232,12 +67427,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_picocolors41.default.dim(clip3(meta, width)),
+    import_picocolors42.default.dim(clip3(meta, width)),
     "",
     ...body,
-    ...scrollHint ? [import_picocolors41.default.dim(scrollHint)] : [],
+    ...scrollHint ? [import_picocolors42.default.dim(scrollHint)] : [],
     "",
-    import_picocolors41.default.dim("↑↓ scroll · esc back to pages")
+    import_picocolors42.default.dim("↑↓ scroll · esc back to pages")
   ];
   return lines.join(`
 `);
@@ -67386,7 +67581,7 @@ ${CLEAR_BELOW3}`);
     input.on("data", onData);
   });
 }
-var import_picocolors41, 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_picocolors42, 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();
@@ -67396,7 +67591,7 @@ var init_pages_view = __esm(() => {
   init_analytics_view();
   init_layout();
   init_menu();
-  import_picocolors41 = __toESM(require_picocolors(), 1);
+  import_picocolors42 = __toESM(require_picocolors(), 1);
   ESC9 = String.fromCharCode(27);
   HIDE_CURSOR5 = `${ESC9}[?25l`;
   SHOW_CURSOR5 = `${ESC9}[?25h`;
@@ -67509,7 +67704,7 @@ function isSetUp(cfg) {
 }
 function setupHint(cfg) {
   const started = Boolean(cfg.active_account?.target);
-  return import_picocolors42.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
+  return import_picocolors43.default.yellow(started ? `incomplete · missing ${missingSetupSteps(cfg).join(" + ")}` : "not set up yet");
 }
 function isStudying() {
   try {
@@ -67754,7 +67949,7 @@ function handleLogout(cfg) {
   saveConfig(cfg);
   log2.success("Credentials cleared.");
 }
-var import_picocolors42, ESC10, CLEAR_SCREEN;
+var import_picocolors43, ESC10, CLEAR_SCREEN;
 var init_tui = __esm(() => {
   init_client();
   init_config();
@@ -67778,7 +67973,7 @@ var init_tui = __esm(() => {
   init_menu();
   init_pages_view();
   init_prompts();
-  import_picocolors42 = __toESM(require_picocolors(), 1);
+  import_picocolors43 = __toESM(require_picocolors(), 1);
   ESC10 = String.fromCharCode(27);
   CLEAR_SCREEN = `${ESC10}[2J${ESC10}[H`;
 });
@@ -68881,11 +69076,20 @@ async function execute() {
   try {
     await program.parseAsync(process.argv);
   } catch (err) {
+    printFatalError2(err);
+    logFatalError(err);
     if (telemetry)
       await finishTelemetry(() => telemetry.fail(err));
-    throw err;
+    process.exit(1);
   }
 }
+function logFatalError(err) {
+  try {
+    const message = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+    const diagnostics = fatalErrorDiagnostics2(err);
+    logger.error("cli", diagnostics ? `${message} (${diagnostics})` : message);
+  } catch {}
+}
 function processCommandTelemetry() {
   try {
     const settings = loadTelemetrySettings();
@@ -68934,8 +69138,63 @@ var init_cli = __esm(() => {
   init_skill_update_check();
   init_update_check();
   init_errors();
+  init_fatal_error();
 });
 
+// src/cli/fatal-error.ts
+init_command_error();
+var import_picocolors = __toESM(require_picocolors(), 1);
+var REQUEST_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9:._-]{0,127}$/;
+function read(value, key) {
+  if (typeof value !== "object" && typeof value !== "function" || value === null) {
+    return;
+  }
+  try {
+    return Reflect.get(value, key);
+  } catch {
+    return;
+  }
+}
+function tokenOf(data, key) {
+  const value = read(data, key);
+  if (typeof value !== "string")
+    return;
+  const trimmed = value.trim();
+  return REQUEST_ID_PATTERN.test(trimmed) ? trimmed : undefined;
+}
+function statusOf(data) {
+  const value = read(data, "httpStatus");
+  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : undefined;
+}
+function fatalErrorDiagnostics(err) {
+  const data = read(err, "data");
+  if (!data)
+    return;
+  const code = tokenOf(data, "code");
+  const path = tokenOf(data, "path");
+  const status = statusOf(data);
+  const requestId = tokenOf(data, "requestId");
+  const parts = [
+    code && `code=${code}`,
+    path && `path=${path}`,
+    status && `status=${status}`,
+    requestId && `request_id=${requestId}`
+  ].filter(Boolean);
+  return parts.length > 0 ? parts.join(" ") : undefined;
+}
+function printFatalError(err) {
+  if (isCommandError(err)) {
+    console.error(import_picocolors.default.red(err.message));
+    for (const line of err.details)
+      console.error(import_picocolors.default.dim(line));
+    return;
+  }
+  console.error(read(err, "message") ?? err);
+  const diagnostics = fatalErrorDiagnostics(err);
+  if (diagnostics)
+    console.error(diagnostics);
+}
+
 // src/statusline/argv.ts
 var RENDER_ARGV = ["knowledge", "statusline", "render"];
 function isStatuslineRenderArgv(argv) {
@@ -68954,17 +69213,8 @@ async function main() {
   await execute();
 }
 main().catch((err) => {
-  console.error(err.message ?? err);
-  const data = err?.data;
-  if (data && (data.code || data.path || data.httpStatus)) {
-    const parts = [
-      data.code && `code=${data.code}`,
-      data.path && `path=${data.path}`,
-      data.httpStatus && `status=${data.httpStatus}`
-    ].filter(Boolean);
-    console.error(parts.join(" "));
-  }
+  printFatalError(err);
   process.exit(1);
 });
 
-//# debugId=5d3e9365-4283-2b42-6475-6e2164756e21
+//# debugId=fa693edb-14f4-abcb-6475-6e2164756e21