opencode-orchestrator 0.8.22 → 0.9.1

package/README.md

@@ -57,40 +57,45 @@ A multi-agent system that **autonomously executes complex tasks** from start to
 ## 🚀 How It Works
 
 ```
-👤 You: /task "Build a REST API with authentication"
+                    /task "Build REST API"
                               │
                               ▼
-              ┌───────────────────────────────┐
-              │      🎯 COMMANDER             │ ← Master Session
-              │   Creates TODO, delegates     │
-              └───────────────────────────────┘
+             ┌────────────────────────────────┐
+             │         🎯 COMMANDER           │
+             │  Read state → Delegate → Loop  │
+             └────────────────────────────────┘
                               │
-       ┌──────────────────────┼──────────────────────┐
-       ▼                      ▼                      ▼
-  ┌─────────┐           ┌─────────┐           ┌─────────┐
-  │ PLANNER │           │ WORKER  │           │ WORKER  │
-  │ ses_001 │           │ ses_002 │           │ ses_003 │   ⚡ PARALLEL
-  └─────────┘           └─────────┘           └─────────┘      SESSIONS
-       │                      │                      │
-       │    ┌─────────────────┴─────────────────┐    │
-       │    │  🔄 Background: npm install, test │    │   ⏳ NON-BLOCKING
-       │    └───────────────────────────────────┘    │
-       └──────────────────────┼──────────────────────┘
+      ┌───────────────────────┼───────────────────────┐
+      ▼                       ▼                       ▼
+ ┌─────────┐            ┌─────────┐            ┌─────────┐
+ │ PLANNER │            │ WORKER  │            │ WORKER  │    ⚡ PARALLEL
+ │ Plan it │            │ Build A │            │ Build B │       EXECUTION
+ └─────────┘            └─────────┘            └─────────┘
+      │                       │                       │
+      └───────────────────────┼───────────────────────┘
                               ▼
-              ┌───────────────────────────────┐
-              │      ✅ REVIEWER              │
-              │   Verifies, updates TODOs     │
-              └───────────────────────────────┘
+             ┌────────────────────────────────┐
+             │         ✅ REVIEWER            │
+             │       Verify → Sync            │
+             └────────────────────────────────┘
                               │
-                    ┌─────────┴─────────┐
-                    │  TODOs remain?    │
-                    └─────────┬─────────┘
+                   ┌──────────┴──────────┐
+                   │  TODO incomplete?   │
+                   │  Sync issues?       │
+                   └──────────┬──────────┘
                         Yes ↓     ↓ No
-                     ♻️ LOOP    🎖️ SEALED
-                      BACK       (done!)
+                    ♻️ LOOP    🎖️ SEALED
 ```
 
-**♾️ Runs until complete** — Keeps looping until ALL TODOs are checked, then seals the mission.
+### 🔑 Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| **♾️ Infinite Loop** | Keeps running until ALL TODOs [x] AND no sync issues |
+| **🔧 TDD Isolation** | Each Worker = 1 file. Test → Build → Delete test |
+| **📂 Shared State** | `.opencode/` = single source of truth for all agents |
+| **🔄 E2E at End** | Integration tests run when TODO nearly complete |
+
 
 ---
 

package/dist/agents/commander.d.ts

@@ -2,7 +2,8 @@
  * Commander Agent
  *
  * Master orchestrator with parallel execution capabilities.
- * Uses modular prompt fragments for flexible composition.
+ * Reads shared state (.opencode/) for loop continuation.
+ * Handles sync issues by instructing Planner and Workers.
  */
 import type { AgentDefinition } from "../shared/agent/interfaces/index.js";
 export declare const commander: AgentDefinition;

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

@@ -10,3 +10,5 @@ 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";
+export { COMMANDER_LOOP_CONTINUATION } from "./loop-continuation.js";
+export { COMMANDER_SYNC_HANDLING } from "./sync-handling.js";

package/dist/agents/prompts/commander/loop-continuation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Commander Loop Continuation
+ *
+ * Logic for reading shared state and continuing work loop.
+ */
+export declare const COMMANDER_LOOP_CONTINUATION: string;

package/dist/agents/prompts/commander/sync-handling.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Commander Sync Issue Handling
+ *
+ * How Commander reads sync issues and instructs agents to fix.
+ */
+export declare const COMMANDER_SYNC_HANDLING: string;

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

@@ -3,4 +3,4 @@
  *
  * 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>";
+export declare const SHARED_WORKSPACE: string;

package/dist/agents/prompts/planner/file-planning.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Planner File-Level Planning
+ *
+ * Plans work at FILE LEVEL - listing all files to create/modify/delete.
+ */
+export declare const PLANNER_FILE_PLANNING: string;

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

@@ -6,3 +6,5 @@ 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";
+export { PLANNER_FILE_PLANNING } from "./file-planning.js";
+export { PLANNER_TODO_SYNC } from "./todo-sync.js";

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

@@ -0,0 +1,6 @@
+/**
+ * Planner TODO Sync
+ *
+ * Syncs TODO list based on Commander instructions after sync issues.
+ */
+export declare const PLANNER_TODO_SYNC: string;

package/dist/agents/prompts/reviewer/async-monitoring.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reviewer Async Monitoring
+ *
+ * Asynchronous monitoring of parallel worker sessions.
+ */
+export declare const REVIEWER_ASYNC_MONITORING: string;

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

@@ -7,3 +7,6 @@ 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";
+export { REVIEWER_ASYNC_MONITORING } from "./async-monitoring.js";
+export { REVIEWER_INTEGRATION_TESTING } from "./integration-testing.js";
+export { REVIEWER_SYNC_VERIFICATION } from "./sync-verification.js";

package/dist/agents/prompts/reviewer/integration-testing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Reviewer Integration Testing
+ *
+ * E2E testing when TODO is almost done or at the end.
+ * Language-agnostic.
+ */
+export declare const REVIEWER_INTEGRATION_TESTING: string;

package/dist/agents/prompts/reviewer/sync-verification.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reviewer Sync Verification
+ *
+ * Verify file synchronization and report issues for next iteration.
+ */
+export declare const REVIEWER_SYNC_VERIFICATION: string;

package/dist/agents/prompts/worker/file-assignment.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Worker File Assignment
+ *
+ * How Worker receives and processes file-level assignments.
+ */
+export declare const WORKER_FILE_ASSIGNMENT: string;

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

@@ -6,3 +6,6 @@ export { WORKER_FORBIDDEN } from "./forbidden.js";
 export { WORKER_REQUIRED } from "./required.js";
 export { WORKER_WORKFLOW } from "./workflow.js";
 export { WORKER_QUALITY } from "./quality.js";
+export { WORKER_TDD_WORKFLOW } from "./tdd-workflow.js";
+export { WORKER_ISOLATION_TESTING } from "./isolation-testing.js";
+export { WORKER_FILE_ASSIGNMENT } from "./file-assignment.js";

package/dist/agents/prompts/worker/isolation-testing.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Worker Isolation Testing Rules
+ *
+ * Rules for creating isolated unit tests that test ONLY the target file.
+ */
+export declare const WORKER_ISOLATION_TESTING: string;

package/dist/agents/prompts/worker/tdd-workflow.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Worker TDD Workflow
+ *
+ * Test-Driven Development workflow for file-level isolated work.
+ * Language-agnostic - works with any programming language.
+ */
+export declare const WORKER_TDD_WORKFLOW: string;

package/dist/agents/subagents/planner.d.ts

@@ -2,7 +2,8 @@
  * Planner Agent (Subagent)
  *
  * Strategic planning and research specialist.
- * Uses modular prompt fragments for flexible composition.
+ * FILE-LEVEL planning - lists all files to create/modify/delete.
+ * TODO sync - updates TODO based on Commander instructions.
  */
 import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
 export declare const planner: AgentDefinition;

package/dist/agents/subagents/reviewer.d.ts

@@ -3,7 +3,7 @@
  *
  * Verification specialist and gatekeeper.
  * ONLY agent authorized to mark [x] in TODO after verification.
- * Uses modular prompt fragments for flexible composition.
+ * Async monitoring of parallel workers, integration testing, sync verification.
  */
 import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
 export declare const reviewer: AgentDefinition;

package/dist/agents/subagents/worker.d.ts

@@ -1,8 +1,9 @@
 /**
  * Worker Agent (Subagent)
  *
- * Implementation and documentation specialist.
- * Uses modular prompt fragments for flexible composition.
+ * Implementation specialist with TDD-based file-level isolated work.
+ * Reads .opencode for assignments and shared state.
+ * Follows Commander instructions for sync fixes.
  */
 import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
 export declare const worker: AgentDefinition;