faf-mcp 1.3.1 → 2.0.0

package/dist/src/faf-core/parsers/conductor-parser.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Conductor Format Parser
+ *
+ * Parses Google's Conductor extension format (conductor/ directory)
+ * for bidirectional interoperability with FAF.
+ *
+ * Ported from faf-cli for claude-faf-mcp v4.5.0
+ */
+export interface ConductorProduct {
+    title: string;
+    description: string;
+    goals: string[];
+    users: string[];
+    features: string[];
+}
+export interface ConductorTechStack {
+    languages: string[];
+    frameworks: string[];
+    databases: string[];
+    infrastructure: string[];
+}
+export interface ConductorWorkflow {
+    developmentProcess: string[];
+    commitStrategy: string[];
+    reviewProcess: string[];
+}
+export interface ConductorGuidelines {
+    proseStyle: string[];
+    brandingRules: string[];
+    visualIdentity: string[];
+}
+export interface ConductorDirectory {
+    product?: ConductorProduct;
+    techStack?: ConductorTechStack;
+    workflow?: ConductorWorkflow;
+    guidelines?: ConductorGuidelines;
+    styleguides?: Record<string, string[]>;
+}
+export interface FafFromConductor {
+    project: {
+        name: string;
+        description: string;
+        type: string;
+        goals: string[];
+        stack: {
+            languages: string[];
+            frameworks: string[];
+            databases: string[];
+            infrastructure: string[];
+        };
+        rules: string[];
+        guidelines: string[];
+    };
+    metadata: {
+        source: string;
+        imported: string;
+        conductor_version?: string;
+    };
+}
+export interface ImportResult {
+    success: boolean;
+    faf: FafFromConductor;
+    warnings: string[];
+    filesProcessed: string[];
+}
+export interface ExportResult {
+    success: boolean;
+    filesGenerated: string[];
+    warnings: string[];
+}
+/**
+ * Parse markdown content and extract sections by heading
+ */
+export declare function parseMarkdownSections(content: string): Record<string, string>;
+/**
+ * Extract bullet points from markdown content
+ */
+export declare function extractBulletPoints(content: string): string[];
+export declare function parseProductMd(content: string): ConductorProduct;
+export declare function parseTechStackMd(content: string): ConductorTechStack;
+export declare function parseWorkflowMd(content: string): ConductorWorkflow;
+export declare function parseGuidelinesMd(content: string): ConductorGuidelines;
+export declare function conductorImport(conductorPath: string): Promise<ImportResult>;
+export declare function conductorExport(faf: FafFromConductor, outputPath: string): Promise<ExportResult>;
+export declare function detectConductor(basePath: string): Promise<boolean>;

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

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * Conductor Format Parser
+ *
+ * Parses Google's Conductor extension format (conductor/ directory)
+ * for bidirectional interoperability with FAF.
+ *
+ * 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.parseMarkdownSections = parseMarkdownSections;
+exports.extractBulletPoints = extractBulletPoints;
+exports.parseProductMd = parseProductMd;
+exports.parseTechStackMd = parseTechStackMd;
+exports.parseWorkflowMd = parseWorkflowMd;
+exports.parseGuidelinesMd = parseGuidelinesMd;
+exports.conductorImport = conductorImport;
+exports.conductorExport = conductorExport;
+exports.detectConductor = detectConductor;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+// ============================================================================
+// Markdown Parsing
+// ============================================================================
+/**
+ * Parse markdown content and extract sections by heading
+ */
+function parseMarkdownSections(content) {
+    const sections = {};
+    const lines = content.split('\n');
+    let currentSection = '_intro';
+    let currentContent = [];
+    for (const line of lines) {
+        const headingMatch = line.match(/^##\s+(.+)$/);
+        if (headingMatch) {
+            if (currentContent.length > 0) {
+                sections[currentSection] = currentContent.join('\n').trim();
+            }
+            currentSection = headingMatch[1].toLowerCase().replace(/\s+/g, '_');
+            currentContent = [];
+        }
+        else if (line.match(/^#\s+(.+)$/)) {
+            const titleMatch = line.match(/^#\s+(.+)$/);
+            if (titleMatch) {
+                sections['_title'] = titleMatch[1];
+            }
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    if (currentContent.length > 0) {
+        sections[currentSection] = currentContent.join('\n').trim();
+    }
+    return sections;
+}
+/**
+ * Extract bullet points from markdown content
+ */
+function extractBulletPoints(content) {
+    const lines = content.split('\n');
+    const bullets = [];
+    for (const line of lines) {
+        const bulletMatch = line.match(/^[-*]\s+(.+)$/);
+        if (bulletMatch) {
+            bullets.push(bulletMatch[1].trim());
+        }
+    }
+    return bullets;
+}
+// ============================================================================
+// File Parsers
+// ============================================================================
+function parseProductMd(content) {
+    const sections = parseMarkdownSections(content);
+    return {
+        title: sections['_title'] || 'Unknown Project',
+        description: sections['overview'] || '',
+        goals: extractBulletPoints(sections['goals'] || ''),
+        users: extractBulletPoints(sections['target_users'] || ''),
+        features: extractBulletPoints(sections['key_features'] || ''),
+    };
+}
+function parseTechStackMd(content) {
+    const sections = parseMarkdownSections(content);
+    return {
+        languages: extractBulletPoints(sections['languages'] || ''),
+        frameworks: extractBulletPoints(sections['frameworks'] || ''),
+        databases: extractBulletPoints(sections['databases'] || ''),
+        infrastructure: extractBulletPoints(sections['infrastructure'] || ''),
+    };
+}
+function parseWorkflowMd(content) {
+    const sections = parseMarkdownSections(content);
+    return {
+        developmentProcess: extractBulletPoints(sections['development_process'] || ''),
+        commitStrategy: extractBulletPoints(sections['commit_strategy'] || ''),
+        reviewProcess: extractBulletPoints(sections['review_process'] || ''),
+    };
+}
+function parseGuidelinesMd(content) {
+    const sections = parseMarkdownSections(content);
+    return {
+        proseStyle: extractBulletPoints(sections['prose_style'] || ''),
+        brandingRules: extractBulletPoints(sections['branding_rules'] || ''),
+        visualIdentity: extractBulletPoints(sections['visual_identity'] || ''),
+    };
+}
+// ============================================================================
+// Import: Conductor -> FAF
+// ============================================================================
+async function conductorImport(conductorPath) {
+    const warnings = [];
+    const filesProcessed = [];
+    const faf = {
+        project: {
+            name: 'Unknown',
+            description: '',
+            type: 'conductor-import',
+            goals: [],
+            stack: {
+                languages: [],
+                frameworks: [],
+                databases: [],
+                infrastructure: [],
+            },
+            rules: [],
+            guidelines: [],
+        },
+        metadata: {
+            source: 'conductor',
+            imported: new Date().toISOString(),
+        },
+    };
+    // Parse product.md
+    const productPath = path_1.default.join(conductorPath, 'product.md');
+    try {
+        const content = await fs_1.promises.readFile(productPath, 'utf-8');
+        const product = parseProductMd(content);
+        faf.project.name = product.title;
+        faf.project.description = product.description;
+        faf.project.goals = product.goals;
+        filesProcessed.push('product.md');
+    }
+    catch {
+        warnings.push('product.md not found - using defaults');
+    }
+    // Parse tech-stack.md
+    const techStackPath = path_1.default.join(conductorPath, 'tech-stack.md');
+    try {
+        const content = await fs_1.promises.readFile(techStackPath, 'utf-8');
+        const techStack = parseTechStackMd(content);
+        faf.project.stack = techStack;
+        filesProcessed.push('tech-stack.md');
+    }
+    catch {
+        warnings.push('tech-stack.md not found - stack will be empty');
+    }
+    // Parse workflow.md
+    const workflowPath = path_1.default.join(conductorPath, 'workflow.md');
+    try {
+        const content = await fs_1.promises.readFile(workflowPath, 'utf-8');
+        const workflow = parseWorkflowMd(content);
+        faf.project.rules = [
+            ...workflow.developmentProcess,
+            ...workflow.commitStrategy,
+            ...workflow.reviewProcess,
+        ];
+        filesProcessed.push('workflow.md');
+    }
+    catch {
+        warnings.push('workflow.md not found - rules will be empty');
+    }
+    // Parse product-guidelines.md
+    const guidelinesPath = path_1.default.join(conductorPath, 'product-guidelines.md');
+    try {
+        const content = await fs_1.promises.readFile(guidelinesPath, 'utf-8');
+        const guidelines = parseGuidelinesMd(content);
+        faf.project.guidelines = [
+            ...guidelines.proseStyle,
+            ...guidelines.brandingRules,
+            ...guidelines.visualIdentity,
+        ];
+        filesProcessed.push('product-guidelines.md');
+    }
+    catch {
+        warnings.push('product-guidelines.md not found - guidelines will be empty');
+    }
+    return {
+        success: filesProcessed.length > 0,
+        faf,
+        warnings,
+        filesProcessed,
+    };
+}
+// ============================================================================
+// Export: FAF -> Conductor
+// ============================================================================
+async function conductorExport(faf, outputPath) {
+    const filesGenerated = [];
+    const warnings = [];
+    // Ensure output directory exists
+    try {
+        await fs_1.promises.mkdir(outputPath, { recursive: true });
+    }
+    catch (err) {
+        return {
+            success: false,
+            filesGenerated: [],
+            warnings: [`Failed to create output directory: ${err}`],
+        };
+    }
+    // Generate product.md
+    const productContent = `# ${faf.project.name}
+
+## Overview
+${faf.project.description}
+
+## Goals
+${faf.project.goals.map(g => `- ${g}`).join('\n')}
+`;
+    await fs_1.promises.writeFile(path_1.default.join(outputPath, 'product.md'), productContent);
+    filesGenerated.push('product.md');
+    // Generate tech-stack.md
+    const techStackContent = `# Tech Stack
+
+## Languages
+${faf.project.stack.languages.map(l => `- ${l}`).join('\n')}
+
+## Frameworks
+${faf.project.stack.frameworks.map(f => `- ${f}`).join('\n')}
+
+## Databases
+${faf.project.stack.databases.map(d => `- ${d}`).join('\n')}
+
+## Infrastructure
+${faf.project.stack.infrastructure.map(i => `- ${i}`).join('\n')}
+`;
+    await fs_1.promises.writeFile(path_1.default.join(outputPath, 'tech-stack.md'), techStackContent);
+    filesGenerated.push('tech-stack.md');
+    // Generate workflow.md
+    const workflowContent = `# Workflow
+
+## Rules
+${faf.project.rules.map(r => `- ${r}`).join('\n')}
+`;
+    await fs_1.promises.writeFile(path_1.default.join(outputPath, 'workflow.md'), workflowContent);
+    filesGenerated.push('workflow.md');
+    // Generate product-guidelines.md
+    const guidelinesContent = `# Product Guidelines
+
+## Guidelines
+${faf.project.guidelines.map(g => `- ${g}`).join('\n')}
+`;
+    await fs_1.promises.writeFile(path_1.default.join(outputPath, 'product-guidelines.md'), guidelinesContent);
+    filesGenerated.push('product-guidelines.md');
+    return {
+        success: true,
+        filesGenerated,
+        warnings,
+    };
+}
+// ============================================================================
+// Detection
+// ============================================================================
+async function detectConductor(basePath) {
+    const conductorPath = path_1.default.join(basePath, 'conductor');
+    try {
+        const stat = await fs_1.promises.stat(conductorPath);
+        if (!stat.isDirectory()) {
+            return false;
+        }
+    }
+    catch {
+        return false;
+    }
+    // Check for at least one required file
+    const requiredFiles = ['product.md', 'tech-stack.md', 'workflow.md'];
+    for (const file of requiredFiles) {
+        try {
+            await fs_1.promises.access(path_1.default.join(conductorPath, file));
+            return true;
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=conductor-parser.js.map

package/dist/src/faf-core/parsers/conductor-parser.js.map

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

package/dist/src/faf-core/parsers/cursorrules-parser.d.ts

@@ -0,0 +1,57 @@
+/**
+ * .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
+ */
+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>;