faf-cli 4.4.4 → 4.5.0

package/dist/utils/agents-parser.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * AGENTS.md Parser
+ *
+ * Parses OpenAI Codex / Linux Foundation AGENTS.md files for bidirectional
+ * interoperability with FAF.
+ *
+ * AGENTS.md Structure:
+ * - H1: Project name
+ * - H2: Section headers (Project Overview, Tech Stack, etc.)
+ * - Bullets: Specific guidelines
+ *
+ * @see https://github.com/anthropics/claude-code/issues/27050
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAgentsMd = parseAgentsMd;
+exports.agentsImport = agentsImport;
+exports.agentsExport = agentsExport;
+exports.detectAgentsMd = detectAgentsMd;
+exports.detectGlobalAgentsMd = detectGlobalAgentsMd;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse AGENTS.md file content
+ */
+function parseAgentsMd(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;
+    for (const line of lines) {
+        // 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());
+        }
+    }
+    // Push last section
+    if (currentSection) {
+        sections.push(currentSection);
+    }
+    return { projectName, sections };
+}
+/**
+ * Categorize AGENTS.md sections into FAF structure
+ */
+function categorizeSections(sections) {
+    const rules = [];
+    const guidelines = [];
+    const codingStyle = [];
+    const buildCommands = [];
+    const architecture = [];
+    for (const section of sections) {
+        const titleLower = section.title.toLowerCase();
+        if (titleLower.includes('build') || titleLower.includes('test') || titleLower.includes('command')) {
+            buildCommands.push(...section.content);
+        }
+        else if (titleLower.includes('architect') || titleLower.includes('structure') || titleLower.includes('design')) {
+            architecture.push(...section.content);
+        }
+        else if (titleLower.includes('coding') || titleLower.includes('style') || titleLower.includes('format') || titleLower.includes('guideline')) {
+            codingStyle.push(...section.content);
+        }
+        else if (titleLower.includes('rule') || titleLower.includes('constraint') || titleLower.includes('requirement') || titleLower.includes('warning')) {
+            rules.push(...section.content);
+        }
+        else {
+            // Default to guidelines (includes "Project Overview", "Tech Stack", etc.)
+            guidelines.push(...section.content);
+        }
+    }
+    return { rules, guidelines, codingStyle, buildCommands, architecture };
+}
+// ============================================================================
+// Import: AGENTS.md → FAF
+// ============================================================================
+async function agentsImport(agentsPath) {
+    const warnings = [];
+    // Check if file exists
+    try {
+        await fs_1.promises.access(agentsPath);
+    }
+    catch {
+        return {
+            success: false,
+            faf: createEmptyFaf(),
+            warnings: [`AGENTS.md not found: ${agentsPath}`],
+            sectionsFound: [],
+        };
+    }
+    // Read and parse
+    const content = await fs_1.promises.readFile(agentsPath, 'utf-8');
+    const parsed = parseAgentsMd(content);
+    if (parsed.sections.length === 0) {
+        warnings.push('No sections found in AGENTS.md');
+    }
+    const { rules, guidelines, codingStyle, buildCommands, architecture } = categorizeSections(parsed.sections);
+    const faf = {
+        project: {
+            name: parsed.projectName,
+            description: `Imported from AGENTS.md`,
+            type: 'agents-import',
+            rules,
+            guidelines,
+            codingStyle,
+            buildCommands,
+            architecture,
+        },
+        metadata: {
+            source: 'agents',
+            imported: new Date().toISOString(),
+        },
+    };
+    return {
+        success: true,
+        faf,
+        warnings,
+        sectionsFound: parsed.sections.map(s => s.title),
+    };
+}
+function createEmptyFaf() {
+    return {
+        project: {
+            name: 'Unknown',
+            description: '',
+            type: 'agents-import',
+            rules: [],
+            guidelines: [],
+            codingStyle: [],
+            buildCommands: [],
+            architecture: [],
+        },
+        metadata: {
+            source: 'agents',
+            imported: new Date().toISOString(),
+        },
+    };
+}
+// ============================================================================
+// Export: FAF → AGENTS.md
+// ============================================================================
+async function agentsExport(fafContent, outputPath) {
+    const warnings = [];
+    // Build AGENTS.md 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('');
+    // Project Overview section
+    lines.push('## Project Overview');
+    lines.push('');
+    if (projectGoal) {
+        lines.push(`- ${projectGoal}`);
+    }
+    if (fafContent.instant_context?.what_building) {
+        lines.push(`- ${fafContent.instant_context.what_building}`);
+    }
+    lines.push('');
+    // Tech Stack section
+    const stack = fafContent.stack || fafContent.project?.stack || {};
+    const hasStack = stack.frontend || stack.backend || stack.build || stack.runtime || stack.database;
+    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.database && stack.database !== 'None')
+            lines.push(`- Database: ${stack.database}`);
+        if (stack.package_manager)
+            lines.push(`- Package Manager: ${stack.package_manager}`);
+        if (stack.hosting)
+            lines.push(`- Hosting: ${stack.hosting}`);
+        if (stack.cicd)
+            lines.push(`- CI/CD: ${stack.cicd}`);
+        // Also include languages/frameworks arrays if present
+        if (stack.languages?.length > 0) {
+            lines.push(`- Languages: ${stack.languages.join(', ')}`);
+        }
+        if (stack.frameworks?.length > 0) {
+            lines.push(`- Frameworks: ${stack.frameworks.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // Code Style Guidelines section
+    const warnings_list = fafContent.ai_instructions?.warnings || [];
+    const codingStyle = fafContent.project?.codingStyle || [];
+    const preferences = fafContent.preferences || {};
+    const styleItems = [...codingStyle, ...warnings_list];
+    if (preferences.quality_bar)
+        styleItems.push(`Quality bar: ${preferences.quality_bar}`);
+    if (preferences.commit_style)
+        styleItems.push(`Commit style: ${preferences.commit_style}`);
+    if (preferences.testing)
+        styleItems.push(`Testing: ${preferences.testing}`);
+    if (styleItems.length > 0) {
+        lines.push('## Code Style Guidelines');
+        lines.push('');
+        for (const item of styleItems) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Build and Test Commands section
+    const howContext = fafContent.human_context?.how || fafContent.context?.how;
+    const buildCommands = fafContent.project?.buildCommands || [];
+    if (howContext || buildCommands.length > 0) {
+        lines.push('## Build and Test Commands');
+        lines.push('');
+        if (howContext)
+            lines.push(`- ${howContext}`);
+        for (const cmd of buildCommands) {
+            lines.push(`- ${cmd}`);
+        }
+        lines.push('');
+    }
+    // Architecture section
+    const humanContext = fafContent.human_context || {};
+    const architecture = fafContent.project?.architecture || [];
+    const archItems = [...architecture];
+    if (humanContext.what)
+        archItems.push(humanContext.what);
+    if (humanContext.where)
+        archItems.push(`Deployed: ${humanContext.where}`);
+    if (archItems.length > 0) {
+        lines.push('## Architecture');
+        lines.push('');
+        for (const item of archItems) {
+            lines.push(`- ${item}`);
+        }
+        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 detectAgentsMd(basePath) {
+    const possiblePaths = [
+        path_1.default.join(basePath, 'AGENTS.md'),
+        path_1.default.join(basePath, 'agents.md'),
+        path_1.default.join(basePath, 'Agents.md'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            await fs_1.promises.access(p);
+            return p;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Check for global AGENTS.md (~/.codex/AGENTS.md)
+ */
+async function detectGlobalAgentsMd() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const globalPath = path_1.default.join(home, '.codex', 'AGENTS.md');
+    try {
+        await fs_1.promises.access(globalPath);
+        return globalPath;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=agents-parser.js.map

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

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

package/dist/utils/cursorrules-parser.d.ts

@@ -0,0 +1,56 @@
+/**
+ * .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.
+ */
+export interface CursorRulesSection {
+    title: string;
+    content: string[];
+}
+export interface CursorRulesFile {
+    projectName: string;
+    sections: CursorRulesSection[];
+    rawLines: string[];
+}
+export interface FafFromCursor {
+    project: {
+        name: string;
+        description: string;
+        type: string;
+        rules: string[];
+        guidelines: string[];
+        codingStyle: string[];
+    };
+    metadata: {
+        source: string;
+        imported: string;
+    };
+}
+export interface CursorImportResult {
+    success: boolean;
+    faf: FafFromCursor;
+    warnings: string[];
+    sectionsFound: string[];
+}
+export interface CursorExportResult {
+    success: boolean;
+    filePath: string;
+    warnings: string[];
+}
+/**
+ * Parse .cursorrules file content
+ */
+export declare function parseCursorRules(content: string): CursorRulesFile;
+export declare function cursorImport(cursorPath: string): Promise<CursorImportResult>;
+export declare function cursorExport(fafContent: any, outputPath: string): Promise<CursorExportResult>;
+export declare function detectCursorRules(basePath: string): Promise<string | null>;
+//# sourceMappingURL=cursorrules-parser.d.ts.map

package/dist/utils/cursorrules-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorrules-parser.d.ts","sourceRoot":"","sources":["../../src/utils/cursorrules-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,aAAa,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAoDjE;AAkCD,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwElF;AAuBD,wBAAsB,YAAY,CAChC,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA6G7B;AAMD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBhF"}