mycontext-cli 0.4.10 → 0.4.12

package/README.md

@@ -15,10 +15,10 @@ mycontext init my-app --description "Your project description"
 cd my-app
 
 # Generate context and components
-mycontext generate context
-mycontext generate types
-mycontext generate brand
-mycontext generate components-list
+mycontext generate context        # → 01-prd.md, 01a-brief.md, 01b-requirements.md, 01c-flows.md
+mycontext generate types          # → types/ folder with complete type system (index.ts, database.ts, enums.ts, ui.ts, utils.ts)
+mycontext generate brand          # → brand/ folder with CSS custom properties (globals.css, colors.md, typography.md)
+mycontext generate components-list # → 04-component-list.json
 mycontext generate-components all --local --with-tests
 ```
 
@@ -28,19 +28,27 @@ mycontext generate-components all --local --with-tests
 
 ```bash
 mycontext generate context      # PRD, user stories, technical specs
-mycontext generate types        # TypeScript interfaces
-mycontext generate brand        # Design system and branding
+mycontext generate types        # Complete TypeScript type system (5 files)
+mycontext generate brand        # Design system with CSS custom properties
 mycontext generate components-list  # Component planning
 ```
 
-### 2. Component Generation
+### 2. Core Component (Design Anchor)
+
+```bash
+mycontext core generate         # Generate BrandComp (design anchor)
+mycontext core refine           # Refine as needed
+mycontext core ready            # Mark ready for component generation
+```
+
+### 3. Component Generation
 
 ```bash
 mycontext generate-components all --local --with-tests  # Generate all components
 mycontext generate-components <group> --local          # Generate specific group
 ```
 
-### 3. Preview & Iterate
+### 4. Preview & Iterate
 
 ```bash
 mycontext preview components    # Preview generated components
@@ -68,11 +76,22 @@ mycontext model test              # Test generation
 
 ## 📦 What You Get
 
-- **`.mycontext/prd.md`** — Product Requirements Document
-- **`.mycontext/types.ts`** — TypeScript type definitions
-- **`.mycontext/branding.md`** — Design system specifications
-- **`.mycontext/component-list.json`** — Component architecture plan
-- **`components/.mycontext/`** — Generated React components with shadcn/ui
+- **`.mycontext/01-prd.md`** — Product Requirements Document
+- **`.mycontext/01a-brief.md`** — Project brief summary
+- **`.mycontext/01b-requirements.md`** — Detailed requirements
+- **`.mycontext/01c-flows.md`** — User flows & interactions
+- **`.mycontext/types/`** — Complete TypeScript type system (5 files)
+  - `index.ts` — Main type exports
+  - `database.ts` — Database schema types
+  - `enums.ts` — Enum constants & type guards
+  - `ui.ts` — UI component types
+  - `utils.ts` — Utility types & helpers
+- **`.mycontext/brand/`** — Complete design system
+  - `globals.css` — CSS custom properties
+  - `colors.md` — Color palette documentation
+  - `typography.md` — Typography specifications
+- **`.mycontext/04-component-list.json`** — Component architecture plan
+- **`components/`** — Generated React components with shadcn/ui
 
 ## Environment Setup
 
@@ -93,173 +112,46 @@ ollama pull llama3.2:3b
 mycontext model status
 ```
 
-## Key Features
-
-- **Context-Aware Generation**: Components that match your existing codebase patterns
-- **Brand Consistency**: Automatic adherence to your design system
-- **Type Safety**: Full TypeScript integration with generated interfaces
-- **Production Ready**: Includes tests, documentation, and best practices
-- **Local AI Support**: Ollama fallback for unlimited generation without API costs
-
-## Support
-
-- **GitHub Issues**: Report bugs and request features
-- **Documentation**: Full CLI reference and guides
-- **Community**: Share components and patterns
-
----
-
-**Built for developers who want AI that understands their project context.**
-
-# Core Component (Brand Anchor)
-
-mycontext core generate [name] [--group core] # Generate BrandComp
-mycontext core refine [--desc "improvements"] # Record refinements
-mycontext core ready # Mark ready for use
-mycontext core status # Check core status
+## 🎯 **Integration Guide**
 
-# Component Generation
-
-mycontext generate-components all [--local] [--with-tests] [--check]
-mycontext generate-components <group> [--local] # Single group
-mycontext generate-components all --core-first # Core only, then stop
-
-````
-
-### **AI Enhancement Commands**
+### Using Generated Types
 
 ```bash
-# Component Enhancement & Refinement
-mycontext enhance <component.tsx> [--prompt "improvements"]
-mycontext enhance <group-name> [--interactive]        # Group enhancement
-mycontext refine <component.tsx> [--prompt "changes"] # Focused refinement
-mycontext refine <component.tsx> --rollback           # Rollback changes
-
-# Enhancement Options
---output-format <format>    # structured, diff, preview, apply
---show-changes             # Show detailed change breakdown
---preserve-history         # Keep refinement history
---interactive             # VS Code extension mode
-````
+# Move the types folder to your lib directory
+mv .mycontext/types ./lib/
 
-### **Project Management**
-
-```bash
-# Status & Information
-mycontext status [--detailed] [--check-health]        # Project status
-mycontext list [type] [--format table|json] [--local] # List resources
-mycontext preview <type> [--port 3000]                # Preview components
-
-# List Types: components, projects, files, all
-# Preview Types: brand, components, generated, <group-name>
-
-# Authentication
-mycontext auth [--email] [--code] [--non-interactive] # Magic code auth
-mycontext auth:status                                  # Check auth status
-mycontext auth:logout                                  # Logout
+# Import types in your components
+import type { User, ApiResponse } from "@/lib/types";
+import { USER_ROLES } from "@/lib/types/enums";
 ```
 
-### **Model & AI Management**
+### Using Generated Brand System
 
 ```bash
-# Local Model Management
-mycontext model status [--detailed]                   # Model health check
-mycontext model list                                   # Available models
-mycontext model test [--prompt "text"] [--verbose]    # Test generation
-mycontext model update [--backup]                     # Update model
-mycontext model reset [--force]                       # Reset to clean state
-mycontext model stats [--detailed] [--last 30d]       # Usage statistics
-```
+# Copy the CSS to your globals.css
+cp .mycontext/brand/globals.css ./src/app/globals.css
 
-### **🧠 Enhanced Intelligence Commands**
-
-```bash
-# Predictive Development (Production Ready)
-mycontext predict next                                # Predict next development steps
-mycontext predict dependencies                        # Suggest optimal packages and tools
-mycontext predict patterns                           # Identify architectural patterns
-mycontext predict issues                             # Forecast potential problems
-mycontext predict optimization                       # Recommend performance improvements
-
-# Agent Communication & Auto-Generation
-mycontext agent-flow generate-context               # Multi-agent context generation
-mycontext agent-flow validate-workflow              # Test agent communication system
-mycontext clean                                     # Auto-fix malformed files and issues
-
-# Intelligence Options
---detailed                                          # Show comprehensive analysis
---format json|table                               # Output format
---scope next|dependencies|patterns|issues|optimization  # Prediction scope
+# Use the design tokens
+<div className="bg-primary text-primary-foreground p-4 rounded-lg">
+  Hello World
+</div>
 ```
 
-### **Utilities & Maintenance**
-
-```bash
-# Utilities
-mycontext normalize preview                            # Build preview layout
-mycontext update                                       # Update CLI
-mycontext help                                         # Detailed help
-
-# Global Options
---verbose              # Detailed output
---yes                 # Skip prompts (non-interactive)
---project <name>      # Specify project
---model <name>        # Override model
---models <list>       # Fallback models (comma-separated)
-```
-
-### **Key Options & Behavior**
-
-- `--description`, `--context-file`: Supply input context for generation
-- `--model`, `--models`/`--use-models`: Model override and fallback candidates
-- `--local`: Generate components without auth; remote storage skipped silently
-- `--with-tests`: Scaffold Jest + RTL and generate per-component tests
-- `--check`: Run typecheck, lint, and tests after generation
-- `--core-first`: Generate only core BrandComp, then exit
-- `--interactive`: VS Code extension mode with structured output
-- `--preserve-history`: Keep enhancement/refinement history for rollback
-
-### **Important Behaviors**
-
-- Component list saves to `.mycontext/component-list.json` and merges by name when re-generated
-- Post-generation scan installs missing `@/components/ui/*` shadcn primitives automatically
-- Neutral fallback: if AI times out, valid skeleton written for manual editing
-- Core-first workflow: components-list generation prompts for core selection
-
-## 🛠 Environment & Configuration
-
-### **Authentication & Models**
-
-```bash
-# GitHub Models (optional - provides faster generation when available)
-MYCONTEXT_GITHUB_TOKEN=ghp_xxx          # Set in .mycontext/.env for faster generation
-
-# Ollama (automatic fallback - works without API keys)
-# Install Ollama locally for unlimited component generation
-# No API keys required - works offline when GitHub Models is rate-limited
+## Key Features
 
-# Alternative providers (optional)
-HUGGINGFACE_API_KEY=hf_xxx             # Hugging Face fallback
-XAI_API_KEY=xai_xxx                    # X.AI (Grok) fallback
-```
+- **Context-Aware Generation**: Components that match your existing codebase patterns
+- **Brand Consistency**: Complete design system with CSS custom properties
+- **Type Safety**: Comprehensive TypeScript type system (5 specialized files)
+- **Production Ready**: Includes tests, documentation, and best practices
+- **Local AI Support**: Ollama fallback for unlimited generation without API costs
+- **Design System**: Ready-to-use brand system with complete CSS custom properties
 
-### **Model Configuration**
+## Support
 
-```bash
-# Model selection
-MYCONTEXT_MODEL=deepseek/DeepSeek-V3-0324         # Override default model
-MYCONTEXT_MODEL_CANDIDATES=gpt-4o,claude-3-5      # Fallback list
-MYCONTEXT_PROVIDER=github                          # Force provider
-
-# Rate limiting & retries
-MYCONTEXT_GITHUB_RETRIES=3                        # Retry attempts
-MYCONTEXT_MODEL_PASSES=2                          # Model fallback passes
-MYCONTEXT_MODEL_COOLDOWN_SECONDS=30               # Cooldown between retries
-```
+- **GitHub Issues**: Report bugs and request features
+- **Documentation**: Full CLI reference and guides
+- **Community**: Share components and patterns
 
-### **Setup Notes**
+---
 
-- Init creates `.mycontext/.env.example` with suggested environment variables
-- Standardized naming ensures clean imports and shadcn/ui compatibility
-- Components generated in `components/.mycontext/` to avoid overriding user code
-- Preview system auto-updates with live component registry
+**Built for developers who want AI that understands their project context.**

package/dist/commands/generate.d.ts

@@ -18,6 +18,12 @@ export declare class GenerateCommand {
     private resolveInputContext;
     generateContext(projectContext: any, options: GenerateOptions): Promise<GenerationResult>;
     generateTypes(projectContext: any, options: GenerateOptions): Promise<GenerationResult>;
+    private parseAndStructureTypes;
+    private generateTypesIndex;
+    private generateTypesDatabase;
+    private generateTypesEnums;
+    private generateTypesUI;
+    private generateTypesUtils;
     private sanitizeTypeScriptOutput;
     generateBrand(projectContext: any, options: GenerateOptions): Promise<GenerationResult>;
     generateProjectStructure(projectContext: any, options: GenerateOptions): Promise<GenerationResult>;
@@ -27,6 +33,11 @@ export declare class GenerateCommand {
     private saveGeneratedContent;
     private mergeComponentLists;
     private mergeComponentsByName;
+    private parseAndCreateBrandSystem;
+    private generateBrandCSS;
+    private generateBrandGuide;
+    private generateBrandColors;
+    private generateBrandTypography;
     private sanitizeMarkdownOutput;
     private splitPrdContent;
     private buildSkeleton;

package/dist/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAqB,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA2F/E,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,CAAC,EACD,SAAS,GACT,OAAO,GACP,OAAO,GACP,iBAAiB,GACjB,mBAAmB,GACnB,KAAK,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CACrC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAiB;;IAOrB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuUhD,iBAAiB;YAYT,mBAAmB;IAmF3B,eAAe,CACnB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAsHtB,aAAa,CACjB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAyC5B,OAAO,CAAC,wBAAwB;IA4B1B,aAAa,CACjB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAuCtB,wBAAwB,CAC5B,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAyEtB,qBAAqB,CACzB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IA2K5B,OAAO,CAAC,0BAA0B;YAqCpB,aAAa;YAiBb,oBAAoB;IAyGlC,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,aAAa;YAwBP,oBAAoB;YAwBpB,sBAAsB;IAcpC,OAAO,CAAC,WAAW;YAoCL,oBAAoB;YAsDpB,eAAe;IAsC7B,OAAO,CAAC,sBAAsB;IAqD9B,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,2BAA2B;IAqDnC,OAAO,CAAC,6BAA6B;IAyDrC,OAAO,CAAC,2BAA2B;IAiDnC,OAAO,CAAC,kBAAkB;CA6C3B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAqB,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA2F/E,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,CAAC,EACD,SAAS,GACT,OAAO,GACP,OAAO,GACP,iBAAiB,GACjB,mBAAmB,GACnB,KAAK,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CACrC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAA2B;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAiB;;IAOrB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuUhD,iBAAiB;YAYT,mBAAmB;IAmF3B,eAAe,CACnB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAsHtB,aAAa,CACjB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IA6F5B,OAAO,CAAC,sBAAsB;IAyF9B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,qBAAqB;IAiD7B,OAAO,CAAC,kBAAkB;IAsE1B,OAAO,CAAC,eAAe;IAgGvB,OAAO,CAAC,kBAAkB;IAwH1B,OAAO,CAAC,wBAAwB;IA4B1B,aAAa,CACjB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IA8HtB,wBAAwB,CAC5B,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAyEtB,qBAAqB,CACzB,cAAc,EAAE,GAAG,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IA2K5B,OAAO,CAAC,0BAA0B;YAqCpB,aAAa;YAiBb,oBAAoB;IA+GlC,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,yBAAyB;IA0BjC,OAAO,CAAC,gBAAgB;IAmWxB,OAAO,CAAC,kBAAkB;IAqK1B,OAAO,CAAC,mBAAmB;IAoG3B,OAAO,CAAC,uBAAuB;IA2I/B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,aAAa;YAwBP,oBAAoB;YAwBpB,sBAAsB;IAcpC,OAAO,CAAC,WAAW;YAoCL,oBAAoB;YAsDpB,eAAe;IAsC7B,OAAO,CAAC,sBAAsB;IAqD9B,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,2BAA2B;IAqDnC,OAAO,CAAC,6BAA6B;IAyDrC,OAAO,CAAC,2BAA2B;IAiDnC,OAAO,CAAC,kBAAkB;CA6C3B"}