archondev 1.2.0 → 1.5.0

package/README.md

@@ -9,10 +9,10 @@ The complete AI development system. It manages your entire development process s
 
 ```bash
 # macOS/Linux:
-npm install -g archondev && archon
+npm install -g archon && archon
 
 # Windows PowerShell:
-npm install -g archondev; archon
+npm install -g archon; archon
 ```
 
 **What you get:**
@@ -20,6 +20,7 @@ npm install -g archondev; archon
 - Adversarial planning (Architect proposes, Sentinel critiques)
 - Automatic quality gates before changes are applied
 - Learning persistence — mistakes are remembered and avoided
+- **Dependency tracking** — prevent regressions with "what-breaks-what" map
 - Bug reporting with root cause analysis
 - AI-powered code review for any codebase
 - Multi-provider key support with adversarial features
@@ -33,6 +34,11 @@ Copy governance files into any project. Works with your existing AI tools (Curso
 - ARCHITECTURE.md template with best practices
 - IDE-specific rule files (.cursorrules, CLAUDE.md, etc.)
 - Progress tracking templates
+- **DEPENDENCIES.md** — Track file-level dependencies to prevent regressions
+- **First-Run Walkthrough** — Guided onboarding when AI detects your governance files
+- **Code Review Mode** — Structured code review without changing your code
+- **Local Database** — Track atoms and learnings in SQLite (no CLI required)
+- **Memory Management** — Context handoff protocol for long sessions
 - Works with any AI coding assistant
 
 ---
@@ -57,19 +63,34 @@ Copy governance files into any project. Works with your existing AI tools (Curso
 | `archon credits budget` | Set monthly budget and alerts |
 | `archon keys add <provider>` | Add your own API key — BYOK (Bring Your Own Key) |
 | `archon keys list` | Show configured API keys by provider |
-| `archon preferences` | View/set model preferences |
+| `archon preferences` | Interactive settings menu (billing, models, keys, usage) |
 | `archon models` | List available AI models |
+| `archon deps list` | View file dependency rules |
+| `archon deps add` | Add a new dependency rule |
+| `archon deps check --files <list>` | Check for downstream impacts |
+| `archon deps graph` | Generate Mermaid dependency diagram |
 
 ## Pricing
 
 | Tier | Cost | What You Get |
 |------|------|--------------|
-| **Free** | $0 | 10,000 atoms/month, fast models (Haiku, Flash, GPT-4 Mini) |
+| **Free** | $0 | Ultra-cheap models (GPT-5-nano, GPT-4.1-nano, Gemini 2.5 Flash-Lite) — $0 cost to us |
 | **Credits** | Pay as you go | All models, 10% service fee, deposit any amount |
 | **BYOK** (Bring Your Own Key) | $0 | Use your own API keys, unlimited usage |
+| **Claude Subscription** *(coming soon)* | Your existing sub | Use Claude Pro/Max subscription instead of API keys |
 
 No subscriptions. No commitments. Start free.
 
+### Claude Pro/Max Subscription Support (Coming Soon)
+
+If you have an existing Claude subscription, you'll soon be able to use it with ArchonDev instead of API keys:
+
+- **Claude Pro** ($20/mo) — Use your Pro subscription
+- **Claude Max 5x** ($100/mo) — Higher limits for power users  
+- **Claude Max 20x** ($200/mo) — Maximum throughput
+
+This works similarly to how Claude Code allows subscription-based access. We're currently waiting on Anthropic to provide a public OAuth API for third-party applications. **For now, use BYOK (bring your own API key)** — we'll notify you when subscription support is available.
+
 ## How It Works
 
 1. **Define Your Rules** — Create ARCHITECTURE.md with boundaries and invariants
@@ -101,7 +122,8 @@ The CLI detects existing projects and suggests this workflow automatically.
 
 ## Documentation
 
-[archondev.io](https://archondev.io)
+- [archondev.io](https://archondev.io) — Main website with animated AI problems story
+- [AI Coding Problems Research](docs/ai-coding-problems-research.md) — Market research on AI coding assistant issues
 
 ---
 

package/dist/{chunk-I4ZVNLNO.js → chunk-74EEFKVP.js}

@@ -2842,7 +2842,7 @@ var require_js_yaml2 = __commonJS({
 
 // src/cli/execute.ts
 import chalk2 from "chalk";
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { readFile as readFile7, writeFile as writeFile4 } from "fs/promises";
 import { join as join3 } from "path";
 import { execSync as execSync3 } from "child_process";
@@ -2850,7 +2850,157 @@ import { createInterface } from "readline";
 
 // src/core/conflicts/checker.ts
 import { stat } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+
+// src/core/dependencies/parser.ts
+import { readFile } from "fs/promises";
 import { existsSync } from "fs";
+import matter from "gray-matter";
+var DEFAULT_DEPENDENCIES_FILENAME = "DEPENDENCIES.md";
+var DependencyParser = class {
+  cwd;
+  filePath;
+  constructor(cwd = process.cwd(), filename = DEFAULT_DEPENDENCIES_FILENAME) {
+    this.cwd = cwd;
+    this.filePath = `${cwd}/${filename}`;
+  }
+  /**
+   * Check if DEPENDENCIES.md exists
+   */
+  exists() {
+    return existsSync(this.filePath);
+  }
+  /**
+   * Parse DEPENDENCIES.md and return the document
+   */
+  async parse() {
+    if (!this.exists()) {
+      return {
+        success: true,
+        document: {
+          version: "1.0",
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0] ?? "",
+          rules: []
+        }
+      };
+    }
+    try {
+      const content = await readFile(this.filePath, "utf-8");
+      const { data } = matter(content);
+      const document = this.validateAndNormalize(data);
+      return { success: true, document };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown parse error"
+      };
+    }
+  }
+  /**
+   * Validate and normalize parsed YAML data
+   */
+  validateAndNormalize(data) {
+    const raw = data;
+    const version = typeof raw["version"] === "string" ? raw["version"] : "1.0";
+    const updatedAt = typeof raw["updatedAt"] === "string" ? raw["updatedAt"] : (/* @__PURE__ */ new Date()).toISOString().split("T")[0] ?? "";
+    const rawRules = Array.isArray(raw["rules"]) ? raw["rules"] : [];
+    const rules = [];
+    for (const rawRule of rawRules) {
+      if (typeof rawRule !== "object" || rawRule === null) continue;
+      const r = rawRule;
+      const id = typeof r["id"] === "string" ? r["id"] : `DEP-${rules.length + 1}`;
+      const source = typeof r["source"] === "string" ? r["source"] : "";
+      const dependents = Array.isArray(r["dependents"]) ? r["dependents"].filter((d) => typeof d === "string") : [];
+      const severity = this.parseSeverity(r["severity"]);
+      const reason = typeof r["reason"] === "string" ? r["reason"] : "";
+      const symbols = Array.isArray(r["symbols"]) ? r["symbols"].filter((s) => typeof s === "string") : void 0;
+      const mustTest = Array.isArray(r["mustTest"]) ? r["mustTest"].filter((t) => typeof t === "string") : void 0;
+      if (source && dependents.length > 0) {
+        rules.push({ id, source, dependents, severity, reason, symbols, mustTest });
+      }
+    }
+    return { version, updatedAt, rules };
+  }
+  parseSeverity(value) {
+    if (typeof value === "string") {
+      const upper = value.toUpperCase();
+      if (upper === "BLOCKER" || upper === "WARNING" || upper === "INFO") {
+        return upper;
+      }
+    }
+    return "WARNING";
+  }
+  /**
+   * Check which dependency rules are triggered by a set of files
+   */
+  async checkFiles(files) {
+    const parseResult = await this.parse();
+    if (!parseResult.success || !parseResult.document) {
+      return {
+        filesChecked: files,
+        impacts: [],
+        totalImpacts: 0,
+        hasBlockers: false
+      };
+    }
+    const impacts = [];
+    for (const file of files) {
+      for (const rule of parseResult.document.rules) {
+        if (this.matchesPattern(file, rule.source)) {
+          impacts.push({
+            rule,
+            matchedSource: file,
+            affectedDependents: rule.dependents
+          });
+        }
+      }
+    }
+    return {
+      filesChecked: files,
+      impacts,
+      totalImpacts: impacts.reduce((sum, i) => sum + i.affectedDependents.length, 0),
+      hasBlockers: impacts.some((i) => i.rule.severity === "BLOCKER")
+    };
+  }
+  /**
+   * Match a file path against a glob pattern
+   * Reuses the same logic as ConflictChecker for consistency
+   */
+  matchesPattern(path, pattern) {
+    const regexPattern = pattern.replace(/\*\*/g, "<<<GLOBSTAR>>>").replace(/\*/g, "[^/]*").replace(/<<<GLOBSTAR>>>/g, ".*").replace(/\//g, "\\/");
+    return new RegExp(`^${regexPattern}$`).test(path);
+  }
+  /**
+   * Generate Mermaid diagram of dependencies
+   */
+  async generateGraph() {
+    const parseResult = await this.parse();
+    if (!parseResult.success || !parseResult.document || parseResult.document.rules.length === 0) {
+      return 'graph LR\n  empty["No dependencies defined"]';
+    }
+    const lines = ["graph LR"];
+    const nodeIds = /* @__PURE__ */ new Map();
+    let nodeCounter = 0;
+    const getNodeId = (path) => {
+      if (!nodeIds.has(path)) {
+        nodeIds.set(path, `n${nodeCounter++}`);
+      }
+      return nodeIds.get(path);
+    };
+    for (const rule of parseResult.document.rules) {
+      const sourceId = getNodeId(rule.source);
+      const sourceLabel = rule.source.replace(/"/g, "'");
+      for (const dependent of rule.dependents) {
+        const depId = getNodeId(dependent);
+        const depLabel = dependent.replace(/"/g, "'");
+        lines.push(`  ${sourceId}["${sourceLabel}"] --> ${depId}["${depLabel}"]`);
+      }
+    }
+    return lines.join("\n");
+  }
+};
+
+// src/core/conflicts/checker.ts
 var ConflictChecker = class {
   architecture;
   constructor(architecture) {
@@ -2877,6 +3027,10 @@ var ConflictChecker = class {
     }
     const semanticConflicts = this.checkSemanticConflicts(plan);
     conflicts.push(...semanticConflicts);
+    if (options.checkFileDependencies !== false) {
+      const fileDepsConflicts = await this.checkFileLevelDependencies(plan.files_to_modify, cwd);
+      conflicts.push(...fileDepsConflicts);
+    }
     if (conflicts.some((c) => c.type === "FILE_MODIFIED")) {
       recommendations.push("Review modified files and re-plan if necessary");
     }
@@ -2902,7 +3056,7 @@ var ConflictChecker = class {
     const conflicts = [];
     for (const filePath of files) {
       const fullPath = `${cwd}/${filePath}`;
-      if (!existsSync(fullPath)) {
+      if (!existsSync2(fullPath)) {
         continue;
       }
       try {
@@ -3035,12 +3189,42 @@ var ConflictChecker = class {
     if (!scope || scope === "*") return true;
     return this.matchesPattern(path, scope) || path.startsWith(scope);
   }
+  /**
+   * Check file-level dependencies from DEPENDENCIES.md
+   */
+  async checkFileLevelDependencies(files, cwd) {
+    const conflicts = [];
+    try {
+      const parser = new DependencyParser(cwd);
+      if (!parser.exists()) {
+        return [];
+      }
+      const result = await parser.checkFiles(files);
+      for (const impact of result.impacts) {
+        const severity = impact.rule.severity === "BLOCKER" ? "BLOCKER" : impact.rule.severity === "WARNING" ? "WARNING" : "INFO";
+        conflicts.push({
+          type: "DEPENDENCY",
+          severity,
+          path: impact.matchedSource,
+          message: `Changing ${impact.matchedSource} may impact: ${impact.affectedDependents.join(", ")}`,
+          recommendation: impact.rule.reason || "Review dependent files before proceeding"
+        });
+      }
+    } catch {
+      conflicts.push({
+        type: "DEPENDENCY",
+        severity: "INFO",
+        message: "DEPENDENCIES.md could not be parsed; file-level dependency checks skipped"
+      });
+    }
+    return conflicts;
+  }
 };
 
 // src/core/gates/runner.ts
 import { execSync } from "child_process";
 import { readFile as readFile2 } from "fs/promises";
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync3 } from "fs";
 import chalk from "chalk";
 var QualityGateRunner = class {
   cwd;
@@ -3125,7 +3309,7 @@ var QualityGateRunner = class {
    */
   async runArchitectureGate() {
     const archPath = `${this.cwd}/ARCHITECTURE.md`;
-    if (!existsSync2(archPath)) {
+    if (!existsSync3(archPath)) {
       return "No ARCHITECTURE.md found - skipping";
     }
     return "Architecture constraints checked";
@@ -3135,13 +3319,13 @@ var QualityGateRunner = class {
    */
   async runSyntaxGate() {
     const pkgPath = `${this.cwd}/package.json`;
-    if (!existsSync2(pkgPath)) {
+    if (!existsSync3(pkgPath)) {
       return "No package.json found - skipping syntax check";
     }
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
     if (pkg.scripts?.["typecheck"]) {
       return this.runCommand("npm run typecheck");
-    } else if (existsSync2(`${this.cwd}/tsconfig.json`)) {
+    } else if (existsSync3(`${this.cwd}/tsconfig.json`)) {
       return this.runCommand("npx tsc --noEmit");
     }
     return "No TypeScript configuration found - skipping";
@@ -3151,7 +3335,7 @@ var QualityGateRunner = class {
    */
   async runLintGate() {
     const pkgPath = `${this.cwd}/package.json`;
-    if (!existsSync2(pkgPath)) {
+    if (!existsSync3(pkgPath)) {
       return "No package.json found - skipping lint";
     }
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
@@ -3165,7 +3349,7 @@ var QualityGateRunner = class {
    */
   async runUnitGate() {
     const pkgPath = `${this.cwd}/package.json`;
-    if (!existsSync2(pkgPath)) {
+    if (!existsSync3(pkgPath)) {
       return "No package.json found - skipping tests";
     }
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
@@ -3179,7 +3363,7 @@ var QualityGateRunner = class {
    */
   async runIntegrationGate() {
     const pkgPath = `${this.cwd}/package.json`;
-    if (!existsSync2(pkgPath)) {
+    if (!existsSync3(pkgPath)) {
       return "No package.json found - skipping integration tests";
     }
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
@@ -3193,7 +3377,7 @@ var QualityGateRunner = class {
    */
   async runE2EGate() {
     const pkgPath = `${this.cwd}/package.json`;
-    if (!existsSync2(pkgPath)) {
+    if (!existsSync3(pkgPath)) {
       return "No package.json found - skipping E2E tests";
     }
     const pkg = JSON.parse(await readFile2(pkgPath, "utf-8"));
@@ -3243,7 +3427,7 @@ var QualityGateRunner = class {
 
 // src/core/learning/capture.ts
 import { readFile as readFile3, writeFile, appendFile } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 var PROGRESS_HEADER = `# ArchonDev Progress Log
 
 Started: ${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}
@@ -3294,7 +3478,7 @@ var LearningCapture = class {
    * Ensure progress.txt exists with initial header
    */
   async ensureProgressFile() {
-    if (!existsSync3(this.progressPath)) {
+    if (!existsSync4(this.progressPath)) {
       await writeFile(this.progressPath, PROGRESS_HEADER);
     }
   }
@@ -3536,7 +3720,7 @@ var LearningCapture = class {
 
 // src/core/learning/agents-md.ts
 import { readFile as readFile4, writeFile as writeFile2, appendFile as appendFile2, mkdir } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { dirname, join } from "path";
 var AGENTS_MD_HEADER = `# AGENTS.md
 
@@ -3771,7 +3955,7 @@ var AgentsMdUpdater = class {
     const agentsMdPath = join(this.cwd, dir, "AGENTS.md");
     const parentAgentsMd = await this.findParentAgentsMd(dir);
     let learningsAdded = 0;
-    if (existsSync4(agentsMdPath)) {
+    if (existsSync5(agentsMdPath)) {
       learningsAdded = await this.appendToAgentsMd(agentsMdPath, knowledge);
       return { path: agentsMdPath, updated: true, created: false, learningsAdded };
     }
@@ -3794,7 +3978,7 @@ var AgentsMdUpdater = class {
     let currentDir = dirname(dir);
     while (currentDir && currentDir !== "." && currentDir !== "/") {
       const agentsMdPath = join(this.cwd, currentDir, "AGENTS.md");
-      if (existsSync4(agentsMdPath)) {
+      if (existsSync5(agentsMdPath)) {
         return agentsMdPath;
       }
       currentDir = dirname(currentDir);
@@ -3896,7 +4080,7 @@ var AgentsMdUpdater = class {
       parts.push("");
     }
     const dir = dirname(path);
-    if (!existsSync4(dir)) {
+    if (!existsSync5(dir)) {
       await mkdir(dir, { recursive: true });
     }
     await writeFile2(path, parts.join("\n"));
@@ -3905,7 +4089,7 @@ var AgentsMdUpdater = class {
 
 // src/agents/executor.ts
 import { readFile as readFile5, writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import { dirname as dirname2 } from "path";
 import { execSync as execSync2 } from "child_process";
 var SYSTEM_PROMPT = `You are the Executor, an expert software engineer responsible for implementing approved plans.
@@ -3972,7 +4156,7 @@ var ExecutorAgent = class {
     try {
       for (const diff of diffs) {
         const fullPath = `${cwd}/${diff.path}`;
-        if (existsSync5(fullPath)) {
+        if (existsSync6(fullPath)) {
           originalContents.set(diff.path, await readFile5(fullPath, "utf-8"));
         } else {
           originalContents.set(diff.path, null);
@@ -3984,7 +4168,7 @@ var ExecutorAgent = class {
           continue;
         }
         const dir = dirname2(fullPath);
-        if (!existsSync5(dir)) {
+        if (!existsSync6(dir)) {
           await mkdir2(dir, { recursive: true });
         }
         await writeFile3(fullPath, diff.newContent);
@@ -4042,7 +4226,7 @@ var ExecutorAgent = class {
     parts.push("# Current File Contents");
     for (const filePath of plan.files_to_modify) {
       const fullPath = `${cwd}/${filePath}`;
-      if (existsSync5(fullPath)) {
+      if (existsSync6(fullPath)) {
         try {
           const content = await readFile5(fullPath, "utf-8");
           parts.push(`
@@ -4167,7 +4351,7 @@ var ExecutorAgent = class {
   async runQualityChecks(cwd) {
     try {
       const pkgPath = `${cwd}/package.json`;
-      if (existsSync5(pkgPath)) {
+      if (existsSync6(pkgPath)) {
         const pkg = JSON.parse(await readFile5(pkgPath, "utf-8"));
         if (pkg.scripts?.["typecheck"]) {
           execSync2("npm run typecheck", { cwd, stdio: "pipe" });
@@ -4219,7 +4403,7 @@ var DEFAULT_ENVIRONMENTS = {
 
 // src/core/environments/config.ts
 var import_js_yaml = __toESM(require_js_yaml2(), 1);
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { readFile as readFile6 } from "fs/promises";
 import { join as join2 } from "path";
 var VALID_GATES = [
@@ -4239,11 +4423,11 @@ var EnvironmentConfigLoader = class {
   }
   async loadConfig() {
     const configPath = join2(this.cwd, "archon.config.yaml");
-    if (existsSync6(configPath)) {
+    if (existsSync7(configPath)) {
       return this.loadFromConfigFile(configPath);
     }
     const archPath = join2(this.cwd, "ARCHITECTURE.md");
-    if (existsSync6(archPath)) {
+    if (existsSync7(archPath)) {
       return this.loadFromArchitecture(archPath);
     }
     return DEFAULT_ENVIRONMENTS;
@@ -4462,7 +4646,7 @@ async function execute(atomId, options) {
       process.exit(1);
     }
     const archPath = join3(cwd, "ARCHITECTURE.md");
-    if (!existsSync7(archPath)) {
+    if (!existsSync8(archPath)) {
       console.error(chalk2.red("ARCHITECTURE.md not found."));
       process.exit(1);
     }
@@ -4630,7 +4814,7 @@ async function captureLearnings(atom, execution) {
 }
 async function loadAtomEnvironmentState(atomId, cwd) {
   const stateFile = join3(cwd, ATOMS_DIR, `${atomId}.env.json`);
-  if (!existsSync7(stateFile)) {
+  if (!existsSync8(stateFile)) {
     return null;
   }
   const content = await readFile7(stateFile, "utf-8");
@@ -4642,6 +4826,7 @@ async function saveAtomEnvironmentState(atomId, cwd, state) {
 }
 
 export {
+  DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute

package/dist/{chunk-UG2ZZ7CM.js → chunk-K2VBICW3.js}

@@ -15,40 +15,54 @@ import readline from "readline";
 // src/core/models/registry.json
 var registry_default = {
   lastUpdated: "2026-01-21T00:00:00Z",
-  version: "1.0.0",
+  version: "1.2.0",
   providers: {
     anthropic: {
       displayName: "Anthropic",
       fast: [
         {
-          id: "claude-3-haiku-20240307",
-          name: "Claude 3 Haiku",
+          id: "claude-haiku-4-5",
+          name: "Claude Haiku 4.5",
           active: true,
-          costPer1kInput: 25e-5,
-          costPer1kOutput: 125e-5
+          costPer1kInput: 1e-3,
+          costPer1kOutput: 5e-3
         }
       ],
       thinking: [
         {
-          id: "claude-3-5-sonnet-20241022",
-          name: "Claude 3.5 Sonnet",
+          id: "claude-sonnet-4-5-20250929",
+          name: "Claude Sonnet 4.5",
           active: true,
           default: true,
           costPer1kInput: 3e-3,
           costPer1kOutput: 0.015
         },
         {
-          id: "claude-3-opus-20240229",
-          name: "Claude 3 Opus",
+          id: "claude-opus-4-5-20251101",
+          name: "Claude Opus 4.5",
           active: true,
-          costPer1kInput: 0.015,
-          costPer1kOutput: 0.075
+          costPer1kInput: 5e-3,
+          costPer1kOutput: 0.025
         }
       ]
     },
     openai: {
       displayName: "OpenAI",
       fast: [
+        {
+          id: "gpt-5-nano",
+          name: "GPT-5 Nano",
+          active: true,
+          costPer1kInput: 25e-6,
+          costPer1kOutput: 2e-4
+        },
+        {
+          id: "gpt-4.1-nano",
+          name: "GPT-4.1 Nano",
+          active: true,
+          costPer1kInput: 5e-5,
+          costPer1kOutput: 2e-4
+        },
         {
           id: "gpt-4o-mini",
           name: "GPT-4o Mini",
@@ -59,26 +73,26 @@ var registry_default = {
       ],
       thinking: [
         {
-          id: "gpt-4o",
-          name: "GPT-4o",
+          id: "gpt-5.2",
+          name: "GPT-5.2",
           active: true,
           default: true,
-          costPer1kInput: 5e-3,
-          costPer1kOutput: 0.015
+          costPer1kInput: 3e-3,
+          costPer1kOutput: 0.012
         },
         {
-          id: "o1-preview",
-          name: "o1 Preview",
+          id: "o3",
+          name: "o3",
           active: true,
-          costPer1kInput: 0.015,
-          costPer1kOutput: 0.06
+          costPer1kInput: 2e-3,
+          costPer1kOutput: 8e-3
         },
         {
-          id: "o1-mini",
-          name: "o1 Mini",
+          id: "o4-mini",
+          name: "o4-mini",
           active: true,
-          costPer1kInput: 3e-3,
-          costPer1kOutput: 0.012
+          costPer1kInput: 11e-4,
+          costPer1kOutput: 44e-4
         }
       ]
     },
@@ -86,42 +100,49 @@ var registry_default = {
       displayName: "Google",
       fast: [
         {
-          id: "gemini-1.5-flash",
-          name: "Gemini 1.5 Flash",
+          id: "gemini-2.5-flash-lite",
+          name: "Gemini 2.5 Flash-Lite",
           active: true,
           costPer1kInput: 75e-6,
           costPer1kOutput: 3e-4
+        },
+        {
+          id: "gemini-3-flash-preview",
+          name: "Gemini 3 Flash",
+          active: true,
+          costPer1kInput: 5e-4,
+          costPer1kOutput: 3e-3
         }
       ],
       thinking: [
         {
-          id: "gemini-1.5-pro",
-          name: "Gemini 1.5 Pro",
+          id: "gemini-2.5-pro",
+          name: "Gemini 2.5 Pro",
           active: true,
           default: true,
           costPer1kInput: 125e-5,
-          costPer1kOutput: 5e-3
+          costPer1kOutput: 0.01
         },
         {
-          id: "gemini-2.0-flash-thinking-exp",
-          name: "Gemini 2.0 Flash Thinking",
+          id: "gemini-3-pro-preview",
+          name: "Gemini 3 Pro",
           active: true,
-          costPer1kInput: 0,
-          costPer1kOutput: 0
+          costPer1kInput: 2e-3,
+          costPer1kOutput: 0.012
         }
       ]
     }
   },
   defaults: {
-    fast: "claude-3-haiku-20240307",
-    thinking: "claude-3-5-sonnet-20241022",
-    primaryAdversarial: "claude-3-5-sonnet-20241022",
-    secondaryAdversarial: "gpt-4o"
+    fast: "claude-haiku-4-5",
+    thinking: "claude-sonnet-4-5-20250929",
+    primaryAdversarial: "claude-sonnet-4-5-20250929",
+    secondaryAdversarial: "gpt-5.2"
   },
   freeModels: [
-    "claude-3-haiku-20240307",
-    "gpt-4o-mini",
-    "gemini-1.5-flash"
+    "gpt-5-nano",
+    "gpt-4.1-nano",
+    "gemini-2.5-flash-lite"
   ]
 };
 
@@ -605,7 +626,7 @@ async function setDefaultModelsMenu(profile, providers) {
   console.log(chalk.bold("\nAvailable models:\n"));
   availableModels.forEach((m, i) => {
     const categoryLabel = m.category === "fast" ? chalk.cyan("[fast]") : chalk.magenta("[thinking]");
-    console.log(`  ${chalk.cyan(String(i + 1))}) ${m.name} ${categoryLabel}`);
+    console.log(`  ${chalk.cyan(String(i + 1))}) ${m.modelName} ${categoryLabel}`);
   });
   console.log();
   const modelChoice = await prompt("Select model number");

package/dist/{execute-LYID2ODD.js → execute-N6CCEJ5I.js}

@@ -1,6 +1,6 @@
 import {
   execute
-} from "./chunk-I4ZVNLNO.js";
+} from "./chunk-74EEFKVP.js";
 import "./chunk-EDP55FCI.js";
 import "./chunk-2CFO5GVH.js";
 import "./chunk-MOZHC2GX.js";

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   resetPreferences,
   setPreference,
   showPreferences
-} from "./chunk-UG2ZZ7CM.js";
+} from "./chunk-K2VBICW3.js";
 import {
   reviewAnalyze,
   reviewExport,
@@ -27,10 +27,11 @@ import {
   status
 } from "./chunk-CAYCSBNX.js";
 import {
+  DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute
-} from "./chunk-I4ZVNLNO.js";
+} from "./chunk-74EEFKVP.js";
 import {
   list
 } from "./chunk-PK3OQVBG.js";
@@ -58,8 +59,8 @@ import {
 import "./chunk-QGM4M3NI.js";
 
 // src/cli/index.ts
-import { Command } from "commander";
-import chalk6 from "chalk";
+import { Command as Command2 } from "commander";
+import chalk7 from "chalk";
 import "dotenv/config";
 
 // src/cli/init.ts
@@ -725,7 +726,7 @@ async function listAtoms() {
 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-N6CCEJ5I.js");
     await execute2(atomId.trim(), {});
   } else {
     console.log(chalk4.yellow('No atom ID provided. Use "archon list" to see available atoms.'));
@@ -743,7 +744,7 @@ 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();
 }
@@ -1399,12 +1400,251 @@ async function watch() {
   await waitUntilExit();
 }
 
+// src/cli/deps.ts
+import { Command } from "commander";
+import chalk6 from "chalk";
+import { readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync5 } 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(chalk6.yellow("No DEPENDENCIES.md found."));
+      console.log(chalk6.dim("Create one with: archon deps add --source <path> --dependent <path>"));
+      return;
+    }
+    const result = await parser.parse();
+    if (!result.success) {
+      console.log(chalk6.red(`Parse error: ${result.error}`));
+      return;
+    }
+    const rules = result.document?.rules ?? [];
+    if (rules.length === 0) {
+      console.log(chalk6.dim("No dependency rules defined."));
+      return;
+    }
+    console.log(chalk6.bold(`
+\u{1F4E6} Dependency Rules (${rules.length})
+`));
+    for (const rule of rules) {
+      const severityColor = rule.severity === "BLOCKER" ? chalk6.red : rule.severity === "WARNING" ? chalk6.yellow : chalk6.blue;
+      console.log(`${severityColor(`[${rule.severity}]`)} ${chalk6.bold(rule.id)}`);
+      console.log(`  Source: ${chalk6.cyan(rule.source)}`);
+      console.log(`  Dependents: ${rule.dependents.map((d) => chalk6.dim(d)).join(", ")}`);
+      if (rule.reason && options.verbose) {
+        console.log(`  Reason: ${chalk6.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(chalk6.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(chalk6.green("\u2705 No downstream dependency impacts found."));
+      process.exit(0);
+    }
+    console.log(chalk6.yellow(`
+\u26A0\uFE0F  Found ${result.impacts.length} dependency impact(s):
+`));
+    for (const impact of result.impacts) {
+      const severityColor = impact.rule.severity === "BLOCKER" ? chalk6.red : impact.rule.severity === "WARNING" ? chalk6.yellow : chalk6.blue;
+      console.log(severityColor(`[${impact.rule.severity}] ${impact.rule.id}`));
+      console.log(`  Changing: ${chalk6.cyan(impact.matchedSource)}`);
+      console.log(`  May impact: ${impact.affectedDependents.join(", ")}`);
+      if (impact.rule.reason) {
+        console.log(`  Reason: ${chalk6.dim(impact.rule.reason)}`);
+      }
+      console.log("");
+    }
+    if (result.hasBlockers) {
+      console.log(chalk6.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 readFile3(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(chalk6.yellow(`Rule already exists: ${existingRule.id}`));
+      return;
+    }
+    const newRule = {
+      id: nextId,
+      source,
+      dependents: [dependent],
+      severity,
+      reason
+    };
+    existingRules.push(newRule);
+    const yaml = generateYamlFrontmatter(existingRules);
+    await writeFile3(DEPENDENCIES_FILENAME, `---
+${yaml}---${markdownBody}`, "utf-8");
+    console.log(chalk6.green(`\u2705 Added dependency rule: ${nextId}`));
+    console.log(`  Source: ${chalk6.cyan(source)}`);
+    console.log(`  Dependent: ${chalk6.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(chalk6.yellow("No DEPENDENCIES.md found."));
+      return;
+    }
+    const mermaid = await parser.generateGraph();
+    if (options.output) {
+      await writeFile3(options.output, mermaid, "utf-8");
+      console.log(chalk6.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 (existsSync5(DEPENDENCIES_FILENAME)) {
+      console.log(chalk6.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 writeFile3(DEPENDENCIES_FILENAME, template, "utf-8");
+    console.log(chalk6.green("\u2705 Created DEPENDENCIES.md"));
+    console.log(chalk6.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)) {
-    console.log(chalk6.blue("\nArchonDev is not initialized in this folder.\n"));
+    console.log(chalk7.blue("\nArchonDev is not initialized in this folder.\n"));
     await init({ analyze: true, git: true });
   }
   await start();
@@ -1412,7 +1652,7 @@ program.name("archon").description("Local-first AI-powered development governanc
 program.command("login").description("Authenticate with ArchonDev").option("-p, --provider <provider>", "OAuth provider (github or google)", "github").action(async (options) => {
   const provider = options.provider;
   if (provider !== "github" && provider !== "google") {
-    console.error(chalk6.red('Invalid provider. Use "github" or "google"'));
+    console.error(chalk7.red('Invalid provider. Use "github" or "google"'));
     process.exit(1);
   }
   await login(provider);
@@ -1531,4 +1771,5 @@ reviewCommand.command("run").description("Run AI-powered review on pending tasks
 reviewCommand.action(async () => {
   await reviewStatus();
 });
+program.addCommand(createDepsCommand());
 program.parse();

package/dist/{preferences-PL2ON5VY.js → preferences-QEFXVCZN.js}

@@ -4,7 +4,7 @@ import {
   resetPreferences,
   setPreference,
   showPreferences
-} from "./chunk-UG2ZZ7CM.js";
+} from "./chunk-K2VBICW3.js";
 import "./chunk-SMR7JQK6.js";
 import "./chunk-WCCBJSNI.js";
 import "./chunk-QGM4M3NI.js";

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "archondev",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "description": "Local-first AI-powered development governance system",
   "main": "dist/index.js",
   "bin": {
-    "archon": "dist/index.js"
+    "archon": "dist/index.js",
+    "archondev": "dist/index.js"
   },
   "files": [
     "dist"