codebrief 1.2.0 → 1.4.0

package/dist/index.js

@@ -79,10 +79,81 @@ var init_utils = __esm({
 });
 
 // src/index.ts
-init_utils();
 import path8 from "path";
 import * as p4 from "@clack/prompts";
-import pc3 from "picocolors";
+
+// src/theme.ts
+import pc from "picocolors";
+var isTTY = !!process.stdout.isTTY;
+var noColor = !!process.env.NO_COLOR;
+var trueColor = !noColor && isTTY && (process.env.COLORTERM === "truecolor" || process.env.COLORTERM === "24bit" || (process.env.TERM ?? "").includes("256color"));
+function rgb(r, g, b) {
+  if (noColor || !isTTY) return (t) => t;
+  if (!trueColor) {
+    return (t) => t;
+  }
+  const open = `\x1B[38;2;${r};${g};${b}m`;
+  const close = "\x1B[39m";
+  return (text2) => `${open}${text2}${close}`;
+}
+var palette = {
+  brand: rgb(122, 162, 247),
+  // #7aa2f7
+  accent: rgb(137, 180, 250),
+  // #89b4fa
+  muted: rgb(84, 92, 126),
+  // #545c7e
+  success: rgb(125, 207, 255),
+  // #7dcfff
+  warn: rgb(178, 174, 166),
+  // #b2aea6 (cool stone, no orange)
+  error: rgb(219, 75, 75)
+  // #db4b4b
+};
+var fallback = {
+  brand: pc.blue,
+  accent: pc.cyan,
+  muted: pc.dim,
+  success: pc.green,
+  warn: pc.yellow,
+  error: pc.red
+};
+function pick(key) {
+  if (noColor || !isTTY) return (t) => t;
+  return trueColor ? palette[key] : fallback[key];
+}
+function gradient(text2, from, to, fallbackFn) {
+  if (noColor || !isTTY) return text2;
+  if (!trueColor) return fallbackFn ? fallbackFn(text2) : text2;
+  const len = text2.length;
+  if (len === 0) return text2;
+  if (len === 1) return `\x1B[38;2;${from[0]};${from[1]};${from[2]}m${text2}\x1B[39m`;
+  let result = "";
+  for (let i = 0; i < len; i++) {
+    const ratio = i / (len - 1);
+    const r = Math.round(from[0] + (to[0] - from[0]) * ratio);
+    const g = Math.round(from[1] + (to[1] - from[1]) * ratio);
+    const b = Math.round(from[2] + (to[2] - from[2]) * ratio);
+    result += `\x1B[38;2;${r};${g};${b}m${text2[i]}`;
+  }
+  return result + "\x1B[39m";
+}
+var theme = {
+  brand: (text2) => pick("brand")(text2),
+  accent: (text2) => pick("accent")(text2),
+  muted: (text2) => pick("muted")(text2),
+  success: (text2) => pick("success")(text2),
+  warn: (text2) => pick("warn")(text2),
+  error: (text2) => pick("error")(text2),
+  bold: (text2) => noColor || !isTTY ? text2 : pc.bold(text2),
+  brandBold: (text2) => pick("brand")(noColor || !isTTY ? text2 : pc.bold(text2)),
+  accentBold: (text2) => pick("accent")(noColor || !isTTY ? text2 : pc.bold(text2)),
+  /** Styled checkmark */
+  check: () => pick("success")("\u2713")
+};
+
+// src/index.ts
+init_utils();
 
 // src/detect.ts
 init_utils();
@@ -505,7 +576,8 @@ function summarizeDetection(ctx) {
 
 // src/prompts.ts
 import * as p from "@clack/prompts";
-async function runPrompts(detected, defaults) {
+var SNAPSHOT_LANGUAGES = /* @__PURE__ */ new Set(["typescript", "javascript", "python"]);
+async function runPrompts(detected, defaults, isReconfigure = false) {
   const ideOptions = [
     { value: "claude", label: "Claude Code" },
     { value: "cursor", label: "Cursor" },
@@ -517,38 +589,41 @@ async function runPrompts(detected, defaults) {
     { value: "aider", label: "Aider" },
     { value: "generic", label: "Other (generic CONTEXT.md)" }
   ];
-  const ide = await p.select({
-    message: "Which AI coding tool are you using?",
+  const ides = await p.multiselect({
+    message: "Which AI coding tools do you use? (select all that apply)",
     options: ideOptions,
-    initialValue: defaults?.ide
+    initialValues: defaults?.ides ?? (defaults?.ide ? [defaults.ide] : void 0),
+    required: true
   });
-  if (p.isCancel(ide)) {
+  if (p.isCancel(ides)) {
     p.cancel("Cancelled.");
     process.exit(0);
   }
-  const stackSummary = summarizeDetection(detected);
   let stackConfirmed = true;
   let stackCorrections = defaults?.stackCorrections ?? "";
-  if (stackSummary) {
-    const confirm3 = await p.confirm({
-      message: `Detected: ${stackSummary}. Correct?`
-    });
-    if (p.isCancel(confirm3)) {
-      p.cancel("Cancelled.");
-      process.exit(0);
-    }
-    stackConfirmed = confirm3;
-    if (!confirm3) {
-      const corrections = await p.text({
-        message: "What should I correct? (describe your actual stack)",
-        placeholder: "e.g. It's actually Next.js 15 + Prisma, not plain React",
-        defaultValue: defaults?.stackCorrections || void 0
+  if (isReconfigure) {
+    const stackSummary = summarizeDetection(detected);
+    if (stackSummary) {
+      const confirm3 = await p.confirm({
+        message: `Detected: ${stackSummary}. Correct?`
       });
-      if (p.isCancel(corrections)) {
+      if (p.isCancel(confirm3)) {
         p.cancel("Cancelled.");
         process.exit(0);
       }
-      stackCorrections = corrections;
+      stackConfirmed = confirm3;
+      if (!confirm3) {
+        const corrections = await p.text({
+          message: "What should I correct? (describe your actual stack)",
+          placeholder: "e.g. It's actually Next.js 15 + Prisma, not plain React",
+          defaultValue: defaults?.stackCorrections || void 0
+        });
+        if (p.isCancel(corrections)) {
+          p.cancel("Cancelled.");
+          process.exit(0);
+        }
+        stackCorrections = corrections;
+      }
     }
   }
   const projectPurpose = await p.text({
@@ -563,55 +638,57 @@ async function runPrompts(detected, defaults) {
     p.cancel("Cancelled.");
     process.exit(0);
   }
+  let patternsDefault = defaults?.keyPatterns || "";
+  if (defaults?.gotchas) {
+    patternsDefault = patternsDefault ? `${patternsDefault}
+Gotchas: ${defaults.gotchas}` : `Gotchas: ${defaults.gotchas}`;
+  }
   const keyPatterns = await p.text({
-    message: "Any key coding patterns or conventions? (optional, press Enter to skip)",
-    placeholder: "e.g. Zustand slices for state, NativeWind for styling, expo/fetch for SSE",
-    defaultValue: defaults?.keyPatterns || ""
+    message: "Any key patterns, conventions, or gotchas? (optional, press Enter to skip)",
+    placeholder: "e.g. Zustand for state, never use FadeIn on ternary, angular commit style",
+    defaultValue: patternsDefault
   });
   if (p.isCancel(keyPatterns)) {
     p.cancel("Cancelled.");
     process.exit(0);
   }
-  const gotchas = await p.text({
-    message: "Any critical gotchas or anti-patterns to avoid? (optional)",
-    placeholder: "e.g. Never use FadeIn/FadeOut on ternary components, no @expo/vector-icons",
-    defaultValue: defaults?.gotchas || ""
-  });
-  if (p.isCancel(gotchas)) {
-    p.cancel("Cancelled.");
-    process.exit(0);
-  }
   let generateSnapshot2 = false;
   let snapshotPaths = defaults?.snapshotPaths ?? [];
-  if (detected.language === "typescript" || detected.language === "javascript") {
-    const snapshotChoice = await p.select({
-      message: "Generate a code snapshot? (extracts types, store shapes, component props)",
-      options: [
-        { value: "auto", label: "Yes, auto-detect key files" },
-        { value: "no", label: "No, skip code snapshot" },
-        { value: "custom", label: "Yes, but let me specify paths" }
-      ],
-      initialValue: defaults?.generateSnapshot ? defaults.snapshotPaths.length > 0 ? "custom" : "auto" : void 0
-    });
-    if (p.isCancel(snapshotChoice)) {
-      p.cancel("Cancelled.");
-      process.exit(0);
-    }
-    if (snapshotChoice === "auto") {
-      generateSnapshot2 = true;
-      snapshotPaths = [];
-    } else if (snapshotChoice === "custom") {
-      generateSnapshot2 = true;
-      const paths = await p.text({
-        message: "Paths to scan (comma-separated, relative to project root)",
-        placeholder: "e.g. src/types, src/stores, src/components",
-        defaultValue: defaults?.snapshotPaths.length ? defaults.snapshotPaths.join(", ") : void 0
+  const supportsSnapshot = SNAPSHOT_LANGUAGES.has(detected.language);
+  if (supportsSnapshot) {
+    if (isReconfigure) {
+      const snapshotChoice = await p.select({
+        message: "Code snapshot (extracts types, function signatures, class definitions)",
+        options: [
+          { value: "auto", label: "Auto-detect key files" },
+          { value: "custom", label: "Custom paths" },
+          { value: "no", label: "Disable" }
+        ],
+        initialValue: defaults?.generateSnapshot ? defaults.snapshotPaths.length > 0 ? "custom" : "auto" : "auto"
       });
-      if (p.isCancel(paths)) {
+      if (p.isCancel(snapshotChoice)) {
         p.cancel("Cancelled.");
         process.exit(0);
       }
-      snapshotPaths = paths.split(",").map((s) => s.trim()).filter(Boolean);
+      if (snapshotChoice === "auto") {
+        generateSnapshot2 = true;
+        snapshotPaths = [];
+      } else if (snapshotChoice === "custom") {
+        generateSnapshot2 = true;
+        const paths = await p.text({
+          message: "Paths to scan (comma-separated, relative to project root)",
+          placeholder: "e.g. src/types, src/stores, src/components",
+          defaultValue: defaults?.snapshotPaths.length ? defaults.snapshotPaths.join(", ") : void 0
+        });
+        if (p.isCancel(paths)) {
+          p.cancel("Cancelled.");
+          process.exit(0);
+        }
+        snapshotPaths = paths.split(",").map((s) => s.trim()).filter(Boolean);
+      }
+    } else {
+      generateSnapshot2 = true;
+      snapshotPaths = defaults?.snapshotPaths ?? [];
     }
   }
   let generatePerPackage = false;
@@ -629,10 +706,11 @@ async function runPrompts(detected, defaults) {
     generatePerPackage = perPkg;
   }
   return {
-    ide,
+    ides,
     projectPurpose,
     keyPatterns: keyPatterns ?? "",
-    gotchas: gotchas ?? "",
+    gotchas: "",
+    // Folded into keyPatterns; kept for backward compat
     generateSnapshot: generateSnapshot2,
     snapshotPaths,
     stackConfirmed,
@@ -886,7 +964,7 @@ async function buildImportGraph(rootDir, language, onProgress) {
   } catch (err) {
     const code = err.code;
     if (code === "EPERM" || code === "EACCES") {
-      onProgress?.("Warning: permission error scanning files \u2014 returning empty graph");
+      onProgress?.("Warning: permission error scanning files, returning empty graph");
       return { edges: [], inDegree: /* @__PURE__ */ new Map(), centrality: /* @__PURE__ */ new Map(), externalImportCounts: /* @__PURE__ */ new Map() };
     }
     throw err;
@@ -1233,6 +1311,12 @@ function computeExportCoverage(graph) {
 
 // src/snapshot.ts
 function getDefaultScanPaths(ctx) {
+  if (ctx.language === "python") {
+    return getDefaultPythonScanPaths(ctx);
+  }
+  return getDefaultJsTsScanPaths(ctx);
+}
+function getDefaultJsTsScanPaths(ctx) {
   const paths = [];
   const dirs = ctx.directories;
   for (const d of dirs) {
@@ -1258,6 +1342,32 @@ function getDefaultScanPaths(ctx) {
   }
   return paths;
 }
+function getDefaultPythonScanPaths(ctx) {
+  const paths = [];
+  const dirs = ctx.directories;
+  for (const d of dirs) {
+    const last = d.split("/").pop() ?? d;
+    if ([
+      "models",
+      "schemas",
+      "types",
+      "services",
+      "api",
+      "core",
+      "utils",
+      "db",
+      "routes",
+      "routers",
+      "views"
+    ].includes(last)) {
+      paths.push(d);
+    }
+  }
+  if (paths.length === 0) {
+    paths.push("src", "app", "lib", ".");
+  }
+  return paths;
+}
 var PATTERNS = {
   /** export interface Foo { ... } or export type Foo = ... */
   exportedType: /^export\s+(interface|type)\s+(\w+)/,
@@ -1352,23 +1462,160 @@ function extractSignatureLine(lines, startIdx) {
   }
   return sig;
 }
-function annotateSignature(entry) {
+var PY_PATTERNS = {
+  /** class Foo: or class Foo(Base): or class Foo(Base, Mixin): */
+  classDef: /^class\s+(\w+)(?:\(([^)]*)\))?:/,
+  /** Decorators (@dataclass, @app.route, etc.) */
+  decorator: /^@(\S+)/,
+  /** def foo(...) -> RetType: or async def foo(...): */
+  funcDef: /^(async\s+)?def\s+(\w+)\s*\(/,
+  /** TypeAlias: Foo = NewType/Union/Optional/Callable/Literal/TypeVar */
+  typeAlias: /^(\w+)\s*(?::\s*TypeAlias\s*)?=\s*(?:NewType|Union|Optional|Callable|Literal|TypeVar|Annotated)\b/
+};
+var PY_TYPE_BASES = /* @__PURE__ */ new Set([
+  "BaseModel",
+  "TypedDict",
+  "NamedTuple",
+  "Protocol"
+]);
+var PY_DATACLASS_DECORATORS = /* @__PURE__ */ new Set([
+  "dataclass",
+  "dataclasses.dataclass",
+  "attrs",
+  "attr.s",
+  "define"
+]);
+async function extractFromPythonFile(filePath, relPath) {
+  const content = await readFileOr(filePath);
+  if (!content) return [];
+  const entries = [];
+  const lines = content.split("\n");
+  let pendingDecorators = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trimStart();
+    const indent = line.length - trimmed.length;
+    if (indent > 0 && !pendingDecorators.length) {
+      if (indent > 4) continue;
+    }
+    const decoMatch = trimmed.match(PY_PATTERNS.decorator);
+    if (decoMatch) {
+      pendingDecorators.push(decoMatch[1]);
+      continue;
+    }
+    if (indent === 0) {
+      const classMatch = trimmed.match(PY_PATTERNS.classDef);
+      if (classMatch) {
+        const [, name, bases] = classMatch;
+        const baseList = bases ? bases.split(",").map((b) => b.trim().split("[")[0].split("(")[0]) : [];
+        let category = "type";
+        const isEnum = baseList.some((b) => b === "Enum" || b === "IntEnum" || b === "StrEnum");
+        const isProtocol = baseList.some((b) => b === "Protocol");
+        const isDatalike = baseList.some((b) => PY_TYPE_BASES.has(b)) || pendingDecorators.some((d) => PY_DATACLASS_DECORATORS.has(d));
+        if (isProtocol) {
+          category = "interface";
+        } else if (isEnum || isDatalike) {
+          category = "type";
+        }
+        const block = extractPythonBlock(lines, i, pendingDecorators);
+        entries.push({ file: relPath, category, signature: block });
+        pendingDecorators = [];
+        continue;
+      }
+    }
+    if (indent === 0) {
+      const funcMatch = trimmed.match(PY_PATTERNS.funcDef);
+      if (funcMatch) {
+        const [, , name] = funcMatch;
+        if (name.startsWith("_") || name.startsWith("test_")) {
+          pendingDecorators = [];
+          continue;
+        }
+        const sig = extractPythonFuncSignature(lines, i, pendingDecorators);
+        entries.push({ file: relPath, category: "function", signature: sig });
+        pendingDecorators = [];
+        continue;
+      }
+    }
+    if (indent === 0) {
+      const aliasMatch = trimmed.match(PY_PATTERNS.typeAlias);
+      if (aliasMatch) {
+        entries.push({ file: relPath, category: "type", signature: trimmed });
+        pendingDecorators = [];
+        continue;
+      }
+    }
+    if (trimmed && !trimmed.startsWith("#")) {
+      pendingDecorators = [];
+    }
+  }
+  return entries;
+}
+function extractPythonBlock(lines, startIdx, decorators) {
+  const maxLines = 30;
+  const parts = [];
+  for (const dec of decorators) {
+    parts.push(`@${dec}`);
+  }
+  parts.push(lines[startIdx].trimStart());
+  let bodyIndent = -1;
+  for (let i = startIdx + 1; i < lines.length && i < startIdx + maxLines; i++) {
+    const line = lines[i];
+    const trimmed = line.trimStart();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    bodyIndent = line.length - trimmed.length;
+    break;
+  }
+  if (bodyIndent <= 0) return parts.join("\n");
+  for (let i = startIdx + 1; i < lines.length && parts.length < maxLines; i++) {
+    const line = lines[i];
+    const trimmed = line.trimStart();
+    if (!trimmed) {
+      parts.push("");
+      continue;
+    }
+    const currentIndent = line.length - trimmed.length;
+    if (currentIndent < bodyIndent) break;
+    parts.push(line.trimStart());
+  }
+  while (parts.length > 0 && parts[parts.length - 1] === "") {
+    parts.pop();
+  }
+  return parts.join("\n");
+}
+function extractPythonFuncSignature(lines, startIdx, decorators) {
+  const parts = [];
+  for (const dec of decorators) {
+    parts.push(`@${dec}`);
+  }
+  let sig = "";
+  for (let i = startIdx; i < lines.length && i < startIdx + 10; i++) {
+    const trimmed = lines[i].trimStart();
+    sig += (sig ? " " : "") + trimmed;
+    if (sig.includes("):") || sig.includes(") ->")) {
+      const colonIdx = sig.lastIndexOf(":");
+      if (colonIdx >= 0) {
+        sig = sig.slice(0, colonIdx + 1);
+      }
+      break;
+    }
+  }
+  parts.push(sig);
+  return parts.join("\n");
+}
+function annotateSignature(entry, commentPrefix = "//") {
   if (entry.importedByCount && entry.importedByCount > 2) {
     const firstLine = entry.signature.split("\n")[0];
     const rest = entry.signature.split("\n").slice(1);
-    const annotated = `${firstLine}  // imported by ${entry.importedByCount} files`;
+    const annotated = `${firstLine}  ${commentPrefix} imported by ${entry.importedByCount} files`;
     return rest.length > 0 ? [annotated, ...rest].join("\n") : annotated;
   }
   return entry.signature;
 }
-function renderSnapshot(entries) {
+function renderSnapshot(entries, language = "typescript") {
   if (entries.length === 0) return "";
-  const byFile = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    const list = byFile.get(e.file) ?? [];
-    list.push(e);
-    byFile.set(e.file, list);
-  }
+  const lang = language === "python" ? "python" : "ts";
+  const comment = language === "python" ? "#" : "//";
   let md = "";
   const types = entries.filter((e) => e.category === "type" || e.category === "interface");
   const stores = entries.filter((e) => e.category === "store");
@@ -1376,28 +1623,43 @@ function renderSnapshot(entries) {
   const components = entries.filter((e) => e.category === "component");
   const functions = entries.filter((e) => e.category === "function");
   if (types.length > 0) {
-    md += "### Core Types\n\n```ts\n";
-    md += types.map((e) => annotateSignature(e)).join("\n\n");
+    md += `### Core Types
+
+\`\`\`${lang}
+`;
+    md += types.map((e) => annotateSignature(e, comment)).join("\n\n");
     md += "\n```\n\n";
   }
   if (stores.length > 0) {
-    md += "### Store Shape\n\n```ts\n";
-    md += stores.map((e) => annotateSignature(e)).join("\n\n");
+    md += `### Store Shape
+
+\`\`\`${lang}
+`;
+    md += stores.map((e) => annotateSignature(e, comment)).join("\n\n");
     md += "\n```\n\n";
   }
   if (components.length > 0) {
-    md += "### Component Props\n\n```ts\n";
-    md += components.map((e) => annotateSignature(e)).join("\n\n");
+    md += `### Component Props
+
+\`\`\`${lang}
+`;
+    md += components.map((e) => annotateSignature(e, comment)).join("\n\n");
     md += "\n```\n\n";
   }
   if (hooks.length > 0) {
-    md += "### Hooks\n\n```ts\n";
-    md += hooks.map((e) => annotateSignature(e)).join("\n\n");
+    md += `### Hooks
+
+\`\`\`${lang}
+`;
+    md += hooks.map((e) => annotateSignature(e, comment)).join("\n\n");
     md += "\n```\n\n";
   }
   if (functions.length > 0) {
-    md += "### Key Functions\n\n```ts\n";
-    md += functions.map((e) => annotateSignature(e)).join("\n\n");
+    md += `### Key Functions
+
+\`\`\`${lang}
+`;
+    md += functions.map((e) => annotateSignature(e, comment)).join("\n\n");
     md += "\n```\n\n";
   }
   return md.trimEnd();
@@ -1409,23 +1671,40 @@ async function generateSnapshot(ctx, customPaths, graph, maxTokens, onProgress,
   }
   const dirNames = scanPaths.map((p5) => p5.split("/").pop() ?? p5);
   onProgress?.(`Scanning ${scanPaths.length} directories: ${dirNames.join(", ")}...`);
-  const patterns = scanPaths.map((p5) => `${p5}/**/*.{ts,tsx,js,jsx}`);
+  const isPython = ctx.language === "python";
+  const fileGlob = isPython ? "**/*.py" : "**/*.{ts,tsx,js,jsx}";
+  const patterns = scanPaths.map((p5) => `${p5}/${fileGlob}`);
+  const ignorePatterns = [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/__tests__/**",
+    "**/.Trash/**",
+    "**/Library/**",
+    "**/.git/**"
+  ];
+  if (isPython) {
+    ignorePatterns.push(
+      "**/__pycache__/**",
+      "**/venv/**",
+      "**/.venv/**",
+      "**/env/**",
+      "**/migrations/**",
+      "**/test_*.py",
+      "**/tests/**",
+      "**/conftest.py",
+      "**/setup.py"
+    );
+  }
   const files = await fg3(patterns, {
     cwd: ctx.rootDir,
-    ignore: [
-      "**/node_modules/**",
-      "**/dist/**",
-      "**/build/**",
-      "**/*.test.*",
-      "**/*.spec.*",
-      "**/__tests__/**",
-      "**/.Trash/**",
-      "**/Library/**",
-      "**/.git/**"
-    ],
+    ignore: ignorePatterns,
     absolute: false
   });
   const allEntries = [];
+  const extractor = isPython ? extractFromPythonFile : extractFromFile;
   for (let i = 0; i < files.length; i++) {
     const file = files[i];
     if ((i + 1) % 20 === 0 || i === files.length - 1) {
@@ -1433,7 +1712,7 @@ async function generateSnapshot(ctx, customPaths, graph, maxTokens, onProgress,
       onProgress?.(`Extracting signatures... ${i + 1}/${files.length} files (${dir}/)`);
     }
     const absPath = path4.join(ctx.rootDir, file);
-    const entries = await extractFromFile(absPath, file);
+    const entries = await extractor(absPath, file);
     allEntries.push(...entries);
   }
   if (graph) {
@@ -1449,7 +1728,7 @@ async function generateSnapshot(ctx, customPaths, graph, maxTokens, onProgress,
   const budget = maxTokens ?? Math.min(16e3, 4e3 + Math.floor(ctx.sourceFileCount / 25) * 500);
   onProgress?.(`Applying token budget (${budget.toLocaleString()} tokens)...`);
   const { selected, excluded } = applyTokenBudget(liveEntries, budget, graph, gitActivity);
-  const markdown = renderSnapshot(selected);
+  const markdown = renderSnapshot(selected, ctx.language);
   return {
     entries: selected,
     markdown,
@@ -1464,13 +1743,23 @@ var ENTRY_POINT_PATTERNS = [
   /(?:^|\/)pages\//,
   /(?:^|\/)app\//,
   /(?:^|\/)routes?\//,
-  /(?:^|\/)middleware\//
+  /(?:^|\/)middleware\//,
+  // Python entry points
+  /(?:^|\/)__init__\.py$/,
+  /(?:^|\/)main\.py$/,
+  /(?:^|\/)app\.py$/,
+  /(?:^|\/)wsgi\.py$/,
+  /(?:^|\/)asgi\.py$/
 ];
 function extractNameFromSignature(sig) {
-  const m = sig.match(
+  const jsMatch = sig.match(
     /export\s+(?:default\s+)?(?:async\s+)?(?:interface|type|function|const|let|var|class|enum)\s+(\w+)/
   );
-  return m?.[1] ?? null;
+  if (jsMatch) return jsMatch[1];
+  const pyMatch = sig.match(
+    /(?:class|(?:async\s+)?def)\s+(\w+)/
+  );
+  return pyMatch?.[1] ?? null;
 }
 function isEntryPoint(filePath) {
   return ENTRY_POINT_PATTERNS.some((p5) => p5.test(filePath));
@@ -1557,7 +1846,7 @@ var HINT_GENERATORS = [
         hints.push("### Next.js (App Router)");
         hints.push("");
         hints.push(
-          "- **App Router** \u2014 all routes in `app/` use React Server Components by default"
+          "- **App Router**: all routes in `app/` use React Server Components by default"
         );
         hints.push(
           '- Add `"use client"` directive at the top of files that need browser APIs, hooks, or event handlers'
@@ -1580,7 +1869,7 @@ var HINT_GENERATORS = [
       } else if (hasPagesDir && !hasAppDir) {
         hints.push("### Next.js (Pages Router)");
         hints.push("");
-        hints.push("- **Pages Router** \u2014 routes in `pages/` directory");
+        hints.push("- **Pages Router**: routes in `pages/` directory");
         hints.push(
           "- `getServerSideProps` for server-side data fetching, `getStaticProps` for static generation"
         );
@@ -1589,10 +1878,10 @@ var HINT_GENERATORS = [
         );
         hints.push("- API routes in `pages/api/`");
       } else if (hasAppDir && hasPagesDir) {
-        hints.push("### Next.js (Hybrid \u2014 App + Pages Router)");
+        hints.push("### Next.js (Hybrid: App + Pages Router)");
         hints.push("");
         hints.push(
-          "- Both `app/` (App Router) and `pages/` (Pages Router) coexist \u2014 new routes should use App Router"
+          "- Both `app/` (App Router) and `pages/` (Pages Router) coexist. New routes should use App Router"
         );
         hints.push(
           '- App Router components are server components by default; add `"use client"` for client components'
@@ -1623,7 +1912,7 @@ var HINT_GENERATORS = [
       "- Organize routes with `express.Router()` in separate files, mount with `app.use('/prefix', router)`",
       "- Validate request bodies/params at the route level (e.g. with zod, joi, or express-validator)",
       "- Use `async` handlers with try/catch or an async wrapper to avoid unhandled promise rejections",
-      "- Set `res.status()` before `res.json()` \u2014 don't rely on defaults for error responses"
+      "- Set `res.status()` before `res.json()`. Don't rely on defaults for error responses"
     ]
   },
   {
@@ -1643,10 +1932,10 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Hono",
       "",
-      "- Middleware with `app.use()` \u2014 compose with `c.next()` pattern",
+      "- Middleware with `app.use()`. Compose with `c.next()` pattern",
       "- Validators: use `hono/validator` or `@hono/zod-validator` for type-safe request parsing",
       "- Context (`c`): `c.json()`, `c.text()`, `c.html()` for responses; `c.req` for request",
-      "- Supports multiple runtimes (Node, Deno, Bun, Cloudflare Workers) \u2014 avoid Node-specific APIs"
+      "- Supports multiple runtimes (Node, Deno, Bun, Cloudflare Workers). Avoid Node-specific APIs"
     ]
   },
   {
@@ -1656,7 +1945,7 @@ var HINT_GENERATORS = [
       "",
       "- **Modules** organize the app into cohesive blocks; every feature gets a module",
       "- **Controllers** handle HTTP requests (decorators: `@Get()`, `@Post()`, etc.)",
-      "- **Providers** (services) hold business logic \u2014 injected via constructor DI",
+      "- **Providers** (services) hold business logic, injected via constructor DI",
       "- **Guards** for auth (`@UseGuards()`), **Pipes** for validation (`@UsePipes()`)",
       "- **Interceptors** for response transformation, logging, caching",
       "- DTOs with `class-validator` decorators for request validation",
@@ -1672,7 +1961,7 @@ var HINT_GENERATORS = [
         "- **expo-router** for file-based routing (if using); Stack, Tabs, Drawer navigators"
       );
       hints.push(
-        "- Expo Go has limited native module support \u2014 some packages require a dev build (`npx expo run:ios`)"
+        "- Expo Go has limited native module support. Some packages require a dev build (`npx expo run:ios`)"
       );
       hints.push(
         "- Use `expo-constants`, `expo-device` etc. instead of raw RN APIs when available"
@@ -1685,7 +1974,7 @@ var HINT_GENERATORS = [
           '- **Reanimated**: worklet functions need the `"worklet"` directive on the first line'
         );
         hints.push(
-          "- Avoid `FadeIn`/`FadeOut` entering/exiting animations on conditionally rendered components \u2014 they cause flashes"
+          "- Avoid `FadeIn`/`FadeOut` entering/exiting animations on conditionally rendered components. They cause flashes"
         );
       }
       return hints;
@@ -1698,11 +1987,11 @@ var HINT_GENERATORS = [
       return [
         "### React Native",
         "",
-        "- Use `StyleSheet.create()` for styles \u2014 avoid inline style objects in render",
+        "- Use `StyleSheet.create()` for styles. Avoid inline style objects in render",
         "- Platform-specific: `*.ios.tsx` / `*.android.tsx` or `Platform.select()`",
         '- **Reanimated**: worklet functions need the `"worklet"` directive',
         "- Navigation: React Navigation with Stack/Tab/Drawer navigators",
-        "- Test with both iOS and Android \u2014 layout behavior differs"
+        "- Test with both iOS and Android. Layout behavior differs"
       ];
     }
   },
@@ -1714,7 +2003,7 @@ var HINT_GENERATORS = [
       return [
         "### React",
         "",
-        "- Functional components with hooks \u2014 no class components",
+        "- Functional components with hooks (no class components)",
         "- Use `React.memo()` for expensive renders, `useMemo`/`useCallback` for referential stability",
         "- Lift state up or use context for shared state; avoid prop drilling beyond 2-3 levels",
         "- Prefer controlled components for forms",
@@ -1739,11 +2028,11 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Nuxt",
       "",
-      "- Auto-imports: components, composables, and utils are auto-imported \u2014 no manual import needed",
-      "- File-based routing in `pages/` \u2014 dynamic params with `[id].vue` syntax",
-      "- Data fetching: `useFetch()` / `useAsyncData()` \u2014 they handle SSR hydration automatically",
-      "- Server routes in `server/api/` \u2014 auto-registered, use `defineEventHandler()`",
-      "- Middleware in `middleware/` \u2014 `defineNuxtRouteMiddleware()` for route guards",
+      "- Auto-imports: components, composables, and utils are auto-imported (no manual import needed)",
+      "- File-based routing in `pages/`. Dynamic params with `[id].vue` syntax",
+      "- Data fetching: `useFetch()` / `useAsyncData()`. They handle SSR hydration automatically",
+      "- Server routes in `server/api/`, auto-registered, use `defineEventHandler()`",
+      "- Middleware in `middleware/`. `defineNuxtRouteMiddleware()` for route guards",
       "- State: `useState()` for SSR-safe shared state, Pinia for complex stores"
     ]
   },
@@ -1756,7 +2045,7 @@ var HINT_GENERATORS = [
         "",
         "- Reactive declarations with `$:` for derived state",
         "- Props: `export let propName` in component script",
-        "- Stores: `writable()`, `readable()`, `derived()` \u2014 auto-subscribe with `$store` syntax",
+        "- Stores: `writable()`, `readable()`, `derived()`. Auto-subscribe with `$store` syntax",
         "- Use `{#if}`, `{#each}`, `{#await}` blocks for conditional/list/async rendering"
       ];
     }
@@ -1766,7 +2055,7 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### SvelteKit",
       "",
-      "- File-based routing in `src/routes/` \u2014 `+page.svelte`, `+layout.svelte`, `+server.ts`",
+      "- File-based routing in `src/routes/`: `+page.svelte`, `+layout.svelte`, `+server.ts`",
       "- `+page.ts` (universal) or `+page.server.ts` (server-only) for `load` functions",
       "- Form actions in `+page.server.ts` with `actions` export for progressive enhancement",
       "- Hooks in `src/hooks.server.ts` for auth, session, error handling",
@@ -1780,7 +2069,7 @@ var HINT_GENERATORS = [
       "",
       "- Components, services, pipes, directives all use decorators (`@Component`, `@Injectable`, etc.)",
       "- Dependency injection: provide services in module or component `providers` array",
-      "- RxJS Observables for async data \u2014 use `async` pipe in templates, unsubscribe on destroy",
+      "- RxJS Observables for async data. Use `async` pipe in templates, unsubscribe on destroy",
       "- Lazy-load feature modules with `loadChildren` in routes",
       "- Use Angular CLI (`ng generate`) for scaffolding"
     ]
@@ -1792,9 +2081,9 @@ var HINT_GENERATORS = [
       "",
       "- Apps structure: each feature is a Django app with `models.py`, `views.py`, `urls.py`, `admin.py`",
       "- Models: define in `models.py`, create migrations with `python manage.py makemigrations`",
-      "- Views: function-based (FBV) or class-based (CBV) \u2014 CBV for CRUD, FBV for custom logic",
+      "- Views: function-based (FBV) or class-based (CBV). CBV for CRUD, FBV for custom logic",
       "- URL routing in `urls.py` using `path()` and `include()` for app-level URLs",
-      "- Templates in `templates/` \u2014 use template inheritance with `{% extends %}` and `{% block %}`",
+      "- Templates in `templates/`. Use template inheritance with `{% extends %}` and `{% block %}`",
       "- Management commands in `management/commands/` for custom CLI tasks",
       "- Settings: use `django-environ` or `python-decouple` for environment-based config"
     ]
@@ -1804,11 +2093,11 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Flask",
       "",
-      "- Blueprints for modular route organization \u2014 register with `app.register_blueprint()`",
+      "- Blueprints for modular route organization. Register with `app.register_blueprint()`",
       "- Use application factory pattern (`create_app()`) for testing and config flexibility",
       "- Error handlers with `@app.errorhandler(404)` etc.",
       "- Use Flask-SQLAlchemy for ORM, Flask-Migrate for database migrations",
-      "- Request context: `request`, `g`, `session` globals \u2014 available inside request handlers"
+      "- Request context: `request`, `g`, `session` globals, available inside request handlers"
     ]
   },
   {
@@ -1817,7 +2106,7 @@ var HINT_GENERATORS = [
       "### FastAPI",
       "",
       "- **Dependency injection**: use `Depends()` for shared logic (auth, DB sessions, validation)",
-      "- **Pydantic models** for request/response schemas \u2014 automatic validation and OpenAPI docs",
+      "- **Pydantic models** for request/response schemas with automatic validation and OpenAPI docs",
       "- Async endpoints by default (`async def`); use sync `def` only for blocking I/O with threadpool",
       "- Routers: `APIRouter()` for modular route organization, mount with `app.include_router()`",
       '- Middleware with `@app.middleware("http")` or Starlette middleware classes',
@@ -1830,7 +2119,7 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Prisma",
       "",
-      "- Schema in `prisma/schema.prisma` \u2014 run `npx prisma generate` after changes",
+      "- Schema in `prisma/schema.prisma`. Run `npx prisma generate` after changes",
       "- Migrations: `npx prisma migrate dev` for development, `npx prisma migrate deploy` for production",
       "- Use `prisma.$transaction()` for atomic operations",
       "- Relation queries: use `include` for eager loading, `select` for field filtering"
@@ -1841,7 +2130,7 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Drizzle",
       "",
-      "- Schema defined in TypeScript \u2014 type-safe queries with no code generation step",
+      "- Schema defined in TypeScript. Type-safe queries with no code generation step",
       "- Migrations: `drizzle-kit generate` then `drizzle-kit migrate`",
       "- Use `db.select()`, `db.insert()`, `db.update()`, `db.delete()` for queries",
       "- Relations: define with `relations()` helper for type-safe joins"
@@ -1854,7 +2143,7 @@ var HINT_GENERATORS = [
       return [
         "### Tailwind CSS",
         "",
-        "- Utility-first: compose styles with `className` \u2014 avoid custom CSS unless truly needed",
+        "- Utility-first: compose styles with `className`. Avoid custom CSS unless truly needed",
         "- Use `@apply` sparingly in CSS modules for repeated patterns",
         "- Responsive: mobile-first with `sm:`, `md:`, `lg:` breakpoint prefixes",
         "- Dark mode: `dark:` variant (class or media strategy per `tailwind.config`)",
@@ -1867,7 +2156,7 @@ var HINT_GENERATORS = [
     getHints: () => [
       "### Electron",
       "",
-      "- **Main process** (Node.js) and **renderer process** (Chromium) \u2014 communicate via IPC",
+      "- **Main process** (Node.js) and **renderer process** (Chromium). Communicate via IPC",
       "- Use `contextBridge` + `preload.js` to expose safe APIs to renderer (no `nodeIntegration`)",
       "- `ipcMain.handle()` / `ipcRenderer.invoke()` for async request-response patterns",
       "- Package with `electron-builder` or `electron-forge`"
@@ -1885,7 +2174,7 @@ function buildMainContext(ctx, answers, snapshot, analysis) {
   sections.push(
     "> **Keep this file up to date.** When you change the architecture, add a dependency, create a new pattern, or learn a gotcha, update this file in the same step. This is the source of truth for how the project works."
   );
-  if (answers.ide === "cursor") {
+  if (answers.ides.includes("cursor")) {
     sections.push(
       "> Scoped rules are in `.cursor/rules/` -- update them when conventions change."
     );
@@ -1919,7 +2208,7 @@ function buildMainContext(ctx, answers, snapshot, analysis) {
     );
     sections.push("");
     for (const pkg of ctx.monorepo.packages) {
-      const fws = pkg.frameworks.length > 0 ? ` \u2014 ${pkg.frameworks.map((f) => f.name).join(", ")}` : "";
+      const fws = pkg.frameworks.length > 0 ? ` (${pkg.frameworks.map((f) => f.name).join(", ")})` : "";
       sections.push(`- **${pkg.name}** (\`${pkg.path}\`)${fws}`);
     }
     sections.push("");
@@ -2329,7 +2618,7 @@ function buildGlobalRule(ctx, answers, analysis) {
     );
     bodyLines.push("");
     for (const inst of analysis.instabilities) {
-      bodyLines.push(`- \`${inst.path}\` \u2014 ${(inst.instability * 100).toFixed(0)}% unstable (${inst.fanIn} dependents, ${inst.fanOut} dependencies)`);
+      bodyLines.push(`- \`${inst.path}\`: ${(inst.instability * 100).toFixed(0)}% unstable (${inst.fanIn} dependents, ${inst.fanOut} dependencies)`);
     }
     bodyLines.push("");
   }
@@ -2593,7 +2882,7 @@ function buildArchitectureSkill(analysis) {
     bodyLines.push("## Key Files (by centrality)");
     bodyLines.push("");
     for (const hub of analysis.hubFiles) {
-      bodyLines.push(`- \`${hub.path}\` \u2014 imported by ${hub.importedBy} file${hub.importedBy === 1 ? "" : "s"}`);
+      bodyLines.push(`- \`${hub.path}\` (imported by ${hub.importedBy} file${hub.importedBy === 1 ? "" : "s"})`);
     }
     bodyLines.push("");
   }
@@ -2653,7 +2942,7 @@ function renderClaudeSkill(skill) {
 // src/templates/aider-context.ts
 function buildAiderContext(ctx, answers, snapshot, analysis) {
   const lines = [];
-  lines.push("# .aider.conf.yml \u2014 Generated by codebrief");
+  lines.push("# .aider.conf.yml - Generated by codebrief");
   lines.push("# Keep this file up to date as the project evolves.");
   lines.push("");
   const stackSummary = answers.stackConfirmed ? summarizeDetection(ctx) : answers.stackCorrections || summarizeDetection(ctx);
@@ -2713,7 +3002,7 @@ function buildAiderContext(ctx, answers, snapshot, analysis) {
   }
   if (analysis?.instabilities && analysis.instabilities.length > 0) {
     for (const inst of analysis.instabilities) {
-      lines.push(`  - "UNSTABLE: ${escapeYaml(inst.path)} \u2014 ${(inst.instability * 100).toFixed(0)}% unstable (${inst.fanIn} dependents, ${inst.fanOut} deps)"`);
+      lines.push(`  - "UNSTABLE: ${escapeYaml(inst.path)}: ${(inst.instability * 100).toFixed(0)}% unstable (${inst.fanIn} dependents, ${inst.fanOut} deps)"`);
     }
   }
   if (analysis?.gitActivity?.changeCoupling && analysis.gitActivity.changeCoupling.length > 0) {
@@ -2757,62 +3046,51 @@ function escapeYaml(s) {
 
 // src/generate.ts
 async function generateFiles(ctx, answers, snapshot, force = false, dryRun = false, analysis, generateSkills = false, onVerbose) {
-  const files = [];
-  const mainFilename = getMainContextFilename(answers.ide);
-  const mainPath = path5.join(ctx.rootDir, mainFilename);
-  const mainContent = answers.ide === "aider" ? buildAiderContext(ctx, answers, snapshot, analysis) : buildMainContext(ctx, answers, snapshot, analysis);
-  files.push({
-    path: mainFilename,
-    content: mainContent,
-    existed: await fileExists(mainPath)
-  });
-  onVerbose?.(`Prepared ${mainFilename} (${mainContent.length} bytes)`);
-  if (answers.ide === "cursor") {
-    const rules = buildCursorRules(ctx, answers, analysis);
-    for (const rule of rules) {
-      const rulePath = `.cursor/rules/${rule.filename}`;
-      const absPath = path5.join(ctx.rootDir, rulePath);
-      const ruleContent = renderCursorRule(rule);
-      files.push({
-        path: rulePath,
-        content: ruleContent,
-        existed: await fileExists(absPath)
-      });
-      onVerbose?.(`Prepared ${rulePath} (${ruleContent.length} bytes)`);
-    }
-  }
-  if (generateSkills) {
-    const pkgJson = await readJsonFile(path5.join(ctx.rootDir, "package.json"));
-    const scripts = pkgJson?.scripts ?? void 0;
-    const skills = buildClaudeSkills(ctx, answers, analysis, scripts);
-    for (const skill of skills) {
-      const skillPath = `.claude/skills/${skill.name}/SKILL.md`;
-      const absPath = path5.join(ctx.rootDir, skillPath);
-      const skillContent = renderClaudeSkill(skill);
-      files.push({
-        path: skillPath,
-        content: skillContent,
-        existed: await fileExists(absPath)
-      });
-      onVerbose?.(`Prepared ${skillPath} (${skillContent.length} bytes)`);
+  const fileMap = /* @__PURE__ */ new Map();
+  async function addFile(filePath, content) {
+    if (fileMap.has(filePath)) return;
+    const absPath = path5.join(ctx.rootDir, filePath);
+    fileMap.set(filePath, {
+      path: filePath,
+      content,
+      existed: await fileExists(absPath)
+    });
+    onVerbose?.(`Prepared ${filePath} (${content.length} bytes)`);
+  }
+  for (const ide of answers.ides) {
+    const mainFilename = getMainContextFilename(ide);
+    const mainContent = ide === "aider" ? buildAiderContext(ctx, answers, snapshot, analysis) : buildMainContext(ctx, answers, snapshot, analysis);
+    await addFile(mainFilename, mainContent);
+    if (ide === "cursor") {
+      const rules = buildCursorRules(ctx, answers, analysis);
+      for (const rule of rules) {
+        const rulePath = `.cursor/rules/${rule.filename}`;
+        const ruleContent = renderCursorRule(rule);
+        await addFile(rulePath, ruleContent);
+      }
     }
-  }
-  if (answers.ide === "opencode") {
-    const claudePath = path5.join(ctx.rootDir, "CLAUDE.md");
-    const claudeExists = await fileExists(claudePath);
-    if (!claudeExists) {
-      files.push({
-        path: "CLAUDE.md",
-        content: `# ${path5.basename(ctx.rootDir)}
+    if (generateSkills && ide === "claude") {
+      const pkgJson = await readJsonFile(path5.join(ctx.rootDir, "package.json"));
+      const scripts = pkgJson?.scripts ?? void 0;
+      const skills = buildClaudeSkills(ctx, answers, analysis, scripts);
+      for (const skill of skills) {
+        const skillPath = `.claude/skills/${skill.name}/SKILL.md`;
+        const skillContent = renderClaudeSkill(skill);
+        await addFile(skillPath, skillContent);
+      }
+    }
+    if (ide === "opencode") {
+      const claudePath = path5.join(ctx.rootDir, "CLAUDE.md");
+      const claudeExists = await fileExists(claudePath);
+      if (!claudeExists && !fileMap.has("CLAUDE.md")) {
+        await addFile("CLAUDE.md", `# ${path5.basename(ctx.rootDir)}
 
 > See AGENTS.md for full project context.
-`,
-        existed: false
-      });
+`);
+      }
     }
   }
   if (answers.generatePerPackage && ctx.monorepo && ctx.monorepo.packages.length > 0) {
-    const pkgMainFilename = answers.ide === "aider" ? ".aider.conf.yml" : getMainContextFilename(answers.ide);
     for (const pkg of ctx.monorepo.packages) {
       const pkgRootDir = path5.join(ctx.rootDir, pkg.path);
       const pkgCtx = await detectContext(pkgRootDir);
@@ -2823,20 +3101,19 @@ async function generateFiles(ctx, answers, snapshot, force = false, dryRun = fal
       }
       const pkgAnswers = {
         ...answers,
-        projectPurpose: `${pkg.name} \u2014 part of the ${path5.basename(ctx.rootDir)} monorepo. ${answers.projectPurpose}`,
+        projectPurpose: `${pkg.name}, part of the ${path5.basename(ctx.rootDir)} monorepo. ${answers.projectPurpose}`,
         generatePerPackage: false
         // don't recurse
       };
-      const pkgContent = answers.ide === "aider" ? buildAiderContext(pkgCtx, pkgAnswers, pkgSnapshot) : buildMainContext(pkgCtx, pkgAnswers, pkgSnapshot);
-      const pkgFilePath = path5.join(pkg.path, pkgMainFilename);
-      const pkgAbsPath = path5.join(ctx.rootDir, pkgFilePath);
-      files.push({
-        path: pkgFilePath,
-        content: pkgContent,
-        existed: await fileExists(pkgAbsPath)
-      });
+      for (const ide of answers.ides) {
+        const pkgMainFilename = ide === "aider" ? ".aider.conf.yml" : getMainContextFilename(ide);
+        const pkgContent = ide === "aider" ? buildAiderContext(pkgCtx, pkgAnswers, pkgSnapshot) : buildMainContext(pkgCtx, pkgAnswers, pkgSnapshot);
+        const pkgFilePath = path5.join(pkg.path, pkgMainFilename);
+        await addFile(pkgFilePath, pkgContent);
+      }
     }
   }
+  const files = Array.from(fileMap.values());
   if (dryRun) {
     return files;
   }
@@ -2871,11 +3148,10 @@ ${existingFiles.map((f) => `  - ${f.path}`).join("\n")}`
 
 // src/summary.ts
 init_utils();
-import pc from "picocolors";
 function printSummary(files, ctx, snapshot, analysis) {
   if (files.length === 0) return;
   console.log("");
-  console.log(pc.bold("  Files created:"));
+  console.log(theme.brandBold("  Files created:"));
   console.log("");
   let totalBytes = 0;
   let totalTokens = 0;
@@ -2936,24 +3212,24 @@ function printSummary(files, ctx, snapshot, analysis) {
   const maxTokenWidth = Math.max(...dataFileRows.map((r) => r.tokens.length));
   for (const row of fileRows) {
     if (row.isHeader) {
-      console.log(`${row.indent}${pc.cyan(row.name)}`);
+      console.log(`${row.indent}${theme.accent(row.name)}`);
     } else {
-      const status = row.isUpdated ? pc.yellow("(updated)") : pc.green("(new)");
+      const status = row.isUpdated ? theme.muted("(updated)") : theme.success("(new)");
       const paddedName = row.name.padEnd(maxNameCol - row.indent.length);
       console.log(
-        `${row.indent}${pc.cyan(paddedName)}  ${row.size.padStart(maxSizeWidth)}  ${pc.dim(row.tokens.padEnd(maxTokenWidth))}  ${status}`
+        `${row.indent}${theme.accent(paddedName)}  ${row.size.padStart(maxSizeWidth)}  ${theme.muted(row.tokens.padEnd(maxTokenWidth))}  ${status}`
       );
     }
   }
   console.log("");
   console.log(
-    pc.dim(
+    theme.muted(
       `    Total: ${formatBytes(totalBytes)}, ~${formatNumber(totalTokens)} tokens`
     )
   );
   if (snapshot?.budgetExcluded && snapshot.budgetExcluded > 0) {
     console.log(
-      pc.dim(
+      theme.muted(
         `    (${snapshot.budgetExcluded} snapshot entries excluded by token budget)`
       )
     );
@@ -2967,12 +3243,12 @@ function printSummary(files, ctx, snapshot, analysis) {
     if (analysis.gitActivity) parts.push(`${analysis.gitActivity.hotFiles.length} recently active files`);
     if (parts.length > 0) {
       console.log(
-        pc.dim(`    Includes: ${parts.join(", ")}`)
+        theme.muted(`    Includes: ${parts.join(", ")}`)
       );
     }
   }
   console.log("");
-  console.log(pc.bold("  Estimated context cost per conversation:"));
+  console.log(theme.brandBold("  Estimated context cost per conversation:"));
   console.log("");
   const explorationTokens = estimateExplorationCost(ctx);
   const avgScopedTokens = scopedRuleTokens.length > 0 ? Math.round(
@@ -2987,23 +3263,37 @@ function printSummary(files, ctx, snapshot, analysis) {
   const maxVal = Math.max(explorationTokens, afterTotal);
   const beforeBarLen = Math.max(1, Math.round(explorationTokens / maxVal * BAR_MAX));
   const afterBarLen = Math.max(1, Math.round(afterTotal / maxVal * BAR_MAX));
-  const BLOCK = "\u2588";
-  const beforeBar = BLOCK.repeat(beforeBarLen);
-  const afterBar = BLOCK.repeat(afterBarLen);
-  const afterPad = " ".repeat(Math.max(0, beforeBarLen - afterBarLen));
-  console.log(`    Before: ${pc.red(beforeBar)}  ~${formatNumber(explorationTokens)} tokens`);
-  console.log(`    After:  ${pc.green(afterBar)}${afterPad}  ~${formatNumber(afterTotal)} tokens`);
+  const savedLen = Math.max(0, beforeBarLen - afterBarLen);
+  const beforeBar = gradient(
+    "\u2588".repeat(beforeBarLen),
+    [90, 135, 230],
+    // slightly deeper than brand
+    [122, 162, 247],
+    // #7aa2f7 brand
+    theme.brand
+  );
+  const afterBar = gradient(
+    "\u2588".repeat(afterBarLen),
+    [122, 162, 247],
+    // #7aa2f7 brand
+    [137, 180, 250],
+    // #89b4fa accent
+    theme.accent
+  );
+  const savedBar = theme.muted("\u2591".repeat(savedLen));
+  console.log(`    Before  ${beforeBar}  ${theme.muted(`~${formatNumber(explorationTokens)} tokens`)}`);
+  console.log(`    After   ${afterBar}${savedBar}  ${theme.muted(`~${formatNumber(afterTotal)} tokens`)}`);
   console.log("");
   if (savings > 0) {
     console.log(
-      pc.green(
+      theme.success(
         `    Estimated savings: ~${savings}% fewer tokens`
       )
     );
   }
   if (analysis) {
     console.log("");
-    console.log(pc.bold("  What we analyzed:"));
+    console.log(theme.brandBold("  What we analyzed:"));
     const recapRows = [];
     if (analysis.hubFiles.length > 0) {
       recapRows.push({ label: "PageRank hub detection", result: `found ${analysis.hubFiles.length} key architectural files` });
@@ -3037,7 +3327,7 @@ function printSummary(files, ctx, snapshot, analysis) {
     const maxRecapLabel = Math.max(...recapRows.map((r) => r.label.length));
     for (const row of recapRows) {
       console.log(
-        pc.dim(`    ${row.label.padEnd(maxRecapLabel)} \u2192 ${row.result}`)
+        theme.muted(`    ${row.label.padEnd(maxRecapLabel)} \u2192 ${row.result}`)
       );
     }
   }
@@ -3068,12 +3358,13 @@ function printSummary(files, ctx, snapshot, analysis) {
     }
     console.log("");
     if (findings.length > 0) {
-      console.log(pc.yellow(`  \u26A0  ${findings.length} finding${findings.length === 1 ? "" : "s"}`));
+      const findingsHeader = `  \u26A0  ${findings.length} finding${findings.length === 1 ? "" : "s"}`;
+      console.log(theme.warn(findingsHeader));
       for (const f of findings) {
-        console.log(pc.dim(`     \u25CF ${f}`));
+        console.log(theme.muted(`     \u25CF ${f}`));
       }
     } else {
-      console.log(pc.green(`  \u2713  No structural issues detected`));
+      console.log(theme.success(`  \u2713  No structural issues detected`));
     }
   }
   console.log("");
@@ -3106,8 +3397,10 @@ async function loadConfig(rootDir) {
   const raw = await readJsonFile(configPath);
   if (!raw) return null;
   const cfg = raw;
-  if (!cfg.ide || !cfg.projectPurpose) return null;
+  const ides = cfg.ides ?? (cfg.ide ? [cfg.ide] : void 0);
+  if (!ides || ides.length === 0 || !cfg.projectPurpose) return null;
   return {
+    ides,
     ide: cfg.ide,
     projectPurpose: cfg.projectPurpose,
     keyPatterns: cfg.keyPatterns ?? "",
@@ -3118,14 +3411,16 @@ async function loadConfig(rootDir) {
     generatePerPackage: cfg.generatePerPackage ?? false,
     snapshotHash: cfg.snapshotHash,
     snapshotGeneratedAt: cfg.snapshotGeneratedAt,
-    language: cfg.language
+    language: cfg.language,
+    staleDays: cfg.staleDays
   };
 }
 async function saveConfig(rootDir, answers, snapshotHash, language) {
   const configPath = path6.join(rootDir, CONFIG_FILENAME);
+  const existing = await readJsonFile(configPath);
   const cfg = {
     _version: CONFIG_VERSION,
-    ide: answers.ide,
+    ides: answers.ides,
     projectPurpose: answers.projectPurpose,
     keyPatterns: answers.keyPatterns,
     gotchas: answers.gotchas,
@@ -3134,13 +3429,14 @@ async function saveConfig(rootDir, answers, snapshotHash, language) {
     stackCorrections: answers.stackCorrections,
     generatePerPackage: answers.generatePerPackage,
     ...snapshotHash ? { snapshotHash, snapshotGeneratedAt: Date.now() } : {},
-    ...language ? { language } : {}
+    ...language ? { language } : {},
+    ...existing?.staleDays != null ? { staleDays: existing.staleDays } : {}
   };
   await writeFileSafe(configPath, JSON.stringify(cfg, null, 2) + "\n");
 }
 function configToAnswers(config) {
   return {
-    ide: config.ide,
+    ides: config.ides,
     projectPurpose: config.projectPurpose,
     keyPatterns: config.keyPatterns,
     gotchas: config.gotchas,
@@ -3182,7 +3478,6 @@ async function computeSnapshotHash(rootDir, language) {
 // src/refresh.ts
 import path7 from "path";
 import * as p3 from "@clack/prompts";
-import pc2 from "picocolors";
 init_utils();
 var CONTEXT_FILES = [
   "CLAUDE.md",
@@ -3218,7 +3513,7 @@ async function refreshSnapshot(rootDir) {
   const found = await findContextFile(rootDir);
   if (!found) {
     p3.log.error(
-      "No context file found. Run " + pc2.cyan("codebrief") + " first to generate one."
+      "No context file found. Run " + theme.accent("codebrief") + " first to generate one."
     );
     process.exit(1);
   }
@@ -3243,7 +3538,7 @@ async function refreshSnapshot(rootDir) {
       process.exit(1);
     }
   }
-  p3.log.info(`Refreshing snapshot in ${pc2.cyan(found.path)}`);
+  p3.log.info(`Refreshing snapshot in ${theme.accent(found.path)}`);
   spinner3.start("Scanning source files...");
   const progress = (msg) => spinner3.message(msg);
   const detected = await detectContext(rootDir, progress);
@@ -3255,7 +3550,7 @@ async function refreshSnapshot(rootDir) {
     snapshot.entries.length > 0 ? `Found ${snapshot.entries.length} type${snapshot.entries.length === 1 ? "" : "s"}/signature${snapshot.entries.length === 1 ? "" : "s"}.` : "No extractable types found."
   );
   if (snapshot.entries.length === 0) {
-    p3.log.warn("No types found \u2014 snapshot section will be empty.");
+    p3.log.warn("No types found. Snapshot section will be empty.");
   }
   let updated;
   if (found.isAider) {
@@ -3293,7 +3588,12 @@ async function refreshSnapshot(rootDir) {
     updated = content.slice(0, startIdx) + newBlock + content.slice(endIdx);
   }
   await writeFileSafe(absPath, updated);
-  p3.log.success(`Updated snapshot in ${pc2.cyan(found.path)}`);
+  if (config) {
+    const answers = configToAnswers(config);
+    const newHash = await computeSnapshotHash(rootDir, config.language ?? detected.language);
+    await saveConfig(rootDir, answers, newHash, config.language ?? detected.language);
+  }
+  p3.log.success(`Updated snapshot in ${theme.accent(found.path)}`);
 }
 
 // src/git-analysis.ts
@@ -3394,14 +3694,141 @@ function analyzeChangeCoupling(rootDir) {
 
 // src/index.ts
 init_utils();
+
+// src/animations.ts
+var isTTY2 = !!process.stdout.isTTY;
+var noColor2 = !!process.env.NO_COLOR;
+var HIDE_CURSOR = "\x1B[?25l";
+var SHOW_CURSOR = "\x1B[?25h";
+function clearLine() {
+  return "\x1B[A\x1B[2K";
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+async function renderFrames(frames, intervalMs) {
+  if (!isTTY2 || noColor2) return;
+  process.stdout.write(HIDE_CURSOR);
+  try {
+    for (let i = 0; i < frames.length; i++) {
+      if (i > 0) process.stdout.write(clearLine());
+      process.stdout.write(frames[i] + "\n");
+      if (i < frames.length - 1) await sleep(intervalMs);
+    }
+  } finally {
+    process.stdout.write(clearLine());
+    process.stdout.write(SHOW_CURSOR);
+  }
+}
+var INTERVAL = 80;
+var WIDTH = 24;
+async function animateGraphBuild(_fileCount, _edgeCount) {
+  const frames = [];
+  const steps = 5;
+  for (let n = 1; n <= steps; n++) {
+    const filled = Math.round(n / steps * WIDTH);
+    const remaining = WIDTH - filled;
+    frames.push(`    ${theme.brand("\u2501".repeat(filled))}${theme.muted("\u254C".repeat(remaining))}`);
+  }
+  await renderFrames(frames, INTERVAL);
+}
+async function animatePageRank() {
+  const frames = [];
+  const steps = 4;
+  for (let n = 1; n <= steps; n++) {
+    const half = Math.round(n / steps * (WIDTH / 2));
+    const pad = WIDTH / 2 - half;
+    frames.push(`    ${theme.muted("\u254C".repeat(pad))}${theme.brand("\u2501".repeat(half * 2))}${theme.muted("\u254C".repeat(pad))}`);
+  }
+  await renderFrames(frames, INTERVAL);
+}
+async function animateCycleDetection(cycleCount) {
+  const frames = [];
+  const steps = 5;
+  for (let n = 1; n <= steps; n++) {
+    const filled = Math.round(n / steps * WIDTH);
+    const remaining = WIDTH - filled;
+    frames.push(`    ${theme.brand("\u2501".repeat(filled))}${remaining > 0 ? theme.muted("\u254C".repeat(remaining)) : theme.brand("\u25B8")}`);
+  }
+  const complete = "\u2501".repeat(WIDTH) + "\u25B8";
+  if (cycleCount > 0) {
+    frames.push(`    ${theme.warn(complete)}`);
+  } else {
+    frames.push(`    ${theme.brand(complete)}`);
+  }
+  await renderFrames(frames, INTERVAL);
+}
+async function animateLayerStack(layerNames) {
+  if (layerNames.length === 0) return;
+  const frames = [];
+  for (let i = 1; i <= layerNames.length; i++) {
+    const visible = layerNames.slice(0, i);
+    frames.push(`    ${theme.brand(visible.join(` ${theme.muted("\u25B8")} `))}`);
+  }
+  await renderFrames(frames, INTERVAL);
+}
+async function animateCommunities(communityCount) {
+  if (communityCount === 0) return;
+  const count = Math.min(communityCount, 5);
+  const frames = [];
+  const scattered = Array.from({ length: count }, () => "\u254C\u254C\u254C").join("  ");
+  frames.push(`    ${theme.muted(scattered)}`);
+  const partial = Array.from({ length: count }, () => "\u2501\u254C\u2501").join("  ");
+  frames.push(`    ${theme.brand(partial)}`);
+  const solid = Array.from({ length: count }, () => "\u2501\u2501\u2501").join("  ");
+  frames.push(`    ${theme.brand(solid)}`);
+  await renderFrames(frames, INTERVAL);
+}
+
+// src/index.ts
+var VERSION = true ? "1.4.0" : "0.0.0-dev";
+var NAME = true ? "codebrief" : "codebrief";
+var DESCRIPTION = true ? "Bootstrap optimized AI context files for any project. Auto-detect stack, generate code snapshots, produce config for Claude Code, Cursor, Copilot, Windsurf, Cline, Continue, Aider, and more." : "";
+function printHelp() {
+  console.log("");
+  console.log(gradient(" codebrief ", [90, 130, 220], [137, 180, 250], theme.brandBold));
+  console.log(theme.muted("  " + DESCRIPTION));
+  console.log("");
+  console.log(`  ${theme.bold("Usage:")}  npx ${NAME} [directory] [options]`);
+  console.log("");
+  console.log(`  ${theme.bold("Options:")}`);
+  console.log(`    ${theme.accent("-h, --help")}              Show this help message`);
+  console.log(`    ${theme.accent("-V, --version")}           Show version number`);
+  console.log(`    ${theme.accent("--force")}                 Overwrite existing files without asking`);
+  console.log(`    ${theme.accent("--dry-run")}               Preview what would be generated`);
+  console.log(`    ${theme.accent("--reconfigure")}           Re-prompt even if .codebrief.json exists`);
+  console.log(`    ${theme.accent("--refresh-snapshot")}      Re-scan source files, update code snapshot only`);
+  console.log(`    ${theme.accent("--check")}                 Exit 0 if snapshot is fresh, 1 if stale (hash-based)`);
+  console.log(`    ${theme.accent("--check=timestamp")}       Exit 0/1 based on age only (no Node.js needed in shell hooks)`);
+  console.log(`    ${theme.accent("--max-tokens=N")}          Set the token budget for the code snapshot`);
+  console.log(`    ${theme.accent("--generate-skills")}       Generate Claude Code skill files`);
+  console.log(`    ${theme.accent("-v, --verbose")}           Show detailed progress output`);
+  console.log("");
+  console.log(`  ${theme.bold("Examples:")}`);
+  console.log(`    ${theme.muted("$")} npx ${NAME}                   ${theme.muted("# analyze current directory")}`);
+  console.log(`    ${theme.muted("$")} npx ${NAME} ./my-project      ${theme.muted("# analyze a specific project")}`);
+  console.log(`    ${theme.muted("$")} npx ${NAME} --dry-run          ${theme.muted("# preview without writing files")}`);
+  console.log(`    ${theme.muted("$")} npx ${NAME} --refresh-snapshot ${theme.muted("# update code snapshot only")}`);
+  console.log("");
+}
 async function main() {
   const startTime = performance.now();
   const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    process.exit(0);
+  }
+  if (args.includes("--version") || args.includes("-V")) {
+    console.log(VERSION);
+    process.exit(0);
+  }
   const force = args.includes("--force");
   const dryRun = args.includes("--dry-run");
   const refresh = args.includes("--refresh-snapshot");
   const reconfigure = args.includes("--reconfigure");
-  const check = args.includes("--check");
+  const checkArg = args.find((a) => a === "--check" || a.startsWith("--check="));
+  const check = !!checkArg;
+  const checkTimestamp = checkArg === "--check=timestamp";
   const verbose = args.includes("--verbose") || args.includes("-v");
   const generateSkills = args.includes("--generate-skills");
   const maxTokensArg = args.find((a) => a.startsWith("--max-tokens="));
@@ -3414,18 +3841,32 @@ async function main() {
   )).some(Boolean);
   if (!hasProjectMarker) {
     console.log("");
-    p4.intro(pc3.bold(" codebrief "));
-    p4.log.error(`No project found at ${pc3.cyan(rootDir)}`);
-    p4.log.info(`Run ${pc3.bold("npx codebrief")} from a project directory, or pass a path:
-  ${pc3.dim("npx codebrief ./my-project")}`);
+    p4.intro(theme.bold(" codebrief "));
+    p4.log.error(`No project found at ${theme.accent(rootDir)}`);
+    p4.log.info(`Run ${theme.bold("npx codebrief")} from a project directory, or pass a path:
+  ${theme.muted("npx codebrief ./my-project")}`);
     p4.outro("");
     process.exit(1);
   }
   const verboseLog = (msg) => {
-    if (verbose) p4.log.info(pc3.dim(msg));
+    if (verbose) p4.log.info(theme.muted(msg));
   };
   if (check) {
     const config = await loadConfig(rootDir);
+    if (checkTimestamp) {
+      if (!config?.snapshotGeneratedAt) {
+        process.exit(0);
+      }
+      const staleDays = config.staleDays ?? 7;
+      const daysSince = Math.floor(
+        (Date.now() - config.snapshotGeneratedAt) / (1e3 * 60 * 60 * 24)
+      );
+      if (daysSince > staleDays) {
+        console.log(`codebrief: snapshot is ${daysSince}d old. Run: npx codebrief --refresh-snapshot`);
+        process.exit(1);
+      }
+      process.exit(0);
+    }
     if (!config?.snapshotHash) {
       process.exit(0);
     }
@@ -3440,16 +3881,17 @@ async function main() {
     process.exit(0);
   }
   console.log("");
-  p4.intro(pc3.bold(" codebrief "));
+  p4.intro(gradient(" codebrief ", [90, 130, 220], [137, 180, 250], theme.brandBold));
+  p4.log.info(theme.muted("code analysis for AI context"));
   if (refresh) {
     await refreshSnapshot(rootDir);
-    p4.outro(pc3.green("Snapshot refreshed!"));
+    p4.outro(theme.success("Snapshot refreshed!"));
     return;
   }
   if (dryRun) {
-    p4.log.warn(pc3.yellow("DRY RUN \u2014 no files will be written"));
+    p4.log.warn(theme.warn("DRY RUN: no files will be written"));
   }
-  p4.log.info(`Analyzing ${pc3.cyan(rootDir)}`);
+  p4.log.info(`Analyzing ${theme.accent(rootDir)}`);
   const spinner3 = p4.spinner();
   const spinnerProgress = (msg) => spinner3.message(msg);
   spinner3.start("Detecting tech stack...");
@@ -3461,6 +3903,7 @@ async function main() {
   spinner3.stop(
     `Import graph: ${graph.edges.length} edges, ${graph.externalImportCounts.size} packages.` + (topHub ? ` Top hub: ${topHub.path}` : "")
   );
+  await animateGraphBuild(detected.sourceFileCount, graph.edges.length);
   detected.frameworks = enrichFrameworksWithUsage(
     detected.frameworks,
     graph.externalImportCounts
@@ -3468,137 +3911,136 @@ async function main() {
   {
     const lines = [];
     const lang = detected.hasTypeScript ? "TypeScript" : detected.language !== "other" ? detected.language.charAt(0).toUpperCase() + detected.language.slice(1) : "";
-    if (lang) lines.push(`  Language:   ${lang}`);
+    if (lang) lines.push(`  ${"Language"}   ${theme.accentBold(lang)}`);
     if (detected.frameworks.length > 0) {
-      lines.push(`  Frameworks: ${detected.frameworks.map((f) => f.name).join(", ")}`);
+      lines.push(`  ${"Frameworks"} ${theme.accentBold(detected.frameworks.map((f) => f.name).join(", "))}`);
     }
     if (detected.linter !== "none") {
-      lines.push(`  Linter:     ${detected.linter.charAt(0).toUpperCase() + detected.linter.slice(1)}`);
+      lines.push(`  ${"Linter"}     ${theme.accentBold(detected.linter.charAt(0).toUpperCase() + detected.linter.slice(1))}`);
     }
     if (detected.packageManager !== "none") {
-      lines.push(`  Pkg mgr:    ${detected.packageManager}`);
+      lines.push(`  ${"Pkg mgr"}    ${theme.accentBold(detected.packageManager)}`);
     }
     if (detected.testFramework) {
-      lines.push(`  Testing:    ${detected.testFramework}`);
+      lines.push(`  ${"Testing"}    ${theme.accentBold(detected.testFramework)}`);
     }
     if (detected.ciProvider) {
-      lines.push(`  CI:         ${detected.ciProvider}`);
+      lines.push(`  ${"CI"}         ${theme.accentBold(detected.ciProvider)}`);
     }
     if (detected.monorepo) {
-      lines.push(`  Monorepo:   ${detected.monorepo.type} (${detected.monorepo.packages.length} package${detected.monorepo.packages.length === 1 ? "" : "s"})`);
+      lines.push(`  ${"Monorepo"}   ${theme.accentBold(`${detected.monorepo.type} (${detected.monorepo.packages.length} package${detected.monorepo.packages.length === 1 ? "" : "s"})`)}`);
     }
     if (detected.sourceFileCount > 0) {
-      lines.push(`  Files:      ${detected.sourceFileCount} (${formatBytes(detected.totalSourceBytes)})`);
+      lines.push(`  ${"Files"}      ${theme.accentBold(`${detected.sourceFileCount}`)} ${theme.muted(`(${formatBytes(detected.totalSourceBytes)})`)}`);
     }
     if (lines.length > 0) {
       p4.note(lines.join("\n"), "Detected Stack");
     }
   }
   const fileCount = graph.centrality.size;
-  spinner3.start(`Running PageRank on ${fileCount} files...`);
+  await animatePageRank();
   const hubFiles = getHubFiles(graph);
   const topHubName = hubFiles[0]?.path ?? "";
-  spinner3.stop(
-    hubFiles.length > 0 ? `${pc3.green("PageRank")}       found ${pc3.bold(String(hubFiles.length))} hub files` + (topHubName ? pc3.dim(` (top: ${topHubName})`) : "") : `${pc3.green("PageRank")}       ${pc3.dim("no hub files detected")}`
+  p4.log.step(
+    hubFiles.length > 0 ? `${theme.brand("PageRank")}       found ${theme.bold(String(hubFiles.length))} hub files` + (topHubName ? theme.muted(` (top: ${topHubName})`) : "") : `${theme.brand("PageRank")}       ${theme.muted("no hub files detected")}`
   );
   if (verbose && hubFiles.length > 0) {
     for (const h of hubFiles.slice(0, 5)) {
-      p4.log.info(pc3.dim(`  ${h.path} (centrality: ${h.centrality.toFixed(3)}, imported by ${h.importedBy})`));
+      p4.log.info(theme.muted(`  ${h.path} (centrality: ${h.centrality.toFixed(3)}, imported by ${h.importedBy})`));
     }
   }
-  spinner3.start("Finding circular dependencies...");
   const circularDeps = findCircularDeps(graph);
-  spinner3.stop(
-    circularDeps.length === 0 ? `${pc3.green("Tarjan SCC")}     no cycles found ${pc3.green("\u2713")}` : `${pc3.yellow("Tarjan SCC")}     ${pc3.bold(String(circularDeps.length))} cycle${circularDeps.length === 1 ? "" : "s"} found`
+  await animateCycleDetection(circularDeps.length);
+  p4.log.step(
+    circularDeps.length === 0 ? `${theme.brand("Tarjan SCC")}     no cycles found ${theme.check()}` : `${theme.warn("Tarjan SCC")}     ${theme.bold(String(circularDeps.length))} cycle${circularDeps.length === 1 ? "" : "s"} found`
   );
   if (verbose && circularDeps.length > 0) {
     for (const c of circularDeps.slice(0, 3)) {
-      p4.log.info(pc3.dim(`  ${c.chain.join(" \u2192 ")}`));
+      p4.log.info(theme.muted(`  ${c.chain.join(" \u2192 ")}`));
     }
   }
-  spinner3.start("Detecting architecture layers...");
   const { layers, layerEdges } = detectArchitecturalLayers(graph);
-  spinner3.stop(
-    layers.length > 0 ? `${pc3.green("Layers")}         ${layers.map((l) => l.name).join(" \u2192 ")}` : `${pc3.green("Layers")}         ${pc3.dim("no clear layers detected")}`
+  await animateLayerStack(layers.map((l) => l.name));
+  p4.log.step(
+    layers.length > 0 ? `${theme.brand("Layers")}         ${layers.map((l) => l.name).join(" \u2192 ")}` : `${theme.brand("Layers")}         ${theme.muted("no clear layers detected")}`
   );
   if (verbose && layers.length > 0) {
     for (const l of layers) {
-      p4.log.info(pc3.dim(`  ${l.name}: ${l.files.length} files, depends on: ${l.dependsOn.join(", ") || "none"}`));
+      p4.log.info(theme.muted(`  ${l.name}: ${l.files.length} files, depends on: ${l.dependsOn.join(", ") || "none"}`));
     }
   }
-  spinner3.start("Computing instability metrics...");
   const instabilities = computeInstability(graph);
   const highInstability = instabilities.filter((f) => f.instability > 0.8);
-  spinner3.stop(
-    highInstability.length > 0 ? `${pc3.yellow("Instability")}    ${pc3.bold(String(highInstability.length))} high-risk file${highInstability.length === 1 ? "" : "s"}` : `${pc3.green("Instability")}    ${pc3.dim("all files within healthy range")} ${pc3.green("\u2713")}`
+  p4.log.step(
+    highInstability.length > 0 ? `${theme.warn("Instability")}    ${theme.bold(String(highInstability.length))} high-risk file${highInstability.length === 1 ? "" : "s"}` : `${theme.brand("Instability")}    ${theme.muted("all files within healthy range")} ${theme.check()}`
   );
   if (verbose && highInstability.length > 0) {
     for (const f of highInstability.slice(0, 5)) {
-      p4.log.info(pc3.dim(`  ${f.path} (I=${f.instability.toFixed(2)}, fan-in=${f.fanIn}, fan-out=${f.fanOut})`));
+      p4.log.info(theme.muted(`  ${f.path} (I=${f.instability.toFixed(2)}, fan-in=${f.fanIn}, fan-out=${f.fanOut})`));
     }
   }
-  spinner3.start("Detecting module communities...");
   const communities = detectCommunities(graph);
-  spinner3.stop(
-    communities.length > 0 ? `${pc3.green("Communities")}    ${pc3.bold(String(communities.length))} module cluster${communities.length === 1 ? "" : "s"}` : `${pc3.green("Communities")}    ${pc3.dim("single cohesive module")}`
+  await animateCommunities(communities.length);
+  p4.log.step(
+    communities.length > 0 ? `${theme.brand("Communities")}    ${theme.bold(String(communities.length))} module cluster${communities.length === 1 ? "" : "s"}` : `${theme.brand("Communities")}    ${theme.muted("single cohesive module")}`
   );
   if (verbose && communities.length > 0) {
     for (const c of communities.slice(0, 5)) {
-      p4.log.info(pc3.dim(`  ${c.label} (${c.files.length} files)`));
+      p4.log.info(theme.muted(`  ${c.label} (${c.files.length} files)`));
     }
   }
-  spinner3.start("Computing export coverage...");
   const exportCoverage = computeExportCoverage(graph);
   {
     const totalExp = exportCoverage.reduce((s, e) => s + e.totalExports, 0);
     const totalUsed = exportCoverage.reduce((s, e) => s + e.usedExports, 0);
     const unusedCount = totalExp - totalUsed;
     const filesWithUnused = exportCoverage.filter((e) => e.usedExports < e.totalExports).length;
-    spinner3.stop(
-      unusedCount > 0 ? `${pc3.yellow("Exports")}        ${pc3.bold(String(unusedCount))} unused export${unusedCount === 1 ? "" : "s"} in ${filesWithUnused} file${filesWithUnused === 1 ? "" : "s"}` : `${pc3.green("Exports")}        ${pc3.dim("all exports used")} ${pc3.green("\u2713")}`
+    p4.log.step(
+      unusedCount > 0 ? `${theme.warn("Exports")}        ${theme.bold(String(unusedCount))} unused export${unusedCount === 1 ? "" : "s"} in ${filesWithUnused} file${filesWithUnused === 1 ? "" : "s"}` : `${theme.brand("Exports")}        ${theme.muted("all exports used")} ${theme.check()}`
     );
     if (verbose && unusedCount > 0) {
       for (const e of exportCoverage.filter((e2) => e2.usedExports < e2.totalExports).slice(0, 5)) {
-        p4.log.info(pc3.dim(`  ${e.file}: ${e.totalExports - e.usedExports} unused of ${e.totalExports}`));
+        p4.log.info(theme.muted(`  ${e.file}: ${e.totalExports - e.usedExports} unused of ${e.totalExports}`));
       }
     }
   }
-  spinner3.start("Analyzing git history...");
-  const gitActivity = detected.isGitRepo ? analyzeGitActivity(rootDir, verbose ? verboseLog : spinnerProgress) : null;
+  const noopProgress = () => {
+  };
+  const gitActivity = detected.isGitRepo ? await analyzeGitActivity(rootDir, verbose ? verboseLog : noopProgress) : null;
   if (gitActivity) {
     const coupledPairs = gitActivity.changeCoupling.length;
-    spinner3.stop(
-      `${pc3.green("Git (90d)")}      ${pc3.bold(String(gitActivity.hotFiles.length))} active file${gitActivity.hotFiles.length === 1 ? "" : "s"}, ${pc3.bold(String(coupledPairs))} coupled pair${coupledPairs === 1 ? "" : "s"}`
+    p4.log.step(
+      `${theme.brand("Git (90d)")}      ${theme.bold(String(gitActivity.hotFiles.length))} active file${gitActivity.hotFiles.length === 1 ? "" : "s"}, ${theme.bold(String(coupledPairs))} coupled pair${coupledPairs === 1 ? "" : "s"}`
     );
     if (verbose) {
       for (const h of gitActivity.hotFiles.slice(0, 5)) {
-        p4.log.info(pc3.dim(`  ${h.path} (${h.commits} commits, last: ${h.lastChanged})`));
+        p4.log.info(theme.muted(`  ${h.path} (${h.commits} commits, last: ${h.lastChanged})`));
       }
     }
   } else {
-    spinner3.stop(`${pc3.green("Git")}            ${pc3.dim("not a git repo \u2014 skipped")}`);
+    p4.log.step(`${theme.brand("Git")}            ${theme.muted("not a git repo, skipped")}`);
   }
   const analysis = { hubFiles, circularDeps, layers, layerEdges, gitActivity, instabilities, communities, exportCoverage };
   {
     const reportLines = [];
-    reportLines.push(`  Files analyzed:  ${fileCount}`);
-    reportLines.push(`  Import edges:    ${graph.edges.length}`);
-    reportLines.push(`  External pkgs:   ${graph.externalImportCounts.size}`);
+    reportLines.push(`  ${"Files analyzed"}  ${theme.brandBold(String(fileCount))}`);
+    reportLines.push(`  ${"Import edges"}    ${theme.brandBold(String(graph.edges.length))}`);
+    reportLines.push(`  ${"External pkgs"}   ${theme.brandBold(String(graph.externalImportCounts.size))}`);
     if (hubFiles.length > 0) {
-      reportLines.push(`  Hub files:       ${hubFiles.length}` + (hubFiles[0] ? ` (most connected: ${hubFiles[0].path})` : ""));
+      reportLines.push(`  ${"Hub files"}       ${theme.brandBold(String(hubFiles.length))}` + (hubFiles[0] ? ` ${theme.muted(`(most connected: ${hubFiles[0].path})`)}` : ""));
     }
     if (layers.length > 0) {
-      reportLines.push(`  Architecture:    ${layers.map((l) => l.name).join(" \u2192 ")}`);
+      reportLines.push(`  ${"Architecture"}    ${theme.accentBold(layers.map((l) => l.name).join(" \u2192 "))}`);
     }
-    reportLines.push(`  Circular deps:   ${circularDeps.length === 0 ? "none" : `${circularDeps.length} chain${circularDeps.length === 1 ? "" : "s"}`}`);
+    reportLines.push(`  ${"Circular deps"}   ${circularDeps.length === 0 ? theme.success("none") : theme.warn(`${circularDeps.length} chain${circularDeps.length === 1 ? "" : "s"}`)}`);
     if (gitActivity) {
-      reportLines.push(`  Hot files (90d): ${gitActivity.hotFiles.length}`);
+      reportLines.push(`  ${"Hot files (90d)"} ${theme.brandBold(String(gitActivity.hotFiles.length))}`);
     }
     p4.note(reportLines.join("\n"), "Analysis Report");
     if (circularDeps.length > 0) {
       for (const c of circularDeps.slice(0, 2)) {
         const shortChain = c.chain.map((f) => f.split("/").pop() ?? f);
-        p4.log.warn(pc3.yellow(`Cycle: ${shortChain.join(" \u2192 ")}`));
+        p4.log.warn(theme.warn(`Cycle: ${shortChain.join(" \u2192 ")}`));
       }
     }
   }
@@ -3610,8 +4052,8 @@ async function main() {
         (Date.now() - savedConfig.snapshotGeneratedAt) / (1e3 * 60 * 60 * 24)
       );
       p4.log.warn(
-        pc3.yellow(
-          `Code snapshot may be stale (source files changed${daysSince > 0 ? `, last generated ${daysSince}d ago` : ""}). Run with ${pc3.bold("--refresh-snapshot")} to update.`
+        theme.warn(
+          `Code snapshot may be stale (source files changed${daysSince > 0 ? `, last generated ${daysSince}d ago` : ""}). Run with ${theme.bold("--refresh-snapshot")} to update.`
         )
       );
     }
@@ -3619,18 +4061,18 @@ async function main() {
   let answers;
   if (savedConfig && !reconfigure) {
     p4.log.info(
-      `Using saved config from ${pc3.cyan(".codebrief.json")} ` + pc3.dim("(run with --reconfigure to change)")
+      `Using saved config from ${theme.accent(".codebrief.json")} ` + theme.muted("(run with --reconfigure to change)")
     );
     answers = configToAnswers(savedConfig);
     if (detected.monorepo && detected.monorepo.packages.length > 0 && !savedConfig.generatePerPackage) {
     }
   } else {
-    answers = await runPrompts(detected, reconfigure ? savedConfig : null);
+    answers = await runPrompts(detected, reconfigure ? savedConfig : null, reconfigure);
     if (!dryRun) {
       const hash = await computeSnapshotHash(rootDir, detected.language);
       await saveConfig(rootDir, answers, hash, detected.language);
       p4.log.info(
-        pc3.dim("Saved config to .codebrief.json for future runs.")
+        theme.muted("Saved config to .codebrief.json for future runs.")
       );
     }
   }
@@ -3650,7 +4092,7 @@ async function main() {
   spinner3.start(
     dryRun ? "Preparing context files..." : "Generating context files..."
   );
-  const shouldGenerateSkills = generateSkills || answers.ide === "claude";
+  const shouldGenerateSkills = generateSkills || answers.ides.includes("claude");
   const files = await generateFiles(detected, answers, snapshot, force, dryRun, analysis, shouldGenerateSkills, verbose ? verboseLog : void 0);
   spinner3.stop(
     dryRun ? `Would generate ${files.length} file${files.length === 1 ? "" : "s"}.` : `Generated ${files.length} file${files.length === 1 ? "" : "s"}.`
@@ -3663,18 +4105,18 @@ async function main() {
   const elapsed = ((performance.now() - startTime) / 1e3).toFixed(1);
   if (dryRun) {
     p4.outro(
-      pc3.yellow("DRY RUN complete \u2014 ") + pc3.dim(`no files were written. Remove --dry-run to generate. (${elapsed}s)`)
+      theme.warn("DRY RUN complete. ") + theme.muted(`no files were written. Remove --dry-run to generate. (${elapsed}s)`)
     );
     return;
   }
   p4.outro(
-    pc3.green(`Done in ${elapsed}s! `) + pc3.dim(
-      "Your context files are ready. They are living documents \u2014 keep them up to date as your project evolves."
+    theme.success(`Done in ${elapsed}s! `) + theme.muted(
+      "Your context files are ready. They are living documents: keep them up to date as your project evolves."
     )
   );
 }
 main().catch((err) => {
-  console.error(pc3.red("Fatal error:"), err);
+  console.error(theme.error("Fatal error:"), err);
   process.exit(1);
 });
 //# sourceMappingURL=index.js.map