faf-cli 3.0.5 → 3.1.0

package/dist/big-orange/faf-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BIG ORANGE 🍊 - REAL .faf Instance Generator
+ * Generates .faf files at different completeness levels using ACTUAL .faf format
+ * Based on faf-cli.faf structure
+ */
+import type { FafInstance } from './types';
+/**
+ * Generate a .faf instance at a specific completeness score
+ * Uses real .faf YAML format with slot-based scoring
+ *
+ * @param score - Completeness level (0-100)
+ * @param projectPath - Optional project path for analysis
+ * @returns FafInstance with generated YAML content
+ */
+export declare function generateFafInstance(score: number, projectPath?: string): Promise<FafInstance>;
+/**
+ * Calculate a project's current .faf birth score
+ * @param projectPath - Path to project
+ * @returns Birth score (0-100)
+ */
+export declare function calculateBirthScore(projectPath: string): Promise<number>;
+//# sourceMappingURL=faf-generator.d.ts.map

package/dist/big-orange/faf-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faf-generator.d.ts","sourceRoot":"","sources":["../../src/big-orange/faf-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAuMtB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9E"}

package/dist/big-orange/faf-generator.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * BIG ORANGE 🍊 - REAL .faf Instance Generator
+ * Generates .faf files at different completeness levels using ACTUAL .faf format
+ * Based on faf-cli.faf structure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFafInstance = generateFafInstance;
+exports.calculateBirthScore = calculateBirthScore;
+/**
+ * Generate a .faf instance at a specific completeness score
+ * Uses real .faf YAML format with slot-based scoring
+ *
+ * @param score - Completeness level (0-100)
+ * @param projectPath - Optional project path for analysis
+ * @returns FafInstance with generated YAML content
+ */
+async function generateFafInstance(score, projectPath) {
+    if (score === 0) {
+        return {
+            score: 0,
+            content: '',
+            metadata: {}
+        };
+    }
+    // Calculate slots based on score
+    // Real .faf has 21 total slots
+    const totalSlots = 21;
+    const filledSlots = Math.round((score / 100) * totalSlots);
+    const slotPercentage = Math.round((filledSlots / totalSlots) * 100);
+    // Build .faf content as YAML
+    const sections = [];
+    // ALWAYS include (even at low scores)
+    sections.push(`faf_version: "2.5.0"`);
+    sections.push(`ai_scoring_system: "2025-09-20"`);
+    sections.push(`ai_score: "${score}%"`);
+    // Score 10%+: Add confidence and value
+    if (score >= 10) {
+        const confidence = score >= 70 ? 'HIGH' : score >= 40 ? 'MEDIUM' : 'LOW';
+        sections.push(`ai_confidence: ${confidence}`);
+        sections.push(`ai_value: "${score >= 80 ? '30_seconds_replaces_20_minutes' : 'reduced_questions'}"`);
+    }
+    // Score 20%+: Add ai_tldr
+    if (score >= 20) {
+        sections.push(`ai_tldr:`);
+        sections.push(`  project: "Demo Project - Color Picker Component"`);
+        sections.push(`  stack: ${score >= 50 ? 'React/TypeScript/Vite/Vercel' : 'React'}`);
+        sections.push(`  quality_bar: ${score >= 80 ? 'ZERO_ERRORS_F1_STANDARDS' : 'STANDARD'}`);
+        sections.push(`  current_focus: Component development`);
+        sections.push(`  your_role: Build features with ${score >= 60 ? 'perfect' : 'available'} context`);
+    }
+    // Score 30%+: Add instant_context
+    if (score >= 30) {
+        sections.push(`instant_context:`);
+        sections.push(`  what_building: "Color picker component"`);
+        sections.push(`  tech_stack: React${score >= 50 ? '/TypeScript/Vite' : ''}`);
+        sections.push(`  main_language: ${score >= 40 ? 'TypeScript' : 'JavaScript'}`);
+        if (score >= 50) {
+            sections.push(`  deployment: Vercel`);
+            sections.push(`  key_files:`);
+            sections.push(`    - package.json`);
+            sections.push(`    - tsconfig.json`);
+        }
+    }
+    // Score 40%+: Add context_quality
+    if (score >= 40) {
+        sections.push(`context_quality:`);
+        sections.push(`  slots_filled: "${filledSlots}/${totalSlots} (${slotPercentage}%)"`);
+        sections.push(`  ai_confidence: ${score >= 70 ? 'HIGH' : 'MEDIUM'}`);
+        sections.push(`  handoff_ready: ${score >= 70 ? 'true' : 'false'}`);
+        if (score < 90) {
+            sections.push(`  missing_context:`);
+            sections.push(`    - ${score < 60 ? 'Project structure' : 'Performance metrics'}`);
+        }
+    }
+    // Score 50%+: Add project section
+    if (score >= 50) {
+        sections.push(`project:`);
+        sections.push(`  name: Demo Color Picker`);
+        sections.push(`  goal: "Build reusable color picker component"`);
+        sections.push(`  main_language: TypeScript`);
+        sections.push(`  generated: "${new Date().toISOString()}"`);
+        if (score >= 80) {
+            sections.push(`  mission: "🚀 Make Your AI Happy! 🧡 Trust-Driven 🤖"`);
+            sections.push(`  revolution: "30 seconds replaces 20 minutes of questions"`);
+            sections.push(`  brand: "F1-Inspired Software Engineering - Championship AI Context"`);
+        }
+    }
+    // Score 60%+: Add ai_instructions
+    if (score >= 60) {
+        sections.push(`ai_instructions:`);
+        sections.push(`  priority_order:`);
+        sections.push(`    - "1. Read THIS .faf file first"`);
+        if (score >= 70) {
+            sections.push(`    - "2. Check CLAUDE.md for session context"`);
+            sections.push(`    - "3. Review package.json for dependencies"`);
+        }
+        sections.push(`  working_style:`);
+        sections.push(`    code_first: true`);
+        sections.push(`    explanations: minimal`);
+        sections.push(`    quality_bar: ${score >= 80 ? 'zero_errors' : 'standard'}`);
+        sections.push(`    testing: ${score >= 70 ? 'required' : 'recommended'}`);
+        if (score >= 80) {
+            sections.push(`  warnings:`);
+            sections.push(`    - All TypeScript must pass strict mode`);
+            sections.push(`    - Test coverage required for new features`);
+        }
+    }
+    // Score 70%+: Add stack
+    if (score >= 70) {
+        sections.push(`stack:`);
+        sections.push(`  frontend: React`);
+        sections.push(`  css_framework: Tailwind CSS`);
+        sections.push(`  ui_library: Headless UI`);
+        sections.push(`  state_management: React Hooks`);
+        sections.push(`  backend: None`);
+        sections.push(`  runtime: "Node.js >=18.0.0"`);
+        sections.push(`  database: None`);
+        sections.push(`  build: Vite`);
+        sections.push(`  package_manager: npm`);
+        sections.push(`  api_type: Component Library`);
+        sections.push(`  hosting: Vercel`);
+        if (score >= 85) {
+            sections.push(`  cicd: GitHub Actions`);
+        }
+    }
+    // Score 80%+: Add preferences
+    if (score >= 80) {
+        sections.push(`preferences:`);
+        sections.push(`  quality_bar: zero_errors`);
+        sections.push(`  commit_style: conventional_emoji`);
+        sections.push(`  response_style: concise_code_first`);
+        sections.push(`  explanation_level: minimal`);
+        sections.push(`  communication: direct`);
+        sections.push(`  testing: required`);
+        sections.push(`  documentation: as_needed`);
+    }
+    // Score 85%+: Add state
+    if (score >= 85) {
+        sections.push(`state:`);
+        sections.push(`  phase: development`);
+        sections.push(`  version: "1.0.0"`);
+        sections.push(`  focus: component_implementation`);
+        sections.push(`  status: green_flag`);
+        sections.push(`  next_milestone: production_ready`);
+        sections.push(`  blockers:`);
+    }
+    // Score 90%+: Add tags
+    if (score >= 90) {
+        sections.push(`tags:`);
+        sections.push(`  auto_generated:`);
+        sections.push(`    - react`);
+        sections.push(`    - typescript`);
+        sections.push(`    - component`);
+        sections.push(`    - color-picker`);
+        sections.push(`  smart_defaults:`);
+        sections.push(`    - .faf`);
+        sections.push(`    - ai-ready`);
+        sections.push(`    - "2025"`);
+        sections.push(`  user_defined:`);
+    }
+    // Score 95%+: Add human_context
+    if (score >= 95) {
+        sections.push(`human_context:`);
+        sections.push(`  who: Development team`);
+        sections.push(`  what: "Reusable color picker component for design system"`);
+        sections.push(`  why: Standardize color selection across applications`);
+        sections.push(`  where: Component library`);
+        sections.push(`  when: "Active development"`);
+        sections.push(`  how: "TypeScript React component with accessibility"`);
+        sections.push(`  context_score: ${slotPercentage}`);
+        sections.push(`  total_prd_score: ${score}`);
+        sections.push(`  success_rate: "95%"`);
+    }
+    // Score 99%+: Add ai_scoring_details (championship level)
+    if (score >= 99) {
+        sections.push(`ai_scoring_details:`);
+        sections.push(`  system_date: "2025-09-20"`);
+        sections.push(`  slot_based_percentage: ${slotPercentage}`);
+        sections.push(`  ai_score: ${score}`);
+        sections.push(`  total_slots: ${totalSlots}`);
+        sections.push(`  filled_slots: ${filledSlots}`);
+        sections.push(`  scoring_method: "Honest percentage - no fake minimums"`);
+        sections.push(`  trust_embedded: "COUNT ONCE architecture - trust MY embedded scores"`);
+    }
+    const content = sections.join('\n');
+    return {
+        score,
+        content,
+        metadata: {
+            framework: 'React',
+            language: 'TypeScript',
+            styling: 'Tailwind CSS',
+            quality_bar: score >= 80 ? 'ZERO_ERRORS_F1_STANDARDS' : 'STANDARD',
+            slots_filled: filledSlots,
+            total_slots: totalSlots
+        }
+    };
+}
+/**
+ * Calculate a project's current .faf birth score
+ * @param projectPath - Path to project
+ * @returns Birth score (0-100)
+ */
+async function calculateBirthScore(projectPath) {
+    // TODO: Implement actual .faf file analysis
+    // This would:
+    // 1. Check if .faf exists
+    // 2. Parse the YAML
+    // 3. Count filled slots
+    // 4. Calculate score based on slot completeness
+    // For now, return placeholder
+    return 42;
+}
+//# sourceMappingURL=faf-generator.js.map

package/dist/big-orange/faf-generator.js.map

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

package/dist/big-orange/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * BIG ORANGE 🍊 - CLI Command
+ * Compare AI responses at different .faf scores
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/big-orange/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/big-orange/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * BIG ORANGE 🍊 - CLI Command
+ * Compare AI responses at different .faf scores
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const compare_1 = require("./compare");
+const bigo_push_1 = require("./bigo-push");
+const faf_generator_1 = require("./faf-generator");
+const open_1 = __importDefault(require("open"));
+const program = new commander_1.Command();
+program
+    .name('big-orange')
+    .description('🍊 Compare AI responses at different .faf context levels')
+    .version('1.0.0');
+program
+    .command('compare')
+    .description('Run side-by-side comparison')
+    .argument('[project-path]', 'Path to project to analyze', process.cwd())
+    .option('-l, --left <score>', 'Left window .faf score (0-100)', '0')
+    .option('-r, --right <score>', 'Right window .faf score (0-100)', '99')
+    .option('-p, --prompt <text>', 'Instruction to give both AI instances', 'Build me a color picker component')
+    .option('--no-visualize', 'Skip opening browser to view results')
+    .action(async (projectPath, options) => {
+    console.log('\n🍊 BIG ORANGE - Context Matters\n');
+    console.log('═'.repeat(60));
+    try {
+        // Parse scores
+        const leftScore = parseInt(options.left);
+        const rightScore = parseInt(options.right);
+        // Validate
+        if (isNaN(leftScore) || leftScore < 0 || leftScore > 100) {
+            throw new Error('Left score must be 0-100');
+        }
+        if (isNaN(rightScore) || rightScore < 0 || rightScore > 100) {
+            throw new Error('Right score must be 0-100');
+        }
+        // Analyze project (if path provided)
+        if (projectPath && projectPath !== process.cwd()) {
+            console.log(`\nAnalyzing project: ${projectPath}`);
+            const birthScore = await (0, faf_generator_1.calculateBirthScore)(projectPath);
+            console.log(`Birth score: ${birthScore}%`);
+        }
+        console.log('\n');
+        // Run comparison
+        const results = await (0, compare_1.compareContexts)({
+            projectPath,
+            leftScore,
+            rightScore,
+            prompt: options.prompt
+        });
+        // Push to Big🍊
+        console.log('Pushing to Big🍊...');
+        const url = await (0, bigo_push_1.pushToBigO)(results);
+        // Display results
+        console.log('\n═'.repeat(60));
+        console.log('\n✅ COMPARISON COMPLETE\n');
+        console.log(`Session ID: ${results.sessionId}`);
+        console.log(`\nResults:`);
+        console.log(`  Left (${leftScore}%): ${results.leftWindow.emoji} ${results.leftWindow.timeToComplete.toFixed(1)}s`);
+        console.log(`  Right (${rightScore}%): ${results.rightWindow.emoji} ${results.rightWindow.timeToComplete.toFixed(1)}s`);
+        console.log(`\nDelta: ${results.delta.verdict}`);
+        console.log(`\nView at: ${url}\n`);
+        // Open browser
+        if (options.visualize) {
+            console.log('Opening Big🍊 in browser...\n');
+            await (0, open_1.default)(url);
+        }
+    }
+    catch (error) {
+        console.error('\n❌ Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program
+    .command('demo')
+    .description('Run demo comparison with default settings')
+    .action(async () => {
+    console.log('\n🍊 Running Big Orange Demo\n');
+    const results = await (0, compare_1.compareContexts)({
+        leftScore: 0,
+        rightScore: 99,
+        prompt: 'Build me a color picker component'
+    });
+    const url = await (0, bigo_push_1.pushToBigO)(results);
+    console.log(`\n✅ Demo complete!\n`);
+    console.log(`View at: ${url}\n`);
+    await (0, open_1.default)(url);
+});
+program.parse();
+//# sourceMappingURL=index.js.map

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

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

package/dist/big-orange/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * BIG ORANGE 🍊 - Core Types
+ * Domain model for .faf context comparison
+ */
+export interface ProjectAnalysis {
+    path: string;
+    birthScore: number;
+    championshipScore: number;
+    gaps: Gap[];
+    timestamp: Date;
+}
+export interface Gap {
+    category: string;
+    severity: 'critical' | 'major' | 'minor';
+    description: string;
+    impact: string;
+}
+export interface ComparisonRequest {
+    projectPath?: string;
+    leftScore: number;
+    rightScore: number;
+    prompt: string;
+}
+export interface ComparisonResults {
+    sessionId: string;
+    timestamp: Date;
+    projectAnalysis?: ProjectAnalysis;
+    leftWindow: WindowResults;
+    rightWindow: WindowResults;
+    delta: DeltaMetrics;
+}
+export interface WindowResults {
+    fafScore: number;
+    aiResponse: string;
+    timeToComplete: number;
+    emoji: string;
+    fafMetadata?: {
+        filled: number;
+        total: number;
+        checksum: string;
+    };
+}
+export interface DeltaMetrics {
+    timeSaved: number;
+    scoreImprovement: number;
+    verdict: string;
+}
+export interface FafInstance {
+    score: number;
+    content: string;
+    metadata: {
+        framework?: string;
+        language?: string;
+        styling?: string;
+        patterns?: string[];
+        conventions?: string[];
+        quality_bar?: string;
+        slots_filled?: number;
+        total_slots?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/big-orange/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,EAAE,aAAa,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH"}

package/dist/big-orange/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * BIG ORANGE 🍊 - Core Types
+ * Domain model for .faf context comparison
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/big-orange/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

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')