faf-cli 2.1.0

package/dist/commands/init.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * 🚀 faf init - Initialization Command
+ * Generate .faf file from project structure with auto-detection
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initFafFile = initFafFile;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const YAML = __importStar(require("yaml"));
+const championship_style_1 = require("../utils/championship-style");
+const technical_credit_1 = require("../utils/technical-credit");
+const file_utils_1 = require("../utils/file-utils");
+const faf_generator_championship_1 = require("../generators/faf-generator-championship");
+const score_calculator_1 = require("../scoring/score-calculator");
+const fafignore_parser_1 = require("../utils/fafignore-parser");
+const balance_visualizer_1 = require("../utils/balance-visualizer");
+const faf_dna_1 = require("../engines/faf-dna");
+const fab_formats_processor_1 = require("../engines/fab-formats-processor");
+const platform_detector_1 = require("../utils/platform-detector");
+async function initFafFile(projectPath, options = {}) {
+    const startTime = Date.now();
+    // Show the FAF banner
+    const { generateFAFHeader } = require('../utils/championship-style');
+    console.log(generateFAFHeader());
+    try {
+        const projectRoot = projectPath || process.cwd();
+        const outputPath = options.output ? options.output : `${projectRoot}/.faf`;
+        // Check if .faf file already exists
+        if ((await (0, file_utils_1.fileExists)(outputPath)) && !options.force && !options.new && !options.choose) {
+            const username = require('os').userInfo().username;
+            console.log();
+            console.log(chalk_1.default.cyan.bold(`👋 Hi ${username}!`));
+            console.log();
+            console.log(chalk_1.default.green(`🤖 We found a .faf file at: `) + chalk_1.default.cyan(outputPath));
+            console.log(championship_style_1.FAF_COLORS.fafOrange(`💡 Do you want to use this one? Or run `) + chalk_1.default.cyan('faf init --new') + championship_style_1.FAF_COLORS.fafOrange(' to create a fresh one?'));
+            console.log();
+            return; // Don't exit, just return gracefully
+        }
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafCyan(`${championship_style_1.FAF_ICONS.rocket} Initializing .faf file...`));
+        // Check for .fafignore
+        const fafIgnorePath = path_1.default.join(projectRoot, ".fafignore");
+        if (!(await (0, file_utils_1.fileExists)(fafIgnorePath))) {
+            console.log(chalk_1.default.gray("   Creating .fafignore with default patterns..."));
+            await (0, fafignore_parser_1.createDefaultFafIgnore)(projectRoot);
+            console.log(chalk_1.default.green("   ☑️ Created .fafignore (customize to exclude files)"));
+        }
+        else {
+            console.log(chalk_1.default.gray("   Using existing .fafignore file"));
+        }
+        // Detect project structure
+        const projectType = options.template === "auto"
+            ? await (0, file_utils_1.detectProjectType)(projectRoot)
+            : options.template || (await (0, file_utils_1.detectProjectType)(projectRoot));
+        console.log(chalk_1.default.gray(`   Detected project type: ${projectType}`));
+        // Generate .faf content
+        const fafContent = await (0, faf_generator_championship_1.generateFafFromProject)({
+            projectType,
+            outputPath,
+            projectRoot: projectRoot,
+        });
+        // Write .faf file
+        await fs_1.promises.writeFile(outputPath, fafContent, "utf-8");
+        const elapsedTime = Date.now() - startTime;
+        console.log(chalk_1.default.green(`☑️ Created ${outputPath}`));
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafOrange('🤖 .faf = Foundational AI-context Format = THE JPEG for AI! 🧡⚡️'));
+        console.log(championship_style_1.FAF_COLORS.fafOrange('🧡 Trust: Context verified'));
+        console.log(championship_style_1.FAF_COLORS.fafCyan(`⚡️ Speed: Generated in ${elapsedTime}ms`));
+        console.log(championship_style_1.FAF_COLORS.fafGreen('SPEEDY AI you can TRUST!'));
+        console.log();
+        // Award technical credit for successful initialization
+        await (0, technical_credit_1.autoAwardCredit)('init_success', outputPath);
+        // REVOLUTIONARY: Score CLAUDE.md ONLY for birth weight!
+        // This is the TRUE starting point - what AI sees initially
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafCyan(`${championship_style_1.FAF_ICONS.magic_wand} Analyzing CLAUDE.md for birth weight...`));
+        const claudeMdPath = path_1.default.join(projectRoot, 'CLAUDE.md');
+        let birthWeight = 0;
+        let fromClaudeMD = false;
+        if (await (0, file_utils_1.fileExists)(claudeMdPath)) {
+            // Score ONLY CLAUDE.md for birth weight
+            const claudeMdContent = await fs_1.promises.readFile(claudeMdPath, 'utf-8');
+            const claudeMdAnalysis = await fab_formats_processor_1.fabFormatsProcessor.processFiles(projectRoot);
+            // Calculate birth weight from CLAUDE.md context quality
+            // Low scores are GOOD - they show the journey!
+            if (claudeMdContent.length < 100) {
+                birthWeight = 5; // Almost empty CLAUDE.md
+            }
+            else if (claudeMdContent.includes('FAF')) {
+                birthWeight = 22; // Has some FAF context
+            }
+            else {
+                birthWeight = 12; // Generic CLAUDE.md
+            }
+            fromClaudeMD = true;
+            console.log(championship_style_1.FAF_COLORS.fafOrange(`   Birth weight from CLAUDE.md: ${birthWeight}%`));
+            console.log(championship_style_1.FAF_COLORS.fafWhite(`   (Low scores are normal - they show your growth journey!)`));
+        }
+        else {
+            // No CLAUDE.md - use minimal birth weight
+            birthWeight = 0;
+            console.log(championship_style_1.FAF_COLORS.fafOrange(`   No CLAUDE.md found - birth weight: ${birthWeight}%`));
+        }
+        // Initialize FAF DNA with birth certificate
+        const dnaManager = new faf_dna_1.FafDNAManager(projectRoot);
+        const dna = await dnaManager.birth(birthWeight, fromClaudeMD);
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafGreen(`${championship_style_1.FAF_ICONS.dna} FAF DNA created with birth certificate!`));
+        console.log(championship_style_1.FAF_COLORS.fafWhite(`   Certificate: ${dna.birthCertificate.certificate}`));
+        // Now calculate ACTUAL score from full .faf
+        const fafData = YAML.parse(fafContent);
+        const scoreResult = await (0, score_calculator_1.calculateFafScore)(fafData, outputPath);
+        const currentScore = fafData.faf_score ? parseInt(fafData.faf_score.replace('%', '')) : scoreResult.totalScore;
+        // Record first growth if different from birth weight
+        if (currentScore !== birthWeight) {
+            await dnaManager.recordGrowth(currentScore, ['Initial .faf generation from project']);
+        }
+        // Display with birth weight
+        console.log();
+        (0, faf_dna_1.displayScoreWithBirthWeight)(currentScore, birthWeight, dna.birthCertificate.born, { showGrowth: true });
+        // Show AI|HUMAN Balance
+        const balance = balance_visualizer_1.BalanceVisualizer.calculateBalance(fafData);
+        console.log(championship_style_1.FAF_COLORS.fafWhite(`${championship_style_1.FAF_ICONS.balance} Balance: `) + balance_visualizer_1.BalanceVisualizer.generateCompactBalance(balance));
+        // Detect platform and show VIBE message if applicable
+        const platformDetector = new platform_detector_1.PlatformDetector();
+        const platformInfo = await platformDetector.detectPlatform(projectRoot);
+        if (platformInfo.detected && platformInfo.tier === 'vibe') {
+            console.log();
+            console.log(championship_style_1.FAF_COLORS.fafOrange('⚡️ FAF VIBE DETECTED! 😽'));
+            console.log(championship_style_1.FAF_COLORS.fafCyan(`   Platform: ${platformInfo.platform}`));
+            console.log(championship_style_1.FAF_COLORS.fafGreen(`   Special pricing: $9/month FOREVER!`));
+            console.log(championship_style_1.FAF_COLORS.fafWhite(`   ${championship_style_1.FAF_ICONS.turbo_cat} TURBO-CAT is ready to make your AI happy!`));
+        }
+        // Championship Next Steps with DNA lifecycle
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafOrange(`${championship_style_1.FAF_ICONS.magic_wand} Championship Recommendations:`));
+        console.log(`${championship_style_1.FAF_COLORS.fafCyan('   1. ')}faf auth${championship_style_1.FAF_COLORS.fafCyan(' - Authenticate your FAF DNA')}`);
+        console.log(`${championship_style_1.FAF_COLORS.fafCyan('   2. ')}faf auto${championship_style_1.FAF_COLORS.fafCyan(' - Grow your context automatically')}`);
+        console.log(`${championship_style_1.FAF_COLORS.fafCyan('   3. ')}faf score --details${championship_style_1.FAF_COLORS.fafCyan(' - Track improvement opportunities')}`);
+        console.log(`${championship_style_1.FAF_COLORS.fafCyan('   4. ')}faf trust --detailed${championship_style_1.FAF_COLORS.fafCyan(' - Boost AI happiness')}`);
+        console.log(`${championship_style_1.FAF_COLORS.fafCyan('   5. ')}faf log${championship_style_1.FAF_COLORS.fafCyan(' - View your context evolution')}`);
+        // Growth-focused messaging
+        const growth = currentScore - birthWeight;
+        if (growth > 0) {
+            console.log();
+            console.log(championship_style_1.FAF_COLORS.fafGreen(`${championship_style_1.FAF_ICONS.rocket} Already improved +${growth}% from birth weight!`));
+        }
+        if (currentScore < 70) {
+            console.log(championship_style_1.FAF_COLORS.fafOrange(`   ${championship_style_1.FAF_ICONS.precision} Target 70%+ for championship AI context`));
+        }
+        else if (currentScore >= 85) {
+            console.log(championship_style_1.FAF_COLORS.fafGreen(`${championship_style_1.FAF_ICONS.party} Championship performance achieved! ${championship_style_1.FAF_ICONS.trophy}`));
+        }
+        console.log();
+        console.log(championship_style_1.FAF_COLORS.fafWhite(`Your FAF journey has begun: ${birthWeight}% → ${currentScore}%`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red("💥 Initialization failed:"));
+        console.log(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/lint.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 🔧 faf lint - Lint Command
+ * Format compliance and style checking for .faf files
+ */
+interface LintOptions {
+    fix?: boolean;
+    schemaVersion?: string;
+}
+export declare function lintFafFile(file?: string, options?: LintOptions): Promise<void>;
+export {};
+//# sourceMappingURL=lint.d.ts.map

package/dist/commands/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,iBAmIzE"}

package/dist/commands/lint.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * 🔧 faf lint - Lint Command
+ * Format compliance and style checking for .faf files
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lintFafFile = lintFafFile;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+const YAML = __importStar(require("yaml"));
+const file_utils_1 = require("../utils/file-utils");
+const faf_schema_1 = require("../schema/faf-schema");
+async function lintFafFile(file, options = {}) {
+    try {
+        const fafPath = file || (await (0, file_utils_1.findFafFile)());
+        if (!fafPath) {
+            console.log(chalk_1.default.red("❌ No .faf file found"));
+            console.log(chalk_1.default.yellow('💡 Run "faf init" to create one'));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.blue(`🔧 Linting: ${fafPath}`));
+        // Read .faf file
+        const content = await fs_1.promises.readFile(fafPath, "utf-8");
+        // Parse and analyze
+        let fafData;
+        const issues = [];
+        try {
+            fafData = YAML.parse(content);
+        }
+        catch (parseError) {
+            issues.push({
+                type: "error",
+                message: `YAML parsing error: ${parseError}`,
+                fixable: false,
+            });
+            console.log(chalk_1.default.red("❌ Failed to parse .faf file"));
+            console.log(chalk_1.default.red(parseError instanceof Error ? parseError.message : String(parseError)));
+            process.exit(1);
+        }
+        // Run schema validation first
+        const validation = (0, faf_schema_1.validateSchema)(fafData, options.schemaVersion);
+        // Convert validation results to lint issues
+        validation.errors.forEach((error) => {
+            issues.push({
+                type: "error",
+                message: error.message,
+                fixable: false,
+            });
+        });
+        validation.warnings.forEach((warning) => {
+            issues.push({
+                type: "warning",
+                message: warning.message,
+                fixable: false,
+            });
+        });
+        // Additional lint checks
+        performFormatLinting(fafData, content, issues);
+        performStyleLinting(fafData, issues);
+        performBestPracticeLinting(fafData, issues);
+        // Display results
+        const errors = issues.filter((i) => i.type === "error");
+        const warnings = issues.filter((i) => i.type === "warning");
+        const info = issues.filter((i) => i.type === "info");
+        const fixableIssues = issues.filter((i) => i.fixable);
+        if (errors.length === 0 && warnings.length === 0 && info.length === 0) {
+            console.log(chalk_1.default.green("☑️ No linting issues found"));
+            return;
+        }
+        // Show issues by type
+        if (errors.length > 0) {
+            console.log(chalk_1.default.red(`\n❌ ${errors.length} Error(s):`));
+            errors.forEach((error, index) => {
+                console.log(chalk_1.default.red(`   ${index + 1}. ${error.message}`));
+            });
+        }
+        if (warnings.length > 0) {
+            console.log(chalk_1.default.yellow(`\n⚠️  ${warnings.length} Warning(s):`));
+            warnings.forEach((warning, index) => {
+                console.log(chalk_1.default.yellow(`   ${index + 1}. ${warning.message}`));
+            });
+        }
+        if (info.length > 0) {
+            console.log(chalk_1.default.blue(`\n💡 ${info.length} Suggestion(s):`));
+            info.forEach((suggestion, index) => {
+                console.log(chalk_1.default.blue(`   ${index + 1}. ${suggestion.message}`));
+            });
+        }
+        // Auto-fix if requested
+        if (options.fix && fixableIssues.length > 0) {
+            console.log(chalk_1.default.blue(`\n🔧 Auto-fixing ${fixableIssues.length} issue(s)...`));
+            fixableIssues.forEach((issue) => {
+                if (issue.fix) {
+                    issue.fix();
+                }
+            });
+            // Write fixed content
+            const fixedContent = YAML.stringify(fafData, { lineWidth: 100 });
+            await fs_1.promises.writeFile(fafPath, fixedContent, "utf-8");
+            console.log(chalk_1.default.green("☑️ Auto-fixes applied"));
+        }
+        else if (fixableIssues.length > 0) {
+            console.log(chalk_1.default.yellow(`\n💡 ${fixableIssues.length} issue(s) can be auto-fixed with --fix`));
+        }
+        // Exit with error code if there are errors
+        if (errors.length > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.log(chalk_1.default.red("💥 Linting failed:"));
+        console.log(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+}
+function performFormatLinting(fafData, content, issues) {
+    // Check YAML formatting
+    try {
+        const normalizedYaml = YAML.stringify(fafData, { lineWidth: 100 });
+        const currentLines = content.split("\n").map((line) => line.trimEnd());
+        const normalizedLines = normalizedYaml
+            .split("\n")
+            .map((line) => line.trimEnd());
+        if (currentLines.length !== normalizedLines.length) {
+            issues.push({
+                type: "info",
+                message: "YAML formatting could be improved",
+                fixable: true,
+                fix: () => {
+                    // Fix will be applied in the main function
+                },
+            });
+        }
+    }
+    catch {
+        // Skip formatting check if there are parsing issues
+    }
+    // Check for trailing whitespace
+    const lines = content.split("\n");
+    lines.forEach((line, index) => {
+        if (line.length > 0 && line !== line.trimEnd()) {
+            issues.push({
+                type: "warning",
+                message: `Trailing whitespace on line ${index + 1}`,
+                line: index + 1,
+                fixable: true,
+            });
+        }
+    });
+}
+function performStyleLinting(fafData, issues) {
+    // Check for consistent naming
+    if (fafData.project?.name && fafData.project.name.includes("_")) {
+        issues.push({
+            type: "info",
+            message: "Project name contains underscores - consider kebab-case",
+            fixable: false,
+        });
+    }
+    // Check score consistency
+    if (fafData.scores) {
+        const fafScore = fafData.scores.faf_score;
+        const slotPercentage = fafData.scores.slot_based_percentage;
+        if (typeof fafScore === "number" && typeof slotPercentage === "number") {
+            const expectedSlots = Math.round((fafScore / 100) * 21);
+            if (Math.abs(slotPercentage - expectedSlots) > 2) {
+                issues.push({
+                    type: "warning",
+                    message: "Slot-based percentage may be inconsistent with faf_score",
+                    fixable: false,
+                });
+            }
+        }
+    }
+}
+function performBestPracticeLinting(fafData, issues) {
+    // Check for AI instructions
+    if (!fafData.ai_instructions || !fafData.ai_instructions.message) {
+        issues.push({
+            type: "info",
+            message: "Consider adding ai_instructions section for better AI context",
+            fixable: false,
+        });
+    }
+    // Check for human context
+    if (!fafData.human_context) {
+        issues.push({
+            type: "info",
+            message: "Consider adding human_context section (who/what/why/where/when/how)",
+            fixable: false,
+        });
+    }
+    // Check timestamp freshness
+    if (fafData.generated) {
+        try {
+            const generated = new Date(fafData.generated);
+            const daysSince = (Date.now() - generated.getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSince > 30) {
+                issues.push({
+                    type: "warning",
+                    message: `Generated timestamp is ${Math.round(daysSince)} days old - consider updating`,
+                    fixable: true,
+                    fix: () => {
+                        fafData.generated = new Date().toISOString();
+                    },
+                });
+            }
+        }
+        catch {
+            issues.push({
+                type: "warning",
+                message: "Invalid generated timestamp format",
+                fixable: true,
+                fix: () => {
+                    fafData.generated = new Date().toISOString();
+                },
+            });
+        }
+    }
+    // Check for empty sections
+    Object.entries(fafData).forEach(([key, value]) => {
+        if (typeof value === "object" &&
+            value !== null &&
+            Object.keys(value).length === 0) {
+            issues.push({
+                type: "warning",
+                message: `Empty section detected: ${key}`,
+                fixable: false,
+            });
+        }
+    });
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/mirror.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * 🔄 Mirror Command - Context-Mirroring (Bi-sync)
+ * Part of the .faf flow: Get .faffed → Mirror → Commit
+ */
+export declare function mirrorCommand(targetPath?: string): Promise<void>;
+//# sourceMappingURL=mirror.d.ts.map

package/dist/commands/mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/commands/mirror.ts"],"names":[],"mappings":";AACA;;;GAGG;AASH,wBAAsB,aAAa,CAAC,UAAU,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG3E"}

package/dist/commands/mirror.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * 🔄 Mirror Command - Context-Mirroring (Bi-sync)
+ * Part of the .faf flow: Get .faffed → Mirror → Commit
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mirrorCommand = mirrorCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const YAML = __importStar(require("yaml"));
+async function mirrorCommand(targetPath = '.') {
+    console.log(chalk_1.default.bold.hex('#FF6B35')('\n🔄 Mirroring Context (Bi-sync with CLAUDE.md)...\n'));
+    const absolutePath = path.resolve(targetPath);
+    try {
+        // Check for .faf file
+        const fafPath = path.join(absolutePath, '.faf');
+        if (!fs.existsSync(fafPath)) {
+            console.error(chalk_1.default.red('❌ No .faf file found. Run "faf init" first.'));
+            process.exit(1);
+        }
+        // Check for CLAUDE.md
+        const claudePath = path.join(absolutePath, 'CLAUDE.md');
+        const hasClaudeMd = fs.existsSync(claudePath);
+        if (!hasClaudeMd) {
+            console.log(chalk_1.default.yellow('📝 Creating CLAUDE.md from .faf...'));
+            // Read .faf and create CLAUDE.md
+            const fafContent = fs.readFileSync(fafPath, 'utf-8');
+            const fafData = YAML.parse(fafContent);
+            const claudeContent = `# 🧡⚡️ CLAUDE.md - AI Context Mirror
+## Generated from .faf - The JPEG for AI™
+
+### Project: ${fafData.project?.name || 'Unknown'}
+**Stack**: ${fafData.instant_context?.tech_stack || fafData.project?.main_language || 'Unknown'}
+**Goal**: ${fafData.project?.goal || fafData.instant_context?.what_building || 'Unknown'}
+
+### AI Context
+${YAML.stringify(fafData.instant_context || {}, null, 2)}
+
+### Quality Status
+- **AI Score**: ${fafData.ai_score || 'Not calculated'}
+- **Confidence**: ${fafData.ai_confidence || 'Unknown'}
+- **Handoff Ready**: ${fafData.context_quality?.handoff_ready || false}
+
+---
+*Synced with .faf via Context-Mirroring™*
+*Last sync: ${new Date().toISOString()}*
+`;
+            fs.writeFileSync(claudePath, claudeContent);
+            console.log(chalk_1.default.green('✅ CLAUDE.md created!'));
+        }
+        // Perform bi-directional sync
+        console.log(chalk_1.default.cyan('🔄 Performing bi-directional sync...'));
+        // Read both files
+        const fafContent = fs.readFileSync(fafPath, 'utf-8');
+        const claudeContent = fs.readFileSync(claudePath, 'utf-8');
+        const fafData = YAML.parse(fafContent);
+        // Update sync metadata
+        if (!fafData.sync_metadata) {
+            fafData.sync_metadata = {};
+        }
+        fafData.sync_metadata.last_mirror = new Date().toISOString();
+        fafData.sync_metadata.claude_md_synced = true;
+        fafData.sync_metadata.mirror_version = '2.0';
+        // Update AI score for mirroring
+        if (fafData.ai_score && fafData.ai_score.includes('%')) {
+            const currentScore = parseInt(fafData.ai_score);
+            if (currentScore < 95) {
+                fafData.ai_score = '95%';
+                console.log(chalk_1.default.green('📈 AI Score increased to 95% (Context Mirrored)'));
+            }
+        }
+        // Write updated .faf
+        const updatedYaml = YAML.stringify(fafData, null, 2);
+        fs.writeFileSync(fafPath, updatedYaml);
+        // Update CLAUDE.md footer
+        const syncFooter = `\n---\n*Context-Mirroring™ Active*\n*Last sync: ${new Date().toISOString()}*\n*Status: Bi-directional sync established*\n`;
+        if (!claudeContent.includes('Context-Mirroring™ Active')) {
+            fs.appendFileSync(claudePath, syncFooter);
+        }
+        console.log(chalk_1.default.green('\n✅ Context Mirrored Successfully!'));
+        console.log(chalk_1.default.cyan('  • .faf ↔️ CLAUDE.md synced'));
+        console.log(chalk_1.default.cyan('  • Bi-directional updates enabled'));
+        console.log(chalk_1.default.cyan('  • AI score: 95%'));
+        console.log(chalk_1.default.bold.hex('#FF6B35')('\n💡 Next step: Run "faf commit" to lock in excellence at 99%+\n'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Mirror failed:'), error);
+        console.error(chalk_1.default.yellow('\nTry running "faf bi-sync" for detailed sync.'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=mirror.js.map