mycontext-cli 1.0.76 → 1.0.78

package/README.md

@@ -4,390 +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"
-
-# Generate only A/B/C/D files (requires existing PRD)
-mycontext generate context --files-only
+# Initialize a new project
+mycontext init my-project
 
-# 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. 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
+# Generate components
+mycontext generate-components all --with-tests
 ```
 
-## 🎯 Core Commands
+## Features
 
-### Context & Planning
+- **🤖 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)
 
-```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
-```
+## Commands
 
-### Component Generation
+### Project Setup
 
 ```bash
-mycontext generate-components all --local --with-tests  # All components
-mycontext generate-components <group> --local          # Specific group
-mycontext core generate                               # Design anchor component
+mycontext init <project-name>          # Initialize new project
+mycontext setup                        # Configure AI providers
+mycontext analyze                      # Analyze existing project
 ```
 
-### Interactive & Management
+### Context Generation
 
 ```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 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
 ```
 
-## Advanced Commands
+### Component Development
 
 ```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
+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
 ```
 
-## 📦 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/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
-
-## 🤖 Agent Architecture
-
-MyContext features a sophisticated multi-agent system with 11 specialized AI agents:
-
-### 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
+### Project Management
 
 ```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
+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
 ```
 
-## 🚀 **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:
+## Configuration
 
-### **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
+### AI Providers
 
-# Or GitHub Models (Fast, high-quality)
-echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
+MyContext supports multiple AI providers:
 
-# Or Claude (Best for complex reasoning)
-echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
+1. **Qwen3 Coder (Recommended - FREE)**
 
-# Or OpenAI (Most versatile)
-echo 'MYCONTEXT_OPENAI_API_KEY=sk-xxx' > .mycontext/.env
+   ```bash
+   echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
+   ```
 
-# Or X.AI (Creative tasks)
-echo 'MYCONTEXT_GROK_TOKEN=xai-xxx' > .mycontext/.env
-```
+2. **GitHub Models (Self-hosted)**
 
-### Option 2: Local AI Setup (Free & Unlimited)
+   ```bash
+   echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
+   ```
 
-```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
+3. **OpenAI (Paid)**
+   ```bash
+   echo 'OPENAI_API_KEY=sk-xxx' > .mycontext/.env
+   ```
 
-# Set up MyContext local AI
-mycontext setup
+### Project Structure
 
-# 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
+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
 ```
 
-### 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
+## Examples
 
-## 🎯 **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
-
-```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
-
-## 🧪 **Testing & Quality Assurance**
-
-### **Quick Test Suite**
+### Work with Existing Project
 
 ```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/dist/cli.js

@@ -33,6 +33,8 @@ const migrate_1 = require("./commands/migrate");
 const generate_todos_1 = require("./commands/generate-todos");
 const sanitize_1 = require("./commands/sanitize");
 const setup_database_1 = require("./commands/setup-database");
+const setup_instantdb_1 = require("./commands/setup-instantdb");
+const setup_mcp_1 = require("./commands/setup-mcp");
 const generate_context_files_1 = require("./commands/generate-context-files");
 const compile_prd_1 = require("./commands/compile-prd");
 // Import sub-agent system
@@ -705,6 +707,61 @@ program
         process.exit(1);
     }
 });
+// InstantDB + MCP setup command
+program
+    .command("setup-instantdb")
+    .description("Set up InstantDB with MCP integration for real-time database and AI-powered development")
+    .option("--no-mcp", "Skip MCP integration setup")
+    .option("--no-auth", "Skip authentication setup")
+    .option("--no-schema", "Skip schema generation")
+    .option("--no-components", "Skip component generation")
+    .option("--app-id <id>", "InstantDB App ID")
+    .option("--token <token>", "InstantDB Personal Access Token")
+    .action(async (options) => {
+    try {
+        const command = new setup_instantdb_1.InstantDBSetupCommand();
+        await command.execute({
+            mcp: options.mcp !== false,
+            auth: options.auth !== false,
+            schema: options.schema !== false,
+            components: options.components !== false,
+            skipAuth: options.auth === false,
+            skipSchema: options.schema === false,
+            skipComponents: options.components === false,
+            appId: options.appId,
+            token: options.token,
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("❌ InstantDB setup failed:"), error);
+        process.exit(1);
+    }
+});
+// MCP setup command
+program
+    .command("setup-mcp")
+    .description("Set up MCP (Model Context Protocol) for AI-powered development with various providers")
+    .option("--provider <provider>", "MCP provider (instantdb, github, custom)", "instantdb")
+    .option("--server <url>", "Custom MCP server URL")
+    .option("--token <token>", "Provider token")
+    .option("--config <path>", "Custom MCP configuration file")
+    .option("--no-install", "Skip dependency installation")
+    .action(async (options) => {
+    try {
+        const command = new setup_mcp_1.MCPSetupCommand();
+        await command.execute({
+            provider: options.provider,
+            server: options.server,
+            token: options.token,
+            config: options.config,
+            install: options.install !== false,
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("❌ MCP setup failed:"), error);
+        process.exit(1);
+    }
+});
 // Promote command for moving components to production
 program
     .command("promote")
@@ -791,6 +848,8 @@ program
     console.log(chalk_1.default.gray("  list [type]             - List resources"));
     console.log(chalk_1.default.gray("  status                  - Check project status"));
     console.log(chalk_1.default.gray("  preview <type>          - Preview brand or components"));
+    console.log(chalk_1.default.gray("  setup-instantdb         - Set up InstantDB with MCP integration"), chalk_1.default.gray("  setup-mcp               - Set up MCP (Model Context Protocol)"));
+    console.log(chalk_1.default.gray("  setup-database          - Set up database and authentication"));
     console.log(chalk_1.default.gray("  auth                    - Authenticate with MyContext AI"));
     console.log(chalk_1.default.gray("  auth --login            - Login to MyContext AI"));
     console.log(chalk_1.default.gray("  auth --logout           - Logout from MyContext AI"));