@dosu/cli 0.7.0 → 0.9.0

package/bin/dosu.js

@@ -2118,6 +2118,192 @@ function emptyConfig() {
 var MODE_OSS = "oss";
 var init_config = () => {};
 
+// node_modules/picocolors/picocolors.js
+var require_picocolors = __commonJS((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 getVersionString() {
+  return `v${VERSION}`;
+}
+var VERSION = "0.9.0";
+
+// src/debug/logger.ts
+import {
+  appendFileSync,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  statSync,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { join as join2 } from "node:path";
+function ensureInit() {
+  if (!initialized) {
+    initLogger({});
+  }
+}
+function resolveLogPath() {
+  if (!logFilePath) {
+    const dir = getConfigDir();
+    if (!existsSync2(dir)) {
+      mkdirSync2(dir, { recursive: true, mode: 448 });
+    }
+    logFilePath = join2(dir, LOG_FILENAME);
+  }
+  return logFilePath;
+}
+function truncateIfNeeded() {
+  try {
+    const path = resolveLogPath();
+    if (!existsSync2(path))
+      return;
+    const stat = statSync(path);
+    if (stat.size <= MAX_LOG_SIZE)
+      return;
+    const content = readFileSync2(path);
+    const start = content.length - TRUNCATE_KEEP;
+    let lineStart = start;
+    while (lineStart < content.length && content[lineStart] !== 10) {
+      lineStart++;
+    }
+    lineStart = Math.min(lineStart + 1, content.length);
+    writeFileSync2(path, content.subarray(lineStart), { mode: 384 });
+  } catch {}
+}
+function writeSessionHeader() {
+  try {
+    const now = new Date().toISOString();
+    const header = `
+════════════════════════════════════════
+` + `Session: ${now} | v${VERSION} | ${process.platform} ${process.arch} | node ${process.version}
+` + `════════════════════════════════════════
+`;
+    appendFileSync(resolveLogPath(), header, { mode: 384 });
+  } catch {}
+}
+function initLogger(opts) {
+  debugToConsole = opts.debug ?? false;
+  try {
+    resolveLogPath();
+    truncateIfNeeded();
+    writeSessionHeader();
+  } catch {}
+  initialized = true;
+}
+function writeEntry(level, mod, message) {
+  ensureInit();
+  const timestamp = new Date().toISOString();
+  const line = `[${timestamp}] [${level}] [${mod}] ${message}
+`;
+  try {
+    appendFileSync(resolveLogPath(), line, { mode: 384 });
+  } 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
+    }[level];
+    console.error(colorize(line.trimEnd()));
+  }
+}
+var import_picocolors, MAX_LOG_SIZE = 1048576, TRUNCATE_KEEP = 524288, LOG_FILENAME = "debug.log", initialized = false, debugToConsole = false, logFilePath = null, logger;
+var init_logger = __esm(() => {
+  init_config();
+  import_picocolors = __toESM(require_picocolors(), 1);
+  logger = {
+    init: initLogger,
+    getLogPath() {
+      return resolveLogPath();
+    },
+    debug(mod, message) {
+      writeEntry("DEBUG", mod, message);
+    },
+    info(mod, message) {
+      writeEntry("INFO", mod, message);
+    },
+    warn(mod, message) {
+      writeEntry("WARN", mod, message);
+    },
+    error(mod, message) {
+      writeEntry("ERROR", mod, message);
+    },
+    _resetForTesting() {
+      initialized = false;
+      debugToConsole = false;
+      logFilePath = null;
+    }
+  };
+});
+
 // src/config/constants.ts
 function getWebAppURL() {
   return "https://app.dosu.dev";
@@ -2133,7 +2319,7 @@ function getSupabaseAnonKey() {
 }
 
 // src/mcp/config-helpers.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { dirname } from "node:path";
 function mcpURL(deploymentID) {
   return `${getBackendURL()}/v1/mcp/deployments/${deploymentID}`;
@@ -2145,9 +2331,9 @@ function mcpHeaders(apiKey) {
   return { "X-Dosu-API-Key": apiKey };
 }
 function loadJSONConfig(path) {
-  if (!existsSync2(path))
+  if (!existsSync3(path))
     return {};
-  let data = readFileSync2(path, "utf-8").trim();
+  let data = readFileSync3(path, "utf-8").trim();
   if (!data)
     return {};
   if (path.endsWith(".jsonc")) {
@@ -2207,10 +2393,10 @@ function stripJSONComments(data) {
 }
 function saveJSONConfig(path, cfg) {
   const dir = dirname(path);
-  if (!existsSync2(dir)) {
-    mkdirSync2(dir, { recursive: true });
+  if (!existsSync3(dir)) {
+    mkdirSync3(dir, { recursive: true });
   }
-  writeFileSync2(path, JSON.stringify(cfg, null, 2));
+  writeFileSync3(path, JSON.stringify(cfg, null, 2));
 }
 function isJSONKeyConfigured(configPath, topLevelKey) {
   const cfg = loadJSONConfig(configPath);
@@ -2245,21 +2431,21 @@ function removeJSONServer(configPath, topKey) {
 var init_config_helpers = () => {};
 
 // src/mcp/detect.ts
-import { existsSync as existsSync3 } from "node:fs";
+import { existsSync as existsSync4 } from "node:fs";
 import { homedir, platform } from "node:os";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 function isInstalled(paths) {
-  return paths.some((p) => existsSync3(expandHome(p)));
+  return paths.some((p) => existsSync4(expandHome(p)));
 }
 function expandHome(path) {
   if (!path.startsWith("~"))
     return path;
-  return join2(homedir(), path.slice(1));
+  return join3(homedir(), path.slice(1));
 }
 function appSupportDir() {
   switch (platform()) {
     case "darwin": {
-      return join2(homedir(), "Library", "Application Support");
+      return join3(homedir(), "Library", "Application Support");
     }
     case "win32": {
       return process.env.APPDATA ?? "";
@@ -2268,7 +2454,7 @@ function appSupportDir() {
       const xdg = process.env.XDG_CONFIG_HOME;
       if (xdg)
         return xdg;
-      return join2(homedir(), ".config");
+      return join3(homedir(), ".config");
     }
   }
 }
@@ -2349,7 +2535,7 @@ var init_antigravity = __esm(() => {
 });
 
 // src/mcp/providers/claude.ts
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 var ClaudeProvider = () => createJSONProvider({
   providerName: "Claude Code",
   providerID: "claude",
@@ -2358,22 +2544,22 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join3(cwd, ".mcp.json")
+  localConfigPath: (cwd) => join4(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/claude-desktop.ts
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
   supportsLocal: () => false,
   priority: () => 2,
-  detectPaths: () => [join4(appSupportDir(), "Claude")],
-  isInstalled: () => isInstalled([join4(appSupportDir(), "Claude")]),
-  globalConfigPath: () => join4(appSupportDir(), "Claude", "claude_desktop_config.json"),
+  detectPaths: () => [join5(appSupportDir(), "Claude")],
+  isInstalled: () => isInstalled([join5(appSupportDir(), "Claude")]),
+  globalConfigPath: () => join5(appSupportDir(), "Claude", "claude_desktop_config.json"),
   isConfigured: () => false,
   install() {
     throw new Error("this tool only supports local (stdio) servers and cannot be configured for remote MCP");
@@ -2387,14 +2573,14 @@ var init_claude_desktop = __esm(() => {
 });
 
 // src/mcp/providers/cline.ts
-import { join as join5 } from "node:path";
-var extensionDir = () => join5(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
+import { join as join6 } from "node:path";
+var extensionDir = () => join6(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
   providerName: "Cline",
   providerID: "cline",
   local: false,
   priorityValue: 11,
   paths: [extensionDir()],
-  globalPath: join5(extensionDir(), "settings", "cline_mcp_settings.json"),
+  globalPath: join6(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -2410,7 +2596,7 @@ var init_cline = __esm(() => {
 });
 
 // src/mcp/providers/cline-cli.ts
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function clineDir() {
   return process.env.CLINE_DIR ?? expandHome("~/.cline");
 }
@@ -2420,7 +2606,7 @@ var ClineCliProvider = () => createJSONProvider({
   local: false,
   priorityValue: 12,
   paths: [clineDir()],
-  globalPath: join6(clineDir(), "data", "settings", "cline_mcp_settings.json"),
+  globalPath: join7(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -2436,26 +2622,26 @@ var init_cline_cli = __esm(() => {
 });
 
 // src/mcp/providers/codex.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname2, join as join7 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname2, join as join8 } from "node:path";
 function codexHome() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
 function getConfigPath2(global) {
   if (global)
-    return join7(codexHome(), "config.toml");
-  return join7(process.cwd(), ".codex", "config.toml");
+    return join8(codexHome(), "config.toml");
+  return join8(process.cwd(), ".codex", "config.toml");
 }
 function readTOML(path) {
-  if (!existsSync4(path))
+  if (!existsSync5(path))
     return "";
-  return readFileSync3(path, "utf-8");
+  return readFileSync4(path, "utf-8");
 }
 function writeTOML(path, content) {
   const dir = dirname2(path);
-  if (!existsSync4(dir))
-    mkdirSync3(dir, { recursive: true });
-  writeFileSync3(path, content);
+  if (!existsSync5(dir))
+    mkdirSync4(dir, { recursive: true });
+  writeFileSync4(path, content);
 }
 function installDosuToTOML(path, cfg) {
   let content = readTOML(path);
@@ -2503,9 +2689,9 @@ var CodexProvider = () => ({
   priority: () => 8,
   detectPaths: () => ["~/.codex"],
   isInstalled: () => isInstalled(["~/.codex"]),
-  globalConfigPath: () => join7(codexHome(), "config.toml"),
+  globalConfigPath: () => join8(codexHome(), "config.toml"),
   isConfigured: () => {
-    const content = readTOML(join7(codexHome(), "config.toml"));
+    const content = readTOML(join8(codexHome(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
   install(cfg, global) {
@@ -2527,10 +2713,10 @@ var init_codex = __esm(() => {
 });
 
 // src/mcp/providers/copilot.ts
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
-    return join8(process.env.XDG_CONFIG_HOME, "mcp-config.json");
+    return join9(process.env.XDG_CONFIG_HOME, "mcp-config.json");
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
@@ -2556,7 +2742,7 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath = join8(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join9(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url,
@@ -2569,7 +2755,7 @@ var CopilotProvider = () => ({
     if (global) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath = join8(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join9(process.cwd(), ".vscode", "mcp.json");
       removeJSONServer(configPath, "servers");
     }
   }
@@ -2581,7 +2767,7 @@ var init_copilot = __esm(() => {
 });
 
 // src/mcp/providers/cursor.ts
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 var CursorProvider = () => createJSONProvider({
   providerName: "Cursor",
   providerID: "cursor",
@@ -2594,7 +2780,7 @@ var CursorProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join9(cwd, ".cursor", "mcp.json")
+  localConfigPath: (cwd) => join10(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
   init_config_helpers();
@@ -2602,7 +2788,7 @@ var init_cursor = __esm(() => {
 });
 
 // src/mcp/providers/gemini.ts
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 var GeminiProvider = () => createJSONProvider({
   providerName: "Gemini CLI",
   providerID: "gemini",
@@ -2611,7 +2797,7 @@ var GeminiProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/settings.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join10(cwd, ".gemini", "settings.json")
+  localConfigPath: (cwd) => join11(cwd, ".gemini", "settings.json")
 });
 var init_gemini = __esm(() => {
   init_base();
@@ -2642,14 +2828,14 @@ var init_manual = __esm(() => {
 });
 
 // src/mcp/providers/mcporter.ts
-import { existsSync as existsSync5 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync6 } from "node:fs";
+import { join as join12 } from "node:path";
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
-  if (existsSync5(jsonPath))
+  if (existsSync6(jsonPath))
     return jsonPath;
   const jsoncPath = expandHome("~/.mcporter/mcporter.jsonc");
-  if (existsSync5(jsoncPath))
+  if (existsSync6(jsoncPath))
     return jsoncPath;
   return jsonPath;
 }
@@ -2665,7 +2851,7 @@ var MCPorterProvider = () => ({
   install(cfg, global) {
     if (cfg.mode !== MODE_OSS && !cfg.deployment_id)
       throw new Error("deployment ID is required");
-    const configPath = global ? resolveGlobalConfigPath() : join11(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join12(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: cfg.mode === MODE_OSS ? mcpBaseURL() : mcpURL(cfg.deployment_id),
@@ -2674,7 +2860,7 @@ var MCPorterProvider = () => ({
     installJSONServer(configPath, "mcpServers", server);
   },
   remove(global) {
-    const configPath = global ? resolveGlobalConfigPath() : join11(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join12(process.cwd(), "config", "mcporter.json");
     removeJSONServer(configPath, "mcpServers");
   }
 });
@@ -2685,7 +2871,7 @@ var init_mcporter = __esm(() => {
 });
 
 // src/mcp/providers/opencode.ts
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var OpenCodeProvider = () => createJSONProvider({
   providerName: "OpenCode",
   providerID: "opencode",
@@ -2700,7 +2886,7 @@ var OpenCodeProvider = () => createJSONProvider({
     enabled: true,
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join12(cwd, "opencode.json")
+  localConfigPath: (cwd) => join13(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
   init_config_helpers();
@@ -2708,16 +2894,16 @@ var init_opencode = __esm(() => {
 });
 
 // src/mcp/providers/vscode.ts
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 var VSCodeProvider = () => createJSONProvider({
   providerName: "VS Code",
   providerID: "vscode",
   local: true,
   priorityValue: 6,
-  paths: [join13(appSupportDir(), "Code")],
-  globalPath: join13(appSupportDir(), "Code", "User", "mcp.json"),
+  paths: [join14(appSupportDir(), "Code")],
+  globalPath: join14(appSupportDir(), "Code", "User", "mcp.json"),
   topKey: "servers",
-  localConfigPath: (cwd) => join13(cwd, ".vscode", "mcp.json")
+  localConfigPath: (cwd) => join14(cwd, ".vscode", "mcp.json")
 });
 var init_vscode = __esm(() => {
   init_detect();
@@ -2726,14 +2912,14 @@ var init_vscode = __esm(() => {
 
 // src/mcp/providers/windsurf.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join14(homedir2(), ".codeium", "windsurf")],
-  globalPath: join14(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join15(homedir2(), ".codeium", "windsurf")],
+  globalPath: join15(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -2742,12 +2928,12 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { platform as platform2 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function zedConfigDir() {
   const os = platform2();
   if (os === "darwin" || os === "win32")
-    return join15(appSupportDir(), "Zed");
-  return join15(appSupportDir(), "zed");
+    return join16(appSupportDir(), "Zed");
+  return join16(appSupportDir(), "zed");
 }
 var ZedProvider = () => createJSONProvider({
   providerName: "Zed",
@@ -2755,7 +2941,7 @@ var ZedProvider = () => createJSONProvider({
   local: true,
   priorityValue: 10,
   paths: [zedConfigDir()],
-  globalPath: join15(zedConfigDir(), "settings.json"),
+  globalPath: join16(zedConfigDir(), "settings.json"),
   topKey: "context_servers",
   buildServer: (cfg) => ({
     source: "custom",
@@ -2763,7 +2949,7 @@ var ZedProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join15(cwd, ".zed", "settings.json")
+  localConfigPath: (cwd) => join16(cwd, ".zed", "settings.json")
 });
 var init_zed = __esm(() => {
   init_config_helpers();
@@ -2877,76 +3063,6 @@ var require_src = __commonJS((exports, module) => {
   module.exports = { cursor, scroll, erase, beep };
 });
 
-// node_modules/picocolors/picocolors.js
-var require_picocolors = __commonJS((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;
-});
-
 // node_modules/@clack/core/dist/index.mjs
 import { stdin as j, stdout as M } from "node:process";
 import * as g from "node:readline";
@@ -3369,17 +3485,17 @@ import y2 from "node:process";
 function ce() {
   return y2.platform !== "win32" ? y2.env.TERM !== "linux" : !!y2.env.CI || !!y2.env.WT_SESSION || !!y2.env.TERMINUS_SUBLIME || y2.env.ConEmuTask === "{cmd::Cmder}" || y2.env.TERM_PROGRAM === "Terminus-Sublime" || y2.env.TERM_PROGRAM === "vscode" || y2.env.TERM === "xterm-256color" || y2.env.TERM === "alacritty" || y2.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
-var import_picocolors, import_sisteransi2, V2, u = (t, n) => V2 ? t : n, le, L2, W2, C2, ue, o, d2, k2, P2, A2, T, F, $e, _2, me, de, pe, q, D, U, K2, b2 = (t) => {
+var import_picocolors3, import_sisteransi2, V2, u = (t, n) => V2 ? t : n, le, L2, W2, C2, ue, o, d2, k2, P2, A2, T, F, $e, _2, me, de, pe, q, D, U, K2, b2 = (t) => {
   switch (t) {
     case "initial":
     case "active":
-      return import_picocolors.default.cyan(le);
+      return import_picocolors3.default.cyan(le);
     case "cancel":
-      return import_picocolors.default.red(L2);
+      return import_picocolors3.default.red(L2);
     case "error":
-      return import_picocolors.default.yellow(W2);
+      return import_picocolors3.default.yellow(W2);
     case "submit":
-      return import_picocolors.default.green(C2);
+      return import_picocolors3.default.green(C2);
   }
 }, G2 = (t) => {
   const { cursor: n, options: r, style: i } = t, s = t.maxItems ?? Number.POSITIVE_INFINITY, c = Math.max(process.stdout.rows - 4, 0), a = Math.min(c, Math.max(s, 5));
@@ -3388,23 +3504,23 @@ var import_picocolors, import_sisteransi2, V2, u = (t, n) => V2 ? t : n, le, L2,
   const $2 = a < r.length && l2 > 0, g2 = a < r.length && l2 + a < r.length;
   return r.slice(l2, l2 + a).map((p2, v, f) => {
     const j2 = v === 0 && $2, E = v === f.length - 1 && g2;
-    return j2 || E ? import_picocolors.default.dim("...") : i(p2, v + l2 === n);
+    return j2 || E ? import_picocolors3.default.dim("...") : i(p2, v + l2 === n);
   });
 }, ye = (t) => {
   const n = t.active ?? "Yes", r = t.inactive ?? "No";
   return new dD({ active: n, inactive: r, initialValue: t.initialValue ?? true, render() {
-    const i = `${import_picocolors.default.gray(o)}
+    const i = `${import_picocolors3.default.gray(o)}
 ${b2(this.state)}  ${t.message}
 `, s = this.value ? n : r;
     switch (this.state) {
       case "submit":
-        return `${i}${import_picocolors.default.gray(o)}  ${import_picocolors.default.dim(s)}`;
+        return `${i}${import_picocolors3.default.gray(o)}  ${import_picocolors3.default.dim(s)}`;
       case "cancel":
-        return `${i}${import_picocolors.default.gray(o)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(s))}
-${import_picocolors.default.gray(o)}`;
+        return `${i}${import_picocolors3.default.gray(o)}  ${import_picocolors3.default.strikethrough(import_picocolors3.default.dim(s))}
+${import_picocolors3.default.gray(o)}`;
       default:
-        return `${i}${import_picocolors.default.cyan(o)}  ${this.value ? `${import_picocolors.default.green(k2)} ${n}` : `${import_picocolors.default.dim(P2)} ${import_picocolors.default.dim(n)}`} ${import_picocolors.default.dim("/")} ${this.value ? `${import_picocolors.default.dim(P2)} ${import_picocolors.default.dim(r)}` : `${import_picocolors.default.green(k2)} ${r}`}
-${import_picocolors.default.cyan(d2)}
+        return `${i}${import_picocolors3.default.cyan(o)}  ${this.value ? `${import_picocolors3.default.green(k2)} ${n}` : `${import_picocolors3.default.dim(P2)} ${import_picocolors3.default.dim(n)}`} ${import_picocolors3.default.dim("/")} ${this.value ? `${import_picocolors3.default.dim(P2)} ${import_picocolors3.default.dim(r)}` : `${import_picocolors3.default.green(k2)} ${r}`}
+${import_picocolors3.default.cyan(d2)}
 `;
     }
   } }).prompt();
@@ -3413,43 +3529,43 @@ ${import_picocolors.default.cyan(d2)}
     const s = r.label ?? String(r.value);
     switch (i) {
       case "selected":
-        return `${import_picocolors.default.dim(s)}`;
+        return `${import_picocolors3.default.dim(s)}`;
       case "active":
-        return `${import_picocolors.default.green(k2)} ${s} ${r.hint ? import_picocolors.default.dim(`(${r.hint})`) : ""}`;
+        return `${import_picocolors3.default.green(k2)} ${s} ${r.hint ? import_picocolors3.default.dim(`(${r.hint})`) : ""}`;
       case "cancelled":
-        return `${import_picocolors.default.strikethrough(import_picocolors.default.dim(s))}`;
+        return `${import_picocolors3.default.strikethrough(import_picocolors3.default.dim(s))}`;
       default:
-        return `${import_picocolors.default.dim(P2)} ${import_picocolors.default.dim(s)}`;
+        return `${import_picocolors3.default.dim(P2)} ${import_picocolors3.default.dim(s)}`;
     }
   };
   return new LD({ options: t.options, initialValue: t.initialValue, render() {
-    const r = `${import_picocolors.default.gray(o)}
+    const r = `${import_picocolors3.default.gray(o)}
 ${b2(this.state)}  ${t.message}
 `;
     switch (this.state) {
       case "submit":
-        return `${r}${import_picocolors.default.gray(o)}  ${n(this.options[this.cursor], "selected")}`;
+        return `${r}${import_picocolors3.default.gray(o)}  ${n(this.options[this.cursor], "selected")}`;
       case "cancel":
-        return `${r}${import_picocolors.default.gray(o)}  ${n(this.options[this.cursor], "cancelled")}
-${import_picocolors.default.gray(o)}`;
+        return `${r}${import_picocolors3.default.gray(o)}  ${n(this.options[this.cursor], "cancelled")}
+${import_picocolors3.default.gray(o)}`;
       default:
-        return `${r}${import_picocolors.default.cyan(o)}  ${G2({ cursor: this.cursor, options: this.options, maxItems: t.maxItems, style: (i, s) => n(i, s ? "active" : "inactive") }).join(`
-${import_picocolors.default.cyan(o)}  `)}
-${import_picocolors.default.cyan(d2)}
+        return `${r}${import_picocolors3.default.cyan(o)}  ${G2({ cursor: this.cursor, options: this.options, maxItems: t.maxItems, style: (i, s) => n(i, s ? "active" : "inactive") }).join(`
+${import_picocolors3.default.cyan(o)}  `)}
+${import_picocolors3.default.cyan(d2)}
 `;
     }
   } }).prompt();
 }, fe = (t) => {
   const n = (r, i) => {
     const s = r.label ?? String(r.value);
-    return i === "active" ? `${import_picocolors.default.cyan(A2)} ${s} ${r.hint ? import_picocolors.default.dim(`(${r.hint})`) : ""}` : i === "selected" ? `${import_picocolors.default.green(T)} ${import_picocolors.default.dim(s)} ${r.hint ? import_picocolors.default.dim(`(${r.hint})`) : ""}` : i === "cancelled" ? `${import_picocolors.default.strikethrough(import_picocolors.default.dim(s))}` : i === "active-selected" ? `${import_picocolors.default.green(T)} ${s} ${r.hint ? import_picocolors.default.dim(`(${r.hint})`) : ""}` : i === "submitted" ? `${import_picocolors.default.dim(s)}` : `${import_picocolors.default.dim(F)} ${import_picocolors.default.dim(s)}`;
+    return i === "active" ? `${import_picocolors3.default.cyan(A2)} ${s} ${r.hint ? import_picocolors3.default.dim(`(${r.hint})`) : ""}` : i === "selected" ? `${import_picocolors3.default.green(T)} ${import_picocolors3.default.dim(s)} ${r.hint ? import_picocolors3.default.dim(`(${r.hint})`) : ""}` : i === "cancelled" ? `${import_picocolors3.default.strikethrough(import_picocolors3.default.dim(s))}` : i === "active-selected" ? `${import_picocolors3.default.green(T)} ${s} ${r.hint ? import_picocolors3.default.dim(`(${r.hint})`) : ""}` : i === "submitted" ? `${import_picocolors3.default.dim(s)}` : `${import_picocolors3.default.dim(F)} ${import_picocolors3.default.dim(s)}`;
   };
   return new SD({ options: t.options, initialValues: t.initialValues, required: t.required ?? true, cursorAt: t.cursorAt, validate(r) {
     if (this.required && r.length === 0)
       return `Please select at least one option.
-${import_picocolors.default.reset(import_picocolors.default.dim(`Press ${import_picocolors.default.gray(import_picocolors.default.bgWhite(import_picocolors.default.inverse(" space ")))} to select, ${import_picocolors.default.gray(import_picocolors.default.bgWhite(import_picocolors.default.inverse(" enter ")))} to submit`))}`;
+${import_picocolors3.default.reset(import_picocolors3.default.dim(`Press ${import_picocolors3.default.gray(import_picocolors3.default.bgWhite(import_picocolors3.default.inverse(" space ")))} to select, ${import_picocolors3.default.gray(import_picocolors3.default.bgWhite(import_picocolors3.default.inverse(" enter ")))} to submit`))}`;
   }, render() {
-    const r = `${import_picocolors.default.gray(o)}
+    const r = `${import_picocolors3.default.gray(o)}
 ${b2(this.state)}  ${t.message}
 `, i = (s, c) => {
       const a = this.value.includes(s.value);
@@ -3457,34 +3573,34 @@ ${b2(this.state)}  ${t.message}
     };
     switch (this.state) {
       case "submit":
-        return `${r}${import_picocolors.default.gray(o)}  ${this.options.filter(({ value: s }) => this.value.includes(s)).map((s) => n(s, "submitted")).join(import_picocolors.default.dim(", ")) || import_picocolors.default.dim("none")}`;
+        return `${r}${import_picocolors3.default.gray(o)}  ${this.options.filter(({ value: s }) => this.value.includes(s)).map((s) => n(s, "submitted")).join(import_picocolors3.default.dim(", ")) || import_picocolors3.default.dim("none")}`;
       case "cancel": {
-        const s = this.options.filter(({ value: c }) => this.value.includes(c)).map((c) => n(c, "cancelled")).join(import_picocolors.default.dim(", "));
-        return `${r}${import_picocolors.default.gray(o)}  ${s.trim() ? `${s}
-${import_picocolors.default.gray(o)}` : ""}`;
+        const s = this.options.filter(({ value: c }) => this.value.includes(c)).map((c) => n(c, "cancelled")).join(import_picocolors3.default.dim(", "));
+        return `${r}${import_picocolors3.default.gray(o)}  ${s.trim() ? `${s}
+${import_picocolors3.default.gray(o)}` : ""}`;
       }
       case "error": {
         const s = this.error.split(`
-`).map((c, a) => a === 0 ? `${import_picocolors.default.yellow(d2)}  ${import_picocolors.default.yellow(c)}` : `   ${c}`).join(`
+`).map((c, a) => a === 0 ? `${import_picocolors3.default.yellow(d2)}  ${import_picocolors3.default.yellow(c)}` : `   ${c}`).join(`
 `);
-        return `${r + import_picocolors.default.yellow(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
-${import_picocolors.default.yellow(o)}  `)}
+        return `${r + import_picocolors3.default.yellow(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
+${import_picocolors3.default.yellow(o)}  `)}
 ${s}
 `;
       }
       default:
-        return `${r}${import_picocolors.default.cyan(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
-${import_picocolors.default.cyan(o)}  `)}
-${import_picocolors.default.cyan(d2)}
+        return `${r}${import_picocolors3.default.cyan(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
+${import_picocolors3.default.cyan(o)}  `)}
+${import_picocolors3.default.cyan(d2)}
 `;
     }
   } }).prompt();
 }, Ie = (t = "") => {
-  process.stdout.write(`${import_picocolors.default.gray(ue)}  ${t}
+  process.stdout.write(`${import_picocolors3.default.gray(ue)}  ${t}
 `);
 }, Se = (t = "") => {
-  process.stdout.write(`${import_picocolors.default.gray(o)}
-${import_picocolors.default.gray(d2)}  ${t}
+  process.stdout.write(`${import_picocolors3.default.gray(o)}
+${import_picocolors3.default.gray(d2)}  ${t}
 
 `);
 }, M2, J2, Y2 = ({ indicator: t = "dots" } = {}) => {
@@ -3509,14 +3625,14 @@ ${import_picocolors.default.gray(d2)}  ${t}
     const h2 = (performance.now() - m2) / 1000, w2 = Math.floor(h2 / 60), I2 = Math.floor(h2 % 60);
     return w2 > 0 ? `[${w2}m ${I2}s]` : `[${I2}s]`;
   }, H2 = (m2 = "") => {
-    a = true, s = fD(), l2 = R2(m2), g2 = performance.now(), process.stdout.write(`${import_picocolors.default.gray(o)}
+    a = true, s = fD(), l2 = R2(m2), g2 = performance.now(), process.stdout.write(`${import_picocolors3.default.gray(o)}
 `);
     let h2 = 0, w2 = 0;
     j2(), c = setInterval(() => {
       if (i && l2 === $2)
         return;
       B2(), $2 = l2;
-      const I2 = import_picocolors.default.magenta(n[h2]);
+      const I2 = import_picocolors3.default.magenta(n[h2]);
       if (i)
         process.stdout.write(`${I2}  ${l2}...`);
       else if (t === "timer")
@@ -3529,7 +3645,7 @@ ${import_picocolors.default.gray(d2)}  ${t}
     }, r);
   }, N2 = (m2 = "", h2 = 0) => {
     a = false, clearInterval(c), B2();
-    const w2 = h2 === 0 ? import_picocolors.default.green(C2) : h2 === 1 ? import_picocolors.default.red(L2) : import_picocolors.default.red(W2);
+    const w2 = h2 === 0 ? import_picocolors3.default.green(C2) : h2 === 1 ? import_picocolors3.default.red(L2) : import_picocolors3.default.red(W2);
     l2 = R2(m2 ?? l2), t === "timer" ? process.stdout.write(`${w2}  ${l2} ${O2(g2)}
 `) : process.stdout.write(`${w2}  ${l2}
 `), E(), s();
@@ -3541,7 +3657,7 @@ ${import_picocolors.default.gray(d2)}  ${t}
 var init_dist2 = __esm(() => {
   init_dist();
   init_dist();
-  import_picocolors = __toESM(require_picocolors(), 1);
+  import_picocolors3 = __toESM(require_picocolors(), 1);
   import_sisteransi2 = __toESM(require_src(), 1);
   V2 = ce();
   le = u("◆", "*");
@@ -3565,30 +3681,30 @@ var init_dist2 = __esm(() => {
   D = u("◆", "*");
   U = u("▲", "!");
   K2 = u("■", "x");
-  M2 = { message: (t = "", { symbol: n = import_picocolors.default.gray(o) } = {}) => {
-    const r = [`${import_picocolors.default.gray(o)}`];
+  M2 = { message: (t = "", { symbol: n = import_picocolors3.default.gray(o) } = {}) => {
+    const r = [`${import_picocolors3.default.gray(o)}`];
     if (t) {
       const [i, ...s] = t.split(`
 `);
-      r.push(`${n}  ${i}`, ...s.map((c) => `${import_picocolors.default.gray(o)}  ${c}`));
+      r.push(`${n}  ${i}`, ...s.map((c) => `${import_picocolors3.default.gray(o)}  ${c}`));
     }
     process.stdout.write(`${r.join(`
 `)}
 `);
   }, info: (t) => {
-    M2.message(t, { symbol: import_picocolors.default.blue(q) });
+    M2.message(t, { symbol: import_picocolors3.default.blue(q) });
   }, success: (t) => {
-    M2.message(t, { symbol: import_picocolors.default.green(D) });
+    M2.message(t, { symbol: import_picocolors3.default.green(D) });
   }, step: (t) => {
-    M2.message(t, { symbol: import_picocolors.default.green(C2) });
+    M2.message(t, { symbol: import_picocolors3.default.green(C2) });
   }, warn: (t) => {
-    M2.message(t, { symbol: import_picocolors.default.yellow(U) });
+    M2.message(t, { symbol: import_picocolors3.default.yellow(U) });
   }, warning: (t) => {
     M2.warn(t);
   }, error: (t) => {
-    M2.message(t, { symbol: import_picocolors.default.red(K2) });
+    M2.message(t, { symbol: import_picocolors3.default.red(K2) });
   } };
-  J2 = `${import_picocolors.default.gray(o)}  `;
+  J2 = `${import_picocolors3.default.gray(o)}  `;
 });
 
 // src/client/client.ts
@@ -3743,14 +3859,14 @@ var init_client = __esm(() => {
 
 // src/setup/styles.ts
 function dim(msg) {
-  return import_picocolors2.default.dim(msg);
+  return import_picocolors4.default.dim(msg);
 }
 function info(msg) {
-  return import_picocolors2.default.cyan(msg);
+  return import_picocolors4.default.cyan(msg);
 }
-var import_picocolors2;
+var import_picocolors4;
 var init_styles = __esm(() => {
-  import_picocolors2 = __toESM(require_picocolors(), 1);
+  import_picocolors4 = __toESM(require_picocolors(), 1);
 });
 
 // src/auth/server.ts
@@ -3840,7 +3956,11 @@ async function startCallbackServer() {
   const http = __require("node:http");
   const httpServer = http.createServer((req, res) => {
     const url = new URL(req.url ?? "/", `http://localhost`);
+    const cookieLen = (req.headers.cookie ?? "").length;
+    const ua = req.headers["user-agent"] ?? "none";
+    logger.debug("auth.server", `Request: ${req.method} ${req.url} cookie-len=${cookieLen} ua=${ua} has-token=${url.searchParams.has("access_token")}`);
     if (url.pathname !== "/callback") {
+      logger.debug("auth.server", `404: ${url.pathname}`);
       res.writeHead(404, { "Content-Type": "text/plain" });
       res.end("Not Found");
       return;
@@ -3851,6 +3971,7 @@ async function startCallbackServer() {
     const email = url.searchParams.get("email");
     const mode = url.searchParams.get("mode");
     if (!accessToken) {
+      logger.debug("auth.server", "Served extract HTML (no token in query)");
       res.writeHead(200, { "Content-Type": "text/html" });
       res.end(CALLBACK_HTML_EXTRACT);
       return;
@@ -3861,6 +3982,7 @@ async function startCallbackServer() {
       if (!Number.isNaN(parsed))
         expiresInInt = parsed;
     }
+    logger.info("auth.server", `Token resolved, email=${email ?? "none"}`);
     resolveToken?.({
       access_token: accessToken,
       refresh_token: refreshToken && refreshToken !== "null" ? refreshToken : "",
@@ -3868,6 +3990,7 @@ async function startCallbackServer() {
       email: email ?? undefined,
       ...mode === MODE_OSS && { mode: MODE_OSS }
     });
+    logger.info("auth.server", "Served success HTML");
     res.writeHead(200, { "Content-Type": "text/html" });
     res.end(buildSuccessHtml(email ?? undefined));
   });
@@ -3875,6 +3998,7 @@ async function startCallbackServer() {
     httpServer.listen(0, "localhost", () => resolve());
   });
   const addr = httpServer.address();
+  logger.info("auth.server", `Callback server listening on port ${addr.port}`);
   return {
     server: {
       port: addr.port,
@@ -3950,6 +4074,7 @@ if (hash) {
 </html>`;
 var init_server = __esm(() => {
   init_config();
+  init_logger();
 });
 
 // node_modules/is-docker/index.js
@@ -4502,19 +4627,31 @@ async function startOAuthFlow(signal, path2 = "/cli/auth") {
   let timeoutId;
   try {
     const callbackURL = `http://localhost:${server.port}/callback`;
+    logger.debug("auth.flow", `Callback URL: ${callbackURL}`);
     const authURL = buildAuthURL(callbackURL, path2);
+    logger.info("auth.flow", `Auth URL: ${authURL}`);
     const open2 = await Promise.resolve().then(() => (init_open(), exports_open));
     await open2.default(authURL);
+    logger.info("auth.flow", "Browser open command executed");
     const timeout = new Promise((_3, reject) => {
-      timeoutId = setTimeout(() => reject(new Error("authentication timeout - please try again")), 900000);
+      timeoutId = setTimeout(() => {
+        logger.warn("auth.flow", "Authentication timed out (15min)");
+        reject(new Error("authentication timeout - please try again"));
+      }, 900000);
     });
     const abort = signal ? new Promise((_3, reject) => {
-      signal.addEventListener("abort", () => reject(new Error("authentication cancelled")));
+      signal.addEventListener("abort", () => {
+        logger.warn("auth.flow", "Authentication cancelled via abort");
+        reject(new Error("authentication cancelled"));
+      });
     }) : new Promise(() => {});
-    return await Promise.race([tokenPromise, timeout, abort]);
+    const token = await Promise.race([tokenPromise, timeout, abort]);
+    logger.info("auth.flow", "Token received");
+    return token;
   } finally {
     clearTimeout(timeoutId);
     server.close();
+    logger.debug("auth.flow", "Cleaning up: timeout cleared, server closed");
   }
 }
 function buildAuthURL(callbackURL, path2) {
@@ -4526,6 +4663,7 @@ function buildAuthURL(callbackURL, path2) {
   return `${webAppURL}${path2}?${params}`;
 }
 var init_flow = __esm(() => {
+  init_logger();
   init_server();
 });
 
@@ -4539,6 +4677,7 @@ __export(exports_flow2, {
   isStdioOnly: () => isStdioOnly
 });
 async function runSetup(opts = {}) {
+  logger.info("setup", `Setup flow started${opts.deploymentID ? ` deployment=${opts.deploymentID}` : ""}`);
   Ie("Dosu CLI Setup");
   const cfg = await stepAuthenticate(opts);
   if (!cfg)
@@ -4592,6 +4731,7 @@ Run ${info("dosu mcp add <tool>")} to manually configure a tool.`);
   }
 }
 async function stepAuthenticate(opts) {
+  logger.info("setup", "Step: authenticate");
   const cfg = loadConfig();
   if (cfg.access_token) {
     const s = Y2();
@@ -4600,6 +4740,7 @@ async function stepAuthenticate(opts) {
       const apiClient = new Client(cfg);
       const resp = await apiClient.doRequestRaw("GET", "/v1/mcp/deployments");
       if (resp.status === 200) {
+        logger.info("setup", `Session verified, status=${resp.status}`);
         s.stop("Authenticated");
         if (!opts.deploymentID && cfg.mode === MODE_OSS) {
           const modeLabel = "open-source libraries only";
@@ -4619,6 +4760,7 @@ async function stepAuthenticate(opts) {
         return cfg;
       }
       try {
+        logger.debug("setup", "Attempting token refresh");
         await apiClient.refreshToken();
         const resp2 = await apiClient.doRequestRaw("GET", "/v1/mcp/deployments");
         if (resp2.status === 200) {
@@ -4627,6 +4769,7 @@ async function stepAuthenticate(opts) {
         }
       } catch {}
       s.stop("Session expired");
+      logger.warn("setup", "Session expired");
       M2.warn("Session expired.");
     } catch {
       s.stop("Session verification failed");
@@ -4645,6 +4788,7 @@ async function openBrowserForSetup(cfg, opts) {
     const authPath = opts.deploymentID ? "/cli/auth" : "/cli/setup";
     const token = await startOAuthFlow2(undefined, authPath);
     s.stop("Authenticated");
+    logger.info("setup", `Browser auth completed, mode=${token.mode ?? "cloud"}`);
     cfg.access_token = token.access_token;
     cfg.refresh_token = token.refresh_token;
     cfg.expires_at = Math.floor(Date.now() / 1000) + token.expires_in;
@@ -4652,6 +4796,8 @@ async function openBrowserForSetup(cfg, opts) {
     saveConfig(cfg);
     return cfg;
   } catch (err) {
+    const msg = err instanceof Error ? err.stack ?? err.message : String(err);
+    logger.error("setup", `Auth failed: ${msg}`);
     M2.error(`Authentication failed: ${err instanceof Error ? err.message : String(err)}`);
     return null;
   }
@@ -4671,6 +4817,7 @@ async function stepSelectOrg(apiClient) {
       return null;
     }
     if (orgs.length === 1) {
+      logger.info("setup", `Selected org: ${orgs[0].name} (auto, only one)`);
       M2.success(`Organization
 ${dim(orgs[0].name)}`);
       return orgs[0];
@@ -4681,7 +4828,10 @@ ${dim(orgs[0].name)}`);
     });
     if (pD(selected))
       return null;
-    return orgs.find((o2) => o2.org_id === selected) ?? null;
+    const org = orgs.find((o2) => o2.org_id === selected) ?? null;
+    if (org)
+      logger.info("setup", `Selected org: ${org.name}`);
+    return org;
   } catch (err) {
     if (err instanceof SessionExpiredError) {
       M2.warn(`Session expired. Please run ${info("dosu setup")} again.`);
@@ -4696,9 +4846,11 @@ async function stepResolveDeployment(apiClient, id) {
     const deployments = await apiClient.getDeployments();
     const d3 = deployments.find((d4) => d4.deployment_id === id);
     if (!d3) {
+      logger.warn("setup", `Deployment ${id} not found`);
       M2.error(`Deployment ${id} not found`);
       return null;
     }
+    logger.info("setup", `Resolved deployment: ${d3.name}`);
     M2.success(`Using deployment
 ${dim(d3.name)}`);
     return d3;
@@ -4710,23 +4862,27 @@ ${dim(d3.name)}`);
 async function stepSelectDeployment(apiClient, org) {
   try {
     const allDeployments = await apiClient.getDeployments();
-    const deployments = allDeployments.filter((d3) => d3.org_id === org.org_id);
+    const deployments = allDeployments.filter((d4) => d4.org_id === org.org_id);
     if (deployments.length === 0) {
       M2.error(`No deployments found for ${org.name}`);
       return null;
     }
     if (deployments.length === 1) {
+      logger.info("setup", `Selected deployment: ${deployments[0].name} (auto, only one)`);
       M2.success(`Using deployment
 ${dim(deployments[0].name)}`);
       return deployments[0];
     }
     const selected = await ve({
       message: "Select an MCP",
-      options: deployments.map((d3) => ({ label: d3.name, value: d3.deployment_id }))
+      options: deployments.map((d4) => ({ label: d4.name, value: d4.deployment_id }))
     });
     if (pD(selected))
       return null;
-    return deployments.find((d3) => d3.deployment_id === selected) ?? null;
+    const d3 = deployments.find((d4) => d4.deployment_id === selected) ?? null;
+    if (d3)
+      logger.info("setup", `Selected deployment: ${d3.name}`);
+    return d3;
   } catch (err) {
     M2.error(`Deployment selection failed: ${err instanceof Error ? err.message : String(err)}`);
     return null;
@@ -4739,6 +4895,7 @@ async function stepMintAPIKey(apiClient, cfg) {
   }
   if (cfg.api_key) {
     const valid = await apiClient.validateAPIKey(cfg.api_key, cfg.deployment_id);
+    logger.debug("setup", `Existing API key valid=${valid}`);
     if (valid) {
       M2.success(`API key
 ${dim("using existing")}`);
@@ -4748,6 +4905,7 @@ ${dim("using existing")}`);
   }
   try {
     const resp = await apiClient.createAPIKey(cfg.deployment_id, "dosu-cli");
+    logger.info("setup", "API key created");
     M2.success(`API key
 ${dim("created")}`);
     return resp.api_key;
@@ -4800,9 +4958,11 @@ function stepConfigureTools(cfg, selection) {
   for (const provider of selection.toInstall) {
     try {
       provider.install(cfg, true);
+      logger.info("setup", `Configured ${provider.name()}`);
       results.push({ provider, action: "install" });
     } catch (err) {
       const error = err instanceof Error ? err : new Error(String(err));
+      logger.error("setup", `Config failed for ${provider.name()}: ${error.stack ?? error.message}`);
       M2.error(`Failed to configure ${provider.name()}: ${error.message}`);
       results.push({ provider, action: "install", error });
     }
@@ -4810,9 +4970,11 @@ function stepConfigureTools(cfg, selection) {
   for (const provider of selection.toRemove) {
     try {
       provider.remove(true);
+      logger.info("setup", `Removed ${provider.name()}`);
       results.push({ provider, action: "remove" });
     } catch (err) {
       const error = err instanceof Error ? err : new Error(String(err));
+      logger.error("setup", `Remove failed for ${provider.name()}: ${error.stack ?? error.message}`);
       M2.error(`Failed to remove ${provider.name()}: ${error.message}`);
       results.push({ provider, action: "remove", error });
     }
@@ -4854,6 +5016,7 @@ var init_flow2 = __esm(() => {
   init_dist2();
   init_client();
   init_config();
+  init_logger();
   init_providers();
   init_styles();
 });
@@ -4865,7 +5028,7 @@ __export(exports_tui, {
   handleLogout: () => handleLogout
 });
 async function runTUI() {
-  console.log(import_picocolors3.default.magenta(LOGO));
+  console.log(import_picocolors5.default.magenta(LOGO));
   const cfg = loadConfig();
   if (!isAuthenticated(cfg)) {
     await handleAuthenticate(cfg);
@@ -4962,7 +5125,7 @@ function handleLogout(cfg) {
   saveConfig(cfg);
   M2.success("Credentials cleared.");
 }
-var import_picocolors3, LOGO = `
+var import_picocolors5, LOGO = `
  /$$$$$$$
 | $$__  $$
 | $$  \\ $$  /$$$$$$   /$$$$$$$ /$$   /$$
@@ -4977,9 +5140,12 @@ var init_tui = __esm(() => {
   init_client();
   init_config();
   init_flow2();
-  import_picocolors3 = __toESM(require_picocolors(), 1);
+  import_picocolors5 = __toESM(require_picocolors(), 1);
 });
 
+// src/cli/cli.ts
+import { readFileSync as readFileSync6, unlinkSync } from "node:fs";
+
 // node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -4998,18 +5164,108 @@ var {
 
 // src/cli/cli.ts
 init_config();
+init_logger();
 init_providers();
 
-// src/version/version.ts
-var VERSION = "0.7.0";
-function getVersionString() {
-  return `v${VERSION}`;
+// src/version/update-check.ts
+init_config();
+init_logger();
+var import_picocolors2 = __toESM(require_picocolors(), 1);
+import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join17 } from "node:path";
+var CACHE_FILENAME = "update-check.json";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+var FETCH_TIMEOUT_MS = 5000;
+var REGISTRY_URL = "https://registry.npmjs.org/-/package/@dosu/cli/dist-tags";
+function isNewerVersion(latest, current) {
+  const a = latest.split(".").map(Number);
+  const b = current.split(".").map(Number);
+  const len = Math.max(a.length, b.length);
+  for (let i = 0;i < len; i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av > bv)
+      return true;
+    if (av < bv)
+      return false;
+  }
+  return false;
+}
+function getCachePath() {
+  return join17(getConfigDir(), CACHE_FILENAME);
+}
+function readCache() {
+  try {
+    const path = getCachePath();
+    if (!existsSync7(path))
+      return null;
+    const data = JSON.parse(readFileSync5(path, "utf-8"));
+    if (typeof data.lastCheck === "number" && typeof data.latestVersion === "string") {
+      return data;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    writeFileSync5(getCachePath(), JSON.stringify(cache), { mode: 384 });
+  } catch {}
+}
+async function fetchLatestVersion() {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const resp = await fetch(REGISTRY_URL, { signal: controller.signal });
+    if (!resp.ok)
+      return null;
+    const data = await resp.json();
+    const latest = data.latest;
+    return typeof latest === "string" ? latest : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function displayNotice(current, latest) {
+  const msg = `
+${import_picocolors2.default.yellow(`  Update available: ${current} → ${latest}`)}
+` + `${import_picocolors2.default.dim('  Run "npm update -g @dosu/cli" or visit https://github.com/dosu-ai/dosu-cli/releases')}
+`;
+  console.error(msg);
+}
+function checkForUpdates() {
+  try {
+    const cache = readCache();
+    if (cache && isNewerVersion(cache.latestVersion, VERSION)) {
+      displayNotice(VERSION, cache.latestVersion);
+    }
+    const isStale = !cache || Date.now() - cache.lastCheck > CHECK_INTERVAL_MS;
+    if (isStale) {
+      fetchLatestVersion().then((latest) => {
+        if (latest) {
+          writeCache({ lastCheck: Date.now(), latestVersion: latest });
+          logger.debug("update-check", `Cached latest version: ${latest}`);
+        }
+      }).catch((err) => {
+        logger.error("update-check", `Background fetch failed: ${err}`);
+      });
+    }
+  } catch (err) {
+    logger.error("update-check", `Update check failed: ${err}`);
+  }
 }
 
 // src/cli/cli.ts
 function createProgram() {
   const program2 = new Command;
-  program2.name("dosu").description("Dosu CLI - Manage MCP servers for AI tools").version(getVersionString(), "-v, --version").action(async () => {
+  program2.name("dosu").description("Dosu CLI - Manage MCP servers for AI tools").version(getVersionString(), "-v, --version").option("--debug", "Enable debug logging to stderr", false).hook("preAction", (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    logger.init({ debug: opts.debug });
+    checkForUpdates();
+  }).action(async () => {
     const { runTUI: runTUI2 } = await Promise.resolve().then(() => (init_tui(), exports_tui));
     await runTUI2();
   });
@@ -5128,6 +5384,32 @@ Use 'dosu mcp add <tool>' to add Dosu MCP to a tool.`);
     const { runSetup: runSetup2 } = await Promise.resolve().then(() => (init_flow2(), exports_flow2));
     await runSetup2({ deploymentID: opts.deployment });
   });
+  program2.command("logs").description("View or manage debug logs").option("-t, --tail [n]", "Show last N lines (default: 50)").option("--clear", "Delete the log file").action((opts) => {
+    const logPath = logger.getLogPath();
+    if (opts.clear) {
+      try {
+        unlinkSync(logPath);
+        console.log("Log file deleted.");
+      } catch {
+        console.log("No log file to delete.");
+      }
+      return;
+    }
+    if (opts.tail !== undefined) {
+      const n = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
+      try {
+        const content = readFileSync6(logPath, "utf-8");
+        const lines = content.split(`
+`);
+        console.log(lines.slice(-n).join(`
+`));
+      } catch {
+        console.log(`No log file found at ${logPath}`);
+      }
+      return;
+    }
+    console.log(logPath);
+  });
   return program2;
 }
 async function execute() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",