@dosu/cli 0.19.3 → 0.20.1

package/bin/dosu.js

@@ -4548,7 +4548,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.19.3";
+var VERSION = "0.20.1";
 
 // src/debug/logger.ts
 import {
@@ -6473,6 +6473,121 @@ var init_codex = __esm(() => {
   };
 });
 
+// src/hooks/factory.ts
+var exports_factory = {};
+__export(exports_factory, {
+  removeFactoryHooks: () => removeFactoryHooks,
+  installFactoryHooks: () => installFactoryHooks,
+  inspectFactoryHooks: () => inspectFactoryHooks,
+  factoryHooksPath: () => factoryHooksPath,
+  factoryHookCommand: () => factoryHookCommand
+});
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "node:fs";
+import { join as join6 } from "node:path";
+function factoryHooksPath(dir) {
+  return join6(dir, ".factory", "hooks.json");
+}
+function factoryHookCommand(subcommand) {
+  return `dosu hooks ${subcommand} --agent factory`;
+}
+function dosuGroup3(event) {
+  const group = {
+    hooks: [{ type: "command", command: factoryHookCommand(EVENT_SUBCOMMAND3[event]) }]
+  };
+  if (event === "PostToolUse")
+    group.matcher = "*";
+  return group;
+}
+function readHooksFileOrThrow2(path) {
+  if (!existsSync7(path))
+    return {};
+  const raw = readFileSync8(path, "utf-8").trim();
+  if (!raw)
+    return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`refusing to modify ${path}: file exists but is not valid JSON`);
+  }
+}
+function installFactoryHooks(configPath, opts = {}) {
+  const config = readHooksFileOrThrow2(configPath);
+  const events = DEFAULT_HOOK_EVENTS.filter((e2) => e2 !== "Stop" || opts.stop !== false);
+  const hooks = typeof config.hooks === "object" && config.hooks ? config.hooks : {};
+  for (const event of events) {
+    const groups = Array.isArray(hooks[event]) ? hooks[event] : [];
+    const kept = groups.filter((g2) => !isDosuGroup(g2));
+    kept.push(dosuGroup3(event));
+    hooks[event] = kept;
+  }
+  for (const event of DEFAULT_HOOK_EVENTS) {
+    if (!events.includes(event) && Array.isArray(hooks[event])) {
+      const kept = hooks[event].filter((g2) => !isDosuGroup(g2));
+      if (kept.length > 0)
+        hooks[event] = kept;
+      else
+        delete hooks[event];
+    }
+  }
+  config.hooks = hooks;
+  saveJSONConfig(configPath, config);
+  return { events: [...events] };
+}
+function removeFactoryHooks(configPath) {
+  if (!existsSync7(configPath))
+    return { removed: false };
+  let config;
+  try {
+    config = readHooksFileOrThrow2(configPath);
+  } catch {
+    return { removed: false };
+  }
+  const hooks = config.hooks;
+  if (typeof hooks !== "object" || !hooks)
+    return { removed: false };
+  let removed = false;
+  for (const event of Object.keys(hooks)) {
+    if (!Array.isArray(hooks[event]))
+      continue;
+    const kept = hooks[event].filter((g2) => !isDosuGroup(g2));
+    if (kept.length !== hooks[event].length) {
+      removed = true;
+      if (kept.length > 0)
+        hooks[event] = kept;
+      else
+        delete hooks[event];
+    }
+  }
+  if (removed)
+    saveJSONConfig(configPath, config);
+  return { removed };
+}
+function inspectFactoryHooks(configPath) {
+  if (!existsSync7(configPath))
+    return { fileExists: false, events: [] };
+  let config;
+  try {
+    config = readHooksFileOrThrow2(configPath);
+  } catch {
+    return { fileExists: true, parseError: true, events: [] };
+  }
+  const hooks = config.hooks;
+  if (typeof hooks !== "object" || !hooks)
+    return { fileExists: true, events: [] };
+  const events = Object.keys(hooks).filter((event) => Array.isArray(hooks[event]) && hooks[event].some((g2) => isDosuGroup(g2)));
+  return { fileExists: true, events };
+}
+var EVENT_SUBCOMMAND3;
+var init_factory = __esm(() => {
+  init_config_helpers();
+  init_claude_code();
+  EVENT_SUBCOMMAND3 = {
+    UserPromptSubmit: "user-prompt-submit",
+    PostToolUse: "post-tool-use",
+    Stop: "stop"
+  };
+});
+
 // src/insights/insights.ts
 async function buildInsights({
   client,
@@ -7561,17 +7676,17 @@ var init_insights2 = __esm(() => {
 });
 
 // src/version/skill-update-check.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join7 } from "node:path";
 function getCachePath() {
-  return join6(getConfigDir(), CACHE_FILENAME);
+  return join7(getConfigDir(), CACHE_FILENAME);
 }
 function readSkillCache() {
   try {
     const path = getCachePath();
-    if (!existsSync7(path))
+    if (!existsSync8(path))
       return null;
-    const data = JSON.parse(readFileSync9(path, "utf-8"));
+    const data = JSON.parse(readFileSync10(path, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
       return data;
     }
@@ -7583,7 +7698,7 @@ function readSkillCache() {
 function writeSkillCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync7(dir)) {
+    if (!existsSync8(dir)) {
       mkdirSync5(dir, { recursive: true, mode: 448 });
     }
     writeFileSync4(getCachePath(), JSON.stringify(cache), { mode: 384 });
@@ -7760,21 +7875,21 @@ var init_skill = __esm(() => {
 var MCP_PROVIDER_SLUG = "dosu_mcp";
 
 // src/mcp/detect.ts
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { homedir, platform } from "node:os";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 function isInstalled(paths) {
-  return paths.some((p2) => existsSync8(expandHome(p2)));
+  return paths.some((p2) => existsSync9(expandHome(p2)));
 }
 function expandHome(path) {
   if (!path.startsWith("~"))
     return path;
-  return join7(homedir(), path.slice(1));
+  return join8(homedir(), path.slice(1));
 }
 function appSupportDir() {
   switch (platform()) {
     case "darwin": {
-      return join7(homedir(), "Library", "Application Support");
+      return join8(homedir(), "Library", "Application Support");
     }
     case "win32": {
       return process.env.APPDATA ?? "";
@@ -7783,7 +7898,7 @@ function appSupportDir() {
       const xdg = process.env.XDG_CONFIG_HOME;
       if (xdg)
         return xdg;
-      return join7(homedir(), ".config");
+      return join8(homedir(), ".config");
     }
   }
 }
@@ -7864,7 +7979,7 @@ var init_antigravity = __esm(() => {
 });
 
 // src/mcp/providers/claude.ts
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 var ClaudeProvider = () => createJSONProvider({
   providerName: "Claude Code",
   providerID: "claude",
@@ -7873,22 +7988,22 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join8(cwd, ".mcp.json")
+  localConfigPath: (cwd) => join9(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/claude-desktop.ts
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
   supportsLocal: () => false,
   priority: () => 2,
-  detectPaths: () => [join9(appSupportDir(), "Claude")],
-  isInstalled: () => isInstalled([join9(appSupportDir(), "Claude")]),
-  globalConfigPath: () => join9(appSupportDir(), "Claude", "claude_desktop_config.json"),
+  detectPaths: () => [join10(appSupportDir(), "Claude")],
+  isInstalled: () => isInstalled([join10(appSupportDir(), "Claude")]),
+  globalConfigPath: () => join10(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");
@@ -7902,14 +8017,14 @@ var init_claude_desktop = __esm(() => {
 });
 
 // src/mcp/providers/cline.ts
-import { join as join10 } from "node:path";
-var extensionDir = () => join10(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
+import { join as join11 } from "node:path";
+var extensionDir = () => join11(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
   providerName: "Cline",
   providerID: "cline",
   local: false,
   priorityValue: 11,
   paths: [extensionDir()],
-  globalPath: join10(extensionDir(), "settings", "cline_mcp_settings.json"),
+  globalPath: join11(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -7925,7 +8040,7 @@ var init_cline = __esm(() => {
 });
 
 // src/mcp/providers/cline-cli.ts
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function clineDir() {
   return process.env.CLINE_DIR ?? expandHome("~/.cline");
 }
@@ -7935,7 +8050,7 @@ var ClineCliProvider = () => createJSONProvider({
   local: false,
   priorityValue: 12,
   paths: [clineDir()],
-  globalPath: join11(clineDir(), "data", "settings", "cline_mcp_settings.json"),
+  globalPath: join12(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -7951,20 +8066,20 @@ var init_cline_cli = __esm(() => {
 });
 
 // src/mcp/providers/codex.ts
-import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
-import { join as join12 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "node:fs";
+import { join as join13 } from "node:path";
 function codexHome() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
 function getConfigPath2(global) {
   if (global)
-    return join12(codexHome(), "config.toml");
-  return join12(process.cwd(), ".codex", "config.toml");
+    return join13(codexHome(), "config.toml");
+  return join13(process.cwd(), ".codex", "config.toml");
 }
 function readTOML(path) {
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return "";
-  return readFileSync10(path, "utf-8");
+  return readFileSync11(path, "utf-8");
 }
 function writeTOML(path, content) {
   writeSecureFile(path, content);
@@ -8022,9 +8137,9 @@ var CodexProvider = () => ({
   priority: () => 8,
   detectPaths: () => ["~/.codex"],
   isInstalled: () => isInstalled(["~/.codex"]),
-  globalConfigPath: () => join12(codexHome(), "config.toml"),
+  globalConfigPath: () => join13(codexHome(), "config.toml"),
   isConfigured: () => {
-    const content = readTOML(join12(codexHome(), "config.toml"));
+    const content = readTOML(join13(codexHome(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
   install(cfg, global) {
@@ -8046,10 +8161,10 @@ var init_codex2 = __esm(() => {
 });
 
 // src/mcp/providers/copilot.ts
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
-    return join13(process.env.XDG_CONFIG_HOME, "mcp-config.json");
+    return join14(process.env.XDG_CONFIG_HOME, "mcp-config.json");
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
@@ -8080,7 +8195,7 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath = join13(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join14(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url,
@@ -8093,7 +8208,7 @@ var CopilotProvider = () => ({
     if (global) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath = join13(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join14(process.cwd(), ".vscode", "mcp.json");
       removeJSONServer(configPath, "servers");
     }
   }
@@ -8105,7 +8220,7 @@ var init_copilot = __esm(() => {
 });
 
 // src/mcp/providers/cursor.ts
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 var CursorProvider = () => createJSONProvider({
   providerName: "Cursor",
   providerID: "cursor",
@@ -8118,15 +8233,31 @@ var CursorProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join14(cwd, ".cursor", "mcp.json")
+  localConfigPath: (cwd) => join15(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
   init_config_helpers();
   init_base();
 });
 
+// src/mcp/providers/factory.ts
+import { join as join16 } from "node:path";
+var FactoryProvider = () => createJSONProvider({
+  providerName: "Factory",
+  providerID: "factory",
+  local: true,
+  priorityValue: 17,
+  paths: ["~/.factory"],
+  globalPath: "~/.factory/mcp.json",
+  topKey: "mcpServers",
+  localConfigPath: (cwd) => join16(cwd, ".factory", "mcp.json")
+});
+var init_factory2 = __esm(() => {
+  init_base();
+});
+
 // src/mcp/providers/gemini.ts
-import { join as join15 } from "node:path";
+import { join as join17 } from "node:path";
 var GeminiProvider = () => createJSONProvider({
   providerName: "Gemini CLI",
   providerID: "gemini",
@@ -8135,7 +8266,7 @@ var GeminiProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/settings.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join15(cwd, ".gemini", "settings.json")
+  localConfigPath: (cwd) => join17(cwd, ".gemini", "settings.json")
 });
 var init_gemini = __esm(() => {
   init_base();
@@ -8185,14 +8316,14 @@ var init_manual = __esm(() => {
 });
 
 // src/mcp/providers/mcporter.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { join as join18 } from "node:path";
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
-  if (existsSync10(jsonPath))
+  if (existsSync11(jsonPath))
     return jsonPath;
   const jsoncPath = expandHome("~/.mcporter/mcporter.jsonc");
-  if (existsSync10(jsoncPath))
+  if (existsSync11(jsoncPath))
     return jsoncPath;
   return jsonPath;
 }
@@ -8213,7 +8344,7 @@ var MCPorterProvider = () => ({
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
   install(cfg, global) {
-    const configPath = global ? resolveGlobalConfigPath() : join16(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join18(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: mcpEndpoint4(cfg),
@@ -8222,7 +8353,7 @@ var MCPorterProvider = () => ({
     installJSONServer(configPath, "mcpServers", server);
   },
   remove(global) {
-    const configPath = global ? resolveGlobalConfigPath() : join16(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join18(process.cwd(), "config", "mcporter.json");
     removeJSONServer(configPath, "mcpServers");
   }
 });
@@ -8233,7 +8364,7 @@ var init_mcporter = __esm(() => {
 });
 
 // src/mcp/providers/opencode.ts
-import { join as join17 } from "node:path";
+import { join as join19 } from "node:path";
 var OpenCodeProvider = () => createJSONProvider({
   providerName: "OpenCode",
   providerID: "opencode",
@@ -8248,7 +8379,7 @@ var OpenCodeProvider = () => createJSONProvider({
     enabled: true,
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join17(cwd, "opencode.json")
+  localConfigPath: (cwd) => join19(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
   init_config_helpers();
@@ -8256,16 +8387,16 @@ var init_opencode = __esm(() => {
 });
 
 // src/mcp/providers/vscode.ts
-import { join as join18 } from "node:path";
+import { join as join20 } from "node:path";
 var VSCodeProvider = () => createJSONProvider({
   providerName: "VS Code",
   providerID: "vscode",
   local: true,
   priorityValue: 6,
-  paths: [join18(appSupportDir(), "Code")],
-  globalPath: join18(appSupportDir(), "Code", "User", "mcp.json"),
+  paths: [join20(appSupportDir(), "Code")],
+  globalPath: join20(appSupportDir(), "Code", "User", "mcp.json"),
   topKey: "servers",
-  localConfigPath: (cwd) => join18(cwd, ".vscode", "mcp.json")
+  localConfigPath: (cwd) => join20(cwd, ".vscode", "mcp.json")
 });
 var init_vscode = __esm(() => {
   init_detect();
@@ -8274,14 +8405,14 @@ var init_vscode = __esm(() => {
 
 // src/mcp/providers/windsurf.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join19 } from "node:path";
+import { join as join21 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join19(homedir2(), ".codeium", "windsurf")],
-  globalPath: join19(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join21(homedir2(), ".codeium", "windsurf")],
+  globalPath: join21(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -8290,12 +8421,12 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { platform as platform2 } from "node:os";
-import { join as join20 } from "node:path";
+import { join as join22 } from "node:path";
 function zedConfigDir() {
   const os = platform2();
   if (os === "darwin" || os === "win32")
-    return join20(appSupportDir(), "Zed");
-  return join20(appSupportDir(), "zed");
+    return join22(appSupportDir(), "Zed");
+  return join22(appSupportDir(), "zed");
 }
 var ZedProvider = () => createJSONProvider({
   providerName: "Zed",
@@ -8303,7 +8434,7 @@ var ZedProvider = () => createJSONProvider({
   local: true,
   priorityValue: 10,
   paths: [zedConfigDir()],
-  globalPath: join20(zedConfigDir(), "settings.json"),
+  globalPath: join22(zedConfigDir(), "settings.json"),
   topKey: "context_servers",
   buildServer: (cfg) => ({
     source: "custom",
@@ -8311,7 +8442,7 @@ var ZedProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join20(cwd, ".zed", "settings.json")
+  localConfigPath: (cwd) => join22(cwd, ".zed", "settings.json")
 });
 var init_zed = __esm(() => {
   init_config_helpers();
@@ -8336,6 +8467,7 @@ function allProviders() {
     OpenCodeProvider(),
     AntigravityProvider(),
     MCPorterProvider(),
+    FactoryProvider(),
     ManualProvider()
   ];
 }
@@ -8358,6 +8490,7 @@ var init_providers = __esm(() => {
   init_codex2();
   init_copilot();
   init_cursor();
+  init_factory2();
   init_gemini();
   init_manual();
   init_mcporter();
@@ -10859,8 +10992,22 @@ async function startOAuthFlow(signal, path2 = "/cli/auth", params = {}) {
     const authURL = buildAuthURL(callbackURL, path2, params);
     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");
+    let browserOpened = false;
+    try {
+      await open2.default(authURL);
+      browserOpened = true;
+      logger.info("auth.flow", "Browser open command executed");
+    } catch (openErr) {
+      logger.warn("auth.flow", `Could not open browser automatically: ${openErr instanceof Error ? openErr.message : String(openErr)}`);
+    }
+    if (!browserOpened) {
+      console.log(`
+Could not open a browser automatically.`);
+      console.log(`Please open this URL in your browser to log in:
+`);
+      console.log(`  ${authURL}
+`);
+    }
     const timeout = new Promise((_3, reject) => {
       timeoutId = setTimeout(() => {
         logger.warn("auth.flow", "Authentication timed out (8min)");
@@ -10904,8 +11051,8 @@ __export(exports_flow2, {
   isStdioOnly: () => isStdioOnly
 });
 import { randomUUID } from "node:crypto";
-import { existsSync as existsSync11 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { join as join23 } from "node:path";
 async function runSetup(opts = {}) {
   const onboardingRunID = randomUUID();
   logger.info("setup", `Setup flow started${opts.deploymentID ? ` deployment=${opts.deploymentID}` : ""}${opts.mode ? ` mode=${opts.mode}` : ""}`);
@@ -11077,7 +11224,7 @@ async function runSetup(opts = {}) {
     showTryItOutPrompt({
       mode: cfg.mode,
       docsImported: choices.connectGitHub && githubOnboardingDone,
-      hasAgentsMd: existsSync11(join21(process.cwd(), "AGENTS.md"))
+      hasAgentsMd: existsSync12(join23(process.cwd(), "AGENTS.md"))
     });
   }
   if (mcpCompleted || skillCompleted || docsImported) {
@@ -11571,8 +11718,8 @@ var init_flow2 = __esm(() => {
 });
 
 // src/commands/insights.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync6, readdirSync, unlinkSync, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname3, join as join22 } from "node:path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync6, readdirSync, unlinkSync, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname3, join as join24 } from "node:path";
 function shuffled(arr) {
   const copy2 = [...arr];
   for (let i = copy2.length - 1;i > 0; i--) {
@@ -11676,17 +11823,17 @@ function makeAskFn(cfg) {
   };
 }
 function insightsDir() {
-  return join22(getConfigDir(), "insights");
+  return join24(getConfigDir(), "insights");
 }
 function reportPath(timestamp) {
   const dir = insightsDir();
   if (!timestamp)
-    return join22(dir, "latest.html");
+    return join24(dir, "latest.html");
   const iso = timestamp.toISOString().slice(0, 19).replace(/:/g, "-");
-  return join22(dir, `report-${iso}Z.html`);
+  return join24(dir, `report-${iso}Z.html`);
 }
 function pruneOldReports(dir, keepN) {
-  if (!existsSync12(dir))
+  if (!existsSync13(dir))
     return;
   let entries;
   try {
@@ -11698,7 +11845,7 @@ function pruneOldReports(dir, keepN) {
   const reports = entries.filter((f) => REPORT_FILE_PATTERN.test(f)).sort().reverse();
   for (const f of reports.slice(keepN)) {
     try {
-      unlinkSync(join22(dir, f));
+      unlinkSync(join24(dir, f));
     } catch (err) {
       logger.debug("insights", `failed to prune ${f}: ${err instanceof Error ? err.message : err}`);
     }
@@ -11771,7 +11918,7 @@ function defaultRunner(cfg) {
     render: renderHTML,
     writeFile: (path2, content) => {
       const dir = dirname3(path2);
-      if (!existsSync12(dir))
+      if (!existsSync13(dir))
         mkdirSync6(dir, { recursive: true, mode: 448 });
       writeFileSync5(path2, content, { mode: 384 });
     },
@@ -12436,7 +12583,7 @@ var init_flow3 = __esm(() => {
 // src/cli/cli.ts
 init_esm();
 init_client();
-import { readFileSync as readFileSync12, unlinkSync as unlinkSync2 } from "node:fs";
+import { readFileSync as readFileSync13, unlinkSync as unlinkSync2 } from "node:fs";
 
 // src/commands/analytics.ts
 init_esm();
@@ -13122,7 +13269,7 @@ init_esm();
 init_config();
 init_logger();
 init_prompts();
-import { readFileSync as readFileSync8 } from "node:fs";
+import { readFileSync as readFileSync9 } from "node:fs";
 import { basename } from "node:path";
 
 // src/hooks/state.ts
@@ -13161,7 +13308,7 @@ var COOLDOWN_DEFAULT_MS = 3000;
 var TTL_DEFAULT_MS = 10 * 60 * 1000;
 var STOP_WAIT_DEFAULT_MS = 8000;
 var STOP_POLL_DEFAULT_MS = 1000;
-var SUPPORTED_AGENTS = ["claude-code", "codex"];
+var SUPPORTED_AGENTS = ["claude-code", "codex", "factory"];
 var DEFAULT_AGENT = "claude-code";
 function cooldownMs() {
   const n = Number.parseInt(process.env.DOSU_HOOK_CHECK_COOLDOWN_MS ?? "", 10);
@@ -13391,7 +13538,7 @@ async function runHookEntrypoint(event, raw, now = Date.now(), agent = DEFAULT_A
 }
 function readStdinRaw() {
   try {
-    return readFileSync8(0, "utf8");
+    return readFileSync9(0, "utf8");
   } catch {
     return "";
   }
@@ -13439,6 +13586,20 @@ async function runInstall(agent, opts) {
       }
       return;
     }
+    if (agent === "factory") {
+      const { installFactoryHooks: installFactoryHooks2, factoryHooksPath: factoryHooksPath2 } = await Promise.resolve().then(() => (init_factory(), exports_factory));
+      const configPath2 = factoryHooksPath2(resolveDir(opts.dir));
+      const { events: events2 } = installFactoryHooks2(configPath2, { stop: opts.stop });
+      if (opts.json) {
+        const { emitStep: emitStep2 } = await Promise.resolve().then(() => exports_output);
+        emitStep2({ step: "hooks-install", agent, path: configPath2, events: events2 });
+      } else {
+        console.log(`✓ Installed Dosu hooks for Factory (${events2.join(", ")}).`);
+        console.log(`  → ${configPath2}`);
+        console.log("  Start a new Factory session in this project to use them.");
+      }
+      return;
+    }
     const { installClaudeHooks: installClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
     const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
     const { events } = installClaudeHooks2(configPath, { stop: opts.stop });
@@ -13476,6 +13637,10 @@ async function runUninstall(agent, opts) {
     const { removeCodexHooks: removeCodexHooks2, codexHooksPath: codexHooksPath2 } = await Promise.resolve().then(() => (init_codex(), exports_codex));
     configPath = codexHooksPath2(resolveDir(opts.dir));
     ({ removed } = removeCodexHooks2(configPath));
+  } else if (agent === "factory") {
+    const { removeFactoryHooks: removeFactoryHooks2, factoryHooksPath: factoryHooksPath2 } = await Promise.resolve().then(() => (init_factory(), exports_factory));
+    configPath = factoryHooksPath2(resolveDir(opts.dir));
+    ({ removed } = removeFactoryHooks2(configPath));
   } else {
     const { removeClaudeHooks: removeClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
     configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
@@ -13494,15 +13659,20 @@ async function collectDoctorChecks(opts) {
   const checks = [];
   const { claudeLocalSettingsPath: claudeLocalSettingsPath2, inspectClaudeHooks: inspectClaudeHooks2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
   const { codexHooksPath: codexHooksPath2, inspectCodexHooks: inspectCodexHooks2 } = await Promise.resolve().then(() => (init_codex(), exports_codex));
+  const { factoryHooksPath: factoryHooksPath2, inspectFactoryHooks: inspectFactoryHooks2 } = await Promise.resolve().then(() => (init_factory(), exports_factory));
   const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
   const inspection = inspectClaudeHooks2(configPath);
   const codexPath = codexHooksPath2(resolveDir(opts.dir));
   const codex = inspectCodexHooks2(codexPath);
+  const factoryPath = factoryHooksPath2(resolveDir(opts.dir));
+  const factory = inspectFactoryHooks2(factoryPath);
   const codexInstalled = codex.events.includes("UserPromptSubmit") && codex.events.includes("PostToolUse");
+  const factoryInstalled = factory.events.includes("UserPromptSubmit") && factory.events.includes("PostToolUse");
+  const alternativeInstalled = codexInstalled || factoryInstalled;
   if (!inspection.fileExists) {
     checks.push({
       name: "config",
-      status: codexInstalled ? "warn" : "fail",
+      status: alternativeInstalled ? "warn" : "fail",
       detail: `not found: ${configPath} (run 'dosu hooks install claude-code')`
     });
   } else if (inspection.parseError) {
@@ -13521,7 +13691,7 @@ async function collectDoctorChecks(opts) {
   } else {
     checks.push({
       name: "hooks",
-      status: codexInstalled ? "warn" : "fail",
+      status: alternativeInstalled ? "warn" : "fail",
       detail: "UserPromptSubmit + PostToolUse not both installed"
     });
   }
@@ -13547,6 +13717,27 @@ async function collectDoctorChecks(opts) {
       });
     }
   }
+  if (factory.fileExists) {
+    if (factory.parseError) {
+      checks.push({
+        name: "factory-config",
+        status: "fail",
+        detail: `invalid JSON: ${factoryPath}`
+      });
+    } else if (factoryInstalled) {
+      checks.push({
+        name: "factory-config",
+        status: "ok",
+        detail: `installed: ${factory.events.join(", ")} (${factoryPath})`
+      });
+    } else {
+      checks.push({
+        name: "factory-config",
+        status: "fail",
+        detail: "UserPromptSubmit + PostToolUse not both installed"
+      });
+    }
+  }
   const cfg = loadConfig();
   if (isAuthenticated(cfg)) {
     checks.push({ name: "auth", status: "ok", detail: "logged in" });
@@ -13601,7 +13792,7 @@ async function runDoctor(opts) {
   }
 }
 function hooksCommand() {
-  const cmd = new Command("hooks").description("Dosu knowledge-injection hooks for coding agents (Claude Code, Codex)");
+  const cmd = new Command("hooks").description("Dosu knowledge-injection hooks for coding agents (Claude Code, Codex, Factory)");
   cmd.command("user-prompt-submit").description("Hook entrypoint: create a knowledge ticket on prompt submit").option("--agent <agent>", "Calling agent for ticket attribution", DEFAULT_AGENT).action(async (opts) => {
     await runHookEntrypoint("user-prompt-submit", readStdinRaw(), Date.now(), opts.agent);
   });
@@ -13628,6 +13819,7 @@ function hooksCommand() {
     "Examples:",
     "  $ dosu hooks install claude-code",
     "  $ dosu hooks install codex",
+    "  $ dosu hooks install factory",
     "  $ dosu hooks install claude-code --no-stop",
     "  $ dosu hooks install codex --dir ./my-project",
     "",
@@ -13641,7 +13833,8 @@ function hooksCommand() {
     "",
     "Examples:",
     "  $ dosu hooks uninstall claude-code",
-    "  $ dosu hooks uninstall codex"
+    "  $ dosu hooks uninstall codex",
+    "  $ dosu hooks uninstall factory"
   ].join(`
 `)).action((agent, opts) => runUninstall(agent, opts));
   cmd.command("doctor").description("Diagnose Dosu hook config, auth, deployment, and backend connectivity").option("--dir <path>", "Project root (defaults to current directory)").option("--json", "Emit machine-readable JSON", false).action((opts) => runDoctor(opts));
@@ -14477,8 +14670,8 @@ init_skill_update_check();
 init_config();
 init_logger();
 var import_picocolors24 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync11, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join23 } from "node:path";
+import { existsSync as existsSync14, mkdirSync as mkdirSync7, readFileSync as readFileSync12, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join25 } from "node:path";
 var CACHE_FILENAME2 = "update-check.json";
 var CHECK_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS2 = 5000;
@@ -14501,14 +14694,14 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath2() {
-  return join23(getConfigDir(), CACHE_FILENAME2);
+  return join25(getConfigDir(), CACHE_FILENAME2);
 }
 function readCache() {
   try {
     const path2 = getCachePath2();
-    if (!existsSync13(path2))
+    if (!existsSync14(path2))
       return null;
-    const data = JSON.parse(readFileSync11(path2, "utf-8"));
+    const data = JSON.parse(readFileSync12(path2, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestVersion === "string") {
       return data;
     }
@@ -14520,7 +14713,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync13(dir)) {
+    if (!existsSync14(dir)) {
       mkdirSync7(dir, { recursive: true, mode: 448 });
     }
     writeFileSync6(getCachePath2(), JSON.stringify(cache), { mode: 384 });
@@ -14810,7 +15003,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync12(logPath, "utf-8");
+        const content = readFileSync13(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n).join(`

package/package.json

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