opencode-orchestrator 1.0.34 → 1.0.35

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 (2) hide show
  1. package/README.md +26 -64
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -23,50 +23,17 @@ In an OpenCode environment:
23
23
 
24
24
  ## Overview
25
25
 
26
- 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.
27
-
28
- ### Key Characteristics
29
- * **Parallel Execution**: Manages multiple concurrent agent sessions to accelerate development.
30
- * **Hierarchical Delegation**: Supports recursive task decomposition (Fractal Spawning) for complex requirements.
31
- * **Integrated Verification**: Employs a multi-stage pipeline (Unit & Integration) to ensure code quality.
32
- * **Persistent State**: Uses structured logging to maintain state and recover from interruptions.
33
-
34
- ---
35
-
36
- ## Core Philosophy: Adaptive Engineering
37
-
38
- The orchestrator follows an **Explore → Learn → Adapt → Act** cycle to ensure agents remain grounded in the project's specific context.
39
-
40
- * **Explore**: Systematically discover the project structure, tech stack, and documentation.
41
- * **Learn**: Extract existing patterns, naming conventions, and architectural decisions from the codebase.
42
- * **Adapt**: Adjust implementation strategies and verification parameters based on learned context.
43
- * **Act**: Execute tasks through parallel delegation with evidence-based verification.
44
-
45
- ---
46
-
47
- ## 🏗️ Architecture
48
-
49
- The system is built upon two core mechanisms that handle scaling and quality control.
50
-
51
- ### HPFA (Hyper-Parallel Fractal Architecture)
52
- HPFA is a parallel execution model that enables task decomposition at scale.
53
- * **Managed Concurrency**: Orchestrates up to 50 parallel agent sessions simultaneously.
54
- * **Recursive Scaling**: Allows "Worker" agents to spawn sub-workers for modular tasks, ensuring deep architectural coverage.
55
-
56
- ### MSVP (Multi-Stage Verification Pipeline)
57
- MSVP is a structured verification process that decouples implementation from quality assurance.
58
- * **Stage 1 (Unit Verification)**: Reviewers validate individual module changes and run local tests immediately after implementation.
59
- * **Stage 2 (Integration Review)**: A master reviewer verifies cross-module consistency and system integrity after all individual units are completed.
26
+ OpenCode Orchestrator manages complex software tasks through **parallel multi-agent execution**. Commander orchestrates Workers and Reviewers to implement and verify code concurrently.
60
27
 
61
28
  ---
62
29
 
63
- ## 📊 Workflow Diagram
30
+ ## 📊 Workflow
64
31
 
65
32
  ```text
66
33
  [User Task Input]
67
34
  │
68
35
  ┌─────────▼─────────┐
69
- │ COMMANDER │ (Orchestration & Discovery)
36
+ │ COMMANDER │ (Orchestration)
70
37
  └─────────┬─────────┘
71
38
  │
72
39
  ┌─────────▼─────────┐
@@ -78,7 +45,7 @@ MSVP is a structured verification process that decouples implementation from qua
78
45
  └──────┬─────────┬─────────┬──────┘
79
46
  │ │ │
80
47
  ┌──────▼──┐ ┌────▼───┐ ┌───▼────┐
81
- │ WORKER A│ │ WORKER B│ │ WORKER C│ (Implementation)
48
+ │ WORKER │ │ WORKER │ │ WORKER │
82
49
  └──────┬──┘ └────┬───┘ └────┬────┘
83
50
  │ │ │
84
51
  ╔══════▼═════════▼══════════▼══════╗
@@ -86,44 +53,39 @@ MSVP is a structured verification process that decouples implementation from qua
86
53
  ╚══════╤═════════╤══════════╤══════╝
87
54
  │ │ │
88
55
  ┌──────▼──┐ ┌────▼───┐ ┌────▼────┐
89
- │REVIEWER │ │REVIEWER │ │REVIEWER │ (Unit Verification)
56
+ │REVIEWER │ │REVIEWER │ │REVIEWER │
90
57
  └──────┬──┘ └────┬───┘ └────┬────┘
91
58
  │ │ │
92
- ═══════▼═════════▼══════════▼══════
93
- │ SYNC BARRIER │
94
- ════════════════╤══════════════════
95
- │
96
- ┌─────────▼─────────┐
97
- │ MASTER REVIEWER │ (E2E Verification)
98
- └─────────┬─────────┘
99
- │
100
- ┌─────────▼─────────┐
101
- │ Mission Sealed? │
102
- └─────────┬─────────┘
103
- No ↙ ↘ Yes
104
- [Loop] [Complete]
59
+ ═▼═════════▼══════════▼═
60
+ │ SYNC BARRIER │
61
+ ═══════════╤═══════════
62
+ │
63
+ ┌─────────▼─────────┐
64
+ │ MASTER REVIEWER │ (E2E Verification)
65
+ └─────────┬─────────┘
66
+ │
67
+ [MISSION SEALED]
105
68
  ```
106
69
 
107
70
  ---
108
71
 
109
- ## 🚀 System Roles
72
+ ## 🚀 Agents
110
73
 
111
- | Role | Responsibility | Key Actions |
112
- |:-----|:---------------|:------------|
113
- | **Commander** | Mission Control | Task assignment, conflict resolution, global synchronization |
114
- | **Planner** | Architecture | Environment analysis, dependency mapping, TODO generation |
115
- | **Worker** | Implementation | Code writing, file modification, unit test creation |
116
- | **Reviewer** | Quality Control| Static analysis, build verification, integration testing |
74
+ | Agent | Role |
75
+ |:------|:-----|
76
+ | **Commander** | Orchestrates all agents, manages task flow |
77
+ | **Planner** | Creates TODO.md with task breakdown |
78
+ | **Worker** | Implements features, writes tests |
79
+ | **Reviewer** | Validates code, runs verification |
117
80
 
118
81
  ---
119
82
 
120
- ## 🛠️ Features
83
+ ## ✨ Key Features
121
84
 
122
- * **Concurrent Task Management**: Efficiently handles up to 50 background agent sessions.
123
- * **Automated Context Synthesis**: Parallel scouters gather environment intelligence (Structure, Stack, Docs) instantly.
124
- * **Synchronized Verification**: Ensures all distributed tasks pass Stage 1 review before final integration.
125
- * **Fault Tolerance**: Automatically resumes progress from checkpoints in case of tool or session failure.
126
- * **Context Optimization**: Monitors context window limits and performs automated compaction for long sessions.
85
+ - **Parallel Execution**: Up to 50 concurrent agent sessions
86
+ - **Two-Stage Verification**: Unit review → Master review → Seal
87
+ - **Fault Tolerance**: Auto-recovery from failures
88
+ - **Context Optimization**: Manages token limits automatically
127
89
 
128
90
  ---
129
91
 
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.34",
5
+ "version": "1.0.35",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {