faf-mcp 2.3.1 → 3.0.1

package/dist/src/utils/auto-path-detection.js

@@ -1,198 +0,0 @@
-"use strict";
-/**
- * 🎯 Auto-Path Detection from Dropped Files
- * Solves the "drop and done" workflow problem
- *
- * When files land in /mnt/user-data/uploads/, extract identifiers
- * and perform case-insensitive filesystem search to find real project path.
- */
-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.extractIdentifier = extractIdentifier;
-exports.findProjectPath = findProjectPath;
-exports.autoDetectPath = autoDetectPath;
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-/**
- * Extract project identifier from dropped file
- */
-function extractIdentifier(filePath) {
-    try {
-        const content = fs.readFileSync(filePath, 'utf8');
-        const basename = path.basename(filePath);
-        // package.json - use package name
-        if (basename === 'package.json') {
-            try {
-                const pkg = JSON.parse(content);
-                if (pkg.name) {
-                    return pkg.name; // "@blackhole/universe" or "hextra-api"
-                }
-            }
-            catch {
-                // Invalid JSON, continue to next strategy
-            }
-        }
-        // README.md - extract from first heading
-        if (basename === 'README.md') {
-            const match = content.match(/^#\s+(.+)$/m);
-            if (match) {
-                // "💫 Black Hole Universe" → "black-hole-universe"
-                return match[1]
-                    .replace(/[^\w\s-]/g, '') // Remove emojis/special chars
-                    .trim()
-                    .toLowerCase()
-                    .replace(/\s+/g, '-');
-            }
-        }
-        // project.faf or .faf - extract name field
-        if (basename === 'project.faf' || basename === '.faf') {
-            const match = content.match(/^\s*name:\s*"?([^"\n]+)"?/m);
-            if (match) {
-                return match[1].trim();
-            }
-        }
-        return null;
-    }
-    catch (error) {
-        return null;
-    }
-}
-/**
- * Find project path on user's filesystem (case-insensitive)
- */
-function findProjectPath(identifier) {
-    try {
-        const username = os.userInfo().username;
-        // Search roots in order of preference
-        const searchRoots = [
-            `/Users/${username}`, // macOS
-            `/home/${username}`, // Linux
-            `C:\\Users\\${username}` // Windows
-        ].filter(p => fs.existsSync(p));
-        if (searchRoots.length === 0) {
-            return null;
-        }
-        // Normalize identifier for search
-        // Remove scope: @blackhole/universe → universe
-        let searchTerm = identifier.replace(/^@[\w-]+\//, '').toLowerCase();
-        // Try exact match first, then partial match
-        for (const exact of [true, false]) {
-            for (const root of searchRoots) {
-                const pattern = exact ? searchTerm : `*${searchTerm}*`;
-                // Case-insensitive find with exclusions
-                const cmd = process.platform === 'win32'
-                    ? `dir /s /b /a:d "${root}\\${pattern}" 2>nul`
-                    : `find "${root}" -maxdepth 5 -type d -iname "${pattern}" \
-             ! -path "*/node_modules/*" \
-             ! -path "*/.git/*" \
-             ! -path "*/dist/*" \
-             ! -path "*/build/*" \
-             ! -path "*/.next/*" \
-             ! -path "*/coverage/*" \
-             ! -path "*/.cache/*" \
-             ! -path "*/venv/*" \
-             ! -path "*/.venv/*" \
-             2>/dev/null`;
-                try {
-                    const result = (0, child_process_1.execSync)(cmd, {
-                        encoding: 'utf8',
-                        timeout: 10000,
-                        maxBuffer: 1024 * 1024 // 1MB buffer
-                    });
-                    const matches = result.split('\n').filter(Boolean);
-                    if (matches.length > 0) {
-                        // Rank matches: exact basename > partial, shorter > longer
-                        const ranked = matches.sort((a, b) => {
-                            const aBase = path.basename(a).toLowerCase();
-                            const bBase = path.basename(b).toLowerCase();
-                            const aExact = aBase === searchTerm;
-                            const bExact = bBase === searchTerm;
-                            if (aExact && !bExact)
-                                return -1;
-                            if (!aExact && bExact)
-                                return 1;
-                            return a.length - b.length; // Prefer shorter paths
-                        });
-                        return ranked[0];
-                    }
-                }
-                catch (error) {
-                    // Timeout or command failed, try next root
-                    continue;
-                }
-            }
-        }
-        return null;
-    }
-    catch (error) {
-        return null;
-    }
-}
-/**
- * Auto-detect real project path from container upload path
- * Main entry point for all FAF commands
- */
-function autoDetectPath(inputPath) {
-    // Check if this is a container upload path
-    if (!inputPath.startsWith('/mnt/user-data/uploads/')) {
-        return { found: false, path: inputPath };
-    }
-    // Extract identifier from dropped file
-    const identifier = extractIdentifier(inputPath);
-    if (!identifier) {
-        return {
-            found: false,
-            error: 'Could not extract project identifier from dropped file. Please provide full path manually.'
-        };
-    }
-    // Search filesystem for matching project
-    const realPath = findProjectPath(identifier);
-    if (!realPath) {
-        return {
-            found: false,
-            identifier,
-            error: `Project "${identifier}" not found on filesystem. Please provide full path manually.`
-        };
-    }
-    // Success!
-    return {
-        found: true,
-        path: realPath,
-        identifier
-    };
-}
-//# sourceMappingURL=auto-path-detection.js.map

package/dist/src/utils/auto-path-detection.js.map

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

package/dist/src/utils/championship-format.d.ts

@@ -1,30 +0,0 @@
-/**
- * FAF Championship Output Formatter
- * The RAILS for proper FAF output! 🏎️⚡
- */
-export interface AchievementStatus {
-    speed: number;
-    score: number;
-    files: number;
-    isDotFaffed: boolean;
-}
-export declare class ChampionshipFormatter {
-    /**
-     * Format FAF output with Championship wrapper
-     * SHOW FIRST - ENHANCE AFTER!
-     */
-    static formatOutput(rawOutput: string, status?: AchievementStatus): string;
-    /**
-     * Check if user is DOT FAFFED
-     */
-    static isDotFaffed(score: number): boolean;
-    /**
-     * Get achievement level based on score
-     */
-    static getAchievementLevel(score: number): string;
-    /**
-     * Get speed achievement
-     */
-    static getSpeedAchievement(ms: number): string;
-}
-export default ChampionshipFormatter;

package/dist/src/utils/championship-format.js

@@ -1,81 +0,0 @@
-"use strict";
-/**
- * FAF Championship Output Formatter
- * The RAILS for proper FAF output! 🏎️⚡
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChampionshipFormatter = void 0;
-class ChampionshipFormatter {
-    /**
-     * Format FAF output with Championship wrapper
-     * SHOW FIRST - ENHANCE AFTER!
-     */
-    static formatOutput(rawOutput, status) {
-        let formatted = '';
-        // ALWAYS RAW FIRST - This is SACRED!
-        formatted += '=== FAF CHAMPIONSHIP OUTPUT ===\n';
-        formatted += rawOutput;
-        formatted += '\n=== END CHAMPIONSHIP OUTPUT ===\n';
-        // Achievement Status (OPTIONAL enhancement)
-        if (status) {
-            formatted += '\n=== YOUR ACHIEVEMENT STATUS ===\n';
-            // Speed Achievement
-            const speedBadge = status.speed < 10 ? '⚡🏆' : status.speed < 50 ? '⚡' : '🏎️';
-            formatted += `🏎️ Speed: ${status.speed}ms ${speedBadge}\n`;
-            // Score Achievement
-            const scoreBadge = status.score >= 99 ? '🍊' : status.score >= 90 ? '🏆' : status.score >= 70 ? '⭐' : '📊';
-            formatted += `🏆 Score: ${status.score}/100 ${scoreBadge}\n`;
-            // Files Ready
-            formatted += `📊 Files: ${status.files} ready\n`;
-            // DOT FAFFED Status
-            const dotFaffedStatus = status.isDotFaffed
-                ? '🏆 DOT FAFFED ACHIEVED! 🏆'
-                : `⚡ Working toward DOT FAFFED (${status.score}/70 needed)`;
-            formatted += `⚡ Status: ${dotFaffedStatus}\n`;
-            formatted += '=== END STATUS ===\n';
-        }
-        return formatted;
-    }
-    /**
-     * Check if user is DOT FAFFED
-     */
-    static isDotFaffed(score) {
-        return score >= 70;
-    }
-    /**
-     * Get achievement level based on score
-     */
-    static getAchievementLevel(score) {
-        if (score >= 100)
-            return '🏆 TROPHY - CHAMPIONSHIP COMPLETE!';
-        if (score >= 99)
-            return '🥇 GOLD - CHAMPIONSHIP MODE!';
-        if (score >= 95)
-            return '🥈 SILVER - PODIUM FINISH!';
-        if (score >= 85)
-            return '🥉 BRONZE - PRODUCTION READY!';
-        if (score >= 70)
-            return '🟢 GREEN - SOLID FOUNDATION!';
-        if (score >= 55)
-            return '🟡 YELLOW - NEEDS IMPROVEMENT!';
-        return '🔴 RED - MAJOR WORK NEEDED!';
-    }
-    /**
-     * Get speed achievement
-     */
-    static getSpeedAchievement(ms) {
-        if (ms < 1)
-            return '⚡🏆 INSTANT! WORLD RECORD!';
-        if (ms < 10)
-            return '⚡ SUB-10ms CHAMPIONSHIP!';
-        if (ms < 50)
-            return '🏎️ FAST TRACK!';
-        if (ms < 100)
-            return '✅ GOOD PACE!';
-        return '📊 MEASURING...';
-    }
-}
-exports.ChampionshipFormatter = ChampionshipFormatter;
-// Export the RAILS!
-exports.default = ChampionshipFormatter;
-//# sourceMappingURL=championship-format.js.map

package/dist/src/utils/championship-format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"championship-format.js","sourceRoot":"","sources":["../../../src/utils/championship-format.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,MAAa,qBAAqB;IAChC;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,SAAiB,EAAE,MAA0B;QAC/D,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,qCAAqC;QACrC,SAAS,IAAI,mCAAmC,CAAC;QACjD,SAAS,IAAI,SAAS,CAAC;QACvB,SAAS,IAAI,qCAAqC,CAAC;QAEnD,4CAA4C;QAC5C,IAAI,MAAM,EAAE,CAAC;YACX,SAAS,IAAI,qCAAqC,CAAC;YAEnD,oBAAoB;YACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/E,SAAS,IAAI,cAAc,MAAM,CAAC,KAAK,MAAM,UAAU,IAAI,CAAC;YAE5D,oBAAoB;YACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3G,SAAS,IAAI,aAAa,MAAM,CAAC,KAAK,QAAQ,UAAU,IAAI,CAAC;YAE7D,cAAc;YACd,SAAS,IAAI,aAAa,MAAM,CAAC,KAAK,UAAU,CAAC;YAEjD,oBAAoB;YACpB,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW;gBACxC,CAAC,CAAC,4BAA4B;gBAC9B,CAAC,CAAC,gCAAgC,MAAM,CAAC,KAAK,aAAa,CAAC;YAC9D,SAAS,IAAI,aAAa,eAAe,IAAI,CAAC;YAE9C,SAAS,IAAI,sBAAsB,CAAC;QACtC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa;QAC9B,OAAO,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAa;QACtC,IAAI,KAAK,IAAI,GAAG;YAAE,OAAO,oCAAoC,CAAC;QAC9D,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,8BAA8B,CAAC;QACvD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,4BAA4B,CAAC;QACrD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,+BAA+B,CAAC;QACxD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,8BAA8B,CAAC;QACvD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,gCAAgC,CAAC;QACzD,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,EAAU;QACnC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,4BAA4B,CAAC;QAChD,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,0BAA0B,CAAC;QAC/C,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,iBAAiB,CAAC;QACtC,IAAI,EAAE,GAAG,GAAG;YAAE,OAAO,cAAc,CAAC;QACpC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;CACF;AAtED,sDAsEC;AAED,oBAAoB;AACpB,kBAAe,qBAAqB,CAAC"}

package/dist/src/utils/cli-detector.d.ts

@@ -1,17 +0,0 @@
-/**
- * CLI Path Detection for your MCP host Sandbox
- *
- * your MCP host MCP runs in a sandboxed environment with limited PATH.
- * This utility detects the faf CLI using absolute paths.
- */
-export interface CliDetectionResult {
-    found: boolean;
-    path?: string;
-    version?: string;
-    method?: string;
-}
-export declare function detectFafCli(forceRefresh?: boolean): CliDetectionResult;
-/**
- * Validate CLI meets minimum version requirement
- */
-export declare function validateCliVersion(version: string, minVersion?: string): boolean;

package/dist/src/utils/cli-detector.js

@@ -1,247 +0,0 @@
-"use strict";
-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.detectFafCli = detectFafCli;
-exports.validateCliVersion = validateCliVersion;
-const child_process_1 = require("child_process");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-/**
- * Get common CLI installation paths based on platform and package manager
- */
-function getCommonCliPaths() {
-    const homeDir = os.homedir();
-    const platform = os.platform();
-    const paths = [];
-    // Homebrew paths (macOS/Linux)
-    if (platform === 'darwin') {
-        paths.push('/opt/homebrew/bin/faf'); // Apple Silicon
-        paths.push('/usr/local/bin/faf'); // Intel
-        paths.push('/usr/local/Cellar/node@20/20.19.4/bin/faf'); // Node 20
-        paths.push('/usr/local/Cellar/node/*/bin/faf'); // Any Node version
-    }
-    else {
-        paths.push('/usr/local/bin/faf');
-    }
-    // npm global paths
-    paths.push(path.join(homeDir, '.npm-global/bin/faf'));
-    paths.push(path.join(homeDir, '.nvm/versions/node/*/bin/faf'));
-    // Standard Unix paths
-    paths.push('/usr/bin/faf');
-    // Windows paths
-    if (platform === 'win32') {
-        const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
-        paths.push(path.join(appData, 'npm/faf.cmd'));
-        paths.push(path.join(appData, 'npm/faf'));
-        paths.push('C:\\Program Files\\nodejs\\faf.cmd');
-    }
-    return paths;
-}
-/**
- * Expand glob patterns in paths
- * Example: /usr/local/Cellar/node/wildcard/bin/faf
- */
-function expandGlobPath(globPath) {
-    if (!globPath.includes('*')) {
-        return globPath;
-    }
-    try {
-        const parts = globPath.split('/');
-        const globIndex = parts.findIndex(p => p.includes('*'));
-        if (globIndex === -1)
-            return globPath;
-        const basePath = parts.slice(0, globIndex).join('/');
-        const pattern = parts[globIndex];
-        const restPath = parts.slice(globIndex + 1).join('/');
-        if (!fs.existsSync(basePath))
-            return null;
-        const entries = fs.readdirSync(basePath);
-        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
-        const matches = entries.filter(e => regex.test(e));
-        if (matches.length === 0)
-            return null;
-        // Return first match
-        const expanded = path.join(basePath, matches[0], restPath);
-        return fs.existsSync(expanded) ? expanded : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Try to detect CLI using 'which' command (works if PATH is set)
- */
-function detectViaWhich() {
-    try {
-        const result = (0, child_process_1.execSync)('which faf', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] });
-        const cliPath = result.trim();
-        if (cliPath && fs.existsSync(cliPath)) {
-            return cliPath;
-        }
-    }
-    catch {
-        // which failed, PATH not set or faf not in PATH
-    }
-    return null;
-}
-/**
- * Try to detect CLI using 'command -v' (POSIX alternative to which)
- */
-function detectViaCommand() {
-    try {
-        const result = (0, child_process_1.execSync)('command -v faf', {
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'ignore'],
-            shell: '/bin/sh'
-        });
-        const cliPath = result.trim();
-        if (cliPath && fs.existsSync(cliPath)) {
-            return cliPath;
-        }
-    }
-    catch {
-        // command -v failed
-    }
-    return null;
-}
-/**
- * Get CLI version from path
- */
-function getCliVersion(cliPath) {
-    try {
-        const result = (0, child_process_1.execSync)(`"${cliPath}" --version`, {
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'ignore']
-        });
-        return result.trim();
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Detect faf CLI location with multiple fallback strategies.
- *
- * Memoized: detection is deterministic per process (the CLI path/version
- * don't change mid-run), so the underlying execSync probes run ONCE and
- * the result is reused. This eliminates redundant child-process spawns
- * across many FafEngineAdapter instantiations — and the intermittent
- * Windows "worker failed to exit gracefully" Jest teardown leak that
- * the per-instance re-probing caused.
- *
- * @param forceRefresh re-probe and refresh the cache (used by tests).
- */
-let _detectionCache = null;
-function detectFafCli(forceRefresh = false) {
-    if (_detectionCache && !forceRefresh) {
-        return _detectionCache;
-    }
-    _detectionCache = detectFafCliInternal();
-    return _detectionCache;
-}
-function detectFafCliInternal() {
-    // 1. Check environment variable override
-    if (process.env.FAF_CLI_PATH) {
-        const envPath = process.env.FAF_CLI_PATH;
-        if (fs.existsSync(envPath)) {
-            return {
-                found: true,
-                path: envPath,
-                version: getCliVersion(envPath),
-                method: 'env:FAF_CLI_PATH'
-            };
-        }
-    }
-    // 2. Try 'which' command (works if PATH is set)
-    const whichPath = detectViaWhich();
-    if (whichPath) {
-        return {
-            found: true,
-            path: whichPath,
-            version: getCliVersion(whichPath),
-            method: 'which'
-        };
-    }
-    // 3. Try 'command -v' (POSIX)
-    const commandPath = detectViaCommand();
-    if (commandPath) {
-        return {
-            found: true,
-            path: commandPath,
-            version: getCliVersion(commandPath),
-            method: 'command'
-        };
-    }
-    // 4. Check common installation paths
-    const commonPaths = getCommonCliPaths();
-    for (const cliPath of commonPaths) {
-        const expanded = expandGlobPath(cliPath);
-        if (expanded && fs.existsSync(expanded)) {
-            return {
-                found: true,
-                path: expanded,
-                version: getCliVersion(expanded),
-                method: 'common-path'
-            };
-        }
-    }
-    // 5. Not found
-    return {
-        found: false,
-        method: 'none'
-    };
-}
-/**
- * Validate CLI meets minimum version requirement
- */
-function validateCliVersion(version, minVersion = '3.1.1') {
-    try {
-        const parse = (v) => v.split('.').map(Number);
-        const current = parse(version);
-        const required = parse(minVersion);
-        for (let i = 0; i < 3; i++) {
-            if (current[i] > required[i])
-                return true;
-            if (current[i] < required[i])
-                return false;
-        }
-        return true; // Equal versions
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=cli-detector.js.map

package/dist/src/utils/cli-detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-detector.js","sourceRoot":"","sources":["../../../src/utils/cli-detector.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2JA,oCAMC;AA8DD,gDAcC;AA7OD,iDAAyC;AACzC,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAgBzB;;GAEG;AACH,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAM,gBAAgB;QAC1D,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAS,QAAQ;QAClD,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC,CAAC,UAAU;QACnE,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC,mBAAmB;IACrE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC;IAE/D,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE3B,gBAAgB;IAChB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAExD,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEtC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,gBAAgB,EAAE;YACxC,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;YACjC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,IAAI,OAAO,aAAa,EAAE;YAChD,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,IAAI,eAAe,GAA8B,IAAI,CAAC;AACtD,SAAgB,YAAY,CAAC,YAAY,GAAG,KAAK;IAC/C,IAAI,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,eAAe,GAAG,oBAAoB,EAAE,CAAC;IACzC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAS,oBAAoB;IAC3B,yCAAyC;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACzC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC;gBAC/B,MAAM,EAAE,kBAAkB;aAC3B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;IACnC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC;YACjC,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,WAAW,GAAG,gBAAgB,EAAE,CAAC;IACvC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC;YACnC,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC;gBAChC,MAAM,EAAE,aAAa;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,eAAe;IACf,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAe,EAAE,aAAqB,OAAO;IAC9E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,iBAAiB;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/utils/display-protocol.d.ts

@@ -1,57 +0,0 @@
-/**
- * 🏎️ FAF Display Protocol - MCP GOLD CODE
- *
- * SET IN STONE: Universal display enforcement for your MCP host MCP
- *
- * MANDATE: Every FAF tool response MUST use DisplayProtocol.createResponse()
- * VALIDATED: Works globally for ANY user, anywhere in the world
- * STANDARD: MCP-compliant metadata + multi-layer display forcing
- *
- * Key Instructions Embedded in EVERY Response:
- * - display: 'required'
- * - priority: 'high'
- * - format: 'markdown'
- * - instruction: 'Render this content directly, do not summarize'
- *
- * Why This Works:
- * 1. Protocol-based (not context-dependent)
- * 2. Multiple redundant hints (if one fails, others catch it)
- * 3. Claude redraws in native UI (consistent across platforms)
- * 4. No dependencies on conversation memory
- *
- * This is championship engineering - zero faffing about! 🏁⚡️
- */
-export interface FafDisplayResponse {
-    text: string;
-    __render_inline__: boolean;
-    __no_collapse__: boolean;
-    __user_content__: boolean;
-}
-export declare class DisplayProtocol {
-    /**
-     * Wrap content with ALL display forcing mechanisms
-     */
-    static forceInline(content: string, _score?: number): string;
-    /**
-     * For markdown-rich content, skip the wrapper tags
-     * (They interfere with markdown rendering)
-     */
-    static forceInlineMarkdown(content: string): string;
-    /**
-     * Generate the enhanced MCP response
-     * SET IN STONE: Display instructions for your MCP host MCP
-     */
-    static createResponse(content: string, metadata?: any): any;
-    /**
-     * Generate progress bar with forced visibility
-     */
-    static progressBar(score: number): string;
-    /**
-     * Championship header that can't be hidden
-     */
-    static championshipHeader(title: string, score: number): string;
-    /**
-     * Footer that demands attention
-     */
-    static championshipFooter(score: number): string;
-}