mycontext-cli 2.0.26 → 2.0.28

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "2.0.26",
+  "version": "2.0.28",
   "description": "Component-first visual builder with zero-error guarantees. Generate and validate React/Next.js components one at a time, preview them visually, then scale to complete applications using Claude Agent SDK.",
   "main": "dist/cli.js",
   "bin": {
@@ -55,9 +55,11 @@
     "dotenv": "^17.2.3",
     "dotenv-expand": "^12.0.3",
     "fs-extra": "^11.1.1",
+    "fuse.js": "^7.1.0",
     "glob": "^10.3.10",
     "inquirer": "^9.2.12",
     "node-fetch": "^2.7.0",
+    "openai": "^6.2.0",
     "ora": "^7.0.1",
     "prompts": "^2.4.2",
     "sonner": "^2.0.7",

package/dist/services/IntentEnricher.d.ts

@@ -0,0 +1,61 @@
+import { IntentValidationReport, EnrichedComponentSpec } from "../types/intent-dictionary";
+import { FunctionalSummary, VisualSystem } from "../types/design-pipeline";
+/**
+ * IntentEnricher Service
+ *
+ * Transforms validated intents into enriched component specifications
+ * with expanded templates, design token mappings, and full type definitions.
+ */
+export declare class IntentEnricher {
+    private dictionaryPath;
+    constructor();
+    /**
+     * Enrich validated intents into component specifications
+     */
+    enrichComponentDefinitions(summary: FunctionalSummary, validation: IntentValidationReport, visualSystem?: VisualSystem): Promise<EnrichedComponentSpec[]>;
+    /**
+     * Enrich a single validated intent
+     */
+    private enrichSingleIntent;
+    /**
+     * Generate component name from intent and context
+     */
+    private generateComponentName;
+    /**
+     * Get appropriate suffix for component type
+     */
+    private getComponentSuffix;
+    /**
+     * Convert string to PascalCase
+     */
+    private toPascalCase;
+    /**
+     * Expand template with placeholder values
+     */
+    private expandTemplate;
+    /**
+     * Extract label from intent text
+     */
+    private extractLabel;
+    /**
+     * Map design tokens from visual system
+     */
+    private mapDesignTokens;
+    /**
+     * Generate TypeScript type definitions for component
+     */
+    private generateTypeDefinitions;
+    /**
+     * Get component category from canonical name
+     */
+    getComponentCategory(canonicalName: string): string;
+    /**
+     * Generate usage example for component
+     */
+    generateUsageExample(spec: EnrichedComponentSpec): string;
+    /**
+     * Calculate complexity score for enriched spec
+     */
+    calculateComplexity(spec: EnrichedComponentSpec): number;
+}
+//# sourceMappingURL=IntentEnricher.d.ts.map

package/dist/services/IntentEnricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentEnricher.d.ts","sourceRoot":"","sources":["../../src/services/IntentEnricher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EAEtB,qBAAqB,EAEtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK3E;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAS;;IAW/B;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,sBAAsB,EAClC,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAkCnC;;OAEG;YACW,kBAAkB;IAwDhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAiBnD;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM;IAoBzD;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM;CAqBzD"}

package/dist/services/IntentEnricher.js

@@ -0,0 +1,318 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentEnricher = void 0;
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * IntentEnricher Service
+ *
+ * Transforms validated intents into enriched component specifications
+ * with expanded templates, design token mappings, and full type definitions.
+ */
+class IntentEnricher {
+    constructor() {
+        this.dictionaryPath = path.join(__dirname, "..", "config", "intent-dictionary.json");
+    }
+    /**
+     * Enrich validated intents into component specifications
+     */
+    async enrichComponentDefinitions(summary, validation, visualSystem) {
+        console.log(chalk_1.default.blue("🔧 Enriching intents into component specifications..."));
+        const enrichedSpecs = [];
+        for (const validatedIntent of validation.validated_intents) {
+            try {
+                const enrichedSpec = await this.enrichSingleIntent(validatedIntent, summary, visualSystem);
+                enrichedSpecs.push(enrichedSpec);
+            }
+            catch (error) {
+                console.warn(chalk_1.default.yellow(`⚠️  Failed to enrich intent: ${validatedIntent.canonical_name}`), error);
+            }
+        }
+        console.log(chalk_1.default.green(`✅ Enriched ${enrichedSpecs.length} component specifications`));
+        return enrichedSpecs;
+    }
+    /**
+     * Enrich a single validated intent
+     */
+    async enrichSingleIntent(intent, summary, visualSystem) {
+        const mapping = intent.intent_mapping;
+        // Generate component name from intent context
+        const componentName = this.generateComponentName(intent, summary);
+        // Expand template with context
+        const expandedTemplate = this.expandTemplate(mapping.component_pattern.template_code, intent, visualSystem);
+        // Map design tokens
+        const designTokens = visualSystem
+            ? this.mapDesignTokens(mapping.design_tokens, visualSystem)
+            : {};
+        // Generate TypeScript type definitions
+        const typeDefinitions = this.generateTypeDefinitions(mapping, componentName);
+        return {
+            component_name: componentName,
+            original_description: intent.original_text,
+            canonical_intent: intent.canonical_name,
+            intent_confidence: intent.confidence,
+            shadcn_components: mapping.component_pattern.shadcn_components.map((comp) => comp.name),
+            component_imports: mapping.component_pattern.shadcn_components.map((comp) => comp.import_path),
+            design_pattern: mapping.component_pattern,
+            code_template: expandedTemplate,
+            props_spec: [
+                ...mapping.component_pattern.required_props,
+                ...mapping.component_pattern.optional_props,
+            ],
+            type_definitions: typeDefinitions,
+            state_management: mapping.interaction_spec.states,
+            event_handlers: mapping.interaction_spec.events,
+            design_tokens_used: designTokens,
+            accessibility_spec: mapping.accessibility_spec,
+            responsive_config: mapping.responsive_behavior,
+            validation_rules: mapping.validation_rules,
+            conflicts: [],
+        };
+    }
+    /**
+     * Generate component name from intent and context
+     */
+    generateComponentName(intent, summary) {
+        // Try to extract action/noun from original text
+        const text = intent.original_text.toLowerCase();
+        // Common patterns for component names
+        const patterns = [
+            /(\w+)\s+(button|form|dialog|card|table|menu)/,
+            /(login|signup|profile|settings|dashboard)/,
+            /(\w+)\s+(component|page|modal)/,
+        ];
+        for (const pattern of patterns) {
+            const match = text.match(pattern);
+            if (match && match[1]) {
+                return this.toPascalCase(match[1] + "-" + match[2]);
+            }
+        }
+        // Fallback: use canonical intent name + suffix
+        const base = intent.canonical_name.replace(/-/g, " ");
+        const suffix = this.getComponentSuffix(intent.canonical_name);
+        return this.toPascalCase(base + suffix);
+    }
+    /**
+     * Get appropriate suffix for component type
+     */
+    getComponentSuffix(canonicalName) {
+        if (canonicalName.includes("button"))
+            return "";
+        if (canonicalName.includes("form"))
+            return "Form";
+        if (canonicalName.includes("dialog"))
+            return "Dialog";
+        if (canonicalName.includes("card"))
+            return "Card";
+        if (canonicalName.includes("table"))
+            return "Table";
+        if (canonicalName.includes("menu"))
+            return "Menu";
+        return "Component";
+    }
+    /**
+     * Convert string to PascalCase
+     */
+    toPascalCase(str) {
+        return str
+            .split(/[-_\s]/)
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join("");
+    }
+    /**
+     * Expand template with placeholder values
+     */
+    expandTemplate(template, intent, visualSystem) {
+        let expanded = template;
+        // Replace common placeholders
+        const replacements = {
+            "{{label}}": this.extractLabel(intent.original_text),
+            "{{size}}": "default",
+            "{{variant}}": "default",
+            "{{handler}}": "handleAction",
+            "{{className}}": "",
+        };
+        // Add design token replacements
+        if (visualSystem) {
+            replacements["{{primaryColor}}"] = visualSystem.colors.primary;
+            replacements["{{backgroundColor}}"] = visualSystem.colors.background;
+            replacements["{{textColor}}"] = visualSystem.colors.text;
+        }
+        // Replace all placeholders
+        for (const [placeholder, value] of Object.entries(replacements)) {
+            expanded = expanded.replace(new RegExp(placeholder, "g"), value);
+        }
+        return expanded;
+    }
+    /**
+     * Extract label from intent text
+     */
+    extractLabel(text) {
+        // Try to find action words
+        const actionWords = [
+            "submit",
+            "save",
+            "cancel",
+            "delete",
+            "create",
+            "update",
+            "login",
+            "signup",
+            "confirm",
+        ];
+        for (const action of actionWords) {
+            if (text.toLowerCase().includes(action)) {
+                return action.charAt(0).toUpperCase() + action.slice(1);
+            }
+        }
+        return "Action";
+    }
+    /**
+     * Map design tokens from visual system
+     */
+    mapDesignTokens(tokenMappings, visualSystem) {
+        const tokens = {};
+        for (const mapping of tokenMappings) {
+            const tokenPath = mapping.token_path.split(".");
+            let value = visualSystem;
+            // Navigate token path
+            for (const key of tokenPath) {
+                if (value && typeof value === "object" && key in value) {
+                    value = value[key];
+                }
+                else {
+                    value = undefined;
+                    break;
+                }
+            }
+            if (value !== undefined) {
+                tokens[mapping.css_var_name] = String(value);
+            }
+        }
+        return tokens;
+    }
+    /**
+     * Generate TypeScript type definitions for component
+     */
+    generateTypeDefinitions(mapping, componentName) {
+        const props = [
+            ...mapping.component_pattern.required_props,
+            ...mapping.component_pattern.optional_props,
+        ];
+        const propDefinitions = props
+            .map((prop) => {
+            // Determine if prop is required based on which array it came from
+            const isRequired = mapping.component_pattern.required_props.includes(prop);
+            const optional = !isRequired ? "?" : "";
+            const description = prop.description
+                ? `  /** ${prop.description} */\n`
+                : "";
+            return `${description}  ${prop.name}${optional}: ${prop.type};`;
+        })
+            .join("\n");
+        return `export interface ${componentName}Props {
+${propDefinitions}
+}`;
+    }
+    /**
+     * Get component category from canonical name
+     */
+    getComponentCategory(canonicalName) {
+        if (canonicalName.includes("button"))
+            return "interactive";
+        if (canonicalName.includes("form") || canonicalName.includes("input"))
+            return "form";
+        if (canonicalName.includes("dialog") || canonicalName.includes("modal"))
+            return "overlay";
+        if (canonicalName.includes("card") || canonicalName.includes("layout"))
+            return "layout";
+        if (canonicalName.includes("table") || canonicalName.includes("list"))
+            return "data";
+        if (canonicalName.includes("menu") || canonicalName.includes("nav"))
+            return "navigation";
+        if (canonicalName.includes("alert") || canonicalName.includes("toast"))
+            return "feedback";
+        return "display";
+    }
+    /**
+     * Generate usage example for component
+     */
+    generateUsageExample(spec) {
+        const propsExample = spec.props_spec
+            .filter((p) => {
+            // Check if prop is required by looking at the original mapping
+            // For now, assume first few props are required
+            return spec.props_spec.indexOf(p) < 3;
+        })
+            .map((p) => {
+            if (p.type.includes("=>"))
+                return `${p.name}={handleAction}`;
+            if (p.type === "string")
+                return `${p.name}="${p.name}"`;
+            if (p.type === "boolean")
+                return p.name;
+            return `${p.name}={${p.name}}`;
+        })
+            .join(" ");
+        return `<${spec.component_name} ${propsExample}>
+  {children}
+</${spec.component_name}>`;
+    }
+    /**
+     * Calculate complexity score for enriched spec
+     */
+    calculateComplexity(spec) {
+        let complexity = 0;
+        // More shadcn components = more complex
+        complexity += spec.shadcn_components.length * 10;
+        // More required props = more complex
+        complexity +=
+            spec.props_spec.filter((p) => {
+                // Assume first few props are required
+                return spec.props_spec.indexOf(p) < 3;
+            }).length * 5;
+        // State management adds complexity
+        complexity += spec.state_management.length * 8;
+        // More design tokens = more styling = more complex
+        complexity += Object.keys(spec.design_tokens_used || {}).length * 3;
+        return Math.min(complexity, 100);
+    }
+}
+exports.IntentEnricher = IntentEnricher;
+//# sourceMappingURL=IntentEnricher.js.map

package/dist/services/IntentEnricher.js.map

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

package/dist/services/IntentValidator.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Intent Validator Service
+ *
+ * Validates natural language UI descriptions against the intent dictionary,
+ * extracting UI intents and matching them to shadcn/ui component patterns.
+ *
+ * @module services/IntentValidator
+ */
+import { IntentDictionary, IntentValidationReport, IntentMapping } from "../types/intent-dictionary";
+/**
+ * Main service for validating UI intents from natural language
+ */
+export declare class IntentValidator {
+    private dictionary;
+    private dictionaryPath;
+    private fuse;
+    /**
+     * @param dictionaryPath - Optional path to custom dictionary (defaults to built-in)
+     */
+    constructor(dictionaryPath?: string);
+    /**
+     * Load intent dictionary from JSON file
+     */
+    private loadDictionary;
+    /**
+     * Initialize Fuse.js for fuzzy matching
+     */
+    private initializeFuse;
+    /**
+     * Get minimal default dictionary as fallback
+     */
+    private getDefaultDictionary;
+    /**
+     * Main validation method - analyzes context files and extracts UI intents
+     */
+    validateContextFiles(prd: string, types?: string, brand?: string): Promise<IntentValidationReport>;
+    /**
+     * Extract UI intent phrases from text using pattern matching
+     */
+    private extractIntentsFromText;
+    /**
+     * Extract surrounding context for an intent match
+     */
+    private extractContext;
+    /**
+     * Match extracted intents against dictionary
+     */
+    private matchIntents;
+    /**
+     * Find exact phrase match in dictionary
+     */
+    private findExactMatch;
+    /**
+     * Find match via synonym lookup
+     */
+    private findSynonymMatch;
+    /**
+     * Fuzzy match using Fuse.js for better accuracy
+     */
+    private fuzzyMatch;
+    /**
+     * Resolve placeholder values from context
+     */
+    private resolvePlaceholders;
+    /**
+     * Detect ambiguous intents (multiple high-confidence matches)
+     */
+    private detectAmbiguities;
+    /**
+     * Generate reasoning for why an intent matched
+     */
+    private generateReasoning;
+    /**
+     * Find unknown intents that couldn't be matched
+     */
+    private findUnknownIntents;
+    /**
+     * Calculate overall confidence score
+     */
+    private calculateConfidence;
+    /**
+     * Generate clarification requests for ambiguous intents
+     */
+    private generateClarifications;
+    /**
+     * Generate warnings about validation results
+     */
+    private generateWarnings;
+    /**
+     * Generate suggestions for improving intent detection
+     */
+    private generateSuggestions;
+    /**
+     * Update usage analytics
+     */
+    private updateAnalytics;
+    /**
+     * Utility: capitalize first letter
+     */
+    private capitalize;
+    /**
+     * Get current dictionary for inspection
+     */
+    getDictionary(): IntentDictionary;
+    /**
+     * Get list of available intents
+     */
+    getAvailableIntents(): string[];
+    /**
+     * Get intent mapping by canonical name
+     */
+    getIntentMapping(canonicalName: string): IntentMapping | null;
+}
+//# sourceMappingURL=IntentValidator.d.ts.map

package/dist/services/IntentValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentValidator.d.ts","sourceRoot":"","sources":["../../src/services/IntentValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EAMtB,aAAa,EAGd,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,IAAI,CAAY;IAExB;;OAEG;gBACS,cAAc,CAAC,EAAE,MAAM;IAQnC;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoDtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACG,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC;IAwDlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqH9B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;YACW,YAAY;IA6D1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyDlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACI,aAAa,IAAI,gBAAgB;IAIxC;;OAEG;IACI,mBAAmB,IAAI,MAAM,EAAE;IAItC;;OAEG;IACI,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CAGrE"}