@dosu/cli 0.67.0 → 0.67.1

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.67.0", 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, {
@@ -11542,6 +11574,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 +14323,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 = "152ccbaa-13cc-83fc-6475-6e2164756e21";
 
 // src/telemetry/telemetry.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
@@ -15089,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();
@@ -15173,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([
@@ -60317,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":
@@ -60387,10 +60429,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 +60449,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 +60483,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 +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({
@@ -60571,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;
       }
@@ -60653,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({
@@ -60674,6 +60703,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 +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.
@@ -66695,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;
@@ -66813,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`);
@@ -66829,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(`
 `);
@@ -66928,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();
@@ -66936,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`;
@@ -66954,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);
@@ -66985,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)
@@ -67004,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"))
@@ -67016,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;
@@ -67039,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 = [];
@@ -67052,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", "██    ▀▄"]],
@@ -67067,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} `;
 });
@@ -67181,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)
@@ -67199,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(`
 `);
@@ -67215,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);
@@ -67232,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(`
 `);
@@ -67386,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();
@@ -67396,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`;
@@ -67509,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 {
@@ -67754,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();
@@ -67778,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`;
 });
@@ -68881,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();
@@ -68934,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) {
@@ -68954,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=5d3e9365-4283-2b42-6475-6e2164756e21
+//# debugId=152ccbaa-13cc-83fc-6475-6e2164756e21

package/package.json

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