opencode-enhancer-plugin 1.0.1 → 1.4.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,28 @@ 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.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 +158,27 @@ 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 |
+|----------|-----------|-------------|
+| **explore-context** | enhancer, ultraplan, ask | Maps project structure, detects tech stack, identifies entry points |
+| **explore-code** | enhancer, ultraplan, ask | Deep-dive source code analysis for relevant files and patterns |
+| **explore-deps** | enhancer, ultraplan, ask | Analyzes dependencies, imports, and external libraries |
+| **explore-tests** | ultraplan, ask (for TEST intent) | Discovers test framework, patterns, and existing coverage |
+| **review-plan** | ultraplan only | Critical analysis of implementation plans during review loop |
+| **strategos-interviewer** | strategos only | Conducts stakeholder interviews to gather strategic requirements and constraints |
 
 ### Supported Tech Stacks
 
@@ -152,28 +193,101 @@ 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": {
+    "review-plan": {
+      "model": "anthropic/claude-sonnet-4-5"
+    },
+    "enhancer": {
+      "model": "anthropic/claude-sonnet-4-5"
+    }
+  }
+}
+```
+
+##### 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_REVIEW_PLAN="anthropic/claude-opus-4"
+export ENHANCER_MODEL_ENHANCER="anthropic/claude-sonnet-4-5"
+```
+
+#### Model Recommendations by Agent Type
+
+**Primary Agents** (Use stronger models for complex reasoning):
+
+| Agent | Recommended | Minimum | Purpose |
+|-------|-----------|---------|---------|
+| enhancer | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Intent classification & prompt generation |
+| ultraplan | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Iterative planning with review loops |
+| ask | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Multi-source research & synthesis |
+
+**Subagents** (Lightweight models sufficient for information gathering):
+
+| Subagent | Recommended | Minimum | Purpose |
+|----------|-------------|---------|---------|
+| review-plan | anthropic/claude-sonnet-4-5 | opencode/kimi-k2.5-free | Critical plan analysis (called by ultraplan) |
+| explore-context | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Project structure mapping |
+| explore-code | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Source code analysis |
+| explore-deps | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Dependency analysis |
+| explore-tests | opencode/kimi-k2.5-free | opencode/kimi-k2.5-free | Test pattern discovery |
+
+#### 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`).
+
 ### Context7 Integration
 
 The plugin automatically detects libraries that benefit from Context7:
@@ -201,9 +315,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;AAmHjD,eAAO,MAAM,cAAc,EAAE,MA8xB5B,CAAA;AAED,eAAe,cAAc,CAAA"}