mycontext-cli 0.4.7 → 0.4.9

package/README.md

@@ -1,8 +1,10 @@
 # mycontext CLI
 
-**AI-Powered Component Generation with shadcn/ui & Next.js** 🚀
+**🧠 The AI That Actually Understands Your Project** 🚀
 
-mycontext CLI transforms your project ideas into production-ready components with a context-first approach. Generate PRD, types, brand, and a component list, then create standardized shadcn/ui components with optional tests.
+mycontext CLI is the first **agentic AI development tool** with specialized intelligence agents that understand your codebase, predict your needs, and generate production-ready components. **BETA READY** with complete agentic AI architecture and Ollama fallback.
+
+**✅ WORKING NOW**: Ollama fallback provides unlimited component generation without API keys when GitHub Models is rate-limited.
 
 ## 🚀 Quick Start
 
@@ -22,100 +24,292 @@ mycontext update
 mycontext --up
 ```
 
-### Generate
+### Ollama Setup (Recommended for Unlimited Generation)
+
+For unlimited component generation without API rate limits:
 
 ```bash
-# 1) Init and enter project
-mycontext init my-app
+# Install Ollama (one-time setup)
+curl -fsSL https://ollama.ai/install.sh | sh
+
+# Pull the specialized MyContext model
+ollama pull llama3.2:3b
+
+# Verify installation
+mycontext model status
+```
+
+**Benefits:**
+
+- ✅ **Zero API costs** - Generate unlimited components
+- ✅ **Works offline** - No internet required after setup
+- ✅ **No rate limits** - Generate as much as you want
+- ✅ **Complete privacy** - Your code stays local
+
+## 🧠 **ENHANCED AI ARCHITECTURE**
+
+### ✅ **Complete Agentic System (Production Ready)**
+
+- **ProjectIntelligence Engine** - Deep codebase analysis and pattern learning
+- **Multi-Agent Architecture** - ArchitectAgent, SecurityAgent, QAAgent, DocsAgent
+- **Predictive Development** - `mycontext predict` commands for intelligent suggestions
+- **Code Evolution Engine** - Automated refactoring and optimization recommendations
+- **Cross-Project Learning** - Knowledge sharing across projects and patterns
+- **Context Generation** - PRD, types, branding, component planning
+- **Component Generation** - Production-ready React components
+- **Enhanced CLI** - Complete agentic command interface
+
+### 🔄 **Enhanced Features (Available Now)**
+
+- **Intelligent Predictions** - Next steps, dependencies, patterns, issues, optimizations
+- **Architectural Insights** - System design analysis and scalability recommendations
+- **Security Analysis** - Vulnerability scanning and compliance checking
+- **Quality Assurance** - Automated code review and quality scoring
+- **Documentation Generation** - Comprehensive docs with JSDoc and usage examples
+- **Auto-Cleanup** - `mycontext clean` command for project maintenance
+
+### 🚀 **Coming Soon**
+
+- **VS Code Extension** - Visual agent management and live preview
+- **Real-time Collaboration** - Multi-user agentic workflows
+- **Advanced Learning** - Enhanced cross-project intelligence
+- **Custom AI Agents** - Build your own specialized agents
+
+### **Enhanced Agentic Workflow (Production Ready)**
+
+```bash
+# 1) Initialize project with ProjectIntelligence
+mycontext init my-app --description "AI-powered platform"
 cd my-app
 
-# Enable GitHub Models (recommended) - set token in this project
+# Optional: Enable GitHub Models for faster generation
 echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
 
-# Optional: list available models
-mycontext model list
-
-# 2) Context & types
-mycontext generate context
-# paste PRD when prompted, or
-# echo "...long PRD..." | mycontext generate context
-# mycontext generate context --description "Short description"
+# 2) Generate comprehensive context with multi-agent analysis
+mycontext generate context --description "Your project description"
 mycontext generate types
+mycontext generate brand
+mycontext generate components-list
 
-# 3) Core-first design anchor (BrandComp)
-mycontext core --group core generate
-# writes components/.mycontext/core/BrandComp.tsx
-# refine manually or record notes
-mycontext core refine --desc "Tighten spacing/colors"
-# when satisfied
-mycontext core ready
+# 3) Experience the enhanced agentic features
+mycontext predict next              # AI predicts next development steps
+mycontext predict dependencies      # Suggests optimal packages and tools
+mycontext predict patterns         # Identifies architectural patterns
+mycontext predict issues           # Forecasts potential problems
+mycontext predict optimization     # Recommends performance improvements
+
+# 4) Generate production-ready components with AI agents
+mycontext generate-components all --local --with-tests
 
-# 4) Plan components (alias supported: component-list)
-mycontext generate components-list --force
-# You'll be prompted to select the core (unless --yes). Or later:
-mycontext core set BrandComp
+# 5) Clean and maintain your project intelligently
+mycontext clean                    # Auto-fix malformed files and issues
+
+# 6) Preview and iterate
+mycontext preview components
+mycontext list components --local
+```
+
+### **Advanced Intelligence Commands**
+
+```bash
+# Core component management (design anchor)
+mycontext core generate BrandComp
+mycontext core refine --desc "Improve spacing and colors"
+mycontext core ready
 
-# 5) Generate components locally (installs shadcn primitives, adds tests)
-mycontext generate-components all --local --with-tests --check
+# Specialized agent workflows
+mycontext agent-flow generate-context              # Multi-agent context generation
+mycontext agent-flow validate-workflow             # Test agent communication
 
-# Live preview (auto-updated) and final canvas
-mycontext preview components           # HTML overview
-mycontext normalize preview            # Build .mycontext/preview-layout.json
+# Project intelligence and analysis
+mycontext status --detailed                        # Comprehensive project analysis
+mycontext validate prd --interactive              # AI-powered PRD validation
 ```
 
 ## 📦 Outputs
 
-- `context/prd.md` — PRD
-- `context/types.ts` — TypeScript types
-- `context/branding.md` — Brand guidelines
-- `context/component-list.json` — Component plan (merged by name when re-generated)
+- `.mycontext/prd.md` — PRD
+- `.mycontext/types.ts` — TypeScript types
+- `.mycontext/branding.md` — Brand guidelines
+- `.mycontext/component-list.json` — Component plan (merged by name when re-generated)
 - `components/.mycontext/` — Generated components (safe default to avoid overriding user code)
   - Group directories: kebab-case (e.g., `user-interface/`)
   - Component files: PascalCase (e.g., `GameBoard.tsx`)
 
 Numbered aliases for easy sorting (display-only):
 
-- `context/01-prd.md`
-- `context/02-types.ts`
-- `context/03-branding.md`
-- `context/04-component-list.json`
+- `.mycontext/01-prd.md`
+- `.mycontext/01a-brief.md` — Project overview and brief
+- `.mycontext/01b-requirements.md` — Technical requirements
+- `.mycontext/01c-flows.md` — User flows and workflows
+- `.mycontext/02-types.ts`
+- `.mycontext/03-branding.md`
+- `.mycontext/04-component-list.json`
+- `.mycontext/05-project-structure.md` — Next.js project structure with dialog/datatable prioritization
+
+## 🔧 Complete Command Reference
 
-## 🔧 Commands (highlights)
+### **Core Workflow Commands**
 
 ```bash
-# Generate (cloud-first GitHub Models, local fallback)
-mycontext generate context --description "Simple app"
-mycontext generate types
-mycontext generate brand
-mycontext generate components-list
+# Project Setup
+mycontext init <project-name> [--description "text"] [--framework nextjs]
+mycontext setup [--local] [--force]                    # Local AI setup
 
-# Accepts alias
-mycontext generate component-list
+# Context Generation
+mycontext generate context [--description "text"]      # PRD + user stories
+mycontext generate types                               # TypeScript interfaces
+mycontext generate brand                               # Design system
+mycontext generate components-list                     # Component planning
+mycontext generate project-structure                  # Next.js project structure (NEW!)
+mycontext validate prd [--interactive]                # PRD validation
 
-# Components (core-first and preview flags)
-mycontext generate-components all --local --with-tests --final-canvas
-mycontext generate-components all --local --core-first   # core-only then stop
-mycontext generate-components authentication --local --no-update-preview
+# Core Component (Brand Anchor)
+mycontext core generate [name] [--group core]         # Generate BrandComp
+mycontext core refine [--desc "improvements"]         # Record refinements
+mycontext core ready                                   # Mark ready for use
+mycontext core status                                  # Check core status
 
-# Preview & Normalize
-mycontext preview components
-mycontext normalize preview
+# Component Generation
+mycontext generate-components all [--local] [--with-tests] [--check]
+mycontext generate-components <group> [--local]       # Single group
+mycontext generate-components all --core-first        # Core only, then stop
+```
+
+### **AI Enhancement Commands**
+
+```bash
+# Component Enhancement & Refinement
+mycontext enhance <component.tsx> [--prompt "improvements"]
+mycontext enhance <group-name> [--interactive]        # Group enhancement
+mycontext refine <component.tsx> [--prompt "changes"] # Focused refinement
+mycontext refine <component.tsx> --rollback           # Rollback changes
+
+# Enhancement Options
+--output-format <format>    # structured, diff, preview, apply
+--show-changes             # Show detailed change breakdown
+--preserve-history         # Keep refinement history
+--interactive             # VS Code extension mode
+```
+
+### **Project Management**
+
+```bash
+# Status & Information
+mycontext status [--detailed] [--check-health]        # Project status
+mycontext list [type] [--format table|json] [--local] # List resources
+mycontext preview <type> [--port 3000]                # Preview components
+
+# List Types: components, projects, files, all
+# Preview Types: brand, components, generated, <group-name>
+
+# Authentication
+mycontext auth [--email] [--code] [--non-interactive] # Magic code auth
+mycontext auth:status                                  # Check auth status
+mycontext auth:logout                                  # Logout
 ```
 
-### Flags & behavior
+### **Model & AI Management**
 
-- `--description`, `--context-file`: supply input context
-- `--model`, `--models`/`--use-models`/`--model-candidates`: model override/fallbacks
-- `--local`: generate components without auth; remote storage is skipped silently
-- `--with-tests`: scaffold Jest + RTL and generate per-component tests
-- Component list saves to `context/component-list.json` and merges by group/component name
-- Neutral fallback: if AI times out for component-list, a valid skeleton is written so you can edit and re-run
-- Post-generation import scan installs any missing `@/components/ui/*` shadcn primitives actually used
-- Prompts include the plan banner: `[mycontext] Plan: plan → generate → QA → docs → preview (→ checks)`
+```bash
+# Local Model Management
+mycontext model status [--detailed]                   # Model health check
+mycontext model list                                   # Available models
+mycontext model test [--prompt "text"] [--verbose]    # Test generation
+mycontext model update [--backup]                     # Update model
+mycontext model reset [--force]                       # Reset to clean state
+mycontext model stats [--detailed] [--last 30d]       # Usage statistics
+```
+
+### **🧠 Enhanced Intelligence Commands**
+
+```bash
+# Predictive Development (Production Ready)
+mycontext predict next                                # Predict next development steps
+mycontext predict dependencies                        # Suggest optimal packages and tools
+mycontext predict patterns                           # Identify architectural patterns
+mycontext predict issues                             # Forecast potential problems
+mycontext predict optimization                       # Recommend performance improvements
+
+# Agent Communication & Auto-Generation
+mycontext agent-flow generate-context               # Multi-agent context generation
+mycontext agent-flow validate-workflow              # Test agent communication system
+mycontext clean                                     # Auto-fix malformed files and issues
+
+# Intelligence Options
+--detailed                                          # Show comprehensive analysis
+--format json|table                               # Output format
+--scope next|dependencies|patterns|issues|optimization  # Prediction scope
+```
+
+### **Utilities & Maintenance**
+
+```bash
+# Utilities
+mycontext normalize preview                            # Build preview layout
+mycontext update                                       # Update CLI
+mycontext help                                         # Detailed help
+
+# Global Options
+--verbose              # Detailed output
+--yes                 # Skip prompts (non-interactive)
+--project <name>      # Specify project
+--model <name>        # Override model
+--models <list>       # Fallback models (comma-separated)
+```
+
+### **Key Options & Behavior**
+
+- `--description`, `--context-file`: Supply input context for generation
+- `--model`, `--models`/`--use-models`: Model override and fallback candidates
+- `--local`: Generate components without auth; remote storage skipped silently
+- `--with-tests`: Scaffold Jest + RTL and generate per-component tests
+- `--check`: Run typecheck, lint, and tests after generation
+- `--core-first`: Generate only core BrandComp, then exit
+- `--interactive`: VS Code extension mode with structured output
+- `--preserve-history`: Keep enhancement/refinement history for rollback
+
+### **Important Behaviors**
+
+- Component list saves to `.mycontext/component-list.json` and merges by name when re-generated
+- Post-generation scan installs missing `@/components/ui/*` shadcn primitives automatically
+- Neutral fallback: if AI times out, valid skeleton written for manual editing
+- Core-first workflow: components-list generation prompts for core selection
+
+## 🛠 Environment & Configuration
+
+### **Authentication & Models**
+
+```bash
+# GitHub Models (optional - provides faster generation when available)
+MYCONTEXT_GITHUB_TOKEN=ghp_xxx          # Set in .mycontext/.env for faster generation
+
+# Ollama (automatic fallback - works without API keys)
+# Install Ollama locally for unlimited component generation
+# No API keys required - works offline when GitHub Models is rate-limited
+
+# Alternative providers (optional)
+HUGGINGFACE_API_KEY=hf_xxx             # Hugging Face fallback
+XAI_API_KEY=xai_xxx                    # X.AI (Grok) fallback
+```
+
+### **Model Configuration**
+
+```bash
+# Model selection
+MYCONTEXT_MODEL=deepseek/DeepSeek-V3-0324         # Override default model
+MYCONTEXT_MODEL_CANDIDATES=gpt-4o,claude-3-5      # Fallback list
+MYCONTEXT_PROVIDER=github                          # Force provider
+
+# Rate limiting & retries
+MYCONTEXT_GITHUB_RETRIES=3                        # Retry attempts
+MYCONTEXT_MODEL_PASSES=2                          # Model fallback passes
+MYCONTEXT_MODEL_COOLDOWN_SECONDS=30               # Cooldown between retries
+```
 
-## 🛠 Notes
+### **Setup Notes**
 
-- Init creates `.mycontext/.env.example` with suggested keys.
-- Set `MYCONTEXT_GITHUB_TOKEN` (models:read) in `.mycontext/.env` for GitHub Models.
-- Standardized naming ensures clean imports and paths.
-- For advanced envs, see `.mycontext/.env.example` or the repo `env.example`.
+- Init creates `.mycontext/.env.example` with suggested environment variables
+- Standardized naming ensures clean imports and shadcn/ui compatibility
+- Components generated in `components/.mycontext/` to avoid overriding user code
+- Preview system auto-updates with live component registry

package/dist/agents/communication/AgentCommunicationManager.d.ts

@@ -0,0 +1,27 @@
+import { AgentMessage, AgentIntent, AgentContext, AgentCommunicationHandler, IntentResolver, WorkflowConfig } from "../interfaces/AgentCommunication";
+import { SubAgentOrchestrator } from "../orchestrator/SubAgentOrchestrator";
+export declare class AgentCommunicationManager implements AgentCommunicationHandler {
+    private messageHistory;
+    private orchestrator;
+    private intentResolver;
+    constructor(orchestrator: SubAgentOrchestrator, intentResolver?: IntentResolver);
+    sendMessage(message: AgentMessage): Promise<void>;
+    receiveMessage(agentName: string): Promise<AgentMessage | null>;
+    broadcastMessage(message: Omit<AgentMessage, "to">): Promise<void>;
+    getMessageHistory(agentName?: string): Promise<AgentMessage[]>;
+    clearHistory(): Promise<void>;
+    private saveMessageLog;
+    runAutoWorkflow(initialAgent: string, context: AgentContext, config: WorkflowConfig): Promise<{
+        success: boolean;
+        outputs: Record<string, any>;
+        messages: AgentMessage[];
+    }>;
+}
+export declare class DefaultIntentResolver implements IntentResolver {
+    analyzeOutput(output: any, context: AgentContext): Promise<AgentIntent>;
+    shouldTriggerNextAgent(intent: AgentIntent, context: AgentContext): Promise<boolean>;
+    getNextAgent(intent: AgentIntent, context: AgentContext): Promise<string | null>;
+    createStarterPrompt(intent: AgentIntent, context: AgentContext): Promise<string>;
+    private calculateConfidence;
+}
+//# sourceMappingURL=AgentCommunicationManager.d.ts.map

package/dist/agents/communication/AgentCommunicationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCommunicationManager.d.ts","sourceRoot":"","sources":["../../../src/agents/communication/AgentCommunicationManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EAEZ,yBAAyB,EACzB,cAAc,EAEd,cAAc,EACf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAI5E,qBAAa,yBAA0B,YAAW,yBAAyB;IACzE,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAiB;gBAGrC,YAAY,EAAE,oBAAoB,EAClC,cAAc,CAAC,EAAE,cAAc;IAM3B,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAM/D,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO9D,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAIrB,cAAc;IAuBtB,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;KAC1B,CAAC;CAwHH;AAGD,qBAAa,qBAAsB,YAAW,cAAc;IACpD,aAAa,CACjB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC;IA8BjB,sBAAsB,CAC1B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC;IAOb,YAAY,CAChB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBnB,mBAAmB,CACvB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IA8BlB,OAAO,CAAC,mBAAmB;CAiC5B"}