archondev 1.2.1 → 1.6.0

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
-  listModels,
-  resetPreferences,
-  setPreference,
-  showPreferences
-} from "./chunk-UG2ZZ7CM.js";
+  addKey,
+  listKeys,
+  removeKey,
+  setPrimaryKey
+} from "./chunk-IMZN36GC.js";
 import {
   reviewAnalyze,
   reviewExport,
@@ -18,6 +18,12 @@ import {
   reviewUpdate
 } from "./chunk-UDBFDXJI.js";
 import "./chunk-VKM3HAHW.js";
+import {
+  listModels,
+  resetPreferences,
+  setPreference,
+  showPreferences
+} from "./chunk-K2VBICW3.js";
 import {
   API_URL,
   SUPABASE_ANON_KEY,
@@ -27,397 +33,58 @@ import {
   status
 } from "./chunk-CAYCSBNX.js";
 import {
+  init,
+  isInitialized
+} from "./chunk-TJXGZB6T.js";
+import {
+  DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute
-} from "./chunk-I4ZVNLNO.js";
+} from "./chunk-S7UXMYWS.js";
 import {
   list
-} from "./chunk-PK3OQVBG.js";
+} from "./chunk-NCJN4X5A.js";
 import {
   listLocalAtoms,
   loadAtom,
   plan
-} from "./chunk-EDP55FCI.js";
+} from "./chunk-3AAQEUY6.js";
+import "./chunk-SMR7JQK6.js";
 import "./chunk-2CFO5GVH.js";
 import {
   bugReport
 } from "./chunk-JBKFAD4M.js";
 import "./chunk-MOZHC2GX.js";
 import "./chunk-A7QU6JC6.js";
-import {
-  addKey,
-  listKeys,
-  removeKey,
-  setPrimaryKey
-} from "./chunk-IMZN36GC.js";
-import "./chunk-SMR7JQK6.js";
 import {
   loadConfig
 } from "./chunk-WCCBJSNI.js";
 import "./chunk-QGM4M3NI.js";
 
 // src/cli/index.ts
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 import chalk6 from "chalk";
 import "dotenv/config";
 
-// src/cli/init.ts
-import { readdir, readFile, writeFile, mkdir } from "fs/promises";
-import { existsSync } from "fs";
-import { join, extname } from "path";
-import { execSync } from "child_process";
-import chalk from "chalk";
-import ora from "ora";
-import readline from "readline";
-function isInitialized(cwd) {
-  const archMdPath = join(cwd, "ARCHITECTURE.md");
-  const archonDir = join(cwd, ".archon");
-  return existsSync(archMdPath) || existsSync(archonDir);
-}
-var LANGUAGE_EXTENSIONS = {
-  ".ts": "TypeScript",
-  ".tsx": "TypeScript",
-  ".js": "JavaScript",
-  ".jsx": "JavaScript",
-  ".py": "Python",
-  ".go": "Go",
-  ".rs": "Rust",
-  ".java": "Java",
-  ".rb": "Ruby",
-  ".php": "PHP",
-  ".cs": "C#",
-  ".cpp": "C++",
-  ".c": "C",
-  ".swift": "Swift",
-  ".kt": "Kotlin",
-  ".vue": "Vue",
-  ".svelte": "Svelte"
-};
-var IGNORE_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  "dist",
-  "build",
-  ".next",
-  "coverage",
-  "__pycache__",
-  ".venv",
-  "venv",
-  "target",
-  "vendor",
-  ".archon"
-]);
-async function init(options = {}) {
-  const cwd = process.cwd();
-  const archMdPath = join(cwd, "ARCHITECTURE.md");
-  const archonDir = join(cwd, ".archon");
-  console.log(chalk.blue("\n\u{1F3DB}\uFE0F  ArchonDev Initialization\n"));
-  if (existsSync(archMdPath)) {
-    const overwrite = await promptYesNo("ARCHITECTURE.md already exists. Overwrite?", false);
-    if (!overwrite) {
-      console.log(chalk.yellow("Initialization cancelled."));
-      return;
-    }
-  }
-  const spinner = ora("Detecting project capabilities...").start();
-  const capabilities = await detectCapabilities(cwd);
-  spinner.succeed("Project capabilities detected");
-  spinner.start("Scanning codebase...");
-  const stats = await scanRepository(cwd);
-  spinner.succeed(`Scanned ${stats.totalFiles} files (${formatLines(stats.totalLines)} lines)`);
-  if (options.git !== false && !capabilities.hasGit) {
-    spinner.start("Initializing git repository...");
-    try {
-      execSync("git init", { cwd, stdio: "pipe" });
-      spinner.succeed("Git repository initialized");
-    } catch {
-      spinner.warn("Could not initialize git");
-    }
-  }
-  if (!existsSync(archonDir)) {
-    await mkdir(archonDir, { recursive: true });
-  }
-  spinner.start("Generating ARCHITECTURE.md...");
-  const archContent = generateArchitectureMd(capabilities, stats, options.analyze);
-  await writeFile(archMdPath, archContent);
-  spinner.succeed("ARCHITECTURE.md created");
-  printSummary(capabilities, stats, options.analyze);
-}
-function promptYesNo(question, defaultValue) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-    const hint = defaultValue ? "(Y/n)" : "(y/N)";
-    rl.question(`${question} ${hint} `, (answer) => {
-      rl.close();
-      if (answer.trim() === "") {
-        resolve(defaultValue);
-      } else {
-        resolve(answer.toLowerCase().startsWith("y"));
-      }
-    });
-  });
-}
-async function detectCapabilities(cwd) {
-  const hasFile = (name) => existsSync(join(cwd, name));
-  const hasJsonDep = async (name) => {
-    try {
-      const pkg = JSON.parse(await readFile(join(cwd, "package.json"), "utf-8"));
-      return !!(pkg.dependencies?.[name] || pkg.devDependencies?.[name]);
-    } catch {
-      return false;
-    }
-  };
-  let packageManager = null;
-  if (hasFile("pnpm-lock.yaml")) packageManager = "pnpm";
-  else if (hasFile("yarn.lock")) packageManager = "yarn";
-  else if (hasFile("bun.lockb")) packageManager = "bun";
-  else if (hasFile("package-lock.json")) packageManager = "npm";
-  const hasTypeScript = hasFile("tsconfig.json") || await hasJsonDep("typescript");
-  const hasESLint = hasFile(".eslintrc") || hasFile(".eslintrc.js") || hasFile("eslint.config.js") || await hasJsonDep("eslint");
-  const hasJest = hasFile("jest.config.js") || hasFile("jest.config.ts") || await hasJsonDep("jest") || await hasJsonDep("vitest");
-  const hasPrettier = hasFile(".prettierrc") || hasFile(".prettierrc.js") || await hasJsonDep("prettier");
-  const hasGit = hasFile(".git");
-  return {
-    hasTypeScript,
-    hasESLint,
-    hasJest,
-    hasPrettier,
-    hasGit,
-    packageManager,
-    primaryLanguage: hasTypeScript ? "TypeScript" : "JavaScript"
-  };
-}
-async function scanRepository(cwd) {
-  const stats = {
-    totalFiles: 0,
-    totalLines: 0,
-    languageBreakdown: {},
-    directories: []
-  };
-  async function scanDir(dir, depth = 0) {
-    if (depth > 10) return;
-    try {
-      const entries = await readdir(dir, { withFileTypes: true });
-      for (const entry of entries) {
-        if (IGNORE_DIRS.has(entry.name)) continue;
-        if (entry.name.startsWith(".") && entry.name !== ".github") continue;
-        const fullPath = join(dir, entry.name);
-        if (entry.isDirectory()) {
-          if (depth < 2) {
-            const relativePath = fullPath.replace(cwd, "").replace(/^\//, "");
-            if (relativePath) {
-              stats.directories.push(relativePath);
-            }
-          }
-          await scanDir(fullPath, depth + 1);
-        } else if (entry.isFile()) {
-          const ext = extname(entry.name).toLowerCase();
-          const language = LANGUAGE_EXTENSIONS[ext];
-          if (language) {
-            stats.totalFiles++;
-            try {
-              const content = await readFile(fullPath, "utf-8");
-              const lines = content.split("\n").length;
-              stats.totalLines += lines;
-              if (!stats.languageBreakdown[language]) {
-                stats.languageBreakdown[language] = { files: 0, lines: 0 };
-              }
-              stats.languageBreakdown[language].files++;
-              stats.languageBreakdown[language].lines += lines;
-            } catch {
-            }
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  await scanDir(cwd);
-  return stats;
-}
-function generateArchitectureMd(capabilities, stats, analyze) {
-  const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const suggestedComponents = stats.directories.filter((d) => !d.includes("/")).slice(0, 10).map((dir) => ({
-    id: dir.replace(/[^a-zA-Z0-9]/g, "-"),
-    name: dir.charAt(0).toUpperCase() + dir.slice(1),
-    path: `${dir}/**`
-  }));
-  const qualityGates = [];
-  if (capabilities.hasTypeScript) qualityGates.push("SYNTAX");
-  if (capabilities.hasESLint) qualityGates.push("LINT");
-  if (capabilities.hasJest) qualityGates.push("UNIT");
-  return `---
-version: "1.0"
-updatedAt: "${now}"
-profile: "balanced"
-strictMode: true
-
-# System Goals
-systemGoals:
-  - id: "GOAL-001"
-    title: "Maintain code quality"
-    description: "All changes must pass quality gates before merging"
-    priority: "HIGH"
-
-  - id: "GOAL-002"
-    title: "Preserve architectural boundaries"
-    description: "Components should not violate defined boundaries"
-    priority: "HIGH"
-
-# Components & Boundaries
-# Detected ${suggestedComponents.length} top-level directories
-components:
-${suggestedComponents.map((c) => `  - id: "${c.id}"
-    name: "${c.name}"
-    paths:
-      - "${c.path}"
-    boundary: "INTERNAL"
-    stability: "EVOLVING"`).join("\n\n")}
-
-# Invariants (Rules to enforce)
-invariants:
-  - id: "INV-001"
-    severity: "WARN"
-    rule: "Avoid console.log in production code"
-    match: "console\\\\.log"
-    scope: "src"
-    reason: "Use proper logging library instead"
-
-# Protected Paths
-protectedPaths:
-  - pattern: "package.json"
-    level: "SOFT"
-    reason: "Dependency changes should be reviewed"
-
-${capabilities.hasTypeScript ? `  - pattern: "tsconfig.json"
-    level: "SOFT"
-    reason: "TypeScript config affects entire project"` : ""}
-
-# Environment Configuration
-environments:
-  development:
-    autoApprove: true
-    qualityGates:
-      - ARCHITECTURE
-${qualityGates.map((g) => `      - ${g}`).join("\n")}
-
-  production:
-    autoApprove: false
-    requiresManualPromotion: true
-    qualityGates:
-      - ARCHITECTURE
-${qualityGates.map((g) => `      - ${g}`).join("\n")}
-      - ACCEPTANCE
----
-
-# Project Architecture
-
-## Overview
-
-This architecture document was auto-generated by ArchonDev on ${now}.
-
-${analyze ? `## Codebase Analysis
-
-- **Total Files:** ${stats.totalFiles}
-- **Total Lines:** ${formatLines(stats.totalLines)}
-- **Primary Language:** ${capabilities.primaryLanguage}
-
-### Language Breakdown
-
-${Object.entries(stats.languageBreakdown).sort((a, b) => b[1].lines - a[1].lines).map(([lang, data]) => `- ${lang}: ${data.files} files, ${formatLines(data.lines)} lines`).join("\n")}
-
-### Detected Capabilities
-
-- TypeScript: ${capabilities.hasTypeScript ? "\u2705" : "\u274C"}
-- ESLint: ${capabilities.hasESLint ? "\u2705" : "\u274C"}
-- Testing: ${capabilities.hasJest ? "\u2705" : "\u274C"}
-- Package Manager: ${capabilities.packageManager ?? "Not detected"}
-` : ""}
-## Components
-
-${suggestedComponents.map((c) => `### ${c.name}
-
-Path: \`${c.path}\`
-
-TODO: Add description for this component.
-`).join("\n")}
-
-## Getting Started
-
-1. Review and customize the components above
-2. Add invariants for your specific rules
-3. Define protected paths for sensitive files
-4. Run \`archon plan <description>\` to create your first atom
-
-## Architecture Decision Records
-
-Document important architectural decisions here.
-`;
-}
-function formatLines(n) {
-  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
-  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}K`;
-  return n.toString();
-}
-function printSummary(capabilities, stats, analyze) {
-  console.log();
-  console.log(chalk.green("\u2713 ArchonDev initialized successfully!"));
-  console.log();
-  console.log(chalk.bold("Detected Capabilities:"));
-  console.log(`  ${capabilities.hasTypeScript ? chalk.green("\u2713") : chalk.gray("\u25CB")} TypeScript`);
-  console.log(`  ${capabilities.hasESLint ? chalk.green("\u2713") : chalk.gray("\u25CB")} ESLint`);
-  console.log(`  ${capabilities.hasJest ? chalk.green("\u2713") : chalk.gray("\u25CB")} Testing (Jest/Vitest)`);
-  console.log(`  ${capabilities.packageManager ? chalk.green("\u2713") : chalk.gray("\u25CB")} Package Manager: ${capabilities.packageManager ?? "none"}`);
-  console.log();
-  console.log(chalk.bold("Codebase Summary:"));
-  console.log(`  Files: ${stats.totalFiles}`);
-  console.log(`  Lines: ${formatLines(stats.totalLines)}`);
-  console.log(`  Directories: ${stats.directories.length}`);
-  console.log();
-  if (Object.keys(stats.languageBreakdown).length > 0) {
-    console.log(chalk.bold("Languages:"));
-    Object.entries(stats.languageBreakdown).sort((a, b) => b[1].lines - a[1].lines).slice(0, 5).forEach(([lang, data]) => {
-      const pct = Math.round(data.lines / stats.totalLines * 100);
-      console.log(`  ${lang}: ${pct}%`);
-    });
-    console.log();
-  }
-  if (analyze && stats.directories.length > 0) {
-    console.log(chalk.bold("Suggested Boundaries:"));
-    stats.directories.filter((d) => !d.includes("/")).slice(0, 5).forEach((dir) => {
-      console.log(`  \u2022 ${dir}/`);
-    });
-    console.log();
-  }
-  console.log(chalk.bold("Next Steps:"));
-  console.log(`  1. ${chalk.cyan("Review")} ARCHITECTURE.md and customize components`);
-  console.log(`  2. ${chalk.cyan("Run")} ${chalk.dim('archon plan "your first task"')} to create an atom`);
-  console.log(`  3. ${chalk.cyan("Execute")} ${chalk.dim("archon execute ATOM-001")} to implement it`);
-  console.log();
-}
-
 // src/cli/promote.ts
-import chalk2 from "chalk";
-import { existsSync as existsSync2 } from "fs";
-import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
-import { join as join2 } from "path";
+import chalk from "chalk";
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import { join } from "path";
 var ATOMS_DIR = ".archon/atoms";
 async function promote(atomId, options) {
   const cwd = process.cwd();
   const atom = await loadAtom(atomId);
   if (!atom) {
-    console.error(chalk2.red(`Atom ${atomId} not found.`));
-    console.log(chalk2.dim(`Use "archon list" to see available atoms.`));
+    console.error(chalk.red(`Atom ${atomId} not found.`));
+    console.log(chalk.dim(`Use "archon list" to see available atoms.`));
     process.exit(1);
   }
   const envLoader = new EnvironmentConfigLoader(cwd);
   if (!envLoader.isValidEnvironment(options.to)) {
-    console.error(chalk2.red(`Invalid target environment: ${options.to}`));
-    console.log(chalk2.dim("Valid environments: development, staging, production"));
+    console.error(chalk.red(`Invalid target environment: ${options.to}`));
+    console.log(chalk.dim("Valid environments: development, staging, production"));
     process.exit(1);
   }
   const targetEnv = options.to;
@@ -427,185 +94,185 @@ async function promote(atomId, options) {
   const currentEnv = envState?.lastExecutedEnv ?? "development";
   const result = validator.validatePromotion(atom, targetEnv, currentEnv);
   if (!result.success) {
-    console.error(chalk2.red("Promotion failed:"));
-    console.error(chalk2.red(result.message));
+    console.error(chalk.red("Promotion failed:"));
+    console.error(chalk.red(result.message));
     process.exit(1);
   }
   await saveAtomEnvironmentState(atomId, cwd, {
     lastExecutedEnv: currentEnv,
     promotedTo: [...envState?.promotedTo ?? [], targetEnv]
   });
-  console.log(chalk2.green(`\u2713 ${result.message}`));
-  console.log(chalk2.dim(`
+  console.log(chalk.green(`\u2713 ${result.message}`));
+  console.log(chalk.dim(`
 To execute in ${targetEnv}:`));
-  console.log(chalk2.cyan(`  archon execute ${atomId} --env=${targetEnv}`));
+  console.log(chalk.cyan(`  archon execute ${atomId} --env=${targetEnv}`));
 }
 async function loadAtomEnvironmentState(atomId, cwd) {
-  const stateFile = join2(cwd, ATOMS_DIR, `${atomId}.env.json`);
-  if (!existsSync2(stateFile)) {
+  const stateFile = join(cwd, ATOMS_DIR, `${atomId}.env.json`);
+  if (!existsSync(stateFile)) {
     return null;
   }
-  const content = await readFile2(stateFile, "utf-8");
+  const content = await readFile(stateFile, "utf-8");
   return JSON.parse(content);
 }
 async function saveAtomEnvironmentState(atomId, cwd, state) {
-  const stateFile = join2(cwd, ATOMS_DIR, `${atomId}.env.json`);
-  await writeFile2(stateFile, JSON.stringify(state, null, 2));
+  const stateFile = join(cwd, ATOMS_DIR, `${atomId}.env.json`);
+  await writeFile(stateFile, JSON.stringify(state, null, 2));
 }
 
 // src/cli/show.ts
-import chalk3 from "chalk";
+import chalk2 from "chalk";
 var STATUS_COLORS = {
-  DRAFT: chalk3.gray,
-  READY: chalk3.blue,
-  IN_PROGRESS: chalk3.yellow,
-  TESTING: chalk3.cyan,
-  DONE: chalk3.green,
-  FAILED: chalk3.red,
-  BLOCKED: chalk3.magenta
+  DRAFT: chalk2.gray,
+  READY: chalk2.blue,
+  IN_PROGRESS: chalk2.yellow,
+  TESTING: chalk2.cyan,
+  DONE: chalk2.green,
+  FAILED: chalk2.red,
+  BLOCKED: chalk2.magenta
 };
 async function show(atomId) {
   const atom = await loadAtom(atomId);
   if (!atom) {
-    console.error(chalk3.red(`Atom ${atomId} not found.`));
-    console.log(chalk3.dim('Use "archon list" to see available atoms.'));
+    console.error(chalk2.red(`Atom ${atomId} not found.`));
+    console.log(chalk2.dim('Use "archon list" to see available atoms.'));
     process.exit(1);
   }
-  const colorFn = STATUS_COLORS[atom.status] ?? chalk3.white;
+  const colorFn = STATUS_COLORS[atom.status] ?? chalk2.white;
   console.log("");
-  console.log(chalk3.bold(`Atom: ${atom.externalId}`));
-  console.log(chalk3.dim("\u2550".repeat(60)));
+  console.log(chalk2.bold(`Atom: ${atom.externalId}`));
+  console.log(chalk2.dim("\u2550".repeat(60)));
   console.log("");
-  console.log(chalk3.bold("Title:"), atom.title);
+  console.log(chalk2.bold("Title:"), atom.title);
   if (atom.description) {
-    console.log(chalk3.bold("Description:"), atom.description);
+    console.log(chalk2.bold("Description:"), atom.description);
   }
-  console.log(chalk3.bold("Status:"), colorFn(atom.status));
-  console.log(chalk3.bold("Priority:"), atom.priority);
-  console.log(chalk3.bold("Created:"), formatDateTime(atom.createdAt));
-  console.log(chalk3.bold("Updated:"), formatDateTime(atom.updatedAt));
+  console.log(chalk2.bold("Status:"), colorFn(atom.status));
+  console.log(chalk2.bold("Priority:"), atom.priority);
+  console.log(chalk2.bold("Created:"), formatDateTime(atom.createdAt));
+  console.log(chalk2.bold("Updated:"), formatDateTime(atom.updatedAt));
   if (atom.goals && atom.goals.length > 0) {
     console.log("");
-    console.log(chalk3.bold("Goals:"));
+    console.log(chalk2.bold("Goals:"));
     for (const goal of atom.goals) {
       console.log(`  \u2022 ${goal}`);
     }
   }
   if (atom.acceptanceCriteria && atom.acceptanceCriteria.length > 0) {
     console.log("");
-    console.log(chalk3.bold("Acceptance Criteria:"));
+    console.log(chalk2.bold("Acceptance Criteria:"));
     for (let i = 0; i < atom.acceptanceCriteria.length; i++) {
       console.log(`  ${i + 1}. ${atom.acceptanceCriteria[i]}`);
     }
   }
   if (atom.tags && atom.tags.length > 0) {
     console.log("");
-    console.log(chalk3.bold("Tags:"), atom.tags.join(", "));
+    console.log(chalk2.bold("Tags:"), atom.tags.join(", "));
   }
   if (atom.plan) {
     console.log("");
-    console.log(chalk3.bold("Implementation Plan:"));
-    console.log(chalk3.dim("\u2500".repeat(40)));
-    console.log(chalk3.bold("Steps:"));
+    console.log(chalk2.bold("Implementation Plan:"));
+    console.log(chalk2.dim("\u2500".repeat(40)));
+    console.log(chalk2.bold("Steps:"));
     for (let i = 0; i < atom.plan.steps.length; i++) {
       console.log(`  ${i + 1}. ${atom.plan.steps[i]}`);
     }
     if (atom.plan.files_to_modify.length > 0) {
       console.log("");
-      console.log(chalk3.bold("Files to modify:"));
+      console.log(chalk2.bold("Files to modify:"));
       for (const file of atom.plan.files_to_modify) {
         console.log(`  \u2022 ${file}`);
       }
     }
     if (atom.plan.dependencies.length > 0) {
       console.log("");
-      console.log(chalk3.bold("Dependencies:"));
+      console.log(chalk2.bold("Dependencies:"));
       for (const dep of atom.plan.dependencies) {
         console.log(`  \u2022 ${dep}`);
       }
     }
     if (atom.plan.risks.length > 0) {
       console.log("");
-      console.log(chalk3.bold("Risks:"));
+      console.log(chalk2.bold("Risks:"));
       for (const risk of atom.plan.risks) {
-        console.log(chalk3.yellow(`  \u26A0 ${risk}`));
+        console.log(chalk2.yellow(`  \u26A0 ${risk}`));
       }
     }
     console.log("");
-    console.log(chalk3.bold("Estimated Complexity:"), atom.plan.estimated_complexity);
+    console.log(chalk2.bold("Estimated Complexity:"), atom.plan.estimated_complexity);
   }
   if (atom.status === "FAILED" && atom.errorMessage) {
     console.log("");
-    console.log(chalk3.bold("Error:"));
-    console.log(chalk3.red(`  ${atom.errorMessage}`));
+    console.log(chalk2.bold("Error:"));
+    console.log(chalk2.red(`  ${atom.errorMessage}`));
   }
   if (atom.retryCount > 0) {
     console.log("");
-    console.log(chalk3.bold("Retry Count:"), chalk3.yellow(String(atom.retryCount)));
+    console.log(chalk2.bold("Retry Count:"), chalk2.yellow(String(atom.retryCount)));
   }
   if (atom.ownershipPaths && atom.ownershipPaths.length > 0) {
     console.log("");
-    console.log(chalk3.bold("Ownership Paths:"));
+    console.log(chalk2.bold("Ownership Paths:"));
     for (const path2 of atom.ownershipPaths) {
       console.log(`  \u2022 ${path2}`);
     }
   }
   if (atom.diffContract) {
     console.log("");
-    console.log(chalk3.bold("Diff Contract:"));
+    console.log(chalk2.bold("Diff Contract:"));
     if (atom.diffContract.allowed_paths.length > 0) {
-      console.log(chalk3.dim("  Allowed paths:"));
+      console.log(chalk2.dim("  Allowed paths:"));
       for (const path2 of atom.diffContract.allowed_paths) {
         console.log(`    \u2713 ${path2}`);
       }
     }
     if (atom.diffContract.forbidden_paths.length > 0) {
-      console.log(chalk3.dim("  Forbidden paths:"));
+      console.log(chalk2.dim("  Forbidden paths:"));
       for (const path2 of atom.diffContract.forbidden_paths) {
-        console.log(chalk3.red(`    \u2717 ${path2}`));
+        console.log(chalk2.red(`    \u2717 ${path2}`));
       }
     }
   }
   if (atom.context && Object.keys(atom.context).length > 0) {
     console.log("");
-    console.log(chalk3.bold("Context:"));
+    console.log(chalk2.bold("Context:"));
     if (atom.context.relevantFiles && atom.context.relevantFiles.length > 0) {
-      console.log(chalk3.dim("  Relevant files:"));
+      console.log(chalk2.dim("  Relevant files:"));
       for (const file of atom.context.relevantFiles) {
         console.log(`    \u2022 ${file}`);
       }
     }
     if (atom.context.recentLearnings && atom.context.recentLearnings.length > 0) {
-      console.log(chalk3.dim("  Recent learnings:"));
+      console.log(chalk2.dim("  Recent learnings:"));
       for (const learning of atom.context.recentLearnings) {
         console.log(`    \u2022 ${learning}`);
       }
     }
   }
   console.log("");
-  console.log(chalk3.dim("\u2500".repeat(60)));
-  console.log(chalk3.bold("Next Steps:"));
+  console.log(chalk2.dim("\u2500".repeat(60)));
+  console.log(chalk2.bold("Next Steps:"));
   switch (atom.status) {
     case "DRAFT":
-      console.log(chalk3.dim(`  Run "archon plan ${atom.externalId} --continue" to finalize the plan`));
+      console.log(chalk2.dim(`  Run "archon plan ${atom.externalId} --continue" to finalize the plan`));
       break;
     case "READY":
-      console.log(chalk3.dim(`  Run "archon execute ${atom.externalId}" to implement`));
+      console.log(chalk2.dim(`  Run "archon execute ${atom.externalId}" to implement`));
       break;
     case "IN_PROGRESS":
-      console.log(chalk3.dim("  Execution is in progress..."));
+      console.log(chalk2.dim("  Execution is in progress..."));
       break;
     case "TESTING":
-      console.log(chalk3.dim("  Waiting for quality gates to complete..."));
+      console.log(chalk2.dim("  Waiting for quality gates to complete..."));
       break;
     case "DONE":
-      console.log(chalk3.green("  \u2713 Atom completed successfully!"));
+      console.log(chalk2.green("  \u2713 Atom completed successfully!"));
       break;
     case "FAILED":
-      console.log(chalk3.dim(`  Review the error and run "archon execute ${atom.externalId}" to retry`));
+      console.log(chalk2.dim(`  Review the error and run "archon execute ${atom.externalId}" to retry`));
       break;
     case "BLOCKED":
-      console.log(chalk3.dim("  This atom is blocked. Manual intervention required."));
+      console.log(chalk2.dim("  This atom is blocked. Manual intervention required."));
       break;
   }
   console.log("");
@@ -616,47 +283,34 @@ function formatDateTime(date) {
 }
 
 // src/cli/start.ts
-import chalk4 from "chalk";
-import readline2 from "readline";
-import { existsSync as existsSync3, readdirSync } from "fs";
-import { join as join3 } from "path";
+import chalk3 from "chalk";
+import readline from "readline";
+import { existsSync as existsSync2, readFileSync, readdirSync, appendFileSync } from "fs";
+import { join as join2 } from "path";
 async function start() {
   const cwd = process.cwd();
-  console.log(chalk4.blue("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
-  console.log(chalk4.bold.white("  ArchonDev - AI-Powered Development Governance"));
-  console.log(chalk4.blue("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+  console.log(chalk3.blue("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+  console.log(chalk3.bold.white("  ArchonDev - AI-Powered Development Governance"));
+  console.log(chalk3.blue("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
   const projectState = detectProjectState(cwd);
-  await showProjectStatus(cwd, projectState);
-  const choices = [
-    { key: "1", label: "Plan a new task", action: () => planTask() },
-    { key: "2", label: "List atoms", action: () => listAtoms() },
-    { key: "3", label: "Execute next atom", action: () => executeNext() },
-    { key: "4", label: "Report a bug", action: () => reportBug() },
-    { key: "5", label: "View status", action: () => viewStatus() },
-    { key: "6", label: "Code Review", action: () => reviewCode() },
-    { key: "7", label: "Settings & Preferences", action: () => settingsMenu() },
-    { key: "q", label: "Quit", action: async () => process.exit(0) }
-  ];
-  console.log(chalk4.bold("What would you like to do?\n"));
-  for (const choice2 of choices) {
-    console.log(`  ${chalk4.cyan(choice2.key)}) ${choice2.label}`);
-  }
-  console.log();
-  const selected = await prompt("Enter choice");
-  const choice = choices.find((c) => c.key === selected.toLowerCase());
-  if (choice) {
-    await choice.action();
-  } else {
-    console.log(chalk4.yellow("Invalid choice. Please try again."));
-    await start();
+  switch (projectState.scenario) {
+    case "NEW_PROJECT":
+      await handleNewProject(cwd, projectState);
+      break;
+    case "ADAPT_EXISTING":
+      await handleAdaptExisting(cwd, projectState);
+      break;
+    case "CONTINUE_SESSION":
+      await handleContinueSession(cwd, projectState);
+      break;
   }
 }
 function detectProjectState(cwd) {
-  const sourceDirs = ["src", "lib", "app", "packages", "components"];
-  const sourceExtensions = [".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java"];
+  const sourceDirs = ["src", "lib", "app", "packages", "components", "pages", "api"];
+  const sourceExtensions = [".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java", ".rb", ".php"];
   let hasSourceFiles = false;
   for (const dir of sourceDirs) {
-    if (existsSync3(join3(cwd, dir))) {
+    if (existsSync2(join2(cwd, dir))) {
       hasSourceFiles = true;
       break;
     }
@@ -670,29 +324,351 @@ function detectProjectState(cwd) {
     } catch {
     }
   }
+  const projectMarkers = ["package.json", "Cargo.toml", "pyproject.toml", "go.mod", "pom.xml", "build.gradle"];
+  if (!hasSourceFiles) {
+    hasSourceFiles = projectMarkers.some((marker) => existsSync2(join2(cwd, marker)));
+  }
+  const hasArchitecture = existsSync2(join2(cwd, "ARCHITECTURE.md"));
+  const hasProgress = existsSync2(join2(cwd, "progress.txt"));
+  const hasReviewDb = existsSync2(join2(cwd, "docs", "code-review", "review-tasks.db"));
+  let hasProgressEntries = false;
+  let lastProgressEntry;
+  if (hasProgress) {
+    try {
+      const progressContent = readFileSync(join2(cwd, "progress.txt"), "utf-8");
+      const entries = progressContent.match(/^## \d{4}-\d{2}-\d{2}/gm);
+      hasProgressEntries = entries !== null && entries.length > 0;
+      if (hasProgressEntries) {
+        const lastMatch = progressContent.match(/## \d{4}-\d{2}-\d{2}[^\n]*\n([^#]*)/g);
+        if (lastMatch && lastMatch.length > 0) {
+          const last = lastMatch[lastMatch.length - 1] ?? "";
+          lastProgressEntry = last.split("\n").slice(0, 3).join("\n").trim();
+        }
+      }
+    } catch {
+    }
+  }
+  let scenario;
+  if (hasProgressEntries) {
+    scenario = "CONTINUE_SESSION";
+  } else if (hasSourceFiles) {
+    scenario = "ADAPT_EXISTING";
+  } else {
+    scenario = "NEW_PROJECT";
+  }
   return {
+    scenario,
     hasSourceFiles,
-    hasArchitecture: existsSync3(join3(cwd, "ARCHITECTURE.md")),
-    hasReviewDb: existsSync3(join3(cwd, "docs", "code-review", "review-tasks.db"))
+    hasArchitecture,
+    hasProgress,
+    hasProgressEntries,
+    hasReviewDb,
+    lastProgressEntry
   };
 }
-async function showProjectStatus(cwd, state) {
-  if (state.hasSourceFiles && !state.hasArchitecture) {
-    console.log(chalk4.yellow("\u{1F4C1} Existing project detected") + chalk4.dim(" (source files found, no ARCHITECTURE.md)"));
-    console.log(chalk4.dim("   Consider running ") + chalk4.cyan("Code Review") + chalk4.dim(" first, then set up governance."));
+async function handleNewProject(cwd, state) {
+  console.log(chalk3.yellow("\u{1F389}") + chalk3.bold(" Starting a new project? Great!\n"));
+  console.log(chalk3.dim("I'll ask you a few quick questions to set things up right."));
+  console.log(chalk3.dim("Answer as much or as little as you want \u2014 you can always refine later.\n"));
+  console.log(chalk3.bold("What would you like to do?\n"));
+  console.log(`  ${chalk3.cyan("1")}) ${chalk3.bold("Start interview")} \u2014 I'll ask questions to understand your project`);
+  console.log(`  ${chalk3.cyan("2")}) ${chalk3.bold("Quick start")} \u2014 Just create basic governance files`);
+  console.log(`  ${chalk3.cyan("3")}) ${chalk3.bold("Import from template")} \u2014 Use a predefined project template`);
+  console.log(`  ${chalk3.cyan("q")}) ${chalk3.dim("Quit")}`);
+  console.log();
+  const choice = await prompt("Enter choice");
+  switch (choice.toLowerCase()) {
+    case "1":
+      await runNewProjectInterview(cwd);
+      break;
+    case "2":
+      await quickStart(cwd);
+      break;
+    case "3":
+      console.log(chalk3.yellow("\nTemplates coming soon! Using quick start for now.\n"));
+      await quickStart(cwd);
+      break;
+    case "q":
+      process.exit(0);
+    default:
+      console.log(chalk3.yellow("Invalid choice. Please try again."));
+      await handleNewProject(cwd, state);
+  }
+}
+async function runNewProjectInterview(cwd) {
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Project Interview \u2501\u2501\u2501\n"));
+  console.log(chalk3.bold("Phase 1: The Vision\n"));
+  const projectName = await prompt("What's the project name?");
+  const projectDescription = await prompt("In one sentence, what does this project do?");
+  const audience = await promptChoice("Who is it for?", [
+    { key: "1", label: "Just me (personal project)" },
+    { key: "2", label: "My team (internal tool)" },
+    { key: "3", label: "End users (product)" }
+  ]);
+  const experience = await promptChoice("Your experience level with this tech stack?", [
+    { key: "1", label: "\u{1F7E2} Expert \u2014 I know this well" },
+    { key: "2", label: "\u{1F7E1} Intermediate \u2014 I've done similar work" },
+    { key: "3", label: "\u{1F534} Learning \u2014 This is new to me" }
+  ]);
+  console.log(chalk3.bold("\nPhase 2: Tech Stack\n"));
+  const language = await promptChoice("Primary language/framework?", [
+    { key: "1", label: "TypeScript / JavaScript" },
+    { key: "2", label: "Python" },
+    { key: "3", label: "Go" },
+    { key: "4", label: "Rust" },
+    { key: "5", label: "Other" }
+  ]);
+  const projectType = await promptChoice("Project type?", [
+    { key: "1", label: "Frontend only (web UI)" },
+    { key: "2", label: "Backend only (API, CLI, service)" },
+    { key: "3", label: "Full-stack (both)" },
+    { key: "4", label: "Library/package" }
+  ]);
+  console.log(chalk3.bold("\nPhase 3: Preferences ") + chalk3.dim("(press Enter to skip)\n"));
+  const protectedFiles = await prompt("Any files AI should NEVER modify without asking? (comma-separated)");
+  const noNoPatterns = await prompt('Anything AI should NEVER do? (e.g., "no console.log")');
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Generating Project Files \u2501\u2501\u2501\n"));
+  const { init: init2 } = await import("./init-YLAHY4CV.js");
+  await init2({ analyze: false, git: true });
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const progressEntry = `
+## ${today} - Project Initialized via Interview
+
+### Vision
+- **Name:** ${projectName || "Unnamed Project"}
+- **Description:** ${projectDescription || "No description provided"}
+- **Audience:** ${["Personal", "Team", "End Users"][parseInt(audience) - 1] || "Not specified"}
+- **Experience Level:** ${["Expert", "Intermediate", "Learning"][parseInt(experience) - 1] || "Not specified"}
+
+### Stack
+- **Language:** ${["TypeScript/JavaScript", "Python", "Go", "Rust", "Other"][parseInt(language) - 1] || "Not specified"}
+- **Type:** ${["Frontend", "Backend", "Full-stack", "Library"][parseInt(projectType) - 1] || "Not specified"}
+
+### Preferences
+${protectedFiles ? `- **Protected files:** ${protectedFiles}` : "- No protected files specified"}
+${noNoPatterns ? `- **Forbidden patterns:** ${noNoPatterns}` : "- No forbidden patterns specified"}
+
+### Files Created
+- ARCHITECTURE.md
+- .archon/config.yaml
+- progress.txt
+`;
+  const progressPath = join2(cwd, "progress.txt");
+  if (!existsSync2(progressPath)) {
+    const { writeFileSync } = await import("fs");
+    writeFileSync(progressPath, "# ArchonDev Progress Log\n\nThis file tracks learnings and decisions across sessions.\n");
+  }
+  appendFileSync(progressPath, progressEntry);
+  console.log(chalk3.green("\n\u2713 Project initialized!\n"));
+  console.log(chalk3.bold("Next steps:"));
+  console.log(`  1. ${chalk3.cyan("Review")} ARCHITECTURE.md and customize if needed`);
+  console.log(`  2. ${chalk3.cyan("Run")} ${chalk3.dim('archon plan "your first task"')} to create an atom`);
+  console.log();
+  const continueChoice = await promptYesNo("Would you like to plan your first task now?", true);
+  if (continueChoice) {
+    const description = await prompt("Describe what you want to build first");
+    if (description.trim()) {
+      const { plan: plan2 } = await import("./plan-WQUFH2WB.js");
+      await plan2(description, {});
+    }
+  }
+}
+async function quickStart(cwd) {
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Quick Start \u2501\u2501\u2501\n"));
+  const { init: init2 } = await import("./init-YLAHY4CV.js");
+  await init2({ analyze: false, git: true });
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const progressPath = join2(cwd, "progress.txt");
+  if (!existsSync2(progressPath)) {
+    const { writeFileSync } = await import("fs");
+    writeFileSync(progressPath, `# ArchonDev Progress Log
+
+This file tracks learnings and decisions across sessions.
+
+## ${today} - Project Initialized (Quick Start)
+
+### What was done
+- Created ARCHITECTURE.md with default template
+- Initialized .archon directory
+- Created this progress.txt
+
+### Next Steps
+1. Customize ARCHITECTURE.md for your project
+2. Run \`archon plan "your first task"\` to create an atom
+`);
+  }
+  console.log();
+  await showMainMenu();
+}
+async function handleAdaptExisting(cwd, state) {
+  console.log(chalk3.yellow("\u{1F4C1}") + chalk3.bold(" Existing project detected!\n"));
+  console.log(chalk3.dim("I can analyze your codebase and adapt the governance files to match your structure."));
+  console.log(chalk3.dim("This helps me understand your architecture without changing any code.\n"));
+  console.log(chalk3.bold("What would you like to do?\n"));
+  console.log(`  ${chalk3.cyan("1")}) ${chalk3.bold("Analyze and adapt")} \u2014 I'll scan your project and update ARCHITECTURE.md`);
+  console.log(`  ${chalk3.cyan("2")}) ${chalk3.bold("Code review first")} \u2014 Review code for issues before setting up governance`);
+  console.log(`  ${chalk3.cyan("3")}) ${chalk3.bold("Manual setup")} \u2014 Keep template files, customize manually`);
+  console.log(`  ${chalk3.cyan("4")}) ${chalk3.bold("Just start working")} \u2014 Skip setup, use defaults`);
+  console.log(`  ${chalk3.cyan("q")}) ${chalk3.dim("Quit")}`);
+  console.log();
+  const choice = await prompt("Enter choice");
+  switch (choice.toLowerCase()) {
+    case "1":
+      await analyzeAndAdapt(cwd);
+      break;
+    case "2":
+      await codeReviewFirst(cwd);
+      break;
+    case "3":
+      await manualSetup(cwd);
+      break;
+    case "4":
+      await quickAdapt(cwd);
+      break;
+    case "q":
+      process.exit(0);
+    default:
+      console.log(chalk3.yellow("Invalid choice. Please try again."));
+      await handleAdaptExisting(cwd, state);
+  }
+}
+async function analyzeAndAdapt(cwd) {
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Analyzing Project \u2501\u2501\u2501\n"));
+  const { init: init2 } = await import("./init-YLAHY4CV.js");
+  await init2({ analyze: true, git: true });
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const progressPath = join2(cwd, "progress.txt");
+  if (!existsSync2(progressPath)) {
+    const { writeFileSync } = await import("fs");
+    writeFileSync(progressPath, "# ArchonDev Progress Log\n\nThis file tracks learnings and decisions across sessions.\n");
+  }
+  appendFileSync(progressPath, `
+## ${today} - ArchonDev Adapted to Existing Project
+
+### What was done
+- Analyzed existing codebase structure
+- Generated ARCHITECTURE.md based on detected components
+- Created .archon configuration
+
+### Governance Files Created
+- ARCHITECTURE.md - Customized to match project structure
+- .archon/config.yaml - Build commands configured
+- progress.txt - This file
+`);
+  console.log(chalk3.green("\n\u2713 Governance files adapted!\n"));
+  await showMainMenu();
+}
+async function codeReviewFirst(cwd) {
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Code Review Mode \u2501\u2501\u2501\n"));
+  console.log(chalk3.dim("I'll analyze your code for issues without making any changes.\n"));
+  const { reviewInit: reviewInit2, reviewAnalyze: reviewAnalyze2, reviewRun: reviewRun2 } = await import("./review-3R6QXAXQ.js");
+  const reviewDbPath = join2(cwd, "docs", "code-review", "review-tasks.db");
+  if (!existsSync2(reviewDbPath)) {
+    await reviewInit2();
+  }
+  await reviewAnalyze2();
+  const runReview = await promptYesNo("Would you like to run the AI-powered review now?", true);
+  if (runReview) {
+    await reviewRun2({ all: true });
+  }
+  console.log(chalk3.dim("\nAfter reviewing, you can run ") + chalk3.cyan("archon") + chalk3.dim(" again to set up governance.\n"));
+}
+async function manualSetup(cwd) {
+  console.log(chalk3.blue("\n\u2501\u2501\u2501 Manual Setup \u2501\u2501\u2501\n"));
+  console.log(chalk3.dim("Creating template files. You can customize them manually.\n"));
+  const { init: init2 } = await import("./init-YLAHY4CV.js");
+  await init2({ analyze: false, git: true });
+  console.log(chalk3.bold("\nWhat to customize:\n"));
+  console.log(`  ${chalk3.cyan("1. ARCHITECTURE.md")} \u2014 Update components to match your folders`);
+  console.log(`  ${chalk3.cyan("2. .archon/config.yaml")} \u2014 Change build/test/lint commands`);
+  console.log(`  ${chalk3.cyan("3. progress.txt")} \u2014 Add project-specific patterns`);
+  console.log();
+  await showMainMenu();
+}
+async function quickAdapt(cwd) {
+  console.log(chalk3.blue("\n\u26A1 Using defaults \u2014 let's go!\n"));
+  const { init: init2 } = await import("./init-YLAHY4CV.js");
+  await init2({ analyze: true, git: true });
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const progressPath = join2(cwd, "progress.txt");
+  if (!existsSync2(progressPath)) {
+    const { writeFileSync } = await import("fs");
+    writeFileSync(progressPath, "# ArchonDev Progress Log\n\nThis file tracks learnings and decisions across sessions.\n");
+  }
+  appendFileSync(progressPath, `
+## ${today} - Quick Adapt (Defaults)
+
+### What was done
+- Used default governance rules
+- You can customize later by editing ARCHITECTURE.md
+`);
+  await showMainMenu();
+}
+async function handleContinueSession(cwd, state) {
+  console.log(chalk3.green("\u{1F44B}") + chalk3.bold(" Welcome back!\n"));
+  if (state.lastProgressEntry) {
+    console.log(chalk3.dim("Last activity:"));
+    console.log(chalk3.dim("  " + state.lastProgressEntry.split("\n")[0]));
     console.log();
   }
-  if (state.hasArchitecture) {
-    console.log(chalk4.green("\u2713") + " ARCHITECTURE.md found");
+  const handoff = checkForHandoff(cwd);
+  if (handoff) {
+    console.log(chalk3.yellow("\u{1F4CB} Found handoff from last session:\n"));
+    console.log(chalk3.dim(handoff.nextSteps));
+    console.log();
+    const continueHandoff = await promptYesNo("Continue from handoff?", true);
+    if (continueHandoff) {
+      console.log(chalk3.dim("\nPicking up where you left off...\n"));
+    }
   }
   if (state.hasReviewDb) {
     await showReviewProgress(cwd);
   }
-  const atomsDir = join3(cwd, ".archon", "atoms");
-  if (existsSync3(atomsDir)) {
-    console.log(chalk4.dim("  Checking for pending work..."));
+  await showMainMenu();
+}
+function checkForHandoff(cwd) {
+  try {
+    const progressPath = join2(cwd, "progress.txt");
+    if (!existsSync2(progressPath)) return null;
+    const content = readFileSync(progressPath, "utf-8");
+    const handoffMatch = content.match(/## Context Handoff[^\n]*\n([\s\S]*?)(?=\n## |\n*$)/);
+    if (handoffMatch && handoffMatch[1]) {
+      const handoffContent = handoffMatch[1];
+      const nextStepsMatch = handoffContent.match(/### Next Steps[^\n]*\n([\s\S]*?)(?=\n### |$)/);
+      if (nextStepsMatch && nextStepsMatch[1]) {
+        return { nextSteps: nextStepsMatch[1].trim() };
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+async function showMainMenu() {
+  const cwd = process.cwd();
+  const state = detectProjectState(cwd);
+  console.log(chalk3.bold("What would you like to do?\n"));
+  const choices = [
+    { key: "1", label: "Plan a new task", action: () => planTask() },
+    { key: "2", label: "List atoms", action: () => listAtoms() },
+    { key: "3", label: "Execute next atom", action: () => executeNext() },
+    { key: "4", label: "Report a bug", action: () => reportBug() },
+    { key: "5", label: "View status", action: () => viewStatus() },
+    { key: "6", label: "Code Review", action: () => reviewCode() },
+    { key: "7", label: "Settings & Preferences", action: () => settingsMenu() },
+    { key: "q", label: "Quit", action: async () => process.exit(0) }
+  ];
+  for (const choice2 of choices) {
+    console.log(`  ${chalk3.cyan(choice2.key)}) ${choice2.label}`);
   }
   console.log();
+  const selected = await prompt("Enter choice");
+  const choice = choices.find((c) => c.key === selected.toLowerCase());
+  if (choice) {
+    await choice.action();
+  } else {
+    console.log(chalk3.yellow("Invalid choice. Please try again."));
+    await showMainMenu();
+  }
 }
 async function showReviewProgress(cwd) {
   try {
@@ -706,29 +682,30 @@ async function showReviewProgress(cwd) {
     const pending = stats.pending + stats.inReview;
     const needsFix = stats.needsFix;
     console.log(
-      chalk4.blue("\u{1F4CA} Review Progress:") + chalk4.dim(` ${completed}/${total} completed`) + (needsFix > 0 ? chalk4.red(` (${needsFix} need fixes)`) : "") + (pending > 0 ? chalk4.yellow(` (${pending} pending)`) : "")
+      chalk3.blue("\u{1F4CA} Review Progress:") + chalk3.dim(` ${completed}/${total} completed`) + (needsFix > 0 ? chalk3.red(` (${needsFix} need fixes)`) : "") + (pending > 0 ? chalk3.yellow(` (${pending} pending)`) : "")
     );
+    console.log();
   } catch {
   }
 }
 async function planTask() {
-  const { plan: plan2 } = await import("./plan-7VSFESVD.js");
+  const { plan: plan2 } = await import("./plan-WQUFH2WB.js");
   const description = await prompt("Describe what you want to build");
   if (description.trim()) {
     await plan2(description, {});
   }
 }
 async function listAtoms() {
-  const { list: list2 } = await import("./list-VXMVEIL5.js");
+  const { list: list2 } = await import("./list-UB4MOGRH.js");
   await list2({});
 }
 async function executeNext() {
   const atomId = await prompt("Enter atom ID to execute (or press Enter for next planned)");
   if (atomId.trim()) {
-    const { execute: execute2 } = await import("./execute-LYID2ODD.js");
+    const { execute: execute2 } = await import("./execute-6ZGARWT2.js");
     await execute2(atomId.trim(), {});
   } else {
-    console.log(chalk4.yellow('No atom ID provided. Use "archon list" to see available atoms.'));
+    console.log(chalk3.yellow('No atom ID provided. Use "archon list" to see available atoms.'));
   }
 }
 async function reportBug() {
@@ -743,25 +720,26 @@ async function viewStatus() {
   await status2();
 }
 async function settingsMenu() {
-  const { interactiveSettings } = await import("./preferences-PL2ON5VY.js");
+  const { interactiveSettings } = await import("./preferences-QEFXVCZN.js");
   await interactiveSettings();
-  await start();
+  await showMainMenu();
 }
 async function reviewCode() {
   const cwd = process.cwd();
-  const reviewDbPath = join3(cwd, "docs", "code-review", "review-tasks.db");
-  if (!existsSync3(reviewDbPath)) {
-    console.log(chalk4.dim("Code review not initialized. Starting setup...\n"));
+  const reviewDbPath = join2(cwd, "docs", "code-review", "review-tasks.db");
+  if (!existsSync2(reviewDbPath)) {
+    console.log(chalk3.dim("Code review not initialized. Starting setup...\n"));
     const { reviewInit: reviewInit2 } = await import("./review-3R6QXAXQ.js");
     await reviewInit2();
     console.log();
   }
-  console.log(chalk4.bold("\nCode Review Options:\n"));
-  console.log(`  ${chalk4.cyan("1")}) Analyze project`);
-  console.log(`  ${chalk4.cyan("2")}) Show review status`);
-  console.log(`  ${chalk4.cyan("3")}) Review next file`);
-  console.log(`  ${chalk4.cyan("4")}) List all tasks`);
-  console.log(`  ${chalk4.cyan("b")}) Back to main menu`);
+  console.log(chalk3.bold("\nCode Review Options:\n"));
+  console.log(`  ${chalk3.cyan("1")}) Analyze project`);
+  console.log(`  ${chalk3.cyan("2")}) Show review status`);
+  console.log(`  ${chalk3.cyan("3")}) Review next file`);
+  console.log(`  ${chalk3.cyan("4")}) List all tasks`);
+  console.log(`  ${chalk3.cyan("5")}) Run AI review on all pending`);
+  console.log(`  ${chalk3.cyan("b")}) Back to main menu`);
   console.log();
   const choice = await prompt("Enter choice");
   switch (choice.toLowerCase()) {
@@ -785,30 +763,68 @@ async function reviewCode() {
       await reviewList2({});
       break;
     }
+    case "5": {
+      const { reviewRun: reviewRun2 } = await import("./review-3R6QXAXQ.js");
+      await reviewRun2({ all: true });
+      break;
+    }
     case "b":
-      await start();
+      await showMainMenu();
       return;
     default:
-      console.log(chalk4.yellow("Invalid choice."));
+      console.log(chalk3.yellow("Invalid choice."));
   }
   await reviewCode();
 }
 function prompt(question) {
   return new Promise((resolve) => {
-    const rl = readline2.createInterface({
+    const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
-    rl.question(`${chalk4.cyan("?")} ${question}: `, (answer) => {
+    rl.question(`${chalk3.cyan("?")} ${question}: `, (answer) => {
       rl.close();
       resolve(answer);
     });
   });
 }
+function promptYesNo(question, defaultValue) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const hint = defaultValue ? "(Y/n)" : "(y/N)";
+    rl.question(`${chalk3.cyan("?")} ${question} ${hint}: `, (answer) => {
+      rl.close();
+      if (answer.trim() === "") {
+        resolve(defaultValue);
+      } else {
+        resolve(answer.toLowerCase().startsWith("y"));
+      }
+    });
+  });
+}
+function promptChoice(question, options) {
+  return new Promise((resolve) => {
+    console.log(`${chalk3.cyan("?")} ${question}`);
+    for (const opt of options) {
+      console.log(`    ${chalk3.dim(opt.key)}) ${opt.label}`);
+    }
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(`  ${chalk3.dim("Enter choice")}: `, (answer) => {
+      rl.close();
+      resolve(answer.trim() || "1");
+    });
+  });
+}
 
 // src/cli/credits.ts
-import chalk5 from "chalk";
-import ora2 from "ora";
+import chalk4 from "chalk";
+import ora from "ora";
 import open from "open";
 import { createClient } from "@supabase/supabase-js";
 function getSupabaseClient(accessToken) {
@@ -817,7 +833,7 @@ function getSupabaseClient(accessToken) {
   });
 }
 async function showCredits() {
-  const spinner = ora2("Fetching credit balance...").start();
+  const spinner = ora("Fetching credit balance...").start();
   try {
     const config = await loadConfig();
     if (!config.accessToken || !config.userId) {
@@ -833,21 +849,21 @@ async function showCredits() {
     const profile = data;
     spinner.stop();
     console.log();
-    console.log(chalk5.bold("\u{1F4B0} Credit Balance"));
+    console.log(chalk4.bold("\u{1F4B0} Credit Balance"));
     console.log();
     const balance = (profile.credit_balance_cents || 0) / 100;
     console.log(`  Tier:    ${formatTier(profile.tier)}`);
-    console.log(`  Balance: ${chalk5.green(`$${balance.toFixed(2)}`)}`);
+    console.log(`  Balance: ${chalk4.green(`$${balance.toFixed(2)}`)}`);
     if (profile.tier === "FREE") {
       console.log(`  Atoms:   ${profile.atoms_used_this_month}/10,000 this month`);
       console.log();
-      console.log(chalk5.dim("  Upgrade to Credits tier: archon credits add"));
+      console.log(chalk4.dim("  Upgrade to Credits tier: archon credits add"));
     } else if (profile.tier === "CREDITS") {
       console.log();
-      console.log(chalk5.dim("  Add more credits: archon credits add"));
+      console.log(chalk4.dim("  Add more credits: archon credits add"));
     } else if (profile.tier === "BYOK") {
       console.log();
-      console.log(chalk5.dim("  Using your own API keys - no credit charges"));
+      console.log(chalk4.dim("  Using your own API keys - no credit charges"));
     }
     console.log();
   } catch (err) {
@@ -856,7 +872,7 @@ async function showCredits() {
   }
 }
 async function addCredits(options = {}) {
-  const spinner = ora2("Preparing checkout...").start();
+  const spinner = ora("Preparing checkout...").start();
   try {
     const config = await loadConfig();
     if (!config.accessToken || !config.userId) {
@@ -893,18 +909,18 @@ async function addCredits(options = {}) {
     }
     spinner.succeed("Checkout ready");
     console.log();
-    console.log(chalk5.bold("\u{1F6D2} Add Credits"));
+    console.log(chalk4.bold("\u{1F6D2} Add Credits"));
     console.log();
-    console.log(`  Amount: ${chalk5.green(`$${amountDollars.toFixed(2)}`)}`);
+    console.log(`  Amount: ${chalk4.green(`$${amountDollars.toFixed(2)}`)}`);
     console.log();
     console.log("  Opening checkout in browser...");
     console.log();
-    console.log(chalk5.dim(`  Or visit: ${checkoutUrl}`));
+    console.log(chalk4.dim(`  Or visit: ${checkoutUrl}`));
     console.log();
     try {
       await open(checkoutUrl);
     } catch {
-      console.log(chalk5.yellow("  Could not open browser. Please visit the URL above."));
+      console.log(chalk4.yellow("  Could not open browser. Please visit the URL above."));
     }
   } catch (err) {
     spinner.fail("Error preparing checkout");
@@ -912,7 +928,7 @@ async function addCredits(options = {}) {
   }
 }
 async function showHistory(options = {}) {
-  const spinner = ora2("Fetching usage history...").start();
+  const spinner = ora("Fetching usage history...").start();
   try {
     const config = await loadConfig();
     if (!config.accessToken || !config.userId) {
@@ -929,15 +945,15 @@ async function showHistory(options = {}) {
     const usage = data;
     spinner.stop();
     console.log();
-    console.log(chalk5.bold("\u{1F4CA} Usage History"));
+    console.log(chalk4.bold("\u{1F4CA} Usage History"));
     console.log();
     if (!usage || usage.length === 0) {
-      console.log(chalk5.dim("  No usage recorded yet."));
+      console.log(chalk4.dim("  No usage recorded yet."));
       console.log();
       return;
     }
-    console.log(chalk5.dim("  Model                          Tokens       Cost       Date"));
-    console.log(chalk5.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk4.dim("  Model                          Tokens       Cost       Date"));
+    console.log(chalk4.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     for (const row of usage) {
       const model = row.model.padEnd(30).slice(0, 30);
       const tokens = (row.input_tokens + row.output_tokens).toString().padStart(8);
@@ -947,9 +963,9 @@ async function showHistory(options = {}) {
     }
     const totalCost = usage.reduce((sum, r) => sum + r.base_cost, 0);
     const totalTokens = usage.reduce((sum, r) => sum + r.input_tokens + r.output_tokens, 0);
-    console.log(chalk5.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk4.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     console.log(
-      `  ${"Total".padEnd(30)} ${totalTokens.toString().padStart(8)} ${chalk5.green(`$${totalCost.toFixed(4)}`.padStart(10))}`
+      `  ${"Total".padEnd(30)} ${totalTokens.toString().padStart(8)} ${chalk4.green(`$${totalCost.toFixed(4)}`.padStart(10))}`
     );
     console.log();
   } catch (err) {
@@ -958,7 +974,7 @@ async function showHistory(options = {}) {
   }
 }
 async function manageBudget(options = {}) {
-  const spinner = ora2("Fetching budget settings...").start();
+  const spinner = ora("Fetching budget settings...").start();
   try {
     const config = await loadConfig();
     if (!config.accessToken || !config.userId) {
@@ -1015,24 +1031,24 @@ async function manageBudget(options = {}) {
     }
     spinner.stop();
     console.log();
-    console.log(chalk5.bold("\u{1F4CA} Monthly Budget"));
+    console.log(chalk4.bold("\u{1F4CA} Monthly Budget"));
     console.log();
     if (profile.monthly_budget_cents === null) {
-      console.log(`  Budget:    ${chalk5.dim("No limit set")}`);
+      console.log(`  Budget:    ${chalk4.dim("No limit set")}`);
     } else {
       const budget = profile.monthly_budget_cents / 100;
       const spend = (profile.monthly_spend_cents || 0) / 100;
       const remaining = budget - spend;
       const percent = budget > 0 ? Math.round(spend / budget * 100) : 0;
-      console.log(`  Budget:    ${chalk5.green(`$${budget.toFixed(2)}`)} / month`);
+      console.log(`  Budget:    ${chalk4.green(`$${budget.toFixed(2)}`)} / month`);
       console.log(`  Spent:     $${spend.toFixed(2)} (${percent}%)`);
-      console.log(`  Remaining: ${remaining >= 0 ? chalk5.green(`$${remaining.toFixed(2)}`) : chalk5.red(`-$${Math.abs(remaining).toFixed(2)}`)}`);
+      console.log(`  Remaining: ${remaining >= 0 ? chalk4.green(`$${remaining.toFixed(2)}`) : chalk4.red(`-$${Math.abs(remaining).toFixed(2)}`)}`);
     }
     console.log(`  Alert at:  ${profile.budget_alert_threshold_percent}% of budget`);
     console.log();
-    console.log(chalk5.dim("  Set budget:     archon credits budget --set 50"));
-    console.log(chalk5.dim("  Clear budget:   archon credits budget --clear"));
-    console.log(chalk5.dim("  Set alert:      archon credits budget --alert 80"));
+    console.log(chalk4.dim("  Set budget:     archon credits budget --set 50"));
+    console.log(chalk4.dim("  Clear budget:   archon credits budget --clear"));
+    console.log(chalk4.dim("  Set alert:      archon credits budget --alert 80"));
     console.log();
   } catch (err) {
     spinner.fail("Error managing budget");
@@ -1040,7 +1056,7 @@ async function manageBudget(options = {}) {
   }
 }
 async function manageAutoRecharge(options = {}) {
-  const spinner = ora2("Fetching auto-recharge settings...").start();
+  const spinner = ora("Fetching auto-recharge settings...").start();
   try {
     const config = await loadConfig();
     if (!config.accessToken || !config.userId) {
@@ -1094,12 +1110,12 @@ async function manageAutoRecharge(options = {}) {
     }
     spinner.stop();
     console.log();
-    console.log(chalk5.bold("\u{1F504} Auto-Recharge"));
+    console.log(chalk4.bold("\u{1F504} Auto-Recharge"));
     console.log();
     if (!profile.auto_recharge_enabled) {
-      console.log(`  Status:    ${chalk5.dim("Disabled")}`);
+      console.log(`  Status:    ${chalk4.dim("Disabled")}`);
     } else {
-      console.log(`  Status:    ${chalk5.green("Enabled")}`);
+      console.log(`  Status:    ${chalk4.green("Enabled")}`);
       if (profile.auto_recharge_threshold_cents !== null) {
         console.log(`  When:      Balance drops below $${(profile.auto_recharge_threshold_cents / 100).toFixed(2)}`);
       }
@@ -1107,10 +1123,10 @@ async function manageAutoRecharge(options = {}) {
         console.log(`  Amount:    $${(profile.auto_recharge_amount_cents / 100).toFixed(2)}`);
       }
     }
-    console.log(`  Payment:   ${profile.stripe_payment_method_id ? chalk5.green("Card saved") : chalk5.dim("No card saved")}`);
+    console.log(`  Payment:   ${profile.stripe_payment_method_id ? chalk4.green("Card saved") : chalk4.dim("No card saved")}`);
     console.log();
-    console.log(chalk5.dim("  Enable:    archon credits auto-recharge --enable --threshold 5 --amount 20"));
-    console.log(chalk5.dim("  Disable:   archon credits auto-recharge --disable"));
+    console.log(chalk4.dim("  Enable:    archon credits auto-recharge --enable --threshold 5 --amount 20"));
+    console.log(chalk4.dim("  Disable:   archon credits auto-recharge --disable"));
     console.log();
   } catch (err) {
     spinner.fail("Error managing auto-recharge");
@@ -1120,11 +1136,11 @@ async function manageAutoRecharge(options = {}) {
 function formatTier(tier) {
   switch (tier) {
     case "FREE":
-      return chalk5.blue("Free (10k atoms/month)");
+      return chalk4.blue("Free (10k atoms/month)");
     case "CREDITS":
-      return chalk5.green("Credits (Pay-as-you-go)");
+      return chalk4.green("Credits (Pay-as-you-go)");
     case "BYOK":
-      return chalk5.magenta("BYOK (Bring Your Own Key)");
+      return chalk4.magenta("BYOK (Bring Your Own Key)");
     default:
       return tier;
   }
@@ -1399,8 +1415,247 @@ async function watch() {
   await waitUntilExit();
 }
 
+// src/cli/deps.ts
+import { Command } from "commander";
+import chalk5 from "chalk";
+import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
+var DEPENDENCIES_FILENAME = "DEPENDENCIES.md";
+function createDepsCommand() {
+  const deps = new Command("deps").description("Manage file-level dependencies (DEPENDENCIES.md)").addHelpText(
+    "after",
+    `
+Examples:
+  archon deps list                     List all dependency rules
+  archon deps check --files a.ts,b.ts  Check if files have downstream impacts
+  archon deps add --source src/api.ts --dependent src/cli/**
+  archon deps graph                    Generate Mermaid dependency diagram
+`
+  );
+  deps.command("list").description("List all dependency rules").option("-v, --verbose", "Show detailed information").action(async (options) => {
+    const parser = new DependencyParser();
+    if (!parser.exists()) {
+      console.log(chalk5.yellow("No DEPENDENCIES.md found."));
+      console.log(chalk5.dim("Create one with: archon deps add --source <path> --dependent <path>"));
+      return;
+    }
+    const result = await parser.parse();
+    if (!result.success) {
+      console.log(chalk5.red(`Parse error: ${result.error}`));
+      return;
+    }
+    const rules = result.document?.rules ?? [];
+    if (rules.length === 0) {
+      console.log(chalk5.dim("No dependency rules defined."));
+      return;
+    }
+    console.log(chalk5.bold(`
+\u{1F4E6} Dependency Rules (${rules.length})
+`));
+    for (const rule of rules) {
+      const severityColor = rule.severity === "BLOCKER" ? chalk5.red : rule.severity === "WARNING" ? chalk5.yellow : chalk5.blue;
+      console.log(`${severityColor(`[${rule.severity}]`)} ${chalk5.bold(rule.id)}`);
+      console.log(`  Source: ${chalk5.cyan(rule.source)}`);
+      console.log(`  Dependents: ${rule.dependents.map((d) => chalk5.dim(d)).join(", ")}`);
+      if (rule.reason && options.verbose) {
+        console.log(`  Reason: ${chalk5.dim(rule.reason)}`);
+      }
+      if (rule.mustTest && options.verbose) {
+        console.log(`  Must test: ${rule.mustTest.join(", ")}`);
+      }
+      console.log("");
+    }
+  });
+  deps.command("check").description("Check if files have downstream dependency impacts").requiredOption("-f, --files <files>", "Comma-separated list of files to check").action(async (options) => {
+    const files = options.files.split(",").map((f) => f.trim());
+    const parser = new DependencyParser();
+    if (!parser.exists()) {
+      console.log(chalk5.dim("No DEPENDENCIES.md found. No dependency checks performed."));
+      process.exit(0);
+    }
+    const result = await parser.checkFiles(files);
+    if (result.impacts.length === 0) {
+      console.log(chalk5.green("\u2705 No downstream dependency impacts found."));
+      process.exit(0);
+    }
+    console.log(chalk5.yellow(`
+\u26A0\uFE0F  Found ${result.impacts.length} dependency impact(s):
+`));
+    for (const impact of result.impacts) {
+      const severityColor = impact.rule.severity === "BLOCKER" ? chalk5.red : impact.rule.severity === "WARNING" ? chalk5.yellow : chalk5.blue;
+      console.log(severityColor(`[${impact.rule.severity}] ${impact.rule.id}`));
+      console.log(`  Changing: ${chalk5.cyan(impact.matchedSource)}`);
+      console.log(`  May impact: ${impact.affectedDependents.join(", ")}`);
+      if (impact.rule.reason) {
+        console.log(`  Reason: ${chalk5.dim(impact.rule.reason)}`);
+      }
+      console.log("");
+    }
+    if (result.hasBlockers) {
+      console.log(chalk5.red("\u274C BLOCKER-level impacts found. Review before proceeding."));
+      process.exit(1);
+    }
+    process.exit(0);
+  });
+  deps.command("add").description("Add a new dependency rule").requiredOption("-s, --source <path>", "Source file or glob pattern").requiredOption("-d, --dependent <path>", "Dependent file or glob pattern").option("--severity <level>", "Severity: INFO, WARNING, BLOCKER", "WARNING").option("--reason <text>", "Reason for this dependency").option("--id <id>", "Custom rule ID (e.g., DEP-001)").action(async (options) => {
+    const source = options.source;
+    const dependent = options.dependent;
+    const severity = options.severity.toUpperCase();
+    const reason = options.reason || "";
+    const parser = new DependencyParser();
+    let existingRules = [];
+    let markdownBody = "";
+    if (parser.exists()) {
+      const content = await readFile2(DEPENDENCIES_FILENAME, "utf-8");
+      const result = await parser.parse();
+      if (result.success && result.document) {
+        existingRules = result.document.rules;
+      }
+      const parts = content.split("---");
+      if (parts.length >= 3) {
+        markdownBody = parts.slice(2).join("---");
+      }
+    } else {
+      markdownBody = `
+
+# Dependencies (File & Symbol Impact Map)
+
+## How to use
+- When you change a \`source\`, you must review each \`dependent\`.
+- Keep rules coarse and high-signal. Prefer fewer, accurate rules over exhaustive lists.
+
+## Conventions
+- \`source\` and \`dependents\` accept glob patterns.
+- Use \`symbols\` to document function/class coupling when helpful.
+`;
+    }
+    const nextId = options.id || `DEP-${String(existingRules.length + 1).padStart(3, "0")}`;
+    const existingRule = existingRules.find(
+      (r) => r.source === source && r.dependents.includes(dependent)
+    );
+    if (existingRule) {
+      console.log(chalk5.yellow(`Rule already exists: ${existingRule.id}`));
+      return;
+    }
+    const newRule = {
+      id: nextId,
+      source,
+      dependents: [dependent],
+      severity,
+      reason
+    };
+    existingRules.push(newRule);
+    const yaml = generateYamlFrontmatter(existingRules);
+    await writeFile2(DEPENDENCIES_FILENAME, `---
+${yaml}---${markdownBody}`, "utf-8");
+    console.log(chalk5.green(`\u2705 Added dependency rule: ${nextId}`));
+    console.log(`  Source: ${chalk5.cyan(source)}`);
+    console.log(`  Dependent: ${chalk5.dim(dependent)}`);
+  });
+  deps.command("graph").description("Generate Mermaid diagram of dependencies").option("--output <file>", "Write to file instead of stdout").action(async (options) => {
+    const parser = new DependencyParser();
+    if (!parser.exists()) {
+      console.log(chalk5.yellow("No DEPENDENCIES.md found."));
+      return;
+    }
+    const mermaid = await parser.generateGraph();
+    if (options.output) {
+      await writeFile2(options.output, mermaid, "utf-8");
+      console.log(chalk5.green(`\u2705 Graph written to ${options.output}`));
+    } else {
+      console.log("\n```mermaid");
+      console.log(mermaid);
+      console.log("```\n");
+    }
+  });
+  deps.command("init").description("Create a starter DEPENDENCIES.md file").action(async () => {
+    if (existsSync4(DEPENDENCIES_FILENAME)) {
+      console.log(chalk5.yellow("DEPENDENCIES.md already exists."));
+      return;
+    }
+    const template = `---
+version: "1.0"
+updatedAt: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
+rules: []
+---
+
+# Dependencies (File & Symbol Impact Map)
+
+## How to use
+
+This file tracks file-level dependencies to prevent regressions. When you change a \`source\` file, you must review and potentially update each \`dependent\`.
+
+**Example rule:**
+\`\`\`yaml
+rules:
+  - id: "DEP-001"
+    source: "src/api/auth.ts"
+    dependents:
+      - "src/cli/**"
+      - "src/server/routes.ts"
+    severity: "WARNING"
+    reason: "CLI and server depend on auth types; changes may require updates"
+    mustTest:
+      - "pnpm test auth"
+\`\`\`
+
+## Severity Levels
+
+- **INFO** \u2014 FYI, might want to review
+- **WARNING** \u2014 Should review dependents before merging
+- **BLOCKER** \u2014 Must update dependents before this change can proceed
+
+## Conventions
+
+- Use glob patterns for broad dependencies (\`src/core/**\`)
+- Keep rules high-signal; don't track every import
+- Add \`mustTest\` for critical paths
+- Update \`updatedAt\` when modifying rules
+
+---
+
+*Powered by [ArchonDev](https://archondev.io)*
+`;
+    await writeFile2(DEPENDENCIES_FILENAME, template, "utf-8");
+    console.log(chalk5.green("\u2705 Created DEPENDENCIES.md"));
+    console.log(chalk5.dim("Add your first rule with: archon deps add --source <path> --dependent <path>"));
+  });
+  return deps;
+}
+function generateYamlFrontmatter(rules) {
+  const lines = [];
+  lines.push(`version: "1.0"`);
+  lines.push(`updatedAt: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"`);
+  lines.push(`rules:`);
+  for (const rule of rules) {
+    lines.push(`  - id: "${rule.id}"`);
+    lines.push(`    source: "${rule.source}"`);
+    lines.push(`    dependents:`);
+    for (const dep of rule.dependents) {
+      lines.push(`      - "${dep}"`);
+    }
+    lines.push(`    severity: "${rule.severity}"`);
+    if (rule.reason) {
+      lines.push(`    reason: "${rule.reason.replace(/"/g, '\\"')}"`);
+    }
+    if (rule.symbols && rule.symbols.length > 0) {
+      lines.push(`    symbols:`);
+      for (const sym of rule.symbols) {
+        lines.push(`      - "${sym}"`);
+      }
+    }
+    if (rule.mustTest && rule.mustTest.length > 0) {
+      lines.push(`    mustTest:`);
+      for (const test of rule.mustTest) {
+        lines.push(`      - "${test}"`);
+      }
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+
 // src/cli/index.ts
-var program = new Command();
+var program = new Command2();
 program.name("archon").description("Local-first AI-powered development governance").version("1.1.0").action(async () => {
   const cwd = process.cwd();
   if (!isInitialized(cwd)) {
@@ -1531,4 +1786,5 @@ reviewCommand.command("run").description("Run AI-powered review on pending tasks
 reviewCommand.action(async () => {
   await reviewStatus();
 });
+program.addCommand(createDepsCommand());
 program.parse();