mycontext-cli 2.0.25 → 2.0.27

package/README.md

@@ -1,15 +1,33 @@
-# MyContext CLI
+# MyContext CLI + mycontext PM System
 
-**🎨 Component-First Visual Builder with Zero-Error Guarantees**
+**🤖 AI-Powered Project Management + Component-First Development**
 
 [![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 production-ready React/Next.js components **one at a time**, preview them visually, then scale to complete applications. Every component guaranteed **zero TypeScript/ESLint/build errors**.
+**🎨 MyContext CLI** - Component-first development with zero-error guarantees and production-ready code generation
+
+<!-- Future: mycontext PM - Intelligent project planning, task decomposition, and real-time monitoring using Claude Agent SDK -->
+
+**Result:** From client requirements to production deployment - fully automated with AI oversight.
 
 ## 🚀 Quick Start
 
+### **Option 1: Complete Guided Setup (⭐ Recommended for New Projects)**
+
+```bash
+# Install globally
+npm install -g mycontext-cli
+
+# Single command complete setup with AI guidance
+mycontext setup-complete --interactive
+
+# That's it! Project is ready for development.
+```
+
+### **Option 2: Step-by-Step Development**
+
 ```bash
 # Install globally
 npm install -g mycontext-cli
@@ -20,10 +38,15 @@ mycontext init my-app
 # 2. Generate context files (PRD, features, etc.)
 mycontext generate-context-files --description "Your app idea"
 
-# 3. Component list is generated automatically
-# 4. Compile PRD (requires approval)
+# 3. Compile PRD (requires approval)
 mycontext compile-prd
 
+# 4. Generate individual components
+mycontext generate types
+mycontext generate brand
+mycontext generate components-list
+mycontext generate project-structure
+
 # 5. Generate components with validation
 mycontext generate-components all --with-tests
 
@@ -34,6 +57,24 @@ mycontext preview components
 mycontext build-app --interactive
 ```
 
+### **Option 3: AI-Powered Workflow Analysis**
+
+```bash
+# Install globally
+npm install -g mycontext-cli
+
+# 1. AI analyzes your project requirements
+
+# 2. AI generates contextual workflow and executes it
+mycontext workflow generate --description "E-commerce platform with payments"
+
+# 3. Or use interactive workflow planning
+mycontext workflow --interactive
+
+# 4. AI creates complete project structure with components
+# 5. Continue development with AI-generated architecture
+```
+
 ## 💡 Philosophy: Component-First Development
 
 **Start Small, Scale Gradually:**
@@ -47,43 +88,112 @@ mycontext build-app --interactive
 
 **Result:** Production-ready apps with 0 errors, built incrementally.
 
-## 🎯 Key Features
+## 🏗️ System Architecture
 
-### ✅ Zero-Error Guarantee
+```
+┌─────────────────┐    ┌─────────────────┐
+│   Client Input  │───▶│  MyContext CLI  │
+│                 │    │                 │
+│ • Requirements  │    │ • Code Generation│
+│ • Description   │    │ • Component      │
+│ • Tech Stack    │    │   Creation      │
+└─────────────────┘    └─────────────────┘
+```
 
-- **TypeScript validation** on every component
-- **ESLint checks** with automatic fixes
-- **Build validation** before moving forward
-- **Automatic retries** with error context (max 3 attempts)
+<!-- Future PM Architecture:
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Client Input  │───▶│  mycontext PM   │───▶│  MyContext CLI  │
+│                 │    │  (Next.js App)  │    │                 │
+│ • Requirements  │    │                 │    │ • Code Generation│
+│ • Budget        │    │ • Task Planning │    │ • Component      │
+│ • Timeline      │    │ • Progress Mgmt │    │   Creation      │
+└─────────────────┘    │ • Real-time     │    └─────────────────┘
+                       │   Monitoring    │
+                       └─────────────────┘
+                               │
+                               ▼
+                       ┌─────────────────┐
+                       │  Progress Sync  │
+                       │  (Webhooks)     │
+                       └─────────────────┘
+-->
+
+### **Data Flow:**
+
+1. **Client Requirements** → AI analyzes and generates project structure
+2. **Code Generation** → MyContext builds production-ready components
+3. **AI Oversight** → Intelligent suggestions and validation throughout development
+
+<!-- Future PM Data Flow:
+1. Client Requirements → mycontext PM analyzes and decomposes into structured JSON
+2. mycontext PM Plan → MyContext CLI imports and generates project structure
+3. Code Generation → MyContext builds production-ready components
+4. Progress Updates → Real-time sync back to mycontext PM dashboard
+5. AI Oversight → Continuous monitoring and intelligent suggestions
+-->
 
-### ✅ UI Specification System
+## 🎯 Key Features
 
-- **Plain-English specs** from component descriptions
-- **JSON-to-spec conversion** for structured input
-- **Built-in templates** for common patterns (cards, forms, buttons)
-- **Detailed implementation guidance** with accessibility & responsive requirements
-- **Integrated workflow** with component generation
+<!-- Future: mycontext PM (Coming Soon)
+- Intelligent Project Planning - AI decomposes requirements into epics, user stories, and tasks
+- Real-time Progress Monitoring - Hourly checks, blocker detection, timeline adjustments
+- Client Brief Processing - Parse contracts, budgets, and timelines into structured plans
+- Task Assignment & Tracking - Automated task management with priority and dependency handling
+- Progress Synchronization - Webhook integration for live dashboard updates
+-->
 
-### ✅ Visual Preview
+### ✅ **MyContext CLI (Component-First Development)**
 
-- **Figma-like component board** for visual testing
-- **Interactive component playground**
-- **Responsive design testing**
+- **Streamlined Workflow** - Single `setup-complete` command for full project setup
+- **Smart Next Steps** - Context-aware suggestions guide you through the development process
+- **Zero-Error Guarantee** - TypeScript/ESLint/build validation on every component
+- **UI Specification System** - Plain-English specs with accessibility & responsive guidance
+- **Visual Preview** - Figma-like component board for testing
+- **BYOK Model** - Use your own Claude/X.AI/OpenAI API keys (~$20/month)
 
-### ✅ BYOK Model (Bring Your Own Keys)
+### 🤖 **AI Workflow Analysis**
 
-- Use your own Claude/X.AI/OpenAI API keys
-- No billing from us - you control costs
-- Transparent pricing (~$20/month for unlimited usage)
+- **Intelligent Project Analysis** - AI understands your requirements and suggests optimal workflows
+- **Contextual Workflow Generation** - Custom workflows tailored to your specific project needs
+- **Component Recommendations** - AI suggests appropriate components and features
+- **Architecture Guidance** - Recommends best tech stack and project structure
 
 ## 📋 Commands
 
-### Core Workflow
+### Complete Project Setup (⭐ NEW)
+
+```bash
+mycontext setup-complete --interactive       # Complete guided project setup
+mycontext setup-complete --name "MyApp"      # Direct setup with options
+```
+
+### AI Workflow Analysis (NEW)
+
+```bash
+mycontext workflow analyze                   # Analyze project with AI
+mycontext workflow generate                  # Generate and execute workflow
+mycontext workflow --interactive             # Interactive workflow planning
+```
+
+### Streamlined Workflow (Recommended)
+
+```bash
+mycontext init <project-name>              # Initialize project
+mycontext generate-context-files            # Generate PRD, features, specs
+mycontext generate architecture             # Generate complete architecture
+mycontext build-app                         # Build complete application
+```
+
+### Traditional Component-First Workflow
 
 ```bash
 mycontext init <project-name>              # Initialize project
 mycontext generate-context-files            # Generate PRD, features, specs
 mycontext compile-prd                       # Compile context into PRD
+mycontext generate types                    # Generate TypeScript types
+mycontext generate brand                    # Generate brand guidelines
+mycontext generate components-list          # Generate component list
+mycontext generate project-structure        # Generate project structure
 mycontext generate-components <name|all>    # Generate components
 mycontext preview <type>                    # Preview components/app
 mycontext build-app                         # Build complete application
@@ -196,17 +306,18 @@ mycontext refine spec RevenueCard --desc "A card showing total revenue prominent
 - Desktop (> 768px): Standard spacing, maintain layout
 ```
 
-## 🆚 MyContext vs Others
+## 🆚 MyContext CLI 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          |
-| **UI Specifications**    | Plain-English   | None       | None        |
-| **Pricing**              | BYOK ($0-20/mo) | $20-200/mo | Usage-based |
-| **Deployment**           | Anywhere        | Limited    | Vercel only |
+| Feature                   | MyContext CLI          | Lovable    | v0.dev      | Bolt        |
+| ------------------------- | ---------------------- | ---------- | ----------- | ----------- |
+| **AI Project Management** | 🚧 Coming Soon         | ❌ None    | ❌ None     | ❌ None     |
+| **Code Location**         | Your machine           | Cloud      | Cloud       | Cloud       |
+| **End-to-End Automation** | ✅ Requirements→Deploy | ❌ Manual  | ❌ Manual   | ❌ Manual   |
+| **Progress Monitoring**   | ✅ Context-Aware       | ❌ None    | ❌ None     | ❌ None     |
+| **Validation Gates**      | 12+ checkpoints        | None       | None        | None        |
+| **TypeScript Guarantee**  | 100%                   | No         | No          | No          |
+| **PM Integration**        | 🚧 Coming Soon         | ❌ None    | ❌ None     | ❌ None     |
+| **Pricing**               | BYOK ($0-20/mo)        | $20-200/mo | Usage-based | Usage-based |
 
 ## 🐛 Troubleshooting
 
@@ -243,10 +354,42 @@ mycontext refine spec ComponentName --desc "description" --verbose
 mycontext refine spec ComponentName --json-file component.json
 ```
 
+**"PM Plan Import Failed"**
+
+```bash
+# Validate PM plan structure first
+mycontext import-project-plan ./pm-plan.json --validate
+
+# Check for required fields in PM plan
+# Required: project.name, project.description, breakdown.tasks, myContext.framework
+```
+
+**"Progress Export Issues"**
+
+```bash
+# Check if project has been initialized
+mycontext export-progress --format summary
+
+# Ensure .mycontext directory exists with todos.json
+ls -la .mycontext/
+```
+
+<!-- Future: mycontext PM Synchronization (Coming Soon)
+# Test webhook connectivity
+curl -X POST https://mycontext-pm.example.com/webhook \
+  -H "Content-Type: application/json" \
+  -d '{"test": "connection"}'
+
+# Check webhook URL format
+mycontext export-progress --webhook https://mycontext-pm.example.com/webhook
+-->
+
 ## 📚 Documentation
 
 - [Getting Started](https://github.com/farajabien/mycontext-cli#quick-start)
-- [Component Generation](https://github.com/farajabien/mycontext-cli#commands)
+- [AI Workflow Analysis](https://github.com/farajabien/mycontext-cli#ai-workflow-analysis-new)
+- [Component Generation](https://github.com/farajabien/mycontext-cli#traditional-component-first-workflow)
+- [System Architecture](https://github.com/farajabien/mycontext-cli#system-architecture)
 - [Build Strategies](https://github.com/farajabien/mycontext-cli#philosophy-component-first-development)
 
 ## 🤝 Contributing
@@ -259,4 +402,8 @@ MIT © MyContext
 
 ---
 
+**🤖 The future of AI-powered development: From requirements to production with intelligent automation.**
+
 **Built by developers, for developers. Your code stays on your machine.** 🚀
+
+<!-- Future: 🤖 The future of AI-powered development: From requirements to production with mycontext PM oversight. -->

package/dist/cli.js

@@ -31,6 +31,14 @@ 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 setup_shadcn_1 = require("./commands/setup-shadcn");
+const setup_complete_1 = require("./commands/setup-complete");
+const import_project_plan_1 = require("./commands/import-project-plan");
+const export_progress_1 = require("./commands/export-progress");
+const pm_integration_1 = require("./commands/pm-integration");
+const help_1 = require("./commands/help");
+const suggest_1 = require("./commands/suggest");
+const workflow_1 = require("./commands/workflow");
 const generate_context_files_1 = require("./commands/generate-context-files");
 const compile_prd_1 = require("./commands/compile-prd");
 const build_strategy_1 = require("./commands/build-strategy");
@@ -77,7 +85,7 @@ try {
     ];
     for (const p of candidates) {
         if (fs.pathExistsSync(p)) {
-            const result = dotenv.config({ path: p });
+            const result = dotenv.config({ path: p, silent: true });
             dotenvExpand.expand(result);
         }
     }
@@ -164,6 +172,7 @@ program
     .option("--force", "Overwrite existing output files without prompt")
     .option("--full", "Generate full context (PRD + A/B/C/D files) - for 'context' type only")
     .option("--files-only", "Generate only A/B/C/D files (requires existing PRD) - for 'context' type only")
+    .option("--auto-continue", "Automatically continue to next logical steps after completion")
     .action(async (type, options) => {
     try {
         const generateCommand = new generate_1.GenerateCommand();
@@ -229,6 +238,42 @@ program
         process.exit(1);
     }
 });
+// Context-aware help command
+program
+    .command("help [topic]")
+    .description("Show context-aware help and guidance")
+    .option("--verbose", "Show detailed help information")
+    .action(async (topic, options) => {
+    try {
+        const helpCommand = new help_1.HelpCommand(program);
+        await helpCommand.execute({
+            topic,
+            verbose: Boolean(options.verbose),
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("❌ Help command failed:"), error);
+        process.exit(1);
+    }
+});
+// Intelligent command suggestions
+program
+    .command("suggest [command]")
+    .description("Get intelligent command suggestions and recommendations")
+    .option("--limit <number>", "Limit number of suggestions", "5")
+    .action(async (command, options) => {
+    try {
+        const suggestCommand = new suggest_1.SuggestCommand(program);
+        await suggestCommand.execute({
+            command,
+            limit: parseInt(options.limit) || 5,
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("❌ Suggest command failed:"), error);
+        process.exit(1);
+    }
+});
 // Generate components command
 const generateComponentsCmd = program
     .command("generate-components [target]")
@@ -424,85 +469,9 @@ program
         process.exit(1);
     }
 });
-// Workflow command - streamlined development flow
-program
-    .command("workflow <step>")
-    .description("Streamlined development workflow: init → context → types → brand → components")
-    .option("--description <desc>", "Project description for context generation")
-    .option("--with-tests", "Generate tests for components")
-    .option("--skip-brand", "Skip brand generation step")
-    .action(async (step, options) => {
-    try {
-        const steps = ["init", "context", "types", "brand", "components"];
-        const currentIndex = steps.indexOf(step);
-        if (currentIndex === -1) {
-            console.error(chalk_1.default.red(`❌ Invalid step: ${step}`));
-            console.log(chalk_1.default.blue("Available steps: " + steps.join(" → ")));
-            process.exit(1);
-        }
-        console.log(chalk_1.default.blue(`🚀 Running workflow step: ${step}`));
-        // Run the current step and all previous steps if needed
-        for (let i = 0; i <= currentIndex; i++) {
-            const currentStep = steps[i];
-            console.log(chalk_1.default.gray(`\n📋 Step ${i + 1}/${steps.length}: ${currentStep}`));
-            switch (currentStep) {
-                case "init":
-                    // Skip if already initialized
-                    if (await require("fs-extra").pathExists(".mycontext")) {
-                        console.log(chalk_1.default.gray("   ✓ Already initialized"));
-                        continue;
-                    }
-                    break;
-                case "context":
-                    const generateCommand = new generate_1.GenerateCommand();
-                    await generateCommand.execute({
-                        type: "context",
-                        full: true,
-                        description: options.description,
-                        ...options,
-                    });
-                    break;
-                case "types":
-                    const generateTypesCommand = new generate_1.GenerateCommand();
-                    await generateTypesCommand.execute({
-                        type: "types",
-                        ...options,
-                    });
-                    break;
-                case "brand":
-                    if (options.skipBrand) {
-                        console.log(chalk_1.default.gray("   ⏭️  Skipped (--skip-brand)"));
-                        continue;
-                    }
-                    const generateBrandCommand = new generate_1.GenerateCommand();
-                    await generateBrandCommand.execute({
-                        type: "brand",
-                        ...options,
-                    });
-                    break;
-                case "components":
-                    const generateComponentsCommand = new generate_components_1.GenerateComponentsCommand();
-                    await generateComponentsCommand.execute("all", {
-                        withTests: options.withTests || false,
-                        all: true,
-                        ...options,
-                    });
-                    break;
-            }
-        }
-        console.log(chalk_1.default.green(`\n✅ Workflow step '${step}' completed successfully!`));
-        if (currentIndex < steps.length - 1) {
-            console.log(chalk_1.default.blue(`\n➡️  Next step: mycontext workflow ${steps[currentIndex + 1]}`));
-        }
-        else {
-            console.log(chalk_1.default.green(`\n🎉 All workflow steps completed! Your project is ready.`));
-        }
-    }
-    catch (error) {
-        console.error(chalk_1.default.red("❌ Workflow failed:"), error);
-        process.exit(1);
-    }
-});
+// Workflow command - pre-configured workflow templates
+const workflowCommand = new workflow_1.WorkflowCommand();
+workflowCommand.register(program);
 // Update command (mycontext update)
 program
     .command("update")
@@ -538,6 +507,15 @@ program.addCommand(build_strategy_1.buildStrategyCommand);
 // Health check command
 const healthCheckCommand = new health_check_1.HealthCheckCommand();
 healthCheckCommand.register(program);
+// Import Project Plan command (mycontext PM integration)
+const importProjectPlanCommand = new import_project_plan_1.ImportProjectPlanCommand();
+importProjectPlanCommand.register(program);
+// Export Progress command (mycontext PM integration)
+const exportProgressCommand = new export_progress_1.ExportProgressCommand();
+exportProgressCommand.register(program);
+// PM Integration command (comprehensive PM integration management)
+const pmIntegrationCommand = new pm_integration_1.PMIntegrationCommand();
+pmIntegrationCommand.register(program);
 // Build App command (agent-driven workflow with looping)
 const buildAppCmd = program
     .command("build-app")
@@ -552,6 +530,9 @@ const buildAppCmd = program
     .option("--interactive", "Enable interactive mode with user prompts and confirmations")
     .option("--skip-validation", "Skip validation and quality assurance steps")
     .option("--max-retries <number>", "Maximum retry attempts for failed steps", "3")
+    .option("--pm-plan <file>", "Use mycontext PM project plan JSON file")
+    .option("--auto-sync", "Automatically sync progress with mycontext PM")
+    .option("--webhook-url <url>", "Webhook URL for progress updates")
     .action(async (options) => {
     try {
         const command = new build_app_1.BuildAppCommand();
@@ -566,6 +547,9 @@ const buildAppCmd = program
             interactive: Boolean(options.interactive),
             skipValidation: Boolean(options.skipValidation),
             maxRetries: parseInt(options.maxRetries) || 3,
+            pmPlan: options.pmPlan,
+            autoSync: Boolean(options.autoSync),
+            webhookUrl: options.webhookUrl,
         });
     }
     catch (error) {
@@ -713,6 +697,34 @@ program
         process.exit(1);
     }
 });
+// shadcn/ui setup command
+program
+    .command("setup-shadcn")
+    .description("Set up shadcn/ui components with interactive terminal installation")
+    .option("--all", "Install all essential components automatically")
+    .option("--components <list>", "Comma-separated list of components to install")
+    .option("--force", "Force reinitialization even if already set up")
+    .option("--skip-prompts", "Skip interactive prompts")
+    .action(async (options) => {
+    try {
+        const command = new setup_shadcn_1.SetupShadcnCommand();
+        await command.execute({
+            all: Boolean(options.all),
+            components: options.components
+                ? options.components.split(",").map((c) => c.trim())
+                : undefined,
+            force: Boolean(options.force),
+            skipPrompts: Boolean(options.skipPrompts),
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red("❌ shadcn/ui setup failed:"), error);
+        process.exit(1);
+    }
+});
+// Setup complete command - guided complete project setup
+const setupCompleteCommand = new setup_complete_1.SetupCompleteCommand();
+setupCompleteCommand.register(program);
 // Promote command for moving components to production
 program
     .command("promote")