fathom-cli 0.3.0 → 0.3.3

package/dist/index.js

@@ -6,7 +6,6 @@ import {
 import {
   __commonJS,
   __export,
-  __require,
   __toESM
 } from "./chunk-SEGVTWSK.js";
 
@@ -103,7 +102,7 @@ var require_extend = __commonJS({
 
 // src/index.ts
 import "dotenv/config";
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 
 // ../../node_modules/.pnpm/bail@2.0.2/node_modules/bail/index.js
 function bail(error) {
@@ -480,10 +479,10 @@ var VFile = class {
    * @returns {undefined}
    *   Nothing.
    */
-  set basename(basename4) {
-    assertNonEmpty(basename4, "basename");
-    assertPart(basename4, "basename");
-    this.path = default2.join(this.dirname || "", basename4);
+  set basename(basename5) {
+    assertNonEmpty(basename5, "basename");
+    assertPart(basename5, "basename");
+    this.path = default2.join(this.dirname || "", basename5);
   }
   /**
    * Get the parent path (example: `'~'`).
@@ -504,9 +503,9 @@ var VFile = class {
    * @returns {undefined}
    *   Nothing.
    */
-  set dirname(dirname8) {
+  set dirname(dirname10) {
     assertPath(this.basename, "dirname");
-    this.path = default2.join(dirname8 || "", this.basename);
+    this.path = default2.join(dirname10 || "", this.basename);
   }
   /**
    * Get the extname (including dot) (example: `'.js'`).
@@ -1105,7 +1104,7 @@ var Processor = class _Processor extends CallableInstance {
     assertParser("process", this.parser || this.Parser);
     assertCompiler("process", this.compiler || this.Compiler);
     return done ? executor(void 0, done) : new Promise(executor);
-    function executor(resolve23, reject) {
+    function executor(resolve25, reject) {
       const realFile = vfile(file);
       const parseTree = (
         /** @type {HeadTree extends undefined ? Node : HeadTree} */
@@ -1136,8 +1135,8 @@ var Processor = class _Processor extends CallableInstance {
       function realDone(error, file2) {
         if (error || !file2) {
           reject(error);
-        } else if (resolve23) {
-          resolve23(file2);
+        } else if (resolve25) {
+          resolve25(file2);
         } else {
           ok(done, "`done` is defined if `resolve` is not");
           done(void 0, file2);
@@ -1239,7 +1238,7 @@ var Processor = class _Processor extends CallableInstance {
       file = void 0;
     }
     return done ? executor(void 0, done) : new Promise(executor);
-    function executor(resolve23, reject) {
+    function executor(resolve25, reject) {
       ok(
         typeof file !== "function",
         "`file` can\u2019t be a `done` anymore, we checked"
@@ -1253,8 +1252,8 @@ var Processor = class _Processor extends CallableInstance {
         );
         if (error) {
           reject(error);
-        } else if (resolve23) {
-          resolve23(resultingTree);
+        } else if (resolve25) {
+          resolve25(resultingTree);
         } else {
           ok(done, "`done` is defined if `resolve` is not");
           done(void 0, resultingTree, file2);
@@ -4082,10 +4081,10 @@ function resolveAll(constructs2, events, context) {
   const called = [];
   let index2 = -1;
   while (++index2 < constructs2.length) {
-    const resolve23 = constructs2[index2].resolveAll;
-    if (resolve23 && !called.includes(resolve23)) {
-      events = resolve23(events, context);
-      called.push(resolve23);
+    const resolve25 = constructs2[index2].resolveAll;
+    if (resolve25 && !called.includes(resolve25)) {
+      events = resolve25(events, context);
+      called.push(resolve25);
     }
   }
   return events;
@@ -9003,26 +9002,43 @@ var SYSTEM_PROMPT = `You are a technical complexity scorer for software features
 Respond with ONLY a JSON object. No markdown, no explanation.`;
 async function scoreComplexityAI(description, options = {}) {
   try {
-    const client = options.client ?? await getAnthropicClient(options.apiKey);
-    const model = options.model ?? "claude-haiku-4-5-20251001";
-    const response = await client.messages.create({
-      model,
-      max_tokens: 1024,
-      system: SYSTEM_PROMPT,
-      messages: [
-        {
-          role: "user",
-          content: `Analyze the complexity of this feature:
+    const userPrompt = `Analyze the complexity of this feature:
 
-${description}`
-        }
-      ]
-    });
-    const textBlock = response.content.find((block) => block.type === "text");
-    if (!textBlock || textBlock.type !== "text") {
-      return null;
+${description}`;
+    let text3;
+    if (options.generate) {
+      text3 = await options.generate(SYSTEM_PROMPT, userPrompt);
+    } else if (options.provider === "openai") {
+      const openaiModule = await import("openai");
+      const OpenAI = openaiModule.default ?? openaiModule;
+      const client = new OpenAI({ apiKey: options.openaiApiKey ?? process.env.OPENAI_API_KEY });
+      const response = await client.chat.completions.create({
+        model: options.model ?? "gpt-4o-mini",
+        messages: [
+          { role: "system", content: SYSTEM_PROMPT },
+          { role: "user", content: userPrompt }
+        ],
+        max_tokens: 1024
+      });
+      text3 = response.choices[0]?.message?.content ?? "";
+    } else {
+      const client = options.client ?? await getAnthropicClient(options.apiKey);
+      const model = options.model ?? "claude-haiku-4-5-20251001";
+      const response = await client.messages.create({
+        model,
+        max_tokens: 1024,
+        system: SYSTEM_PROMPT,
+        messages: [
+          { role: "user", content: userPrompt }
+        ]
+      });
+      const textBlock = response.content.find((block) => block.type === "text");
+      if (!textBlock || textBlock.type !== "text") {
+        return null;
+      }
+      text3 = textBlock.text;
     }
-    let jsonText = textBlock.text.trim();
+    let jsonText = text3.trim();
     if (jsonText.startsWith("```")) {
       jsonText = jsonText.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "");
     }
@@ -9220,8 +9236,8 @@ var VERSION = "0.1.0";
 
 // src/commands/go.ts
 import { Command as Command3 } from "commander";
-import { existsSync as existsSync6, readFileSync as readFileSync6, cpSync, mkdirSync as mkdirSync6 } from "fs";
-import { resolve as resolve7, basename as basename2 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync7, cpSync, mkdirSync as mkdirSync6 } from "fs";
+import { resolve as resolve7, basename as basename3 } from "path";
 import { spawn } from "child_process";
 import chalk4 from "chalk";
 import { select as select2, confirm as confirm2, input as input2, checkbox } from "@inquirer/prompts";
@@ -9302,11 +9318,21 @@ function updateWorkflowState(updates) {
 
 // src/commands/setup.ts
 import { Command } from "commander";
-import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync as existsSync3 } from "fs";
-import { resolve as resolve4 } from "path";
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
+import { basename, resolve as resolve4 } from "path";
 import chalk from "chalk";
+function detectProjectName(dir) {
+  try {
+    const pkg = JSON.parse(readFileSync4(resolve4(dir, "package.json"), "utf-8"));
+    if (pkg.name && typeof pkg.name === "string") {
+      return pkg.name.replace(/^@[^/]+\//, "");
+    }
+  } catch {
+  }
+  return basename(dir);
+}
 function scaffoldProject(projectName, opts = {}) {
-  const baseDir = process.cwd();
+  const baseDir = opts.projectDir ?? process.cwd();
   const log = opts.quiet ? () => {
   } : (msg) => console.log(msg);
   const fathomDir = resolve4(baseDir, ".fathom");
@@ -9390,9 +9416,25 @@ function scaffoldProject(projectName, opts = {}) {
   } else {
     log(chalk.dim("  \xB7 .claude/hooks/te-session-sync.sh (exists)"));
   }
+  const mcpPath = resolve4(baseDir, ".mcp.json");
+  let mcpConfig = { mcpServers: {} };
+  if (existsSync3(mcpPath)) {
+    try {
+      mcpConfig = JSON.parse(readFileSync4(mcpPath, "utf-8"));
+      if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
+    } catch {
+      mcpConfig = { mcpServers: {} };
+    }
+  }
+  mcpConfig.mcpServers.fathom = {
+    command: "npx",
+    args: ["-y", "fathom-mcp@latest", "--project-dir", "."]
+  };
+  writeFileSync3(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  log(chalk.green("  \u2713 .mcp.json (MCP auto-discovery)"));
 }
-var setupCommand = new Command("setup").description("Scaffold .fathom/ project directory + .claude/ skill + hooks").option("-p, --project <name>", "Project name", "unnamed").action((options) => {
-  const projectName = options.project;
+var setupCommand = new Command("setup").description("Scaffold .fathom/ project directory + .claude/ skill + hooks").option("-p, --project <name>", "Project name").action((options) => {
+  const projectName = options.project ?? detectProjectName(process.cwd());
   console.log(chalk.bold(`
 Fathom \u2014 Setup: ${projectName}`));
   console.log(chalk.dim("\u2500".repeat(50)));
@@ -9450,8 +9492,8 @@ function generateHookScript(projectName) {
 
 // src/commands/intake.ts
 import { Command as Command2 } from "commander";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4, readdirSync, statSync } from "fs";
-import { resolve as resolve5, basename, dirname as dirname3 } from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4, readdirSync, statSync } from "fs";
+import { resolve as resolve5, basename as basename2, dirname as dirname3 } from "path";
 import chalk3 from "chalk";
 import Table from "cli-table3";
 import { input, confirm, select } from "@inquirer/prompts";
@@ -9975,16 +10017,24 @@ function findLocalMarkdownFiles() {
 async function runIntakeFlow(projectName) {
   const cwd = process.cwd();
   const { rawInput, source } = await resolveInput(cwd);
-  if (!process.env.ANTHROPIC_API_KEY) {
-    console.error(chalk3.red("ANTHROPIC_API_KEY environment variable is required."));
-    console.error(chalk3.dim("  Add it to your .env file or export it:"));
+  const hasAnthropicKey = !!process.env.ANTHROPIC_API_KEY;
+  const hasOpenAIKey = !!process.env.OPENAI_API_KEY;
+  if (!hasAnthropicKey && !hasOpenAIKey) {
+    console.error(chalk3.red("No LLM provider API key found."));
+    console.error(chalk3.dim("  Set one of:"));
     console.error(chalk3.dim("  export ANTHROPIC_API_KEY=sk-ant-..."));
+    console.error(chalk3.dim("  export OPENAI_API_KEY=sk-..."));
     process.exit(1);
   }
-  console.log(chalk3.dim("\n  Extracting work items via Claude..."));
+  const provider = hasAnthropicKey ? "anthropic" : "openai";
+  console.log(chalk3.dim(`
+  Extracting work items via ${provider === "anthropic" ? "Claude" : "OpenAI"}...`));
   let items;
   try {
-    items = await extractWorkItems(rawInput);
+    items = await extractWorkItems(rawInput, {
+      provider,
+      ...provider === "openai" ? { openaiApiKey: process.env.OPENAI_API_KEY } : {}
+    });
   } catch (err) {
     console.error(chalk3.red("  Extraction failed:"), err.message);
     process.exit(1);
@@ -10033,7 +10083,7 @@ async function resolveInput(cwd) {
       { name: "Type/paste text instead", value: "__text__" }
     );
     const chosen = await select({
-      message: `Input source (${localFiles.length} file${localFiles.length === 1 ? "" : "s"} found in ${basename(cwd)}):`,
+      message: `Input source (${localFiles.length} file${localFiles.length === 1 ? "" : "s"} found in ${basename2(cwd)}):`,
       choices: fileChoices
     });
     if (chosen === "__text__") {
@@ -10048,9 +10098,9 @@ async function resolveInput(cwd) {
         console.error(chalk3.red(`File not found: ${resolved}`));
         process.exit(1);
       }
-      return { rawInput: readFileSync4(resolved, "utf-8"), source: "file" };
+      return { rawInput: readFileSync5(resolved, "utf-8"), source: "file" };
     } else {
-      return { rawInput: readFileSync4(resolve5(chosen), "utf-8"), source: "file" };
+      return { rawInput: readFileSync5(resolve5(chosen), "utf-8"), source: "file" };
     }
   }
   const inputType = await select({
@@ -10067,7 +10117,7 @@ async function resolveInput(cwd) {
       console.error(chalk3.red(`File not found: ${resolved}`));
       process.exit(1);
     }
-    return { rawInput: readFileSync4(resolved, "utf-8"), source: "file" };
+    return { rawInput: readFileSync5(resolved, "utf-8"), source: "file" };
   }
   return {
     rawInput: await input({ message: "Paste your feedback / requirements:" }),
@@ -10110,14 +10160,14 @@ function displayIntakeTable(projectName, slices, totalTokens, totalCost) {
   Total: ${totalTokens.toLocaleString()} tokens \u2014 $${totalCost.toFixed(2)}`)
   );
 }
-var intakeCommand = new Command2("intake").description("Extract work items from raw feedback, bug reports, or meeting notes").argument("[text]", "Raw text input to analyze").option("-f, --file <path>", "Read input from a file").option("-p, --project <name>", "Project name").option("-o, --output <path>", "Write markdown spec to file").option("--json", "Output as JSON").option("--markdown", "Output as markdown to stdout").action(async (text3, options) => {
+var intakeCommand = new Command2("intake").description("Extract work items from raw feedback, bug reports, or meeting notes").argument("[text]", "Raw text input to analyze").option("-f, --file <path>", "Read input from a file").option("-p, --project <name>", "Project name").option("-o, --output <path>", "Write markdown spec to file").option("--json", "Output as JSON").option("--markdown", "Output as markdown to stdout").option("--provider <provider>", "LLM provider (anthropic, openai, auto)", "auto").action(async (text3, options) => {
   try {
     const cwd = process.cwd();
     let projectName = options.project ?? getProjectName();
     if (projectName === "unnamed") {
       projectName = await input({
         message: "Project name:",
-        default: basename(cwd)
+        default: basename2(cwd)
       });
       updateProjectConfig({ project: projectName });
     }
@@ -10129,7 +10179,7 @@ var intakeCommand = new Command2("intake").description("Extract work items from
         console.error(chalk3.red(`File not found: ${filePath}`));
         process.exit(1);
       }
-      rawInput = readFileSync4(filePath, "utf-8");
+      rawInput = readFileSync5(filePath, "utf-8");
       source = "file";
     } else if (text3) {
       rawInput = text3;
@@ -10146,7 +10196,7 @@ var intakeCommand = new Command2("intake").description("Extract work items from
           { name: "Type/paste text instead", value: "__text__" }
         );
         const chosen = await select({
-          message: `Input source (${localFiles.length} file${localFiles.length === 1 ? "" : "s"} found in ${basename(cwd)}):`,
+          message: `Input source (${localFiles.length} file${localFiles.length === 1 ? "" : "s"} found in ${basename2(cwd)}):`,
           choices: fileChoices
         });
         if (chosen === "__text__") {
@@ -10164,10 +10214,10 @@ var intakeCommand = new Command2("intake").description("Extract work items from
             console.error(chalk3.red(`File not found: ${resolved}`));
             process.exit(1);
           }
-          rawInput = readFileSync4(resolved, "utf-8");
+          rawInput = readFileSync5(resolved, "utf-8");
           source = "file";
         } else {
-          rawInput = readFileSync4(resolve5(chosen), "utf-8");
+          rawInput = readFileSync5(resolve5(chosen), "utf-8");
           source = "file";
         }
       } else {
@@ -10188,7 +10238,7 @@ var intakeCommand = new Command2("intake").description("Extract work items from
             console.error(chalk3.red(`File not found: ${resolved}`));
             process.exit(1);
           }
-          rawInput = readFileSync4(resolved, "utf-8");
+          rawInput = readFileSync5(resolved, "utf-8");
           source = "file";
         } else {
           rawInput = await input({
@@ -10198,16 +10248,29 @@ var intakeCommand = new Command2("intake").description("Extract work items from
         }
       }
     }
-    if (!process.env.ANTHROPIC_API_KEY) {
-      console.error(chalk3.red("ANTHROPIC_API_KEY environment variable is required."));
-      console.error(chalk3.dim("  Add it to your .env file or export it:"));
-      console.error(chalk3.dim("  export ANTHROPIC_API_KEY=sk-ant-..."));
-      process.exit(1);
+    const hasAnthropicKey = !!process.env.ANTHROPIC_API_KEY;
+    const hasOpenAIKey = !!process.env.OPENAI_API_KEY;
+    let provider;
+    if (options.provider && options.provider !== "auto") {
+      provider = options.provider;
+    } else {
+      if (!hasAnthropicKey && !hasOpenAIKey) {
+        console.error(chalk3.red("No LLM provider API key found."));
+        console.error(chalk3.dim("  Set one of:"));
+        console.error(chalk3.dim("  export ANTHROPIC_API_KEY=sk-ant-..."));
+        console.error(chalk3.dim("  export OPENAI_API_KEY=sk-..."));
+        process.exit(1);
+      }
+      provider = hasAnthropicKey ? "anthropic" : "openai";
     }
-    console.log(chalk3.dim("\nExtracting work items via Claude..."));
+    console.log(chalk3.dim(`
+Extracting work items via ${provider === "anthropic" ? "Claude" : "OpenAI"}...`));
     let items;
     try {
-      items = await extractWorkItems(rawInput);
+      items = await extractWorkItems(rawInput, {
+        provider,
+        ...provider === "openai" ? { openaiApiKey: process.env.OPENAI_API_KEY } : {}
+      });
     } catch (err) {
       console.error(chalk3.red("Extraction failed:"), err.message);
       process.exit(1);
@@ -10364,7 +10427,7 @@ function writeRegistry(projectName, slices) {
   let existing = [];
   if (existsSync4(registryPath)) {
     try {
-      const data = JSON.parse(readFileSync4(registryPath, "utf-8"));
+      const data = JSON.parse(readFileSync5(registryPath, "utf-8"));
       if (Array.isArray(data.features)) {
         const newIds = new Set(features.map((f) => f.id));
         existing = data.features.filter(
@@ -10407,7 +10470,7 @@ async function doConvexSync(result, rawInput, source, projectName) {
 }
 
 // src/build-prompt.ts
-import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5, existsSync as existsSync5 } from "fs";
+import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync6, existsSync as existsSync5 } from "fs";
 import { resolve as resolve6, dirname as dirname4 } from "path";
 function generateBuildPrompt(opts) {
   const { projectName, workflowState } = opts;
@@ -10415,14 +10478,14 @@ function generateBuildPrompt(opts) {
   let features = [];
   if (existsSync5(regPath)) {
     try {
-      const data = JSON.parse(readFileSync5(regPath, "utf-8"));
+      const data = JSON.parse(readFileSync6(regPath, "utf-8"));
       if (Array.isArray(data.features)) features = data.features;
     } catch {
     }
   }
   let specContent = "";
   if (workflowState.specPath && existsSync5(workflowState.specPath)) {
-    specContent = readFileSync5(workflowState.specPath, "utf-8");
+    specContent = readFileSync6(workflowState.specPath, "utf-8");
   }
   const queueFeatures = workflowState.buildQueue.map((id) => features.find((f) => f.id === id)).filter((f) => f !== void 0);
   const pct = workflowState.featuresTotal > 0 ? Math.round(workflowState.featuresComplete / workflowState.featuresTotal * 100) : 0;
@@ -10549,38 +10612,70 @@ async function captureIntentFlow(defaultProjectName) {
     choices: VALUE_OPTIONS
   });
   const values = [];
-  for (const val of selectedValues) {
-    const label = VALUE_OPTIONS.find((o) => o.value === val)?.name ?? val;
-    const details = await input2({
-      message: `"${label}" \u2014 any specifics? (optional)`
+  let skipRemaining = false;
+  if (selectedValues.length > 0) {
+    const drillDown = await confirm2({
+      message: `Set priorities for each? (${selectedValues.length} selected \u2014 or skip to default all to medium)`,
+      default: false
     });
-    const priority = await select2({
-      message: `"${label}" \u2014 priority?`,
-      choices: [
-        { name: "Critical", value: "critical" },
-        { name: "High", value: "high" },
-        { name: "Medium", value: "medium" },
-        { name: "Low", value: "low" }
-      ],
-      default: "medium"
-    });
-    values.push({
-      name: val,
-      description: label,
-      priority,
-      ...details ? { details } : {}
-    });
-  }
-  let addMore = selectedValues.length === 0;
-  if (!addMore && selectedValues.length > 0) {
-    addMore = await confirm2({ message: "Add any custom values not in the list?", default: false });
+    if (drillDown) {
+      for (const val of selectedValues) {
+        if (skipRemaining) {
+          const label2 = VALUE_OPTIONS.find((o) => o.value === val)?.name ?? val;
+          values.push({ name: val, description: label2, priority: "medium" });
+          continue;
+        }
+        const label = VALUE_OPTIONS.find((o) => o.value === val)?.name ?? val;
+        const details = await input2({
+          message: `"${label}" \u2014 any specifics? (enter to skip, "done" to skip remaining)`
+        });
+        if (details.toLowerCase() === "done") {
+          values.push({ name: val, description: label, priority: "medium" });
+          skipRemaining = true;
+          continue;
+        }
+        const priority = await select2({
+          message: `"${label}" \u2014 priority?`,
+          choices: [
+            { name: "Critical", value: "critical" },
+            { name: "High", value: "high" },
+            { name: "Medium", value: "medium" },
+            { name: "Low", value: "low" },
+            { name: "Skip remaining (default medium)", value: "skip" }
+          ],
+          default: "medium"
+        });
+        if (priority === "skip") {
+          values.push({ name: val, description: label, priority: "medium", ...details ? { details } : {} });
+          skipRemaining = true;
+          continue;
+        }
+        values.push({
+          name: val,
+          description: label,
+          priority,
+          ...details ? { details } : {}
+        });
+      }
+    } else {
+      for (const val of selectedValues) {
+        const label = VALUE_OPTIONS.find((o) => o.value === val)?.name ?? val;
+        values.push({ name: val, description: label, priority: "medium" });
+      }
+    }
   }
-  while (addMore) {
-    const customName = await input2({ message: "Value name (or press enter to finish):" });
-    if (!customName) break;
-    const customDesc = await input2({ message: `Description for "${customName}":` });
-    values.push({ name: customName, description: customDesc, priority: "medium" });
-    addMore = await confirm2({ message: "Add another?", default: false });
+  if (!skipRemaining) {
+    let addMore = selectedValues.length === 0;
+    if (!addMore && selectedValues.length > 0) {
+      addMore = await confirm2({ message: "Add any custom values not in the list?", default: false });
+    }
+    while (addMore) {
+      const customName = await input2({ message: "Value name (or press enter to finish):" });
+      if (!customName) break;
+      const customDesc = await input2({ message: `Description for "${customName}":` });
+      values.push({ name: customName, description: customDesc, priority: "medium" });
+      addMore = await confirm2({ message: "Add another?", default: false });
+    }
   }
   const wantBudget = await confirm2({ message: "Set a monthly AI budget? (helps with model routing)", default: false });
   let budget;
@@ -10597,14 +10692,14 @@ async function captureIntentFlow(defaultProjectName) {
   let guardrails;
   if (wantGuardrails) {
     const templates = await checkbox({
-      message: "Security templates (select all that apply):",
+      message: "Guardrail templates (select all that apply):",
       choices: [
-        { name: "OWASP Top 10 (web security)", value: "owasp-top-10" },
-        { name: "WCAG AA (accessibility)", value: "wcag-aa" },
-        { name: "PCI Basic (payment data) \u2014 coming soon", value: "pci-basic" },
-        { name: "HIPAA Basic (health data) \u2014 coming soon", value: "hipaa-basic" },
-        { name: "GDPR Basic (privacy) \u2014 coming soon", value: "gdpr-basic" },
-        { name: "SOC2 Basic (security/availability) \u2014 coming soon", value: "soc2-basic" }
+        { name: "OWASP Top 10 \u2014 web security (injection, XSS, auth, CSRF, etc.)", value: "owasp-top-10" },
+        { name: "WCAG AA \u2014 accessibility (contrast, keyboard, screen readers, etc.)", value: "wcag-aa" },
+        { name: "PCI DSS \u2014 payment card data (encryption, tokenization, access control)", value: "pci-basic" },
+        { name: "HIPAA \u2014 health data (PHI protection, audit trails, encryption)", value: "hipaa-basic" },
+        { name: "GDPR \u2014 data privacy (consent, deletion rights, data minimization)", value: "gdpr-basic" },
+        { name: "SOC 2 \u2014 security + availability (MFA, logging, incident response)", value: "soc2-basic" }
       ]
     });
     const customRulesStr = await input2({
@@ -10644,6 +10739,67 @@ function printProgress(state) {
     )
   );
 }
+async function runSettingsFlow(projectName) {
+  let done = false;
+  while (!done) {
+    const setting = await select2({
+      message: "What would you like to update?",
+      choices: [
+        { name: "Re-capture project intent", value: "intent" },
+        { name: "Update budget", value: "budget" },
+        { name: "Reset build mode preference", value: "build-mode" },
+        { name: "Back", value: "back" }
+      ]
+    });
+    switch (setting) {
+      case "intent": {
+        const intentData = await captureIntentFlow(projectName);
+        const { saveIntent } = await import("./dist-XKZLNUDU.js");
+        await saveIntent(process.cwd(), intentData);
+        const { writeProjections } = await import("./dist-KXBSLOHP.js");
+        const files = await writeProjections(process.cwd(), intentData);
+        console.log(chalk4.green(`
+  \u2713 Intent saved to .fathom/intent.yaml`));
+        console.log(chalk4.green(`  \u2713 Generated ${files.length} projection files`));
+        console.log();
+        break;
+      }
+      case "budget": {
+        const { loadIntent, saveIntent } = await import("./dist-XKZLNUDU.js");
+        let existing;
+        try {
+          existing = await loadIntent(process.cwd());
+        } catch {
+          console.log(chalk4.yellow("  No intent found. Run intent capture first."));
+          break;
+        }
+        const limitStr = await input2({ message: "Monthly budget (USD):", default: String(existing.budget?.monthly_limit ?? 200) });
+        const limit = parseFloat(limitStr) || 200;
+        const thresholdStr = await input2({ message: "Alert threshold (0-1):", default: String(existing.budget?.alert_threshold ?? 0.8) });
+        const threshold = parseFloat(thresholdStr) || 0.8;
+        existing.budget = {
+          monthly_limit: limit,
+          alert_threshold: threshold,
+          prefer_batch: existing.budget?.prefer_batch ?? false,
+          currency: existing.budget?.currency ?? "USD"
+        };
+        await saveIntent(process.cwd(), existing);
+        console.log(chalk4.green(`
+  \u2713 Budget updated: $${limit}/month, alert at ${(threshold * 100).toFixed(0)}%
+`));
+        break;
+      }
+      case "build-mode": {
+        updateProjectConfig({ buildMode: void 0 });
+        console.log(chalk4.green("\n  \u2713 Build mode preference cleared. You'll be asked next time.\n"));
+        break;
+      }
+      case "back":
+        done = true;
+        break;
+    }
+  }
+}
 var goCommand = new Command3("go").description("Run the full workflow: intake \u2192 build \u2192 review").option("--from <phase>", "Start from a specific phase (intake, build, review)").option("--auto", "Skip confirmation prompts").action(async (options) => {
   try {
     const projectState = detectProjectState();
@@ -10683,7 +10839,7 @@ var goCommand = new Command3("go").description("Run the full workflow: intake \u
       console.log();
       console.log(chalk4.dim("  No project detected. Let's set one up."));
       console.log();
-      const intentData = await captureIntentFlow(basename2(process.cwd()));
+      const intentData = await captureIntentFlow(basename3(process.cwd()));
       projectName = intentData.project;
       const { saveIntent } = await import("./dist-XKZLNUDU.js");
       await saveIntent(process.cwd(), intentData);
@@ -10721,6 +10877,7 @@ var goCommand = new Command3("go").description("Run the full workflow: intake \u
           },
           { name: "New intake \u2014 add more work", value: "intake" },
           { name: "Review \u2014 reconcile recent sessions", value: "review" },
+          { name: "Update intent / project settings", value: "settings" },
           { name: "Status overview", value: "status" }
         ]
       });
@@ -10728,6 +10885,10 @@ var goCommand = new Command3("go").description("Run the full workflow: intake \u
         printStatus(workflowState);
         return;
       }
+      if (action === "settings") {
+        await runSettingsFlow(projectName);
+        return;
+      }
       startPhase = action;
     } else {
       startPhase = "intake";
@@ -10919,8 +11080,8 @@ async function executeBuildMode(mode, promptPath, state) {
       console.log(chalk4.dim(`
   Creating worktree: ${branchName}`));
       try {
-        const { execSync } = await import("child_process");
-        execSync(`git worktree add "${worktreePath}" -b "${branchName}"`, {
+        const { execSync: execSync2 } = await import("child_process");
+        execSync2(`git worktree add "${worktreePath}" -b "${branchName}"`, {
           stdio: "pipe",
           cwd: process.cwd()
         });
@@ -10952,8 +11113,8 @@ async function executeBuildMode(mode, promptPath, state) {
   return false;
 }
 function launchClaude(promptPath, cwd, firstFeature) {
-  return new Promise((resolve23) => {
-    const promptContent = readFileSync6(promptPath, "utf-8");
+  return new Promise((resolve25) => {
+    const promptContent = readFileSync7(promptPath, "utf-8");
     const initialPrompt = firstFeature ? `Read the build context in your system prompt. Start working on feature \`${firstFeature}\` \u2014 read the spec reference, plan the implementation, and begin.` : "Read the build context in your system prompt and start working on the first feature in the priority queue.";
     const child = spawn("claude", ["--append-system-prompt", promptContent, initialPrompt], {
       stdio: "inherit",
@@ -10969,11 +11130,11 @@ function launchClaude(promptPath, cwd, firstFeature) {
       } else {
         console.error(chalk4.red(`  Failed to launch Claude Code: ${err.message}`));
       }
-      resolve23();
+      resolve25();
     });
     child.on("close", () => {
       process.removeListener("SIGINT", sigintHandler);
-      resolve23();
+      resolve25();
     });
   });
 }
@@ -10999,7 +11160,7 @@ function printStatus(state) {
 
 // src/commands/analyze.ts
 import { Command as Command4 } from "commander";
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, mkdirSync as mkdirSync7, existsSync as existsSync7 } from "fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, mkdirSync as mkdirSync7, existsSync as existsSync7 } from "fs";
 import { resolve as resolve8 } from "path";
 import chalk5 from "chalk";
 import Table2 from "cli-table3";
@@ -11009,7 +11170,7 @@ var analyzeCommand = new Command4("analyze").description("Analyze a spec and gen
     console.error(chalk5.red(`Spec file not found: ${fullPath}`));
     process.exit(1);
   }
-  const content3 = readFileSync7(fullPath, "utf-8");
+  const content3 = readFileSync8(fullPath, "utf-8");
   const data = loadData();
   console.log(chalk5.dim("Parsing spec..."));
   const spec = parseSpec(content3);
@@ -11179,7 +11340,7 @@ var pricingCommand = new Command5("pricing").description("Show current model pri
 
 // src/commands/status.ts
 import { Command as Command6 } from "commander";
-import { readFileSync as readFileSync8, existsSync as existsSync8 } from "fs";
+import { readFileSync as readFileSync9, existsSync as existsSync8 } from "fs";
 import { resolve as resolve9 } from "path";
 import chalk7 from "chalk";
 import Table4 from "cli-table3";
@@ -11193,7 +11354,7 @@ var statusCommand = new Command6("status").description("Show project status from
     );
     return;
   }
-  const registry = JSON.parse(readFileSync8(registryPath, "utf-8"));
+  const registry = JSON.parse(readFileSync9(registryPath, "utf-8"));
   const projectName = options.project ?? registry.project ?? getProjectName();
   const summaryPath = resolve9(
     process.cwd(),
@@ -11205,7 +11366,7 @@ var statusCommand = new Command6("status").description("Show project status from
   const hasTracking = existsSync8(summaryPath);
   const actuals = /* @__PURE__ */ new Map();
   if (hasTracking) {
-    const summary = JSON.parse(readFileSync8(summaryPath, "utf-8"));
+    const summary = JSON.parse(readFileSync9(summaryPath, "utf-8"));
     for (const s of summary.sessions) {
       if (!s.featureId || s.status === "untagged") continue;
       const existing = actuals.get(s.featureId) ?? { tokens: 0, sessions: 0 };
@@ -11268,14 +11429,14 @@ Total estimated: ${totalEstimated.toLocaleString()} tokens`));
 
 // src/commands/track.ts
 import { Command as Command7 } from "commander";
-import { readFileSync as readFileSync10, existsSync as existsSync10, writeFileSync as writeFileSync7, mkdirSync as mkdirSync8 } from "fs";
+import { readFileSync as readFileSync11, existsSync as existsSync10, writeFileSync as writeFileSync7, mkdirSync as mkdirSync8 } from "fs";
 import { resolve as resolve10 } from "path";
 import chalk8 from "chalk";
 import Table5 from "cli-table3";
 
 // ../tracker/dist/index.js
-import { readFileSync as readFileSync9, readdirSync as readdirSync2, existsSync as existsSync9 } from "fs";
-import { join, basename as basename3 } from "path";
+import { readFileSync as readFileSync10, readdirSync as readdirSync2, existsSync as existsSync9 } from "fs";
+import { join, basename as basename4 } from "path";
 import { homedir } from "os";
 import { countTokens } from "@anthropic-ai/tokenizer";
 import { readFileSync as readFileSync22, existsSync as existsSync22 } from "fs";
@@ -11334,7 +11495,7 @@ var Registry = external_exports.object({
   generatedAt: external_exports.string()
 });
 function parseSessionFile(filePath) {
-  const content3 = readFileSync9(filePath, "utf-8");
+  const content3 = readFileSync10(filePath, "utf-8");
   const lines = content3.trim().split("\n").filter(Boolean);
   if (lines.length === 0) return null;
   let inputTokens = 0;
@@ -11407,7 +11568,7 @@ function parseSessionFile(filePath) {
       if (typeof text3 === "string") bucket.push(text3);
     }
   }
-  const sessionId = basename3(filePath, ".jsonl");
+  const sessionId = basename4(filePath, ".jsonl");
   const activeMinutes = sessionStart && sessionEnd ? (sessionEnd - sessionStart) / 6e4 : void 0;
   const allParts = [...inputParts, ...outputParts, ...conversationParts];
   const conversationText = allParts.join("\n");
@@ -11683,7 +11844,7 @@ var trackCommand = new Command7("track").description("Import Claude Code session
       return;
     }
     const registry = JSON.parse(
-      readFileSync10(registryPath, "utf-8")
+      readFileSync11(registryPath, "utf-8")
     );
     const projectName = options.project ?? registry.project ?? getProjectName();
     console.log(chalk8.dim("Scanning for sessions..."));
@@ -11710,7 +11871,7 @@ var trackCommand = new Command7("track").description("Import Claude Code session
     );
     const trackedIds = /* @__PURE__ */ new Set();
     if (!options.backfill && existsSync10(summaryPath)) {
-      const summary = JSON.parse(readFileSync10(summaryPath, "utf-8"));
+      const summary = JSON.parse(readFileSync11(summaryPath, "utf-8"));
       for (const s of summary.sessions ?? []) {
         trackedIds.add(s.sessionId);
       }
@@ -11810,7 +11971,7 @@ Total: ${totalTokens.toLocaleString()} tokens across ${results.length} sessions`
     }));
     let existing = { sessions: [] };
     if (existsSync10(summaryPath)) {
-      existing = JSON.parse(readFileSync10(summaryPath, "utf-8"));
+      existing = JSON.parse(readFileSync11(summaryPath, "utf-8"));
     }
     existing.sessions.push(...sessionRecords);
     writeFileSync7(
@@ -11863,7 +12024,7 @@ Tracking saved: ${summaryPath}`));
 
 // src/commands/reconcile.ts
 import { Command as Command8 } from "commander";
-import { readFileSync as readFileSync11, existsSync as existsSync11 } from "fs";
+import { readFileSync as readFileSync12, existsSync as existsSync11 } from "fs";
 import { resolve as resolve11 } from "path";
 import chalk9 from "chalk";
 import Table6 from "cli-table3";
@@ -11892,8 +12053,8 @@ var reconcileCommand = new Command8("reconcile").description("Compare estimates
     );
     return;
   }
-  const registry = JSON.parse(readFileSync11(registryPath, "utf-8"));
-  const summary = JSON.parse(readFileSync11(summaryPath, "utf-8"));
+  const registry = JSON.parse(readFileSync12(registryPath, "utf-8"));
+  const summary = JSON.parse(readFileSync12(summaryPath, "utf-8"));
   const projectName = options.project ?? registry.project ?? getProjectName();
   const data = loadData();
   const actuals = /* @__PURE__ */ new Map();
@@ -12068,7 +12229,7 @@ Overall: ${totalActual.toLocaleString()} / ${totalEstimated.toLocaleString()} to
 
 // src/commands/calibrate.ts
 import { Command as Command9 } from "commander";
-import { readFileSync as readFileSync12, existsSync as existsSync12 } from "fs";
+import { readFileSync as readFileSync13, existsSync as existsSync12 } from "fs";
 import { resolve as resolve12 } from "path";
 import chalk10 from "chalk";
 import Table7 from "cli-table3";
@@ -12089,8 +12250,8 @@ var calibrateCommand = new Command9("calibrate").description("Show calibration d
     );
     return;
   }
-  const registry = JSON.parse(readFileSync12(registryPath, "utf-8"));
-  const summary = JSON.parse(readFileSync12(summaryPath, "utf-8"));
+  const registry = JSON.parse(readFileSync13(registryPath, "utf-8"));
+  const summary = JSON.parse(readFileSync13(summaryPath, "utf-8"));
   const projectName = options.project ?? registry.project ?? getProjectName();
   const actuals = /* @__PURE__ */ new Map();
   for (const session of summary.sessions) {
@@ -12200,7 +12361,7 @@ Calibration summary (${drifts.length} features with data):`));
 // src/commands/estimate.ts
 import { Command as Command10 } from "commander";
 import chalk11 from "chalk";
-var estimateCommand = new Command10("estimate").description("Quick single-feature estimate from a description").argument("<description>", "Feature description").option("-c, --complexity <size>", "Override complexity (S/M/L/XL)").option("--category <cat>", "Feature category", "general").option("--no-ai", "Skip AI complexity scoring, use heuristic only").action(
+var estimateCommand = new Command10("estimate").description("Quick single-feature estimate from a description").argument("<description>", "Feature description").option("-c, --complexity <size>", "Override complexity (S/M/L/XL)").option("--category <cat>", "Feature category", "general").option("--no-ai", "Skip AI complexity scoring, use heuristic only").option("--provider <provider>", "LLM provider for AI scoring (anthropic, openai)").action(
   async (description, options) => {
     const data = loadData();
     const feature = {
@@ -12217,7 +12378,7 @@ var estimateCommand = new Command10("estimate").description("Quick single-featur
     if (options.complexity) {
       complexitySource = "manual";
     } else if (options.ai !== false) {
-      const aiResult = await scoreComplexityAI(description);
+      const aiResult = await scoreComplexityAI(description, { provider: options.provider });
       if (aiResult) {
         feature.complexity = aiResult.complexity;
         feature.dependencies = aiResult.dependencies;
@@ -12228,7 +12389,7 @@ var estimateCommand = new Command10("estimate").description("Quick single-featur
         feature.complexity = scoreComplexity(feature);
         console.log(
           chalk11.dim(
-            "  (AI scoring unavailable \u2014 using heuristic. Set ANTHROPIC_API_KEY for richer estimates)\n"
+            "  (AI scoring unavailable \u2014 using heuristic. Set ANTHROPIC_API_KEY or OPENAI_API_KEY for richer estimates)\n"
           )
         );
       }
@@ -12284,7 +12445,7 @@ var estimateCommand = new Command10("estimate").description("Quick single-featur
 
 // src/commands/validate.ts
 import { Command as Command11 } from "commander";
-import { readFileSync as readFileSync13, existsSync as existsSync13 } from "fs";
+import { readFileSync as readFileSync14, existsSync as existsSync13 } from "fs";
 import { resolve as resolve13 } from "path";
 import chalk12 from "chalk";
 var validateCommand = new Command11("validate").description("Validate a spec file format without running full analysis").argument("<spec>", "Path to the spec markdown file").action((specPath) => {
@@ -12293,7 +12454,7 @@ var validateCommand = new Command11("validate").description("Validate a spec fil
     console.error(chalk12.red(`Spec file not found: ${fullPath}`));
     process.exit(1);
   }
-  const content3 = readFileSync13(fullPath, "utf-8");
+  const content3 = readFileSync14(fullPath, "utf-8");
   console.log(chalk12.bold("\nFathom \u2014 Validate Spec"));
   console.log(chalk12.dim("\u2500".repeat(50)));
   console.log(chalk12.dim(`File: ${fullPath}`));
@@ -12362,7 +12523,7 @@ var validateCommand = new Command11("validate").description("Validate a spec fil
 
 // src/commands/velocity.ts
 import { Command as Command12 } from "commander";
-import { readFileSync as readFileSync14, existsSync as existsSync14 } from "fs";
+import { readFileSync as readFileSync15, existsSync as existsSync14 } from "fs";
 import { resolve as resolve14 } from "path";
 import chalk13 from "chalk";
 import Table8 from "cli-table3";
@@ -12685,8 +12846,8 @@ var velocityCommand = new Command12("velocity").description("Show velocity metri
       );
       return;
     }
-    const registry = JSON.parse(readFileSync14(registryPath, "utf-8"));
-    const summary = JSON.parse(readFileSync14(summaryPath, "utf-8"));
+    const registry = JSON.parse(readFileSync15(registryPath, "utf-8"));
+    const summary = JSON.parse(readFileSync15(summaryPath, "utf-8"));
     const projectName = options.project ?? registry.project ?? getProjectName();
     const data = loadData();
     const featureDataMap = /* @__PURE__ */ new Map();
@@ -12823,10 +12984,24 @@ Fathom \u2014 Velocity: ${projectName}`));
 
 // src/commands/init.ts
 import { Command as Command13 } from "commander";
-import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync9, existsSync as existsSync15 } from "fs";
-import { resolve as resolve15 } from "path";
+import {
+  writeFileSync as writeFileSync8,
+  mkdirSync as mkdirSync9,
+  existsSync as existsSync15,
+  readFileSync as readFileSync16,
+  readdirSync as readdirSync3
+} from "fs";
+import { resolve as resolve15, dirname as dirname6 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { execSync } from "child_process";
 import chalk14 from "chalk";
-var initCommand = new Command13("init").description("Initialize Fathom global config").option("--convex-url <url>", "Convex deployment URL").option("--team <name>", "Team name").option("--admin-key <key>", "Anthropic Admin API key (sk-ant-admin...)").action((options) => {
+import { confirm as confirm3 } from "@inquirer/prompts";
+var initCommand = new Command13("init").description("Initialize Fathom: create global config and scaffold project directory").option("--convex-url <url>", "Convex deployment URL").option("--team <name>", "Team name").option("--admin-key <key>", "Anthropic Admin API key (sk-ant-admin...)").option("--project <name>", "Project name (auto-detected from package.json if omitted)").option("--project-dir <dir>", "Project directory (defaults to current directory)").action(async (options) => {
+  const projectDir = options.projectDir ? resolve15(options.projectDir) : process.cwd();
+  const projectName = options.project ?? detectProjectName(projectDir);
+  console.log(chalk14.bold(`
+Fathom \u2014 Init: ${projectName}`));
+  console.log(chalk14.dim("\u2500".repeat(50)));
   const configDir = resolve15(
     process.env.HOME ?? process.env.USERPROFILE ?? ".",
     ".config",
@@ -12837,9 +13012,7 @@ var initCommand = new Command13("init").description("Initialize Fathom global co
   let existing = {};
   if (existsSync15(configPath)) {
     try {
-      existing = JSON.parse(
-        __require("fs").readFileSync(configPath, "utf-8")
-      );
+      existing = JSON.parse(readFileSync16(configPath, "utf-8"));
     } catch {
     }
   }
@@ -12851,29 +13024,80 @@ var initCommand = new Command13("init").description("Initialize Fathom global co
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   writeFileSync8(configPath, JSON.stringify(config, null, 2));
-  console.log(chalk14.bold("\nFathom \u2014 Init"));
-  console.log(chalk14.dim("\u2500".repeat(40)));
+  console.log(chalk14.green(`  \u2713 Global config: ${configPath}`));
   if (options.convexUrl) {
-    console.log(chalk14.green(`  \u2713 Convex URL: ${options.convexUrl}`));
+    console.log(chalk14.dim(`    Convex URL: ${options.convexUrl}`));
   }
   if (options.team) {
-    console.log(chalk14.green(`  \u2713 Team: ${options.team}`));
+    console.log(chalk14.dim(`    Team: ${options.team}`));
   }
-  if (options.adminKey) {
-    console.log(chalk14.green(`  \u2713 Admin API key: ${options.adminKey.slice(0, 16)}...`));
+  console.log("");
+  scaffoldProject(projectName, { projectDir });
+  let claudeDetected = false;
+  try {
+    execSync("which claude", { stdio: "ignore" });
+    claudeDetected = true;
+  } catch {
   }
-  console.log(chalk14.dim(`
-  Config saved: ${configPath}`));
-  console.log(
-    chalk14.dim(
-      "  Set CONVEX_URL env var or pass --convex-url to enable sync.\n"
-    )
-  );
+  if (claudeDetected) {
+    console.log("");
+    console.log(chalk14.cyan("  Claude Code detected!"));
+    const installPlugin = await confirm3({
+      message: "Install Fathom plugin for Claude Code? (adds skills + MCP config)",
+      default: true
+    });
+    if (installPlugin) {
+      const __dirname2 = dirname6(fileURLToPath2(import.meta.url));
+      let pluginSource = resolve15(__dirname2, "../plugins/fathom");
+      if (!existsSync15(pluginSource)) {
+        pluginSource = resolve15(__dirname2, "../../plugins/fathom");
+      }
+      const skillsSource = resolve15(pluginSource, "skills");
+      if (existsSync15(skillsSource)) {
+        const skillDirs = readdirSync3(skillsSource, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+        for (const skillDir of skillDirs) {
+          const src = resolve15(skillsSource, skillDir, "SKILL.md");
+          if (!existsSync15(src)) continue;
+          const destDir = resolve15(
+            projectDir,
+            ".claude",
+            "skills",
+            "fathom",
+            skillDir
+          );
+          mkdirSync9(destDir, { recursive: true });
+          writeFileSync8(
+            resolve15(destDir, "SKILL.md"),
+            readFileSync16(src, "utf-8")
+          );
+        }
+        console.log(chalk14.green("  \u2713 Claude Code skills installed"));
+      }
+      const pluginJsonSrc = resolve15(
+        pluginSource,
+        ".claude-plugin",
+        "plugin.json"
+      );
+      if (existsSync15(pluginJsonSrc)) {
+        const destDir = resolve15(projectDir, ".claude-plugin");
+        mkdirSync9(destDir, { recursive: true });
+        writeFileSync8(
+          resolve15(destDir, "plugin.json"),
+          readFileSync16(pluginJsonSrc, "utf-8")
+        );
+        console.log(chalk14.green("  \u2713 Plugin manifest installed"));
+      }
+    }
+  }
+  console.log(chalk14.bold(`
+\u2713 Fathom initialized for "${projectName}"`));
+  console.log(chalk14.dim("  Next: git add .fathom && git commit"));
+  console.log(chalk14.dim("  Then: fathom analyze  (to build feature registry)\n"));
 });
 
 // src/commands/rename.ts
 import { Command as Command14 } from "commander";
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync9, existsSync as existsSync16 } from "fs";
+import { readFileSync as readFileSync17, writeFileSync as writeFileSync9, existsSync as existsSync16 } from "fs";
 import { resolve as resolve16 } from "path";
 import chalk15 from "chalk";
 var renameCommand = new Command14("rename").description("Rename the project in all .claude/te/ config files").argument("<name>", "New project name").action((name) => {
@@ -12894,7 +13118,7 @@ var renameCommand = new Command14("rename").description("Rename the project in a
   let updated = 0;
   for (const filePath of jsonFiles) {
     if (!existsSync16(filePath)) continue;
-    const data = JSON.parse(readFileSync15(filePath, "utf-8"));
+    const data = JSON.parse(readFileSync17(filePath, "utf-8"));
     if (data.project) {
       oldName = data.project;
       data.project = name;
@@ -12904,7 +13128,7 @@ var renameCommand = new Command14("rename").description("Rename the project in a
   }
   const skillPath = resolve16(baseDir, ".claude", "skills", "fathom", "SKILL.md");
   if (existsSync16(skillPath)) {
-    const content3 = readFileSync15(skillPath, "utf-8");
+    const content3 = readFileSync17(skillPath, "utf-8");
     const newContent = content3.replaceAll(oldName, name);
     if (newContent !== content3) {
       writeFileSync9(skillPath, newContent);
@@ -12913,7 +13137,7 @@ var renameCommand = new Command14("rename").description("Rename the project in a
   }
   const hookPath = resolve16(baseDir, ".claude", "hooks", "te-session-sync.sh");
   if (existsSync16(hookPath)) {
-    const content3 = readFileSync15(hookPath, "utf-8");
+    const content3 = readFileSync17(hookPath, "utf-8");
     const newContent = content3.replaceAll(oldName, name);
     if (newContent !== content3) {
       writeFileSync9(hookPath, newContent);
@@ -12929,26 +13153,485 @@ var renameCommand = new Command14("rename").description("Rename the project in a
 
 // src/commands/research.ts
 import { Command as Command15 } from "commander";
+import { writeFileSync as writeFileSync10, existsSync as existsSync17 } from "fs";
+import { resolve as resolve17 } from "path";
 import chalk16 from "chalk";
-var researchCommand = new Command15("research").description("Check for pricing updates and intelligence improvements").action(async () => {
-  console.log(chalk16.bold("\nFathom \u2014 Research Pulse"));
-  console.log(chalk16.dim("\u2500".repeat(50)));
-  console.log(chalk16.dim("  Checking for updates...\n"));
-  console.log(chalk16.yellow("  Research pulse not yet implemented."));
-  console.log(chalk16.dim("  This will check for model pricing changes, new guardrail templates,"));
-  console.log(chalk16.dim("  and community-calibrated task profiles.\n"));
+
+// src/fetchers/types.ts
+var RemoteManifest = external_exports.object({
+  version: external_exports.number(),
+  updated: external_exports.string(),
+  models: external_exports.array(ModelPricing),
+  recommendations: external_exports.record(external_exports.string(), AgentRecommendation)
+});
+var IntelligenceSuggestion = external_exports.object({
+  type: external_exports.enum(["new-model", "price-change", "recommendation-change", "deprecation", "general"]),
+  model: external_exports.string().optional(),
+  description: external_exports.string(),
+  confidence: external_exports.enum(["high", "medium", "low"])
 });
+var IntelligenceResponse = external_exports.object({
+  suggestions: external_exports.array(IntelligenceSuggestion),
+  summary: external_exports.string()
+});
+
+// src/fetchers/pricing-fetcher.ts
+var MANIFEST_URL = "https://raw.githubusercontent.com/anthropics/fathom/main/data/remote-manifest.json";
+var DEFAULT_TIMEOUT_MS = 1e4;
+async function fetchPricing(options = {}) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  if (options.offline) {
+    return loadLocalPricing(now);
+  }
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(
+      () => controller.abort(),
+      options.timeoutMs ?? DEFAULT_TIMEOUT_MS
+    );
+    if (options.verbose) {
+      console.log(`  Fetching: ${MANIFEST_URL}`);
+    }
+    const response = await fetch(MANIFEST_URL, { signal: controller.signal });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const json = await response.json();
+    const manifest = RemoteManifest.parse(json);
+    return {
+      data: {
+        models: manifest.models,
+        recommendations: manifest.recommendations,
+        manifestVersion: manifest.version,
+        manifestDate: manifest.updated
+      },
+      source: "remote",
+      stale: false,
+      fetchedAt: now
+    };
+  } catch (err) {
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    if (options.verbose) {
+      console.log(`  Remote fetch failed: ${errorMsg}`);
+    }
+    return loadLocalPricing(now, errorMsg);
+  }
+}
+function loadLocalPricing(fetchedAt, error) {
+  const data = loadData();
+  return {
+    data: {
+      models: data.models,
+      recommendations: data.recommendations,
+      manifestVersion: 0,
+      manifestDate: "local"
+    },
+    source: "local",
+    stale: true,
+    fetchedAt,
+    error: error ?? "offline mode"
+  };
+}
+
+// src/fetchers/intelligence-fetcher.ts
+async function getAnthropicClient3(apiKey) {
+  const { default: AnthropicSDK } = await import("@anthropic-ai/sdk");
+  return new AnthropicSDK({ apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY });
+}
+var SYSTEM_PROMPT2 = `You are an AI model pricing analyst. Given the current model pricing and agent recommendations for an AI development workflow tool, review them and suggest updates.
+
+You should:
+1. Flag any models with outdated pricing based on your knowledge
+2. Suggest new models that should be added (only well-established models from major providers)
+3. Flag any recommendation changes (e.g., if a newer model is better suited for a task category)
+4. Note any models that may be deprecated or renamed
+
+Respond with ONLY valid JSON matching this schema:
+{
+  "suggestions": [
+    {
+      "type": "new-model" | "price-change" | "recommendation-change" | "deprecation" | "general",
+      "model": "model-id (optional)",
+      "description": "what changed or should change",
+      "confidence": "high" | "medium" | "low"
+    }
+  ],
+  "summary": "one sentence overall assessment"
+}
+
+If everything looks current, return an empty suggestions array with a summary saying so.`;
+async function fetchIntelligence(models, recommendations, options = {}) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const apiKey = options.apiKey ?? process.env.ANTHROPIC_API_KEY;
+  if (options.offline || !apiKey) {
+    if (options.verbose) {
+      console.log(
+        apiKey ? "  Intelligence: skipped (offline mode)" : "  Intelligence: skipped (no ANTHROPIC_API_KEY)"
+      );
+    }
+    return null;
+  }
+  try {
+    if (options.verbose) {
+      console.log("  Intelligence: querying Claude Haiku...");
+    }
+    const client = await getAnthropicClient3(apiKey);
+    const modelsDesc = models.map((m) => `${m.id} (${m.name}): $${m.input_per_mtok}/$${m.output_per_mtok} per MTok, tier=${m.tier}`).join("\n");
+    const recsDesc = Object.entries(recommendations).map(([cat, rec]) => `${cat}: ${rec.model} \u2014 ${rec.reason}`).join("\n");
+    const userPrompt = `Current model pricing:
+${modelsDesc}
+
+Current agent recommendations:
+${recsDesc}`;
+    const response = await client.messages.create({
+      model: "claude-haiku-4-5-20251001",
+      max_tokens: 1024,
+      system: SYSTEM_PROMPT2,
+      messages: [{ role: "user", content: userPrompt }]
+    });
+    const textBlock = response.content.find((block) => block.type === "text");
+    if (!textBlock || textBlock.type !== "text") {
+      throw new Error("No text content in response");
+    }
+    let jsonText = textBlock.text.trim();
+    if (jsonText.startsWith("```")) {
+      jsonText = jsonText.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "");
+    }
+    const parsed = JSON.parse(jsonText);
+    const intelligence = IntelligenceResponse.parse(parsed);
+    return {
+      data: intelligence,
+      source: "api",
+      stale: false,
+      fetchedAt: now
+    };
+  } catch (err) {
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    if (options.verbose) {
+      console.log(`  Intelligence fetch failed: ${errorMsg}`);
+    }
+    return null;
+  }
+}
+
+// src/fetchers/merge.ts
+function mergePricingData(localModels, remoteModels, localRecs, remoteRecs, suggestions = []) {
+  const mergedModels = [];
+  const modelChanges = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const remote of remoteModels) {
+    seenIds.add(remote.id);
+    const local = localModels.find((m) => m.id === remote.id);
+    if (!local) {
+      mergedModels.push(remote);
+      modelChanges.push({ id: remote.id, name: remote.name, status: "added" });
+      continue;
+    }
+    const fields = [];
+    const pricingKeys = [
+      "input_per_mtok",
+      "output_per_mtok",
+      "cache_read_per_mtok",
+      "batch_discount"
+    ];
+    for (const key of pricingKeys) {
+      if (local[key] !== remote[key]) {
+        fields.push({ field: key, old: local[key], new: remote[key] });
+      }
+    }
+    if (local.tier !== remote.tier) {
+      fields.push({ field: "tier", old: local.tier, new: remote.tier });
+    }
+    mergedModels.push(remote);
+    modelChanges.push({
+      id: remote.id,
+      name: remote.name,
+      status: fields.length > 0 ? "updated" : "unchanged",
+      fields: fields.length > 0 ? fields : void 0
+    });
+  }
+  for (const local of localModels) {
+    if (!seenIds.has(local.id)) {
+      mergedModels.push(local);
+      modelChanges.push({ id: local.id, name: local.name, status: "unchanged" });
+    }
+  }
+  const mergedRecs = { ...localRecs };
+  const recChanges = [];
+  for (const [cat, remoteRec] of Object.entries(remoteRecs)) {
+    const localRec = localRecs[cat];
+    if (!localRec) {
+      mergedRecs[cat] = remoteRec;
+      recChanges.push({
+        category: cat,
+        status: "added",
+        newModel: remoteRec.model,
+        reason: remoteRec.reason
+      });
+    } else if (localRec.model !== remoteRec.model || localRec.reason !== remoteRec.reason) {
+      mergedRecs[cat] = remoteRec;
+      recChanges.push({
+        category: cat,
+        status: "updated",
+        oldModel: localRec.model,
+        newModel: remoteRec.model,
+        reason: remoteRec.reason
+      });
+    } else {
+      recChanges.push({ category: cat, status: "unchanged" });
+    }
+  }
+  return {
+    models: {
+      merged: mergedModels,
+      changes: modelChanges,
+      added: modelChanges.filter((c) => c.status === "added").length,
+      updated: modelChanges.filter((c) => c.status === "updated").length,
+      unchanged: modelChanges.filter((c) => c.status === "unchanged").length
+    },
+    recommendations: {
+      merged: mergedRecs,
+      changes: recChanges,
+      added: recChanges.filter((c) => c.status === "added").length,
+      updated: recChanges.filter((c) => c.status === "updated").length,
+      unchanged: recChanges.filter((c) => c.status === "unchanged").length
+    },
+    suggestions
+  };
+}
+function generateModelsYaml(models) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  let yaml = `# Model pricing registry \u2014 updated via \`fathom research\`
+`;
+  yaml += `# Last verified: ${date}
+
+`;
+  yaml += `models:
+`;
+  for (const m of models) {
+    yaml += `  - id: ${m.id}
+`;
+    yaml += `    provider: ${m.provider}
+`;
+    yaml += `    name: ${m.name}
+`;
+    yaml += `    input_per_mtok: ${m.input_per_mtok.toFixed(2)}
+`;
+    yaml += `    output_per_mtok: ${m.output_per_mtok.toFixed(2)}
+`;
+    yaml += `    cache_read_per_mtok: ${m.cache_read_per_mtok.toFixed(2)}
+`;
+    yaml += `    batch_discount: ${m.batch_discount.toFixed(2)}
+`;
+    yaml += `    tier: ${m.tier}
+
+`;
+  }
+  return yaml;
+}
+function generateAgentsYaml(recommendations) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  let yaml = `# Agent/model recommendation mappings
+`;
+  yaml += `# Maps task categories to recommended models
+`;
+  yaml += `# Last updated: ${date}
+
+`;
+  yaml += `recommendations:
+`;
+  for (const [category, rec] of Object.entries(recommendations)) {
+    yaml += `  ${category}:
+`;
+    yaml += `    model: ${rec.model}
+`;
+    yaml += `    reason: ${rec.reason}
+
+`;
+  }
+  return yaml;
+}
+
+// src/commands/research.ts
+function findDataDir2() {
+  const bundled = resolve17(import.meta.dirname ?? __dirname, "data");
+  if (existsSync17(resolve17(bundled, "models.yaml"))) return bundled;
+  return resolve17(import.meta.dirname ?? __dirname, "../../../../data");
+}
+var researchCommand = new Command15("research").description("Check and update model pricing data (fetches live data)").option("--update", "Update local data files with latest pricing").option("--sync", "Also sync updated pricing to Convex").option("--check", "Check for differences without updating (default)").option("--offline", "Skip remote fetches, use local data only").option("--verbose", "Show fetch sources and timing details").action(async (options) => {
+  console.log(chalk16.bold("\nFathom \u2014 Research: Model Pricing"));
+  console.log(chalk16.dim("\u2500".repeat(55)));
+  const startTime = Date.now();
+  let localData;
+  try {
+    localData = loadData();
+  } catch {
+    console.log(chalk16.yellow("  Warning: could not load local data files"));
+    localData = { models: [], recommendations: {} };
+  }
+  const [pricingResult, intelligenceResult] = await Promise.all([
+    fetchPricing({ offline: options.offline, verbose: options.verbose }),
+    fetchIntelligence(localData.models, localData.recommendations, {
+      offline: options.offline,
+      verbose: options.verbose
+    })
+  ]);
+  if (options.verbose) {
+    const elapsed = Date.now() - startTime;
+    console.log(chalk16.dim(`
+  Fetch time: ${elapsed}ms`));
+    console.log(chalk16.dim(`  Pricing source: ${pricingResult.source}`));
+    if (intelligenceResult) {
+      console.log(chalk16.dim(`  Intelligence source: ${intelligenceResult.source}`));
+    }
+  }
+  if (pricingResult.stale) {
+    console.log(chalk16.yellow(`
+  \u26A0 Using local data (${pricingResult.error ?? "stale"})`));
+  } else {
+    console.log(chalk16.green(`
+  Pricing: live data (manifest v${pricingResult.data.manifestVersion}, ${pricingResult.data.manifestDate})`));
+  }
+  const mergeResult = mergePricingData(
+    localData.models,
+    pricingResult.data.models,
+    localData.recommendations,
+    pricingResult.data.recommendations,
+    intelligenceResult?.data.suggestions ?? []
+  );
+  displayPricingReport(mergeResult);
+  if (intelligenceResult?.data) {
+    displayIntelligence(intelligenceResult.data);
+  }
+  displayRecommendations(mergeResult);
+  if (options.update) {
+    const dataDir = findDataDir2();
+    const modelsPath = resolve17(dataDir, "models.yaml");
+    const agentsPath = resolve17(dataDir, "agents.yaml");
+    writeFileSync10(modelsPath, generateModelsYaml(mergeResult.models.merged));
+    console.log(chalk16.green(`
+  Updated: ${modelsPath}`));
+    writeFileSync10(agentsPath, generateAgentsYaml(mergeResult.recommendations.merged));
+    console.log(chalk16.green(`  Updated: ${agentsPath}`));
+  }
+  if (options.sync) {
+    await syncToConvex(mergeResult);
+  }
+  if (options.verbose) {
+    const totalElapsed = Date.now() - startTime;
+    console.log(chalk16.dim(`
+  Total time: ${totalElapsed}ms`));
+  }
+  console.log();
+});
+function displayPricingReport(result) {
+  const { models } = result;
+  if (models.added === 0 && models.updated === 0) {
+    console.log(chalk16.green(`  All model pricing is up to date.`));
+    console.log(chalk16.dim(`  ${models.merged.length} models checked.`));
+  } else {
+    if (models.updated > 0) {
+      console.log(chalk16.yellow(`
+  ${models.updated} pricing change(s) found:`));
+      for (const change of models.changes) {
+        if (change.status === "updated" && change.fields) {
+          for (const f of change.fields) {
+            console.log(chalk16.dim(`    ${change.name}: ${f.field} ${f.old} \u2192 ${f.new}`));
+          }
+        }
+      }
+    }
+    if (models.added > 0) {
+      console.log(chalk16.yellow(`
+  ${models.added} new model(s) found:`));
+      for (const change of models.changes) {
+        if (change.status === "added") {
+          const m = models.merged.find((x) => x.id === change.id);
+          if (m) {
+            console.log(
+              chalk16.dim(`    ${m.name} (${m.tier}): $${m.input_per_mtok}/$${m.output_per_mtok} per MTok`)
+            );
+          }
+        }
+      }
+    }
+  }
+}
+function displayIntelligence(intelligence) {
+  if (intelligence.suggestions.length === 0) {
+    console.log(chalk16.dim(`
+  Intelligence: ${intelligence.summary}`));
+    return;
+  }
+  console.log(chalk16.cyan(`
+  Intelligence suggestions (${intelligence.suggestions.length}):`));
+  for (const s of intelligence.suggestions) {
+    const badge = s.confidence === "high" ? chalk16.red("HIGH") : s.confidence === "medium" ? chalk16.yellow("MED") : chalk16.dim("LOW");
+    const model = s.model ? chalk16.dim(` [${s.model}]`) : "";
+    console.log(`    ${badge} ${s.description}${model}`);
+  }
+  console.log(chalk16.dim(`  Summary: ${intelligence.summary}`));
+  console.log(chalk16.dim(`  Note: Task profiles are team-calibrated and shown as suggestions only.`));
+}
+function displayRecommendations(result) {
+  const { recommendations } = result;
+  if (recommendations.updated > 0 || recommendations.added > 0) {
+    console.log(chalk16.yellow(`
+  Recommendation changes:`));
+    for (const change of recommendations.changes) {
+      if (change.status === "updated") {
+        console.log(chalk16.dim(`    ${change.category}: ${change.oldModel} \u2192 ${change.newModel}`));
+      } else if (change.status === "added") {
+        console.log(chalk16.dim(`    ${change.category}: ${change.newModel} (new)`));
+      }
+    }
+  }
+  console.log(chalk16.dim("\n  Current model recommendations:"));
+  console.log(chalk16.dim("    S/M complexity \u2192 Haiku 4.5 ($1/$5 per MTok) \u2014 fast, cheap"));
+  console.log(chalk16.dim("    L complexity   \u2192 Sonnet 4.6 ($3/$15 per MTok) \u2014 balanced"));
+  console.log(chalk16.dim("    XL complexity  \u2192 Opus 4.6 ($15/$75 per MTok) \u2014 highest quality"));
+  console.log(
+    chalk16.dim("\n    Tip: Enable prompt caching to save 90% on input tokens for repeated context.")
+  );
+}
+async function syncToConvex(result) {
+  const client = getConvexClient();
+  if (!client) {
+    logConvexStatus(false);
+    return;
+  }
+  let synced = 0;
+  for (const m of result.models.merged) {
+    try {
+      await client.mutation(api.modelPricing.upsert, {
+        model: m.name,
+        provider: m.provider,
+        inputPerMTok: m.input_per_mtok,
+        outputPerMTok: m.output_per_mtok,
+        cacheReadPerMTok: m.cache_read_per_mtok,
+        batchDiscount: m.batch_discount
+      });
+      synced++;
+    } catch {
+    }
+  }
+  logConvexStatus(synced > 0);
+  if (synced > 0) {
+    console.log(chalk16.dim(`  ${synced} models synced to Convex.`));
+  }
+}
 
 // src/commands/project.ts
 import { Command as Command16 } from "commander";
-import { existsSync as existsSync17 } from "fs";
-import { resolve as resolve17 } from "path";
+import { existsSync as existsSync18 } from "fs";
+import { resolve as resolve18 } from "path";
 import chalk17 from "chalk";
 var projectCommand = new Command16("project").description("View or update project intent and regenerate projections").option("--regenerate", "Regenerate projection files from current intent").action(async (options) => {
   try {
     const cwd = process.cwd();
-    const intentPath = resolve17(cwd, ".fathom", "intent.yaml");
-    if (!existsSync17(intentPath)) {
+    const intentPath = resolve18(cwd, ".fathom", "intent.yaml");
+    if (!existsSync18(intentPath)) {
       console.log(chalk17.yellow("\n  No project intent found."));
       console.log(chalk17.dim("  Run `fathom` to set up a project with intent capture.\n"));
       return;
@@ -13007,13 +13690,13 @@ var projectCommand = new Command16("project").description("View or update projec
         console.log(chalk17.bold("  Opinions:") + " " + intent.tech.opinions.join(", "));
       }
     }
-    const projectionsDir = resolve17(cwd, ".fathom", "projections");
-    const hasProjections = existsSync17(projectionsDir);
+    const projectionsDir = resolve18(cwd, ".fathom", "projections");
+    const hasProjections = existsSync18(projectionsDir);
     console.log(chalk17.bold("\n  Projections:") + (hasProjections ? chalk17.green(" generated") : chalk17.yellow(" not generated")));
     if (hasProjections) {
       const targets = ["claude/SKILL.md", "cursor/.cursorrules", "generic/SYSTEM_PROMPT.md"];
       for (const t of targets) {
-        const exists = existsSync17(resolve17(projectionsDir, t));
+        const exists = existsSync18(resolve18(projectionsDir, t));
         console.log(`    ${exists ? "\u2713" : "\xB7"} ${t}`);
       }
     }
@@ -13030,14 +13713,14 @@ var projectCommand = new Command16("project").description("View or update projec
 
 // src/commands/report.ts
 import { Command as Command17 } from "commander";
-import { writeFileSync as writeFileSync10, mkdirSync as mkdirSync10, existsSync as existsSync18 } from "fs";
-import { resolve as resolve18, join as join4 } from "path";
+import { writeFileSync as writeFileSync11, mkdirSync as mkdirSync10, existsSync as existsSync19 } from "fs";
+import { resolve as resolve19, join as join4 } from "path";
 import chalk18 from "chalk";
 
 // ../store/dist/index.js
 import { randomUUID } from "crypto";
 import { mkdir, readFile, rename, writeFile } from "fs/promises";
-import { dirname as dirname6, join as join3 } from "path";
+import { dirname as dirname7, join as join3 } from "path";
 import { readFile as readFile2 } from "fs/promises";
 import { join as join22 } from "path";
 var OverheadBreakdownSchema = external_exports.object({
@@ -13228,7 +13911,7 @@ function generateId() {
   return randomUUID();
 }
 async function ensureDir(path) {
-  await mkdir(dirname6(path), { recursive: true });
+  await mkdir(dirname7(path), { recursive: true });
 }
 async function readJsonFile(path) {
   try {
@@ -14661,12 +15344,12 @@ Fathom \u2014 Project Report: ${projectName}`));
         "reports",
         `${projectName}-${today}.${ext}`
       );
-      const outputPath = options.output ? resolve18(options.output) : defaultPath;
-      const dir = resolve18(outputPath, "..");
-      if (!existsSync18(dir)) {
+      const outputPath = options.output ? resolve19(options.output) : defaultPath;
+      const dir = resolve19(outputPath, "..");
+      if (!existsSync19(dir)) {
         mkdirSync10(dir, { recursive: true });
       }
-      writeFileSync10(outputPath, report, "utf-8");
+      writeFileSync11(outputPath, report, "utf-8");
       console.log(
         chalk18.green(`
   \u2713 Report generated: ${outputPath}`)
@@ -14682,17 +15365,17 @@ Fathom \u2014 Project Report: ${projectName}`));
 
 // src/commands/contribute.ts
 import { Command as Command18 } from "commander";
-import { readFileSync as readFileSync16, writeFileSync as writeFileSync11, existsSync as existsSync19, mkdirSync as mkdirSync11 } from "fs";
-import { resolve as resolve19 } from "path";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync12, existsSync as existsSync20, mkdirSync as mkdirSync11 } from "fs";
+import { resolve as resolve20 } from "path";
 import chalk19 from "chalk";
-import { confirm as confirm3 } from "@inquirer/prompts";
+import { confirm as confirm4 } from "@inquirer/prompts";
 function loadCalibratedProfiles() {
   const profiles = [];
-  const registryPath = resolve19(process.cwd(), ".claude", "te", "registry.json");
-  const summaryPath = resolve19(process.cwd(), ".claude", "te", "tracking", "summary.json");
-  if (existsSync19(registryPath) && existsSync19(summaryPath)) {
-    const registry = JSON.parse(readFileSync16(registryPath, "utf-8"));
-    const summary = JSON.parse(readFileSync16(summaryPath, "utf-8"));
+  const registryPath = resolve20(process.cwd(), ".claude", "te", "registry.json");
+  const summaryPath = resolve20(process.cwd(), ".claude", "te", "tracking", "summary.json");
+  if (existsSync20(registryPath) && existsSync20(summaryPath)) {
+    const registry = JSON.parse(readFileSync18(registryPath, "utf-8"));
+    const summary = JSON.parse(readFileSync18(summaryPath, "utf-8"));
     const actuals = /* @__PURE__ */ new Map();
     for (const session of summary.sessions ?? []) {
       if (!session.featureId || session.status === "untagged") continue;
@@ -14769,7 +15452,7 @@ var contributeCommand = new Command18("contribute").description("Share anonymize
   }
   if (!options.yes) {
     try {
-      const confirmed = await confirm3({
+      const confirmed = await confirm4({
         message: "Share this data?",
         default: false
       });
@@ -14782,12 +15465,12 @@ var contributeCommand = new Command18("contribute").description("Share anonymize
       return;
     }
   }
-  const contributionsDir = resolve19(process.cwd(), ".fathom", "contributions");
+  const contributionsDir = resolve20(process.cwd(), ".fathom", "contributions");
   mkdirSync11(contributionsDir, { recursive: true });
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const outputPath = resolve19(contributionsDir, `${today}.json`);
+  const outputPath = resolve20(contributionsDir, `${today}.json`);
   const json = exportContribution(dataPoints);
-  writeFileSync11(outputPath, json, "utf-8");
+  writeFileSync12(outputPath, json, "utf-8");
   console.log(chalk19.green(`
   \u2713 Contribution saved to .fathom/contributions/${today}.json`));
   console.log(chalk19.green("  \u2713 Thank you! This helps make Fathom better for everyone."));
@@ -14796,14 +15479,14 @@ var contributeCommand = new Command18("contribute").description("Share anonymize
 
 // src/commands/feedback.ts
 import { Command as Command19 } from "commander";
-import { writeFileSync as writeFileSync12, mkdirSync as mkdirSync12, readFileSync as readFileSync17, existsSync as existsSync20 } from "fs";
-import { resolve as resolve20, join as join5 } from "path";
+import { writeFileSync as writeFileSync13, mkdirSync as mkdirSync12, readFileSync as readFileSync19, existsSync as existsSync21 } from "fs";
+import { resolve as resolve21, join as join5 } from "path";
 import chalk20 from "chalk";
 function getIntentSummary() {
   try {
-    const intentPath = resolve20(process.cwd(), ".fathom", "intent.yaml");
-    if (!existsSync20(intentPath)) return {};
-    const content3 = readFileSync17(intentPath, "utf-8");
+    const intentPath = resolve21(process.cwd(), ".fathom", "intent.yaml");
+    if (!existsSync21(intentPath)) return {};
+    const content3 = readFileSync19(intentPath, "utf-8");
     const projectMatch = content3.match(/^project:\s*(.+)$/m);
     const descMatch = content3.match(/^description:\s*["']?(.+?)["']?\s*$/m);
     return {
@@ -14823,7 +15506,7 @@ function getSystemInfo() {
   };
 }
 function saveFeedback(type, description) {
-  const feedbackDir = resolve20(process.cwd(), ".fathom", "feedback");
+  const feedbackDir = resolve21(process.cwd(), ".fathom", "feedback");
   mkdirSync12(feedbackDir, { recursive: true });
   const sys = getSystemInfo();
   const intent = getIntentSummary();
@@ -14861,7 +15544,7 @@ function saveFeedback(type, description) {
     "Review this file, add any additional details, then email to feedback@fathom.dev"
   );
   lines.push("");
-  writeFileSync12(filepath, lines.join("\n"));
+  writeFileSync13(filepath, lines.join("\n"));
   return filepath;
 }
 var feedbackCommand = new Command19("feedback").description("How to report bugs and request features").option("--bug <description>", "Save a bug report to .fathom/feedback/").option(
@@ -14924,8 +15607,8 @@ import { Command as Command20 } from "commander";
 import chalk21 from "chalk";
 
 // ../sync/dist/index.js
-import { readFileSync as readFileSync18, writeFileSync as writeFileSync13, mkdirSync as mkdirSync13, existsSync as existsSync21 } from "fs";
-import { resolve as resolve21, dirname as dirname7 } from "path";
+import { readFileSync as readFileSync20, writeFileSync as writeFileSync14, mkdirSync as mkdirSync13, existsSync as existsSync23 } from "fs";
+import { resolve as resolve22, dirname as dirname8 } from "path";
 var SyncStatusSchema = external_exports.enum([
   "backlog",
   "todo",
@@ -15605,20 +16288,20 @@ function createProvider(config, apiKey) {
 }
 function getLedgerPath(basePath) {
   const base = basePath ?? process.cwd();
-  return resolve21(base, LEDGER_DIR, LEDGER_FILE);
+  return resolve22(base, LEDGER_DIR, LEDGER_FILE);
 }
 function loadLedger(ledgerPath) {
-  if (existsSync21(ledgerPath)) {
+  if (existsSync23(ledgerPath)) {
     try {
-      return JSON.parse(readFileSync18(ledgerPath, "utf-8"));
+      return JSON.parse(readFileSync20(ledgerPath, "utf-8"));
     } catch {
     }
   }
   return { provider: "", projectKey: "", items: [], lastSync: 0 };
 }
 function saveLedger(ledgerPath, ledger) {
-  mkdirSync13(dirname7(ledgerPath), { recursive: true });
-  writeFileSync13(ledgerPath, JSON.stringify(ledger, null, 2) + "\n");
+  mkdirSync13(dirname8(ledgerPath), { recursive: true });
+  writeFileSync14(ledgerPath, JSON.stringify(ledger, null, 2) + "\n");
 }
 function createSyncManager(config, options) {
   const apiKey = resolveApiKey(config);
@@ -15677,14 +16360,14 @@ function createSyncManager(config, options) {
 }
 
 // src/commands/sync.ts
-import { readFileSync as readFileSync19, existsSync as existsSync23 } from "fs";
-import { resolve as resolve22 } from "path";
+import { readFileSync as readFileSync21, existsSync as existsSync24 } from "fs";
+import { resolve as resolve23 } from "path";
 function loadSyncConfig(options) {
-  const configPath = resolve22(process.cwd(), ".fathom", "sync-config.json");
+  const configPath = resolve23(process.cwd(), ".fathom", "sync-config.json");
   let config = {};
-  if (existsSync23(configPath)) {
+  if (existsSync24(configPath)) {
     try {
-      config = JSON.parse(readFileSync19(configPath, "utf-8"));
+      config = JSON.parse(readFileSync21(configPath, "utf-8"));
     } catch {
     }
   }
@@ -15697,10 +16380,10 @@ function loadSyncConfig(options) {
   };
 }
 function loadPendingSlices() {
-  const registryPath = resolve22(process.cwd(), ".claude", "te", "registry.json");
-  if (!existsSync23(registryPath)) return [];
+  const registryPath = resolve23(process.cwd(), ".claude", "te", "registry.json");
+  if (!existsSync24(registryPath)) return [];
   try {
-    const data = JSON.parse(readFileSync19(registryPath, "utf-8"));
+    const data = JSON.parse(readFileSync21(registryPath, "utf-8"));
     if (!Array.isArray(data.features)) return [];
     return data.features.map((f) => ({
       sliceId: f.id,
@@ -15795,8 +16478,94 @@ Fathom \u2014 Sync to ${config.provider.charAt(0).toUpperCase() + config.provide
   }
 });
 
+// src/commands/install-plugin.ts
+import { Command as Command21 } from "commander";
+import {
+  writeFileSync as writeFileSync15,
+  readFileSync as readFileSync23,
+  mkdirSync as mkdirSync14,
+  existsSync as existsSync25,
+  readdirSync as readdirSync4
+} from "fs";
+import { resolve as resolve24, dirname as dirname9 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import chalk22 from "chalk";
+var installPluginCommand = new Command21("install-plugin").description(
+  "Install Fathom plugin for Claude Code (copies skills + MCP config)"
+).option("--project-dir <dir>", "Target project directory", ".").action((options) => {
+  const projectDir = resolve24(options.projectDir);
+  const __dirname2 = dirname9(fileURLToPath3(import.meta.url));
+  let pluginSource = resolve24(__dirname2, "../plugins/fathom");
+  if (!existsSync25(pluginSource)) {
+    pluginSource = resolve24(__dirname2, "../../plugins/fathom");
+  }
+  if (!existsSync25(pluginSource)) {
+    console.error(
+      chalk22.red("Error: Plugin source files not found at " + pluginSource)
+    );
+    console.error(
+      chalk22.dim("If installed via npm, ensure fathom-cli >= 0.3.3")
+    );
+    process.exit(1);
+  }
+  console.log(chalk22.bold("\nFathom \u2014 Install Plugin"));
+  console.log(chalk22.dim("\u2500".repeat(50)));
+  const skillsSource = resolve24(pluginSource, "skills");
+  if (existsSync25(skillsSource)) {
+    const skillDirs = readdirSync4(skillsSource, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    for (const skillDir of skillDirs) {
+      const src = resolve24(skillsSource, skillDir, "SKILL.md");
+      if (!existsSync25(src)) continue;
+      const destDir = resolve24(
+        projectDir,
+        ".claude",
+        "skills",
+        "fathom",
+        skillDir
+      );
+      mkdirSync14(destDir, { recursive: true });
+      writeFileSync15(resolve24(destDir, "SKILL.md"), readFileSync23(src, "utf-8"));
+      console.log(chalk22.green(`  \u2713 .claude/skills/fathom/${skillDir}/SKILL.md`));
+    }
+  }
+  const pluginJsonSrc = resolve24(
+    pluginSource,
+    ".claude-plugin",
+    "plugin.json"
+  );
+  if (existsSync25(pluginJsonSrc)) {
+    const destDir = resolve24(projectDir, ".claude-plugin");
+    mkdirSync14(destDir, { recursive: true });
+    writeFileSync15(
+      resolve24(destDir, "plugin.json"),
+      readFileSync23(pluginJsonSrc, "utf-8")
+    );
+    console.log(chalk22.green("  \u2713 .claude-plugin/plugin.json"));
+  }
+  const mcpPath = resolve24(projectDir, ".mcp.json");
+  let mcpConfig = { mcpServers: {} };
+  if (existsSync25(mcpPath)) {
+    try {
+      mcpConfig = JSON.parse(readFileSync23(mcpPath, "utf-8"));
+      if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
+    } catch {
+      mcpConfig = { mcpServers: {} };
+    }
+  }
+  mcpConfig.mcpServers.fathom = {
+    command: "npx",
+    args: ["-y", "fathom-mcp@latest", "--project-dir", "."]
+  };
+  writeFileSync15(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  console.log(chalk22.green("  \u2713 .mcp.json (MCP auto-discovery)"));
+  console.log(chalk22.bold("\n\u2713 Fathom plugin installed"));
+  console.log(
+    chalk22.dim("  Skills and MCP config are ready for Claude Code\n")
+  );
+});
+
 // src/index.ts
-var program = new Command21();
+var program = new Command22();
 program.name("fathom").description("Workflow intelligence platform for AI-augmented development").version(VERSION);
 program.addCommand(goCommand, { isDefault: true });
 program.addCommand(intakeCommand);
@@ -15813,6 +16582,7 @@ program.addCommand(projectCommand);
 program.addCommand(contributeCommand);
 program.addCommand(feedbackCommand);
 program.addCommand(syncCommand);
+program.addCommand(installPluginCommand);
 program.addCommand(statusCommand);
 program.addCommand(pricingCommand);
 program.addCommand(validateCommand);