opencode-orchestrator 1.2.59 → 1.2.61

package/README.md

@@ -1,7 +1,9 @@
+
+---
+
 <div align="center">
   <img src="assets/logo.png" alt="logo" width="200" />
   <h1>OpenCode Orchestrator</h1>
-
   <p>Production-Grade Multi-Agent Orchestration Engine for High-Integrity Software Engineering</p>
 
   [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
@@ -23,8 +25,6 @@ Inside an OpenCode environment:
 
 ---
 
----
-
 ## 🚀 Engine Workflow
 
 OpenCode Orchestrator utilizes a **Hub-and-Spoke Topology** with **Work-Stealing Queues** to execute complex engineering tasks through parallel, context-isolated sessions.
@@ -64,13 +64,24 @@ OpenCode Orchestrator utilizes a **Hub-and-Spoke Topology** with **Work-Stealing
 
 ---
 
+## ⚡ Elite Multi-Agent Swarm
+
+| Agent | Expertise | Capability |
+|:------|:----------|:-----------|
+| **Commander** | Mission Hub | Session pooling, parallel thread control, state rehydration, work-stealing coordination |
+| **Planner** | Architect | Symbolic mapping, dependency research, roadmap generation, file-level planning |
+| **Worker** | Implementer | High-throughput coding, TDD workflow, documentation, isolated file execution |
+| **Reviewer** | Auditor | Rigid verification, LSP/Lint authority, integration testing, final mission seal |
+
+---
+
 ## 🛠️ Core Capabilities
 
 ### 🔒 Atomic MVCC State Synchronization
-The engine solves the "Concurrent TODO Update" problem using **Multi-Version Concurrency Control (MVCC) + Mutex**. Agents can safely mark tasks as complete in parallel without data loss or race conditions. Every state change is cryptographically hashed and logged for a complete audit trail.
+Solves the "Concurrent TODO Update" problem using **MVCC + Mutex**. Agents safely mark tasks complete in parallel without data loss or race conditions. Every state change is cryptographically hashed and logged.
 
 ### 🧩 Advanced Hook Orchestration
-Execution flows are governed by a **Priority-Phase Hook Registry**. Hooks (Safety, UI, Protocol) are grouped into phases (`early`, `normal`, `late`) and executed using a **Topological Sort** to handle complex dependencies automatically, ensuring a predictable and stable environment.
+Execution flows governed by a **Priority-Phase Hook Registry**. Hooks are grouped into phases (`early`, `normal`, `late`) and executed via **Topological Sort** for predictable, dependency-aware ordering.
 
 ### 🛡️ Autonomous Recovery
 - **Self-healing loops** with adaptive stagnation detection
@@ -78,130 +89,57 @@ Execution flows are governed by a **Priority-Phase Hook Registry**. Hooks (Safet
 - **Auto-retry with backoff**: Exponential backoff for transient failures
 
 ### 🎯 State-Level Session Isolation
-Reused sessions in the **SessionPool** are explicitly reset using server-side compaction triggered by health monitors. This ensures that previous task context (old error messages, stale file references) never leaks into new tasks, maintaining 100% implementation integrity.
+Reused sessions in the **SessionPool** are explicitly reset via server-side compaction, ensuring previous task context never leaks into new tasks.
 
 ### 🚀 Zero-Payload Turbo Mode
-Leverages `system.transform` to unshift massive agent instruction sets on the server side. This reduces initial message payloads by **90%+**, slashing latency and preventing context fragmentation during long autonomous loops.
-
----
-
-## 🛠️ Infrastructure & Reliability
-
-### 🔒 Resource Safety & Reliability
-- **RAII Pattern (ConcurrencyToken)**: Guaranteed resource cleanup with zero leaks
-- **ShutdownManager**: Priority-based graceful shutdown with 5-second timeout per handler
-- **Automatic Backups**: All config changes backed up with rollback support
-- **Atomic File Operations**: Temp file + rename for corruption-proof writes
-- **Finally Blocks**: Guaranteed cleanup in all critical paths
-- **Zero Resource Leaks**: File watchers, event listeners, concurrency slots all properly released
-
-### ⚡ Performance Optimizations
-- **Work-Stealing Queues**: Chase-Lev deque implementation for 90%+ CPU utilization
-  - Planner: 2 workers, Worker: 8 workers, Reviewer: 4 workers
-  - LIFO for owner (cache locality), FIFO for thieves (fairness)
-- **Memory Pooling**: 80% GC pressure reduction
-  - Object Pool: 200 ParallelTask instances (50 prewarmed)
-  - String Interning: Deduplication for agent names, status strings
-  - Buffer Pool: Reusable ArrayBuffers (1KB, 4KB, 16KB, 64KB)
-- **Session Reuse**: 90% faster session creation (500ms → 50ms)
-  - Pool size: 5 sessions per agent type
-  - Max reuse: 10 times per session
-  - Health check: Every 60 seconds
-- **Rust Connection Pool**: 10x faster tool calls (50-100ms → 5-10ms)
-  - Max 4 persistent processes
-  - 30-second idle timeout
-- **Adaptive Polling**: Dynamic 500ms-5s intervals based on system load
-
-### 🛡️ Safety Features
-- **Circuit Breaker**: Auto-recovery from API failures (5 failures → open)
-- **Resource Pressure Detection**: Rejects low-priority tasks when memory > 80%
-- **Terminal Node Guard**: Prevents infinite recursion (depth limit enforcement)
-- **Auto-Scaling**: Concurrency slots adjust based on success/failure rate
-
----
-
-## 🛠️ Key Innovations
+Leverages `system.transform` to unshift agent instruction sets server-side, reducing initial message payloads by **90%+** and preventing context fragmentation.
 
 ### 🧠 Hierarchical Memory System
-Maintains focus across thousands of conversation turns using a 4-tier memory structure and **EMA-based Context Gating** to preserve "Architectural Truth" while pruning operational noise.
-
-###  Dynamic Concurrency Auto-Scaling
-Slots for parallel implementation scale up automatically after a **3-success streak** and scale down aggressively upon detection of API instability or implementation failures.
-
-### 🛡️ Neuro-Symbolic Safety
-Combines LLM reasoning with deterministic **AST/LSP verification**. Every code change is verified by native system tools before being accepted into the master roadmap.
+Maintains focus across thousands of conversation turns using a 4-tier memory structure with **EMA-based Context Gating** to preserve architectural truth while pruning noise.
 
 ### 🔄 Adaptive Intelligence Loop
-- **Stagnation Detection**: Automatically senses when no progress is made across multiple iterations
-- **Diagnostic Intervention**: Forces the agent into a "Diagnostic Mode" when stagnation is detected, mandating log audits and strategy pivots
-- **Proactive Agency**: Mandates Speculative Planning and Parallel Thinking during background task execution
-
-### 📊 Native TUI Integration
-Seamless integration with OpenCode's native TUI via **TaskToastManager**. Provides non-intrusive, real-time feedback on **Mission Progress**, active **Agent Sub-sessions**, and **Technical Metrics** using protocol-safe Toast notifications.
-
-### ⚡ Event-Driven Architecture
-Utilizes a hybrid event-driven pipeline (`EventHandler` + `TaskPoller`) to maximize responsiveness while maintaining robust state tracking and resource cleanup.
-
-### 🔒 Secure Configuration
-Runtime agent configuration is strictly validated using **Zod schemas**, ensuring that custom agent definitions in `agents.json` are type-safe and error-free before execution.
+- **Stagnation Detection**: Senses when no progress is made across iterations
+- **Diagnostic Intervention**: Forces "Diagnostic Mode" mandating log audits and strategy pivots
+- **Proactive Agency**: Mandates Speculative Planning during background task execution
 
 ---
 
-## ⚡ Elite Multi-Agent Swarm
+## � Performance Benchmarks
 
-| Agent | Expertise | Capability |
-|:------|:-----|:---|
-| **Commander** | Mission Hub | Session pooling, parallel thread control, state rehydration, work-stealing coordination |
-| **Planner** | Architect | Symbolic mapping, dependency research, roadmap generation, file-level planning |
-| **Worker** | Implementer | High-throughput coding, TDD workflow, documentation, isolated file execution |
-| **Reviewer** | Auditor | Rigid verification, LSP/Lint authority, integration testing, final mission seal |
+| Metric | Improvement |
+|:-------|:------------|
+| CPU Utilization | 90%+ (up from 50-70%) |
+| Tool Call Speed | 10x faster (5-10ms vs 50-100ms) via Rust pool |
+| Session Creation | 90% faster (50ms vs 500ms) via session pooling |
+| Memory Usage | 60% reduction via object/string/buffer pooling |
+| GC Pressure | 80% reduction |
+| Token Efficiency | 40% reduction via Incremental State & System Transform |
+| Sync Accuracy | 99.95% via MVCC+Mutex |
+| Parallel Efficiency | 80% improvement (50% → 90%+) |
 
 ---
 
-## 📈 Performance Benchmarks
-
-### Throughput & Efficiency
-- **Concurrent Sessions**: 50+ parallel agent sessions with work-stealing
-- **CPU Utilization**: 90%+ (up from 50-70%)
-- **Tool Call Speed**: 10x faster (5-10ms vs 50-100ms) via Rust connection pool
-- **Session Creation**: 90% faster (50ms vs 500ms) via session pooling
-- **Processing Speed**: 3-5x baseline throughput
-
-### Resource Efficiency
-- **Memory Usage**: 60% reduction (40% of baseline) via pooling
-- **GC Pressure**: 80% reduction via object/string/buffer pooling
-- **Token Efficiency**: 40% reduction via Incremental State & System Transform
+## 🏗️ Infrastructure & Reliability
 
-### Reliability
-- **Sync Accuracy**: 99.95% reliability via MVCC+Mutex transaction logic
-- **Mission Survival**: 100% uptime through plugin restarts via S.H.R (Self-Healing Rehydration)
-- **Resource Leaks**: Zero (guaranteed by RAII pattern)
-- **Config Safety**: 100% (atomic writes + auto-backup + rollback)
-
-### Scalability
-- **Work-Stealing Efficiency**: 80% improvement in parallel efficiency (50% → 90%+)
-- **Adaptive Polling**: Dynamic 500ms-5s based on load
-- **Auto-Scaling**: Concurrency slots adjust automatically based on success rate
-
----
+### Resource Safety
+- **RAII Pattern**: Guaranteed resource cleanup with zero leaks
+- **ShutdownManager**: Priority-based graceful shutdown (5s timeout per handler)
+- **Atomic File Operations**: Temp file + rename for corruption-proof writes
+- **Automatic Backups**: Timestamped config backups with rollback support
 
-## 🏗️ Technical Stack
+### Safety Features
+- **Circuit Breaker**: Auto-recovery from API failures (5 failures → open)
+- **Resource Pressure Detection**: Rejects low-priority tasks when memory > 80%
+- **Terminal Node Guard**: Prevents infinite recursion via depth limit
+- **Auto-Scaling**: Concurrency slots adjust based on success/failure rate
 
+### Technical Stack
 - **Runtime**: Node.js 18+ (TypeScript)
 - **Tools**: Rust-based CLI tools (grep, glob, ast) via connection pool
 - **Concurrency**: Chase-Lev work-stealing deque + priority queues
 - **Memory**: Object pooling + string interning + buffer pooling
 - **State Management**: MVCC + Mutex
-- **Safety**: RAII pattern + circuit breaker + resource pressure detection
-
----
-
-## 📚 Documentation
-
-- [Why We Built a Custom Orchestrator Instead of Using OpenCode's APIs →](docs/WHY_CUSTOM_ORCHESTRATOR.md)
-- [System Architecture Deep-Dive →](docs/SYSTEM_ARCHITECTURE.md)
-- [Windows Configuration Guide →](docs/WINDOWS_CONFIGURATION.md)
-- [Developer Notes →](docs/DEVELOPERS_NOTE.md)
+- **Safety**: RAII + circuit breaker + resource pressure detection
 
 ---
 
@@ -210,12 +148,11 @@ Runtime agent configuration is strictly validated using **Zod schemas**, ensurin
 ### Safe Installation
 The installation process is **production-safe** with multiple protection layers:
 
-1. ✅ **Never overwrites** - always merges with existing config
-2. ✅ **Automatic backups** - timestamped, last 5 kept
-3. ✅ **Atomic writes** - temp file + rename (OS-level atomic)
-4. ✅ **Write verification** - ensures correctness after every change
-5. ✅ **Automatic rollback** - restores from backup on any failure
-6. ✅ **Cross-platform** - Windows (native, Git Bash, WSL), macOS, Linux
+1. ✅ **Never overwrites** — always merges with existing config
+2. ✅ **Automatic backups** — timestamped, last 5 kept
+3. ✅ **Atomic writes** — temp file + rename (OS-level atomic)
+4. ✅ **Automatic rollback** — restores from backup on any failure
+5. ✅ **Cross-platform** — Windows (native, Git Bash, WSL2), macOS, Linux
 
 ### Configuration Logs
 - Unix: `/tmp/opencode-orchestrator.log`
@@ -223,9 +160,18 @@ The installation process is **production-safe** with multiple protection layers:
 
 ---
 
+## 📚 Documentation
+
+- [Why We Built a Custom Orchestrator →](docs/WHY_CUSTOM_ORCHESTRATOR.md)
+- [System Architecture Deep-Dive →](docs/SYSTEM_ARCHITECTURE.md)
+- [Windows Configuration Guide →](docs/WINDOWS_CONFIGURATION.md)
+- [Developer Notes →](docs/DEVELOPERS_NOTE.md)
+
+---
+
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License — see [LICENSE](LICENSE) for details.
 
 ---
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).",
-  "version": "1.2.59",
+  "version": "1.2.61",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {
@@ -41,7 +41,7 @@
   "scripts": {
     "docker:build-all": "docker compose run --rm dev && docker compose run --rm win-builder",
     "docker:build-win": "docker compose run --rm win-builder",
-    "docker:rust-dist": "docker compose run --rm dev && sudo chown -R $(id -u):$(id -g) bin/ 2>/dev/null || true",
+    "docker:rust-dist": "docker compose run --rm dev && (sudo chown -R $(id -u):$(id -g) bin/ 2>/dev/null || true)",
     "docker:test": "docker compose run --rm test",
     "docker:clean": "docker compose down -v",
     "build": "rm -rf dist && npx esbuild src/index.ts --bundle --outfile=dist/index.js --platform=node --format=esm && tsc --emitDeclarationOnly && mkdir -p dist/scripts && npx esbuild scripts/postinstall.ts --bundle --outfile=dist/scripts/postinstall.js --platform=node --format=esm && npx esbuild scripts/preuninstall.ts --bundle --outfile=dist/scripts/preuninstall.js --platform=node --format=esm",