faf-mcp 1.0.0

package/dist/src/faf-core/utils/chrome-extension-detector.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 🎯 Chrome Extension Fuzzy Detection - Google-style intelligence
+ * "Did you mean Chrome Extension?"
+ */
+interface DetectionResult {
+    detected: boolean;
+    confidence: 'high' | 'medium' | 'low' | 'none';
+    suggestion?: string;
+    needsConfirmation: boolean;
+}
+/**
+ * Google-style fuzzy matching for Chrome Extension detection
+ * Handles typos, abbreviations, and variations
+ */
+export declare class ChromeExtensionDetector {
+    private static readonly HIGH_CONFIDENCE;
+    private static readonly MEDIUM_CONFIDENCE;
+    private static readonly LOW_CONFIDENCE;
+    private static readonly TYPO_CORRECTIONS;
+    /**
+     * Detect if text refers to a Chrome Extension with Google-style intelligence
+     */
+    static detect(text: string): DetectionResult;
+    /**
+     * Correct common typos
+     */
+    private static correctTypos;
+    /**
+     * Fuzzy match with Levenshtein distance
+     */
+    private static fuzzyMatch;
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    private static levenshteinDistance;
+    /**
+     * Check for extension-related context
+     */
+    private static hasExtensionContext;
+    /**
+     * Check for spaced patterns like "c e" or "ch ext"
+     */
+    private static hasSpacedPattern;
+    /**
+     * Get user-friendly confirmation message
+     */
+    static getConfirmationMessage(result: DetectionResult): string | null;
+    /**
+     * Check if project has Chrome Extension files (for validation)
+     */
+    static hasExtensionFiles(files: string[]): boolean;
+}
+export {};
+/**
+ * Examples of detection:
+ *
+ * HIGH confidence (auto-accept):
+ * - "chrome extension" → ✅
+ * - "browser extension" → ✅
+ *
+ * MEDIUM confidence (needs confirmation):
+ * - "chr ext" → "Did you mean Chrome Extension?"
+ * - "c ext" → "Did you mean Chrome Extension?"
+ * - "CE" → "Did you mean Chrome Extension?"
+ *
+ * TYPO correction (auto-fix):
+ * - "chrom extention" → ✅ (corrected)
+ * - "chrome extnsion" → ✅ (corrected)
+ *
+ * LOW confidence (suggest if context):
+ * - "extension for managing tabs" → "Possible Chrome Extension?"
+ * - "popup manager" → "Possible Chrome Extension?"
+ */ 

package/dist/src/faf-core/utils/chrome-extension-detector.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * 🎯 Chrome Extension Fuzzy Detection - Google-style intelligence
+ * "Did you mean Chrome Extension?"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeExtensionDetector = void 0;
+/**
+ * Google-style fuzzy matching for Chrome Extension detection
+ * Handles typos, abbreviations, and variations
+ */
+class ChromeExtensionDetector {
+    // High confidence patterns (exact matches)
+    static HIGH_CONFIDENCE = [
+        'chrome extension',
+        'browser extension',
+        'chrome addon',
+        'chrome plugin',
+        'web extension',
+        'manifest v3',
+        'manifest v2'
+    ];
+    // Medium confidence patterns (close matches, abbreviations)
+    static MEDIUM_CONFIDENCE = [
+        'chrome ext',
+        'chr ext',
+        'chrome-ext',
+        'chr extension',
+        'extension for chrome',
+        'chrome browser extension',
+        'google chrome extension',
+        'chromium extension',
+        'edge extension', // Edge uses same APIs
+        'browser addon',
+        'browser plug-in'
+    ];
+    // Low confidence patterns (needs confirmation)
+    static LOW_CONFIDENCE = [
+        'extension',
+        'ext',
+        'addon',
+        'plugin',
+        'chrome',
+        'browser',
+        'popup',
+        'content script',
+        'background script',
+        'browser action',
+        'page action'
+    ];
+    // Common typos and their corrections
+    static TYPO_CORRECTIONS = {
+        'chrom extension': 'chrome extension',
+        'chrome extention': 'chrome extension',
+        'chrome exension': 'chrome extension',
+        'chrome extenstion': 'chrome extension',
+        'crome extension': 'chrome extension',
+        'chrome extnsion': 'chrome extension',
+        'chorme extension': 'chrome extension',
+        'chrome etension': 'chrome extension',
+        'chormeextension': 'chrome extension',
+        'chromeext': 'chrome extension',
+        'c-ext': 'chrome extension',
+        'c.ext': 'chrome extension',
+        'ch ext': 'chrome extension',
+        'chr-ext': 'chrome extension',
+        'chrome-extension': 'chrome extension',
+        'chrome_extension': 'chrome extension'
+    };
+    /**
+     * Detect if text refers to a Chrome Extension with Google-style intelligence
+     */
+    static detect(text) {
+        if (!text) {
+            return { detected: false, confidence: 'none', needsConfirmation: false };
+        }
+        const normalized = text.toLowerCase().trim();
+        // Step 1: Check for typos and auto-correct
+        const corrected = this.correctTypos(normalized);
+        if (corrected !== normalized) {
+            // We auto-corrected a typo
+            return {
+                detected: true,
+                confidence: 'medium',
+                suggestion: `Chrome Extension (auto-corrected from "${text}")`,
+                needsConfirmation: false
+            };
+        }
+        // Step 2: Check high confidence patterns
+        for (const pattern of this.HIGH_CONFIDENCE) {
+            if (normalized.includes(pattern)) {
+                return {
+                    detected: true,
+                    confidence: 'high',
+                    needsConfirmation: false
+                };
+            }
+        }
+        // Step 3: Check medium confidence patterns
+        for (const pattern of this.MEDIUM_CONFIDENCE) {
+            if (normalized.includes(pattern) ||
+                this.fuzzyMatch(normalized, pattern)) {
+                return {
+                    detected: true,
+                    confidence: 'medium',
+                    suggestion: 'Chrome Extension',
+                    needsConfirmation: true // "Did you mean Chrome Extension?"
+                };
+            }
+        }
+        // Step 4: Check low confidence patterns
+        for (const pattern of this.LOW_CONFIDENCE) {
+            if (normalized.includes(pattern)) {
+                // Only suggest if there's additional context
+                if (this.hasExtensionContext(normalized)) {
+                    return {
+                        detected: false,
+                        confidence: 'low',
+                        suggestion: 'Chrome Extension',
+                        needsConfirmation: true
+                    };
+                }
+            }
+        }
+        // Step 5: Check for split/spaced variations
+        if (this.hasSpacedPattern(normalized)) {
+            return {
+                detected: true,
+                confidence: 'medium',
+                suggestion: 'Chrome Extension',
+                needsConfirmation: true
+            };
+        }
+        return { detected: false, confidence: 'none', needsConfirmation: false };
+    }
+    /**
+     * Correct common typos
+     */
+    static correctTypos(text) {
+        // Direct typo lookup
+        if (this.TYPO_CORRECTIONS[text]) {
+            return this.TYPO_CORRECTIONS[text];
+        }
+        // Check if any typo pattern is in the text
+        for (const [typo, correction] of Object.entries(this.TYPO_CORRECTIONS)) {
+            if (text.includes(typo)) {
+                return text.replace(typo, correction);
+            }
+        }
+        return text;
+    }
+    /**
+     * Fuzzy match with Levenshtein distance
+     */
+    static fuzzyMatch(text, pattern, threshold = 3) {
+        // Check if text contains something close to pattern
+        const words = text.split(/\s+/);
+        for (const word of words) {
+            if (this.levenshteinDistance(word, pattern) <= threshold) {
+                return true;
+            }
+        }
+        // Check the whole phrase
+        return this.levenshteinDistance(text, pattern) <= threshold;
+    }
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    static levenshteinDistance(a, b) {
+        const matrix = [];
+        for (let i = 0; i <= b.length; i++) {
+            matrix[i] = [i];
+        }
+        for (let j = 0; j <= a.length; j++) {
+            matrix[0][j] = j;
+        }
+        for (let i = 1; i <= b.length; i++) {
+            for (let j = 1; j <= a.length; j++) {
+                if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                    matrix[i][j - 1] + 1, // insertion
+                    matrix[i - 1][j] + 1 // deletion
+                    );
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+    /**
+     * Check for extension-related context
+     */
+    static hasExtensionContext(text) {
+        const contextWords = [
+            'tab', 'popup', 'browser', 'chrome', 'manifest',
+            'content', 'background', 'inject', 'page', 'action',
+            'storage', 'permissions', 'google', 'store'
+        ];
+        return contextWords.some(word => text.includes(word));
+    }
+    /**
+     * Check for spaced patterns like "c e" or "ch ext"
+     */
+    static hasSpacedPattern(text) {
+        const spacedPatterns = [
+            /c\s+e\s+x?\s*t/, // c e, c e x t
+            /ch\s+ext/, // ch ext
+            /chr\s+ext/, // chr ext
+            /ext\s+for\s+chr/, // ext for chr
+            /chrome\s+ex\b/ // chrome ex
+        ];
+        return spacedPatterns.some(pattern => pattern.test(text));
+    }
+    /**
+     * Get user-friendly confirmation message
+     */
+    static getConfirmationMessage(result) {
+        if (!result.needsConfirmation) {
+            return null;
+        }
+        if (result.confidence === 'medium') {
+            return `Did you mean: Chrome Extension? (detected "${result.suggestion}")`;
+        }
+        if (result.confidence === 'low') {
+            return `Possible Chrome Extension detected. Did you mean to create a Chrome Extension?`;
+        }
+        return null;
+    }
+    /**
+     * Check if project has Chrome Extension files (for validation)
+     */
+    static hasExtensionFiles(files) {
+        const extensionFiles = [
+            'manifest.json',
+            'popup.html',
+            'popup.js',
+            'background.js',
+            'content.js',
+            'options.html',
+            'service-worker.js'
+        ];
+        return files.some(file => extensionFiles.some(extFile => file.endsWith(extFile)));
+    }
+}
+exports.ChromeExtensionDetector = ChromeExtensionDetector;
+/**
+ * Examples of detection:
+ *
+ * HIGH confidence (auto-accept):
+ * - "chrome extension" → ✅
+ * - "browser extension" → ✅
+ *
+ * MEDIUM confidence (needs confirmation):
+ * - "chr ext" → "Did you mean Chrome Extension?"
+ * - "c ext" → "Did you mean Chrome Extension?"
+ * - "CE" → "Did you mean Chrome Extension?"
+ *
+ * TYPO correction (auto-fix):
+ * - "chrom extention" → ✅ (corrected)
+ * - "chrome extnsion" → ✅ (corrected)
+ *
+ * LOW confidence (suggest if context):
+ * - "extension for managing tabs" → "Possible Chrome Extension?"
+ * - "popup manager" → "Possible Chrome Extension?"
+ */ 
+//# sourceMappingURL=chrome-extension-detector.js.map

package/dist/src/faf-core/utils/chrome-extension-detector.js.map

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

package/dist/src/faf-core/utils/fafignore-parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 🚫 .fafignore Parser
+ * Handles exclusion patterns for .faf file generation
+ */
+/**
+ * Parse .fafignore file and return patterns
+ */
+export declare function parseFafIgnore(projectRoot: string): Promise<string[]>;
+/**
+ * Check if a file path should be ignored
+ */
+export declare function shouldIgnore(filePath: string, patterns: string[]): boolean;
+/**
+ * Create a default .fafignore file with helpful comments
+ */
+export declare function createDefaultFafIgnore(projectRoot: string): Promise<void>;
+/**
+ * Get file size limit for inclusion (default 1MB)
+ */
+export declare function getFileSizeLimit(): number;

package/dist/src/faf-core/utils/fafignore-parser.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * 🚫 .fafignore Parser
+ * Handles exclusion patterns for .faf file generation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFafIgnore = parseFafIgnore;
+exports.shouldIgnore = shouldIgnore;
+exports.createDefaultFafIgnore = createDefaultFafIgnore;
+exports.getFileSizeLimit = getFileSizeLimit;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const file_utils_1 = require("./file-utils");
+/**
+ * Default patterns to always exclude
+ * These are common directories/files that shouldn't be in AI context
+ */
+const DEFAULT_IGNORE_PATTERNS = [
+    // JavaScript/Node
+    "node_modules/",
+    "dist/",
+    "build/",
+    "coverage/",
+    ".next/",
+    ".nuxt/",
+    "out/",
+    // Python
+    "__pycache__/",
+    "*.pyc",
+    ".venv/",
+    "venv/",
+    ".pytest_cache/",
+    ".mypy_cache/",
+    // Version Control
+    ".git/",
+    ".svn/",
+    ".hg/",
+    // IDE/Editor
+    ".vscode/",
+    ".idea/",
+    "*.swp",
+    ".DS_Store",
+    // Sensitive files
+    ".env",
+    ".env.*",
+    "*.key",
+    "*.pem",
+    "*.cert",
+    // Logs and temp
+    "*.log",
+    "logs/",
+    "tmp/",
+    "temp/",
+    // Package files
+    "*.tgz",
+    "*.tar.gz",
+    "*.zip",
+    // Media files (usually not needed for code context)
+    "*.jpg",
+    "*.jpeg",
+    "*.png",
+    "*.gif",
+    "*.mp4",
+    "*.mov",
+    "*.avi",
+];
+/**
+ * Parse .fafignore file and return patterns
+ */
+async function parseFafIgnore(projectRoot) {
+    const fafIgnorePath = path_1.default.join(projectRoot, ".fafignore");
+    // Start with default patterns
+    let patterns = [...DEFAULT_IGNORE_PATTERNS];
+    // Check if .fafignore exists
+    if (await (0, file_utils_1.fileExists)(fafIgnorePath)) {
+        try {
+            const content = await fs_1.promises.readFile(fafIgnorePath, "utf-8");
+            const userPatterns = content
+                .split("\n")
+                .map((line) => line.trim())
+                .filter((line) => line && !line.startsWith("#")); // Remove empty lines and comments
+            // Add user patterns
+            patterns = [...patterns, ...userPatterns];
+        }
+        catch {
+            console.warn("Warning: Could not read .fafignore file");
+        }
+    }
+    // Remove duplicates
+    return [...new Set(patterns)];
+}
+/**
+ * Check if a file path should be ignored
+ */
+function shouldIgnore(filePath, patterns) {
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    for (const pattern of patterns) {
+        // Handle directory patterns (ending with /)
+        if (pattern.endsWith("/")) {
+            const dir = pattern.slice(0, -1);
+            if (normalizedPath.includes(`/${dir}/`) ||
+                normalizedPath.startsWith(`${dir}/`)) {
+                return true;
+            }
+        }
+        // Handle file extension patterns (*.ext)
+        if (pattern.startsWith("*.")) {
+            const ext = pattern.slice(1);
+            if (normalizedPath.endsWith(ext)) {
+                return true;
+            }
+        }
+        // Handle exact matches
+        if (normalizedPath.includes(pattern) || normalizedPath.endsWith(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Create a default .fafignore file with helpful comments
+ */
+async function createDefaultFafIgnore(projectRoot) {
+    const fafIgnorePath = path_1.default.join(projectRoot, ".fafignore");
+    const content = `# .fafignore - Exclude files/directories from .faf context
+# Similar to .gitignore syntax
+# Lines starting with # are comments
+
+# Dependencies and build outputs
+node_modules/
+dist/
+build/
+coverage/
+
+# Python environments
+__pycache__/
+venv/
+.venv/
+
+# IDE and system files
+.vscode/
+.idea/
+.DS_Store
+
+# Sensitive files
+.env
+.env.*
+*.key
+*.pem
+
+# Logs and temporary files
+*.log
+logs/
+tmp/
+temp/
+
+# Large media files
+*.jpg
+*.png
+*.mp4
+*.pdf
+
+# Custom exclusions (add your own below)
+# example: my-large-data-folder/
+# example: *.generated.ts
+`;
+    await fs_1.promises.writeFile(fafIgnorePath, content, "utf-8");
+}
+/**
+ * Get file size limit for inclusion (default 1MB)
+ */
+function getFileSizeLimit() {
+    return 1024 * 1024; // 1MB
+}
+//# sourceMappingURL=fafignore-parser.js.map

package/dist/src/faf-core/utils/fafignore-parser.js.map

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

package/dist/src/faf-core/utils/file-utils.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 📁 File Utilities
+ * Helper functions for finding and working with .faf files
+ */
+/**
+ * Find project.faf file in current directory or parent directories
+ *
+ * v3.0.0: ONLY supports project.faf (no legacy .faf support)
+ */
+export declare function findFafFile(startDir?: string): Promise<string | null>;
+/**
+ * Check if file exists and is readable
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Get file modification time
+ */
+export declare function getFileModTime(filePath: string): Promise<Date | null>;
+/**
+ * Find package.json in project
+ */
+export declare function findPackageJson(startDir?: string): Promise<string | null>;
+/**
+ * Find pyproject.toml in project (Python Poetry/PEP 518)
+ */
+export declare function findPyprojectToml(startDir?: string): Promise<string | null>;
+/**
+ * Find requirements.txt in project (Python pip)
+ */
+export declare function findRequirementsTxt(startDir?: string): Promise<string | null>;
+/**
+ * Find tsconfig.json in project (TypeScript)
+ */
+export declare function findTsConfig(startDir?: string): Promise<string | null>;
+/**
+ * Analyze tsconfig.json for F1-Inspired TypeScript intelligence
+ */
+export declare function analyzeTsConfig(filePath: string): Promise<TypeScriptContext | null>;
+export interface TypeScriptContext {
+    target: string;
+    module: string;
+    moduleResolution: string;
+    strict: boolean;
+    strictnessLevel: "basic" | "strict" | "ultra_strict" | "f1_inspired";
+    frameworkIntegration: string;
+    performanceOptimizations: string[];
+    includes: string[];
+    excludes: string[];
+    engineeringQuality: "standard" | "professional" | "f1_inspired";
+}
+/**
+ * Detect n8n workflow files in directory
+ */
+export declare function findN8nWorkflows(projectDir?: string): Promise<string[]>;
+/**
+ * Find Make.com scenario files in a project directory
+ *
+ * Detects Make.com blueprint JSON files by checking for:
+ * - name string (scenario name)
+ * - flow array (modules/steps)
+ * - metadata object (scenario metadata)
+ *
+ * @param projectDir - Directory to search (defaults to cwd)
+ * @returns Array of Make.com scenario file names
+ */
+export declare function findMakeScenarios(projectDir?: string): Promise<string[]>;
+/**
+ * Find Google Opal mini-app files in a project directory
+ *
+ * Detects Opal mini-app JSON files by checking for:
+ * - steps array (mini-app steps)
+ * - model string (AI model used)
+ *
+ * @param projectDir - Directory to search (defaults to cwd)
+ * @returns Array of Opal mini-app file names
+ */
+export declare function findOpalMiniApps(projectDir?: string): Promise<string[]>;
+/**
+ * Find OpenAI Assistant files in a project directory
+ *
+ * Detects OpenAI Assistant JSON files (OpenAPI 3.x schemas) by checking for:
+ * - openapi string (OpenAPI version)
+ * - paths object (API endpoints/actions)
+ *
+ * @param projectDir - Directory to search (defaults to cwd)
+ * @returns Array of OpenAI Assistant file names
+ */
+export declare function findOpenAIAssistants(projectDir?: string): Promise<string[]>;
+/**
+ * Detect project type from files and structure
+ *
+ * CHAMPIONSHIP DETECTION STRATEGY:
+ * 1. 😽 TURBO-CAT: Format discovery (finds config files)
+ * 2. 🛂 TSA: Dependency intelligence (analyzes actual usage)
+ * 3. Cross-reference both engines for definitive answer
+ * 4. Fallback to file patterns if engines unavailable
+ *
+ * Goal: Championship-grade detection using existing engines
+ */
+export declare function detectProjectType(projectDir?: string): Promise<string>;
+/**
+ * Calculate days since file was modified
+ */
+export declare function daysSinceModified(date: Date): number;
+/**
+ * Detect Python project type using dependency files (Option A)
+ */
+export declare function detectPythonProjectType(projectDir: string): Promise<string>;
+/**
+ * Detect Python frameworks using code patterns (Option B)
+ */
+export declare function detectPythonPatterns(projectDir: string, pythonFiles: string[]): Promise<string>;