opencode-orchestrator 0.8.10 → 0.8.13

package/README.md

@@ -28,70 +28,202 @@ Multi-agent system that autonomously executes complex tasks. Commander delegates
 
 ---
 
-## 🏛️ Master Session Architecture
+## 🏛️ Architecture Overview
+
+### 🚀 User Flow Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                              👤 USER REQUEST                                    │
+│                           /task "Build a REST API"                              │
+└─────────────────────────────────────────────────────────────────────────────────┘
+                                       │
+                                       ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                    chat.message-handler.ts                                      │
+│  ┌────────────────────────────────────────────────────────────────────────────┐ │
+│  │ 1. Detect /task command                                                    │ │
+│  │ 2. Create SessionState in sessions Map                                     │ │
+│  │ 3. Call startMissionLoop() → Write .opencode/loop-state.json               │ │
+│  │ 4. Apply mission template + Inject prompt to Commander                     │ │
+│  └────────────────────────────────────────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────────────────────────┘
+                                       │
+                                       ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                       🎯 MASTER SESSION (Commander)                             │
+│                                                                                 │
+│    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    │
+│    │  1️⃣ THINK   │───▶│  2️⃣ PLAN   │───▶│ 3️⃣ DELEGATE │───▶│ 4️⃣ MONITOR  │    │
+│    │  Analyze    │    │  Create     │    │  Spawn      │    │  Watch      │    │
+│    │  request    │    │  TODO.md    │    │  Workers    │    │  progress   │    │
+│    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    │
+│                                                                                 │
+│    Core Systems Active:                                                         │
+│    • 🔄 SessionRecovery (auto error handling)                                   │
+│    • 📋 TodoContinuation (auto-resume on idle)                                  │
+│    • 🎖️ MissionSealHandler (completion detection)                               │
+│    • 📣 TaskToastManager (consolidated notifications)                           │
+└─────────────────────────────────────────────────────────────────────────────────┘
+                                       │
+                          delegate_task (background: true)
+                                       │
+            ┌──────────────────────────┼──────────────────────────┐
+            ▼                          ▼                          ▼
+┌────────────────────┐   ┌────────────────────┐   ┌────────────────────┐
+│ ⚡ Worker Session 1 │   │ ⚡ Worker Session 2 │   │ ⚡ Worker Session N │
+│    Agent: Planner  │   │    Agent: Worker   │   │   Agent: Reviewer  │
+├────────────────────┤   ├────────────────────┤   ├────────────────────┤
+│ • Independent exec │   │ • Independent exec │   │ • Read/Write       │
+│ • Read/Write       │   │ • Read/Write       │   │   .opencode/       │
+│   .opencode/       │   │   .opencode/       │   │ • Notify parent    │
+│ • Notify parent    │   │ • Notify parent    │   │   on complete      │
+│   on complete      │   │   on complete      │   └────────────────────┘
+└────────────────────┘   └────────────────────┘
+            │                          │                          │
+            └──────────────────────────┼──────────────────────────┘
+                                       ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                        📁 SHARED CONTEXT (.opencode/)                           │
+│                                                                                 │
+│   todo.md ◄── Planner creates │ Worker implements │ Reviewer checks ──▶ [x]    │
+│                                                                                 │
+│   ⚡ All sessions read/write this shared workspace                              │
+│   📊 Progress is tracked via todo.md checkboxes                                 │
+└─────────────────────────────────────────────────────────────────────────────────┘
+                                       │
+                                       ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                        🎖️ MISSION SEAL LOOP                                     │
+│                                                                                 │
+│   ┌───────────────────────────────────────────────────────────────────────────┐ │
+│   │                                                                           │ │
+│   │    session.idle event ──▶ Check for <mission_seal>SEALED</mission_seal>   │ │
+│   │           │                         │                                     │ │
+│   │           │                ┌────────┴────────┐                            │ │
+│   │           │                ▼                 ▼                            │ │
+│   │           │         [Seal Found]      [Not Found]                         │ │
+│   │           │               │                  │                            │ │
+│   │           │               ▼                  ▼                            │ │
+│   │           │      ✅ Mission Complete   iteration < max?                   │ │
+│   │           │         Clear state             │                             │ │
+│   │           │                          ┌──────┴──────┐                      │ │
+│   │           │                          ▼             ▼                      │ │
+│   │           │                        [YES]         [NO]                     │ │
+│   │           │                          │             │                      │ │
+│   │           │                          ▼             ▼                      │ │
+│   │           │               3s countdown toast  ⚠️ Max iterations           │ │
+│   │           │               Inject continuation     Force stop              │ │
+│   │           │                          │                                    │ │
+│   │           └──────────────────────────┘                                    │ │
+│   │                     LOOP                                                  │ │
+│   └───────────────────────────────────────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 📊 Project Architecture
 
 ```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                           👤 USER REQUEST                                   │
-│                        "/task Build a REST API"                             │
-└─────────────────────────────────────────────────────────────────────────────┘
-                                     │
-                                     ▼
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                    🎯 MASTER SESSION (Commander Agent)                      │
-│                                                                             │
-│  ┌───────────────────────────────────────────────────────────────────────┐  │
-│  │ 1️⃣ THINK     → Analyze request, assess complexity (L1/L2/L3)         │  │
-│  │ 2️⃣ PLAN      → Create .opencode/todo.md via Planner                  │  │
-│  │ 3️⃣ DELEGATE  → Spawn Worker Sessions via delegate_task              │  │
-│  │ 4️⃣ MONITOR   → Watch .opencode/ for progress, handle completions     │  │
-│  └───────────────────────────────────────────────────────────────────────┘  │
-│                                                                             │
-│  ┌─────────────────┐  ┌─────────────────────────────────────────────────┐  │
-│  │  Session State  │  │               4 CONSOLIDATED AGENTS             │  │
-│  │  Map<id,state>  │  │  🎯 Commander  📋 Planner                       │  │
-│  └─────────────────┘  │  🔨 Worker     ✅ Reviewer                       │  │
-│                       └─────────────────────────────────────────────────┘  │
-│  ┌─────────────────┐
-│  │  Plugin Hooks   │                                                       │
-│  │  event          │  ┌─────────────────────────────────────────────────┐  │
-│  │  chat.message   │  │ 🔄 SessionRecovery (auto error handling)        │  │
-│  │  tool.execute   │  │ 📋 TodoContinuation (auto-resume on idle)       │  │
-│  └─────────────────┘  │ 📣 TaskToastManager (consolidated notifications)│  │
-│                       └─────────────────────────────────────────────────┘  │
-└─────────────────────────────────────────────────────────────────────────────┘
-                                     │
-                        delegate_task (async)
-                                     │
-           ┌─────────────────────────┼─────────────────────────┐
-           ▼                         ▼                         ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                         OpenCode Orchestrator Plugin                            │
+│                              src/index.ts                                       │
+└─────────────────────────────────────────────────────────────────────────────────┘
+                                      │
+          ┌───────────────────────────┼───────────────────────────┐
+          ▼                           ▼                           ▼
+┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────────────────────┐
+│   Plugin Hooks      │  │   Core Systems      │  │         Tools               │
+│   plugin-handlers/  │  │   src/core/         │  │       src/tools/            │
+├─────────────────────┤  ├─────────────────────┤  ├─────────────────────────────┤
+│ • chat.message      │  │ • agents/           │  │ • parallel/                 │
+│ • event             │  │   ParallelManager   │  │   delegate_task             │
+│ • tool.execute      │  │   TaskStore         │  │   get_task_result           │
+│ • assistant.done    │  │   Concurrency       │  │ • web/                      │
+└─────────────────────┘  │ • loop/             │  │   webfetch, websearch       │
+                         │   MissionSeal       │  │ • background-cmd/           │
+                         │   TodoContinuation  │  │   run_background            │
+                         │ • recovery/         │  │ • search                    │
+                         │   SessionRecovery   │  │   grep, glob, mgrep         │
+                         │ • notification/     │  └─────────────────────────────┘
+                         │   Toast, Manager    │
+                         │ • session/          │
+                         │   SharedContext     │
+                         │ • cache/            │
+                         │   DocumentCache     │
+                         └─────────────────────┘
+                                      │
+          ┌───────────────────────────┼───────────────────────────┐
+          ▼                           ▼                           ▼
 ┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────────────┐
-│  ⚡ Worker Session 1 │  │  ⚡ Worker Session 2 │  │  ⚡ Worker Session N │
-│  Agent: Planner     │  │  Agent: Worker      │  │  Agent: Reviewer    │
-│                     │  │                     │  │                     │
-│  • Independent exec │  │  • Independent exec │  │  • Independent exec │
-│  • Read/Write       │  │  • Read/Write       │  │  • Read/Write       │
-│    .opencode/       │  │    .opencode/       │  │    .opencode/       │
-│  • Notify parent    │  │  • Notify parent    │  │  • Notify parent    │
-│    on complete      │  │    on complete      │  │    on complete      │
+│   🎯 Commander       │  │   📋 Planner        │  │   🔨 Worker          │
+│   Orchestrator      │  │   Research+Plan     │  │   Implementation    │
+├─────────────────────┤  ├─────────────────────┤  ├─────────────────────┤
+│ • Mission control   │  │ • Task decompose    │  │ • Code writing      │
+│ • Parallel delegate │  │ • Doc research      │  │ • File operations   │
+│ • TODO monitoring   │  │ • TODO creation     │  │ • Command execution │
 └─────────────────────┘  └─────────────────────┘  └─────────────────────┘
-           │                         │                         │
-           └─────────────────────────┼─────────────────────────┘
-                                     ▼
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                    📁 SHARED CONTEXT (.opencode/)                           │
-│                                                                             │
-│  .opencode/todo.md     ← Master TODO (Planner creates, Reviewer updates)  │
-│  .opencode/context.md  ← Adaptive context (shrinks as progress increases)  │
-│  .opencode/docs/       ← Cached docs (Planner/Worker save, auto-expire)    │
-│  .opencode/archive/    ← Old context for reference                         │
-│                                                                             │
-│  ⚡ All sessions read/write this shared workspace                           │
-│  📊 Progress is tracked via todo.md checkboxes                              │
-└─────────────────────────────────────────────────────────────────────────────┘
+          │                           │                           │
+          │                           │                           │
+          │                  ┌────────┴────────┐                  │
+          │                  ▼                 │                  │
+          │       ┌─────────────────────┐      │                  │
+          │       │   ✅ Reviewer        │      │                  │
+          │       │   Quality+Context   │      │                  │
+          │       ├─────────────────────┤      │                  │
+          │       │ • Verification      │      │                  │
+          │       │ • TODO updates      │      │                  │
+          │       │ • Context manage    │      │                  │
+          │       └─────────────────────┘      │                  │
+          │                  │                 │                  │
+          └──────────────────┼─────────────────┴──────────────────┘
+                             ▼
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                        📁 Shared Workspace (.opencode/)                         │
+├─────────────────────────────────────────────────────────────────────────────────┤
+│  todo.md          │ Hierarchical task list (Epic → Task → Subtask)             │
+│  context.md       │ Adaptive context (shrinks with progress)                   │
+│  loop-state.json  │ Mission loop iteration state                               │
+│  docs/            │ Cached documentation (auto-expire)                         │
+│  archive/         │ Old context snapshots                                      │
+└─────────────────────────────────────────────────────────────────────────────────┘
+```
+
+
+### 📂 Directory Structure
+
+```
+src/
+├── index.ts                      # Plugin main entry point
+├── agents/
+│   ├── commander.ts              # Commander agent definition
+│   ├── definitions.ts            # Agent exports
+│   ├── prompts/                  # Prompt fragments (commander/, planner/, worker/, reviewer/)
+│   └── subagents/                # Subagent definitions (planner.ts, worker.ts, reviewer.ts)
+├── core/
+│   ├── agents/                   # ParallelAgentManager, TaskStore, ConcurrencyController
+│   ├── cache/                    # DocumentCache
+│   ├── loop/                     # MissionSeal, TodoContinuation, TodoEnforcer
+│   ├── notification/             # Toast, TaskToastManager
+│   ├── recovery/                 # SessionRecovery, ErrorPatterns
+│   ├── session/                  # SharedContext
+│   └── task/                     # TaskScheduler, TaskParser
+├── plugin-handlers/
+│   ├── chat-message-handler.ts   # /task detection, mission start
+│   ├── event-handler.ts          # session.idle, session.error handling
+│   ├── tool-execute-handler.ts   # Tool completion tracking
+│   └── assistant-done-handler.ts # Response completion
+├── shared/
+│   ├── constants/                # PATHS, TOOL_NAMES, MISSION_SEAL, etc.
+│   ├── agent/                    # Agent definitions, names
+│   └── errors/                   # Error types
+├── tools/
+│   ├── parallel/                 # delegate_task, get_task_result, list_tasks, cancel_task
+│   ├── web/                      # webfetch, websearch, codesearch, cache_docs
+│   ├── background-cmd/           # run_background, check_background, list_background
+│   └── search.ts                 # grep_search, glob_search, mgrep
+└── utils/                        # Utility functions
 ```
 
----
 
 ## Installation
 
@@ -127,9 +259,17 @@ Use `/task` when you need the AI to **complete a mission autonomously**:
 **What Commander Mode Does:**
 - ♾️ **Runs until sealed** — Loops until agent outputs `<mission_seal>SEALED</mission_seal>`
 - 🧠 **Anti-Hallucination** — Researches docs before coding
-- ⚡ **Parallel Execution** — Up to 50 concurrent agents
-- 🔄 **Auto-Recovery** — Handles errors automatically
-- 📊 **Triage System** — Adapts strategy to complexity (L1/L2/L3)
+- ⚡ **Parallel Execution** — Up to 50 concurrent Worker Sessions
+- 🔄 **Auto-Recovery** — Handles errors automatically with pattern matching
+- 📊 **Progress Tracking** — Monitors TODO completion and shows progress
+
+**Concurrency Limits (per agent type):**
+| Agent | Max Concurrent | Purpose |
+|--------|---------------|-----------|
+| Commander | 1 | Single orchestrator per mission |
+| Planner | 3 | Research and TODO planning |
+| Worker | 10 | Implementation tasks |
+| Reviewer | 5 | Verification and testing |
 
 **🎖️ Mission Seal Loop:**
 ```
@@ -172,7 +312,65 @@ What's the difference between useState and useReducer?
 
 ---
 
-## The 7 Agents
+## 🔄 Mission Loop Mechanism
+
+The Commander uses an event-driven mission loop to autonomously complete missions:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                  MISSION LOOP LIFECYCLE                       │
+└─────────────────────────────────────────────────────────────────┘
+
+1️⃣ User sends "/task 'mission'"
+    ↓
+2️⃣ chat.message handler detects /task
+    ↓
+3️⃣ Create session + startMissionLoop()
+    ↓
+    Write .opencode/loop-state.json:
+    {
+      "active": true,
+      "sessionID": "ses_abc",
+      "iteration": 1,
+      "maxIterations": 20
+    }
+    ↓
+4️⃣ Commander receives prompt → delegates work
+    ↓
+5️⃣ Worker sessions execute → results collected
+    ↓
+6️⃣ session.idle event triggers
+    ↓
+    Check for <mission_seal>SEALED</mission_seal>
+    ├─ Seal found? → Clear loop state → Complete ✅
+    └─ Not found? → Increment iteration → Continue loop
+         ↓
+         Show countdown toast (3 seconds)
+         ↓
+         Inject continuation prompt
+         ↓
+         [Loop back to step 4]
+```
+
+**Key Loop Components:**
+
+| Component | File | Purpose |
+|-----------|-------|---------|
+| Loop State | `src/core/loop/mission-seal.ts` | State management (.opencode/loop-state.json) |
+| Seal Detection | `src/core/loop/mission-seal-handler.ts` | Detect `<mission_seal>` in responses |
+| Continuation | `src/core/loop/mission-seal-handler.ts` | Inject prompts to continue work |
+| Countdown | `src/core/loop/mission-seal-handler.ts` | 3-second countdown toast |
+| Idle Handler | `src/plugin-handlers/assistant-done-handler.ts` | Monitor session.idle events |
+
+**Why Event-Driven?**
+- No fixed iteration limits - loop continues until sealed
+- Resilient to network delays
+- Can be interrupted by user at any time
+- Efficient polling (500ms interval with backoff)
+
+---
+
+## The 4 Agents
 
 | Agent            | Role         | Responsibility                     |
 | :--------------- | :----------- | :--------------------------------- |
@@ -210,7 +408,7 @@ What's the difference between useState and useReducer?
 | Notifications | 100/parent | FIFO eviction |
 | Event History | 100 | Ring buffer |
 | Session TTL | 60 min | Auto cleanup |
-| Poll Interval | 1 second | Fast completion detection |
+| Poll Interval | 500ms | Fast completion detection |
 | Max Poll Count | 600 | Hard limit prevents infinite loops |
 | Sync Timeout | 5 min | Safe delegate_task timeout |
 | Recovery Attempts | 3 | Auto session error recovery |
@@ -238,9 +436,9 @@ Automatic recovery from common errors:
 
 ### Todo Continuation
 - Monitors `session.idle` events
-- 2-second countdown before auto-continuation
+- 3-second countdown toast before auto-continuation
 - Cancels on user interaction
-- Skips if background tasks running
+- Skips if background tasks running or session is recovering
 
 ### noReply Optimization
 - Individual task completion: `noReply: true` (saves tokens)
@@ -274,9 +472,9 @@ tail -f "$(node -e 'console.log(require("os").tmpdir())')/opencode-orchestrator.
 ## Documentation
 
 - **[System Architecture](docs/SYSTEM_ARCHITECTURE.md)** — Detailed technical docs
-- **[OpenCode SDK Reference](docs/OPENCODE_SDK_REFERENCE.md)** — API usage reference
+- **[Architecture and Flow](docs/ARCHITECTURE_AND_FLOW.md)** — Complete architecture guide with scenarios
+- **[Improvement Suggestions](docs/IMPROVEMENT_SUGGESTIONS.md)** — Project improvement recommendations
 - [Release Notes](docs/releases/) — Version history
-- [Troubleshooting](docs/PLUGIN_TROUBLESHOOTING.md)
 
 ---
 

package/dist/agents/commander.d.ts

@@ -1,2 +1,8 @@
+/**
+ * Commander Agent
+ *
+ * Master orchestrator with parallel execution capabilities.
+ * Uses modular prompt fragments for flexible composition.
+ */
 import { AgentDefinition } from "../shared/agent.js";
 export declare const commander: AgentDefinition;

package/dist/agents/prompts/commander/agents.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Agent Delegation
+ */
+export declare const COMMANDER_AGENTS: string;

package/dist/agents/prompts/commander/execution.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Execution Strategy
+ */
+export declare const COMMANDER_EXECUTION: string;

package/dist/agents/prompts/commander/forbidden.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Forbidden Actions
+ */
+export declare const COMMANDER_FORBIDDEN: string;

package/dist/agents/prompts/commander/identity.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Identity
+ */
+export declare const COMMANDER_IDENTITY = "<identity>\n- You are the ORCHESTRATOR, not the implementer\n- You DELEGATE work to specialized agents\n- You COORDINATE parallel execution\n- You VERIFY completion before sealing\n- You are RELENTLESS - never stop mid-mission\n</identity>";

package/dist/agents/prompts/commander/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Commander Prompts - Index
+ */
+export { COMMANDER_ROLE } from "./role.js";
+export { COMMANDER_IDENTITY } from "./identity.js";
+export { COMMANDER_FORBIDDEN } from "./forbidden.js";
+export { COMMANDER_REQUIRED } from "./required.js";
+export { COMMANDER_TOOLS } from "./tools.js";
+export { COMMANDER_EXECUTION } from "./execution.js";
+export { COMMANDER_PARALLEL } from "./parallel.js";
+export { COMMANDER_AGENTS } from "./agents.js";
+export { COMMANDER_TODO_FORMAT } from "./todo-format.js";

package/dist/agents/prompts/commander/parallel.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Parallel Execution
+ */
+export declare const COMMANDER_PARALLEL: string;

package/dist/agents/prompts/commander/required.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Required Actions
+ */
+export declare const COMMANDER_REQUIRED: string;

package/dist/agents/prompts/commander/role.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Role Definition
+ */
+export declare const COMMANDER_ROLE = "<role>\nYou are Commander. Autonomous mission controller with parallel execution.\nYou NEVER stop until the mission is SEALED. You are RELENTLESS.\nYou ORCHESTRATE - you delegate, coordinate, and verify.\n</role>";

package/dist/agents/prompts/commander/todo-format.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander TODO Format - Hierarchical
+ */
+export declare const COMMANDER_TODO_FORMAT: string;

package/dist/agents/prompts/commander/tools.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Commander Tools Overview
+ */
+export declare const COMMANDER_TOOLS: string;

package/dist/agents/prompts/common/anti-hallucination.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Anti-Hallucination Rules
+ *
+ * Core rules to prevent LLM from making up information.
+ */
+export declare const ANTI_HALLUCINATION_CORE = "<anti_hallucination>\n ZERO TOLERANCE FOR GUESSING\n\nBEFORE ANY IMPLEMENTATION:\n1. Check .opencode/docs/ for cached documentation\n2. If not found \u2192 websearch for OFFICIAL docs\n3. webfetch with cache=true\n4. Use EXACT syntax from docs\n\nTRUSTED SOURCES ONLY:\n- Official docs: docs.[framework].com\n- GitHub: github.com/[org]/[repo]\n- Package registries: npmjs.com, pypi.org\n\n FORBIDDEN:\n- Inventing function signatures\n- Assuming API compatibility\n- Guessing version-specific syntax\n- Using outdated knowledge\n\n REQUIRED:\n- Source URL for every claim\n- Confidence level: HIGH (official) / MEDIUM (github) / LOW (blog)\n- Say \"NOT FOUND\" if documentation unavailable\n</anti_hallucination>";

package/dist/agents/prompts/common/environment-discovery.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Environment Discovery Prompt
+ *
+ * PHASE 0: Mandatory first step - understand project before ANY action
+ */
+export declare const ENVIRONMENT_DISCOVERY = "<environment_discovery>\n MANDATORY FIRST STEP - Before any planning or coding:\n\n## 1. Project Structure Analysis\n- Read file tree: ls -la, find . -type f -name \"*.ts\" | head -50\n- Identify: src/, tests/, docs/, config files\n- Check for: package.json, Dockerfile, docker-compose.yml, Makefile\n\n## 2. Build Environment Detection\n| Check | Command | Look For |\n|-------|---------|----------|\n| Node.js | cat package.json | scripts.build, scripts.test |\n| Docker | ls Dockerfile* | Multi-stage build, base image |\n| Make | cat Makefile | build, test, deploy targets |\n| Rust | cat Cargo.toml | [package], [dependencies] |\n\n## 3. Documentation Review\n- README.md \u2192 Project overview, setup instructions\n- CONTRIBUTING.md \u2192 Code standards, PR process\n- docs/ \u2192 Architecture, API docs\n- .opencode/ \u2192 Existing context, todos\n\n## 4. Context Summary (SAVE TO .opencode/context.md)\n```markdown\n# Project Context\n## Environment\n- Runtime: [Node.js 20 / Python 3.11 / Rust 1.75]\n- Build: [npm / Docker / Make]\n- Test: [npm test / pytest / cargo test]\n\n## Structure\n- Source: src/\n- Tests: tests/\n- Docs: docs/\n\n## Key Files\n- Entry: [src/index.ts]\n- Config: [tsconfig.json, package.json]\n\n## Conventions\n- [observed patterns from existing code]\n```\n\nNEVER skip this step. NEVER assume without checking.\n</environment_discovery>";

package/dist/agents/prompts/common/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Common Prompts - Index
+ *
+ * Re-exports all common prompt fragments.
+ */
+export { ENVIRONMENT_DISCOVERY } from "./environment-discovery.js";
+export { ANTI_HALLUCINATION_CORE } from "./anti-hallucination.js";
+export { TODO_RULES } from "./todo-rules.js";
+export { SHARED_WORKSPACE } from "./shared-workspace.js";
+export { MISSION_SEAL_RULES } from "./mission-seal.js";
+export { VERIFICATION_REQUIREMENTS } from "./verification.js";

package/dist/agents/prompts/common/mission-seal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mission Seal Rules
+ *
+ * Requirements for completing and sealing a mission.
+ */
+export declare const MISSION_SEAL_RULES: string;

package/dist/agents/prompts/common/shared-workspace.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared Workspace Configuration
+ *
+ * Defines the .opencode/ directory structure.
+ */
+export declare const SHARED_WORKSPACE = "<shared_workspace>\n .opencode/ - Shared Context Directory\n\n```\n.opencode/\n\u251C\u2500\u2500 todo.md       - Master task list\n\u251C\u2500\u2500 context.md    - Project context summary\n\u251C\u2500\u2500 docs/         - Cached documentation\n\u2502   \u251C\u2500\u2500 [topic].md\n\u2502   \u2514\u2500\u2500 ...\n\u2514\u2500\u2500 archive/      - Old context\n```\n\nRULES:\n- ALL agents share this workspace\n- context.md < 150 lines (compress if larger)\n- docs/ = official documentation ONLY\n- todo.md = single source of truth for tasks\n</shared_workspace>";

package/dist/agents/prompts/common/todo-rules.d.ts

@@ -0,0 +1,6 @@
+/**
+ * TODO Rules - Hierarchical Structure
+ *
+ * Three-level TODO system with completion rollup.
+ */
+export declare const TODO_RULES: string;

package/dist/agents/prompts/common/verification.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Verification Requirements
+ *
+ * Checklist for verifying code before marking complete.
+ */
+export declare const VERIFICATION_REQUIREMENTS = "<verification>\n VERIFICATION CHECKLIST\n\n## Code Verification\n\u25A1 lsp_diagnostics clean (no errors)\n\u25A1 Build passes (npm run build)\n\u25A1 Tests pass (npm test)\n\u25A1 No TypeScript 'any' types\n\u25A1 No console.log debugging left\n\n## Documentation Verification\n\u25A1 Implementation matches .opencode/docs/\n\u25A1 API usage matches official docs\n\u25A1 Version compatibility confirmed\n\n## Security Verification\n\u25A1 No hardcoded secrets/passwords\n\u25A1 Input validation present\n\u25A1 Error messages don't leak info\n\nONLY mark complete after ALL checks pass!\n</verification>";

package/dist/agents/prompts/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Prompts - Index
+ *
+ * Exports all modular prompt fragments.
+ * Structure: 1 folder per agent/category, 1 file per const
+ */
+export * from "./common/index.js";
+export * from "./commander/index.js";
+export * from "./planner/index.js";
+export * from "./worker/index.js";
+export * from "./reviewer/index.js";

package/dist/agents/prompts/planner/forbidden.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Planner Forbidden Actions
+ */
+export declare const PLANNER_FORBIDDEN = "<forbidden_actions>\nNEVER implement code - only plan and research\nNEVER guess API syntax - always verify with official docs\nNEVER create TODO without parallel groups\nNEVER claim knowledge without source URL\nNEVER assume version compatibility\nNEVER create TODOs with [x] already marked\nNEVER skip environment discovery\n</forbidden_actions>";

package/dist/agents/prompts/planner/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Planner Prompts - Index
+ */
+export { PLANNER_ROLE } from "./role.js";
+export { PLANNER_FORBIDDEN } from "./forbidden.js";
+export { PLANNER_REQUIRED } from "./required.js";
+export { PLANNER_TODO_FORMAT } from "./todo-format.js";
+export { PLANNER_RESEARCH } from "./research.js";

package/dist/agents/prompts/planner/required.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Planner Required Actions
+ */
+export declare const PLANNER_REQUIRED = "<required_actions>\nALWAYS analyze project structure first\nALWAYS cite sources with URLs\nALWAYS maximize parallelism in TODO\nALWAYS include confidence level (HIGH/MEDIUM/LOW)\nALWAYS save docs to .opencode/docs/\nALWAYS include task dependencies explicitly\nALWAYS create tasks with [ ] (unchecked)\n</required_actions>";

package/dist/agents/prompts/planner/research.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Planner Research Workflow
+ */
+export declare const PLANNER_RESEARCH = "<research_workflow>\n1. websearch \"[topic] official documentation [version]\"\n2. webfetch official URL with cache=true\n3. Extract EXACT syntax (not paraphrased)\n4. Save to .opencode/docs/[topic].md\n\nOUTPUT:\n```markdown\n# Research: [topic]\nSource: [official URL]\nConfidence: HIGH/MEDIUM/LOW\nVersion: [version]\n\n## Exact Syntax\n```[lang]\n[code from official docs]\n```\n```\n</research_workflow>";

package/dist/agents/prompts/planner/role.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Planner Role
+ */
+export declare const PLANNER_ROLE: string;

package/dist/agents/prompts/planner/todo-format.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Planner TODO Format - Hierarchical
+ */
+export declare const PLANNER_TODO_FORMAT: string;

package/dist/agents/prompts/reviewer/forbidden.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Reviewer Forbidden Actions
+ */
+export declare const REVIEWER_FORBIDDEN: string;

package/dist/agents/prompts/reviewer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reviewer Prompts - Index
+ */
+export { REVIEWER_ROLE } from "./role.js";
+export { REVIEWER_FORBIDDEN } from "./forbidden.js";
+export { REVIEWER_REQUIRED } from "./required.js";
+export { REVIEWER_VERIFICATION } from "./verification.js";
+export { REVIEWER_TODO_UPDATE } from "./todo-update.js";
+export { REVIEWER_OUTPUT } from "./output.js";

package/dist/agents/prompts/reviewer/output.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Reviewer Output Format
+ */
+export declare const REVIEWER_OUTPUT: string;

package/dist/agents/prompts/reviewer/required.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Reviewer Required Actions
+ */
+export declare const REVIEWER_REQUIRED = "<required_actions>\nALWAYS run lsp_diagnostics\nALWAYS run build command (npm run build)\nALWAYS run test command (npm test)\nALWAYS check implementation matches .opencode/docs/\nALWAYS update .opencode/todo.md checkboxes ONLY after verification\nALWAYS provide PASS/FAIL with evidence\nALWAYS check for security issues\nALWAYS verify tests exist for new code\n</required_actions>";