faf-mcp 1.3.1 → 2.0.0

package/dist/src/faf-core/parsers/cursorrules-parser.js

@@ -0,0 +1,317 @@
+"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.
+ *
+ * Ported from faf-cli for claude-faf-mcp v4.5.0
+ */
+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 codingStyleItems = fafContent.project?.codingStyle || [];
+    const styleItems = [...codingStyleItems, ...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 ruleItems = fafContent.project?.rules || [];
+    const guidelineItems = fafContent.project?.guidelines || [];
+    const generalInstructions = [...ruleItems, ...guidelineItems];
+    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 claude-faf-mcp — ${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/src/faf-core/parsers/cursorrules-parser.js.map

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

package/dist/src/faf-core/parsers/faf-git-generator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * FAF Generation for `faf git`
+ *
+ * Generates clean, accurate .faf files from GitHub repos without cloning.
+ * Output is compact and PR-ready — every line adds value.
+ *
+ * Ported from faf-cli for claude-faf-mcp v4.5.0
+ */
+import type { GitHubMetadata } from './github-extractor.js';
+export interface Enhanced6Ws {
+    who: string;
+    what: string;
+    why: string;
+    where: string;
+    when: string;
+    how: string;
+    confidence: number;
+}
+export interface StackAnalysis {
+    frontend?: string;
+    backend?: string;
+    database?: string;
+    testing?: string;
+    buildTool?: string;
+    runtime?: string;
+    language?: string;
+    hosting?: string;
+    frameworks: string[];
+}
+/**
+ * Extract 6 Ws from README content
+ */
+export declare function extract6WsFromReadme(readme: string, metadata: GitHubMetadata): Enhanced6Ws;
+/**
+ * Extract stack from GitHub API languages array (source of truth)
+ * Languages are sorted by percentage descending — first entry is primary.
+ */
+export declare function extractFromLanguages(metadata: GitHubMetadata): StackAnalysis;
+/**
+ * Analyze package.json for npm ecosystem details
+ */
+export declare function analyzePackageJson(packageJson: any, _metadata: GitHubMetadata): StackAnalysis;
+/**
+ * Generate clean .faf file from GitHub repo metadata
+ */
+export declare function generateEnhancedFaf(metadata: GitHubMetadata, _files: any[]): Promise<{
+    content: string;
+    score: number;
+}>;
+/**
+ * Score tier for display (not written to file)
+ */
+export declare function getScoreTier(score: number): string;