@dosu/cli 0.66.1 → 0.67.1

package/README.md

@@ -119,7 +119,7 @@ Once authenticated against a deployment, you can drive the Dosu platform without
 | `dosu knowledge` | Search and browse your knowledge base |
 | `dosu docs` | Manage documents (list, create, update, import, publish) |
 | `dosu threads` | List and manage conversation threads |
-| `dosu review` | Document review workflow, plus `review notifications` to route a Library's or Agent's reviews to a Slack channel |
+| `dosu review` | Document review workflow for the selected Library, plus `review notifications` to route a Library's or Agent's reviews to a Slack channel |
 | `dosu sources` | Manage connected data sources (list, connect, create, sync, update) |
 | `dosu integrations` | List and inspect platform integrations (Slack, GitHub, …) |
 | `dosu topics` | List knowledge base topics and their pages |

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++) {
@@ -1006,76 +1111,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 +1118,7 @@ function isNpxInvocation(channel = INSTALL_CHANNEL, env = process.env) {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.66.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.67.1", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -1173,18 +1208,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 +7222,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 +7230,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 +11462,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 +11485,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 +11520,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 +11548,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, {
@@ -11535,12 +11567,14 @@ ${import_picocolors15.default.dim(`Current: ${cfg.active_account?.target?.deploy
       return;
     }
     console.log(import_picocolors15.default.green(`Switched to deployment: ${deployment.name}`));
+    console.log(import_picocolors15.default.dim("This changes the CLI's saved selection. An AI tool with a running Dosu MCP connection " + "keeps its previous deployment until you run 'dosu mcp refresh' and restart or " + "reconnect it."));
   });
   return cmd;
 }
 var import_picocolors15, MCP_PROVIDER_SLUG = "dosu_mcp";
 var init_deployments = __esm(() => {
   init_commander();
+  init_command_error();
   init_client();
   init_trpc();
   init_config();
@@ -14289,7 +14323,7 @@ var init_conflicts = __esm(() => {
 });
 
 // src/telemetry/debug-id.ts
-var BUNDLE_DEBUG_ID_PLACEHOLDER = "0891ed1f-f060-16b6-6475-6e2164756e21";
+var BUNDLE_DEBUG_ID_PLACEHOLDER = "152ccbaa-13cc-83fc-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -15088,10 +15122,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();
@@ -15172,7 +15207,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([
@@ -60316,25 +60357,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":
@@ -60386,46 +60429,95 @@ function printDraftPreview(draft) {
   console.log();
   console.log(draft.body ?? "");
 }
-async function getKnowledgeStoreId2(client, spaceId) {
-  const store = await client.knowledgeStore.getBySpaceId.query({ space_id: spaceId });
-  if (!store) {
-    console.error(import_picocolors27.default.red("No knowledge store found for this deployment."));
-    process.exit(1);
+function failScope(code, message, hint = SELECT_LIBRARY_HINT) {
+  throw new CommandError(code, message, [hint]);
+}
+async function lookupLibrary(client, spaceId) {
+  try {
+    const library = await client.libraries.info.query(spaceId);
+    return { found: true, name: library.name || null };
+  } catch (err) {
+    if (isNotFound(err))
+      return { found: false };
+    return { found: true, name: null };
   }
-  return store.id;
+}
+async function resolveReviewScope(client, spaceId, deploymentId) {
+  const [store, library, deployment] = await Promise.all([
+    client.knowledgeStore.getBySpaceId.query({ space_id: spaceId }),
+    lookupLibrary(client, spaceId),
+    deploymentId ? client.workspaces.get.query(deploymentId) : Promise.resolve(undefined)
+  ]);
+  if (deploymentId && !deployment) {
+    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("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("LIBRARY_UNAVAILABLE", `The selected Library (${spaceId}) is unavailable: it was deleted, or the signed-in ` + "account cannot access it.");
+  }
+  return {
+    knowledgeStoreId: store.id,
+    library: { id: spaceId, name: library.name },
+    deployment: deployment ? { id: deployment.deployment_id, name: deployment.name || null } : null
+  };
+}
+function describeScopeEntry(entry) {
+  return entry.name ? `${entry.name} (${entry.id})` : entry.id;
+}
+function printScope(scope) {
+  printInfo([
+    ["Library", describeScopeEntry(scope.library)],
+    [
+      "MCP deployment",
+      scope.deployment ? describeScopeEntry(scope.deployment) : "none selected (draft replies not listed)"
+    ]
+  ]);
+  console.log();
 }
 function reviewCommand() {
   const cmd = new Command("review").description("Review workflow (doc changes and draft replies)");
-  cmd.command("list").description("List pending review items (doc changes and draft replies)").addOption(new Option("--since <when>", "Only items created at or after <when>: a duration back from now (24h, 7d, 2w), " + "a UTC date (2026-09-01), or an ISO-8601 datetime").argParser(timeBound)).addOption(new Option("--until <when>", "Only items created before <when> (same forms; a date includes that whole day)").argParser(timeBound)).option("--json", "Output as JSON").action(async (opts) => {
+  cmd.command("list").description("List pending review items in the selected Library (doc changes and draft replies)").addOption(new Option("--since <when>", "Only items created at or after <when>: a duration back from now (24h, 7d, 2w), " + "a UTC date (2026-09-01), or an ISO-8601 datetime").argParser(timeBound)).addOption(new Option("--until <when>", "Only items created before <when> (same forms; a date includes that whole day)").argParser(timeBound)).option("--json", "Output as JSON").action(async (opts) => {
     let range;
     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();
-    if (!cfg.active_account?.target?.space_id) {
-      console.error(import_picocolors27.default.red("Missing space config. Run 'dosu setup' to reconfigure."));
-      process.exit(1);
+    const target = cfg.active_account?.target;
+    if (!target?.space_id) {
+      failScope("NO_LIBRARY_SELECTED", "No Library selected. The review list reads the Library of the selected MCP deployment.");
     }
     const client = createTypedClient(cfg);
-    const ksId = await getKnowledgeStoreId2(client, cfg.active_account?.target?.space_id);
+    const scope = await resolveReviewScope(client, target.space_id, target.deployment_id);
     const result = await client.review.listPending.query({
-      knowledgeStoreId: ksId,
-      deploymentId: cfg.active_account?.target?.deployment_id,
+      knowledgeStoreId: scope.knowledgeStoreId,
+      ...scope.deployment && { deploymentId: scope.deployment.id },
       ...range.since && { since: range.since.toISOString() },
       ...range.until && { until: range.until.toISOString() }
     });
     const { items, truncated, total } = result;
     if (opts.json) {
-      printResult(result, opts);
+      printResult({
+        ...result,
+        scope: {
+          library: scope.library,
+          deployment: scope.deployment,
+          kinds: scope.deployment ? ["doc_change", "draft_message"] : ["doc_change"],
+          since: range.since?.toISOString() ?? null,
+          until: range.until?.toISOString() ?? null
+        }
+      }, opts);
       return;
     }
+    printScope(scope);
     if (!items || items.length === 0) {
-      console.log(import_picocolors27.default.dim(`No pending review items${inRange}.`));
+      console.log(import_picocolors27.default.dim(`No pending review items in this scope${inRange}.`));
+      console.log(import_picocolors27.default.dim("Only the selected Library is listed. To review another Library, find its MCP " + "deployment with 'dosu deployments list' and select it with " + "'dosu deployments switch <deployment-id>'."));
       return;
     }
     if (rangeLabel)
@@ -60479,30 +60571,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({
@@ -60518,8 +60602,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;
       }
@@ -60600,8 +60683,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({
@@ -60617,10 +60699,11 @@ function reviewCommand() {
   cmd.addCommand(reviewNotificationsCommand());
   return cmd;
 }
-var import_picocolors27, DRAFT_MESSAGE_ID_PREFIX = "draft_message:";
+var import_picocolors27, DRAFT_MESSAGE_ID_PREFIX = "draft_message:", SELECT_LIBRARY_HINT;
 var init_review = __esm(() => {
   init_dist();
   init_commander();
+  init_command_error();
   init_trpc();
   init_auth();
   init_confirmation();
@@ -60628,6 +60711,7 @@ var init_review = __esm(() => {
   init_review_notifications();
   init_time_range();
   import_picocolors27 = __toESM(require_picocolors(), 1);
+  SELECT_LIBRARY_HINT = "Run 'dosu deployments list' to see the MCP deployments you can select, then " + "'dosu deployments switch <deployment-id>' for the Library to review, or run 'dosu setup' " + "to choose the organization and Library again.";
 });
 
 // src/generated/skills.ts
@@ -60713,7 +60797,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.
@@ -61089,7 +61173,7 @@ dosu review notifications set (--library <library-id> | --agent <agent-id>)
 dosu review notifications clear (--library <library-id> | --agent <agent-id>) [--confirm] [--json]
 \`\`\`
 
-- \`list\` reads the selected Library's pending doc changes plus the selected MCP deployment's draft replies. JSON is \`{items, truncated, total}\`: at most 50 items, newest first; \`total\` is a lower bound when \`truncated\` is true. \`--since\`/\`--until\` take \`24h\`/\`7d\`/\`2w\`, a UTC date, or an ISO-8601 datetime.
+- \`list\` reads the selected Library's pending doc changes plus the selected MCP deployment's draft replies. JSON is \`{items, truncated, total, scope}\`: at most 50 items, newest first; \`total\` is a lower bound when \`truncated\` is true; \`scope\` names the Library and MCP deployment searched (see [review-workflow.md](review-workflow.md)). A missing, deleted, or inaccessible Library or deployment is an error, not an empty list. \`--since\`/\`--until\` take \`24h\`/\`7d\`/\`2w\`, a UTC date, or an ISO-8601 datetime.
 - IDs are opaque: pass each \`id\` from \`list\` verbatim (draft replies carry a \`draft_message:\` prefix). \`revert\` takes a decided doc change's page-version ID and does not apply to drafts.
 - \`edit\` requires at least one field; drafts accept only \`--body\`/\`--body-file\`. \`approve\` and \`reject\` do not write without interactive confirmation or \`--confirm\`.
 - \`notifications\` manages the Slack channel that receives review notifications for one Library (doc reviews) or one Agent (its draft replies). Unlike the queue commands it takes an explicit target, not the selected MCP deployment. Pass exactly one of \`--library\`/\`--agent\` (UUID v4; Agent IDs come from \`dosu agents list\`).
@@ -61169,6 +61253,7 @@ dosu deployments switch <id> [--json]
 
 dosu mcp list
 dosu mcp add <agent> [--global] [--show-secret]
+dosu mcp refresh
 dosu skill install | remove | update
 dosu telemetry status [--json]
 dosu telemetry enable | disable | reset
@@ -61177,7 +61262,7 @@ dosu upgrade [--auto on|off]
 dosu logs [--tail [n]] [--clear]
 \`\`\`
 
-\`deployments\` selects the MCP deployment stored in local config; it is distinct from \`agents\`. \`insights\` opens an interactive visual report. \`logs --clear\` deletes the CLI log file. The CLI updates itself in the background by default; a \`[dosu:update] Installing ...\` notice on stderr needs no action. \`upgrade --auto off\` turns that off.
+\`deployments\` selects the MCP deployment stored in local config; it is distinct from \`agents\`. \`deployments switch\` does not repoint an AI tool's running MCP connection; \`mcp refresh\` rewrites the global Dosu MCP entry of each configured tool from the current selection (project-level entries change on the next \`dosu setup\` or \`dosu mcp add\`), and the tool then needs a restart or reconnect. \`insights\` opens an interactive visual report. \`logs --clear\` deletes the CLI log file. The CLI updates itself in the background by default; a \`[dosu:update] Installing ...\` notice on stderr needs no action. \`upgrade --auto off\` turns that off.
 
 ## Codebase audit
 
@@ -61192,7 +61277,7 @@ The coding agent writes the findings; Dosu generates the selected docs. Follow [
         },
         {
           path: "references/review-workflow.md",
-          content: '# Review workflow\n\nHow to work Dosu\'s review queue from the CLI: triage pending items, read the\ndiff, optionally edit, and apply a decision — safely.\n\nThe queue holds **document versions** (AI-generated, user-edited, synced from\nsource, or API-created) and **draft messages**, all surfaced through the same\n`dosu review` commands. Doc changes come from the selected Library; draft\nreplies come only from threads of the selected MCP deployment.\n\n## Read the list result\n\n`dosu review list --json` returns `{ "items": [...], "truncated": <bool>, "total": <n> }`.\n\n- `items` holds at most 50 entries, newest first, doc changes and draft\n  replies merged.\n- `truncated: true` means more pending items may exist than `items` shows.\n- `total` counts what the server found before that cap. When `truncated` is\n  true it is a lower bound: report "at least `total`", never an exact backlog.\n- Each `id` is opaque. A doc change\'s `id` is its page-version UUID; a draft\n  reply\'s `id` looks like `draft_message:<uuid>` and has `kind: "draft_message"`.\n  Pass the `id` exactly as listed to `diff`, `edit`, `approve`, and `reject`;\n  do not strip the prefix or shorten it.\n- `--since <when>` and `--until <when>` narrow the list by creation time. Each\n  takes a duration back from now (`24h`, `7d`, `2w`), a UTC date\n  (`2026-09-01`; an `--until` date includes that whole day), or an ISO-8601\n  datetime. When `truncated` is true, `--until` reaches older items.\n\nAn empty `items` array means no pending items in the current scope. It is not\na reason to switch deployments.\n\n## Check the context when the scope looks wrong\n\nRun this only when the user says the list is for the wrong Library, names a\ndifferent Library, or a command reports missing context:\n\n1. `dosu status --json`: login state and the selected MCP deployment.\n2. `dosu deployments info --json`: the selected MCP deployment. The list reads\n   the Library saved in the CLI\'s config, which `dosu setup` and\n   `dosu deployments switch` set to this deployment\'s `space_id`\n   (`dosu libraries info <space_id> --json` gives its name).\n3. If that is not the Library the user means, run\n   `dosu deployments list --json` and find the MCP deployment whose `space_id`\n   matches it (`dosu libraries list --json` maps names to IDs).\n4. Switch only to a deployment the user named or confirmed:\n   `dosu deployments switch <deployment-id> --json`. It changes the CLI\'s\n   selection for later commands and mints a new API key, so say that it did.\n   Never pick the first deployment, and ask when several match or none does.\n5. Run `dosu review list --json` again.\n\n## Draft reply limits\n\n- `edit` on a draft accepts `--body` or `--body-file` only (no `--title`).\n- `approve` publishes the draft to its thread; `reject` discards it.\n- Drafts have no `revert`. A rejected draft is regenerated on the next agent run.\n\n## Scope tool access for a review session\n\nApproving and rejecting are destructive and outward-facing. When you spin up an\nagent session dedicated to reviewing, scope it to just the review commands:\n\n```yaml\nallowed-tools: Bash(dosu review:*)\n```\n\nThis lets the agent triage, diff, and edit, but keeps it from running unrelated\nCLI commands during a review pass.\n\n## The flow\n\n```bash\n# 1. Triage — what\'s pending? Columns: ID, Kind, Title, Source, Status, Created.\ndosu review list --json\ndosu review list --since 7d --json          # optional creation-time window\n\n# 2. Inspect — read the exact change before deciding anything.\ndosu review diff <id> --json\n\n# 3. (optional) Edit in place instead of rejecting a near-miss.\ndosu review edit <id> --body-file ./revised.md   # or --body / --title (docs only)\n\n# 4. Decide — only on the item the user named, only after they OK it.\ndosu review approve <id> --confirm --json\ndosu review reject  <id> --confirm --json\n\n# Undo a doc-change decision — back to pending (not for draft replies).\ndosu review revert <page-version-id> --json\n```\n\n### `--confirm` is mandatory for agents\n\n`approve` and `reject` only prompt interactively in a TTY *without* `--json`.\nThe skill always passes `--json`, which suppresses both the diff preview and\nthe prompt — so without `--confirm` the command changes nothing and returns\n`{ "applied": false, "confirmRequired": true }`. Run `dosu review diff <id>` to\nsee the change, then pass `--confirm` to apply — only after the user has\napproved that specific item.\n\n## Reading the `Source` column\n\n`Source` is the humanized `origin` field:\n\n| `origin` | Source | Meaning |\n|---|---|---|\n| `manual_update` | User created / User updated | A teammate authored or edited the doc |\n| `llm_generated` | AI generated | Dosu drafted the change |\n| `sync_upstream` | Synced from source | Came in from a connected source (Notion/Confluence/GitHub) |\n| `api_update` | Created via API | Pushed in programmatically |\n\n## Feeding PR / thread context\n\nA review often originates from a conversation thread (a GitHub issue, a Slack\nmessage, a sync-back PR). Pull that context before deciding:\n\n```bash\ndosu review context <thread-id> --json\n```\n\nIt returns the review `type`, the review/published page IDs, and — when the\nchange round-trips to an external system — a **Sync PR URL**. Use it to:\n\n- show the user where the change came from and where approval will land, and\n- read the originating discussion so the decision matches intent.\n\n## Safety rules\n\n- **Explicit item only.** Decide on the `id` the user named. "Review my queue"\n  → run `list` and show it; never decide on their behalf.\n- **Listing is read-only.** A request to show the list authorizes no approve,\n  reject, edit, API-key creation, or deployment switch.\n- **Diff before deciding.** Always `diff` and surface the change first.\n- **Never batch-accept.** No loop over `list` that approves everything. One\n  item, one confirmation.\n- **Extra care for sync/PR origins.** `Synced from source` items and anything\n  with a Sync PR URL push back to an upstream system on approval. Call it out\n  and get explicit sign-off.\n',
+          content: '# Review workflow\n\nHow to work Dosu\'s review queue from the CLI: triage pending items, read the\ndiff, optionally edit, and apply a decision — safely.\n\nThe queue holds **document versions** (AI-generated, user-edited, synced from\nsource, or API-created) and **draft messages**, all surfaced through the same\n`dosu review` commands. Doc changes come from the selected Library; draft\nreplies come only from threads of the selected MCP deployment.\n\n## Read the list result\n\n`dosu review list --json` returns\n`{ "items": [...], "truncated": <bool>, "total": <n>, "scope": {...} }`.\n\n- `items` holds at most 50 entries, newest first, doc changes and draft\n  replies merged.\n- `truncated: true` means more pending items may exist than `items` shows.\n- `total` counts what the server found before that cap. When `truncated` is\n  true it is a lower bound: report "at least `total`", never an exact backlog.\n- Each `id` is opaque. A doc change\'s `id` is its page-version UUID; a draft\n  reply\'s `id` looks like `draft_message:<uuid>` and has `kind: "draft_message"`.\n  Pass the `id` exactly as listed to `diff`, `edit`, `approve`, and `reject`;\n  do not strip the prefix or shorten it.\n- `--since <when>` and `--until <when>` narrow the list by creation time. Each\n  takes a duration back from now (`24h`, `7d`, `2w`), a UTC date\n  (`2026-09-01`; an `--until` date includes that whole day), or an ISO-8601\n  datetime. When `truncated` is true, `--until` reaches older items.\n\n`scope` says what was searched. It was added alongside the older fields,\nwhich keep their meaning:\n\n- `library`: `{ "id", "name" }` of the Library whose pending doc changes are\n  listed.\n- `deployment`: `{ "id", "name" }` of the MCP deployment whose draft replies\n  are listed, or `null` when none is saved. Then drafts are not listed.\n- `kinds`: the item kinds searched, `["doc_change", "draft_message"]` or\n  `["doc_change"]`.\n- `since` / `until`: the resolved ISO-8601 bounds, or `null` when unbounded.\n\nA `name` is `null` when the server could not provide one; report the ID then\nand do not guess a name. Tell the user which Library the list covers.\n\nAn empty `items` array means no pending items in this scope. It is not a\nreason to switch deployments.\n\n`review list` checks the saved context before listing and fails (exit 1,\nnothing on stdout) instead of returning an empty list when:\n\n- `Not logged in`: run `dosu login`.\n- `No Library selected`: no Library is saved. Follow the context check below.\n- `... is unavailable`: the saved MCP deployment or Library was deleted, or\n  the signed-in account cannot access it. Follow the context check below; if\n  `dosu deployments list --json` returns nothing, the saved organization may\n  be the inaccessible one, and `dosu setup` chooses it again.\n- `... does not match ...`: the saved Library is not the MCP deployment\'s\n  Library. The message names the `dosu deployments switch` command that saves\n  them together again; run it only after the user confirms.\n\n## Check the context when the scope looks wrong\n\nRun this only when the user says the list is for the wrong Library, names a\ndifferent Library, or a command reports missing context:\n\n1. `dosu status --json`: login state and the selected MCP deployment.\n2. `dosu deployments info --json`: the selected MCP deployment. The list reads\n   the Library saved in the CLI\'s config, which `dosu setup` and\n   `dosu deployments switch` set to this deployment\'s `space_id`\n   (`dosu libraries info <space_id> --json` gives its name). A successful list\n   already reports both in `scope`, and a saved Library that does not match\n   the deployment\'s is an error.\n3. If that is not the Library the user means, run\n   `dosu deployments list --json` and find the MCP deployment whose `space_id`\n   matches it (`dosu libraries list --json` maps names to IDs).\n4. Switch only to a deployment the user named or confirmed:\n   `dosu deployments switch <deployment-id> --json`. It changes the CLI\'s\n   selection for later commands and mints a new API key, so say that it did.\n   Never pick the first deployment, and ask when several match or none does.\n5. Run `dosu review list --json` again.\n\n`deployments switch` changes only the CLI\'s saved selection. An AI tool with a\nrunning Dosu MCP connection still points at its previous deployment until\n`dosu mcp refresh` rewrites its MCP entry and the tool restarts or reconnects.\nSay so after a switch; do not run `dosu mcp refresh` unless the user asks.\n\n## Draft reply limits\n\n- `edit` on a draft accepts `--body` or `--body-file` only (no `--title`).\n- `approve` publishes the draft to its thread; `reject` discards it.\n- Drafts have no `revert`. A rejected draft is regenerated on the next agent run.\n\n## Scope tool access for a review session\n\nApproving and rejecting are destructive and outward-facing. When you spin up an\nagent session dedicated to reviewing, scope it to just the review commands:\n\n```yaml\nallowed-tools: Bash(dosu review:*)\n```\n\nThis lets the agent triage, diff, and edit, but keeps it from running unrelated\nCLI commands during a review pass.\n\n## The flow\n\n```bash\n# 1. Triage — what\'s pending? Columns: ID, Kind, Title, Source, Status, Created.\ndosu review list --json\ndosu review list --since 7d --json          # optional creation-time window\n\n# 2. Inspect — read the exact change before deciding anything.\ndosu review diff <id> --json\n\n# 3. (optional) Edit in place instead of rejecting a near-miss.\ndosu review edit <id> --body-file ./revised.md   # or --body / --title (docs only)\n\n# 4. Decide — only on the item the user named, only after they OK it.\ndosu review approve <id> --confirm --json\ndosu review reject  <id> --confirm --json\n\n# Undo a doc-change decision — back to pending (not for draft replies).\ndosu review revert <page-version-id> --json\n```\n\n### `--confirm` is mandatory for agents\n\n`approve` and `reject` only prompt interactively in a TTY *without* `--json`.\nThe skill always passes `--json`, which suppresses both the diff preview and\nthe prompt — so without `--confirm` the command changes nothing and returns\n`{ "applied": false, "confirmRequired": true }`. Run `dosu review diff <id>` to\nsee the change, then pass `--confirm` to apply — only after the user has\napproved that specific item.\n\n## Reading the `Source` column\n\n`Source` is the humanized `origin` field:\n\n| `origin` | Source | Meaning |\n|---|---|---|\n| `manual_update` | User created / User updated | A teammate authored or edited the doc |\n| `llm_generated` | AI generated | Dosu drafted the change |\n| `sync_upstream` | Synced from source | Came in from a connected source (Notion/Confluence/GitHub) |\n| `api_update` | Created via API | Pushed in programmatically |\n\n## Feeding PR / thread context\n\nA review often originates from a conversation thread (a GitHub issue, a Slack\nmessage, a sync-back PR). Pull that context before deciding:\n\n```bash\ndosu review context <thread-id> --json\n```\n\nIt returns the review `type`, the review/published page IDs, and — when the\nchange round-trips to an external system — a **Sync PR URL**. Use it to:\n\n- show the user where the change came from and where approval will land, and\n- read the originating discussion so the decision matches intent.\n\n## Safety rules\n\n- **Explicit item only.** Decide on the `id` the user named. "Review my queue"\n  → run `list` and show it; never decide on their behalf.\n- **Listing is read-only.** A request to show the list authorizes no approve,\n  reject, edit, API-key creation, or deployment switch.\n- **Diff before deciding.** Always `diff` and surface the change first.\n- **Never batch-accept.** No loop over `list` that approves everything. One\n  item, one confirmation.\n- **Extra care for sync/PR origins.** `Synced from source` items and anything\n  with a Sync PR URL push back to an upstream system on approval. Call it out\n  and get explicit sign-off.\n',
           executable: false
         },
         {
@@ -62328,7 +62413,7 @@ function requireConfig13() {
   }
   return cfg;
 }
-async function getKnowledgeStoreId3(client, spaceId) {
+async function getKnowledgeStoreId2(client, spaceId) {
   const store = await client.knowledgeStore.getBySpaceId.query({
     space_id: spaceId
   });
@@ -62343,7 +62428,7 @@ function topicsCommand() {
   cmd.command("list").description("List all topics").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = requireConfig13();
     const client = createTypedClient(cfg);
-    const ksId = await getKnowledgeStoreId3(client, cfg.active_account.target.space_id);
+    const ksId = await getKnowledgeStoreId2(client, cfg.active_account.target.space_id);
     const topics = await client.topic.listTopicsByKnowledgeStore.query({
       knowledge_store_id: ksId
     });
@@ -62364,7 +62449,7 @@ function topicsCommand() {
   cmd.command("pages").description("List pages with a specific topic").argument("<topic-id>", "Topic ID").option("--search <query>", "Search within the topic's pages").addOption(new Option("--limit <n>", "Maximum results").argParser(positiveInteger).default(10)).option("--json", "Output as JSON").action(async (topicId, opts) => {
     const cfg = requireConfig13();
     const client = createTypedClient(cfg);
-    const ksId = await getKnowledgeStoreId3(client, cfg.active_account.target.space_id);
+    const ksId = await getKnowledgeStoreId2(client, cfg.active_account.target.space_id);
     const result = await client.topic.getPagesByTopicId.query({
       knowledge_store_id: ksId,
       topic_id: topicId,
@@ -66640,6 +66725,63 @@ var init_incognito_backfill_check = __esm(() => {
   import_picocolors38 = __toESM(require_picocolors(), 1);
 });
 
+// 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
 function analyticsListHeight(rows) {
   const room = frameMaxLines(rows) - ANALYTICS_VIEW_CHROME_LINES;
@@ -66758,7 +66900,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`);
@@ -66774,9 +66916,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(`
 `);
@@ -66873,7 +67015,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();
@@ -66881,7 +67023,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`;
@@ -66899,7 +67041,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);
@@ -66930,14 +67072,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)
@@ -66949,7 +67091,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"))
@@ -66961,20 +67103,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;
@@ -66984,7 +67126,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 = [];
@@ -66997,11 +67139,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", "██    ▀▄"]],
@@ -67012,8 +67154,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} `;
 });
@@ -67126,16 +67268,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)
@@ -67144,14 +67286,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(`
 `);
@@ -67160,9 +67302,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);
@@ -67177,12 +67319,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(`
 `);
@@ -67331,7 +67473,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();
@@ -67341,7 +67483,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`;
@@ -67454,7 +67596,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 {
@@ -67699,7 +67841,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();
@@ -67723,7 +67865,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`;
 });
@@ -68826,11 +68968,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();
@@ -68879,8 +69030,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) {
@@ -68899,17 +69105,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=0891ed1f-f060-16b6-6475-6e2164756e21
+//# debugId=152ccbaa-13cc-83fc-6475-6e2164756e21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.66.1",
+  "version": "0.67.1",
   "type": "module",
   "description": "Dosu CLI - Set up Dosu MCP for AI tools and work with Dosu Libraries, docs, and reviews",
   "license": "MIT",