mycontext-cli 2.0.1 → 2.0.2

package/dist/README.md

@@ -0,0 +1,388 @@
+# MyContext CLI
+
+**🧠 AI-Powered Full-Stack App Generation with Production-Ready Guarantees**
+
+[![npm version](https://badge.fury.io/js/mycontext-cli.svg)](https://www.npmjs.com/package/mycontext-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+
+Generate complete Next.js applications from natural language with **guaranteed zero linter/build errors** through AI-powered validation gates and automatic build checking.
+
+## 🚀 Quick Start
+
+```bash
+# Install globally
+npm install -g mycontext-cli
+
+# Build a complete app in one command
+mycontext build-app --description "Your app idea" --interactive
+```
+
+## 💡 Philosophy: "LLM as Compiler"
+
+MyContext treats AI as a **compiler** that transforms requirements into production-ready code:
+- **You write the spec** → PRD with user approval gates
+- **AI compiles it** → Generates components with validation
+- **System validates** → TypeScript, ESLint, build checks
+- **You approve** → 12+ validation checkpoints
+
+**Result:** Production-ready code with 0 errors guaranteed.
+
+---
+
+## 📖 Examples
+
+### Tic-Tac-Toe Game
+
+```bash
+mycontext build-app \
+  --description "Tic-tac-toe with AI opponent, score tracking, and responsive design" \
+  --interactive \
+  --with-tests
+```
+
+**Generated:**
+- Game board component
+- AI opponent (minimax algorithm)
+- Score tracking system
+- Reset functionality
+- Responsive Tailwind design
+- Unit tests
+
+### E-Commerce Platform
+
+```bash
+mycontext build-app \
+  --description "E-commerce with product catalog, shopping cart, checkout, and admin dashboard" \
+  --interactive \
+  --complete-architecture
+```
+
+**Generated:**
+- Product listing & detail pages
+- Shopping cart with persistence
+- Checkout flow
+- Admin dashboard
+- Server actions for CRUD
+- Next.js App Router routes
+- Full TypeScript types
+
+### Todo App with Auth
+
+```bash
+mycontext build-app \
+  --description "Todo app with user auth, categories, due dates, and dark mode" \
+  --interactive \
+  --with-tests
+```
+
+---
+
+## 🎯 Features
+
+### ✅ 230-Step Validated Workflow
+
+Every app goes through **12 validation gates** where you approve:
+1. Features specification
+2. User flows
+3. Edge cases
+4. Technical specs
+5. **PRD (must read entire document)**
+6. TypeScript types
+7. Branding & design system
+8. Build strategy
+9. Component list
+10. Server actions (if full-stack)
+11. Routes (if full-stack)
+12. Final build validation
+
+### 🔨 Automatic Build Validation
+
+**Every component** automatically passes through:
+- ✅ TypeScript check (`tsc --noEmit`)
+- ✅ ESLint validation
+- ✅ Build check (`npm run build`)
+- ✅ Unit tests (if `--with-tests`)
+
+**Failed components retry automatically** with error context (max 3 attempts).
+
+### 📊 Real-Time Progress Tracking
+
+Track build progress via JSON files in `.mycontext/progress/`:
+```json
+{
+  "currentPhase": "component_generation",
+  "currentStep": 95,
+  "totalSteps": 230,
+  "percentComplete": 41.3
+}
+```
+
+**Perfect for VS Code extensions & dashboards.**
+
+### 🏗️ Complete Architecture Generation
+
+Generate full-stack apps with `--complete-architecture`:
+- Next.js 15 App Router routes
+- Server actions with validation
+- Self-documenting components
+- Type-safe throughout
+
+---
+
+## 📋 Commands
+
+### Build Complete App (Recommended)
+
+```bash
+mycontext build-app --description "Your app" --interactive
+
+# Options:
+  --output <dir>              # Output directory (default: mycontext-app)
+  --interactive               # Interactive mode with validation prompts
+  --with-tests                # Generate unit tests
+  --complete-architecture     # Generate server actions + routes
+  --architecture-type         # nextjs-app-router | nextjs-pages | react-spa
+  --max-retries 3             # Max retry attempts
+  --verbose                   # Show detailed output
+```
+
+### Step-by-Step Workflow
+
+```bash
+# 1. Initialize project
+mycontext init my-app
+
+# 2. Generate context files (with validation gates)
+mycontext generate-context-files --description "Your app"
+
+# 3. Compile PRD (requires approval)
+mycontext compile-prd
+
+# 4. Generate components (with build validation)
+mycontext generate-components all --with-tests
+```
+
+### Other Commands
+
+```bash
+mycontext setup                    # Configure AI providers
+mycontext build-strategy          # Interactive strategy selection
+mycontext analyze                 # Analyze existing project
+mycontext list [type]             # List components/projects
+mycontext preview <type>          # Preview components
+```
+
+---
+
+## ⚙️ Configuration
+
+### API Keys (BYOK Model)
+
+MyContext uses **your own API keys** - no billing from us.
+
+**Recommended providers:**
+
+```bash
+# Claude (best for complex reasoning)
+echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
+
+# X.AI Grok (best for code generation)
+echo 'MYCONTEXT_XAI_API_KEY=xai-xxx' > .mycontext/.env
+
+# OpenAI (most versatile)
+echo 'MYCONTEXT_OPENAI_API_KEY=sk-xxx' > .mycontext/.env
+```
+
+**Free tier:**
+
+```bash
+# Qwen3 (free via OpenRouter)
+echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
+```
+
+### Project Structure
+
+```
+my-app/
+├── .mycontext/
+│   ├── 01-prd.md                 # Product Requirements
+│   ├── 02-a-features.md          # Features
+│   ├── 02-b-user-flows.md        # User flows
+│   ├── 02-c-edge-cases.md        # Edge cases
+│   ├── 02-d-technical-specs.md   # Tech specs
+│   ├── 03-types.ts               # TypeScript types
+│   ├── 04-branding.md            # Branding
+│   ├── 05-component-list.json    # Component list
+│   ├── progress/                 # Progress tracking
+│   │   ├── master.json           # Master progress
+│   │   └── 07-components/        # Per-component progress
+│   └── .env                      # API keys
+├── components/                    # Generated components
+├── actions/                       # Server actions (--complete-architecture)
+├── app/                          # Routes (--complete-architecture)
+└── package.json
+```
+
+---
+
+## 🎓 How It Works
+
+### 1. Context Generation
+AI generates detailed context files based on your description. **You approve each one.**
+
+### 2. PRD Compilation
+Context files are compiled into a comprehensive PRD. **You must read and approve.**
+
+### 3. Component Generation
+Components are generated from PRD. **Each component automatically validated:**
+```
+🔨 Generating: LoginForm
+   ✅ Code Generated
+   ✅ TypeScript Check Passed
+   ✅ ESLint Passed
+   ✅ Build Passed
+   ✅ Tests Passed
+```
+
+### 4. Error Recovery
+Failed components retry with error context:
+```
+❌ TypeScript check failed (3 errors)
+   - LoginForm.tsx:12:5 - TS2322: Type 'string' not assignable to 'number'
+
+🔄 Retry 1/3 (with error context)
+   ✅ Fixed and validated
+```
+
+### 5. Production Deploy
+```bash
+cd my-app
+npm run build    # ✅ Zero errors guaranteed
+vercel deploy    # 🚀 Deploy
+```
+
+---
+
+## 🔧 Advanced Usage
+
+### Build Strategy Selection
+
+```bash
+mycontext build-strategy --recommend
+
+# AI asks about:
+- Project type (client work, personal, MVP, etc.)
+- Complexity (simple, medium, complex)
+- Timeline (urgent, moderate, flexible)
+- Team size (solo, small, large)
+
+# Recommends best approach:
+🎯 Vertical Slice - Build complete features end-to-end
+⏰ Time to first demo: 2-3 weeks
+```
+
+### Complete Architecture
+
+```bash
+mycontext build-app \
+  --description "Blog platform" \
+  --complete-architecture \
+  --architecture-type nextjs-app-router
+
+# Generates:
+# - app/blog/[slug]/page.tsx
+# - actions/createPost.ts
+# - actions/updatePost.ts
+# - components/BlogPost.tsx
+# - Full type system
+```
+
+### Existing Project Migration
+
+```bash
+mycontext analyze                  # Analyze existing project
+mycontext migrate --all           # Migrate to MyContext structure
+```
+
+---
+
+## 📊 Build Metrics
+
+After successful build:
+
+```
+🎉 Workflow Complete!
+
+📊 Summary:
+   Duration: 12m 34s
+   Total Steps: 230/230
+   User Approvals: 12
+   Retries: 3
+
+✅ Build Checks:
+   TypeScript: 30 passed, 0 failed
+   ESLint: 30 passed, 0 failed
+   Build: 30 passed, 0 failed
+   Tests: 28 passed, 0 failed
+```
+
+**Zero failures = Production-ready**
+
+---
+
+## 🆚 MyContext vs Others
+
+| Feature | MyContext | Lovable | v0.dev |
+|---------|-----------|---------|--------|
+| **Code Location** | Your machine | Cloud | Cloud |
+| **Validation Gates** | 12+ checkpoints | None | None |
+| **Build Validation** | Every component | None | None |
+| **TypeScript Guarantee** | 100% | No | No |
+| **Pricing** | BYOK ($0-20/mo) | $20-200/mo | Usage-based |
+| **Deployment** | Anywhere | Limited | Vercel only |
+| **Progress Tracking** | JSON files | None | None |
+
+---
+
+## 📚 Documentation
+
+- [Complete Workflow](https://github.com/farajabien/mycontext-monorepo/blob/main/docs/BUILD_APP_PROCESS.md) - 230-step process
+- [Integration Guide](https://github.com/farajabien/mycontext-monorepo/blob/main/docs/IMPLEMENTATION_SUMMARY.md) - VS Code integration
+- [Quick Start](https://github.com/farajabien/mycontext-monorepo/blob/main/docs/QUICK_START_BUILD_APP.md) - User guide
+
+---
+
+## 🐛 Troubleshooting
+
+**"PRD Validation Failed"**
+```bash
+# Provide feedback and regenerate
+mycontext compile-prd --force
+```
+
+**"Component Build Failed"**
+```bash
+# Automatic retry with error context (max 3 attempts)
+# Check .mycontext/progress/07-components/<component>.json
+```
+
+**"Progress Not Tracking"**
+```bash
+# Verify progress directory exists
+ls -la .mycontext/progress/
+```
+
+---
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](https://github.com/farajabien/mycontext-monorepo/blob/main/CONTRIBUTING.md)
+
+## 📄 License
+
+MIT © MyContext
+
+---
+
+**Built by developers, for developers. Your code stays on your machine.** 🚀

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "MyContext CLI - AI-powered full-stack application generator with complete architecture generation, server actions, Next.js 15 App Router, and self-documenting components",
   "main": "dist/cli.js",
   "bin": {
@@ -11,7 +11,7 @@
     "build": "npm run build:clean && npm run build:compile && npm run build:copy",
     "build:clean": "rm -rf dist && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '🧹 Cleaned build directory')",
     "build:compile": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '🔨 Compiling TypeScript...') && tsc --noEmitOnError false",
-    "build:copy": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '📋 Copying config files...') && cp -r src/config dist/ && cp package.json dist/ && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '✅ Build complete')",
+    "build:copy": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '📋 Copying config files...') && cp -r src/config dist/ && cp package.json dist/ && cp README.md dist/ && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '✅ Build complete')",
     "dev": "ts-node src/cli.ts",
     "start": "node dist/cli.js",
     "watch": "tsc --watch --pretty",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mycontext-cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "MyContext CLI - AI-powered full-stack application generator with complete architecture generation, server actions, Next.js 15 App Router, and self-documenting components",
   "main": "dist/cli.js",
   "bin": {
@@ -11,7 +11,7 @@
     "build": "npm run build:clean && npm run build:compile && npm run build:copy",
     "build:clean": "rm -rf dist && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '🧹 Cleaned build directory')",
     "build:compile": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '🔨 Compiling TypeScript...') && tsc --noEmitOnError false",
-    "build:copy": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '📋 Copying config files...') && cp -r src/config dist/ && cp package.json dist/ && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '✅ Build complete')",
+    "build:copy": "([ \"$npm_config_loglevel\" = \"silent\" ] || echo '📋 Copying config files...') && cp -r src/config dist/ && cp package.json dist/ && cp README.md dist/ && ([ \"$npm_config_loglevel\" = \"silent\" ] || echo '✅ Build complete')",
     "dev": "ts-node src/cli.ts",
     "start": "node dist/cli.js",
     "watch": "tsc --watch --pretty",