faf-mcp 1.0.0

package/dist/src/faf-core/commands/enhance.js

@@ -0,0 +1,360 @@
+"use strict";
+/**
+ * ⚡ FAF Enhance - MCP-native interactive enhancement
+ * Combines auto-detection with intelligent MCP questionnaire
+ */
+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.enhanceCommand = enhanceCommand;
+exports.enhanceWithAnswers = enhanceWithAnswers;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const yaml_1 = require("../fix-once/yaml");
+const file_utils_1 = require("../utils/file-utils");
+const score_1 = require("./score");
+/**
+ * Auto-detect improvements from project files
+ */
+async function autoDetectImprovements(projectPath, fafData) {
+    const improvements = [];
+    const updates = {};
+    // Check for package.json
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    if (await (0, file_utils_1.fileExists)(packageJsonPath)) {
+        const pkgContent = await fs_1.promises.readFile(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(pkgContent);
+        // Detect version
+        if (pkg.version && !fafData.project?.version) {
+            updates['project.version'] = pkg.version;
+            improvements.push('version');
+        }
+        // Detect testing
+        if (pkg.scripts?.test && !fafData.stack?.testing) {
+            updates['stack.testing'] = 'jest/vitest';
+            improvements.push('testing');
+        }
+        // Detect dependencies for framework detection
+        if (pkg.dependencies || pkg.devDependencies) {
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            // Frontend frameworks
+            if (allDeps.react && !fafData.stack?.frontend) {
+                updates['stack.frontend'] = 'React';
+                improvements.push('frontend');
+            }
+            else if (allDeps.vue && !fafData.stack?.frontend) {
+                updates['stack.frontend'] = 'Vue';
+                improvements.push('frontend');
+            }
+            else if (allDeps.svelte && !fafData.stack?.frontend) {
+                updates['stack.frontend'] = 'Svelte';
+                improvements.push('frontend');
+            }
+            // Backend
+            if (allDeps.express && !fafData.stack?.backend) {
+                updates['stack.backend'] = 'Express';
+                improvements.push('backend');
+            }
+            // Database
+            if (allDeps.mongoose && !fafData.stack?.database) {
+                updates['stack.database'] = 'MongoDB';
+                improvements.push('database');
+            }
+            else if (allDeps.pg && !fafData.stack?.database) {
+                updates['stack.database'] = 'PostgreSQL';
+                improvements.push('database');
+            }
+        }
+    }
+    // Detect main language from files
+    if (!fafData.project?.main_language) {
+        const hasTS = await (0, file_utils_1.fileExists)(path.join(projectPath, 'tsconfig.json'));
+        const hasPy = await (0, file_utils_1.fileExists)(path.join(projectPath, 'requirements.txt')) ||
+            await (0, file_utils_1.fileExists)(path.join(projectPath, 'setup.py'));
+        if (hasTS) {
+            updates['project.main_language'] = 'TypeScript';
+            improvements.push('mainLanguage');
+        }
+        else if (hasPy) {
+            updates['project.main_language'] = 'Python';
+            improvements.push('mainLanguage');
+        }
+    }
+    return { improvements, updates };
+}
+/**
+ * Generate questions for missing 6 W's
+ */
+function generateQuestions(fafData) {
+    const questions = [];
+    if (!fafData.human_context?.who) {
+        questions.push({
+            id: 'who',
+            question: 'WHO will use this project?',
+            header: 'Target Users',
+            description: 'Specify your target audience (developers, data scientists, designers, end users, etc.)',
+            defaultValue: 'developers',
+            required: true
+        });
+    }
+    if (!fafData.human_context?.what) {
+        questions.push({
+            id: 'what',
+            question: 'WHAT problem does this project solve?',
+            header: 'Core Problem',
+            description: 'Describe the specific problem or need this project addresses',
+            required: true
+        });
+    }
+    if (!fafData.human_context?.why) {
+        questions.push({
+            id: 'why',
+            question: 'WHY is this project important?',
+            header: 'Value/Impact',
+            description: 'Explain the value or impact this project creates',
+            required: true
+        });
+    }
+    if (!fafData.human_context?.where) {
+        questions.push({
+            id: 'where',
+            question: 'WHERE will this project be deployed/used?',
+            header: 'Environment',
+            description: 'Specify the deployment context (cloud, browser, mobile, on-premise, etc.)',
+            defaultValue: 'cloud',
+            required: false
+        });
+    }
+    if (!fafData.human_context?.when) {
+        questions.push({
+            id: 'when',
+            question: 'WHEN do you need this completed?',
+            header: 'Timeline',
+            description: 'Specify the timeline or urgency (now, Q1 2025, ongoing, etc.)',
+            defaultValue: 'ongoing',
+            required: false
+        });
+    }
+    if (!fafData.human_context?.how) {
+        questions.push({
+            id: 'how',
+            question: 'HOW will you build this?',
+            header: 'Approach',
+            description: 'Describe your development methodology (agile, iterative, waterfall, etc.)',
+            defaultValue: 'agile',
+            required: false
+        });
+    }
+    return questions;
+}
+/**
+ * Apply answers to project.faf
+ */
+function applyAnswers(fafData, answers) {
+    const applied = [];
+    if (!fafData.human_context) {
+        fafData.human_context = {};
+    }
+    if (answers.who) {
+        fafData.human_context.who = answers.who;
+        applied.push('who');
+    }
+    if (answers.what) {
+        fafData.human_context.what = answers.what;
+        applied.push('what');
+    }
+    if (answers.why) {
+        fafData.human_context.why = answers.why;
+        applied.push('why');
+    }
+    if (answers.where) {
+        fafData.human_context.where = answers.where;
+        applied.push('where');
+    }
+    if (answers.when) {
+        fafData.human_context.when = answers.when;
+        applied.push('when');
+    }
+    if (answers.how) {
+        fafData.human_context.how = answers.how;
+        applied.push('how');
+    }
+    // Apply stack improvements
+    if (!fafData.stack) {
+        fafData.stack = {};
+    }
+    if (answers.frontend && !fafData.stack.frontend) {
+        fafData.stack.frontend = answers.frontend;
+        applied.push('frontend');
+    }
+    if (answers.backend && !fafData.stack.backend) {
+        fafData.stack.backend = answers.backend;
+        applied.push('backend');
+    }
+    if (answers.database && !fafData.stack.database) {
+        fafData.stack.database = answers.database;
+        applied.push('database');
+    }
+    if (answers.hosting && !fafData.stack.hosting) {
+        fafData.stack.hosting = answers.hosting;
+        applied.push('hosting');
+    }
+    return applied;
+}
+/**
+ * Calculate score using real FafCompiler
+ */
+async function calculateScore(projectPath) {
+    const fafPath = path.join(projectPath, 'project.faf');
+    const result = await (0, score_1.scoreFafFile)(fafPath);
+    return result.score;
+}
+/**
+ * Main enhance command - auto-detect mode
+ */
+async function enhanceCommand(projectPath, options = {}) {
+    try {
+        // Find project.faf
+        const fafPath = path.join(projectPath, 'project.faf');
+        if (!(await (0, file_utils_1.fileExists)(fafPath))) {
+            return {
+                success: false,
+                initialScore: 0,
+                finalScore: 0,
+                improvements: [],
+                message: 'No project.faf found. Run faf_init first.'
+            };
+        }
+        // Read and parse
+        const content = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(content);
+        const initialScore = await calculateScore(projectPath);
+        // Auto-detect improvements
+        const { improvements, updates } = await autoDetectImprovements(projectPath, fafData);
+        // Apply auto-detected updates
+        for (const [key, value] of Object.entries(updates)) {
+            const keys = key.split('.');
+            let target = fafData;
+            for (let i = 0; i < keys.length - 1; i++) {
+                if (!target[keys[i]]) {
+                    target[keys[i]] = {};
+                }
+                target = target[keys[i]];
+            }
+            target[keys[keys.length - 1]] = value;
+        }
+        // Check if questions needed
+        const questions = generateQuestions(fafData);
+        // If auto-fill only or no questions, finish here
+        if (options.autoFill || questions.length === 0 || !options.interactive) {
+            // Update metadata
+            if (!fafData.meta) {
+                fafData.meta = {};
+            }
+            fafData.meta.last_enhanced = new Date().toISOString();
+            fafData.meta.enhanced_by = 'faf-enhance-auto';
+            // Write back
+            const yamlContent = (0, yaml_1.stringify)(fafData);
+            await fs_1.promises.writeFile(fafPath, yamlContent, 'utf-8');
+            const finalScore = await calculateScore(projectPath);
+            return {
+                success: true,
+                initialScore,
+                finalScore,
+                improvements,
+                message: improvements.length > 0
+                    ? `Auto-enhanced: ${improvements.join(', ')}. Score: ${initialScore}% → ${finalScore}%`
+                    : `Already optimized. Score: ${finalScore}%`
+            };
+        }
+        // Return with questions for interactive mode
+        return {
+            success: true,
+            initialScore,
+            finalScore: initialScore,
+            improvements,
+            questionsNeeded: questions,
+            message: `Auto-detected ${improvements.length} improvements. ${questions.length} questions needed for full enhancement.`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            initialScore: 0,
+            finalScore: 0,
+            improvements: [],
+            message: error instanceof Error ? error.message : 'Enhancement failed'
+        };
+    }
+}
+/**
+ * Apply interactive answers and finalize enhancement
+ */
+async function enhanceWithAnswers(projectPath, answers) {
+    try {
+        const fafPath = path.join(projectPath, 'project.faf');
+        const content = await fs_1.promises.readFile(fafPath, 'utf-8');
+        const fafData = (0, yaml_1.parse)(content);
+        const initialScore = await calculateScore(projectPath);
+        // Apply answers
+        const applied = applyAnswers(fafData, answers);
+        // Update metadata
+        if (!fafData.meta) {
+            fafData.meta = {};
+        }
+        fafData.meta.last_enhanced = new Date().toISOString();
+        fafData.meta.enhanced_by = 'faf-enhance-interactive';
+        // Write back
+        const yamlContent = (0, yaml_1.stringify)(fafData);
+        await fs_1.promises.writeFile(fafPath, yamlContent, 'utf-8');
+        const finalScore = await calculateScore(projectPath);
+        return {
+            success: true,
+            initialScore,
+            finalScore,
+            improvements: applied,
+            message: `Enhanced with ${applied.length} answers. Score: ${initialScore}% → ${finalScore}%`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            initialScore: 0,
+            finalScore: 0,
+            improvements: [],
+            message: error instanceof Error ? error.message : 'Enhancement failed'
+        };
+    }
+}
+//# sourceMappingURL=enhance.js.map

package/dist/src/faf-core/commands/enhance.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * 🏆 faf formats - TURBO-CAT Format Discovery Command (Mk3 Bundled)
+ * Lists all discovered formats in the project
+ */
+export interface FormatsOptions {
+    export?: boolean;
+    json?: boolean;
+    category?: boolean;
+}
+export interface FormatsResult {
+    success: boolean;
+    totalFormats: number;
+    stackSignature: string;
+    intelligenceScore: number;
+    formats: Array<{
+        fileName: string;
+        category: string;
+        confidence: string;
+    }>;
+    message: string;
+}
+export declare function formatsCommand(projectPath?: string, options?: FormatsOptions): Promise<FormatsResult>;

package/dist/src/faf-core/commands/formats.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * 🏆 faf formats - TURBO-CAT Format Discovery Command (Mk3 Bundled)
+ * Lists all discovered formats in the project
+ */
+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.formatsCommand = formatsCommand;
+const path = __importStar(require("path"));
+const file_utils_1 = require("../utils/file-utils");
+async function formatsCommand(projectPath, options = {}) {
+    try {
+        const projectRoot = projectPath || process.cwd();
+        const startTime = Date.now();
+        // Simple format detection - check for common files
+        const commonFormats = [
+            'package.json',
+            'tsconfig.json',
+            'README.md',
+            '.gitignore',
+            'vite.config.ts',
+            'svelte.config.js',
+            'tailwind.config.js',
+            'Dockerfile',
+            '.env',
+            'project.faf',
+            '.faf'
+        ];
+        const foundFormats = [];
+        for (const format of commonFormats) {
+            const filePath = path.join(projectRoot, format);
+            if (await (0, file_utils_1.fileExists)(filePath)) {
+                foundFormats.push({
+                    fileName: format,
+                    category: categorizeFormat(format),
+                    confidence: 'confirmed'
+                });
+            }
+        }
+        const elapsedTime = Date.now() - startTime;
+        return {
+            success: true,
+            totalFormats: foundFormats.length,
+            stackSignature: 'Detected',
+            intelligenceScore: foundFormats.length * 5,
+            formats: foundFormats,
+            message: `Found ${foundFormats.length} formats in ${elapsedTime}ms`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            totalFormats: 0,
+            stackSignature: 'Unknown',
+            intelligenceScore: 0,
+            formats: [],
+            message: error instanceof Error ? error.message : 'Format discovery failed'
+        };
+    }
+}
+function categorizeFormat(fileName) {
+    if (fileName.includes('json') || fileName.includes('yaml') || fileName.includes('toml')) {
+        return 'Config';
+    }
+    else if (fileName.includes('.ts') || fileName.includes('.js') || fileName.includes('.py')) {
+        return 'Code';
+    }
+    else if (fileName.includes('.md') || fileName.includes('README')) {
+        return 'Documentation';
+    }
+    else if (fileName.includes('test') || fileName.includes('spec')) {
+        return 'Testing';
+    }
+    else if (fileName.includes('workflow') || fileName.includes('jenkins')) {
+        return 'CI/CD';
+    }
+    else if (fileName.includes('docker') || fileName.includes('compose')) {
+        return 'Container';
+    }
+    else if (fileName.includes('.sql') || fileName.includes('migration')) {
+        return 'Database';
+    }
+    return 'Other';
+}
+//# sourceMappingURL=formats.js.map

package/dist/src/faf-core/commands/formats.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * faf init - Programmatic API (MCP-ready)
+ * No console output, returns structured data
+ */
+export interface InitOptions {
+    force?: boolean;
+    new?: boolean;
+    choose?: boolean;
+    template?: string;
+    output?: string;
+    quiet?: boolean;
+}
+export interface InitResult {
+    success: boolean;
+    outputPath?: string;
+    projectType?: string;
+    score?: number;
+    duration?: number;
+    error?: string;
+    alreadyExists?: boolean;
+}
+/**
+ * Initialize .faf file - programmatic API
+ * Returns structured data, no console output
+ */
+export declare function initFafFile(projectPath?: string, options?: InitOptions): Promise<InitResult>;

package/dist/src/faf-core/commands/init.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * faf init - Programmatic API (MCP-ready)
+ * No console output, returns structured data
+ */
+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.initFafFile = initFafFile;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const file_utils_js_1 = require("../utils/file-utils.js");
+const faf_generator_championship_js_1 = require("../generators/faf-generator-championship.js");
+const fafignore_parser_js_1 = require("../utils/fafignore-parser.js");
+const faf_compiler_js_1 = require("../compiler/faf-compiler.js");
+/**
+ * Initialize .faf file - programmatic API
+ * Returns structured data, no console output
+ */
+async function initFafFile(projectPath, options = {}) {
+    const startTime = Date.now();
+    try {
+        const projectRoot = projectPath || process.cwd();
+        const homeDir = require('os').homedir();
+        // CRITICAL: Prevent running in home or root directory
+        if (!projectPath && (projectRoot === homeDir || projectRoot === '/')) {
+            return {
+                success: false,
+                error: 'Cannot run in home or root directory for safety',
+                duration: Date.now() - startTime
+            };
+        }
+        // v3.0.0: ONLY supports project.faf (no legacy .faf)
+        const outputPath = options.output || `${projectRoot}/project.faf`;
+        // Check if project.faf file already exists
+        if ((await (0, file_utils_js_1.fileExists)(outputPath)) && !options.force && !options.new && !options.choose) {
+            return {
+                success: true,
+                alreadyExists: true,
+                outputPath,
+                duration: Date.now() - startTime
+            };
+        }
+        // Check for .fafignore
+        const fafIgnorePath = path.join(projectRoot, '.fafignore');
+        if (!(await (0, file_utils_js_1.fileExists)(fafIgnorePath))) {
+            await (0, fafignore_parser_js_1.createDefaultFafIgnore)(projectRoot);
+        }
+        // Detect project structure
+        const projectType = options.template === 'auto'
+            ? await (0, file_utils_js_1.detectProjectType)(projectRoot)
+            : options.template || (await (0, file_utils_js_1.detectProjectType)(projectRoot));
+        // Generate .faf content
+        const fafContent = await (0, faf_generator_championship_js_1.generateFafFromProject)({
+            projectType,
+            outputPath,
+            projectRoot: projectRoot,
+        });
+        // Write .faf file
+        await fs_1.promises.writeFile(outputPath, fafContent, 'utf-8');
+        // Score the newly created file
+        const compiler = new faf_compiler_js_1.FafCompiler();
+        const scoreResult = await compiler.compile(outputPath);
+        const duration = Date.now() - startTime;
+        return {
+            success: true,
+            outputPath,
+            projectType,
+            score: scoreResult.score,
+            duration
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : 'Init failed';
+        return {
+            success: false,
+            error: errorMessage,
+            duration
+        };
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/src/faf-core/commands/init.js.map

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