faf-cli 4.4.2 → 4.5.0

package/dist/utils/cursorrules-parser.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * .cursorrules Parser
+ *
+ * Parses Cursor IDE .cursorrules files for bidirectional
+ * interoperability with FAF.
+ *
+ * .cursorrules Structure:
+ * - Free-form markdown with sections
+ * - H2: Section headers (optional)
+ * - Bullets/paragraphs: Guidelines and rules
+ *
+ * Note: This generates legacy .cursorrules (single file).
+ * The new .cursor/rules/ MDC directory format is a future enhancement.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCursorRules = parseCursorRules;
+exports.cursorImport = cursorImport;
+exports.cursorExport = cursorExport;
+exports.detectCursorRules = detectCursorRules;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse .cursorrules file content
+ */
+function parseCursorRules(content) {
+    // Strip BOM and normalize line endings (Windows \r\n, old Mac \r)
+    const normalized = content.replace(/^\uFEFF/, '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const lines = normalized.split('\n');
+    let projectName = 'Unknown Project';
+    const sections = [];
+    let currentSection = null;
+    const rawLines = [];
+    for (const line of lines) {
+        rawLines.push(line);
+        // H1 = Project name
+        const h1Match = line.match(/^#\s+(?:Project:\s*)?(.+)$/);
+        if (h1Match) {
+            projectName = h1Match[1].trim();
+            continue;
+        }
+        // H2 = Section header
+        const h2Match = line.match(/^##\s+(.+)$/);
+        if (h2Match) {
+            if (currentSection) {
+                sections.push(currentSection);
+            }
+            currentSection = {
+                title: h2Match[1].trim(),
+                content: [],
+            };
+            continue;
+        }
+        // Bullet point
+        const bulletMatch = line.match(/^[-*]\s+(.+)$/);
+        if (bulletMatch && currentSection) {
+            currentSection.content.push(bulletMatch[1].trim());
+            continue;
+        }
+        // Non-empty line in a section (paragraph text)
+        const trimmed = line.trim();
+        if (trimmed && currentSection && !trimmed.startsWith('#')) {
+            currentSection.content.push(trimmed);
+        }
+    }
+    // Push last section
+    if (currentSection) {
+        sections.push(currentSection);
+    }
+    return { projectName, sections, rawLines };
+}
+/**
+ * Categorize .cursorrules sections into FAF structure
+ */
+function categorizeSections(sections) {
+    const rules = [];
+    const guidelines = [];
+    const codingStyle = [];
+    for (const section of sections) {
+        const titleLower = section.title.toLowerCase();
+        if (titleLower.includes('coding') || titleLower.includes('style') || titleLower.includes('format') || titleLower.includes('convention')) {
+            codingStyle.push(...section.content);
+        }
+        else if (titleLower.includes('rule') || titleLower.includes('constraint') || titleLower.includes('requirement') || titleLower.includes('preference')) {
+            rules.push(...section.content);
+        }
+        else {
+            // Default to guidelines
+            guidelines.push(...section.content);
+        }
+    }
+    return { rules, guidelines, codingStyle };
+}
+// ============================================================================
+// Import: .cursorrules → FAF
+// ============================================================================
+async function cursorImport(cursorPath) {
+    const warnings = [];
+    // Check if file exists
+    try {
+        await fs_1.promises.access(cursorPath);
+    }
+    catch {
+        return {
+            success: false,
+            faf: createEmptyFaf(),
+            warnings: [`.cursorrules not found: ${cursorPath}`],
+            sectionsFound: [],
+        };
+    }
+    // Read and parse
+    const content = await fs_1.promises.readFile(cursorPath, 'utf-8');
+    const parsed = parseCursorRules(content);
+    if (parsed.sections.length === 0) {
+        warnings.push('No sections found in .cursorrules — treating all content as guidelines');
+        // If no sections, treat all non-empty lines as guidelines
+        const allLines = parsed.rawLines
+            .map(l => l.trim())
+            .filter(l => l && !l.startsWith('#'));
+        const faf = {
+            project: {
+                name: parsed.projectName,
+                description: 'Imported from .cursorrules',
+                type: 'cursor-import',
+                rules: [],
+                guidelines: allLines,
+                codingStyle: [],
+            },
+            metadata: {
+                source: 'cursor',
+                imported: new Date().toISOString(),
+            },
+        };
+        return {
+            success: true,
+            faf,
+            warnings,
+            sectionsFound: [],
+        };
+    }
+    const { rules, guidelines, codingStyle } = categorizeSections(parsed.sections);
+    const faf = {
+        project: {
+            name: parsed.projectName,
+            description: 'Imported from .cursorrules',
+            type: 'cursor-import',
+            rules,
+            guidelines,
+            codingStyle,
+        },
+        metadata: {
+            source: 'cursor',
+            imported: new Date().toISOString(),
+        },
+    };
+    return {
+        success: true,
+        faf,
+        warnings,
+        sectionsFound: parsed.sections.map(s => s.title),
+    };
+}
+function createEmptyFaf() {
+    return {
+        project: {
+            name: 'Unknown',
+            description: '',
+            type: 'cursor-import',
+            rules: [],
+            guidelines: [],
+            codingStyle: [],
+        },
+        metadata: {
+            source: 'cursor',
+            imported: new Date().toISOString(),
+        },
+    };
+}
+// ============================================================================
+// Export: FAF → .cursorrules
+// ============================================================================
+async function cursorExport(fafContent, outputPath) {
+    const warnings = [];
+    // Build .cursorrules content
+    const lines = [];
+    // Project header
+    const projectName = fafContent.project?.name || fafContent.name || 'My Project';
+    const projectGoal = fafContent.project?.goal || fafContent.project?.description || fafContent.ai_tldr?.project || '';
+    lines.push(`# ${projectName}`);
+    lines.push('');
+    if (projectGoal) {
+        lines.push(projectGoal);
+        lines.push('');
+    }
+    // Tech Stack section
+    const stack = fafContent.stack || fafContent.project?.stack || {};
+    const hasStack = stack.frontend || stack.backend || stack.build || stack.runtime;
+    if (hasStack) {
+        lines.push('## Tech Stack');
+        lines.push('');
+        if (stack.frontend)
+            lines.push(`- Frontend: ${stack.frontend}`);
+        if (stack.backend)
+            lines.push(`- Backend: ${stack.backend}`);
+        if (stack.runtime)
+            lines.push(`- Runtime: ${stack.runtime}`);
+        if (stack.build)
+            lines.push(`- Build: ${stack.build}`);
+        if (stack.package_manager)
+            lines.push(`- Package Manager: ${stack.package_manager}`);
+        if (stack.languages?.length > 0) {
+            lines.push(`- Languages: ${stack.languages.join(', ')}`);
+        }
+        if (stack.frameworks?.length > 0) {
+            lines.push(`- Frameworks: ${stack.frameworks.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // Coding Standards section
+    const warnings_list = fafContent.ai_instructions?.warnings || [];
+    const workingStyle = fafContent.ai_instructions?.working_style || {};
+    const codingStyle = fafContent.project?.codingStyle || [];
+    const styleItems = [...codingStyle, ...warnings_list];
+    if (workingStyle.quality_bar)
+        styleItems.push(`Quality bar: ${workingStyle.quality_bar}`);
+    if (workingStyle.testing)
+        styleItems.push(`Testing: ${workingStyle.testing}`);
+    if (styleItems.length > 0) {
+        lines.push('## Coding Standards');
+        lines.push('');
+        for (const item of styleItems) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Preferences section
+    const preferences = fafContent.preferences || {};
+    const prefItems = [];
+    if (preferences.quality_bar)
+        prefItems.push(`Quality bar: ${preferences.quality_bar}`);
+    if (preferences.commit_style)
+        prefItems.push(`Commit style: ${preferences.commit_style}`);
+    if (preferences.response_style)
+        prefItems.push(`Response style: ${preferences.response_style}`);
+    if (preferences.testing)
+        prefItems.push(`Testing: ${preferences.testing}`);
+    if (preferences.documentation)
+        prefItems.push(`Documentation: ${preferences.documentation}`);
+    if (prefItems.length > 0) {
+        lines.push('## Preferences');
+        lines.push('');
+        for (const item of prefItems) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Build Commands section
+    const howContext = fafContent.human_context?.how || fafContent.context?.how;
+    if (howContext) {
+        lines.push('## Build Commands');
+        lines.push('');
+        lines.push(`- ${howContext}`);
+        lines.push('');
+    }
+    // General Instructions (rules + guidelines)
+    const rules = fafContent.project?.rules || [];
+    const guidelines = fafContent.project?.guidelines || [];
+    const generalInstructions = [...rules, ...guidelines];
+    if (generalInstructions.length > 0) {
+        lines.push('## General Instructions');
+        lines.push('');
+        for (const item of generalInstructions) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Footer
+    lines.push('---');
+    lines.push(`Generated from project.faf by faf-cli — ${new Date().toISOString().split('T')[0]}`);
+    lines.push('');
+    // Write file
+    const content = lines.join('\n');
+    await fs_1.promises.writeFile(outputPath, content);
+    return {
+        success: true,
+        filePath: outputPath,
+        warnings,
+    };
+}
+// ============================================================================
+// Detection
+// ============================================================================
+async function detectCursorRules(basePath) {
+    const possiblePaths = [
+        path_1.default.join(basePath, '.cursorrules'),
+        path_1.default.join(basePath, '.cursor-rules'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            await fs_1.promises.access(p);
+            return p;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=cursorrules-parser.js.map

package/dist/utils/cursorrules-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorrules-parser.js","sourceRoot":"","sources":["../../src/utils/cursorrules-parser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;AAuDH,4CAoDC;AAkCD,oCAwEC;AAuBD,oCAgHC;AAMD,8CAgBC;AAhXD,2BAAoC;AACpC,gDAAwB;AA6CxB,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,kEAAkE;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,WAAW,GAAG,iBAAiB,CAAC;IACpC,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,IAAI,cAAc,GAA8B,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpB,oBAAoB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QAED,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,cAAc,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAChC,CAAC;YACD,cAAc,GAAG;gBACf,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACxB,OAAO,EAAE,EAAE;aACZ,CAAC;YACF,SAAS;QACX,CAAC;QAED,eAAe;QACf,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAChD,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;YAClC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,+CAA+C;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,cAAc,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAA8B;IAKxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAE/C,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACxI,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACvJ,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAExE,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,aAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,cAAc,EAAE;YACrB,QAAQ,EAAE,CAAC,2BAA2B,UAAU,EAAE,CAAC;YACnD,aAAa,EAAE,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACxF,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAExC,MAAM,GAAG,GAAkB;YACzB,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM,CAAC,WAAW;gBACxB,WAAW,EAAE,4BAA4B;gBACzC,IAAI,EAAE,eAAe;gBACrB,KAAK,EAAE,EAAE;gBACT,UAAU,EAAE,QAAQ;gBACpB,WAAW,EAAE,EAAE;aAChB;YACD,QAAQ,EAAE;gBACR,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACnC;SACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG;YACH,QAAQ;YACR,aAAa,EAAE,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE/E,MAAM,GAAG,GAAkB;QACzB,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,WAAW,EAAE,4BAA4B;YACzC,IAAI,EAAE,eAAe;YACrB,KAAK;YACL,UAAU;YACV,WAAW;SACZ;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC;KACF,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,GAAG;QACH,QAAQ;QACR,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;SAChB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAExE,KAAK,UAAU,YAAY,CAChC,UAAe,EACf,UAAkB;IAElB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,6BAA6B;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,iBAAiB;IACjB,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,UAAU,CAAC,IAAI,IAAI,YAAY,CAAC;IAChF,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,UAAU,CAAC,OAAO,EAAE,WAAW,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACrH,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IACjF,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,KAAK,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACvD,IAAI,KAAK,CAAC,eAAe;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QACrF,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,UAAU,CAAC,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC;IACjE,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,EAAE,aAAa,IAAI,EAAE,CAAC;IACrE,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,aAAa,CAAC,CAAC;IAEtD,IAAI,YAAY,CAAC,WAAW;QAAE,UAAU,CAAC,IAAI,CAAC,gBAAgB,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1F,IAAI,YAAY,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;IAE9E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,sBAAsB;IACtB,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,WAAW,CAAC,WAAW;QAAE,SAAS,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,IAAI,WAAW,CAAC,YAAY;QAAE,SAAS,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1F,IAAI,WAAW,CAAC,cAAc;QAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;IAChG,IAAI,WAAW,CAAC,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,IAAI,WAAW,CAAC,aAAa;QAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;IAE7F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,EAAE,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC;IAC5E,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,4CAA4C;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;IACxD,MAAM,mBAAmB,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC;IAEtD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,2CAA2C,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,aAAa;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,aAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,UAAU;QACpB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAExE,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,MAAM,aAAa,GAAG;QACpB,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC;QACnC,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC;KACrC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,aAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "4.4.2",
+  "version": "4.5.0",
   "description": "The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",
@@ -56,7 +56,7 @@
     "release:beta": "npm run release -- --type prerelease --preid beta",
     "release:dry": "npm run release -- --dry-run",
     "performance": "ts-node scripts/performance-validation.ts",
-    "performance:ci": "npm run performance -- --tests status,help,index",
+    "performance:ci": "npm run performance -- --tests status_command,help_command,index_command",
     "performance:full": "npm run performance -- --verbose",
     "version:update": "node scripts/update-version.js",
     "version:check": "node scripts/version-check.js",
@@ -131,6 +131,7 @@
     "yaml": "^2.4.1"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@types/inquirer": "^9.0.9",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
@@ -143,10 +144,11 @@
     "prettier": "^3.2.5",
     "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.56.0"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "publishConfig": {
     "access": "public"

package/project.faf

@@ -1,5 +1,5 @@
 faf_version: 2.5.0
-generated: 2026-02-17T04:13:29.330Z
+generated: 2026-02-18T19:56:53.057Z
 ai_scoring_system: 2025-09-20
 ai_score: 83%
 ai_confidence: HIGH
@@ -50,7 +50,7 @@ stack:
   frontend: CLI
   ui_library: inquirer (interactive prompts)
   backend: Node.js
-  runtime: Node.js >=14.0.0
+  runtime: Node.js >=18.0.0
   database: None
   build: TypeScript (tsc)
   package_manager: npm
@@ -67,7 +67,7 @@ preferences:
   documentation: as_needed
 state:
   phase: development
-  version: 4.4.2
+  version: 4.5.0
   focus: production_deployment
   status: green_flag
   next_milestone: npm_publication
@@ -132,6 +132,6 @@ gemini:
   notes: Native Gemini CLI integration via FAF
 faf_dna:
   birth_dna: 86
-  birth_certificate: FAF-2026-CLIX-07DH
-  birth_date: 2026-02-17T04:13:29.390Z
+  birth_certificate: FAF-2026-CLIX-KQPK
+  birth_date: 2026-02-18T19:56:53.125Z
   current_score: 86