faf-mcp 1.0.0

package/dist/src/faf-core/commands/innit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 🇬🇧 faf innit - British Init Command (Mk3 Bundled)
+ * "Innit bruv" - Initialize with style
+ */
+import { InitOptions, InitResult } from './init';
+export { InitOptions, InitResult };
+export declare function innitFafFile(projectPath?: string, options?: InitOptions): Promise<InitResult>;

package/dist/src/faf-core/commands/innit.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * 🇬🇧 faf innit - British Init Command (Mk3 Bundled)
+ * "Innit bruv" - Initialize with style
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.innitFafFile = innitFafFile;
+const init_1 = require("./init");
+async function innitFafFile(projectPath, options = {}) {
+    // Just delegate to init - same functionality, British flavor
+    return (0, init_1.initFafFile)(projectPath, options);
+}
+//# sourceMappingURL=innit.js.map

package/dist/src/faf-core/commands/innit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"innit.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/innit.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,oCAGC;AAPD,iCAA8D;AAIvD,KAAK,UAAU,YAAY,CAAC,WAAoB,EAAE,UAAuB,EAAE;IAChF,6DAA6D;IAC7D,OAAO,IAAA,kBAAW,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/src/faf-core/commands/migrate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 🔄 faf migrate - Migrate legacy .faf to project.faf (Mk3 Bundled)
+ */
+export interface MigrateOptions {
+    force?: boolean;
+    json?: boolean;
+}
+export interface MigrateResult {
+    success: boolean;
+    migrated: boolean;
+    from?: string;
+    to?: string;
+    message: string;
+}
+export declare function migrateFafFile(projectPath?: string, options?: MigrateOptions): Promise<MigrateResult>;

package/dist/src/faf-core/commands/migrate.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * 🔄 faf migrate - Migrate legacy .faf to project.faf (Mk3 Bundled)
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateFafFile = migrateFafFile;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const file_utils_1 = require("../utils/file-utils");
+async function migrateFafFile(projectPath, options = {}) {
+    try {
+        const projectRoot = projectPath || process.cwd();
+        const legacyPath = path.join(projectRoot, '.faf');
+        const newPath = path.join(projectRoot, 'project.faf');
+        // Check if legacy file exists
+        if (!await (0, file_utils_1.fileExists)(legacyPath)) {
+            return {
+                success: true,
+                migrated: false,
+                message: 'No legacy .faf file found - nothing to migrate'
+            };
+        }
+        // Check if new file already exists
+        if (await (0, file_utils_1.fileExists)(newPath) && !options.force) {
+            return {
+                success: false,
+                migrated: false,
+                message: 'project.faf already exists. Use --force to overwrite.'
+            };
+        }
+        // Read legacy file
+        const content = await fs_1.promises.readFile(legacyPath, 'utf-8');
+        // Write to new location
+        await fs_1.promises.writeFile(newPath, content, 'utf-8');
+        // Delete legacy file (optional - could keep as backup)
+        // await fs.unlink(legacyPath);
+        return {
+            success: true,
+            migrated: true,
+            from: legacyPath,
+            to: newPath,
+            message: 'Successfully migrated .faf to project.faf'
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            migrated: false,
+            message: error instanceof Error ? error.message : 'Migration failed'
+        };
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/src/faf-core/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/migrate.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBH,wCAgDC;AAjED,2BAAoC;AACpC,2CAA6B;AAC7B,oDAAiD;AAe1C,KAAK,UAAU,cAAc,CAAC,WAAoB,EAAE,UAA0B,EAAE;IACrF,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAEtD,8BAA8B;QAC9B,IAAI,CAAC,MAAM,IAAA,uBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,gDAAgD;aAC1D,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,MAAM,IAAA,uBAAU,EAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,uDAAuD;aACjE,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEvD,wBAAwB;QACxB,MAAM,aAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE9C,uDAAuD;QACvD,+BAA+B;QAE/B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO;YACX,OAAO,EAAE,2CAA2C;SACrD,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;SACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/faf-core/commands/quick.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ⚡ FAF Quick - Lightning-fast .faf creation (Mk3 Bundled)
+ * One-liner format for instant context generation
+ */
+interface QuickOptions {
+    force?: boolean;
+    json?: boolean;
+}
+export interface QuickResult {
+    success: boolean;
+    created: boolean;
+    filePath?: string;
+    message: string;
+}
+export declare function quickCommand(projectPath: string, input?: string, options?: QuickOptions): Promise<QuickResult>;
+export {};

package/dist/src/faf-core/commands/quick.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * ⚡ FAF Quick - Lightning-fast .faf creation (Mk3 Bundled)
+ * One-liner format for instant context generation
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quickCommand = quickCommand;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const yaml_1 = require("../fix-once/yaml");
+const file_utils_1 = require("../utils/file-utils");
+/**
+ * Quick format parser - accepts simple comma-separated values
+ * Format: "project name, what it does, main language, framework, where deployed"
+ */
+function parseQuickInput(input) {
+    if (!input) {
+        return {
+            projectName: 'my-project',
+            projectGoal: 'Build amazing software',
+            mainLanguage: 'TypeScript',
+            framework: 'none',
+            hosting: 'cloud',
+            slotBasedPercentage: 50,
+            fafScore: 50
+        };
+    }
+    const parts = input.split(',').map(s => s.trim());
+    return {
+        projectName: parts[0] || 'my-project',
+        projectGoal: parts[1] || 'Build amazing software',
+        mainLanguage: parts[2] || 'TypeScript',
+        framework: parts[3] || 'none',
+        hosting: parts[4] || 'cloud',
+        slotBasedPercentage: 60,
+        fafScore: 60
+    };
+}
+async function quickCommand(projectPath, input, options = {}) {
+    try {
+        const fafPath = path.join(projectPath, 'project.faf');
+        // Check if file exists
+        if (await (0, file_utils_1.fileExists)(fafPath) && !options.force) {
+            return {
+                success: false,
+                created: false,
+                message: 'project.faf already exists. Use --force to overwrite.'
+            };
+        }
+        // Parse input
+        const parsed = parseQuickInput(input);
+        // Generate quick .faf file
+        const fafData = {
+            faf_version: '2.5.0',
+            ai_scoring_system: '2025-09-20',
+            ai_score: `${parsed.fafScore}%`,
+            ai_confidence: 'MEDIUM',
+            ai_value: '30_seconds_replaces_20_minutes_of_questions',
+            ai_tldr: {
+                project: `${parsed.projectName} - ${parsed.projectGoal}`,
+                stack: `${parsed.mainLanguage}/${parsed.framework}`,
+                quality_bar: 'ZERO_ERRORS_F1_STANDARDS',
+                current_focus: 'Quick start - ready to build',
+                your_role: 'Build features with context'
+            },
+            instant_context: {
+                what_building: parsed.projectGoal,
+                tech_stack: `${parsed.mainLanguage}/${parsed.framework}`,
+                main_language: parsed.mainLanguage,
+                deployment: parsed.hosting,
+                key_files: ['package.json', 'README.md']
+            },
+            context_quality: {
+                slots_filled: '12/21 (57%)',
+                ai_confidence: 'MEDIUM',
+                handoff_ready: true,
+                missing_context: ['CI/CD pipeline', 'Database', 'Testing strategy']
+            },
+            project: {
+                name: parsed.projectName,
+                goal: parsed.projectGoal,
+                main_language: parsed.mainLanguage,
+                generated: new Date().toISOString(),
+                mission: '🚀 Make Your AI Happy! 🧡 Trust-Driven 🤖',
+                revolution: '30 seconds replaces 20 minutes of questions',
+                brand: 'F1-Inspired Software Engineering - Championship AI Context',
+                version: '1.0.0',
+                type: parsed.framework.toLowerCase()
+            },
+            stack: {
+                frontend: parsed.framework !== 'none' ? parsed.framework : 'None',
+                css_framework: 'None',
+                ui_library: 'None',
+                state_management: 'None',
+                backend: 'Node.js',
+                runtime: 'Node.js',
+                database: 'None',
+                build: 'Vite',
+                package_manager: 'npm',
+                api_type: 'REST',
+                hosting: parsed.hosting,
+                cicd: 'None',
+                testing: 'None',
+                language: parsed.mainLanguage
+            },
+            preferences: {
+                quality_bar: 'zero_errors',
+                commit_style: 'conventional_emoji',
+                response_style: 'concise_code_first',
+                explanation_level: 'minimal',
+                communication: 'direct',
+                testing: 'required',
+                documentation: 'as_needed'
+            },
+            state: {
+                phase: 'development',
+                version: '1.0.0',
+                focus: 'quick_start',
+                status: 'green_flag',
+                next_milestone: 'first_feature',
+                blockers: null
+            },
+            tags: {
+                auto_generated: [parsed.projectName.toLowerCase(), parsed.mainLanguage.toLowerCase()],
+                smart_defaults: ['.faf', 'ai-ready', '2025', 'quick-start'],
+                user_defined: null
+            },
+            meta: {
+                last_enhanced: new Date().toISOString(),
+                enhanced_by: 'faf-quick-command'
+            }
+        };
+        // Write file
+        const yamlContent = (0, yaml_1.stringify)(fafData);
+        await fs_1.promises.writeFile(fafPath, yamlContent, 'utf-8');
+        return {
+            success: true,
+            created: true,
+            filePath: fafPath,
+            message: `⚡ Created project.faf at ${fafPath} - Score: ${parsed.fafScore}%`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            created: false,
+            message: error instanceof Error ? error.message : 'Quick command failed'
+        };
+    }
+}
+//# sourceMappingURL=quick.js.map

package/dist/src/faf-core/commands/quick.js.map

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

package/dist/src/faf-core/commands/score.d.ts

@@ -0,0 +1,47 @@
+/**
+ * faf score - Programmatic API (MCP-ready)
+ * No console output, returns structured data
+ */
+import { CompilationResult } from '../compiler/faf-compiler.js';
+export interface ScoreOptions {
+    json?: boolean;
+    trace?: boolean;
+    verify?: boolean;
+    breakdown?: boolean;
+    checksum?: string;
+}
+export interface ScoreResult {
+    score: number;
+    filled: number;
+    total: number;
+    breakdown: {
+        project: {
+            filled: number;
+            total: number;
+            percentage: number;
+        };
+        stack: {
+            filled: number;
+            total: number;
+            percentage: number;
+        };
+        human: {
+            filled: number;
+            total: number;
+            percentage: number;
+        };
+        discovery: {
+            filled: number;
+            total: number;
+            percentage: number;
+        };
+    };
+    trace?: CompilationResult['trace'];
+    diagnostics?: CompilationResult['diagnostics'];
+    checksum?: string;
+}
+/**
+ * Score a .faf file - programmatic API
+ * Returns structured data, no console output
+ */
+export declare function scoreFafFile(file?: string, options?: ScoreOptions): Promise<ScoreResult>;

package/dist/src/faf-core/commands/score.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * faf score - Programmatic API (MCP-ready)
+ * No console output, returns structured data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreFafFile = scoreFafFile;
+const faf_compiler_js_1 = require("../compiler/faf-compiler.js");
+const file_utils_js_1 = require("../utils/file-utils.js");
+/**
+ * Score a .faf file - programmatic API
+ * Returns structured data, no console output
+ */
+async function scoreFafFile(file, options = {}) {
+    // Find .faf file
+    const fafPath = file || await (0, file_utils_js_1.findFafFile)(process.cwd());
+    if (!fafPath) {
+        throw new Error('No .faf file found');
+    }
+    // Create compiler
+    const compiler = new faf_compiler_js_1.FafCompiler();
+    // Compile with or without trace
+    const result = options.trace
+        ? await compiler.compileWithTrace(fafPath)
+        : await compiler.compile(fafPath);
+    // Verify checksum if provided
+    if (options.checksum && result.checksum !== options.checksum) {
+        throw new Error(`Checksum mismatch: expected ${options.checksum}, got ${result.checksum}`);
+    }
+    // Return structured data
+    const scoreResult = {
+        score: result.score,
+        filled: result.filled,
+        total: result.total,
+        breakdown: result.breakdown,
+    };
+    // Add optional fields
+    if (options.trace) {
+        scoreResult.trace = result.trace;
+    }
+    if (options.breakdown && result.diagnostics.length > 0) {
+        scoreResult.diagnostics = result.diagnostics;
+    }
+    if (options.checksum || options.verify) {
+        scoreResult.checksum = result.checksum;
+    }
+    return scoreResult;
+}
+//# sourceMappingURL=score.js.map

package/dist/src/faf-core/commands/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/score.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAgDH,oCA2CC;AAzFD,iEAA6E;AAC7E,0DAAqD;AAyCrD;;;GAGG;AACI,KAAK,UAAU,YAAY,CAAC,IAAa,EAAE,UAAwB,EAAE;IAC1E,iBAAiB;IACjB,MAAM,OAAO,GAAG,IAAI,IAAI,MAAM,IAAA,2BAAW,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,IAAI,6BAAW,EAAE,CAAC;IAEnC,gCAAgC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;QAC1B,CAAC,CAAC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpC,8BAA8B;IAC9B,IAAI,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAgB;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IAEF,sBAAsB;IACtB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACvC,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACzC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/src/faf-core/commands/sync.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 🔄 faf sync - Sync Command (Mk3 Bundled)
+ * Sync project.faf file with project changes (package.json, git, etc.)
+ */
+export interface SyncOptions {
+    auto?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    changesDetected: number;
+    changesApplied: number;
+    message: string;
+}
+export declare function syncFafFile(projectPath?: string, options?: SyncOptions): Promise<SyncResult>;

package/dist/src/faf-core/commands/sync.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * 🔄 faf sync - Sync Command (Mk3 Bundled)
+ * Sync project.faf file with project changes (package.json, git, etc.)
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncFafFile = syncFafFile;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const yaml_1 = require("../fix-once/yaml");
+const file_utils_1 = require("../utils/file-utils");
+async function syncFafFile(projectPath, options = {}) {
+    try {
+        const fafPath = projectPath ? path.join(projectPath, 'project.faf') : await (0, file_utils_1.findFafFile)();
+        if (!fafPath || !await (0, file_utils_1.fileExists)(fafPath)) {
+            return {
+                success: false,
+                changesDetected: 0,
+                changesApplied: 0,
+                message: 'No project.faf file found. Run faf init first.'
+            };
+        }
+        // Read current .faf file
+        const content = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(content);
+        // Detect changes
+        const changes = await detectProjectChanges(fafData, path.dirname(fafPath));
+        if (changes.length === 0) {
+            return {
+                success: true,
+                changesDetected: 0,
+                changesApplied: 0,
+                message: 'project.faf file is up to date'
+            };
+        }
+        if (options.dryRun) {
+            return {
+                success: true,
+                changesDetected: changes.length,
+                changesApplied: 0,
+                message: `Found ${changes.length} potential updates (dry run - no changes applied)`
+            };
+        }
+        // Apply changes if auto mode
+        if (options.auto) {
+            applyChanges(fafData, changes);
+            // Update generated timestamp
+            if (!fafData.meta)
+                fafData.meta = {};
+            fafData.meta.last_sync = new Date().toISOString();
+            // Write updated .faf file
+            const updatedContent = (0, yaml_1.stringify)(fafData);
+            await fs_1.promises.writeFile(fafPath, updatedContent, 'utf-8');
+            return {
+                success: true,
+                changesDetected: changes.length,
+                changesApplied: changes.length,
+                message: `Applied ${changes.length} changes to project.faf`
+            };
+        }
+        return {
+            success: true,
+            changesDetected: changes.length,
+            changesApplied: 0,
+            message: `Found ${changes.length} potential updates. Run with --auto to apply.`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            changesDetected: 0,
+            changesApplied: 0,
+            message: error instanceof Error ? error.message : 'Sync failed'
+        };
+    }
+}
+async function detectProjectChanges(fafData, projectRoot) {
+    const changes = [];
+    try {
+        // Check package.json changes
+        const packageJsonPath = path.join(projectRoot, 'package.json');
+        if (await (0, file_utils_1.fileExists)(packageJsonPath)) {
+            const packageContent = await fs_1.promises.readFile(packageJsonPath, 'utf-8');
+            const packageData = JSON.parse(packageContent);
+            // Project name change
+            if (packageData.name && packageData.name !== fafData.project?.name) {
+                changes.push({
+                    path: 'project.name',
+                    description: 'Project name changed in package.json',
+                    oldValue: fafData.project?.name || 'undefined',
+                    newValue: packageData.name,
+                    confidence: 'high'
+                });
+            }
+            // Description/goal change
+            if (packageData.description && packageData.description !== fafData.project?.goal) {
+                changes.push({
+                    path: 'project.goal',
+                    description: 'Project description changed in package.json',
+                    oldValue: fafData.project?.goal || 'undefined',
+                    newValue: packageData.description,
+                    confidence: 'medium'
+                });
+            }
+            // Dependencies changes - detect frameworks
+            const deps = {
+                ...packageData.dependencies,
+                ...packageData.devDependencies
+            };
+            // Check for framework changes
+            if (deps.svelte && !fafData.stack?.frontend?.includes('Svelte')) {
+                changes.push({
+                    path: 'stack.frontend',
+                    description: 'Svelte dependency detected',
+                    oldValue: fafData.stack?.frontend || '',
+                    newValue: 'Svelte',
+                    confidence: 'high'
+                });
+            }
+            if (deps.react && !fafData.stack?.frontend?.includes('React')) {
+                changes.push({
+                    path: 'stack.frontend',
+                    description: 'React dependency detected',
+                    oldValue: fafData.stack?.frontend || '',
+                    newValue: 'React',
+                    confidence: 'high'
+                });
+            }
+            if (deps.vue && !fafData.stack?.frontend?.includes('Vue')) {
+                changes.push({
+                    path: 'stack.frontend',
+                    description: 'Vue dependency detected',
+                    oldValue: fafData.stack?.frontend || '',
+                    newValue: 'Vue',
+                    confidence: 'high'
+                });
+            }
+        }
+        // Check if generated timestamp is very old (30+ days)
+        if (fafData.meta?.generated) {
+            const generatedDate = new Date(fafData.meta.generated);
+            const daysSince = Math.abs(Date.now() - generatedDate.getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSince > 30) {
+                changes.push({
+                    path: 'meta.generated',
+                    description: `Generated timestamp is ${Math.round(daysSince)} days old`,
+                    oldValue: fafData.meta.generated,
+                    newValue: new Date().toISOString(),
+                    confidence: 'high'
+                });
+            }
+        }
+    }
+    catch {
+        // Continue with what we have
+    }
+    return changes;
+}
+function applyChanges(fafData, changes) {
+    changes.forEach(change => {
+        if (change.confidence === 'high' || change.confidence === 'medium') {
+            setNestedValue(fafData, change.path, change.newValue);
+        }
+    });
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!current[parts[i]]) {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+//# sourceMappingURL=sync.js.map