opencode-orchestrator 1.0.24 → 1.0.26

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 CHANGED
@@ -4,12 +4,23 @@
4
4
 
5
5
  <p>Autonomous Multi-Agent Orchestration Engine for Software Engineering</p>
6
6
 
7
- [![MIT License](https://img.shields.io/badge/license-MIT-gray.svg)](LICENSE)
7
+ [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
8
8
  [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
9
9
  </div>
10
10
 
11
11
  ---
12
12
 
13
+ ## ⚡ Quick Start
14
+
15
+ ```bash
16
+ npm install -g opencode-orchestrator
17
+ ```
18
+
19
+ In an OpenCode environment:
20
+ ```bash
21
+ /task "Implement a real-time collaborative editor using WebSocket"
22
+ ```
23
+
13
24
  ## Overview
14
25
 
15
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.
@@ -22,16 +33,14 @@ OpenCode Orchestrator is a framework designed to manage complex software enginee
22
33
 
23
34
  ---
24
35
 
25
- ## Quick Start
36
+ ## Core Philosophy: Adaptive Engineering
26
37
 
27
- ```bash
28
- npm install -g opencode-orchestrator
29
- ```
38
+ The orchestrator follows an **Explore → Learn → Adapt → Act** cycle to ensure agents remain grounded in the project's specific context.
30
39
 
31
- In an OpenCode environment:
32
- ```bash
33
- /task "Implement a real-time collaborative editor using WebSocket"
34
- ```
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.
35
44
 
36
45
  ---
37
46
 
@@ -123,6 +132,7 @@ MSVP is a structured verification process that decouples implementation from qua
123
132
  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.
124
133
 
125
134
  [Full Developer's Note →](docs/DEVELOPERS_NOTE.md)
135
+ [System Architecture →](docs/SYSTEM_ARCHITECTURE.md)
126
136
 
127
137
  ---
128
138
 
package/dist/index.js CHANGED
@@ -907,8 +907,36 @@ var PHILOSOPHY_TAGLINE = "Explore \u2192 Learn \u2192 Adapt \u2192 Act";
907
907
  var PHILOSOPHY_QUOTE = "Like an astronaut landing on unknown planets \u2014 never assume, always discover.";
908
908
  var PHILOSOPHY_LEARN_PRINCIPLE = "LEARN = DOCUMENT: What you discover, you record. Your learnings become the team's knowledge.";
909
909
 
910
+ // src/shared/prompt/constants/scouts.ts
911
+ var SCOUT_LABEL = "Scout";
912
+ var SCOUT_STRUCTURE = {
913
+ ID: "STRUCTURE",
914
+ NAME: `${SCOUT_LABEL}: Structure`,
915
+ PROMPT: "Analyze the project folder structure. Locate source code (src, lib), tests, and documentation directories. Map out the tree at depth 2-3."
916
+ };
917
+ var SCOUT_STACK = {
918
+ ID: "STACK",
919
+ NAME: `${SCOUT_LABEL}: Stack`,
920
+ PROMPT: "Identify the technology stack. Parse package.json, Cargo.toml, go.mod, or pyproject.toml. Determine build and test commands."
921
+ };
922
+ var SCOUT_DOCS = {
923
+ ID: "DOCS",
924
+ NAME: `${SCOUT_LABEL}: Docs`,
925
+ PROMPT: "Digest the project documentation. Read README.md, CONTRIBUTING.md, and any files in docs/ to understand the core architecture and mission."
926
+ };
927
+ var SCOUT_INFRA = {
928
+ ID: "INFRA",
929
+ NAME: `${SCOUT_LABEL}: Infra`,
930
+ PROMPT: "Detect infrastructure and environment configs. Search for Dockerfiles, CI/CD workflows (.github, .gitlab), and environment variable templates."
931
+ };
932
+ var SCOUT_INTEGRATION = {
933
+ ID: "INTEGRATION",
934
+ NAME: `${SCOUT_LABEL}: Integration`,
935
+ PROMPT: "Read all modified files and their cross-module dependencies in parallel. Map the actual integration surface and identify potential consistency issues."
936
+ };
937
+
910
938
  // src/shared/prompt/constants/mandates.ts
911
- var PHASE_0_SCOUT_SWARM = `**Mandatory Parallel Initialization**: DO NOT run discovery tools (ls, grep, find) yourself. Your job is to ORCHESTRATE and synthesize results.
939
+ var PHASE_0_SCOUT_SWARM = `**Mandatory Parallel Initialization**: DO NOT run discovery tools (ls, grep, find) yourself. Your job is to ORCHESTRATE and synthesize results.
912
940
 
913
941
  1. **LAUNCH Parallel Scouts**: In your VERY FIRST response, you must output ALL of the following \`${TOOL_NAMES.DELEGATE_TASK}\` calls simultaneously (background: true) for:
914
942
  - **[${SCOUT_STRUCTURE.NAME}]**: ${SCOUT_STRUCTURE.PROMPT} (To ${AGENT_NAMES.PLANNER})
@@ -945,34 +973,6 @@ var HPFA_RULES = `1. **Fractal Spawning**: Workers spawn sub-workers for complex
945
973
  4. **Barrier-Sync Pipeline**: Reviewers start Unit Review (Stage 1) while other workers still run.
946
974
  5. **Real-time Brain Sync**: Parallel sessions share public interfaces via shared task logs.`;
947
975
 
948
- // src/shared/prompt/constants/scouts.ts
949
- var SCOUT_LABEL = "Scout";
950
- var SCOUT_STRUCTURE = {
951
- ID: "STRUCTURE",
952
- NAME: `${SCOUT_LABEL}: Structure`,
953
- PROMPT: "Analyze the project folder structure. Locate source code (src, lib), tests, and documentation directories. Map out the tree at depth 2-3."
954
- };
955
- var SCOUT_STACK = {
956
- ID: "STACK",
957
- NAME: `${SCOUT_LABEL}: Stack`,
958
- PROMPT: "Identify the technology stack. Parse package.json, Cargo.toml, go.mod, or pyproject.toml. Determine build and test commands."
959
- };
960
- var SCOUT_DOCS = {
961
- ID: "DOCS",
962
- NAME: `${SCOUT_LABEL}: Docs`,
963
- PROMPT: "Digest the project documentation. Read README.md, CONTRIBUTING.md, and any files in docs/ to understand the core architecture and mission."
964
- };
965
- var SCOUT_INFRA = {
966
- ID: "INFRA",
967
- NAME: `${SCOUT_LABEL}: Infra`,
968
- PROMPT: "Detect infrastructure and environment configs. Search for Dockerfiles, CI/CD workflows (.github, .gitlab), and environment variable templates."
969
- };
970
- var SCOUT_INTEGRATION = {
971
- ID: "INTEGRATION",
972
- NAME: `${SCOUT_LABEL}: Integration`,
973
- PROMPT: "Read all modified files and their cross-module dependencies in parallel. Map the actual integration surface and identify potential consistency issues."
974
- };
975
-
976
976
  // src/core/agents/consts/task-status.const.ts
977
977
  var TASK_STATUS = {
978
978
  PENDING: STATUS_LABEL.PENDING,
@@ -1,6 +1,7 @@
1
1
  /**
2
2
  * Architectural Mandates - Immutable Core Logic
3
3
  *
4
+ *
4
5
  * These constants define the non-negotiable architectural requirements
5
6
  * that ensure the orchestrator operates according to the verified diagram.
6
7
  */
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.24",
5
+ "version": "1.0.26",
6
6
  "author": "agnusdei1207",
7
7
  "license": "MIT",
8
8
  "repository": {