opencode-enhancer-plugin 1.0.1 → 1.5.0

package/README.md

@@ -14,6 +14,8 @@ The **Enhancer** is a third primary agent mode for OpenCode that sits alongside
 
 - **🔍 Intelligent Context Analysis** - Automatically explores your project structure, tech stack, and relevant files
 - **🧠 Intent Classification** - Categorizes requests as FIX, FEAT, REFACTOR, TEST, or EXPLAIN
+- **🔒 Todo Enforcer System** - Tracks TODOs and prevents stopping until all tasks are completed (for ultraplan and strategos agents)
+- **🎯 Strategos Mode** - Strategic planning with interview mode for complex tasks
 - **📚 Context7 Integration** - Conditionally includes `use context7` when documentation-heavy frameworks are detected
 - **🎨 Style-Aware** - Mimics your project's coding style and patterns
 - **⚡ One-Click Workflow** - Generates copy-pasteable prompts ready for Build mode
@@ -66,6 +68,7 @@ Plan → Build → Enhancer → Plan
 ### Version Management
 
 - **Latest version**: `"opencode-enhancer-plugin@latest"`
+- **Current version**: `"opencode-enhancer-plugin@1.4.0"`
 - **Specific version**: `"opencode-enhancer-plugin@1.0.0"`
 - **Update**: OpenCode auto-updates plugins on startup, or run `opencode --update-plugins`
 
@@ -102,6 +105,37 @@ Remove from your `opencode.json`:
 4. **Receive enhanced prompt** - Structured markdown with context, instructions, and technical requirements
 5. **Copy & Execute** - Switch to Build mode and run the generated prompt
 
+## 📝 Changelog
+
+### v1.5.0 - Specialized Subagents
+- **📚 Librarian** - Documentation and research specialist with Context7 and Code Search
+- **🔮 Oracle** - Debugging and code architecture specialist
+- **🏗️ Architect** - Dependencies and system design specialist
+- **✅ Reviewer** - Plan validation specialist
+- **🎤 Interviewer** - Requirements clarification specialist
+- Optimized 4+1 subagent structure (4 specialists + 1 interviewer)
+- Simplified, focused prompts for better performance
+
+### v1.4.0 - Todo Enforcer & Strategos Mode
+- **🔒 Todo Enforcer System** - Tracks TODOs and prevents stopping until all tasks are completed (for ultraplan and strategos agents)
+- **🎯 Strategos Mode** - New primary agent with strategic planning and interview mode for complex multi-phase tasks
+- strategos-interviewer subagent for stakeholder requirement gathering
+- Enhanced hooks for session management and TODO tracking
+- Auto-activation of strategos mode on keyword detection
+
+### v1.2.0 - New Agents & Model Configuration
+- **ultraplan** & **ask** primary agents
+- **review-plan** subagent for critical analysis
+- Enhanced model configuration with environment variables
+
+### v1.0.0 - Initial Release
+- **enhancer** primary agent
+- **explore-context** subagent for project analysis
+- Intent classification and Context7 integration
+- Style-aware prompt generation
+
+---
+
 ## 🎨 Example Output
 
 ```markdown
@@ -133,11 +167,26 @@ use context7
 
 ### Components
 
-| Component | Type | Description |
-|-----------|------|-------------|
-| **Enhancer** | Primary Agent | Main interface, intent classification, prompt generation |
-| **Explore-Context** | Subagent | Read-only codebase analysis, tech stack detection |
-| **check_context7** | Tool | Decides if libraries need Context7 documentation |
+#### Primary Agents (User-Facing)
+Activated via `Tab` key in OpenCode:
+
+| Agent | Color | Steps | Description |
+|-------|-------|-------|-------------|
+| **enhancer** | Purple (#9C27B0) | 15 | Universal Technical Architect - analyzes intent and generates executable prompts |
+| **ultraplan** | Orange (#FF5722) | 20 | Iterative Planner with Todo Enforcement - creates plans through parallel subagent analysis and review loops |
+| **ask** | Blue (#2196F3) | 15 | Research Assistant - answers codebase questions via multi-source context gathering |
+| **strategos** | Deep Orange (#BF360C) | 30 | Strategic Planner with Interview Mode - handles complex multi-phase tasks with strategic planning and stakeholder interviews |
+
+#### Subagents (Background Workers)
+Called automatically by primary agents via `task` tool:
+
+| Subagent | Called By | Description |
+|----------|-----------|-------------|
+| **librarian** | All primary agents | Documentation and codebase research specialist (Context7 + codesearch) |
+| **oracle** | All primary agents | Debugging and code architecture specialist |
+| **architect** | ultraplan, strategos, ask | Dependencies and system design specialist |
+| **reviewer** | ultraplan, strategos | Plan validation and critical analysis specialist |
+| **interviewer** | strategos only | Requirements clarification and stakeholder interview specialist |
 
 ### Supported Tech Stacks
 
@@ -152,28 +201,120 @@ use context7
 
 ### Agent Configuration
 
-The plugin automatically registers both agents via the `config` hook:
+The plugin automatically registers agents via the `config` hook with **configurable models**:
 
 ```typescript
-// Enhancer (Primary Agent)
+// Enhancer (Primary Agent) - Model configurable via opencode.json or env vars
 {
   mode: "primary",
-  model: "opencode/kimi-k2.5-free",
+  model: "opencode/kimi-k2.5-free",  // Default, can be overridden
   description: "Universal Technical Architect & Prompt Enhancer",
   color: "#9C27B0",
   steps: 15,
   tools: { task: true, read: true }
 }
 
-// Explore-Context (Subagent)
+// Explore-Context (Subagent) - Model configurable via opencode.json or env vars
 {
   mode: "subagent",
   hidden: true,
-  model: "opencode/kimi-k2.5-free",
+  model: "opencode/kimi-k2.5-free",  // Default, can be overridden
   tools: { list: true, read: true, grep: true, bash: true }
 }
 ```
 
+### Model Configuration
+
+You can configure custom models for Enhancer agents. This is useful for:
+- Using more powerful models for complex planning tasks
+- Saving costs by using simpler models for subagents
+- Testing specific models for certain task types
+
+#### Configuration Methods (Priority: Highest → Lowest)
+
+##### 1. OpenCode Agent Config (Recommended)
+Configure models directly in your `opencode.json`:
+
+```json
+{
+  "agent": {
+    "strategos": {
+      "model": "anthropic/claude-sonnet-4-5"
+    },
+    "oracle": {
+      "model": "anthropic/claude-sonnet-4-5"
+    },
+    "librarian": {
+      "model": "opencode/kimi-k2.5-free"
+    }
+  }
+}
+```
+
+##### 2. Environment Variables
+Use environment variables for CI/CD or temporary changes:
+
+```bash
+# All Subagents
+export ENHANCER_MODEL_SUBAGENT="opencode/kimi-k2.5-free"
+
+# All Primary Agents  
+export ENHANCER_MODEL_PRIMARY="anthropic/claude-sonnet-4-5"
+
+# Specific Agent (highest priority among env vars)
+export ENHANCER_MODEL_STRATEGOS="anthropic/claude-opus-4"
+export ENHANCER_MODEL_ORACLE="anthropic/claude-sonnet-4-5"
+```
+
+#### Model Recommendations by Agent Type
+
+**Primary Agents** (Use stronger models for complex reasoning):
+
+| Agent | Recommended | Minimum | Purpose |
+|-------|-----------|---------|---------|
+| strategos | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Strategic planning with interview mode |
+| ultraplan | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Planning with todo enforcement |
+| enhancer | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Prompt enhancement & analysis |
+| ask | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Q&A and research |
+
+**Subagents** (Lightweight models sufficient for information gathering):
+
+| Subagent | Recommended | Minimum | Purpose |
+|----------|-------------|---------|---------|
+| librarian | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Documentation & research (Context7 + codesearch) |
+| oracle | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Debugging & code architecture |
+| architect | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Dependencies & system design |
+| reviewer | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Plan validation |
+| interviewer | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Requirements clarification |
+
+#### Validation
+
+The plugin validates configured models against known providers:
+- `opencode/*`
+- `anthropic/*`
+- `openai/*`
+- `google/*`
+- `mistral/*`
+- `cohere/*`
+- `ollama/*`
+
+Invalid models automatically fall back to the default (`opencode/kimi-k2.5-free`).
+
+#### 🎨 Ready-to-Use Templates
+
+Siehe [`MODEL-TEMPLATES.md`](./MODEL-TEMPLATES.md) für vorgefertigte Konfigurationen:
+
+- 🚀 **Performance First** - Beste Ergebnisse mit Claude
+- 💰 **Budget First** - Kosten sparen mit Kimi
+- ⚡ **Hybrid** - Intelligente Aufteilung nach Aufgabe
+- 🔧 **Custom Models** - OpenAI, Google, etc.
+
+**Quick-Start:**
+```bash
+# Hybrid Template (empfohlen für den Anfang)
+curl -s https://raw.githubusercontent.com/MaansenV/opencode-enhancer-plugin/main/MODEL-TEMPLATES.md | grep -A 50 "Template 3: Hybrid"
+```
+
 ### Context7 Integration
 
 The plugin automatically detects libraries that benefit from Context7:
@@ -201,9 +342,14 @@ opencode-enhancer-plugin/
 
 ### Hooks
 
-- **`config`** - Registers both agents on startup
-- **`tool.execute.before`** - Logs explore-context calls
-- **`message.updated`** - Appends Build mode hint to outputs
+- **`config`** - Registers agents on startup
+- **`tool.execute.before`** - Logs subagent calls
+- **`message.updated`** - Appends Build mode hint
+- **`message.completed`** - Extracts and stores TODOs
+- **`stop.requested`** - Prevents stop when TODOs are open
+- **`session.start`** - Manages todo store lifecycle
+- **`session.end`** - Manages todo store lifecycle
+- **`user.prompt.submitted`** - Auto-activates strategos mode on keywords
 
 ## 🤝 Contributing
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,eAAO,MAAM,cAAc,EAAE,MA0E5B,CAAA;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAqHjD,eAAO,MAAM,cAAc,EAAE,MAqwB5B,CAAA;AAED,eAAe,cAAc,CAAA"}