faf-mcp 1.0.0

package/dist/src/compiler/type-detector.js

@@ -0,0 +1,388 @@
+"use strict";
+/**
+ * Project Type Detector - FAF Compiler Engine MK3
+ * Championship-grade type detection with intelligent confidence scoring
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectTypeDetector = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const project_types_1 = require("../types/project-types");
+class ProjectTypeDetector {
+    projectPath;
+    packageJson = null;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Detect project type from file system analysis
+     */
+    async detect() {
+        // Load package.json if it exists
+        await this.loadPackageJson();
+        // Detection priority (as per spec)
+        // 1. Explicit markers
+        const explicitType = this.detectExplicitMarkers();
+        if (explicitType) {
+            return this.createResult(explicitType.type, explicitType.confidence, explicitType.reasoning);
+        }
+        // 2. Framework signatures
+        const frameworkType = this.detectFrameworkSignatures();
+        if (frameworkType) {
+            return this.createResult(frameworkType.type, frameworkType.confidence, frameworkType.reasoning);
+        }
+        // 3. Structure analysis
+        const structureType = await this.analyzeStructure();
+        if (structureType) {
+            return this.createResult(structureType.type, structureType.confidence, structureType.reasoning);
+        }
+        // 4. Package.json analysis
+        const packageType = this.analyzePackageJson();
+        if (packageType) {
+            return this.createResult(packageType.type, packageType.confidence, packageType.reasoning);
+        }
+        // 5. Default to full-stack (safe fallback)
+        return this.createResult('full-stack', 50, 'Defaulted to full-stack (unable to determine specific type)');
+    }
+    /**
+     * Check for explicit file markers
+     */
+    detectExplicitMarkers() {
+        // Browser extension
+        if (this.hasFile('manifest.json')) {
+            return {
+                type: 'browser-extension',
+                confidence: 95,
+                reasoning: 'Found manifest.json (browser extension marker)',
+            };
+        }
+        // Documentation site
+        if (this.hasFile('docusaurus.config.js') || this.hasFile('docusaurus.config.ts')) {
+            return {
+                type: 'docs-site',
+                confidence: 95,
+                reasoning: 'Found Docusaurus config',
+            };
+        }
+        if (this.hasFile('vitepress.config.js') || this.hasFile('vitepress.config.ts') || this.hasFile('.vitepress/config.js')) {
+            return {
+                type: 'docs-site',
+                confidence: 95,
+                reasoning: 'Found VitePress config',
+            };
+        }
+        if (this.hasFile('nextra.config.js') || this.hasFile('next.config.js')) {
+            const hasDocs = this.hasDirectory('pages') || this.hasDirectory('docs');
+            if (hasDocs) {
+                return {
+                    type: 'docs-site',
+                    confidence: 90,
+                    reasoning: 'Found Next.js config with docs structure',
+                };
+            }
+        }
+        // Monorepo
+        if (this.hasFile('pnpm-workspace.yaml')) {
+            return {
+                type: 'monorepo',
+                confidence: 95,
+                reasoning: 'Found pnpm-workspace.yaml',
+            };
+        }
+        if (this.hasFile('lerna.json')) {
+            return {
+                type: 'monorepo',
+                confidence: 95,
+                reasoning: 'Found lerna.json',
+            };
+        }
+        if (this.hasFile('nx.json')) {
+            return {
+                type: 'monorepo',
+                confidence: 95,
+                reasoning: 'Found nx.json (Nx monorepo)',
+            };
+        }
+        if (this.hasFile('turbo.json')) {
+            return {
+                type: 'monorepo',
+                confidence: 95,
+                reasoning: 'Found turbo.json (Turborepo)',
+            };
+        }
+        // Serverless
+        if (this.hasFile('serverless.yml') || this.hasFile('serverless.yaml')) {
+            return {
+                type: 'serverless',
+                confidence: 95,
+                reasoning: 'Found serverless config',
+            };
+        }
+        // Microservices
+        if (this.hasFile('docker-compose.yml') || this.hasFile('docker-compose.yaml')) {
+            if (this.hasDirectory('k8s') || this.hasDirectory('kubernetes')) {
+                return {
+                    type: 'microservices',
+                    confidence: 90,
+                    reasoning: 'Found docker-compose + k8s configs',
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Detect framework signatures from dependencies
+     */
+    detectFrameworkSignatures() {
+        if (!this.packageJson)
+            return null;
+        const allDeps = {
+            ...this.packageJson.dependencies,
+            ...this.packageJson.devDependencies,
+        };
+        // MCP Server
+        if (allDeps['@modelcontextprotocol/sdk']) {
+            return {
+                type: 'mcp-server',
+                confidence: 95,
+                reasoning: 'Found @modelcontextprotocol/sdk dependency',
+            };
+        }
+        // Desktop app
+        if (allDeps['electron'] || allDeps['@tauri-apps/api']) {
+            return {
+                type: 'desktop-app',
+                confidence: 95,
+                reasoning: allDeps['electron'] ? 'Found Electron dependency' : 'Found Tauri dependency',
+            };
+        }
+        // Mobile app
+        if (allDeps['react-native'] || allDeps['expo']) {
+            return {
+                type: 'mobile-app',
+                confidence: 95,
+                reasoning: allDeps['react-native'] ? 'Found React Native dependency' : 'Found Expo dependency',
+            };
+        }
+        if (allDeps['flutter']) {
+            return {
+                type: 'mobile-app',
+                confidence: 95,
+                reasoning: 'Found Flutter dependency',
+            };
+        }
+        return null;
+    }
+    /**
+     * Analyze project structure
+     */
+    async analyzeStructure() {
+        const hasFrontend = this.hasFrontendFramework();
+        const hasBackend = this.hasBackendFramework();
+        const hasDatabase = this.hasDatabaseDependency();
+        // Full-stack (all three)
+        if (hasFrontend && hasBackend && hasDatabase) {
+            return {
+                type: 'full-stack',
+                confidence: 90,
+                reasoning: 'Has frontend + backend + database',
+            };
+        }
+        // API backend (backend, no frontend)
+        if (hasBackend && !hasFrontend) {
+            return {
+                type: 'api-backend',
+                confidence: 85,
+                reasoning: 'Has backend framework, no frontend',
+            };
+        }
+        // SPA or Vibe site (frontend, no backend)
+        if (hasFrontend && !hasBackend) {
+            const isStaticOnly = await this.isStaticOnly();
+            if (isStaticOnly) {
+                return {
+                    type: 'vibe-site',
+                    confidence: 80,
+                    reasoning: 'Static site with minimal dependencies',
+                };
+            }
+            return {
+                type: 'spa',
+                confidence: 85,
+                reasoning: 'Has frontend framework, no backend',
+            };
+        }
+        return null;
+    }
+    /**
+     * Analyze package.json for library/CLI patterns
+     */
+    analyzePackageJson() {
+        if (!this.packageJson)
+            return null;
+        // CLI tool
+        if (this.packageJson.bin) {
+            return {
+                type: 'cli-tool',
+                confidence: 90,
+                reasoning: 'Has bin field in package.json',
+            };
+        }
+        // Library
+        if (this.packageJson.main || this.packageJson.exports) {
+            const hasSrcDir = this.hasDirectory('src');
+            const hasNoAppStructure = !this.hasDirectory('pages') && !this.hasDirectory('app') && !this.hasDirectory('routes');
+            if (hasSrcDir && hasNoAppStructure) {
+                return {
+                    type: 'library',
+                    confidence: 85,
+                    reasoning: 'Has main/exports field with library structure',
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Create TypeDetectionResult from detected type
+     */
+    createResult(type, confidence, reasoning) {
+        return {
+            type,
+            confidence,
+            slotignore: project_types_1.SLOT_IGNORE_BY_TYPE[type],
+            relevantSlots: project_types_1.RELEVANT_SLOTS_BY_TYPE[type],
+            reasoning,
+        };
+    }
+    /**
+     * Helper: Check if file exists
+     */
+    hasFile(fileName) {
+        try {
+            const filePath = path.join(this.projectPath, fileName);
+            return fs.existsSync(filePath) && fs.statSync(filePath).isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Helper: Check if directory exists
+     */
+    hasDirectory(dirName) {
+        try {
+            const dirPath = path.join(this.projectPath, dirName);
+            return fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Helper: Load package.json
+     */
+    async loadPackageJson() {
+        try {
+            const pkgPath = path.join(this.projectPath, 'package.json');
+            if (fs.existsSync(pkgPath)) {
+                const content = fs.readFileSync(pkgPath, 'utf-8');
+                this.packageJson = JSON.parse(content);
+            }
+        }
+        catch {
+            // Silently fail if package.json doesn't exist or can't be parsed
+        }
+    }
+    /**
+     * Helper: Check if has frontend framework
+     */
+    hasFrontendFramework() {
+        if (!this.packageJson)
+            return false;
+        const allDeps = {
+            ...this.packageJson.dependencies,
+            ...this.packageJson.devDependencies,
+        };
+        const frontendFrameworks = ['react', 'vue', 'svelte', '@angular/core', 'solid-js', 'preact'];
+        return frontendFrameworks.some(fw => allDeps[fw]);
+    }
+    /**
+     * Helper: Check if has backend framework
+     */
+    hasBackendFramework() {
+        if (!this.packageJson)
+            return false;
+        const allDeps = {
+            ...this.packageJson.dependencies,
+            ...this.packageJson.devDependencies,
+        };
+        const backendFrameworks = ['express', 'koa', 'hono', '@hono/node-server', 'fastify', 'nestjs'];
+        return backendFrameworks.some(fw => allDeps[fw]);
+    }
+    /**
+     * Helper: Check if has database dependency
+     */
+    hasDatabaseDependency() {
+        if (!this.packageJson)
+            return false;
+        const allDeps = {
+            ...this.packageJson.dependencies,
+            ...this.packageJson.devDependencies,
+        };
+        const databases = ['pg', 'mysql', 'mongodb', 'mongoose', 'prisma', '@supabase/supabase-js', 'sqlite3', 'better-sqlite3'];
+        return databases.some(db => allDeps[db]);
+    }
+    /**
+     * Helper: Check if static-only site
+     */
+    async isStaticOnly() {
+        if (!this.packageJson)
+            return true;
+        const allDeps = {
+            ...this.packageJson.dependencies,
+            ...this.packageJson.devDependencies,
+        };
+        // Count total dependencies
+        const depCount = Object.keys(allDeps).length;
+        // Static sites typically have < 10 dependencies
+        // and no server/state management libraries
+        const hasServerDeps = allDeps['express'] || allDeps['next'] || allDeps['@sveltejs/kit'];
+        const hasStateMgmt = allDeps['redux'] || allDeps['zustand'] || allDeps['@tanstack/react-query'];
+        return depCount < 10 && !hasServerDeps && !hasStateMgmt;
+    }
+}
+exports.ProjectTypeDetector = ProjectTypeDetector;
+//# sourceMappingURL=type-detector.js.map

package/dist/src/compiler/type-detector.js.map

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

package/dist/src/config/visibility.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 🏎️ FAF Tool Visibility Configuration - v2.8.0
+ * Controls which tools are visible (core vs all)
+ * Championship-grade configuration management
+ */
+export interface VisibilityConfig {
+    showAdvanced: boolean;
+    source: 'env' | 'flag' | 'config' | 'default';
+}
+export interface FafConfig {
+    showAdvanced?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Get visibility configuration from multiple sources
+ * Priority: ENV var > config file > default
+ */
+export declare function getVisibilityConfig(): VisibilityConfig;
+/**
+ * Read configuration from .fafrc file
+ * Checks multiple locations:
+ * 1. ~/.fafrc (home directory)
+ * 2. ./.fafrc (current working directory)
+ */
+export declare function readConfigFile(): FafConfig | null;
+/**
+ * Write configuration to ~/.fafrc file
+ */
+export declare function writeConfigFile(config: FafConfig): boolean;
+/**
+ * Enable advanced tools
+ */
+export declare function enableAdvancedTools(): boolean;
+/**
+ * Disable advanced tools (show core only)
+ */
+export declare function disableAdvancedTools(): boolean;
+/**
+ * Get current tool visibility status (for logging)
+ */
+export declare function getVisibilityStatus(): string;

package/dist/src/config/visibility.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * 🏎️ FAF Tool Visibility Configuration - v2.8.0
+ * Controls which tools are visible (core vs all)
+ * Championship-grade configuration management
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVisibilityConfig = getVisibilityConfig;
+exports.readConfigFile = readConfigFile;
+exports.writeConfigFile = writeConfigFile;
+exports.enableAdvancedTools = enableAdvancedTools;
+exports.disableAdvancedTools = disableAdvancedTools;
+exports.getVisibilityStatus = getVisibilityStatus;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * Get visibility configuration from multiple sources
+ * Priority: ENV var > config file > default
+ */
+function getVisibilityConfig() {
+    // 1. Check ENV: FAF_MCP_SHOW_ADVANCED=true
+    if (process.env.FAF_MCP_SHOW_ADVANCED === 'true') {
+        return { showAdvanced: true, source: 'env' };
+    }
+    // 2. Check config file: ~/.fafrc or .fafrc
+    const configFile = readConfigFile();
+    if (configFile?.showAdvanced === true) {
+        return { showAdvanced: true, source: 'config' };
+    }
+    // 3. Default: core only (changed from "show all" to align with spec)
+    // NOTE: For backward compatibility during transition, you may want to
+    // temporarily set default to `true` and notify users to update config
+    return { showAdvanced: false, source: 'default' };
+}
+/**
+ * Read configuration from .fafrc file
+ * Checks multiple locations:
+ * 1. ~/.fafrc (home directory)
+ * 2. ./.fafrc (current working directory)
+ */
+function readConfigFile() {
+    const configPaths = [
+        path.join(os.homedir(), '.fafrc'),
+        path.join(process.cwd(), '.fafrc'),
+    ];
+    for (const configPath of configPaths) {
+        try {
+            if (fs.existsSync(configPath)) {
+                const content = fs.readFileSync(configPath, 'utf-8');
+                // Support both JSON and simple key=value format
+                if (content.trim().startsWith('{')) {
+                    // JSON format
+                    return JSON.parse(content);
+                }
+                else {
+                    // Simple key=value format
+                    const config = {};
+                    const lines = content.split('\n');
+                    for (const line of lines) {
+                        const trimmed = line.trim();
+                        if (!trimmed || trimmed.startsWith('#'))
+                            continue;
+                        const [key, value] = trimmed.split('=').map((s) => s.trim());
+                        if (key === 'showAdvanced' || key === 'FAF_SHOW_ADVANCED') {
+                            config.showAdvanced = value === 'true';
+                        }
+                    }
+                    return config;
+                }
+            }
+        }
+        catch (error) {
+            // Silently ignore config file errors - graceful degradation
+            // Config file is optional, errors are non-critical
+        }
+    }
+    return null;
+}
+/**
+ * Write configuration to ~/.fafrc file
+ */
+function writeConfigFile(config) {
+    const configPath = path.join(os.homedir(), '.fafrc');
+    try {
+        const content = JSON.stringify(config, null, 2);
+        fs.writeFileSync(configPath, content, 'utf-8');
+        return true;
+    }
+    catch (error) {
+        // Silent failure - config file write is optional
+        return false;
+    }
+}
+/**
+ * Enable advanced tools
+ */
+function enableAdvancedTools() {
+    const config = readConfigFile() || {};
+    config.showAdvanced = true;
+    return writeConfigFile(config);
+}
+/**
+ * Disable advanced tools (show core only)
+ */
+function disableAdvancedTools() {
+    const config = readConfigFile() || {};
+    config.showAdvanced = false;
+    return writeConfigFile(config);
+}
+/**
+ * Get current tool visibility status (for logging)
+ */
+function getVisibilityStatus() {
+    const config = getVisibilityConfig();
+    const toolCount = config.showAdvanced ? '51 (ALL)' : '20 (CORE)';
+    const sourceEmoji = {
+        env: '🌍',
+        flag: '🚩',
+        config: '⚙️',
+        default: '🏁',
+    };
+    return `${sourceEmoji[config.source]} ${toolCount} tools via ${config.source.toUpperCase()}`;
+}
+//# sourceMappingURL=visibility.js.map

package/dist/src/config/visibility.js.map

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

package/dist/src/faf-core/commands/audit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 🔍 faf audit - Comprehensive Quality Audit (Mk3 Bundled)
+ * Audit project.faf quality and completeness
+ */
+export interface AuditOptions {
+    json?: boolean;
+    verbose?: boolean;
+}
+export interface AuditResult {
+    success: boolean;
+    score: number;
+    grade: string;
+    issues: Array<{
+        severity: 'high' | 'medium' | 'low';
+        message: string;
+        fix?: string;
+    }>;
+    strengths: string[];
+    message: string;
+}
+export declare function auditFafFile(projectPath?: string, options?: AuditOptions): Promise<AuditResult>;