JSPM

opencode-orchestrator

1.0.10
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 910
  • Score
    100M100P100Q100892F
  • License MIT

Distributed Cognitive Architecture for OpenCode. Turns simple prompts into specialized multi-agent workflows (Planner, Coder, Reviewer).

Package Exports

  • opencode-orchestrator

Readme

logo

OpenCode Orchestrator

Next-Gen Autonomous Mastery: Powered by HPFAβ„’ & MSVPβ„’

Redefining Scalability with Fractal Swarm Intelligence and Multi-Stage Integrity

MIT License npm Tests


🌌 The End of Sequential Limits. The Era of Fractal Mastery.

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.

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.

⚑ Quick Start

npm install -g opencode-orchestrator

Then in OpenCode, launch your mission:

/extreme-mission "Architect and Build a Diablo-like Web Engine"

πŸ’Ž The Four Pillars of Excellence

We’ve combined industrial-grade reliability with cutting-edge parallel intelligence to redefine what’s possible in AI coding.

  • ⚑ Velocity: Parallelize up to 50 concurrent sessions. What takes hours for others is finished in minutes through Cognitive Elasticity.
  • 🧬 Scale: Fractal Delegation allows workers to recursively spawn their own sub-agents. No task is too big for a system that can replicate its own intelligence.
  • πŸ›‘οΈ Safety: Our MSVP (Multi-Stage Verification Pipeline) reviews every line of code in parallel "Shadow Sessions" before it ever touches your build.
  • ♾️ Trust: Iron-Clad Reliability via Write-Ahead Logging (WAL). Even after a crash, the system replays its history to resume exactly where it was.

⭐ Core Philosophy

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  πŸ” EXPLORE β†’ πŸ“ LEARN β†’ πŸ”„ ADAPT β†’ ⚑ ACT         β”‚
β”‚  Scan        Document    Adjust      Execute      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ The Agents

Agent Role What It Does
🎯 Commander Orchestrator Leads the task, delegates work to other agents, ensures completion
πŸ“‹ Planner Researcher Analyzes the project, creates the plan, documents findings
πŸ”¨ Worker Implementer Writes code, modifies files, follows the project's patterns
βœ… Reviewer Verifier Tests changes, checks for errors, confirms quality

πŸ“– Principles

Principle What It Means
πŸ” Never Assume Always check the actual code and config files first
πŸ“ Document Everything Record patterns and findings for future tasks
πŸ“š Verify with Evidence Run tests, cite sources, complete with proof
πŸ”„ Adapt to the Project Match the project's existing style and patterns
🀝 Specialized Roles Each agent has a clear, focused responsibility

πŸ›οΈ Hyper-Parallel Architecture: HPFA & MSVP

The orchestrator eliminates the linear bottleneck of AI development through two breakthrough technologies:

🧬 HPFA (Hyper-Parallel Fractal Architecture)

Imagine an agent that doesn't just work, but thinks like a Hive Mind.

  • Fractal Delegation: Workers are no longer just "doers." They are mini-planners that can recursively spawn their own sub-agents to handle complexity at every level.
  • Speculative Racing: Ambiguous tasks are solved using multiple strategies in parallel. The fastest, most accurate path wins, while others are prunedβ€”minimizing latency and maximizing quality.

πŸ›‘οΈ MSVP (Multi-Stage Verification Pipeline)

Speed is nothing without accuracy. MSVP ensures your code is production-ready at every second.

  • Shadow Parallel Review: As soon as a file is written, a parallel reviewer session is already validating it before the main task even finishes.
  • Barrier-Sync Integration: A 4-stage verification gate that prevents "architectural drift" by forcing a global synchronization barrier before final sealing.
              /extreme-mission "Build Complex System"
                           β”‚
           ╔═══════════════════════════════════════╗
           β•‘     🎯 COMMANDER β€” Orchestrator       β•‘
           β•‘        (Main Session - Single)        β•‘
           β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•€β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•
                               β”‚
           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
           β”‚      πŸ“‹ PLANNER β€” Create Plan         β”‚
           β”‚    β†’ Outputs: Architectural Grid      β”‚
           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
    ══════════════════════════╧══════════════════════════
    β•‘            πŸ”₯ HPFA PARALLEL GRID (MSVP)           β•‘
    ══════════════════════════════════════════════════════
    β”‚               β”‚               β”‚               β”‚
    β–Ό               β–Ό               β–Ό               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚πŸ”¨ WORKER β”‚    β”‚πŸ”¨ WORKER β”‚    β”‚πŸ”¨ WORKER β”‚    β”‚πŸ”¨ WORKER β”‚  <-- Fractal Spawning
β”‚ Module A β”‚    β”‚ Module B β”‚    β”‚ Module C β”‚    β”‚ Module D β”‚
β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
     β”‚ ⚑ Instant    β”‚ ⚑ Instant    β”‚ ⚑ Instant    β”‚ ⚑ Instant
     β–Ό Review       β–Ό Review       β–Ό Review       β–Ό Review
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚βœ… REVIEWRβ”‚    β”‚βœ… REVIEWRβ”‚    β”‚βœ… REVIEWRβ”‚    β”‚βœ… REVIEWRβ”‚  <-- Stage 1: Unit
β”‚ (Unit-A) β”‚    β”‚ (Unit-B) β”‚    β”‚ (Unit-C) β”‚    β”‚ (Unit-D) β”‚      Verification
β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
     β”‚               β”‚               β”‚               β”‚
    ═▼═══════════════▼═══════════════▼═══════════════▼════
    β•‘                ⏳ SYNC BARRIER                     β•‘
    ══════════════════════════════════════════════════════
                               β”‚
           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
           β”‚      βœ… MASTER REVIEWER β€” Final Pass  β”‚
           β”‚         (Cross-module Integration)    β”‚
           β”‚    β†’ Stage 2: E2E & System Integrity  β”‚
           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                               β”‚
                     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                     β”‚   Seal Conditions β”‚
                     β”‚   Verified?       β”‚
                     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         No ↙     β†˜ Yes
                     ♻️ LOOP    πŸŽ–οΈ MISSION
                    (Adaptive)   SEALED

Execution Model (MSVP)

Phase Agent Parallelism Verification Level
1️⃣ Plan Planner Single Static Analysis
2️⃣ Implement Workers HPFA Parallel Direct Coding
3️⃣ Unit Pass Reviewers Shadow Parallel 1μ°¨ 리뷰: Unit Tests (Async)
4️⃣ Final Sync Barrier Blocking All Units Verified
5️⃣ Integration Master Reviewer Single 2μ°¨ 리뷰: Full E2E & Sync

Features

Feature What It Does
πŸš€ MSVP Pipeline Parallel unit reviews triggered immediately after worker tasks
🧬 Fractal Spawning Workers can recursively spawn sub-missions for complex tasks
⚑ 20+ Parallel Tasks High-intensity execution with safety concurrency limits
πŸ”„ Non-Stop Recovery WAL-based persistence (resumes tasks after crashes)
πŸ”₯ Multi-File Ops Work on different files at the same time
πŸ›‘οΈ Self-Scaling Dynamic concurrency limits based on success/failure
🩹 Memory Integrity Strict resource cleanup prevents leaks in long sessions
πŸ—οΈ Architectural Modularity Enforces language-agnostic clean code principles

Error Handling

Error What Happens
πŸ’₯ Tool crash Inject recovery prompt and retry
🚦 Rate limit hit Wait and retry with exponential backoff
πŸ“¦ Context overflow Compact the context automatically
⏱️ Session timeout Resume from the last checkpoint
πŸ”¨ Build failure Fix the issue and retry

🎹 Developer's Words

"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."

Read the full Developer's Note β†’

πŸ“„ License

MIT License. LICENSE