mycontext-cli 0.1.2 → 0.2.0

package/README.md

@@ -1,7 +1,21 @@
 # MyContext CLI
 
+**The Micro-Tool That Does Heavy Lifting** 🚀
+
 AI-powered component generation CLI for the MyContext platform. Transform your project ideas into production-ready UI components with a systematic, context-first approach.
 
+> **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.
+
+## 💰 Pricing Model
+
+**Sustainable, Affordable Plans** - Because we're a micro-tool with zero ongoing costs:
+
+- **$1/month** - Basic CLI access
+- **$5/month** - Advanced features + priority support
+- **$10/month** - Enterprise features + team collaboration
+
+_No API costs, no usage limits, no hidden fees. You control your own AI infrastructure._
+
 ## 🚀 Quick Start
 
 ### Installation
@@ -17,12 +31,19 @@ pnpm add -g mycontext-cli
 yarn global add mycontext-cli
 ```
 
-### Basic Usage
+### First-Time Setup
 
 ```bash
-# Set up API keys for AI providers (production-ready security)
+# Set up local AI environment (recommended - ZERO ongoing costs)
+mycontext setup
+
+# Or set up API keys for cloud-based generation (optional)
 mycontext auth setup
+```
+
+### Basic Usage
 
+```bash
 # Initialize a new project
 mycontext init my-app --description "My awesome application"
 
@@ -38,12 +59,77 @@ mycontext generate types
 # Generate component list (AI-driven)
 mycontext generate components-list
 
+# Generate React components (using your local AI - FREE)
+mycontext generate-components all
+
+# Enhance existing components
+mycontext enhance TodoApp.tsx --prompt "Make it more accessible"
+
 # Check project status
 mycontext status
 ```
 
+## 🎯 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
+- **Sustainable Pricing** - No ongoing infrastructure costs to pass on
+
+### **Smart Dependency Management**
+
+- **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.
+
+```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.
@@ -78,6 +164,9 @@ mycontext generate components-list
 
 # Generate individual components
 mycontext generate components
+
+# Generate app structure
+mycontext generate app-structure
 ```
 
 **Types:**
@@ -89,13 +178,66 @@ mycontext generate components
 - `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:**
 
-- `--use-claude-code-sdk` - Use Claude Code SDK for generation
-- `--use-gemini` - Use Gemini for generation
+- `--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
-- `--temperature <number>` - Generation temperature (0-1)
-- `--max-tokens <number>` - Maximum tokens 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>`
 
@@ -159,56 +301,77 @@ mycontext auth --yes  # Non-interactive mode
 
 ## 🔐 Authentication & Security
 
-### Enterprise-Grade API Key Management
+### Local AI Model Management
 
-MyContext CLI includes production-ready security features for managing AI provider API keys:
+MyContext CLI includes production-ready security features for managing your local AI environment:
 
 ```bash
-# Interactive setup for all providers
-mycontext auth setup
+# Set up local AI environment
+mycontext setup
+
+# Check model status
+mycontext model status
+
+# Test model generation
+mycontext model test
+
+# Update specialized model
+mycontext model update
+
+# View model statistics
+mycontext model stats
+```
 
-# Set up specific providers
-mycontext auth setup --provider xai
-mycontext auth setup --provider openai
-mycontext auth setup --provider anthropic
-mycontext auth setup --provider google
+**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
 
-# List configured API keys
-mycontext auth list
+- **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
 
-# Export keys for backup (password-protected)
-mycontext auth export --password "secure-password"
+## 🤖 Local AI Models
 
-# Import keys from backup
-mycontext auth import --file backup.json --password "secure-password"
+### Ollama Integration
 
-# Remove all API keys
-mycontext auth clear
+MyContext CLI includes seamless integration with Ollama for local AI generation:
 
-# Check authentication status
-mycontext auth:status
+```bash
+# Check if Ollama is available
+mycontext model status
+
+# Test local model generation
+mycontext model test
 
-# Remove authentication
-mycontext auth:logout
+# Monitor model performance
+mycontext model stats
 ```
 
-**Security Features:**
+**Benefits:**
 
-- **AES-256-CBC Encryption** with PBKDF2 key derivation
-- **Local Storage** in `~/.mycontext/api-keys.json`
-- **Environment Variable Integration** - Automatically detects `XAI_API_KEY`, `OPENAI_API_KEY`, etc.
-- **Password-Protected Backup/Restore**
-- **Key Validation** - Tests API keys with provider endpoints
-- **Rate Limiting Information** - Tracks usage and limits per provider
+- **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
 
-### Supported AI Providers
+### Model Management
 
-| Provider       | Key Format | Environment Variable |
-| -------------- | ---------- | -------------------- |
-| **XAI (Grok)** | `xai-*`    | `XAI_API_KEY`        |
-| **OpenAI**     | `sk-*`     | `OPENAI_API_KEY`     |
-| **Anthropic**  | `sk-ant-*` | `ANTHROPIC_API_KEY`  |
-| **Google AI**  | Various    | `GOOGLE_AI_API_KEY`  |
+```bash
+# Update base model
+mycontext model update
+
+# Reset to clean state
+mycontext model reset
+
+# View detailed statistics
+mycontext model stats --detailed
+```
 
 ## 🏗️ Project Structure
 
@@ -218,15 +381,20 @@ 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)
+├── 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
@@ -253,7 +421,7 @@ mycontext generate components-list
 ### Phase 3: Component Generation
 
 ```bash
-mycontext generate components
+mycontext generate-components all
 mycontext preview components
 ```
 
@@ -262,6 +430,7 @@ mycontext preview components
 ```bash
 mycontext list components
 mycontext status
+mycontext enhance components
 ```
 
 ## 🎯 Features
@@ -269,11 +438,26 @@ mycontext status
 ### Enterprise-Grade Security & Authentication
 
 - **Production-Ready API Key Management** - AES-256-CBC encryption with PBKDF2
-- **Multi-Provider Support** - XAI, OpenAI, Anthropic, Google AI
 - **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
+
+- **Sustainable Pricing** - $1/$5/$10 plans because we have zero ongoing costs
+- **Unlimited Usage** - No API rate limits or usage quotas
+- **User Control** - Each developer manages their own AI infrastructure
+- **Scalable Growth** - More users = more revenue, not more costs
+- **Enterprise Ready** - Teams can run their own Ollama instances
+
 ### Context-First Development
 
 - Start with deep understanding before generating code
@@ -283,11 +467,13 @@ mycontext status
 ### AI-Powered Generation
 
 - **Production-Ready CLI** - Fully functional command-line interface
-- **Multi-Provider AI Support** - Choose between XAI, OpenAI, Anthropic, or Google
+- **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
 
@@ -323,12 +509,14 @@ mycontext generate components-list
 - **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
 
@@ -341,22 +529,20 @@ mycontext generate components-list
 ### Environment Variables
 
 ```bash
-# AI Provider API Keys (automatically detected)
-export XAI_API_KEY="your-xai-key"
-export OPENAI_API_KEY="your-openai-key"
-export ANTHROPIC_API_KEY="your-anthropic-key"
-export GOOGLE_AI_API_KEY="your-google-key"
+# Ollama configuration
+export OLLAMA_BASE_URL="http://localhost:11434"
 
-# Optional: Custom API endpoint
+# Optional: Custom MyContext API endpoint (for enterprise features)
 export MYCONTEXT_API_ENDPOINT="https://custom-endpoint.com"
 ```
 
 ## 🧪 Testing
 
 ```bash
-# Test API key setup
-mycontext auth setup --provider xai --key "test-key"
-mycontext auth list
+# Test local setup
+mycontext setup --yes
+mycontext model status
+mycontext model test
 
 # Test project initialization
 mycontext init test-app --description "Test application" --yes
@@ -371,13 +557,15 @@ 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
 
-# Test authentication commands
-mycontext auth:status
-mycontext auth clear
-
 # Clean up
 cd ..
 rm -rf test-app
@@ -386,8 +574,8 @@ rm -rf test-app
 ### Production Testing
 
 ```bash
-# Test with real API keys
-mycontext auth setup
+# Test with Ollama installed
+mycontext setup
 mycontext init production-test --description "Production testing app"
 cd production-test
 
@@ -396,10 +584,11 @@ mycontext generate context
 mycontext validate prd
 mycontext generate types
 mycontext generate components-list
+mycontext generate-components all
 mycontext status --detailed
 
-# Test component generation with AI
-mycontext generate components --use-xai
+# Test component enhancement
+mycontext enhance components --prompt "Improve accessibility"
 ```
 
 ## 🤝 Contributing
@@ -416,4 +605,8 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
-**MyContext CLI**: Where AI-generated code becomes a valuable, reusable asset rather than technical debt.
+**MyContext CLI**: The micro-tool that does heavy lifting. Where AI-generated code becomes a valuable, reusable asset rather than technical debt.
+
+**Sustainable Pricing Model**: $1/$5/$10 plans because we have zero ongoing costs. You control your own AI infrastructure.
+
+**Local AI Generation**: Generate unlimited components with zero API costs and complete privacy.

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

@@ -0,0 +1,48 @@
+/**
+ * CodeGenSubAgent Implementation
+ *
+ * Specialized sub-agent for generating production-ready React components and TypeScript code.
+ * Uses Claude Code for optimal code generation capabilities.
+ * Enhanced with shadcn/ui primitives and modern React patterns for Next.js 14+.
+ */
+import { SubAgent, ComponentGenerationInput, ComponentGenerationOutput } from "../interfaces/SubAgent";
+export declare class CodeGenSubAgent implements SubAgent<ComponentGenerationInput, ComponentGenerationOutput> {
+    name: string;
+    description: string;
+    personality: string;
+    traits: string[];
+    llmProvider: string;
+    expertise: string[];
+    modelName: string;
+    temperature: number;
+    maxTokens: number;
+    systemPrompt: string;
+    constructor();
+    run(input: ComponentGenerationInput): Promise<ComponentGenerationOutput>;
+    validate(input: ComponentGenerationInput): Promise<boolean>;
+    getStatus(): Promise<{
+        name: string;
+        status: "idle" | "running" | "completed" | "error";
+        lastRun?: Date;
+        executionTime?: number;
+        errorCount: number;
+        successCount: number;
+    }>;
+    private generateProductionReadyComponent;
+    private getReactImportsForType;
+    private getShadcnImportsForType;
+    private getCustomImportsForType;
+    private generateTypeDefinitions;
+    private generateDetailedPropsForType;
+    private generateExampleProps;
+    private generateEnhancedPropsDestructuring;
+    private generateProductionComponentLogic;
+    private generateAccessibleComponentJSX;
+    private generateProductionActionFunctions;
+    private extractDependencies;
+    private extractShadcnComponents;
+    private calculateQualityScore;
+    private generateComponentName;
+    private generateWithOllama;
+}
+//# sourceMappingURL=CodeGenSubAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeGenSubAgent.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/CodeGenSubAgent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,QAAQ,EACR,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAuChC,qBAAa,eACX,YAAW,QAAQ,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;IAExE,IAAI,SAAqB;IACzB,WAAW,SACkG;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;;IAkBf,GAAG,CACP,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC;IAuC/B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB3D,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,gCAAgC;IAS9C,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,uBAAuB;IAoI/B,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,uBAAuB;IA2E/B,OAAO,CAAC,4BAA4B;IAmIpC,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,kCAAkC;IA4E1C,OAAO,CAAC,gCAAgC;IAwIxC,OAAO,CAAC,8BAA8B;IAyetC,OAAO,CAAC,iCAAiC;IA0HzC,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,qBAAqB;YASf,kBAAkB;CA0CjC"}