faf-mcp 1.0.0

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

@@ -0,0 +1,198 @@
+"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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-path-detection.js","sourceRoot":"","sources":["../../../src/utils/auto-path-detection.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBH,8CA0CC;AAKD,0CA0EC;AAMD,wCAiCC;AA/KD,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAyC;AASzC;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEzC,kCAAkC;QAClC,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;oBACb,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,wCAAwC;gBAC3D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC3C,IAAI,KAAK,EAAE,CAAC;gBACV,mDAAmD;gBACnD,OAAO,KAAK,CAAC,CAAC,CAAC;qBACZ,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,8BAA8B;qBACvD,IAAI,EAAE;qBACN,WAAW,EAAE;qBACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC1D,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,UAAkB;IAChD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;QAExC,sCAAsC;QACtC,MAAM,WAAW,GAAG;YAClB,UAAU,QAAQ,EAAE,EAAO,QAAQ;YACnC,SAAS,QAAQ,EAAE,EAAS,QAAQ;YACpC,cAAc,QAAQ,EAAE,CAAI,UAAU;SACvC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kCAAkC;QAClC,+CAA+C;QAC/C,IAAI,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAEpE,4CAA4C;QAC5C,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC;gBAEvD,wCAAwC;gBACxC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;oBACtC,CAAC,CAAC,mBAAmB,IAAI,KAAK,OAAO,SAAS;oBAC9C,CAAC,CAAC,SAAS,IAAI,iCAAiC,OAAO;;;;;;;;;;yBAUxC,CAAC;gBAElB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,GAAG,EAAE;wBAC3B,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,KAAK;wBACd,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC,aAAa;qBACrC,CAAC,CAAC;oBAEH,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;oBAEnD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACvB,2DAA2D;wBAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;4BACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;4BAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;4BAC7C,MAAM,MAAM,GAAG,KAAK,KAAK,UAAU,CAAC;4BACpC,MAAM,MAAM,GAAG,KAAK,KAAK,UAAU,CAAC;4BAEpC,IAAI,MAAM,IAAI,CAAC,MAAM;gCAAE,OAAO,CAAC,CAAC,CAAC;4BACjC,IAAI,CAAC,MAAM,IAAI,MAAM;gCAAE,OAAO,CAAC,CAAC;4BAChC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,uBAAuB;wBACrD,CAAC,CAAC,CAAC;wBAEH,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,2CAA2C;oBAC3C,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAC9C,2CAA2C;IAC3C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3C,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,4FAA4F;SACpG,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,UAAU;YACV,KAAK,EAAE,YAAY,UAAU,+DAA+D;SAC7F,CAAC;IACJ,CAAC;IAED,WAAW;IACX,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,QAAQ;QACd,UAAU;KACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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

@@ -0,0 +1,79 @@
+"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 >= 105)
+            return '🍊 BIG ORANGE CHAMPIONSHIP!';
+        if (score >= 99)
+            return '🏆 CHAMPIONSHIP MODE!';
+        if (score >= 90)
+            return '⭐ PODIUM FINISH!';
+        if (score >= 70)
+            return '✅ DOT FAFFED!';
+        if (score >= 50)
+            return '🏎️ ON TRACK!';
+        return '⚡ BUILDING MOMENTUM!';
+    }
+    /**
+     * 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

@@ -0,0 +1 @@
+{"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,6BAA6B,CAAC;QACvD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,uBAAuB,CAAC;QAChD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,kBAAkB,CAAC;QAC3C,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,eAAe,CAAC;QACxC,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,eAAe,CAAC;QACxC,OAAO,sBAAsB,CAAC;IAChC,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;AArED,sDAqEC;AAED,oBAAoB;AACpB,kBAAe,qBAAqB,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * CLI Path Detection for Claude Desktop Sandbox
+ *
+ * Claude Desktop 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;
+}
+/**
+ * Detect faf CLI location with multiple fallback strategies
+ */
+export declare function detectFafCli(): CliDetectionResult;
+/**
+ * Validate CLI meets minimum version requirement
+ */
+export declare function validateCliVersion(version: string, minVersion?: string): boolean;

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

@@ -0,0 +1,230 @@
+"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
+ */
+function detectFafCli() {
+    // 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

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

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

@@ -0,0 +1,57 @@
+/**
+ * 🏎️ FAF Display Protocol - MCP GOLD CODE
+ *
+ * SET IN STONE: Universal display enforcement for Claude Desktop 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 Claude Desktop 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;
+}