faf-mcp 1.0.0

package/dist/src/utils/path-resolver.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * 🎯 Projects Convention Path Resolver
+ *
+ * Default: ~/Projects/[project-name]/project.faf
+ *
+ * Project name inference order:
+ * 1. User explicit path (always wins)
+ * 2. User project name statement
+ * 3. AI inference from README, files, conversation context
+ * 4. Fallback to 'unnamed-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.getHomeDirectory = getHomeDirectory;
+exports.getProjectsDirectory = getProjectsDirectory;
+exports.resolveProjectPath = resolveProjectPath;
+exports.ensureProjectsDirectory = ensureProjectsDirectory;
+exports.isRealFilesystemPath = isRealFilesystemPath;
+exports.formatPathConfirmation = formatPathConfirmation;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+/**
+ * Slugify project name for filesystem
+ */
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '') // Remove emojis/special chars
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-'); // Collapse multiple dashes
+}
+/**
+ * Infer project name from context
+ */
+function inferFromContext(context) {
+    if (!context)
+        return null;
+    // Try README title
+    if (context.readme) {
+        const titleMatch = context.readme.match(/^#\s+(.+)/m);
+        if (titleMatch) {
+            return slugify(titleMatch[1]);
+        }
+    }
+    // Try explicit project name
+    if (context.projectName) {
+        return slugify(context.projectName);
+    }
+    // Try uploaded files (package.json name, etc.)
+    if (context.uploadedFiles && context.uploadedFiles.length > 0) {
+        for (const file of context.uploadedFiles) {
+            try {
+                const basename = path.basename(file);
+                // package.json
+                if (basename === 'package.json' && fs.existsSync(file)) {
+                    const content = fs.readFileSync(file, 'utf8');
+                    const pkg = JSON.parse(content);
+                    if (pkg.name) {
+                        // Handle scoped packages: @org/name → name
+                        return slugify(pkg.name.replace(/^@[\w-]+\//, ''));
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Get user's home directory cross-platform
+ */
+function getHomeDirectory() {
+    return os.homedir();
+}
+/**
+ * Get default Projects directory
+ */
+function getProjectsDirectory() {
+    const home = getHomeDirectory();
+    return path.join(home, 'Projects');
+}
+/**
+ * Resolve project path using Projects convention
+ *
+ * @param userInput - User-provided path or project name
+ * @param context - Context for AI inference (README, files, etc.)
+ * @returns Path resolution with project directory and .faf file path
+ */
+function resolveProjectPath(userInput, context) {
+    // USER EXPLICIT PATH ALWAYS WINS
+    if (userInput && (userInput.includes('/') || userInput.includes('\\'))) {
+        const normalized = path.resolve(userInput);
+        const projectName = path.basename(normalized);
+        const fafFilePath = path.join(normalized, 'project.faf');
+        return {
+            projectPath: normalized,
+            fafFilePath,
+            projectName,
+            source: 'user-explicit'
+        };
+    }
+    // USER PROVIDED NAME (not path)
+    if (userInput) {
+        const projectName = slugify(userInput);
+        const projectPath = path.join(getProjectsDirectory(), projectName);
+        const fafFilePath = path.join(projectPath, 'project.faf');
+        return {
+            projectPath,
+            fafFilePath,
+            projectName,
+            source: 'user-name'
+        };
+    }
+    // AI INFERENCE FROM CONTEXT
+    const inferredName = inferFromContext(context);
+    if (inferredName) {
+        const projectPath = path.join(getProjectsDirectory(), inferredName);
+        const fafFilePath = path.join(projectPath, 'project.faf');
+        return {
+            projectPath,
+            fafFilePath,
+            projectName: inferredName,
+            source: 'ai-inference'
+        };
+    }
+    // FALLBACK
+    const projectName = 'unnamed-project';
+    const projectPath = path.join(getProjectsDirectory(), projectName);
+    const fafFilePath = path.join(projectPath, 'project.faf');
+    return {
+        projectPath,
+        fafFilePath,
+        projectName,
+        source: 'fallback'
+    };
+}
+/**
+ * Ensure Projects directory exists
+ */
+function ensureProjectsDirectory() {
+    const projectsDir = getProjectsDirectory();
+    if (!fs.existsSync(projectsDir)) {
+        fs.mkdirSync(projectsDir, { recursive: true });
+    }
+}
+/**
+ * Validate that path is on real filesystem (not container)
+ */
+function isRealFilesystemPath(inputPath) {
+    // Container paths to reject
+    const containerPaths = [
+        '/mnt/user-data/',
+        '/home/claude/',
+        '/tmp/uploads/'
+    ];
+    return !containerPaths.some(cp => inputPath.startsWith(cp));
+}
+/**
+ * Format confirmation message for user
+ */
+function formatPathConfirmation(resolution) {
+    const sourceEmoji = {
+        'user-explicit': '✓',
+        'user-name': '✓',
+        'ai-inference': '🤖',
+        'fallback': '⚠️'
+    };
+    const emoji = sourceEmoji[resolution.source];
+    if (resolution.source === 'ai-inference') {
+        return `${emoji} Inferred project: "${resolution.projectName}"\nCreating at: ${resolution.projectPath}/`;
+    }
+    if (resolution.source === 'fallback') {
+        return `${emoji} Using fallback name: "${resolution.projectName}"\nCreating at: ${resolution.projectPath}/\n(Tip: Provide project name or upload README for auto-detection)`;
+    }
+    return `${emoji} Creating at: ${resolution.projectPath}/`;
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/src/utils/path-resolver.js.map

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

package/dist/src/utils/type-guards.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 🏎️ Type Guards - Championship Type Safety
+ * Stage 2: strictNullChecks enabled
+ */
+export declare function isError(value: unknown): value is Error;
+export declare function isString(value: unknown): value is string;
+export declare function isNumber(value: unknown): value is number;
+export declare function isDefined<T>(value: T | undefined | null): value is T;
+export declare function hasProperty<K extends string>(obj: unknown, key: K): obj is Record<K, unknown>;

package/dist/src/utils/type-guards.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * 🏎️ Type Guards - Championship Type Safety
+ * Stage 2: strictNullChecks enabled
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isError = isError;
+exports.isString = isString;
+exports.isNumber = isNumber;
+exports.isDefined = isDefined;
+exports.hasProperty = hasProperty;
+function isError(value) {
+    return value instanceof Error;
+}
+function isString(value) {
+    return typeof value === 'string';
+}
+function isNumber(value) {
+    return typeof value === 'number';
+}
+function isDefined(value) {
+    return value !== undefined && value !== null;
+}
+function hasProperty(obj, key) {
+    return typeof obj === 'object' && obj !== null && key in obj;
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/src/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../../src/utils/type-guards.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,0BAEC;AAED,4BAEC;AAED,4BAEC;AAED,8BAEC;AAED,kCAKC;AArBD,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,SAAgB,SAAS,CAAI,KAA2B;IACtD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AAC/C,CAAC;AAED,SAAgB,WAAW,CACzB,GAAY,EACZ,GAAM;IAEN,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * 🔍 Username & Home Directory Detection
+ *
+ * Cross-platform detection of current user and home directory
+ * for Projects convention path resolution.
+ */
+export interface UserInfo {
+    username: string;
+    homeDir: string;
+    platform: 'darwin' | 'linux' | 'win32' | 'unknown';
+}
+/**
+ * Detect current user information
+ */
+export declare function detectUser(): UserInfo;
+/**
+ * Get platform-specific home directory notation
+ */
+export declare function getHomeDirNotation(): string;
+/**
+ * Expand ~ to full home directory path
+ */
+export declare function expandTilde(inputPath: string): string;
+/**
+ * Contract full home directory path to ~
+ */
+export declare function contractToTilde(fullPath: string): string;

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

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * 🔍 Username & Home Directory Detection
+ *
+ * Cross-platform detection of current user and home directory
+ * for Projects convention path resolution.
+ */
+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.detectUser = detectUser;
+exports.getHomeDirNotation = getHomeDirNotation;
+exports.expandTilde = expandTilde;
+exports.contractToTilde = contractToTilde;
+const os = __importStar(require("os"));
+/**
+ * Detect current user information
+ */
+function detectUser() {
+    const userInfo = os.userInfo();
+    const platform = os.platform();
+    return {
+        username: userInfo.username,
+        homeDir: os.homedir(),
+        platform: platform === 'darwin' ? 'darwin' :
+            platform === 'linux' ? 'linux' :
+                platform === 'win32' ? 'win32' : 'unknown'
+    };
+}
+/**
+ * Get platform-specific home directory notation
+ */
+function getHomeDirNotation() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        return process.env.USERPROFILE || os.homedir();
+    }
+    return '~'; // Unix-like systems
+}
+/**
+ * Expand ~ to full home directory path
+ */
+function expandTilde(inputPath) {
+    if (inputPath.startsWith('~')) {
+        return inputPath.replace('~', os.homedir());
+    }
+    return inputPath;
+}
+/**
+ * Contract full home directory path to ~
+ */
+function contractToTilde(fullPath) {
+    const homeDir = os.homedir();
+    if (fullPath.startsWith(homeDir)) {
+        return fullPath.replace(homeDir, '~');
+    }
+    return fullPath;
+}
+//# sourceMappingURL=username-detector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"username-detector.js","sourceRoot":"","sources":["../../../src/utils/username-detector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaH,gCAWC;AAKD,gDAQC;AAKD,kCAKC;AAKD,0CAMC;AAxDD,uCAAyB;AAQzB;;GAEG;AACH,SAAgB,UAAU;IACxB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;QACrB,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAChC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KACpD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAE/B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,GAAG,CAAC,CAAC,oBAAoB;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,SAAiB;IAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,QAAgB;IAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/utils/visual-style.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 🧡🩵 BIG ORANGE + CYAN Visual Style for FAF MCP
+ * 3 Lines, 3 Words, 1 Emoji with Bar
+ * Orange emojis with cyan text for championship look!
+ */
+export interface DisplayStyle {
+    line1: string;
+    line2: string;
+    line3: string;
+}
+/**
+ * Create an orange-themed progress bar
+ * Uses orange blocks for filled, gray for empty
+ */
+export declare function createProgressBar(percentage: number, width?: number): string;
+/**
+ * Alternative ASCII bar when emojis aren't suitable
+ */
+export declare function createASCIIBar(percentage: number, width?: number): string;
+/**
+ * Get championship medal emoji and status based on score
+ */
+export declare function getScoreMedal(score: number): {
+    medal: string;
+    status: string;
+};
+/**
+ * Format score display with Championship Medal System
+ */
+export declare function formatScore(score: number): DisplayStyle;
+/**
+ * Format file operations with style
+ */
+export declare function formatFileOp(operation: string, count: number, total?: number): DisplayStyle;
+/**
+ * Format sync operations
+ */
+export declare function formatSync(synced: number, total: number): DisplayStyle;
+/**
+ * Format directory tree with orange accents
+ */
+export declare function formatTree(tree: string): string;
+/**
+ * Format project detection
+ */
+export declare function formatDetection(projectType: string, confidence: number): DisplayStyle;
+/**
+ * Format generic success message
+ */
+export declare function formatSuccess(action: string, detail?: string): DisplayStyle;
+/**
+ * Format error message (still styled but clear)
+ */
+export declare function formatError(action: string, error: string): DisplayStyle;
+/**
+ * The main formatter - always returns 3 lines
+ */
+export declare function format3Lines(style: DisplayStyle): string;
+/**
+ * Special Big Orange celebration for perfect scores
+ */
+export declare function formatBigOrange(): DisplayStyle;

package/dist/src/utils/visual-style.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * 🧡🩵 BIG ORANGE + CYAN Visual Style for FAF MCP
+ * 3 Lines, 3 Words, 1 Emoji with Bar
+ * Orange emojis with cyan text for championship look!
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgressBar = createProgressBar;
+exports.createASCIIBar = createASCIIBar;
+exports.getScoreMedal = getScoreMedal;
+exports.formatScore = formatScore;
+exports.formatFileOp = formatFileOp;
+exports.formatSync = formatSync;
+exports.formatTree = formatTree;
+exports.formatDetection = formatDetection;
+exports.formatSuccess = formatSuccess;
+exports.formatError = formatError;
+exports.format3Lines = format3Lines;
+exports.formatBigOrange = formatBigOrange;
+// ANSI color codes for terminal output
+const CYAN = '\x1b[36m';
+const BRIGHT_CYAN = '\x1b[96m';
+const ORANGE = '\x1b[38;5;208m'; // Terminal orange approximation
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+/**
+ * Create an orange-themed progress bar
+ * Uses orange blocks for filled, gray for empty
+ */
+function createProgressBar(percentage, width = 24) {
+    const filled = Math.round((percentage / 100) * width);
+    const empty = width - filled;
+    // Orange blocks for progress (using standard blocks since terminal orange is limited)
+    // In Claude Desktop, we use the emoji for orange feel
+    const bar = '🟧'.repeat(filled) + '⬜'.repeat(empty);
+    return `${bar} ${percentage}%`;
+}
+/**
+ * Alternative ASCII bar when emojis aren't suitable
+ */
+function createASCIIBar(percentage, width = 24) {
+    const filled = Math.round((percentage / 100) * width);
+    const empty = width - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    return `${bar} ${percentage}%`;
+}
+/**
+ * Get championship medal emoji and status based on score
+ */
+function getScoreMedal(score) {
+    if (score >= 100)
+        return { medal: '🏆', status: 'Trophy - Championship' };
+    if (score >= 99)
+        return { medal: '🥇', status: 'Gold' };
+    if (score >= 95)
+        return { medal: '🥈', status: 'Target 2 - Silver' };
+    if (score >= 85)
+        return { medal: '🥉', status: 'Target 1 - Bronze' };
+    if (score >= 70)
+        return { medal: '🟢', status: 'GO! - Ready for Target 1' };
+    if (score >= 55)
+        return { medal: '🟡', status: 'Caution - Getting ready' };
+    return { medal: '🔴', status: 'Stop - Needs work' };
+}
+/**
+ * Format score display with Championship Medal System
+ */
+function formatScore(score) {
+    const { medal, status } = getScoreMedal(score);
+    return {
+        line1: `${medal} ${BRIGHT_CYAN}Score: ${score}/100${RESET}`,
+        line2: createASCIIBar(score),
+        line3: `🏎️ ${CYAN}Status: ${status}${RESET}`
+    };
+}
+/**
+ * Format file operations with style
+ */
+function formatFileOp(operation, count, total) {
+    const percentage = total ? Math.round((count / total) * 100) : 100;
+    return {
+        line1: `📁 ${BRIGHT_CYAN}${operation}: ${count}${total ? `/${total}` : ' files'}${RESET}`,
+        line2: createASCIIBar(percentage),
+        line3: `🧡 ${CYAN}Speed: Fast${RESET}`
+    };
+}
+/**
+ * Format sync operations
+ */
+function formatSync(synced, total) {
+    const percentage = Math.round((synced / total) * 100);
+    let status = '';
+    if (percentage === 100) {
+        status = 'Complete!';
+    }
+    else if (percentage >= 50) {
+        status = 'In Progress';
+    }
+    else {
+        status = 'Starting';
+    }
+    return {
+        line1: `🔄 ${BRIGHT_CYAN}Synced: ${synced}/${total}${RESET}`,
+        line2: createASCIIBar(percentage),
+        line3: `🧡 ${CYAN}Status: ${status}${RESET}`
+    };
+}
+/**
+ * Format directory tree with orange accents
+ */
+function formatTree(tree) {
+    // Add orange folder emojis
+    return tree
+        .replace(/├──/g, '├── 🧡')
+        .replace(/└──/g, '└── 🧡')
+        .replace(/│/g, '│');
+}
+/**
+ * Format project detection
+ */
+function formatDetection(projectType, confidence) {
+    return {
+        line1: `🏗️ ${BRIGHT_CYAN}Type: ${projectType}${RESET}`,
+        line2: createASCIIBar(confidence),
+        line3: `🧡 ${CYAN}Confidence: ${confidence}%${RESET}`
+    };
+}
+/**
+ * Format generic success message
+ */
+function formatSuccess(action, detail) {
+    return {
+        line1: `✅ ${BRIGHT_CYAN}${action}: Success${RESET}`,
+        line2: `████████████████████████ 100%`,
+        line3: `🧡 ${CYAN}${detail || 'Complete!'}${RESET}`
+    };
+}
+/**
+ * Format error message (still styled but clear)
+ */
+function formatError(action, error) {
+    return {
+        line1: `❌ ${action}: Failed`,
+        line2: `░░░░░░░░░░░░░░░░░░░░░░░░ 0%`,
+        line3: `💡 Fix: ${error}`
+    };
+}
+/**
+ * The main formatter - always returns 3 lines
+ */
+function format3Lines(style) {
+    return `${style.line1}\n${style.line2}\n${style.line3}`;
+}
+/**
+ * Special Big Orange celebration for perfect scores
+ */
+function formatBigOrange() {
+    return {
+        line1: `🧡 ${BRIGHT_CYAN}${BOLD}BIG ORANGE: 100/100${RESET}`,
+        line2: `🟧🟧🟧🟧🟧🟧🟧🟧🟧🟧🟧🟧 ${ORANGE}MAX!${RESET}`,
+        line3: `🏆 ${BRIGHT_CYAN}${BOLD}Status: CHAMPION!${RESET}`
+    };
+}
+//# sourceMappingURL=visual-style.js.map

package/dist/src/utils/visual-style.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get the current version from package.json
+ * Caches the result for performance
+ */
+export declare function getVersion(): string;
+/**
+ * Version constant for convenience
+ */
+export declare const VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.getVersion = getVersion;
+/**
+ * Version information - Single source of truth
+ * Imports from package.json to avoid hardcoding
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+let cachedVersion = '';
+/**
+ * Get the current version from package.json
+ * Caches the result for performance
+ */
+function getVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        // __dirname in compiled code is dist/src, so we need to go up two levels to reach package.json
+        const packageJsonPath = (0, path_1.join)(__dirname, '..', '..', 'package.json');
+        const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, 'utf-8'));
+        cachedVersion = packageJson.version;
+        return cachedVersion;
+    }
+    catch (error) {
+        // Fallback if package.json read fails (should never happen in production)
+        console.error('Failed to read version from package.json:', error);
+        return 'unknown';
+    }
+}
+/**
+ * Version constant for convenience
+ */
+exports.VERSION = getVersion();
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAaA,gCAgBC;AA7BD;;;GAGG;AACH,2BAAkC;AAClC,+BAA4B;AAE5B,IAAI,aAAa,GAAW,EAAE,CAAC;AAE/B;;;GAGG;AACH,SAAgB,UAAU;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,+FAA+F;QAC/F,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC;QACpC,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACU,QAAA,OAAO,GAAG,UAAU,EAAE,CAAC"}