mycontext-cli 0.1.0

package/README.md

@@ -0,0 +1,440 @@
+# MyContext CLI
+
+AI-powered component generation CLI for the MyContext platform. Transform your project ideas into production-ready UI components with a systematic, context-first approach.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install globally
+npm install -g mycontext-cli
+
+# Or use pnpm
+pnpm add -g mycontext-cli
+
+# Or install locally and link
+cd cli
+pnpm link --global
+```
+
+### Basic Usage
+
+```bash
+# Set up API keys for AI providers (production-ready security)
+mycontext auth setup
+
+# Initialize a new project
+mycontext init my-app --description "My awesome application"
+
+# Generate context files (PRD, user stories, technical specs)
+mycontext generate context
+
+# Validate your PRD
+mycontext validate prd
+
+# Generate TypeScript types
+mycontext generate types
+
+# Generate component list (AI-driven)
+mycontext generate components-list
+
+# Check project status
+mycontext status
+```
+
+## 📋 Commands
+
+### `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
+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
+```
+
+**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
+
+**Options:**
+
+- `--use-claude-code-sdk` - Use Claude Code SDK for generation
+- `--use-gemini` - Use Gemini for generation
+- `--use-xai` - Use XAI (Grok) for generation
+- `--temperature <number>` - Generation temperature (0-1)
+- `--max-tokens <number>` - Maximum tokens for generation
+
+### `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
+
+### Enterprise-Grade API Key Management
+
+MyContext CLI includes production-ready security features for managing AI provider API keys:
+
+```bash
+# Interactive setup for all providers
+mycontext auth setup
+
+# Set up specific providers
+mycontext auth setup --provider xai
+mycontext auth setup --provider openai
+mycontext auth setup --provider anthropic
+mycontext auth setup --provider google
+
+# List configured API keys
+mycontext auth list
+
+# Export keys for backup (password-protected)
+mycontext auth export --password "secure-password"
+
+# Import keys from backup
+mycontext auth import --file backup.json --password "secure-password"
+
+# Remove all API keys
+mycontext auth clear
+
+# Check authentication status
+mycontext auth:status
+
+# Remove authentication
+mycontext auth:logout
+```
+
+**Security Features:**
+- **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
+
+### Supported AI Providers
+
+| 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` |
+
+## 🏗️ 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)
+```
+
+## 🔄 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
+mycontext preview components
+```
+
+### Phase 4: Development Integration
+
+```bash
+mycontext list components
+mycontext status
+```
+
+## 🎯 Features
+
+### 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
+
+### 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
+- **Multi-Provider AI Support** - Choose between XAI, OpenAI, Anthropic, or Google
+- **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
+
+### 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
+
+### Project Management
+
+- Status tracking through development phases
+- File validation and health checks
+- Resource discovery and listing
+
+## 🔧 Configuration
+
+### Global Options
+
+- `--verbose` - Enable verbose logging
+- `--project <name>` - Specify project name
+- `--yes` - Skip all prompts (non-interactive mode)
+
+### 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"
+
+# Optional: Custom API endpoint
+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 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 status checking
+mycontext status --detailed --yes
+
+# Test authentication commands
+mycontext auth:status
+mycontext auth clear
+
+# Clean up
+cd ..
+rm -rf test-app
+```
+
+### Production Testing
+
+```bash
+# Test with real API keys
+mycontext auth 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 status --detailed
+
+# Test component generation with AI
+mycontext generate components --use-xai
+```
+
+## 📚 Documentation
+
+- [Platform Overview](../README.md)
+- [Architecture](../docs/architecture/overview.md)
+- [CLI Implementation](../docs/cli/implementation.md)
+- [XAI Integration](../docs/cli/xai-integration.md)
+
+## 🤝 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.
+
+---
+
+**MyContext CLI**: Where AI-generated code becomes a valuable, reusable asset rather than technical debt.
+
+## 🚀 Production Ready
+
+**Current Status: PRODUCTION READY** ✅
+
+- **✅ 28+ Passing Tests** - Comprehensive unit test coverage
+- **✅ Enterprise Security** - AES-256-CBC encrypted API key management  
+- **✅ Multi-Provider AI** - XAI, OpenAI, Anthropic, Google AI support
+- **✅ Robust Error Handling** - Structured error management with recovery
+- **✅ TypeScript Strict Mode** - Full type safety throughout
+- **✅ Production CLI** - All commands functional and tested
+- **✅ CI/CD Ready** - Non-interactive mode for automation
+
+The MyContext CLI is ready for production use with enterprise-grade security, comprehensive testing, and full TypeScript support. All core features are implemented and working.

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

@@ -0,0 +1,43 @@
+/**
+ * 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;
+    llmProvider: string;
+    expertise: 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 generateWithXAI;
+}
+//# sourceMappingURL=CodeGenSubAgent.d.ts.map

package/dist/cli/src/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,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;;IAad,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;IA+G9C,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,eAAe;CAkC9B"}