mycontext-cli 0.2.11 → 0.2.12

package/README.md

@@ -1,613 +1,88 @@
-# MyContext CLI v0.2.2
+# MyContext CLI
 
-**AI-Powered Component Generation with shadcn/ui & Next.js 15** 🚀
+**AI-Powered Component Generation with shadcn/ui & Next.js** 🚀
 
-MyContext CLI transforms your project ideas into production-ready MyContext Components with systematic, MyContext Files-first approach. Experience the complete MyContext ecosystem in one powerful tool.
-
-> **Why MyContext CLI?** A lightweight, self-contained tool that generates unlimited React components locally with zero ongoing costs. Perfect for developers who want AI-powered development without subscription fees.
-
-## 🆓 Free During Beta
-
-**MyContext CLI is completely free during our beta period** - Because we're building the future of AI-powered development:
-
-- **🎯 Full Access** - All CLI features and capabilities
-- **🚀 Unlimited Generation** - Generate as many components as you need
-- **🔒 Local AI** - Zero API costs, complete privacy
-- **💡 Community Driven** - Help shape the future of MyContext
-
-_No costs, no usage limits, no hidden fees. You control your own AI infrastructure._
+MyContext CLI transforms your project ideas into production-ready components with a context-first approach. Generate PRD, types, brand, and a component list, then create standardized shadcn/ui components with optional tests.
 
 ## 🚀 Quick Start
 
-### Installation
+### Install
 
 ```bash
-# Install globally
 npm install -g mycontext-cli
-
-# Or use pnpm
+# or
 pnpm add -g mycontext-cli
-
-# Or use yarn
-yarn global add mycontext-cli
 ```
 
-### First-Time Setup
+### Enable GitHub Models (recommended)
 
 ```bash
-# Set up local AI environment (recommended - ZERO ongoing costs)
-mycontext setup
+# Fine-grained PAT with models:read
+echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
 
-# Or set up API keys for cloud-based generation (optional)
-mycontext auth setup
+# Optional: list available models
+mycontext model list
 ```
 
-### Basic Usage
+### Generate
 
 ```bash
-# Initialize a new project with Next.js and shadcn/ui
-mycontext init my-app --next --description "My awesome application"
+# 1) Init and enter project
+mycontext init my-app --description "Simple app"
+cd my-app
 
-# Generate MyContext Files (PRD, user stories, technical specs)
-mycontext generate context
-
-# Validate your PRD
-mycontext validate prd
-
-# Generate TypeScript types
+# 2) Context & types
+mycontext generate context --description "Simple app"
 mycontext generate types
 
-# Generate component list (AI-driven)
-mycontext generate components-list
-
-# Generate React components (using your local AI - FREE)
-mycontext generate-components all
+# 3) Plan components (alias supported: component-list)
+mycontext generate components-list --description "Simple app"
 
-# Enhance existing components
-mycontext enhance TodoApp.tsx --prompt "Make it more accessible"
-
-# Check project status
-mycontext status
+# 4) Generate components locally (installs shadcn primitives, adds tests)
+mycontext generate-components all --local --with-tests
 ```
 
-## 🎯 Why This Architecture Works
-
-### **Micro-Tool, Massive Value**
-
-- **Tiny CLI** (~10MB) - Easy to install and update
-- **Local AI Generation** - Zero API costs, unlimited usage
-- **User-Controlled Setup** - Each developer manages their own Ollama
-- **🆓 Completely Free** - Full access to all features during beta
+## 📦 Outputs
 
-### **Smart Dependency Management**
+- `context/prd.md` — PRD
+- `context/types.ts` — TypeScript types
+- `context/branding.md` — Brand guidelines
+- `context/component-list.json` — Component plan (merged by name when re-generated)
+- `components/` — Generated components
+  - Group directories: kebab-case (e.g., `user-interface/`)
+  - Component files: PascalCase (e.g., `GameBoard.tsx`)
 
-- **Ollama Runtime** - Users install locally (platform-native)
-- **Specialized Models** - We provide the MyContext-optimized AI model
-- **Health Checks** - CLI validates everything works
-- **Fallback Options** - Cloud APIs available if needed
-
-## 📋 Commands
-
-### `mycontext setup`
-
-Set up your local AI environment with Ollama and specialized models.
+## 🔧 Commands (highlights)
 
 ```bash
-# Interactive setup
-mycontext setup
-
-# Force local setup
-mycontext setup --local
-
-# Skip prompts
-mycontext setup --skip-prompts
-```
-
-**Features:**
-
-- **Automatic Ollama Installation** - Installs Ollama runtime for your platform
-- **Specialized Model Creation** - Creates MyContext-optimized AI model
-- **Health Checks** - Validates installation and model functionality
-- **Fallback Options** - Always provides cloud-based alternatives
-
-### `mycontext model`
-
-Manage your local AI models and monitor performance.
-
-```bash
-# Check model status
-mycontext model status
-
-# Test model generation
-mycontext model test
-
-# Update model
-mycontext model update
-
-# Reset model
-mycontext model reset
-
-# View statistics
-mycontext model stats
-```
-
-### `mycontext init <project-name>`
-
-Initialize a new MyContext project with proper directory structure.
-
-```bash
-mycontext init todo-app --description "A simple todo application"
-mycontext init ecommerce-app --description "Online store with shopping cart"
-```
-
-**Options:**
-
-- `--description <desc>` - Project description
-- `--force` - Force reinitialization
-- `--yes` - Skip all prompts (non-interactive mode)
-
-### `mycontext generate <type>`
-
-Generate various project assets using AI.
-
-```bash
-# Generate context files
-mycontext generate context
-
-# Generate TypeScript types
+# Generate (cloud-first GitHub Models, local fallback)
+mycontext generate context --description "Simple app"
 mycontext generate types
-
-# Generate branding guidelines
 mycontext generate brand
-
-# Generate component list (AI-driven analysis)
 mycontext generate components-list
 
-# Generate individual components
-mycontext generate components
-
-# Generate app structure
-mycontext generate app-structure
-```
-
-**Types:**
-
-- `context` - PRD, user stories, technical specifications
-- `types` - TypeScript type definitions
-- `brand` - Branding guidelines and design system
-- `components-list` - AI-driven component planning and grouping
-- `components` - Individual component generation
-- `app-structure` - Application structure and routing
-
-### Command Options
-
-- `--yes` - Skip all prompts and use defaults
-- `--verbose` - Show detailed output
-- `--debug` - Enable debug logging
-- `--temperature` - Set AI generation temperature (0.1-1.0)
-- `--group` - Specify component group for generation
-- `--prompt` - Custom enhancement prompt
-- `--output` - Output directory for generated files
-
-### `mycontext generate-components <target>`
-
-Generate React components using AI.
-
-```bash
-# Generate all components
-mycontext generate-components all
-
-# Generate specific component group
-mycontext generate-components group --group "authentication"
-
-# Generate single component
-mycontext generate-components component --name "UserProfile" --description "User profile display component"
-
-# Generate with custom temperature
-mycontext generate-components all --temperature 0.7
-```
-
-**Options:**
-
-- `--group <name>` - Generate specific component group
-- `--all` - Generate all components
-- `--output <path>` - Output directory
-- `--template <name>` - Use specific template
-- `--use-xai` - Use XAI (Grok) for generation
-- `--yes` - Skip prompts
-
-### `mycontext enhance <target>`
-
-Enhance existing React components with AI-powered improvements.
-
-```bash
-# Enhance specific component
-mycontext enhance Button.tsx --prompt "Add loading states"
-
-# Enhance all components
-mycontext enhance components --prompt "Improve accessibility"
-
-# Enhance with custom temperature
-mycontext enhance components --prompt "Add error handling" --temperature 0.8
-```
-
-**Options:**
-
-- `--prompt <text>` - Enhancement instructions
-- `--use-xai` - Use XAI (Grok) for enhancement
-- `--temperature <number>` - Generation temperature
-- `--max-tokens <number>` - Maximum tokens
-- `--credits <number>` - Credit limit
-- `--yes` - Skip prompts
-
-### `mycontext validate <target>`
-
-Validate PRD or other context files for quality and completeness.
-
-```bash
-mycontext validate prd
-mycontext validate prd --file path/to/prd.md
-```
-
-**Options:**
-
-- `--file <path>` - Specific file to validate
-- `--interactive` - Interactive validation mode
-
-### `mycontext list [type]`
-
-List projects, components, files, or all resources.
-
-```bash
-mycontext list all
-mycontext list projects
-mycontext list components
-mycontext list files
-```
-
-**Types:**
-
-- `all` - List everything (default)
-- `projects` - List all projects
-- `components` - List generated components
-- `files` - List context files
-
-**Options:**
-
-- `--format <format>` - Output format (table, json, simple)
-
-### `mycontext status`
-
-Check project status and progress through development phases.
-
-```bash
-mycontext status
-mycontext status --detailed
-mycontext status --check-health
-```
-
-**Options:**
-
-- `--detailed` - Show detailed status information
-- `--check-health` - Perform health checks
-
-### `mycontext auth`
-
-Authenticate with the MyContext platform for enhanced features.
-
-```bash
-mycontext auth
-mycontext auth --yes  # Non-interactive mode
-```
-
-## 🔐 Authentication & Security
-
-### Local AI Model Management
-
-MyContext CLI includes production-ready security features for managing your local AI environment:
-
-```bash
-# Set up local AI environment
-mycontext setup
-
-# Check model status
-mycontext model status
-
-# Test model generation
-mycontext model test
+# Accepts alias
+mycontext generate component-list
 
-# Update specialized model
-mycontext model update
+# Components
+mycontext generate-components all --local --with-tests
+mycontext generate-components authentication --local
 
-# View model statistics
-mycontext model stats
-```
-
-**Security Features:**
-
-- **Local AI Only** - Your code never leaves your machine
-- **Specialized Models** - MyContext-optimized AI models for React/Shadcn
-- **No API Keys Required** - Zero external dependencies
-- **Complete Privacy** - All processing happens locally
-- **Model Validation** - CLI validates model functionality and health
-
-### Specialized MyContext Models
-
-- **mycontext-react** - Specialized for React component generation
-- **mycontext-architect** - Specialized for project architecture and context
-- **Custom Models** - Create your own specialized models for specific use cases
-
-## 🤖 Local AI Models
-
-### Ollama Integration
-
-MyContext CLI includes seamless integration with Ollama for local AI generation:
-
-```bash
-# Check if Ollama is available
-mycontext model status
-
-# Test local model generation
-mycontext model test
-
-# Monitor model performance
-mycontext model stats
-```
-
-**Benefits:**
-
-- **Zero API Costs** - Generate unlimited components locally
-- **Instant Generation** - No network latency
-- **Complete Privacy** - Your code never leaves your machine
-- **Specialized Models** - Models trained specifically for MyContext patterns
-
-### Model Management
-
-```bash
-# Update base model
-mycontext model update
-
-# Reset to clean state
-mycontext model reset
-
-# View detailed statistics
-mycontext model stats --detailed
-```
-
-## 🏗️ Project Structure
-
-When you initialize a project, MyContext creates this structure:
-
-```
-my-app/
-├── .mycontext/
-│   └── config.json          # Project configuration
-├── context/
-│   ├── prd.md              # Product Requirements Document
-│   ├── 01_PRD.md           # Generated PRD (v2)
-│   ├── 02_user_stories.md  # User stories and workflows
-│   ├── 03_technical_specs.md # Technical specifications
-│   ├── types.ts            # TypeScript type definitions
-│   ├── branding.md         # Branding guidelines (generated)
-│   ├── component-list.json # Component planning (generated)
-│   └── component-list.md   # Component planning (markdown)
-└── components/
-    └── generated/          # Generated React components
-        ├── core-todo/      # Main app components
-        ├── forms-input/    # Form components
-        └── layout-ui/      # Layout components
-```
-
-## 🔄 Development Workflow
-
-MyContext follows a 4-phase development process:
-
-### Phase 1: Context & Architecture
-
-```bash
-mycontext init my-app
-mycontext generate context
-mycontext validate prd
-mycontext generate types
-```
-
-### Phase 2: Brand & Design System
-
-```bash
-mycontext generate brand
-mycontext preview brand
-mycontext generate components-list
-```
-
-### Phase 3: Component Generation
-
-```bash
-mycontext generate-components all
+# Preview
 mycontext preview components
 ```
 
-### Phase 4: Development Integration
-
-```bash
-mycontext list components
-mycontext status
-mycontext enhance components
-```
-
-## 🎯 Features
-
-### Enterprise-Grade Security & Authentication
-
-- **Production-Ready API Key Management** - AES-256-CBC encryption with PBKDF2
-- **Secure Local Storage** - Encrypted storage in `~/.mycontext/api-keys.json`
-- **Password-Protected Backup/Restore** - Secure key export/import
-- **Environment Variable Integration** - Seamless CI/CD integration
-
-### Local AI Generation
-
-- **Ollama Integration** - Seamless local AI model management
-- **Specialized Models** - MyContext-optimized AI models
-- **Zero API Costs** - Generate unlimited components locally
-- **Complete Privacy** - Your code never leaves your machine
-- **Performance Monitoring** - Track model performance and usage
-
-### Business Model Benefits
-
-- **🆓 Completely Free** - All features available at no cost during beta
-- **Community Driven** - Help shape the future of MyContext
-- **Unlimited Usage** - No API rate limits or usage quotas
-- **User Control** - Each developer manages their own AI infrastructure
-- **Enterprise Ready** - Teams can run their own Ollama instances
-
-### Context-First Development
-
-- Start with deep understanding before generating code
-- User story mapping for actionable components
-- Building blocks that work across projects
-
-### AI-Powered Generation
-
-- **Production-Ready CLI** - Fully functional command-line interface
-- **Specialized Local AI Models** - MyContext-optimized models for specific tasks
-- **Local AI Generation** - Ollama integration for cost-free generation
-- **Dynamic app analysis** - Automatically detects app type and generates appropriate components
-- **Brand-compliant component generation** - Components follow your design system
-- **Type-safe TypeScript interfaces** - Full type safety throughout
-- **Robust Error Handling** - Comprehensive error management and recovery
-- **Component Enhancement** - AI-powered refinement of existing components
-
-### Dynamic Component Generation
-
-MyContext uses intelligent analysis to generate app-specific components:
-
-**Supported App Types:**
-
-- **Ecommerce**: ProductList, ShoppingCart, CheckoutForm, OrderHistory, UserProfile
-- **Dashboard**: DashboardOverview, DataGrid, AnalyticsCharts, MetricCards
-- **Productivity**: TodoList, TaskDetail, ProjectManager, CalendarView
-- **Weather**: WeatherForecast, WeatherHistory, LocationPicker
-- **Finance**: TransactionList, BudgetOverview, ExpenseTracker
-- **Social**: UserFeed, ProfileCard, CommentThread, SocialActions
-
-**Example:**
-
-```bash
-# Ecommerce app
-mycontext init ecommerce-app --description "Online store with shopping cart"
-mycontext generate components-list
-# Generates: ProductList, ShoppingCart, CheckoutForm, OrderHistory, UserProfile
-
-# Dashboard app
-mycontext init dashboard-app --description "Analytics dashboard"
-mycontext generate components-list
-# Generates: DashboardOverview, DataGrid, AnalyticsCharts, MetricCards
-```
-
-### Production-Ready Features
-
-- **Comprehensive Test Suite** - 28+ passing unit tests
-- **TypeScript Strict Mode** - Full type safety and validation
-- **Enhanced Error Handling** - Structured error types with recovery suggestions
-- **Interactive CLI Experience** - Modern prompts with progress feedback
-- **Non-Interactive Mode** - Full automation support for CI/CD
-- **Local AI Models** - Ollama integration for cost-free generation
-
-### Project Management
-
-- Status tracking through development phases
-- File validation and health checks
-- Resource discovery and listing
-- Component enhancement and iteration
-
-## 🔧 Configuration
-
-### Global Options
-
-- `--verbose` - Enable verbose logging
-- `--project <name>` - Specify project name
-- `--yes` - Skip all prompts (non-interactive mode)
-
-### Environment Variables
-
-```bash
-# Ollama configuration
-export OLLAMA_BASE_URL="http://localhost:11434"
-
-# Optional: Custom MyContext API endpoint (for enterprise features)
-export MYCONTEXT_API_ENDPOINT="https://custom-endpoint.com"
-```
-
-## 🧪 Testing
-
-```bash
-# Test local setup
-mycontext setup --yes
-mycontext model status
-mycontext model test
-
-# Test project initialization
-mycontext init test-app --description "Test application" --yes
-
-# Test context generation
-cd test-app
-mycontext generate context --yes
-
-# Test validation
-mycontext validate prd --yes
-
-# Test component list generation
-mycontext generate components-list --yes
-
-# Test component generation (requires Ollama)
-mycontext generate-components all --yes
-
-# Test component enhancement
-mycontext enhance components --prompt "Add loading states" --yes
-
-# Test status checking
-mycontext status --detailed --yes
-
-# Clean up
-cd ..
-rm -rf test-app
-```
-
-### Production Testing
-
-```bash
-# Test with Ollama installed
-mycontext setup
-mycontext init production-test --description "Production testing app"
-cd production-test
-
-# Test full workflow
-mycontext generate context
-mycontext validate prd
-mycontext generate types
-mycontext generate components-list
-mycontext generate-components all
-mycontext status --detailed
-
-# Test component enhancement
-mycontext enhance components --prompt "Improve accessibility"
-```
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests if applicable
-5. Submit a pull request
-
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE) for details.
-
----
+### Flags & behavior
 
-**MyContext CLI**: The micro-tool that does heavy lifting. Where AI-generated code becomes a valuable, reusable asset rather than technical debt.
+- `--description`, `--context-file`: supply input context
+- `--model`, `--models`/`--use-models`/`--model-candidates`: model override/fallbacks
+- `--local`: generate components without auth; remote storage is skipped silently
+- `--with-tests`: scaffold Jest + RTL and generate per-component tests
+- Component list saves to `context/component-list.json` and merges by group/component name
+- Neutral fallback: if AI times out for component-list, a valid skeleton is written so you can edit and re-run
 
-**🆓 Completely Free**: Full access to all features during beta while we perfect the local AI experience.
+## 🛠 Notes
 
-**Local AI Generation**: Generate unlimited components with zero API costs and complete privacy.
+- Set `MYCONTEXT_GITHUB_TOKEN` (models:read) in `.mycontext/.env` for GitHub Models.
+- Standardized naming ensures clean imports and paths.
+- For advanced envs, see the repo `env.example`.

package/dist/agents/implementations/QASubAgent.d.ts

@@ -11,7 +11,7 @@ export declare class QASubAgent implements SubAgent<QAValidationInput, QAValidat
     personality: string;
     llmProvider: string;
     expertise: string[];
-    private ollamaClient;
+    private ai;
     constructor();
     run(input: QAValidationInput): Promise<QAValidationOutput>;
     validate(input: QAValidationInput): Promise<boolean>;

package/dist/agents/implementations/QASubAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QASubAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/QASubAgent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,UACX,YAAW,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAE1D,IAAI,SAAgB;IACpB,WAAW,SACoE;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,YAAY,CAAe;;IAc7B,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoC1D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,SAAS,IAAI,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;QACnD,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;YASY,yBAAyB;YAuCzB,uBAAuB;YAsCvB,kBAAkB;YA6BlB,gBAAgB;YAgChB,aAAa;IA8B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACH,OAAO,CAAC,eAAe;CA+CxB"}
+{"version":3,"file":"QASubAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/QASubAgent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,UACX,YAAW,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAE1D,IAAI,SAAgB;IACpB,WAAW,SACoE;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,CAAiB;;IAcrB,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyB1D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,SAAS,IAAI,OAAO,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;QACnD,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;YASY,yBAAyB;YAuCzB,uBAAuB;YAsCvB,kBAAkB;YA6BlB,gBAAgB;YAgChB,aAAa;IA8B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA8CrB;;OAEG;IACH,OAAO,CAAC,eAAe;CA+CxB"}