mycontext-cli 1.0.77 → 1.0.78

package/README.md

@@ -4,419 +4,155 @@
 
 AI-powered tool that generates production-ready React components through an advanced agent-driven workflow that deeply understands your project context.
 
-## 🚀 Quick Start
+## Installation
 
 ```bash
-# Install CLI
-npm install -g mycontext-cli
-
-# Initialize project (supports current directory with ".")
-mycontext init . --description "Your project description"
-# OR
-mycontext init my-app --description "Your project description"
-cd my-app
-
-# Unified Context Generation
-mycontext generate context --full --description "Your project description"  # → PRD + A/B/C/D files
-mycontext compile-prd                                                      # → Comprehensive PRD
-mycontext build-app --interactive                                          # → Complete app with agents
+npm install -g @mycontext/cli
+# or
+pnpm add -g @mycontext/cli
+# or
+yarn global add @mycontext/cli
 ```
 
-## 🤖 Agent-Driven Workflow (New!)
-
-MyContext uses 11 specialized AI agents working together in an orchestrated workflow:
-
-### 1. Context Generation (Agent: SpecAgent)
+## Quick Start
 
 ```bash
-# Generate only PRD (default)
-mycontext generate context --description "Modern e-commerce platform"
-
-# Generate full context (PRD + A/B/C/D files)
-mycontext generate context --full --description "Modern e-commerce platform"
+# Initialize a new project
+mycontext init my-project
 
-# Generate only A/B/C/D files (requires existing PRD)
-mycontext generate context --files-only
-
-# Generates:
-# - PRD (.mycontext/01-prd.md)
-# - A. Features (.mycontext/01a-features.md)
-# - B. User Flows (.mycontext/01b-user-flows.md)
-# - C. Edge Cases (.mycontext/01c-edge-cases.md)
-# - D. Technical Specs (.mycontext/01d-technical-specs.md)
-```
+# Set up AI provider (Qwen3 Coder - FREE!)
+echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
 
-### 2. PRD Compilation (Agent: PRDAgent)
+# Generate context files
+mycontext generate context --full --description 'Modern todo app'
 
-```bash
+# Compile PRD
 mycontext compile-prd
-# Compiles A/B/C/D context files into:
-# - .mycontext/prd-compiled.md (comprehensive requirements)
-```
-
-### 3. Database Setup (Default: InstantDB)
-
-```bash
-# Set up InstantDB with MCP integration (recommended)
-mycontext setup-instantdb
 
-# Set up MCP with other providers
-mycontext setup-mcp --provider github --token YOUR_TOKEN
-mycontext setup-mcp --provider custom --server https://your-server.com
+# Generate components
+mycontext generate-components all --with-tests
 ```
 
-### 4. Complete Application Build (Agent Orchestration)
+## Features
 
-```bash
-mycontext build-app --interactive --max-retries 3
-# Orchestrates multiple agents:
-# - TypesAgent: Generates TypeScript types
-# - BrandAgent: Creates design system
-# - CodeGenAgent: Generates components with database integration
-# - QAAgent: Quality assurance
-# - DocsAgent: Documentation
-# - DatabaseAgent: Real-time data operations
-```
+- **🤖 AI-Powered Generation**: Uses advanced AI models to understand your project context
+- **⚡ Fast Setup**: Initialize projects in seconds with Next.js, TypeScript, and Tailwind CSS
+- **🎨 Component Generation**: Create production-ready React components with Shadcn UI
+- **📋 Context-Aware**: Generates PRDs, types, and branding based on your project
+- **🔧 Developer-Friendly**: Built-in validation, testing, and preview capabilities
+- **🆓 Free Tier**: Use Qwen3 Coder model for free (no API key required for basic usage)
 
-## 🎯 Core Commands
+## Commands
 
-### Context & Planning
+### Project Setup
 
 ```bash
-mycontext generate context --full  # PRD + A/B/C/D context files (UNIFIED)
-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
+mycontext init <project-name>          # Initialize new project
+mycontext setup                        # Configure AI providers
+mycontext analyze                      # Analyze existing project
 ```
 
-### Database & MCP Setup
+### Context Generation
 
 ```bash
-mycontext setup-instantdb       # Set up InstantDB with MCP (DEFAULT)
-mycontext setup-mcp            # Set up MCP with various providers
-mycontext setup-database       # Set up other database options
+mycontext generate context             # Generate PRD and context files
+mycontext generate types               # Generate TypeScript types
+mycontext generate brand               # Generate branding guidelines
+mycontext generate components-list     # Generate component list
+mycontext compile-prd                  # Compile PRD from context files
 ```
 
-### Component Generation
+### Component Development
 
 ```bash
-mycontext generate-components all --local --with-tests  # All components (with DB integration)
-mycontext generate-components <group> --local          # Specific group
-mycontext core generate                               # Design anchor component
+mycontext generate-components <target> # Generate React components
+mycontext enhance <component>          # Enhance existing components
+mycontext refine <component>           # Refine components with AI
+mycontext preview <type>               # Preview components or brand
 ```
 
-### Interactive & Management
+### Project Management
 
 ```bash
-mycontext enhance <component> --prompt "improvements"  # AI enhancement
-mycontext refine <component> --prompt "changes"        # AI refinement
-mycontext preview components                           # Live preview
-mycontext status --detailed                           # Project analysis
+mycontext validate <target>            # Validate PRD or files
+mycontext status                       # Check project status
+mycontext list [type]                  # List components, projects, or files
+mycontext promote                      # Promote components to production
 ```
 
-## Advanced Commands
-
-```bash
-# AI predictions and insights
-mycontext predict next              # Next development steps
-mycontext predict dependencies      # Package suggestions
-mycontext predict patterns         # Architecture patterns
-mycontext predict issues           # Potential problems
-
-# 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 AI models
-mycontext model test               # Test AI provider connections
-mycontext setup                    # Local AI setup
-```
+## Configuration
 
-## 📦 What You Get (Updated Structure)
+### AI Providers
 
-### Context Files (A/B/C/D Workflow)
+MyContext supports multiple AI providers:
 
-- **`.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
+1. **Qwen3 Coder (Recommended - FREE)**
 
-### Generated Assets
+   ```bash
+   echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
+   ```
 
-- **`.mycontext/types/`** — Complete TypeScript type system (5 files)
-  - `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 and hierarchy
-- **`components/`** — Production-ready React components with shadcn/ui
-- **`lib/`** — Shared utilities and hooks
-- **`docs/`** — Auto-generated component documentation
+2. **GitHub Models (Self-hosted)**
 
-## 🤖 Agent Architecture
+   ```bash
+   echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
+   ```
 
-MyContext features a sophisticated multi-agent system with 11 specialized AI agents:
+3. **OpenAI (Paid)**
+   ```bash
+   echo 'OPENAI_API_KEY=sk-xxx' > .mycontext/.env
+   ```
 
-### Core Agents
+### Project Structure
 
-- **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
 ```
-
-## 🚀 **Beta Release - BYOK Model**
-
-**We're currently in beta!** All usage is **Bring Your Own Key (BYOK)** - no pricing, no subscriptions, just use your existing API keys.
-
-### **What This Means**
-
-- ✅ **No Cost**: Use your own API keys, pay only what you normally pay
-- ✅ **Full Control**: Complete control over costs and performance
-- ✅ **No Limits**: No rate limits or usage tracking from us
-- ✅ **Recommended Providers**: Claude or GPT for best results
-
-## 🤖 AI Provider Options
-
-MyContext supports multiple AI providers with intelligent fallback:
-
-### **Bring Your Own Keys (BYOK)**
-
-| Provider               | Environment Variable       | Best For                         | Cost           |
-| ---------------------- | -------------------------- | -------------------------------- | -------------- |
-| **X.AI (Grok)**        | `MYCONTEXT_XAI_API_KEY`    | Fast, high-quality generation    | Your API costs |
-| **Qwen3 Coder**        | `MYCONTEXT_QWEN_API_KEY`   | Free code generation, OpenRouter | **FREE**       |
-| **GitHub Models**      | `MYCONTEXT_GITHUB_TOKEN`   | Fast, high-quality generation    | Your API costs |
-| **Claude (Anthropic)** | `MYCONTEXT_CLAUDE_API_KEY` | Complex reasoning, detailed PRDs | Your API costs |
-| **OpenAI**             | `MYCONTEXT_OPENAI_API_KEY` | Versatile generation, refinement | Your API costs |
-
-### **Provider Priority Chain**
-
-1. **Your API Keys** (recommended - Claude or GPT)
-2. **Qwen3 Coder FREE** (fallback via OpenRouter)
-3. **Basic Templates** (ultimate fallback)
-
-## Environment Setup
-
-### Option 1: Bring Your Own API Keys (Recommended)
-
-Set up your preferred AI provider for best performance and cost control:
-
-```bash
-# Qwen3 Coder (FREE via OpenRouter - Recommended!)
-echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
-
-# Or GitHub Models (Fast, high-quality)
-echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
-
-# Or Claude (Best for complex reasoning)
-echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
-
-# Or OpenAI (Most versatile)
-echo 'MYCONTEXT_OPENAI_API_KEY=sk-xxx' > .mycontext/.env
-
-# Or X.AI (Creative tasks)
-echo 'MYCONTEXT_GROK_TOKEN=xai-xxx' > .mycontext/.env
+my-project/
+├── .mycontext/           # MyContext configuration
+│   ├── 01-prd.md        # Product Requirements Document
+│   ├── 02-types.ts      # TypeScript types
+│   ├── 03-branding.md   # Branding guidelines
+│   └── .env             # Environment variables
+├── components/           # Generated components
+└── package.json
 ```
 
-### Option 2: Local AI Setup (Free & Unlimited)
-
-```bash
-# Get Qwen3 Coder API key (FREE)
-# Visit https://openrouter.ai/ and create an account
-# Get your API key and add it to .mycontext/.env
+## Examples
 
-# Set up MyContext local AI
-mycontext setup
-
-# Verify setup
-mycontext model status
-```
-
-## 🧠 **Automatic Context Loading**
-
-MyContext commands automatically load context from your project files when no description is provided:
-
-```bash
-# These commands automatically use context files
-mycontext generate types          # Uses PRD and existing context
-mycontext predict next           # Uses project context for predictions
-mycontext enhance Button.tsx     # Uses brand and types for enhancements
-mycontext refine LoginForm.tsx   # Uses project context for refinements
-```
-
-### Context File Priority
-
-When no description is provided, commands load context in this order:
-
-1. **PRD** (`.mycontext/01-prd.md`) - Product requirements and project overview
-2. **Types** (`.mycontext/02-types.ts`) - TypeScript type definitions
-3. **User Stories** (`.mycontext/02_user_stories.md`) - User requirements
-4. **Technical Specs** (`.mycontext/03_technical_specs.md`) - Technical details
-5. **Component List** (`.mycontext/04-component-list.json`) - Component architecture
-6. **Brand** (`.mycontext/03-branding.md` or `brand/globals.css`) - Design system
-
-### Context Loading Benefits
-
-- **No Repetition**: Don't re-enter project details for every command
-- **Consistency**: All commands use the same project context
-- **Efficiency**: Faster workflow with automatic context detection
-- **Accuracy**: Better results with full project understanding
-
-## 🎯 **Integration Guide**
-
-### Using Generated Types
+### Create a Todo App
 
 ```bash
-# Move the types folder to your lib directory
-mv .mycontext/types ./lib/
-
-# Import types in your components
-import type { User, ApiResponse } from "@/lib/types";
-import { USER_ROLES } from "@/lib/types/enums";
+mycontext init todo-app --description "A modern todo application with dark mode"
+cd todo-app
+mycontext generate context --full
+mycontext generate-components all --with-tests
 ```
 
-### Using Generated Brand System
+### Work with Existing Project
 
 ```bash
-# Copy the CSS to your globals.css
-cp .mycontext/brand/globals.css ./src/app/globals.css
-
-# Use the design tokens
-<div className="bg-primary text-primary-foreground p-4 rounded-lg">
-  Hello World
-</div>
-```
-
-## Key Features
-
-### 🤖 **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
-
-### 🎯 **Context-Aware Generation**
-
-- **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
-
-### 🗄️ **Database Integration**
-
-- **InstantDB Default**: Real-time database with instant synchronization
-- **MCP Support**: AI can directly interact with databases and external services
-- **Automatic Schema**: Database schema generated from project context
-- **Authentication**: Magic code authentication with user profiles
-- **CRUD Operations**: Generic database utilities for all entities
-- **Real-time Components**: Components automatically sync with live data
-
-## 🧪 **Testing & Quality Assurance**
-
-### **Quick Test Suite**
-
-```bash
-# Run automated test suite
-./docs/quick-test.sh
-
-# Expected: All tests pass within 5 minutes
-# Tests: Installation, initialization, generation, timeout handling
+mycontext init . --analyze
+mycontext generate context --files-only
+mycontext generate-components authentication
 ```
 
-### **Comprehensive Testing**
+### Build Complete App
 
 ```bash
-# Follow detailed testing guide
-cat docs/TESTING_GUIDE.md
-
-# Test specific scenarios
-mycontext status --check-health
-mycontext model --test
+mycontext build-app --description "E-commerce platform" --interactive
 ```
 
-### **Timeout Configuration**
-
-- **Default Timeout**: 5 minutes for all AI operations
-- **Component Generation**: 5 minutes per component
-- **Context Generation**: 5 minutes for full context
-- **Agent Workflows**: 5 minutes per workflow step
-
-## 📞 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
+## Documentation
 
-### Enterprise Support
+- [Full Documentation](https://mycontext.fbien.com/docs)
+- [API Reference](https://mycontext.fbien.com/docs/api)
+- [Examples](https://mycontext.fbien.com/docs/examples)
 
-- **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
+## Support
 
----
+- [GitHub Issues](https://github.com/mycontext/cli/issues)
+- [Discord Community](https://discord.gg/mycontext)
+- [Documentation](https://mycontext.fbien.com/docs)
 
-**🚀 Ready to transform your development workflow with AI-powered agents?**
+## License
 
-_Built with ❤️ by the MyContext team - Making AI work for developers, not against them._
+MIT © MyContext

package/package.json

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