opencode-orchestrator 0.5.5 โ†’ 0.5.7

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.
Files changed (3) hide show
  1. package/README.md +24 -176
  2. package/dist/index.js +18 -13
  3. package/package.json +3 -2
package/README.md CHANGED
@@ -11,34 +11,20 @@
11
11
 
12
12
  ---
13
13
 
14
- ## Why I Built This ๐Ÿค”
15
-
16
- **I was frustrated coding with DeepSeek and Z.AI.**
17
-
18
- I wanted to achieve the same quality of work as premium models like **Gemini 3 Pro** and **Claude Opus**, but with affordable models.
19
- For developers who chose **budget-friendly subscriptions** instead of expensive plans, I built a multi-agent system that can **autonomously complete** complex engineering tasks even with mid-tier LLMs.
20
-
21
- > *"Intelligence is a resource. Orchestrate it."*
22
-
23
- ---
24
-
25
14
  ## What is this?
26
15
 
27
- A **5-agent autonomous architecture** designed to solve complex engineering tasks with high reliability, even on mid-range LLMs.
28
-
29
- **Core Philosophy**: Intelligence is a resource. We orchestrate that resource through **Phase-based Workflows** and **Mandatory Environment Scans** to ensure code always fits the project's infrastructure.
16
+ A **5-agent autonomous architecture** for OpenCode that completes complex engineering tasks reliably.
30
17
 
31
- > ๐Ÿฆ€ **Powered by Rust** โ€” Background tasks and parallel searches run on native Rust binaries for maximum performance.
18
+ > *"Intelligence is a resource. Orchestrate it."*
32
19
 
33
20
  ### Key Features
34
- - **๐ŸŽฏ Autonomous Loop** โ€” Commander runs relentlessly until the mission is complete.
35
- - **๐Ÿ” Environment Scan** โ€” Mandatory analysis of Infra (Docker/OS), Stack, and Domain before any code change.
36
- - **๐Ÿ”จ Smart Implementation** โ€” Builder matches existing codebase patterns exactly.
37
- - **๐Ÿ›ก๏ธ Rigorous Audit** โ€” Inspector proves success with environment-specific evidence (Builds/Tests/Logs).
38
- - **๐Ÿ’พ Persistent Context** โ€” Recorder saves session state to disk, enabling resume at any time.
39
- - **๐Ÿ—๏ธ Parallel Agents** โ€” Delegated agent execution (`delegate_task`) with sync/async modes.
40
- - **โณ Background Tasks** โ€” Run long commands (builds, tests) in background and check results later.
41
- - **๐Ÿ”Ž mgrep** โ€” Multi-pattern parallel search powered by Rust for blazing-fast codebase analysis.
21
+ - **๐ŸŽฏ Autonomous Loop** โ€” Commander runs until the mission is complete
22
+ - **๐Ÿ” Environment Scan** โ€” Analyzes Infra, Stack, and Domain before coding
23
+ - **๐Ÿ”จ Smart Implementation** โ€” Matches existing codebase patterns
24
+ - **๐Ÿ›ก๏ธ Rigorous Audit** โ€” Proves success with builds/tests/logs
25
+ - **๐Ÿ’พ Persistent Context** โ€” Saves session state to disk
26
+ - **๐Ÿ—๏ธ Parallel Agents** โ€” Run multiple agents concurrently
27
+ - **โณ Background Tasks** โ€” Non-blocking command execution
42
28
 
43
29
  ---
44
30
 
@@ -54,169 +40,33 @@ Restart OpenCode after installation.
54
40
 
55
41
  ## Usage
56
42
 
57
- ### ๐Ÿš€ Method 1: Select Commander via Tab Key (Recommended)
58
-
59
- In OpenCode, press `Tab` to open the Agent selection menu. Select **Commander** and type your mission!
43
+ ### ๐Ÿš€ Select Commander via Tab Key (Recommended)
60
44
 
61
- <div align="center">
62
- <img src="assets/commander-screenshot.png" alt="Commander Screenshot" width="600" />
63
- <p><em>Press Tab to select Commander</em></p>
64
- </div>
45
+ Press `Tab` in OpenCode โ†’ Select **Commander** โ†’ Type your mission!
65
46
 
66
47
  ```
67
48
  "Fix the login bug in the docker-compose environment"
68
49
  ```
69
50
 
70
- The Commander will:
71
- 1. **Survey**: Scan the Docker environment and codebase.
72
- 2. **Plan**: Break the fix into steps.
73
- 3. **Execute**: Call Builder to fix while matching patterns.
74
- 4. **Verify**: Run builds/tests to prove the fix works.
75
- 5. **Complete**: Report results with concrete evidence.
76
-
77
- ### ๐Ÿ“‹ Method 2: Use /task Command
51
+ ### ๐Ÿ“‹ Use /task Command
78
52
 
79
53
  ```bash
80
54
  /task "Implement user authentication with JWT"
81
55
  ```
82
56
 
83
- > **๐Ÿ’ก Tip:** Using the `/task` command makes Commander mode run **2x longer**.
84
- > Use `/task` for complex tasks that need extended processing!
85
-
86
- ### โšก Example: Parallel Execution
87
-
88
- Trigger parallel agent execution with prompts like:
89
-
90
- ```
91
- "Build and test in parallel"
92
- "Implement feature X while reviewing module Y"
93
- "Run linting, tests, and build at the same time"
94
- ```
95
-
96
- Commander will automatically use `delegate_task` with `background: true` for independent tasks.
97
-
98
- Monitor parallel tasks in the terminal:
99
- ```
100
- [parallel] ๐Ÿš€ SPAWNED task_a1b2 โ†’ builder: Implement feature X
101
- [parallel] ๐Ÿš€ SPAWNED task_c3d4 โ†’ inspector: Review module Y
102
- [parallel] โœ… COMPLETED task_c3d4 โ†’ inspector: Review module Y (45s)
103
- [parallel] ๐Ÿ—‘๏ธ CLEANED task_c3d4 (session deleted)
104
- ```
57
+ > **๐Ÿ’ก Tip:** `/task` makes Commander run **2x longer** for complex tasks.
105
58
 
106
59
  ---
107
60
 
108
- ## Agents (5-Agent Architecture)
109
-
110
- | Agent | Emoji | Role | Responsibility |
111
- | :--- | :--- | :--- | :--- |
112
- | **Commander** | ๐ŸŽฏ | Orchestrator | Autonomous mission control & delegation |
113
- | **Architect** | ๐Ÿ—๏ธ | Planner | Task decomposition & strategy correction |
114
- | **Builder** | ๐Ÿ”จ | Developer | Full-stack implementation (Logic + UI) |
115
- | **Inspector** | ๐Ÿ” | Quality | 5-point audit & automatic bug fixing |
116
- | **Recorder** | ๐Ÿ’พ | Context | Persistent environment & progress tracking |
117
-
118
- ---
119
-
120
- ## The Workflow (Progressive Phases)
121
-
122
- 1. **Phase 0: Triage (Smart)**
123
- - **Fast Track ๐ŸŸข**: Simple fixes โ†’ Execute instantly (Skip heavy scans).
124
- - **Deep Track ๐Ÿ”ด**: Complex features โ†’ Full Environment Scan & Plan.
125
- 2. **Phase 1: Environment Scan**
126
- - Mandatory for Deep Track: Infra/Domain/Stack analysis.
127
- 3. **Phase 2: Parallel Planning**
128
- - Architect creates a DAG of atomic tasks (Scalable Planning).
129
- 4. **Phase 3: Execution & Audit**
130
- - Builder writes code โ†” Inspector verifies with evidence.
131
- 5. **Phase 4: Completion**
132
- - Mission Complete reported with proof of build/test success.
133
-
134
- ---
135
-
136
- ## Development
137
-
138
- ### Quick Start (Local Development)
139
-
140
- ```bash
141
- # Step 1: Build and link (run this ONCE)
142
- npm run dev:link
143
-
144
- # Step 2: Restart OpenCode
145
-
146
- # Step 3: Make code changes...
147
-
148
- # Step 4: Rebuild and re-link (after code changes)
149
- npm run dev:link
150
-
151
- # (Optional) Check link status
152
- npm run dev:status
153
- ```
154
-
155
- ### Development Scripts
156
-
157
- ```bash
158
- # Build the plugin
159
- npm run build
160
-
161
- # Link for local testing (auto-rebuilds)
162
- npm run dev:link
163
-
164
- # Unlink from global
165
- npm run dev:unlink
166
-
167
- # Check if plugin is linked globally
168
- npm run dev:status
169
-
170
- # Test install/uninstall scripts locally
171
- npm run dev:test
172
- ```
173
-
174
- ### Development Workflow
175
-
176
- | Step | Command | Description |
177
- |------|----------|-------------|
178
- | 1๏ธโƒฃ Initial setup | `npm run dev:link` | Build + link for the first time |
179
- | 2๏ธโƒฃ Test | Open OpenCode | Test your changes |
180
- | 3๏ธโƒฃ Make changes | Edit code | Modify TypeScript files |
181
- | 4๏ธโƒฃ Rebuild | `npm run dev:link` | Rebuild + re-link |
182
- | 5๏ธโƒฃ Repeat | 2-4 | Iterate on changes |
183
- | โŒ Cleanup | `npm run dev:unlink` | Unlink when done |
184
-
185
- ### Common Scenarios
186
-
187
- ```bash
188
- # ๐Ÿ”„ Changed code and want to test
189
- npm run dev:link
190
-
191
- # ๐Ÿ” Check if linked properly
192
- npm run dev:status
193
-
194
- # ๐Ÿงน Cleanup before committing
195
- npm run dev:unlink
196
-
197
- # ๐Ÿงช Test install/uninstall scripts
198
- npm run dev:test
199
- ```
200
-
201
- ### Release Scripts
202
-
203
- ```bash
204
- # Release patch version (0.4.1 โ†’ 0.4.2)
205
- npm run release:patch
206
-
207
- # Release minor version (0.4.1 โ†’ 0.5.0)
208
- npm run release:minor
209
-
210
- # Release major version (0.4.1 โ†’ 1.0.0)
211
- npm run release:major
212
- ```
61
+ ## The 5 Agents
213
62
 
214
- Each release script:
215
- 1. Builds the plugin
216
- 2. Bumps version in package.json
217
- 3. Creates git tag
218
- 4. Pushes to remote
219
- 5. Publishes to npm
63
+ | Agent | Role | Responsibility |
64
+ | :--- | :--- | :--- |
65
+ | **Commander** ๐ŸŽฏ | Orchestrator | Autonomous mission control |
66
+ | **Architect** ๐Ÿ—๏ธ | Planner | Task decomposition |
67
+ | **Builder** ๐Ÿ”จ | Developer | Full-stack implementation |
68
+ | **Inspector** ๐Ÿ” | Quality | Audit & auto-fix |
69
+ | **Recorder** ๐Ÿ’พ | Context | Progress tracking |
220
70
 
221
71
  ---
222
72
 
@@ -228,12 +78,10 @@ npm uninstall -g opencode-orchestrator
228
78
 
229
79
  ---
230
80
 
231
- ## Docs
81
+ ## Documentation
232
82
 
233
- - [Architecture & Design](docs/ARCHITECTURE.md) โ€” Detailed system design and agent protocols
234
- - [Plugin Troubleshooting](docs/PLUGIN_TROUBLESHOOTING.md) โ€” Setup and common issues
235
- - [Changelog](CHANGELOG.md) โ€” Version history and updates
236
- - [Changelogs](changelogs/) โ€” Detailed implementation notes per release
83
+ - [Architecture & Design](docs/ARCHITECTURE.md)
84
+ - [Troubleshooting](docs/PLUGIN_TROUBLESHOOTING.md)
237
85
 
238
86
  ---
239
87
 
package/dist/index.js CHANGED
@@ -22,11 +22,12 @@ You are Commander. Complete missions autonomously. Never stop until done.
22
22
  </role>
23
23
 
24
24
  <core_rules>
25
- 1. Never stop until "\u2705 MISSION COMPLETE"
26
- 2. Never wait for user during execution
27
- 3. Never stop because agent returned nothing
28
- 4. Always survey environment & codebase BEFORE coding
29
- 5. Always verify with evidence based on runtime context
25
+ 1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
26
+ 2. Never stop until "\u2705 MISSION COMPLETE"
27
+ 3. Never wait for user during execution
28
+ 4. Never stop because agent returned nothing
29
+ 5. Always survey environment & codebase BEFORE coding
30
+ 6. Always verify with evidence based on runtime context
30
31
  </core_rules>
31
32
 
32
33
  <phase_0 name="TRIAGE">
@@ -216,8 +217,8 @@ You are Architect. Break complex tasks into atomic pieces.
216
217
  </role>
217
218
 
218
219
  <constraints>
219
-
220
- If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
220
+ 1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
221
+ 2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
221
222
  </constraints>
222
223
 
223
224
  <scalable_planning>
@@ -278,8 +279,8 @@ You are Builder. Write code that works.
278
279
  </role>
279
280
 
280
281
  <constraints>
281
-
282
- If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
282
+ 1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
283
+ 2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
283
284
  </constraints>
284
285
 
285
286
  <scalable_attention>
@@ -344,8 +345,8 @@ You are Inspector. Prove failure or success with evidence.
344
345
  </role>
345
346
 
346
347
  <constraints>
347
-
348
- If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
348
+ 1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
349
+ 2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
349
350
  </constraints>
350
351
 
351
352
  <scalable_audit>
@@ -411,8 +412,8 @@ You are Recorder. Save and load work progress.
411
412
  </role>
412
413
 
413
414
  <constraints>
414
-
415
- If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
415
+ 1. LANGUAGE: ALL output MUST be in English only. No exceptions. No other languages.
416
+ 2. If your reasoning collapses into gibberish, stop and output "ERROR: REASONING_COLLAPSE".
416
417
  </constraints>
417
418
 
418
419
  <purpose>
@@ -13053,6 +13054,10 @@ var COMMANDS = {
13053
13054
  You are Commander. Complete this mission. Never stop until 100% done.
13054
13055
  </role>
13055
13056
 
13057
+ <language_rule>
13058
+ CRITICAL: ALL output MUST be in English only. No exceptions. No other languages permitted.
13059
+ </language_rule>
13060
+
13056
13061
  <phase_1 name="MANDATORY_ENVIRONMENT_SCAN">
13057
13062
  Before any planning or coding, you MUST understand:
13058
13063
  1. INFRA: OS-native? Container? Docker-compose? Volume-mounted?
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": "0.5.5",
5
+ "version": "0.5.7",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {
@@ -56,7 +56,8 @@
56
56
  "dev:unlink": "npm unlink -g opencode-orchestrator || true && npm run dev:clean && echo 'SUCCESS: Unlinked'",
57
57
  "dev:status": "echo '=== Global Link ===' && ls -la $(npm root -g)/opencode-orchestrator 2>/dev/null || echo 'Not linked'",
58
58
  "dev:test": "node dist/scripts/postinstall.js && echo '---' && node dist/scripts/preuninstall.js",
59
- "reset": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm run dev:link && echo '=== Reset complete ==='"
59
+ "reset": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm run dev:link && echo '=== Reset complete ==='",
60
+ "reset:global": "npm run dev:unlink || true && npm uninstall -g opencode-orchestrator || true && brew uninstall opencode || true && rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode && echo '=== Clean done ===' && brew install opencode && npm install -g opencode-orchestrator && echo '=== Reset Global complete ==='"
60
61
  },
61
62
  "dependencies": {
62
63
  "@opencode-ai/plugin": "^1.1.1",