faf-cli 2.5.4 → 3.0.1

package/dist/enrichment/slot-filler.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * 🏎️ Slot Filler - The 6 W's Intelligence
+ *
+ * Takes messy natural language and fills structured context slots
+ * This is where POOR data becomes RICH data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlotFiller = void 0;
+class SlotFiller {
+    /**
+     * Fill all 6 W's from user input + workflow analysis
+     */
+    fill6Ws(useCase, other, workflow, pattern, aiModels, infrastructure) {
+        // Parse the use case into components
+        const parsed = this.parseIntent(useCase, other);
+        return {
+            who: this.fillWho(parsed, other),
+            what: this.fillWhat(parsed, pattern),
+            why: this.fillWhy(parsed),
+            where: this.fillWhere(workflow),
+            when: this.fillWhen(workflow),
+            how: this.fillHow(aiModels, infrastructure, pattern)
+        };
+    }
+    /**
+     * Parse natural language into intent components
+     */
+    parseIntent(useCase, other) {
+        const text = useCase.toLowerCase();
+        return {
+            subject: this.extractSubject(useCase),
+            audience: this.extractAudience(useCase, other),
+            goal: this.extractGoal(text),
+            context: other ? other.split(/[,;]/).map(s => s.trim()).filter(Boolean) : [],
+            keywords: this.extractKeywords(text)
+        };
+    }
+    /**
+     * Extract subject (what system/framework is this about?)
+     */
+    extractSubject(text) {
+        // Look for proper nouns, product names, frameworks
+        const patterns = [
+            /(\w+(?:'s)?\s+\$?\d+[MKB]?\s+\w+)/i, // "Hormozi's $100M Sales"
+            /(\w+\s+\w+\s+(?:system|framework|model|strategy))/i, // "Money Models system"
+            /(RAG|ETL|API)\s+(?:system|framework|workflow)/i // "RAG system"
+        ];
+        for (const pattern of patterns) {
+            const match = text.match(pattern);
+            if (match) {
+                return match[1].trim();
+            }
+        }
+        // Fallback: capitalize first few words
+        const words = text.split(' ').slice(0, 3);
+        return words.map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+    }
+    /**
+     * Extract audience (who is this for?)
+     */
+    extractAudience(useCase, other) {
+        const text = useCase.toLowerCase();
+        const audience = [];
+        // Look for "for X" or "help X"
+        const forMatch = text.match(/for\s+([^,\.]+)/i);
+        if (forMatch) {
+            audience.push(forMatch[1].trim());
+        }
+        const helpMatch = text.match(/help\s+([^,\.]+)/i);
+        if (helpMatch && !helpMatch[1].includes('get') && !helpMatch[1].includes('with')) {
+            audience.push(helpMatch[1].trim());
+        }
+        // Check Q3 for audience specificity
+        if (other) {
+            const otherLower = other.toLowerCase();
+            if (otherLower.match(/only for|just for|specifically for|for my/i)) {
+                const specificMatch = other.match(/(?:only|just|specifically|for my)\s+(?:for\s+)?([^,\.]+)/i);
+                if (specificMatch) {
+                    audience.push(specificMatch[1].trim());
+                }
+            }
+        }
+        return [...new Set(audience)]; // Dedupe
+    }
+    /**
+     * Extract goal (why does this exist?)
+     */
+    extractGoal(text) {
+        // Look for verbs indicating purpose
+        const goalPatterns = [
+            /to\s+([^,\.]+)/i,
+            /help\s+(?:people|users|them|clients)?\s*(?:to\s+)?([^,\.]+)/i,
+            /(?:provide|enable|allow|give)\s+([^,\.]+)/i,
+            /(?:get|achieve|reach)\s+([^,\.]+)/i
+        ];
+        for (const pattern of goalPatterns) {
+            const match = text.match(pattern);
+            if (match && match[1]) {
+                return match[1].trim();
+            }
+        }
+        // Fallback: look for action verbs
+        const actionMatch = text.match(/(automat\w+|process\w+|send\w+|fetch\w+|generat\w+)\s+([^,\.]+)/i);
+        if (actionMatch) {
+            return `${actionMatch[1]} ${actionMatch[2]}`.trim();
+        }
+        return 'solve user problems'; // Ultimate fallback
+    }
+    /**
+     * Extract keywords for search
+     */
+    extractKeywords(text) {
+        // Simple keyword extraction (stopwords filtered)
+        const stopwords = new Set([
+            'the', 'a', 'an', 'to', 'for', 'of', 'and', 'or', 'in', 'on', 'is', 'are',
+            'was', 'were', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does',
+            'did', 'will', 'would', 'should', 'could', 'may', 'might', 'must', 'can',
+            'this', 'that', 'these', 'those', 'i', 'you', 'he', 'she', 'it', 'we', 'they'
+        ]);
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ') // Remove punctuation
+            .split(/\s+/)
+            .filter(word => word.length > 3 && !stopwords.has(word))
+            .slice(0, 10);
+    }
+    /**
+     * Fill WHO slot
+     */
+    fillWho(parsed, other) {
+        if (parsed.audience.length > 0) {
+            const primary = parsed.audience[0];
+            // Enhance with subject if available
+            if (parsed.subject && parsed.subject.length > 3) {
+                return `${primary} learning ${parsed.subject}`;
+            }
+            return primary;
+        }
+        // Check Q3 for implicit audience
+        if (other.toLowerCase().includes('my')) {
+            return 'internal team';
+        }
+        return 'users'; // Fallback
+    }
+    /**
+     * Fill WHAT slot (infer from pattern + subject)
+     */
+    fillWhat(parsed, pattern) {
+        let what = '';
+        // Add pattern prefix
+        if (pattern !== 'Unknown') {
+            what = `${pattern}-powered `;
+        }
+        // Add subject
+        if (parsed.subject && parsed.subject.length > 3) {
+            what += `${parsed.subject} system`;
+        }
+        else {
+            what += 'automation workflow';
+        }
+        return what.trim();
+    }
+    /**
+     * Fill WHY slot
+     */
+    fillWhy(parsed) {
+        return parsed.goal || 'automate processes';
+    }
+    /**
+     * Fill WHERE slot (infer from workflow structure)
+     */
+    fillWhere(workflow) {
+        // Check for webhook triggers
+        const hasWebhook = workflow.nodes.some(n => n.type.toLowerCase().includes('webhook'));
+        if (hasWebhook) {
+            return 'accessible via webhook API';
+        }
+        // Check for form triggers
+        const hasForm = workflow.nodes.some(n => n.type.toLowerCase().includes('form'));
+        if (hasForm) {
+            return 'web form interface';
+        }
+        // Check for schedule triggers
+        const hasSchedule = workflow.nodes.some(n => n.type.toLowerCase().includes('schedule') ||
+            n.type.toLowerCase().includes('cron'));
+        if (hasSchedule) {
+            return 'scheduled execution';
+        }
+        return 'n8n workflow environment';
+    }
+    /**
+     * Fill WHEN slot (infer from triggers)
+     */
+    fillWhen(workflow) {
+        // Check trigger types
+        const triggers = workflow.nodes.filter(n => n.type.toLowerCase().includes('trigger'));
+        if (triggers.length === 0) {
+            return 'manual execution';
+        }
+        const triggerTypes = triggers.map(t => t.type.toLowerCase());
+        if (triggerTypes.some(t => t.includes('webhook'))) {
+            return 'on-demand (webhook triggered)';
+        }
+        if (triggerTypes.some(t => t.includes('schedule') || t.includes('cron'))) {
+            return 'scheduled intervals';
+        }
+        if (triggerTypes.some(t => t.includes('form'))) {
+            return 'user form submission';
+        }
+        if (triggerTypes.some(t => t.includes('manual'))) {
+            return 'manual execution';
+        }
+        return 'event-driven';
+    }
+    /**
+     * Fill HOW slot (tech stack summary)
+     */
+    fillHow(aiModels, infrastructure, pattern) {
+        const components = [];
+        // Add pattern if significant
+        if (pattern === 'RAG') {
+            components.push('RAG pipeline');
+        }
+        else if (pattern === 'Multi-Agent') {
+            components.push('multi-agent coordination');
+        }
+        // Add primary AI model
+        if (aiModels.length > 0) {
+            components.push(aiModels[0]);
+        }
+        // Add key infrastructure (limit to 2)
+        if (infrastructure.length > 0) {
+            const key = infrastructure.slice(0, 2);
+            components.push(...key);
+        }
+        if (components.length === 0) {
+            return 'n8n workflow automation';
+        }
+        // Join with " with "
+        if (components.length === 1) {
+            return components[0];
+        }
+        if (components.length === 2) {
+            return components.join(' with ');
+        }
+        // For 3+: "A with B and C"
+        const last = components.pop();
+        return `${components.join(', ')} and ${last}`;
+    }
+}
+exports.SlotFiller = SlotFiller;
+//# sourceMappingURL=slot-filler.js.map

package/dist/enrichment/slot-filler.js.map

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

package/dist/fix-once/yaml.d.ts

@@ -1,55 +1,58 @@
 /**
- * 🍜 YAML FIX-ONCE ABSTRACTION
+ * 🔥 YAML FIX-ONCE ABSTRACTION
  *
- * This module will handle the transition from external yaml
- * to bundled yaml seamlessly!
+ * ROCK SOLID YAML PARSING - FIX ONCE, DONE FOREVER
  *
- * CURRENT STATUS: Using external yaml
- * FUTURE STATUS: Will use bundled yaml
+ * This module handles ALL YAML edge cases:
+ * ✅ Empty files
+ * ✅ Null/undefined content
+ * ✅ Invalid YAML syntax
+ * ✅ Type validation
+ * ✅ Corrupted files
+ * ✅ Clear error messages
+ * ✅ Primitive vs Object validation
+ *
+ * NEVER touch raw YAML parsing outside this file.
  */
 import * as yaml from 'yaml';
-export declare const parse: typeof yaml.parse;
-export declare const stringify: typeof yaml.stringify;
-export declare const Document: typeof yaml.Document;
+/**
+ * Safe YAML parse - handles ALL edge cases
+ * ROCK SOLID - FIX ONCE, DONE FOREVER
+ */
+export declare function parse(content: string | null | undefined, options?: {
+    filepath?: string;
+}): any;
+/**
+ * Safe YAML stringify - handles edge cases
+ * ROCK SOLID - FIX ONCE, DONE FOREVER
+ */
+export declare function stringify(data: any, options?: any): string;
 export declare const parseDocument: typeof yaml.parseDocument;
+export declare const Document: typeof yaml.Document;
 declare const _default: {
-    parse: typeof yaml.parse;
-    stringify: typeof yaml.stringify;
+    parse: typeof parse;
+    stringify: typeof stringify;
     Document: typeof yaml.Document;
     parseDocument: typeof yaml.parseDocument;
 };
 export default _default;
 export declare const YAML: {
-    parse: typeof yaml.parse;
-    stringify: typeof yaml.stringify;
+    parse: typeof parse;
+    stringify: typeof stringify;
     Document: typeof yaml.Document;
     parseDocument: typeof yaml.parseDocument;
 };
 /**
- * FIX-ONCE BENEFITS:
- * 1. All yaml imports go through here
- * 2. Easy to switch to bundled version later
- * 3. Can add logging/debugging if needed
- * 4. Single place to manage yaml
+ * 🔥 ROCK SOLID STATUS: ACHIEVED
  *
- * BUNDLE STRATEGY:
- * When we're ready to bundle, we'll:
- * 1. Copy yaml source into src/bundled/
- * 2. Update this file to import from there
- * 3. Remove yaml from package.json
- * 4. Done! YAML is part of FAF!
- */
-/**
- * FAF YAML USAGE PATTERNS:
- *
- * 1. Parsing .faf files:
- *    const config = parse(fileContent);
+ * All edge cases handled:
+ * ✅ Null/undefined → Clear error
+ * ✅ Empty files → Clear error
+ * ✅ Wrong types → Clear error
+ * ✅ Invalid YAML → Wrapped error with context
+ * ✅ Primitives → Clear error (.faf must be objects)
+ * ✅ Arrays → Clear error (.faf must be objects)
  *
- * 2. Writing .faf files:
- *    const yamlString = stringify(config);
- *
- * 3. That's literally it! We keep it simple!
- *
- * 🍜 NOODLE PRESERVATION STATUS: SECURED
- */ 
+ * FIX ONCE, DONE FOREVER
+ */
 //# sourceMappingURL=yaml.d.ts.map

package/dist/fix-once/yaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/fix-once/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,eAAO,MAAM,KAAK,mBAAa,CAAC;AAChC,eAAO,MAAM,SAAS,uBAAiB,CAAC;AACxC,eAAO,MAAM,QAAQ,sBAAgB,CAAC;AACtC,eAAO,MAAM,aAAa,2BAAqB,CAAC;;;;;;;AAGhD,wBAKE;AAGF,eAAO,MAAM,IAAI;;;;;CAKhB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/fix-once/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAmE9F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM,CAmC1D;AAGD,eAAO,MAAM,aAAa,2BAAqB,CAAC;AAChD,eAAO,MAAM,QAAQ,sBAAgB,CAAC;;;;;;;AAGtC,wBAKE;AAGF,eAAO,MAAM,IAAI;;;;;CAKhB,CAAC;AAEF;;;;;;;;;;;;GAYG"}

package/dist/fix-once/yaml.js

@@ -1,12 +1,19 @@
 "use strict";
 /**
- * 🍜 YAML FIX-ONCE ABSTRACTION
+ * 🔥 YAML FIX-ONCE ABSTRACTION
  *
- * This module will handle the transition from external yaml
- * to bundled yaml seamlessly!
+ * ROCK SOLID YAML PARSING - FIX ONCE, DONE FOREVER
  *
- * CURRENT STATUS: Using external yaml
- * FUTURE STATUS: Will use bundled yaml
+ * This module handles ALL YAML edge cases:
+ * ✅ Empty files
+ * ✅ Null/undefined content
+ * ✅ Invalid YAML syntax
+ * ✅ Type validation
+ * ✅ Corrupted files
+ * ✅ Clear error messages
+ * ✅ Primitive vs Object validation
+ *
+ * NEVER touch raw YAML parsing outside this file.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -42,53 +49,124 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.YAML = exports.parseDocument = exports.Document = exports.stringify = exports.parse = void 0;
-// For now, use the external yaml package
+exports.YAML = exports.Document = exports.parseDocument = void 0;
+exports.parse = parse;
+exports.stringify = stringify;
 const yaml = __importStar(require("yaml"));
-// Export everything FAF uses
-exports.parse = yaml.parse;
-exports.stringify = yaml.stringify;
-exports.Document = yaml.Document;
+const colors_1 = require("./colors");
+/**
+ * Safe YAML parse - handles ALL edge cases
+ * ROCK SOLID - FIX ONCE, DONE FOREVER
+ */
+function parse(content, options) {
+    const filepath = options?.filepath || 'unknown file';
+    // Edge case 1: Null/undefined (CHECK FIRST before any operations)
+    if (content === null || content === undefined) {
+        throw new Error(`${colors_1.chalk.red('Empty content passed to YAML parser')}\n` +
+            `File: ${filepath}\n` +
+            `Fix: Ensure file exists and has content before parsing`);
+    }
+    // Edge case 2: Not a string (CHECK BEFORE calling string methods)
+    if (typeof content !== 'string') {
+        throw new Error(`${colors_1.chalk.red('Invalid content type passed to YAML parser')}\n` +
+            `Expected: string\n` +
+            `Got: ${typeof content}\n` +
+            `File: ${filepath}`);
+    }
+    // Edge case 3: Empty string or whitespace only
+    if (content.trim() === '') {
+        throw new Error(`${colors_1.chalk.red('Empty .faf file detected')}\n` +
+            `File: ${filepath}\n` +
+            `Fix: Run ${colors_1.chalk.cyan('faf init')} to recreate the file`);
+    }
+    // Edge case 4: Parse YAML and handle syntax errors
+    let result;
+    try {
+        result = yaml.parse(content);
+    }
+    catch (error) {
+        // Wrap yaml parsing errors with helpful context
+        throw new Error(`${colors_1.chalk.red('Invalid YAML syntax')}\n` +
+            `File: ${filepath}\n` +
+            `Error: ${error.message}\n` +
+            `Fix: Check file syntax or run ${colors_1.chalk.cyan('faf init --force')} to recreate`);
+    }
+    // Edge case 5: Parsed successfully but result is null/undefined
+    // (valid YAML like "null" or "~" or empty documents)
+    if (result === null || result === undefined) {
+        throw new Error(`${colors_1.chalk.red('YAML file parsed but contains no data')}\n` +
+            `File: ${filepath}\n` +
+            `Fix: Ensure file has valid YAML content or run ${colors_1.chalk.cyan('faf init')}`);
+    }
+    // Edge case 6: Parsed to primitive (not an object)
+    // .faf files must be YAML objects, not scalars
+    if (typeof result !== 'object' || Array.isArray(result)) {
+        throw new Error(`${colors_1.chalk.red('Invalid .faf structure - must be a YAML object')}\n` +
+            `File: ${filepath}\n` +
+            `Got: ${Array.isArray(result) ? 'array' : typeof result}\n` +
+            `Fix: .faf files must contain key-value pairs, not ${Array.isArray(result) ? 'lists' : 'simple values'}`);
+    }
+    return result;
+}
+/**
+ * Safe YAML stringify - handles edge cases
+ * ROCK SOLID - FIX ONCE, DONE FOREVER
+ */
+function stringify(data, options) {
+    // Edge case 1: Null/undefined data
+    if (data === null || data === undefined) {
+        throw new Error(`${colors_1.chalk.red('Cannot stringify null/undefined data to YAML')}\n` +
+            `Fix: Provide valid data object`);
+    }
+    // Edge case 2: Not an object (primitives should not be stringified for .faf)
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        throw new Error(`${colors_1.chalk.red('Invalid data for .faf stringify')}\n` +
+            `Expected: object\n` +
+            `Got: ${Array.isArray(data) ? 'array' : typeof data}\n` +
+            `Fix: .faf files must be objects with key-value pairs`);
+    }
+    // Edge case 3: Stringify and catch any errors
+    try {
+        const result = yaml.stringify(data, options);
+        // Edge case 4: Empty result
+        if (!result || result.trim() === '') {
+            throw new Error('Stringify produced empty output');
+        }
+        return result;
+    }
+    catch (error) {
+        throw new Error(`${colors_1.chalk.red('Failed to convert data to YAML')}\n` +
+            `Error: ${error.message}`);
+    }
+}
+// Export raw versions for advanced usage (use with caution)
 exports.parseDocument = yaml.parseDocument;
+exports.Document = yaml.Document;
 // Re-export as default for compatibility
 exports.default = {
-    parse: exports.parse,
-    stringify: exports.stringify,
+    parse,
+    stringify,
     Document: exports.Document,
     parseDocument: exports.parseDocument
 };
 // Also export as YAML for compatibility
 exports.YAML = {
-    parse: exports.parse,
-    stringify: exports.stringify,
+    parse,
+    stringify,
     Document: exports.Document,
     parseDocument: exports.parseDocument
 };
 /**
- * FIX-ONCE BENEFITS:
- * 1. All yaml imports go through here
- * 2. Easy to switch to bundled version later
- * 3. Can add logging/debugging if needed
- * 4. Single place to manage yaml
+ * 🔥 ROCK SOLID STATUS: ACHIEVED
  *
- * BUNDLE STRATEGY:
- * When we're ready to bundle, we'll:
- * 1. Copy yaml source into src/bundled/
- * 2. Update this file to import from there
- * 3. Remove yaml from package.json
- * 4. Done! YAML is part of FAF!
- */
-/**
- * FAF YAML USAGE PATTERNS:
- *
- * 1. Parsing .faf files:
- *    const config = parse(fileContent);
+ * All edge cases handled:
+ * ✅ Null/undefined → Clear error
+ * ✅ Empty files → Clear error
+ * ✅ Wrong types → Clear error
+ * ✅ Invalid YAML → Wrapped error with context
+ * ✅ Primitives → Clear error (.faf must be objects)
+ * ✅ Arrays → Clear error (.faf must be objects)
  *
- * 2. Writing .faf files:
- *    const yamlString = stringify(config);
- *
- * 3. That's literally it! We keep it simple!
- *
- * 🍜 NOODLE PRESERVATION STATUS: SECURED
- */ 
+ * FIX ONCE, DONE FOREVER
+ */
 //# sourceMappingURL=yaml.js.map

package/dist/fix-once/yaml.js.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/fix-once/yaml.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yCAAyC;AACzC,2CAA6B;AAE7B,6BAA6B;AAChB,QAAA,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;AACnB,QAAA,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;AAC3B,QAAA,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACzB,QAAA,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;AAEhD,yCAAyC;AACzC,kBAAe;IACb,KAAK,EAAL,aAAK;IACL,SAAS,EAAT,iBAAS;IACT,QAAQ,EAAR,gBAAQ;IACR,aAAa,EAAb,qBAAa;CACd,CAAC;AAEF,wCAAwC;AAC3B,QAAA,IAAI,GAAG;IAClB,KAAK,EAAL,aAAK;IACL,SAAS,EAAT,iBAAS;IACT,QAAQ,EAAR,gBAAQ;IACR,aAAa,EAAb,qBAAa;CACd,CAAC;AAEF;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/fix-once/yaml.ts"],"names":[],"mappings":"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"}

package/dist/generators/faf-generator-championship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faf-generator-championship.d.ts","sourceRoot":"","sources":["../../src/generators/faf-generator-championship.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAuVjB"}
+{"version":3,"file":"faf-generator-championship.d.ts","sourceRoot":"","sources":["../../src/generators/faf-generator-championship.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAyZjB"}

package/dist/generators/faf-generator-championship.js

@@ -203,6 +203,76 @@ async function generateFafFromProject(options) {
             contextSlotsFilled['how'] = humanContext.how.value;
         }
     }
+    // CLI-specific detection and smart slot reuse
+    const deps = {
+        ...packageData.dependencies,
+        ...packageData.devDependencies
+    };
+    const isCLI = packageData.bin ||
+        packageData.name?.includes('cli') ||
+        packageData.keywords?.includes('cli') ||
+        packageData.keywords?.includes('command-line') ||
+        deps?.commander ||
+        deps?.yargs ||
+        deps?.oclif ||
+        deps?.inquirer;
+    if (isCLI) {
+        // Smart slot reuse for CLI projects
+        contextSlotsFilled['framework'] = 'CLI'; // frontend = CLI
+        contextSlotsFilled['api_type'] = 'CLI';
+        contextSlotsFilled['hosting'] = 'npm registry';
+        contextSlotsFilled['backend'] = 'Node.js';
+        // Detect terminal UI framework
+        if (deps?.chalk)
+            contextSlotsFilled['css_framework'] = 'chalk (terminal colors)';
+        else if (deps?.colors)
+            contextSlotsFilled['css_framework'] = 'colors';
+        else if (deps?.ora)
+            contextSlotsFilled['css_framework'] = 'ora';
+        // Detect interactive framework
+        if (deps?.inquirer)
+            contextSlotsFilled['ui_library'] = 'inquirer (interactive prompts)';
+        else if (deps?.prompts)
+            contextSlotsFilled['ui_library'] = 'prompts';
+        else if (deps?.enquirer)
+            contextSlotsFilled['ui_library'] = 'enquirer';
+        // Detect CLI framework
+        if (deps?.commander)
+            contextSlotsFilled['cli_framework'] = 'commander';
+        else if (deps?.yargs)
+            contextSlotsFilled['cli_framework'] = 'yargs';
+        else if (deps?.oclif)
+            contextSlotsFilled['cli_framework'] = 'oclif';
+        // Detect runtime
+        if (packageData.engines?.node) {
+            contextSlotsFilled['runtime'] = `Node.js ${packageData.engines.node}`;
+        }
+        else {
+            contextSlotsFilled['runtime'] = 'Node.js v16+';
+        }
+        // Detect build system
+        if (deps?.typescript || deps?.['@types/node']) {
+            contextSlotsFilled['build_tool'] = 'TypeScript (tsc)';
+        }
+        // Detect testing
+        if (deps?.jest)
+            contextSlotsFilled['test_framework'] = 'Jest';
+        else if (deps?.mocha)
+            contextSlotsFilled['test_framework'] = 'Mocha';
+        else if (deps?.vitest)
+            contextSlotsFilled['test_framework'] = 'Vitest';
+        // Detect CI/CD - check for .github/workflows directory
+        try {
+            const githubWorkflowsPath = path_1.default.join(projectRoot, '.github', 'workflows');
+            const githubWorkflowsExists = await fs_1.promises.access(githubWorkflowsPath).then(() => true).catch(() => false);
+            if (githubWorkflowsExists) {
+                contextSlotsFilled['cicd'] = 'GitHub Actions';
+            }
+        }
+        catch {
+            // Continue without CI/CD detection
+        }
+    }
     // Override with package.json if more specific
     if (packageData.name && !contextSlotsFilled['project_name']) {
         contextSlotsFilled['project_name'] = packageData.name;
@@ -323,12 +393,12 @@ async function generateFafFromProject(options) {
         projectGoal: contextSlotsFilled['project_goal'] || 'Build amazing software',
         mainLanguage: contextSlotsFilled['main_language'] || 'JavaScript',
         framework: contextSlotsFilled['framework'] || 'None',
-        cssFramework: undefined,
-        uiLibrary: undefined,
+        cssFramework: contextSlotsFilled['css_framework'] || undefined,
+        uiLibrary: contextSlotsFilled['ui_library'] || undefined,
         stateManagement: undefined,
         backend: contextSlotsFilled['backend'] || 'None',
         apiType: contextSlotsFilled['api_type'] || 'REST',
-        server: contextSlotsFilled['server'] || 'None',
+        server: contextSlotsFilled['runtime'] || contextSlotsFilled['server'] || 'None',
         database: contextSlotsFilled['database'] || 'None',
         connection: 'None',
         hosting: contextSlotsFilled['hosting'] || 'None',