faf-mcp 1.3.1 → 2.0.0

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

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * GEMINI.md Parser
+ *
+ * Parses Google Gemini CLI GEMINI.md files for bidirectional
+ * interoperability with FAF.
+ *
+ * GEMINI.md Structure:
+ * - H1: Project name
+ * - H2: Section headers (General Instructions, Coding Style, etc.)
+ * - Bullets: Specific guidelines
+ *
+ * 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.parseGeminiMd = parseGeminiMd;
+exports.geminiImport = geminiImport;
+exports.geminiExport = geminiExport;
+exports.detectGeminiMd = detectGeminiMd;
+exports.detectGlobalGeminiMd = detectGlobalGeminiMd;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+// ============================================================================
+// Parsing
+// ============================================================================
+/**
+ * Parse GEMINI.md file content
+ */
+function parseGeminiMd(content) {
+    const lines = content.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 };
+}
+/**
+ * Convert GEMINI.md sections to 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')) {
+            codingStyle.push(...section.content);
+        }
+        else if (titleLower.includes('rule') || titleLower.includes('constraint') || titleLower.includes('requirement')) {
+            rules.push(...section.content);
+        }
+        else {
+            // Default to guidelines
+            guidelines.push(...section.content);
+        }
+    }
+    return { rules, guidelines, codingStyle };
+}
+// ============================================================================
+// Import: GEMINI.md -> FAF
+// ============================================================================
+async function geminiImport(geminiPath) {
+    const warnings = [];
+    // Check if file exists
+    try {
+        await fs_1.promises.access(geminiPath);
+    }
+    catch {
+        return {
+            success: false,
+            faf: createEmptyFaf(),
+            warnings: [`GEMINI.md not found: ${geminiPath}`],
+            sectionsFound: [],
+        };
+    }
+    // Read and parse
+    const content = await fs_1.promises.readFile(geminiPath, 'utf-8');
+    const parsed = parseGeminiMd(content);
+    if (parsed.sections.length === 0) {
+        warnings.push('No sections found in GEMINI.md');
+    }
+    const { rules, guidelines, codingStyle } = categorizeSections(parsed.sections);
+    const faf = {
+        project: {
+            name: parsed.projectName,
+            description: `Imported from GEMINI.md`,
+            type: 'gemini-import',
+            rules,
+            guidelines,
+            codingStyle,
+        },
+        metadata: {
+            source: 'gemini',
+            imported: new Date().toISOString(),
+        },
+    };
+    return {
+        success: true,
+        faf,
+        warnings,
+        sectionsFound: parsed.sections.map(s => s.title),
+    };
+}
+function createEmptyFaf() {
+    return {
+        project: {
+            name: 'Unknown',
+            description: '',
+            type: 'gemini-import',
+            rules: [],
+            guidelines: [],
+            codingStyle: [],
+        },
+        metadata: {
+            source: 'gemini',
+            imported: new Date().toISOString(),
+        },
+    };
+}
+// ============================================================================
+// Export: FAF -> GEMINI.md
+// ============================================================================
+async function geminiExport(fafContent, outputPath) {
+    const warnings = [];
+    // Build GEMINI.md content
+    const lines = [];
+    // Project header
+    const projectName = fafContent.project?.name || fafContent.name || 'My Project';
+    lines.push(`# Project: ${projectName}`);
+    lines.push('');
+    // Description as intro paragraph if exists
+    const description = fafContent.project?.description || fafContent.description;
+    if (description) {
+        lines.push(description);
+        lines.push('');
+    }
+    // General Instructions section
+    const guidelineItems = fafContent.project?.guidelines || fafContent.guidelines || [];
+    const ruleItems = fafContent.project?.rules || fafContent.rules || [];
+    const generalInstructions = [...guidelineItems, ...ruleItems];
+    if (generalInstructions.length > 0) {
+        lines.push('## General Instructions');
+        lines.push('');
+        for (const item of generalInstructions) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Coding Style section
+    const codingStyleItems = fafContent.project?.codingStyle || fafContent.codingStyle || [];
+    const stack = fafContent.project?.stack || {};
+    // Add languages/frameworks to coding style context
+    const styleItems = [...codingStyleItems];
+    if (stack.languages?.length > 0) {
+        styleItems.push(`Languages: ${stack.languages.join(', ')}`);
+    }
+    if (stack.frameworks?.length > 0) {
+        styleItems.push(`Frameworks: ${stack.frameworks.join(', ')}`);
+    }
+    if (styleItems.length > 0) {
+        lines.push('## Coding Style');
+        lines.push('');
+        for (const item of styleItems) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Tech Stack section (if detailed)
+    if (stack.databases?.length > 0 || stack.infrastructure?.length > 0) {
+        lines.push('## Tech Stack');
+        lines.push('');
+        if (stack.databases?.length > 0) {
+            lines.push(`- Databases: ${stack.databases.join(', ')}`);
+        }
+        if (stack.infrastructure?.length > 0) {
+            lines.push(`- Infrastructure: ${stack.infrastructure.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // Goals section
+    const goals = fafContent.project?.goals || [];
+    if (goals.length > 0) {
+        lines.push('## Project Goals');
+        lines.push('');
+        for (const goal of goals) {
+            lines.push(`- ${goal}`);
+        }
+        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 detectGeminiMd(basePath) {
+    const possiblePaths = [
+        path_1.default.join(basePath, 'GEMINI.md'),
+        path_1.default.join(basePath, 'gemini.md'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            await fs_1.promises.access(p);
+            return p;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Check for global GEMINI.md
+ */
+async function detectGlobalGeminiMd() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const globalPath = path_1.default.join(home, '.gemini', 'GEMINI.md');
+    try {
+        await fs_1.promises.access(globalPath);
+        return globalPath;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=gemini-parser.js.map

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

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

package/dist/src/faf-core/parsers/github-extractor.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GitHub Repository Metadata Extractor
+ *
+ * Fetches rich metadata from GitHub repos without cloning.
+ * Uses GitHub API v3 (no auth needed for public repos, 60 req/hr limit).
+ *
+ * Ported from faf-cli for claude-faf-mcp v4.5.0
+ */
+export interface GitHubMetadata {
+    owner: string;
+    repo: string;
+    url: string;
+    description?: string;
+    topics?: string[];
+    stars?: string;
+    forks?: string;
+    license?: string;
+    languages?: string[];
+    lastUpdated?: string;
+    defaultBranch?: string;
+    openIssues?: number;
+    watchers?: number;
+    readme?: boolean;
+    hasPackageJson?: boolean;
+    hasTsConfig?: boolean;
+    hasDockerfile?: boolean;
+}
+export interface GitHubFile {
+    path: string;
+    type: 'file' | 'dir';
+    size?: number;
+    url?: string;
+}
+/**
+ * Parse GitHub URL to extract owner and repo
+ */
+export declare function parseGitHubUrl(url: string): {
+    owner: string;
+    repo: string;
+} | null;
+/**
+ * Fetch repository metadata from GitHub API
+ * (No auth required for public repos, 60 requests/hour limit)
+ */
+export declare function fetchGitHubMetadata(owner: string, repo: string, includeFiles?: boolean): Promise<GitHubMetadata>;
+/**
+ * Fetch repository file tree
+ */
+export declare function fetchGitHubFileTree(owner: string, repo: string, branch?: string, treePath?: string): Promise<GitHubFile[]>;
+/**
+ * Fetch file content from GitHub repository
+ */
+export declare function fetchGitHubFileContent(owner: string, repo: string, filePath: string, branch?: string): Promise<string | null>;
+/**
+ * Detect framework/stack from repository metadata
+ */
+export declare function detectStackFromMetadata(metadata: GitHubMetadata): string[];
+/**
+ * Generate quality score based on metadata
+ */
+export declare function calculateRepoQualityScore(metadata: GitHubMetadata): number;