faf-cli 3.0.6 → 3.1.0

package/README.md

@@ -25,15 +25,29 @@ faf score       # Check AI-readiness (0-100%)
 ```
 
 **CLI vs MCP clarity**
-- **faf-cli** (this): Command-line tool that creates .faf files from your codebase → attach to any AI
-- **claude-faf-mcp** ([npm](https://www.npmjs.com/package/claude-faf-mcp)): MCP server for Claude Desktop → lets Claude read .faf files natively
+- **faf-cli** (this): Runs on your machine locally in a terminal
+- **claude-faf-mcp** ([npm](https://www.npmjs.com/package/claude-faf-mcp)): Runs through Claude Desktop as a tool
 
-Most users want both: faf-cli creates .faf files, claude-faf-mcp lets Claude read them automatically.
+Same .faf, different way to use. Same Project DNA and scoring. Same capabilities (create, score, improve). Different execution layer.
+
+Use CLI for raw speed and local development; use MCP for AI-integrated workflows. No feature gaps between them - pick based on your flow.
 
 [Website](https://faf.one) | [GitHub](https://github.com/Wolfe-Jam/faf-cli) | [Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)
 
 ---
 
+### 📸 See It In Action
+
+<div align="center">
+<img src="./assets/screenshots/package-json+project-faf.png" alt="project.faf sits between package.json and README.md" width="500" />
+
+**`project.faf` sits right between `package.json` and `README.md`** - exactly where it belongs.
+
+Visible. Discoverable. Universal.
+</div>
+
+---
+
 ## 📚 Complete Documentation
 
 **For developers who want the full story**, here's everything about FAF's architecture, testing, and championship engineering standards.
@@ -68,13 +82,181 @@ npm install -g faf-cli
 brew install faf-cli
 ```
 
-**One line. Zero config. Championship context.** 🏁
+**One line. Zero config. Podium context.** 🏁
+
+---
+
+## 🎉 What's New in v3.1.0
+
+### 🔥 THE VISIBILITY REVOLUTION 🔥
+
+**AI context just became UNIVERSAL. project.faf is here.**
+
+For too long, `.faf` lived in the shadows - hidden, invisible, forgotten. **NOT ANYMORE.**
+
+### 📂 Introducing: `project.faf`
+
+## **`package.json` for AI**
+
+**Just like `package.json` tells npm what your project needs...**
+**`project.faf` tells AI what your project IS.**
+
+| File | Purpose | Who Reads It |
+|------|---------|--------------|
+| `package.json` | Dependencies, scripts, metadata | npm, Node.js, developers |
+| `project.faf` | **Context, architecture, purpose** | **AI, Claude, Cursor, any AI tool** |
+
+**Same pattern. Same universality. Same necessity.**
+
+**VISIBLE. DISCOVERABLE. UNIVERSAL.**
+
+```bash
+# The old way (hidden like .env)
+ls -la
+.env          # 🔒 Hidden (secrets - SHOULD be hidden)
+.faf          # 👻 Hidden (AI context - SHOULD be visible!)
+
+# The NEW WAY (visible like package.json)
+ls
+package.json  # ✅ Visible (dependencies - everyone needs to see)
+project.faf   # ✅ Visible (AI context - AI needs to find this!)
+.env          # 🔒 Still hidden (secrets stay secret)
+```
+
+**`.env` hides secrets. `project.faf` shares context.**
+
+**`.faf` was hiding in the wrong category. `project.faf` fixes that.**
+
+### 🚀 Why This Changes Everything
+
+**Before:**
+- Hidden `.faf` files easily forgotten
+- Hard to discover in new projects
+- "Wait, does this project have AI context?"
+- Invisible to Git UIs, IDEs, file managers
+
+**After:**
+- `project.faf` sits next to `package.json`
+- **IMPOSSIBLE TO MISS**
+- Universal pattern developers already know
+- Every project SHOWS its AI-readiness
+
+### 🔺 The Golden Triangle
+
+**Three sides. Closed loop. Complete accountability.**
+
+```
+         project.faf
+          (WHAT IT IS)
+              /    \
+             /      \
+            /        \
+         repo    ←→   .taf
+        (CODE)    (PROOF IT WORKS)
+```
+
+Every project needs three things:
+- **Code that works** (repo)
+- **Context for AI** (project.faf)
+- **Proof it works** (.taf - git-tracked testing timeline)
+
+**TAF** (Testing Audit File) format tracks every test run in git. On-the-fly CI/CD updates. Permanent audit trail. Unheard of in CI/CD.
+
+**Traditional CI/CD:** Tests run → Results disappear → No permanent record
+**TAF:** Tests run → .taf updates → Git commits → Permanent timeline
+
+Format defined in **faf-taf-git** (GitHub Actions native support).
+
+### ✨ The Essential Trio
+
+```bash
+your-project/
+├── package.json    # What your project NEEDS (dependencies)
+├── project.faf     # What your project IS (context for AI)
+└── tsconfig.json   # How your project BUILDS (TypeScript config)
+```
+
+**`package.json`** → Tells npm: "Install these dependencies"
+**`project.faf`** → Tells AI: "This is what I am, this is my purpose"
+**`tsconfig.json`** → Tells TypeScript: "Compile with these settings"
+
+**All visible. All universal. All essential.**
+
+**You wouldn't skip `package.json`. Don't skip `project.faf`.**
+
+### 🔥 New Commands
+
+**1. `faf migrate` - Instant Upgrade**
+```bash
+faf migrate
+# .faf → project.faf (27ms)
+```
+
+**2. `faf rename` - Bulk Power**
+```bash
+faf rename
+# Recursively migrates ENTIRE monorepo tree
+# Found 147 .faf files? ✅ Migrated in 420ms
+```
+
+**3. Auto-Magic for New Projects**
+```bash
+faf init    # Creates project.faf (not .faf)
+faf auto    # Creates project.faf
+```
+
+### 🎯 Championship Detection Upgrade
+
+**TSA Engine Integration** - "We're INSPECTORS, not trash collectors"
+
+**Before (naive):**
+```
+Has 'commander' in package.json? → Maybe CLI
+```
+
+**After (championship):**
+```
+'commander' imported 10+ times? → DEFINITELY CLI
+Analyzes CORE dependencies (actual usage)
+95% accuracy vs 70% accuracy
+```
+
+### ⚡ Performance
+
+- **migrate:** 27ms (54% faster than 50ms target)
+- **rename:** 27ms for 3 files (73% faster than target)
+- **championship grade** across all operations
+
+### 🏆 WJTTC GOLD Certification
+
+**97/100 Championship Score**
+- Project Understanding: 20/20
+- TURBO-CAT Knowledge: 20/20
+- Architecture Understanding: 20/20
+
+Full report: 194KB comprehensive test suite
+
+### 🔙 100% Backward Compatible
+
+**Still works with `.faf` files** - graceful transition, no breaking changes.
+
+Your old `.faf` files keep working. Migrate when ready.
+
+### 🌍 The Vision
+
+**Every project with a `package.json` should have a `project.faf`**
+
+Just like every TypeScript project has `tsconfig.json`, every Rust project has `Cargo.toml`, every Python project has `requirements.txt`...
+
+**Every AI-augmented project has `project.faf`**
+
+**This is the new universal standard for AI context.**
 
 ---
 
 ## 🎉 What's New in v3.0.0
 
-### The Championship Release
+### The Podium Release
 
 **The biggest release yet:**
 
@@ -82,10 +264,10 @@ brew install faf-cli
 - 💨 **TURBO Model Introduced** - Like VS Code + Copilot, Spotify Free + Premium, Zoom Basic + Pro
 - 😽 **TURBO-CAT™ Format Discovery** - Introduced in v2.0.0, now purring at full power in v3.0.0 - 153 validated formats organized in a perfect pyramid
 - 🧬 **Birth DNA Lifecycle** - Track your project's evolution from birth to championship
-- 🏆 **7-Tier Championship Scoring** - 🏆 🥇 🥈 🥉 🟢 🟡 🔴 🤍 - From Lonely Heart to Podium Champion
+- 🏆 **7-Tier Podium Scoring** - 🏆 🥇 🥈 🥉 🟢 🟡 🔴 🤍 - From Lonely Heart to Podium Champion
 - ⚖️ **AI | HUMAN Balance** - 50|50 system = Optimal Context for championship performance
 - 🔗 **Context-Mirroring w/Bi-Sync** - Bidirectional .faf ↔ CLAUDE.md synchronization
-- ⚡ **Championship Speed** - 8ms bi-sync, <50ms all commands, 18ms avg, 0ms operations achieved
+- ⚡ **Podium Speed** - 8ms bi-sync, <50ms all commands, 18ms avg, 0ms operations achieved
 - 🏁 **WJTTC GOLD Certified** - 1,000+ comprehensive tests, unique test suite
 - 🤖 **BIG-3 AI Validation** - Verified by Google Gemini, Anthropic Claude, OpenAI Codex
 - 🌐 **Universal AI Support** - Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, Warp, Copilot, Windsurf, ALL AI coding assistants
@@ -187,7 +369,7 @@ faf formats
 
 ### **FAF v3.0.3 (FREE FOR ALL DEVS)** 🆓
 
-✅ **41 Championship Commands**
+✅ **41 Podium Commands**
 - Project initialization & auto-detection
 - TURBO-CAT format discovery (153 formats)
 - Birth DNA lifecycle tracking
@@ -356,7 +538,7 @@ You're gonna end up with a **CAVITY**.
 
 ### The Solution: Project DNA
 
-- ✅ **Championship context** (85-99% quality scores)
+- ✅ **Podium context** (85-99% quality scores)
 - ✅ **Persistent intelligence** - AI remembers your project perfectly
 - ✅ **Seamless collaboration** - Human + AI working together optimally
 - ✅ **Project health monitoring** - Track context quality over time
@@ -369,7 +551,7 @@ You're gonna end up with a **CAVITY**.
 
 ### 🏎️ Power Commands
 ```bash
-faf auto        # ONE COMMAND TO RULE THEM ALL - Zero to Championship
+faf auto        # ONE COMMAND TO RULE THEM ALL - Zero to Podium
 faf init        # Create .faf from your project
 faf enhance     # Real AI analysis & improvements
 faf analyze     # Claude-first intelligence
@@ -485,12 +667,12 @@ faf             # Interactive menu (use faf auto instead)
 
 ---
 
-## 🏆 Championship Scoring
+## 🏆 Podium Scoring
 
 Track your project's AI-readiness with F1-inspired tiers:
 
 ```
-🏆 Trophy (100%)    - Championship - Perfect 50|50 AI|HUMAN balance
+🏆 Trophy (100%)    - Podium - Perfect 50|50 AI|HUMAN balance
 🥇 Gold (99%)       - Gold standard
 🥈 Silver (95-98%)  - Excellence
 🥉 Bronze (85-94%)  - Production ready
@@ -513,7 +695,7 @@ Status: Bronze - Production Ready
 
 Next milestone: 95% 🥈 Silver (6 points to go!)
 
-🏎️  FAF Championship Status
+🏎️  FAF Podium Status
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Initial DNA: 12% (born 2025-10-03)
 Growth: +77% over 4 days
@@ -522,7 +704,7 @@ Next Milestone: 95% 🥈 Silver (6% to go!)
 
 ---
 
-## ⚖️ AI | HUMAN Balance - The 50|50 Championship System
+## ⚖️ AI | HUMAN Balance - The 50|50 Podium System
 
 **NEW in v3.0.0:** Track the perfect balance between AI-readable and human-readable content.
 
@@ -613,7 +795,7 @@ Automation:    n8n workflows, OpenAI Builder, Google Opal, Make.com - AI-Automat
 | **Cost** | Per-query fees | Zero runtime cost |
 | **Versioning** | Difficult | Git-friendly YAML |
 
-**.faf is RAG's output—captured once, reused infinitely.** Championship efficiency.
+**.faf is RAG's output—captured once, reused infinitely.** Podium efficiency.
 
 ### Universal Pattern
 
@@ -631,7 +813,7 @@ Same pattern. Same output. Universal by design.
 
 ---
 
-## 🏆 WJTTC Championship Testing
+## 🏆 WJTTC Podium Testing
 
 **FAF CLI v3.0.3 is WJTTC GOLD Certified** - tested to F1-grade standards.
 
@@ -642,7 +824,7 @@ Same pattern. Same output. Universal by design.
 
 **Battle-tested with 12,500+ test iterations across 5 testing tiers:**
 - ✅ **BIG-3 AI Validation** (11,200 iterations - Claude, ChatGPT/Codex, Gemini)
-- ✅ **287 Automated Tests** (191 Jest unit + 66 Championship Safety + 30 YOLO torture)
+- ✅ **287 Automated Tests** (191 Jest unit + 66 Podium Safety + 30 YOLO torture)
 - ✅ **730 Empirical C.O.R.E Tests** (100% MCP protocol compliance)
 - ✅ **301 Context-On-Demand Tests** (Torture testing, edge cases, stress scenarios)
 - ✅ **35+ Test Documents** (Comprehensive validation reports)
@@ -810,7 +992,7 @@ Copy cats? Why bother.
 
 <div align="center">
 
-## 🏁 v3.0.3 - Championship Edition
+## 🏁 v3.0.3 - Podium Edition
 
 **FREE FOR ALL DEVS** 🆓 • **Growing Fast** 📈 • **AI-Context, On-Demand.**
 

package/dist/big-orange/compare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAiB,MAAM,SAAS,CAAC;AAOnF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAmD5B"}
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAiB,MAAM,SAAS,CAAC;AAOnF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAuC5B"}

package/dist/big-orange/compare.js

@@ -30,14 +30,12 @@ async function compareContexts(request) {
     console.log(`Generated .faf instances:`);
     console.log(`  Left: ${request.leftScore}% (${leftFaf.content.length} chars)`);
     console.log(`  Right: ${request.rightScore}% (${rightFaf.content.length} chars)\n`);
-    // 2. Call Claude API twice (parallel for speed)
-    const anthropic = new sdk_1.default({
-        apiKey: process.env.ANTHROPIC_API_KEY
-    });
+    // 2. Call Claude API with both contexts
     console.log('Calling Claude API...');
+    const client = new sdk_1.default({ apiKey: process.env.ANTHROPIC_API_KEY });
     const [leftResponse, rightResponse] = await Promise.all([
-        callClaudeWithContext(anthropic, request.prompt, leftFaf.content, request.leftScore),
-        callClaudeWithContext(anthropic, request.prompt, rightFaf.content, request.rightScore)
+        callClaudeWithContext(client, request.prompt, leftFaf.content, request.leftScore),
+        callClaudeWithContext(client, request.prompt, rightFaf.content, request.rightScore)
     ]);
     console.log('✓ Both responses received\n');
     // 3. Calculate delta metrics
@@ -129,20 +127,20 @@ async function scoreFafContent(fafContent, expectedScore) {
  * Uses FAF CLI's standard scoring tiers
  */
 function getChampionshipEmoji(score) {
-    if (score >= 85)
+    if (score >= 100)
         return '🏆'; // Trophy (championship)
+    if (score >= 99)
+        return '🥇'; // Gold
+    if (score >= 95)
+        return '🥈'; // Silver (Target 2)
+    if (score >= 85)
+        return '🥉'; // Bronze (Target 1)
     if (score >= 70)
-        return '🥇'; // Gold medal
+        return '🟢'; // Green (GO!)
     if (score >= 55)
-        return '🥈'; // Silver medal
-    if (score >= 40)
-        return '🥉'; // Bronze medal
-    if (score >= 35)
-        return '🟢'; // Green (good)
-    if (score >= 20)
-        return '🟡'; // Yellow (warning)
+        return '🟡'; // Yellow (Caution)
     if (score >= 10)
-        return '🔴'; // Red (poor)
+        return '🔴'; // Red (Pit Stop)
     return '🤍'; // White (empty)
 }
 /**

package/dist/big-orange/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAi1C/C,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA89C/C,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -77,6 +77,11 @@ const chat_1 = require("./commands/chat");
 const convert_1 = require("./commands/convert");
 const notifications_1 = require("./commands/notifications");
 const skills_1 = require("./commands/skills");
+const drift_1 = require("./commands/drift");
+const git_1 = require("./commands/git");
+const taf_1 = require("./commands/taf");
+const migrate_1 = require("./commands/migrate");
+const rename_1 = require("./commands/rename");
 const color_utils_1 = require("./utils/color-utils");
 const championship_style_1 = require("./utils/championship-style");
 const analytics_1 = require("./telemetry/analytics");
@@ -207,6 +212,38 @@ Examples:
     console.log('');
     return (0, init_1.initFafFile)(directory, options);
 }));
+// 🔄 faf migrate - Migrate .faf to project.faf (v1.2.0)
+commander_1.program
+    .command('migrate [directory]')
+    .description('Migrate .faf (legacy) to project.faf (v1.2.0 standard)')
+    .option('-f, --force', 'Overwrite existing project.faf file')
+    .option('--dry-run', 'Preview migration without making changes')
+    .addHelpText('after', `
+Examples:
+  $ faf migrate                  # Migrate .faf to project.faf
+  $ faf migrate --dry-run        # Preview migration
+  $ faf migrate --force          # Overwrite existing project.faf
+
+v1.2.0: project.faf is the new standard (visible, like package.json)`)
+    .action(withAnalyticsTracking('migrate', (directory, options) => (0, migrate_1.migrateCommand)(directory, options)));
+// 🔄 faf rename - Bulk migration across multiple projects
+commander_1.program
+    .command('rename [path]')
+    .description('Bulk migrate all .faf files to project.faf recursively')
+    .option('-f, --force', 'Overwrite existing project.faf files')
+    .option('--dry-run', 'Preview migration without making changes')
+    .option('--no-confirm', 'Skip confirmation for large migrations')
+    .option('--max-depth <number>', 'Maximum directory depth to search', '10')
+    .addHelpText('after', `
+Examples:
+  $ faf rename ~/Projects          # Migrate all repos in ~/Projects
+  $ faf rename . --dry-run         # Preview what would be migrated
+  $ faf rename ~/code --force      # Overwrite existing project.faf files
+  $ faf rename --no-confirm        # Skip confirmation prompt
+
+Power user tool: Migrate your entire system in one command!
+Searches recursively and renames all .faf → project.faf`)
+    .action(withAnalyticsTracking('rename', (searchPath, options) => (0, rename_1.renameCommand)(searchPath, options)));
 // 🧬 faf dna - Show your journey at a glance
 commander_1.program
     .command('dna')
@@ -465,6 +502,69 @@ Integrations:
   • MCP server recommendations per stack
   • Quality-gated: 85% minimum (Bronze tier)`)
     .action(withAnalyticsTracking('fam', (subcommand, arg, options) => (0, fam_1.famCommand)(subcommand, arg, options)));
+// 🚀 faf git - GitHub Repository Context Extractor
+commander_1.program
+    .command('git [query]')
+    .description('🚀 Generate AI context for ANY GitHub repo without cloning')
+    .option('-o, --output <path>', 'Output path for .faf file')
+    .option('--list', 'Show popular repositories')
+    .option('--category <category>', 'Filter popular repos by category')
+    .option('--scan', 'Metadata only (skip file tree)')
+    .option('--clone', 'Clone repo after generating .faf')
+    .addHelpText('after', `
+Examples:
+  $ faf git react                     # Shorthand: facebook/react
+  $ faf git svelte                    # Auto-resolve: sveltejs/svelte
+  $ faf git facebook/react            # owner/repo format
+  $ faf git https://github.com/...    # Full URL
+  $ faf git --list                    # Show popular repos
+  $ faf git --list --category auth    # Show auth libraries
+
+  # Batch processing (comparison mode)
+  $ faf git react vue svelte          # Compare multiple repos
+
+🚀 Use Cases:
+  • Get AI context for libraries you DON'T own
+  • Compare repos before choosing one
+  • Understand architecture before cloning
+  • Ask AI about ANY repo instantly
+
+Features:
+  • ⚡ <200ms extraction (no clone needed)
+  • 🔍 Fuzzy matching for typos (svelt → svelte)
+  • 📊 Rich metadata (stars, topics, languages)
+  • 🏆 Quality scoring (0-100%)
+  • 🎯 Smart shorthand (react → facebook/react)`)
+    .action(withAnalyticsTracking('git', (query, options) => (0, git_1.gitCommand)(query, options)));
+// 📊 faf taf - Testing Activity Feed
+commander_1.program
+    .command('taf')
+    .description('📊 Testing Activity Feed - Git-friendly testing timeline')
+    .addHelpText('after', `
+Subcommands:
+  init              Initialize .taf file
+  log               Log a test run
+  validate          Validate .taf format
+  stats             Show test statistics
+
+Examples:
+  $ faf taf init                              # Create .taf file
+  $ faf taf log --total 173 --passed 173 --failed 0
+  $ faf taf validate                          # Check format
+  $ faf taf stats                             # View statistics
+
+Features:
+  • 📝 Git-friendly YAML format (append-only)
+  • 🔗 Native Reference with .faf
+  • 🏆 Podium scoring (🏆 🥇 🥈 🥉)
+  • 📊 Pass rate tracking and trends
+  • ⚡ Lightweight (5-60 lines per run)`)
+    .action(withAnalyticsTracking('taf', () => {
+    // Get raw arguments after 'taf' command
+    const tafIndex = process.argv.indexOf('taf');
+    const args = tafIndex >= 0 ? process.argv.slice(tafIndex + 1) : [];
+    return (0, taf_1.tafCommand)(args);
+}));
 // 📚 faf index - Universal A-Z Reference (The Everything Catalog)
 commander_1.program
     .command('index [term]')
@@ -879,7 +979,43 @@ Claude Code Consistency:
   • Fresh start for .faf system
   • Removes temporary files and cached data`)
     .action((options) => (0, clear_1.clearCommand)(options));
-// ✏️ faf edit - Interactive .faf editor (Claude Code consistency)  
+// 🍊 faf drift - Context-Drift Analyzer
+commander_1.program
+    .command('drift')
+    .description('🍊 Analyze git history for context-drift - Context-drift makes you pay')
+    .option('--since <period>', 'Analyze drift since period (e.g., "90d", "6m")')
+    .option('--detailed', 'Show detailed breakdown of drift events')
+    .option('--export <file>', 'Export analysis to JSON file')
+    .addHelpText('after', `
+Examples:
+  $ faf drift                    # Analyze entire git history
+  $ faf drift --since 90d        # Last 90 days only
+  $ faf drift --detailed         # Full breakdown
+  $ faf drift --export drift.json # Save to file
+
+What is Context-Drift?
+  • AI makes decisions without project context
+  • Each guess creates drift from your true architecture
+  • Drift compounds: auth → state → styling → framework
+  • Eventually: rewrites, migrations, or project death
+
+What faf drift detects:
+  • Auth system changes (JWT → Firebase → Supabase)
+  • State management swaps (Redux → Zustand)
+  • Styling migrations (CSS → Tailwind)
+  • Framework changes (React → Next.js)
+  • Database migrations (MongoDB → Postgres)
+
+Shows you:
+  • Files rewritten due to drift
+  • Weeks lost to cascade fixes
+  • Future drift risk level
+  • What .faf would have prevented
+
+Context-drift makes you pay.
+.faf keeps you drift-free.`)
+    .action(withAnalyticsTracking('drift', (options) => (0, drift_1.driftCommand)(options)));
+// ✏️ faf edit - Interactive .faf editor (Claude Code consistency)
 commander_1.program
     .command('edit')
     .description('✏️ Interactive .faf editor with validation')