opencode-orchestrator 1.0.23 → 1.0.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +89 -152
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,194 +1,131 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<img src="assets/logo.png" alt="logo" width="
|
|
2
|
+
<img src="assets/logo.png" alt="logo" width="200" />
|
|
3
3
|
<h1>OpenCode Orchestrator</h1>
|
|
4
4
|
|
|
5
|
-
<p
|
|
6
|
-
<p><i>Redefining Scalability with Fractal Swarm Intelligence and Multi-Stage Integrity</i></p>
|
|
5
|
+
<p>Autonomous Multi-Agent Orchestration Engine for Software Engineering</p>
|
|
7
6
|
|
|
8
|
-
[](LICENSE)
|
|
9
8
|
[](https://www.npmjs.com/package/opencode-orchestrator)
|
|
10
|
-
[]()
|
|
11
9
|
</div>
|
|
12
10
|
|
|
13
11
|
---
|
|
14
12
|
|
|
13
|
+
## Overview
|
|
14
|
+
|
|
15
|
+
OpenCode Orchestrator is a framework designed to manage complex software engineering tasks through parallel multi-agent execution. It extends the capabilities of standard AI agents by introducing a hierarchical delegation model and a multi-stage verification pipeline.
|
|
16
|
+
|
|
17
|
+
### Key Characteristics
|
|
18
|
+
* **Parallel Execution**: Manages multiple concurrent agent sessions to accelerate development.
|
|
19
|
+
* **Hierarchical Delegation**: Supports recursive task decomposition (Fractal Spawning) for complex requirements.
|
|
20
|
+
* **Integrated Verification**: Employs a multi-stage pipeline (Unit & Integration) to ensure code quality.
|
|
21
|
+
* **Persistent State**: Uses structured logging to maintain state and recover from interruptions.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
15
25
|
## ⚡ Quick Start
|
|
16
26
|
|
|
17
27
|
```bash
|
|
18
28
|
npm install -g opencode-orchestrator
|
|
19
29
|
```
|
|
20
30
|
|
|
21
|
-
|
|
31
|
+
In an OpenCode environment:
|
|
22
32
|
```bash
|
|
23
|
-
/task "
|
|
33
|
+
/task "Implement a real-time collaborative editor using WebSocket"
|
|
24
34
|
```
|
|
25
35
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
Where traditional agents hit a sequential wall, we deploy a fractal swarm. OpenCode Orchestrator is the world's most advanced autonomous engineering platform—a **Titan-Class Execution Engine** designed to conquer missions that break conventional AI.
|
|
29
|
-
|
|
30
|
-
By fusing **Fractal Swarm Intelligence (HPFA™)** with **Continuous Multi-Stage Verification Pipeline (MSVP™)**, it delivers a level of scale, velocity, and architectural absolute previously considered impossible. Welcome to the final form of autonomous development. No bottlenecks. No limits. Only pure execution.
|
|
36
|
+
---
|
|
31
37
|
|
|
38
|
+
## 🏗️ Architecture
|
|
32
39
|
|
|
33
|
-
|
|
40
|
+
The system is built upon two core mechanisms that handle scaling and quality control.
|
|
34
41
|
|
|
35
|
-
|
|
42
|
+
### HPFA (Hyper-Parallel Fractal Architecture)
|
|
43
|
+
HPFA is a parallel execution model that enables task decomposition at scale.
|
|
44
|
+
* **Managed Concurrency**: Orchestrates up to 50 parallel agent sessions simultaneously.
|
|
45
|
+
* **Recursive Scaling**: Allows "Worker" agents to spawn sub-workers for modular tasks, ensuring deep architectural coverage.
|
|
36
46
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
*
|
|
40
|
-
*
|
|
47
|
+
### MSVP (Multi-Stage Verification Pipeline)
|
|
48
|
+
MSVP is a structured verification process that decouples implementation from quality assurance.
|
|
49
|
+
* **Stage 1 (Unit Verification)**: Reviewers validate individual module changes and run local tests immediately after implementation.
|
|
50
|
+
* **Stage 2 (Integration Review)**: A master reviewer verifies cross-module consistency and system integrity after all individual units are completed.
|
|
41
51
|
|
|
42
52
|
---
|
|
43
53
|
|
|
44
|
-
##
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
│
|
|
49
|
-
|
|
50
|
-
|
|
54
|
+
## 📊 Workflow Diagram
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
[User Task Input]
|
|
58
|
+
│
|
|
59
|
+
┌─────────▼─────────┐
|
|
60
|
+
│ COMMANDER │ (Orchestration context)
|
|
61
|
+
└─────────┬─────────┘
|
|
62
|
+
│
|
|
63
|
+
┌────────────────▼────────────────┐
|
|
64
|
+
│ Phase 0: Parallel Discovery │ (Structure, Tech Stack, Docs, Infra)
|
|
65
|
+
└────────────────┬────────────────┘
|
|
66
|
+
│
|
|
67
|
+
┌─────────▼─────────┐
|
|
68
|
+
│ PLANNER │ (Create Hierarchical Plan)
|
|
69
|
+
└─────────┬─────────┘
|
|
70
|
+
│
|
|
71
|
+
┌────────────────▼────────────────┐
|
|
72
|
+
│ Phase 1: Parallel Execution │ (HPFA Implementation Grid)
|
|
73
|
+
└──────┬─────────┬─────────┬──────┘
|
|
74
|
+
│ │ │
|
|
75
|
+
┌──────▼──┐ ┌────▼───┐ ┌───▼────┐
|
|
76
|
+
│ WORKER │ │ WORKER │ │ WORKER │ (Fractal Spawning)
|
|
77
|
+
└──────┬──┘ └────┬───┘ └───┬────┘
|
|
78
|
+
│ │ │
|
|
79
|
+
┌──────▼──┐ ┌────▼───┐ ┌───▼────┐
|
|
80
|
+
│ REVIEWER│ │ REVIEWER│ │ REVIEWER│ (Stage 1: Unit Verification)
|
|
81
|
+
└──────┬──┘ └────┬───┘ └───┬────┘
|
|
82
|
+
│ │ │
|
|
83
|
+
───────▼─────────▼─────────▼───────
|
|
84
|
+
│ Sync Barrier │ (Wait for all units)
|
|
85
|
+
─────────────────┬─────────────────
|
|
86
|
+
│
|
|
87
|
+
┌─────────▼─────────┐
|
|
88
|
+
│ MASTER REVIEWER │ (Stage 2: System Integration)
|
|
89
|
+
└─────────┬─────────┘
|
|
90
|
+
│
|
|
91
|
+
┌─────────▼─────────┐
|
|
92
|
+
│ Mission Sealed? │
|
|
93
|
+
└─────────┬─────────┘
|
|
94
|
+
No ↙ ↘ Yes
|
|
95
|
+
[Loop] [Complete]
|
|
51
96
|
```
|
|
52
97
|
|
|
98
|
+
---
|
|
53
99
|
|
|
54
|
-
## 🚀
|
|
55
|
-
|
|
56
|
-
| Agent | Role | What It Does |
|
|
57
|
-
|:------|:-----|:-------------|
|
|
58
|
-
| 🎯 **Commander** | Orchestrator | Leads the task, delegates work to other agents, ensures completion |
|
|
59
|
-
| 📋 **Planner** | Researcher | Analyzes the project, creates the plan, documents findings |
|
|
60
|
-
| 🔨 **Worker** | Implementer | Writes code, modifies files, follows the project's patterns |
|
|
61
|
-
| ✅ **Reviewer** | Verifier | Tests changes, checks for errors, confirms quality |
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
## 📖 Principles
|
|
66
|
-
|
|
67
|
-
| Principle | What It Means |
|
|
68
|
-
|:----------|:--------------|
|
|
69
|
-
| 🔍 **Never Assume** | Always check the actual code and config files first |
|
|
70
|
-
| 📝 **Document Everything** | Record patterns and findings for future tasks |
|
|
71
|
-
| 📚 **Verify with Evidence** | Run tests, cite sources, complete with proof |
|
|
72
|
-
| 🔄 **Adapt to the Project** | Match the project's existing style and patterns |
|
|
73
|
-
| 🤝 **Specialized Roles** | Each agent has a clear, focused responsibility |
|
|
74
|
-
|
|
100
|
+
## 🚀 System Roles
|
|
75
101
|
|
|
76
|
-
|
|
102
|
+
| Role | Responsibility | Key Actions |
|
|
103
|
+
|:-----|:---------------|:------------|
|
|
104
|
+
| **Commander** | Mission Control | Task assignment, conflict resolution, global synchronization |
|
|
105
|
+
| **Planner** | Architecture | Environment analysis, dependency mapping, TODO generation |
|
|
106
|
+
| **Worker** | Implementation | Code writing, file modification, unit test creation |
|
|
107
|
+
| **Reviewer** | Quality Control| Static analysis, build verification, integration testing |
|
|
77
108
|
|
|
78
|
-
|
|
109
|
+
---
|
|
79
110
|
|
|
80
|
-
|
|
81
|
-
HPFA defines a recursive problem-solving model that decomposes massive codebases into atomic task units through a fractal hierarchy.
|
|
82
|
-
* **Fractal Delegation**: Workers are instantiated as autonomous controllers with localized `TaskLauncher` contexts. This enables recursive spawning of sub-agents up to 8 levels deep, mapping complex architectural hierarchies into a parallel execution grid.
|
|
83
|
-
* **Cognitive Concurrency Control**: A dedicated state-machine manages up to 50 concurrent sessions. It monitors success/failure trajectories to dynamically scale concurrency slots, ensuring maximum throughput while maintaining strict rate-limit compliance.
|
|
111
|
+
## 🛠️ Features
|
|
84
112
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
* **
|
|
88
|
-
* **
|
|
89
|
-
|
|
90
|
-
```
|
|
91
|
-
/task "Build Diablo Game"
|
|
92
|
-
│
|
|
93
|
-
╔═══════════════════════════════════════╗
|
|
94
|
-
║ 🎯 COMMANDER — Orchestrator ║
|
|
95
|
-
║ (Main Session - Single) ║
|
|
96
|
-
╚═══════════════════╤═══════════════════╝
|
|
97
|
-
│
|
|
98
|
-
══════════════════════════▼══════════════════════════
|
|
99
|
-
║ 🚀 PHASE 0: DISCOVERY SWARM (Parallel) ║
|
|
100
|
-
═════════════════════════════════════════════════════
|
|
101
|
-
│ │ │ │
|
|
102
|
-
▼ Scout ▼ Scout ▼ Scout ▼ Scout
|
|
103
|
-
[Structure] [Stack] [Docs] [Infra]
|
|
104
|
-
└───────────────┬───────────────┬───────────────┘
|
|
105
|
-
│ Consolidate & Sync
|
|
106
|
-
┌────────▼───────────────────┐
|
|
107
|
-
│ 📋 PLANNER — Create Plan │
|
|
108
|
-
│ → Outputs: Architectural Grid │
|
|
109
|
-
└───────────────────┬───────────────────┘
|
|
110
|
-
│
|
|
111
|
-
══════════════════════════╧══════════════════════════
|
|
112
|
-
║ 🔥 HPFA PARALLEL GRID (MSVP) ║
|
|
113
|
-
══════════════════════════════════════════════════════
|
|
114
|
-
│ │ │ │
|
|
115
|
-
▼ ▼ ▼ ▼
|
|
116
|
-
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
117
|
-
│🔨 WORKER │ │🔨 WORKER │ │🔨 WORKER │ │🔨 WORKER │ <-- Fractal Spawning
|
|
118
|
-
│ Module A │ │ Module B │ │ Module C │ │ Module D │
|
|
119
|
-
└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
|
|
120
|
-
│ ⚡ Instant │ ⚡ Instant │ ⚡ Instant │ ⚡ Instant
|
|
121
|
-
▼ Review ▼ Review ▼ Review ▼ Review
|
|
122
|
-
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
123
|
-
│✅ REVIEWR│ │✅ REVIEWR│ │✅ REVIEWR│ │✅ REVIEWR│ <-- Stage 1: Unit
|
|
124
|
-
│ (Unit-A) │ │ (Unit-B) │ │ (Unit-C) │ │ (Unit-D) │ Verification
|
|
125
|
-
└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
|
|
126
|
-
│ │ │ │
|
|
127
|
-
═▼═══════════════▼═══════════════▼═══════════════▼════
|
|
128
|
-
║ ⏳ SYNC BARRIER ║
|
|
129
|
-
══════════════════════════════════════════════════════
|
|
130
|
-
│
|
|
131
|
-
┌───────────────────▼───────────────────┐
|
|
132
|
-
│ ✅ MASTER REVIEWER — Final Pass │
|
|
133
|
-
│ (Cross-module Integration) │
|
|
134
|
-
│ → Stage 2: E2E & System Integrity │
|
|
135
|
-
└───────────────────┬───────────────────┘
|
|
136
|
-
│
|
|
137
|
-
┌─────────┴─────────┐
|
|
138
|
-
│ Seal Conditions │
|
|
139
|
-
│ Verified? │
|
|
140
|
-
└─────────┬─────────┘
|
|
141
|
-
No ↙ ↘ Yes
|
|
142
|
-
♻️ LOOP 🎖️ MISSION
|
|
143
|
-
(Adaptive) SEALED
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
### Execution Model (MSVP)
|
|
147
|
-
|
|
148
|
-
| Phase | Agent | Parallelism | Verification Level |
|
|
149
|
-
|:------|:------|:------------|:-------------------|
|
|
150
|
-
| 1️⃣ Plan | Planner | **Single** | Static Analysis |
|
|
151
|
-
| 2️⃣ Implement | Workers | **HPFA Parallel** | Direct Coding |
|
|
152
|
-
| 3️⃣ Unit Pass | Reviewers | **Shadow Parallel** | **1차 리뷰**: Unit Tests (Async) |
|
|
153
|
-
| 4️⃣ Final Sync | Barrier | **Blocking** | All Units Verified |
|
|
154
|
-
| 5️⃣ Integration | Master Reviewer | **Single** | **2차 리뷰**: Full E2E & Sync |
|
|
155
|
-
|
|
156
|
-
## Features
|
|
157
|
-
|
|
158
|
-
| Feature | What It Does |
|
|
159
|
-
|:---------|:-------------|
|
|
160
|
-
| 🚀 **MSVP™ Pipeline** | Zero-latency unit reviews triggered the millisecond code is written |
|
|
161
|
-
| 🧬 **Fractal Spawning** | Workers recursively spawn sub-agents for infinite structural depth |
|
|
162
|
-
| ⚡ **50 Parallel Tasks** | Titan-class density—run massive swarms without breaking a sweat |
|
|
163
|
-
| 🔄 **Non-Stop Recovery** | WAL-powered cognitive persistence; resumes instantly after any crash |
|
|
164
|
-
| 🔥 **Multi-File Ops** | Massive parallel edits with cross-file context integrity |
|
|
165
|
-
| 🛡️ **Self-Scaling** | Dynamic AI-driven concurrency management based on success velocity |
|
|
166
|
-
| 🩹 **Memory Integrity** | 100% reclamation; engineered for sessions with 10k+ iterations |
|
|
167
|
-
| 🏗️ **Clean-Code Engine**| Enforces industrial modularity and clean architectural patterns |
|
|
113
|
+
* **Concurrent Task Management**: Efficiently handles up to 50 background agent sessions.
|
|
114
|
+
* **Automated Context Synthesis**: Parallel scouters gather environment intelligence (Structure, Stack, Docs) instantly.
|
|
115
|
+
* **Synchronized Verification**: Ensures all distributed tasks pass Stage 1 review before final integration.
|
|
116
|
+
* **Fault Tolerance**: Automatically resumes progress from checkpoints in case of tool or session failure.
|
|
117
|
+
* **Context Optimization**: Monitors context window limits and performs automated compaction for long sessions.
|
|
168
118
|
|
|
169
119
|
---
|
|
170
120
|
|
|
121
|
+
## Piano Developer's Note
|
|
171
122
|
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
| Error | What Happens |
|
|
175
|
-
|:------|:-------------|
|
|
176
|
-
| 💥 Tool crash | Inject recovery prompt and retry |
|
|
177
|
-
| 🚦 Rate limit hit | Wait and retry with exponential backoff |
|
|
178
|
-
| 📦 Context overflow | Compact the context automatically |
|
|
179
|
-
| ⏱️ Session timeout | Resume from the last checkpoint |
|
|
180
|
-
| 🔨 Build failure | Fix the issue and retry |
|
|
123
|
+
OpenCode Orchestrator was developed to solve the "sequential bottleneck" in AI-assisted coding. By treating agents as distributed processing units rather than just chat interfaces, we aim to provide a more reliable and scalable autonomous engineering experience.
|
|
181
124
|
|
|
125
|
+
[Full Developer's Note →](docs/DEVELOPERS_NOTE.md)
|
|
182
126
|
|
|
183
127
|
---
|
|
184
128
|
|
|
185
|
-
## 🎹 Developer's Words
|
|
186
|
-
|
|
187
|
-
> "We are not just building a tool; we are building an autonomous engineer that can evolve with the project. HPFA and MSVP are the heart of this evolution—turning AI from a chatbot into a high-performance execution engine."
|
|
188
|
-
>
|
|
189
|
-
> [Read the full Developer's Note →](docs/DEVELOPERS_NOTE.md)
|
|
190
|
-
|
|
191
|
-
|
|
192
129
|
## 📄 License
|
|
193
130
|
|
|
194
|
-
MIT License. [LICENSE](LICENSE)
|
|
131
|
+
MIT License. See [LICENSE](LICENSE) for details.
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "opencode-orchestrator",
|
|
3
3
|
"displayName": "OpenCode Orchestrator",
|
|
4
4
|
"description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
|
|
5
|
-
"version": "1.0.
|
|
5
|
+
"version": "1.0.24",
|
|
6
6
|
"author": "agnusdei1207",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"repository": {
|