mycontext-cli 1.0.10 → 1.0.11

package/README.md

@@ -2,7 +2,7 @@
 
 **🧠 The AI That Actually Understands Your Project**
 
-AI-powered tool that generates production-ready React components by deeply understanding your project context.
+AI-powered tool that generates production-ready React components through an advanced agent-driven workflow that deeply understands your project context.
 
 ## 🚀 Quick Start
 
@@ -16,45 +16,74 @@ mycontext init . --description "Your project description"
 mycontext init my-app --description "Your project description"
 cd my-app
 
-# Generate context and components
-mycontext generate context        # → 01-prd.md, 01a-brief.md, 01b-requirements.md, 01c-flows.md
-mycontext generate types          # → types/ folder with complete type system
-mycontext generate brand          # → brand/ folder with CSS custom properties
-mycontext generate components-list # → 04-component-list.json
-mycontext generate-components all --local --with-tests
+# Agent-Driven Workflow (New!)
+mycontext generate-context-files --description "Your project description"  # → A/B/C/D context files
+mycontext compile-prd                                                  # → Comprehensive PRD
+mycontext build-app --interactive                                      # → Complete app with agents
 ```
 
-## Core Workflow
+## 🤖 Agent-Driven Workflow (New!)
 
-### 1. Context Generation
+MyContext uses 11 specialized AI agents working together in an orchestrated workflow:
+
+### 1. Context Generation (Agent: SpecAgent)
+
+```bash
+mycontext generate-context-files --description "Modern e-commerce platform"
+# Generates:
+# - A. Features (.mycontext/features.md)
+# - B. User Flows (.mycontext/user-flows.md)
+# - C. Edge Cases (.mycontext/edge-cases.md)
+# - D. Technical Specs (.mycontext/technical-specs.md)
+```
+
+### 2. PRD Compilation (Agent: PRDAgent)
 
 ```bash
-mycontext generate context      # PRD, user stories, technical specs
-mycontext generate types        # Complete TypeScript type system (5 files)
-mycontext generate brand        # Design system with CSS custom properties
-mycontext generate components-list  # Component planning
+mycontext compile-prd
+# Compiles A/B/C/D context files into:
+# - .mycontext/prd-compiled.md (comprehensive requirements)
 ```
 
-### 2. Core Component (Design Anchor)
+### 3. Complete Application Build (Agent Orchestration)
+
+```bash
+mycontext build-app --interactive --max-retries 3
+# Orchestrates multiple agents:
+# - TypesAgent: Generates TypeScript types
+# - BrandAgent: Creates design system
+# - CodeGenAgent: Generates components
+# - QAAgent: Quality assurance
+# - DocsAgent: Documentation
+```
+
+## 🎯 Core Commands
+
+### Context & Planning
 
 ```bash
-mycontext core generate         # Generate BrandComp (design anchor)
-mycontext core refine           # Refine as needed
-mycontext core ready            # Mark ready for component generation
+mycontext generate-context-files  # A/B/C/D context files (NEW)
+mycontext compile-prd            # Compile to comprehensive PRD (NEW)
+mycontext build-app              # Agent-orchestrated full build (NEW)
+mycontext generate types         # TypeScript type system
+mycontext generate brand-kit     # Complete brand system
 ```
 
-### 3. Component Generation
+### Component Generation
 
 ```bash
-mycontext generate-components all --local --with-tests  # Generate all components
-mycontext generate-components <group> --local          # Generate specific group
+mycontext generate-components all --local --with-tests  # All components
+mycontext generate-components <group> --local          # Specific group
+mycontext core generate                               # Design anchor component
 ```
 
-### 4. Preview & Iterate
+### Interactive & Management
 
 ```bash
-mycontext preview components    # Preview generated components
-mycontext list components --local  # List generated components
+mycontext enhance <component> --prompt "improvements"  # AI enhancement
+mycontext refine <component> --prompt "changes"        # AI refinement
+mycontext preview components                           # Live preview
+mycontext status --detailed                           # Project analysis
 ```
 
 ## Advanced Commands
@@ -66,42 +95,109 @@ mycontext predict dependencies      # Package suggestions
 mycontext predict patterns         # Architecture patterns
 mycontext predict issues           # Potential problems
 
-# Component management
-mycontext enhance <component> --prompt "improvements"
-mycontext refine <component> --prompt "changes"
-mycontext status --detailed        # Project analysis
+# Interactive workflow
+mycontext build-app --interactive   # Human-in-the-loop generation
+mycontext build-app --max-retries 5 # Configure retry limits
 
 # Model management
-mycontext model list              # Available models
-mycontext model test              # Test generation
+mycontext model list               # Available AI models
+mycontext model test               # Test AI provider connections
+mycontext setup                    # Local AI setup
 ```
 
-## 📦 What You Get
+## 📦 What You Get (Updated Structure)
+
+### Context Files (A/B/C/D Workflow)
+
+- **`.mycontext/features.md`** — Core product features and capabilities
+- **`.mycontext/user-flows.md`** — User journey maps and interaction patterns
+- **`.mycontext/edge-cases.md`** — Error scenarios and edge conditions
+- **`.mycontext/technical-specs.md`** — Architecture and technical requirements
+- **`.mycontext/prd-compiled.md`** — Comprehensive compiled PRD
+
+### Generated Assets
 
-- **`.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
+  - `index.ts` — Main type exports and interfaces
+  - `database.ts` — Database schema and data models
+  - `enums.ts` — Enum constants and type guards
+  - `ui.ts` — UI component prop types
+  - `utils.ts` — Utility types and helpers
+- **`.mycontext/brand-kit/`** — Complete design system
+  - `brand-kit.json` — Design tokens and theme configuration
+  - `globals.css` — CSS custom properties and variables
   - `colors.md` — Color palette documentation
-  - `typography.md` — Typography specifications
-- **`.mycontext/04-component-list.json`** — Component architecture plan
-- **`components/`** — Generated React components with shadcn/ui
+  - `typography.md` — Typography specifications and hierarchy
+- **`components/`** — Production-ready React components with shadcn/ui
+- **`lib/`** — Shared utilities and hooks
+- **`docs/`** — Auto-generated component documentation
 
-## 🤖 AI Provider Options
+## 🤖 Agent Architecture
+
+MyContext features a sophisticated multi-agent system with 11 specialized AI agents:
 
-MyContext supports multiple AI providers - you can use your own API keys or our managed service:
+### Core Agents
+
+- **SpecAgent**: Generates A/B/C/D context files from project descriptions
+- **PRDAgent**: Compiles context files into comprehensive PRDs
+- **TypesAgent**: Creates TypeScript type systems from features and flows
+- **BrandAgent**: Generates complete design systems and brand kits
+- **CodeGenAgent**: Produces production-ready React components
+- **QAAgent**: Performs quality assurance and validation
+- **DocsAgent**: Creates comprehensive documentation
+
+### Support Agents
+
+- **ArchitectAgent**: Provides architectural analysis and recommendations
+- **SecurityAgent**: Performs security analysis and best practices
+- **InteractiveAgent**: Handles human-in-the-loop interactions
+- **ProjectSetupAgent**: Manages project initialization and structure
+- **WorkflowAgent**: Orchestrates complete build processes
+
+### Agent Orchestration
+
+```bash
+mycontext build-app --interactive
+# Automatically coordinates all agents in the optimal sequence
+# Provides progress updates and handles failures gracefully
+# Supports human intervention when needed
+```
+
+## 💰 Business Model & Pricing
+
+### **Free Tier (Always Free)**
+
+- ✅ Unlimited basic generation with Qwen3 Coder
+- ✅ Core CLI features and commands
+- ✅ Community support and documentation
+- ✅ Local AI setup with Ollama
+
+### **Pro Tier ($9/month)**
+
+- ✅ Advanced AI generation with premium providers
+- ✅ Priority support and faster response times
+- ✅ Enhanced features and beta access
+- ✅ Team collaboration tools
+
+### **Enterprise Tier ($29/month)**
+
+- ✅ Custom AI model training and fine-tuning
+- ✅ White-label solutions and branding
+- ✅ On-premise deployment options
+- ✅ Dedicated enterprise support and SLAs
 
 ### **Bring Your Own Keys (BYOK)**
 
-Use your own API keys for full control and potentially lower costs:
+- ✅ Use your existing API provider accounts
+- ✅ Pay only for your actual API usage
+- ✅ Full control over costs and performance
+- ✅ No rate limits or usage tracking
+
+## 🤖 AI Provider Options
+
+MyContext supports multiple AI providers with intelligent fallback:
+
+### **Bring Your Own Keys (BYOK)**
 
 | Provider               | Environment Variable       | Best For                         | Cost           |
 | ---------------------- | -------------------------- | -------------------------------- | -------------- |
@@ -113,27 +209,17 @@ Use your own API keys for full control and potentially lower costs:
 
 ### **MyContext Managed Service**
 
-If you don't set any API keys, MyContext uses our hosted AI service:
-
 - **Rate Limited**: 10 requests per hour for free tier
 - **Paid Credits**: Purchase credits for unlimited usage
-- **Tracked Usage**: All generations are logged for quality improvement
-- **Fallback Support**: Automatic fallback to multiple providers
+- **Multi-Provider**: Automatic fallback across providers
+- **Usage Tracking**: Quality improvement and analytics
 
-### **Local AI (Free & Unlimited)**
+### **Provider Priority Chain**
 
-| Provider        | Model                   | Best For        | Setup              |
-| --------------- | ----------------------- | --------------- | ------------------ |
-| **Qwen3 Coder** | `qwen/qwen3-coder:free` | FREE generation | OpenRouter API key |
-
-### **Provider Priority Order**
-
-MyContext automatically tries providers in this order:
-
-1. **Your API Keys** (Qwen → GitHub → Claude → OpenAI → X.AI)
-2. **MyContext Managed Service** (if no keys set)
-3. **Qwen3 Coder** (FREE via OpenRouter)
-4. **Basic Templates** (fallback generation)
+1. **Your API Keys** (highest performance, your costs)
+2. **MyContext Managed Service** (balanced, our costs)
+3. **Qwen3 Coder FREE** (fallback, completely free)
+4. **Basic Templates** (ultimate fallback)
 
 ## Environment Setup
 
@@ -239,20 +325,139 @@ cp .mycontext/brand/globals.css ./src/app/globals.css
 
 ## Key Features
 
-- **Context-Aware Generation**: Components that match your existing codebase patterns
-- **Automatic Context Loading**: Commands automatically use PRD, types, and component lists when no description is provided
-- **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
-- **Free AI Support**: Qwen3 Coder integration for unlimited generation without API costs
-- **Design System**: Ready-to-use brand system with complete CSS custom properties
+### 🤖 **Agent-Driven Development**
+
+- **11 Specialized Agents**: Each agent handles specific development tasks
+- **Intelligent Orchestration**: Agents work together seamlessly
+- **Human-in-the-Loop**: Interactive prompts and confirmations
+- **Quality Gates**: Built-in validation and retry mechanisms
 
-## Support
+### 🎯 **Context-Aware Generation**
 
-- **GitHub Issues**: Report bugs and request features
-- **Documentation**: Full CLI reference and guides
-- **Community**: Share components and patterns
+- **Deep Project Understanding**: Analyzes existing codebase patterns
+- **A/B/C/D Context Files**: Comprehensive project specification
+- **Automatic Context Loading**: Commands use project context intelligently
+- **Consistent Results**: Same context produces consistent outputs
+
+### 🏗️ **Production-Ready Code**
+
+- **TypeScript First**: Complete type system with 5 specialized files
+- **Modern React**: Next.js 15, shadcn/ui, server components
+- **Accessibility**: WCAG compliant components
+- **Testing**: Comprehensive test suites included
+- **Documentation**: Auto-generated component docs
+
+### 🎨 **Complete Design System**
+
+- **Brand Kit Generation**: Colors, typography, components
+- **CSS Custom Properties**: Theme-able design tokens
+- **Component Library**: Consistent, reusable components
+- **Responsive Design**: Mobile-first approach
+
+### 🔧 **Developer Experience**
+
+- **Interactive CLI**: Guided workflows with progress indicators
+- **Multiple AI Providers**: Choose your preferred AI service
+- **Fallback Support**: Always works, even without API keys
+- **Extensible Architecture**: Plugin system for custom agents
+
+## 🛠️ Development & Contributing
+
+### Prerequisites
+
+- **Node.js**: 18+ (20+ recommended)
+- **pnpm**: Package manager
+- **Git**: Version control
+
+### Local Development
+
+```bash
+# Clone the monorepo
+git clone https://github.com/farajabien/mycontext.git
+cd mycontext
+
+# Install dependencies
+pnpm install
+
+# Build all packages
+pnpm build
+
+# Run CLI in development mode
+cd packages/cli
+pnpm dev --help
+```
+
+### Project Structure
+
+```
+mycontext-monorepo/
+├── packages/
+│   ├── cli/                    # Main CLI package
+│   │   ├── src/
+│   │   │   ├── commands/      # CLI command implementations
+│   │   │   ├── agents/        # AI agent implementations
+│   │   │   ├── utils/         # Utility functions
+│   │   │   └── config/        # Configuration files
+│   │   └── docs/              # CLI documentation
+│   └── ui/                     # Shared UI components
+├── apps/
+│   └── web/                    # Web platform (Next.js)
+└── docs/                       # Monorepo documentation
+```
+
+### Testing
+
+```bash
+# Run all tests
+pnpm test
+
+# Run CLI tests specifically
+cd packages/cli && pnpm test
+
+# Run with coverage
+pnpm test:coverage
+```
+
+### Contributing Guidelines
+
+1. **Fork** the repository
+2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
+3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
+4. **Push** to the branch (`git push origin feature/amazing-feature`)
+5. **Open** a Pull Request
+
+### Code Standards
+
+- **TypeScript**: Strict type checking enabled
+- **ESLint**: Code quality and consistency
+- **Prettier**: Automatic code formatting
+- **Conventional Commits**: Structured commit messages
+
+## 📞 Support & Community
+
+### Getting Help
+
+- **📧 Email**: hello@fbien.com
+- **🐛 Issues**: [GitHub Issues](https://github.com/farajabien/mycontext/issues)
+- **💬 Discussions**: [GitHub Discussions](https://github.com/farajabien/mycontext/discussions)
+- **📖 Documentation**: [docs.mycontext.fbien.com](https://docs.mycontext.fbien.com)
+
+### Community
+
+- **Share Components**: Contribute to the component library
+- **Report Bugs**: Help improve stability and reliability
+- **Feature Requests**: Suggest new capabilities and improvements
+- **Beta Testing**: Get early access to new features
+
+### Enterprise Support
+
+- **Custom Deployments**: On-premise and private cloud options
+- **White-label Solutions**: Custom branding and integration
+- **Dedicated Support**: Priority response and SLAs
+- **Training**: Team onboarding and best practices
 
 ---
 
-**Built for developers who want AI that understands their project context.**
+**🚀 Ready to transform your development workflow with AI-powered agents?**
+
+_Built with ❤️ by the MyContext team - Making AI work for developers, not against them._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "MyContext CLI - AI-powered component generation with shadcn/ui and Next.js 15 integration",
   "main": "dist/cli.js",
   "bin": {