faf-cli 4.4.4 → 5.0.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":"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"}

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

@@ -0,0 +1,95 @@
+/**
+ * MEMORY.md Parser — Claude Code Auto-Memory Interop
+ *
+ * Bidirectional interoperability between FAF and Claude Code's
+ * auto-memory system (~/.claude/projects/<id>/memory/MEMORY.md).
+ *
+ * Key difference from other targets: MEMORY.md lives OUTSIDE the
+ * project root, has a 200-line auto-load ceiling, and must MERGE
+ * (not overwrite) to preserve Claude's own notes.
+ *
+ * Path convention:
+ *   ~/.claude/projects/<project-id>/memory/MEMORY.md
+ *   project-id = absolute path with / replaced by -
+ *   e.g. /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+export interface MemoryMdSection {
+    title: string;
+    content: string;
+}
+export interface MemoryMdFile {
+    fafSection: string | null;
+    claudeNotes: string;
+    totalLines: number;
+}
+export interface MemoryImportResult {
+    success: boolean;
+    warnings: string[];
+    harvested: {
+        patterns: string[];
+        conventions: string[];
+        keyFiles: string[];
+        notes: string[];
+    };
+}
+export interface MemoryExportResult {
+    success: boolean;
+    filePath: string;
+    linesWritten: number;
+    warnings: string[];
+    merged: boolean;
+}
+/**
+ * Compute Claude Code project ID from an absolute path.
+ * Convention: /Users/wolfejam/FAF/cli → -Users-wolfejam-FAF-cli
+ */
+export declare function computeProjectId(projectPath: string): string;
+/**
+ * Get the git repository root for a directory.
+ * Returns null if not in a git repo.
+ */
+export declare function getGitRoot(cwd?: string): string | null;
+/**
+ * Resolve the memory directory for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/
+ */
+export declare function resolveMemoryDir(projectPath: string): string;
+/**
+ * Resolve the full MEMORY.md path for a project.
+ * → ~/.claude/projects/-Users-wolfejam-FAF-cli/memory/MEMORY.md
+ */
+export declare function resolveMemoryPath(projectPath: string): string;
+/**
+ * Parse MEMORY.md into our section and Claude's notes.
+ */
+export declare function parseMemoryMd(content: string): MemoryMdFile;
+/**
+ * Export .faf data to MEMORY.md.
+ * Merge mode (default): replace only our section, preserve Claude's notes.
+ * Force mode: overwrite entire file.
+ */
+export declare function memoryExport(fafContent: any, outputPath: string, options?: {
+    merge?: boolean;
+}): Promise<MemoryExportResult>;
+/**
+ * Import/harvest Claude's notes from MEMORY.md into structured data.
+ * Conservative: only extracts clearly structured entries.
+ */
+export declare function memoryImport(memoryPath: string): Promise<MemoryImportResult>;
+/**
+ * Detect MEMORY.md at Claude's expected path for this project.
+ * Returns the path if found, null otherwise.
+ */
+export declare function detectMemoryMd(projectPath: string): Promise<string | null>;
+/**
+ * Get memory status for display.
+ */
+export declare function getMemoryStatus(projectPath: string): Promise<{
+    exists: boolean;
+    path: string;
+    totalLines: number;
+    fafSectionLines: number;
+    claudeNotesLines: number;
+    hasFafSection: boolean;
+}>;
+//# sourceMappingURL=memory-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-parser.d.ts","sourceRoot":"","sources":["../../src/utils/memory-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA6B3D;AA4GD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAsD7B;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmElF;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAwBD"}