mycontext-cli 1.0.24 → 1.0.25

package/dist/commands/generate.js

@@ -412,6 +412,46 @@ class GenerateCommand {
             }
         }
         catch { }
+        // If no description provided, scan .mycontext folder for context files
+        if (!projectContext.description) {
+            const contextFiles = await this.scanMyContextFiles();
+            if (contextFiles.length > 0) {
+                console.log(chalk_1.default.blue(`\n📁 Found ${contextFiles.length} context files in .mycontext folder:`));
+                contextFiles.forEach((file) => {
+                    console.log(chalk_1.default.gray(`   - ${file}`));
+                });
+                // Let user select which files to use
+                const response = await (0, prompts_1.default)({
+                    type: "multiselect",
+                    name: "selectedFiles",
+                    message: "Select files to use as context:",
+                    choices: contextFiles.map((file) => ({
+                        title: file,
+                        value: file,
+                        selected: true, // Select all by default
+                    })),
+                    instructions: "Use arrow keys to navigate, space to select/deselect, enter to confirm",
+                });
+                if (response.selectedFiles && response.selectedFiles.length > 0) {
+                    // Read selected files and combine content
+                    let combinedContent = "";
+                    for (const file of response.selectedFiles) {
+                        try {
+                            const content = await fs.readFile(file, "utf8");
+                            combinedContent += `\n\n## ${path_1.default.basename(file)}\n\n${content}`;
+                        }
+                        catch (error) {
+                            console.log(chalk_1.default.yellow(`⚠️ Could not read ${file}`));
+                        }
+                    }
+                    if (combinedContent.trim()) {
+                        // Update project context with combined content
+                        projectContext.description = combinedContent.trim();
+                        console.log(chalk_1.default.green(`✅ Using content from ${response.selectedFiles.length} files as context`));
+                    }
+                }
+            }
+        }
         // Get active playbook for additional context
         const activePlaybook = await this.getActivePlaybook();
         const prompt = [
@@ -1533,45 +1573,201 @@ Make the CSS immediately usable - no placeholders, actual working values!`;
             ctx.brand.split("\n").slice(0, 40).join("\n"),
             "",
             "Available shadcn/ui primitives (import from '@/components/ui/<component>'):",
-            (ctx.shadcn.length ? ctx.shadcn : this.getCanonicalShadcnList())
-                .slice(0, 60)
-                .join(", "),
+            this.getComprehensiveShadcnList().join(", "),
             "",
-            "Return strictly valid JSON ONLY with this shape:",
+            "Return strictly valid JSON ONLY with this ATOMIC → COMPOSITE → PAGE hierarchical structure:",
+            "",
+            "PHILOSOPHY: Start with the smallest atomic components, then compose them into larger structures, then into full pages.",
+            "This ensures consistency, reusability, and clear context about where each component belongs.",
+            "",
+            "JSON Structure:",
             "{",
-            '  "groups": [',
+            '  "pages": [',
             "    {",
-            '      "name": string (PascalCase or words),',
-            '      "description": string,',
-            '      "components": [',
+            '      "name": "PageName" (PascalCase),',
+            '      "description": "Main page description",',
+            '      "type": "page",',
+            '      "priority": "high",',
+            '      "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      },",
+            '      "composites": [',
             "        {",
-            '          "name": string (PascalCase),',
-            '          "description": string,',
-            '          "type": "layout"|"display"|"interactive"|"form",',
-            '          "priority": "high"|"medium"|"low",',
-            '          "dependencies": string[],',
-            '          "tags": string[],',
-            '          "acceptanceCriteria": string[],',
-            '          "context": string',
+            '          "name": "CompositeName" (PascalCase),',
+            '          "description": "Larger structural component",',
+            '          "type": "composite",',
+            '          "priority": "high",',
+            '          "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      },",
+            '          "atomics": [',
+            "            {",
+            '              "name": "AtomicName" (PascalCase),',
+            '              "description": "Smallest reusable component",',
+            '              "type": "atomic",',
+            '              "priority": "high",',
+            '              "dependencies": ["shadcn/ui components"],',
+            '              "tags": ["specific", "reusable"],',
+            '              "acceptanceCriteria": ["specific criteria"],',
+            '              "context": "Where this atomic component is used",',
+            '              "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      }",
+            "            }",
+            "          ]",
             "        }",
             "      ]",
             "    }",
-            "  ]",
-            "  ,",
+            "  ],",
+            '  "standaloneComposites": [',
+            "    {",
+            '      "name": "StandaloneComposite" (PascalCase),',
+            '      "description": "Reusable composite not tied to specific page",',
+            '      "type": "composite",',
+            '      "priority": "medium",',
+            '      "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      },",
+            '      "atomics": [',
+            "        {",
+            '          "name": "AtomicName" (PascalCase),',
+            '          "description": "Atomic component within standalone composite",',
+            '          "type": "atomic",',
+            '          "priority": "medium",',
+            '          "dependencies": ["shadcn/ui components"],',
+            '          "tags": ["reusable", "standalone"],',
+            '          "acceptanceCriteria": ["specific criteria"],',
+            '          "context": "Context within standalone composite",',
+            '          "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      }",
+            "        }",
+            "      ]",
+            "    }",
+            "  ],",
+            '  "standaloneAtomics": [',
+            "    {",
+            '      "name": "StandaloneAtomic" (PascalCase),',
+            '      "description": "Reusable atomic component not tied to specific structure",',
+            '      "type": "atomic",',
+            '      "priority": "low",',
+            '      "dependencies": ["shadcn/ui components"],',
+            '      "tags": ["utility", "standalone"],',
+            '      "acceptanceCriteria": ["specific criteria"],',
+            '      "context": "General utility component",',
+            '      "development": {',
+            '        "status": "planned|in-progress|completed|testing|deployed",',
+            '        "progress": 0-100,',
+            '        "assignedTo": "developer-name",',
+            '        "startDate": "YYYY-MM-DD",',
+            '        "targetDate": "YYYY-MM-DD",',
+            '        "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '        "notes": "Development notes and updates"',
+            "      }",
+            "    }",
+            "  ],",
             '  "metadata": {',
             '    "coreCandidates": [',
-            '      { "name": string, "group": string, "reason": string },',
-            '      { "name": string, "group": string, "reason": string },',
-            '      { "name": string, "group": string, "reason": string }',
+            '      { "name": string, "type": "page|composite|atomic", "reason": string },',
+            '      { "name": string, "type": "page|composite|atomic", "reason": string },',
+            '      { "name": string, "type": "page|composite|atomic", "reason": string }',
+            "    ],",
+            '    "hierarchy": {',
+            '      "atomicCount": number,',
+            '      "compositeCount": number,',
+            '      "pageCount": number,',
+            '      "maxDepth": number',
+            "    },",
+            '    "development": {',
+            '      "projectStatus": "planning|in-progress|testing|completed|deployed",',
+            '      "overallProgress": 0-100,',
+            '      "teamMembers": ["developer1", "developer2"],',
+            '      "projectStartDate": "YYYY-MM-DD",',
+            '      "projectTargetDate": "YYYY-MM-DD",',
+            '      "lastUpdated": "YYYY-MM-DDTHH:mm:ss.sssZ",',
+            '      "milestones": [',
+            '        { "name": "Phase 1", "status": "completed", "date": "YYYY-MM-DD" },',
+            '        { "name": "Phase 2", "status": "in-progress", "date": "YYYY-MM-DD" }',
+            "      ]",
+            "    },",
+            '    "availableShadcnComponents": [',
+            '      "accordion", "alert", "alert-dialog", "aspect-ratio", "avatar", "badge",',
+            '      "breadcrumb", "button", "calendar", "card", "carousel", "chart",',
+            '      "checkbox", "collapsible", "command", "context-menu", "dialog", "drawer",',
+            '      "dropdown-menu", "form", "hover-card", "input", "input-otp", "label",',
+            '      "menubar", "navigation-menu", "pagination", "popover", "progress",',
+            '      "radio-group", "resizable", "scroll-area", "select", "separator", "sheet",',
+            '      "sidebar", "skeleton", "slider", "sonner", "switch", "table", "tabs",',
+            '      "textarea", "toggle", "toggle-group", "tooltip"',
             "    ]",
             "  }",
             "}",
             "",
-            "Rules:",
+            "ATOMIC → COMPOSITE → PAGE RULES:",
+            "1. ATOMIC: Smallest, most reusable components (Button, Input, Card, Badge)",
+            "2. COMPOSITE: Composed of multiple atomics (PlayerCard, FormSection, NavigationBar)",
+            "3. PAGE: Full page layouts composed of composites (HomePage, DashboardPage)",
+            "4. NESTING: Each level can contain the level below it",
+            "5. CONTEXT: Always specify where each component belongs in the hierarchy",
+            "6. REUSABILITY: Atomic components should be reusable across different contexts",
+            "7. CONSISTENCY: Similar components at the same level should follow similar patterns",
+            "",
+            "DEVELOPMENT TRACKING RULES:",
+            "8. STATUS: Use 'planned' for new components, 'in-progress' for active development",
+            "9. PROGRESS: Set to 0 for planned, 25/50/75 for partial, 100 for completed",
+            "10. ASSIGNMENT: Assign components to team members or 'unassigned'",
+            "11. DATES: Use realistic start/target dates based on component complexity",
+            "12. NOTES: Include development context, blockers, or important updates",
+            "13. HIERARCHY: Update parent progress when child components are completed",
+            "14. MILESTONES: Track major development phases and releases",
+            "",
+            "EXAMPLE STRUCTURE (FTL Transfer Pitch):",
+            "- Page: TransferPitchPage",
+            "  - Composite: PitchLayout",
+            "    - Atomic: PlayerCard (for starters)",
+            "    - Atomic: FormationGrid",
+            "  - Composite: BenchSection",
+            "    - Atomic: PlayerCard (for substitutes)",
+            "    - Atomic: SubstitutionControls",
+            "  - Composite: TransferControls",
+            "    - Atomic: TransferButton",
+            "    - Atomic: BudgetDisplay",
+            "",
+            "JSON RULES:",
             "- No code fences, no comments, no trailing commas.",
             "- Use only the fields above.",
             "- Ensure arrays/objects have no extra commas.",
-            "- Provide up to 3 'coreCandidates' that best represent the design anchor (canvas/layout), with a short reason.",
+            "- Provide up to 3 'coreCandidates' that best represent the design anchor.",
         ].join("\n");
         try {
             // Check if user has local AI keys configured
@@ -1690,38 +1886,214 @@ Make the CSS immediately usable - no placeholders, actual working values!`;
         }
     }
     buildFallbackComponentList(projectContext) {
-        // Neutral skeleton: no assumptions. Valid shape with guidance.
+        // Atomic → Composite → Page hierarchical structure
         return {
-            project: {
-                name: (projectContext?.description || "mycontext-project").slice(0, 40),
-                description: projectContext?.description || "Generated project",
-            },
-            metadata: {
-                version: "1.0.0",
-                generatedAt: new Date().toISOString(),
-                ai: false,
-                provider: "none",
-            },
-            groups: [],
-            guidance: {
-                note: "AI generation timed out. Start by adding groups with components (name, description, type, priority, userStories, actionFunctions, dependencies, tags).",
-                exampleGroup: {
-                    name: "Auth",
-                    description: "Authentication components",
+            pages: [
+                {
+                    name: "HomePage",
+                    description: "Main landing page",
+                    type: "page",
                     priority: "high",
-                    components: [
+                    development: {
+                        status: "planned",
+                        progress: 0,
+                        assignedTo: "unassigned",
+                        startDate: new Date().toISOString().split("T")[0],
+                        targetDate: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000)
+                            .toISOString()
+                            .split("T")[0],
+                        lastUpdated: new Date().toISOString(),
+                        notes: "Initial page setup and planning",
+                    },
+                    composites: [
                         {
-                            name: "LoginForm",
-                            description: "Email/password form",
-                            type: "form",
+                            name: "HeroSection",
+                            description: "Main hero section with call-to-action",
+                            type: "composite",
                             priority: "high",
-                            userStories: ["As a user, I can log in"],
-                            actionFunctions: ["onSubmit"],
-                            dependencies: ["react"],
-                            tags: ["auth", "form"],
+                            development: {
+                                status: "planned",
+                                progress: 0,
+                                assignedTo: "unassigned",
+                                startDate: new Date().toISOString().split("T")[0],
+                                targetDate: new Date(Date.now() + 3 * 24 * 60 * 60 * 1000)
+                                    .toISOString()
+                                    .split("T")[0],
+                                lastUpdated: new Date().toISOString(),
+                                notes: "Hero section component planning",
+                            },
+                            atomics: [
+                                {
+                                    name: "HeroTitle",
+                                    description: "Main page title",
+                                    type: "atomic",
+                                    priority: "high",
+                                    dependencies: ["@/components/ui/typography"],
+                                    tags: ["title", "hero"],
+                                    acceptanceCriteria: [
+                                        "Displays main title",
+                                        "Responsive text",
+                                    ],
+                                    context: "Main hero section title",
+                                    development: {
+                                        status: "planned",
+                                        progress: 0,
+                                        assignedTo: "unassigned",
+                                        startDate: new Date().toISOString().split("T")[0],
+                                        targetDate: new Date(Date.now() + 1 * 24 * 60 * 60 * 1000)
+                                            .toISOString()
+                                            .split("T")[0],
+                                        lastUpdated: new Date().toISOString(),
+                                        notes: "Title component implementation",
+                                    },
+                                },
+                                {
+                                    name: "HeroButton",
+                                    description: "Primary call-to-action button",
+                                    type: "atomic",
+                                    priority: "high",
+                                    dependencies: ["@/components/ui/button"],
+                                    tags: ["button", "cta"],
+                                    acceptanceCriteria: ["Clickable", "Accessible"],
+                                    context: "Hero section call-to-action",
+                                    development: {
+                                        status: "planned",
+                                        progress: 0,
+                                        assignedTo: "unassigned",
+                                        startDate: new Date().toISOString().split("T")[0],
+                                        targetDate: new Date(Date.now() + 1 * 24 * 60 * 60 * 1000)
+                                            .toISOString()
+                                            .split("T")[0],
+                                        lastUpdated: new Date().toISOString(),
+                                        notes: "CTA button component implementation",
+                                    },
+                                },
+                            ],
                         },
                     ],
                 },
+            ],
+            standaloneComposites: [
+                {
+                    name: "NavigationBar",
+                    description: "Main navigation component",
+                    type: "composite",
+                    priority: "high",
+                    development: {
+                        status: "planned",
+                        progress: 0,
+                        assignedTo: "unassigned",
+                        startDate: new Date().toISOString().split("T")[0],
+                        targetDate: new Date(Date.now() + 2 * 24 * 60 * 60 * 1000)
+                            .toISOString()
+                            .split("T")[0],
+                        lastUpdated: new Date().toISOString(),
+                        notes: "Navigation component planning",
+                    },
+                    atomics: [
+                        {
+                            name: "NavLink",
+                            description: "Navigation link component",
+                            type: "atomic",
+                            priority: "high",
+                            dependencies: ["@/components/ui/link"],
+                            tags: ["navigation", "link"],
+                            acceptanceCriteria: ["Clickable", "Active state"],
+                            context: "Navigation bar links",
+                            development: {
+                                status: "planned",
+                                progress: 0,
+                                assignedTo: "unassigned",
+                                startDate: new Date().toISOString().split("T")[0],
+                                targetDate: new Date(Date.now() + 1 * 24 * 60 * 60 * 1000)
+                                    .toISOString()
+                                    .split("T")[0],
+                                lastUpdated: new Date().toISOString(),
+                                notes: "Navigation link component implementation",
+                            },
+                        },
+                    ],
+                },
+            ],
+            standaloneAtomics: [
+                {
+                    name: "LoadingSpinner",
+                    description: "Reusable loading indicator",
+                    type: "atomic",
+                    priority: "low",
+                    dependencies: ["@/components/ui/spinner"],
+                    tags: ["utility", "loading"],
+                    acceptanceCriteria: ["Animated", "Accessible"],
+                    context: "General loading states",
+                    development: {
+                        status: "planned",
+                        progress: 0,
+                        assignedTo: "unassigned",
+                        startDate: new Date().toISOString().split("T")[0],
+                        targetDate: new Date(Date.now() + 1 * 24 * 60 * 60 * 1000)
+                            .toISOString()
+                            .split("T")[0],
+                        lastUpdated: new Date().toISOString(),
+                        notes: "Loading spinner utility component",
+                    },
+                },
+            ],
+            metadata: {
+                coreCandidates: [
+                    { name: "HomePage", type: "page", reason: "Main entry point" },
+                    {
+                        name: "HeroSection",
+                        type: "composite",
+                        reason: "Primary content area",
+                    },
+                    {
+                        name: "HeroButton",
+                        type: "atomic",
+                        reason: "Key interaction element",
+                    },
+                ],
+                hierarchy: {
+                    atomicCount: 4,
+                    compositeCount: 2,
+                    pageCount: 1,
+                    maxDepth: 3,
+                },
+                development: {
+                    projectStatus: "planning",
+                    overallProgress: 0,
+                    teamMembers: ["unassigned"],
+                    projectStartDate: new Date().toISOString().split("T")[0],
+                    projectTargetDate: new Date(Date.now() + 14 * 24 * 60 * 60 * 1000)
+                        .toISOString()
+                        .split("T")[0],
+                    lastUpdated: new Date().toISOString(),
+                    milestones: [
+                        {
+                            name: "Planning Phase",
+                            status: "in-progress",
+                            date: new Date().toISOString().split("T")[0],
+                        },
+                        {
+                            name: "Development Phase",
+                            status: "planned",
+                            date: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000)
+                                .toISOString()
+                                .split("T")[0],
+                        },
+                        {
+                            name: "Testing Phase",
+                            status: "planned",
+                            date: new Date(Date.now() + 12 * 24 * 60 * 60 * 1000)
+                                .toISOString()
+                                .split("T")[0],
+                        },
+                    ],
+                },
+                availableShadcnComponents: this.getComprehensiveShadcnList(),
+                version: "1.0.0",
+                generatedAt: new Date().toISOString(),
+                ai: false,
+                provider: "fallback",
             },
         };
     }
@@ -2833,6 +3205,29 @@ export function Typography({ variant, children, className }: TypographyProps) {
         // 4) Fallback: wrap into minimal valid envelope
         return JSON.stringify({ error: "Invalid JSON from AI", raw }, null, 2);
     }
+    async scanMyContextFiles() {
+        const myContextDir = ".mycontext";
+        const files = [];
+        try {
+            if (await fs.pathExists(myContextDir)) {
+                const items = await fs.readdir(myContextDir);
+                for (const item of items) {
+                    const fullPath = path_1.default.join(myContextDir, item);
+                    const stat = await fs.stat(fullPath);
+                    if (stat.isFile() &&
+                        (item.endsWith(".md") ||
+                            item.endsWith(".txt") ||
+                            item.endsWith(".json"))) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Ignore errors, return empty array
+        }
+        return files;
+    }
     async readContextArtifacts() {
         try {
             const cwd = process.cwd();
@@ -2965,6 +3360,56 @@ export function Typography({ variant, children, className }: TypographyProps) {
             "Typography",
         ];
     }
+    getComprehensiveShadcnList() {
+        return [
+            "accordion",
+            "alert",
+            "alert-dialog",
+            "aspect-ratio",
+            "avatar",
+            "badge",
+            "breadcrumb",
+            "button",
+            "calendar",
+            "card",
+            "carousel",
+            "chart",
+            "checkbox",
+            "collapsible",
+            "command",
+            "context-menu",
+            "dialog",
+            "drawer",
+            "dropdown-menu",
+            "form",
+            "hover-card",
+            "input",
+            "input-otp",
+            "label",
+            "menubar",
+            "navigation-menu",
+            "pagination",
+            "popover",
+            "progress",
+            "radio-group",
+            "resizable",
+            "scroll-area",
+            "select",
+            "separator",
+            "sheet",
+            "sidebar",
+            "skeleton",
+            "slider",
+            "sonner",
+            "switch",
+            "table",
+            "tabs",
+            "textarea",
+            "toggle",
+            "toggle-group",
+            "tooltip",
+        ];
+    }
     repairJson(raw) {
         // Remove any fenced code blocks markers
         let s = raw.replace(/```json\n?|```/gi, "");