opencode-orchestrator 1.0.7 → 1.0.11

package/README.md

@@ -2,13 +2,15 @@
   <img src="assets/logo.png" alt="logo" width="280" />
   <h1>OpenCode Orchestrator</h1>
 
+  <p><b>Next-Gen Autonomous Mastery: Powered by HPFA™ & MSVP™</b></p>
+  <p><i>Redefining Scalability with Fractal Swarm Intelligence and Multi-Stage Integrity</i></p>
+
   [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
   [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
   [![Tests](https://img.shields.io/badge/tests-216%20passed-brightgreen.svg)]()
 </div>
 
-> **Multi-Agent Orchestration Plugin for [OpenCode](https://opencode.ai)**
-
+---
 
 ## ⚡ Quick Start
 
@@ -16,20 +18,28 @@
 npm install -g opencode-orchestrator
 ```
 
-Then in OpenCode:
+Then in OpenCode, launch your mission:
 ```bash
-/extreme-mission "Implement a Diablo2 Online Game for Web"
+/swarm "Architect and Build a Diablo-like Web Game"
 ```
 
-## 🏔️ Extreme Resilience & Performance
+### 🌌 **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. 
 
-Built for "Infinite Missions," the OpenCode Orchestrator is engineered to handle massive codebases and long-running tasks where absolute stability is non-negotiable.
+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.
 
-- **🔄 Continuous Operation (WAL)**: Mission continuity is guaranteed via Write-Ahead Logging. Even after a system crash, the orchestrator "replays" its history from disk to resume complex tasks exactly where they left off.
-- **⚡ 80% Resource Efficiency**: Smart intent-based polling and output caching reduce API overhead by 60-80%. The system intelligently filters redundant traffic, ensuring extreme agility even under heavy multi-agent load.
-- **🧬 Self-Scaling Intelligence**: Real-time success/failure feedback dynamic concurrency. The system learns model reliability and rate limits on the fly, autonomously balancing execution speed with fail-safe stability.
-- **💎 Zero-Leak Architecture**: Rigorous, lifecycle-based resource management ensures 100% memory reclamation. Engineered for sessions lasting 10,000+ iterations without a single byte of memory drift.
 
+## 💎 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
 
@@ -63,73 +73,90 @@ Built for "Infinite Missions," the OpenCode Orchestrator is engineered to handle
 | 🤝 **Specialized Roles** | Each agent has a clear, focused responsibility |
 
 
-## 🏛️ Workflow Architecture
+## 🏛️ Hyper-Parallel Architecture: HPFA & MSVP
+
+The orchestrator eliminates the linear reasoning bottleneck of conventional AI agents by shifting from sequential execution to a **Distributed Runtime Unit** paradigm.
+
+### 🧬 **HPFA™ (Hyper-Parallel Fractal Architecture)**
+HPFA defines a recursive problem-solving model that decomposes massive codebases into atomic task units through a fractal hierarchy.
+*   **Fractal Delegation**: Workers are instantiated as autonomous controllers with localized `TaskLauncher` contexts. This enables recursive spawning of sub-agents up to 8 levels deep, mapping complex architectural hierarchies into a parallel execution grid.
+*   **Cognitive Concurrency Control**: A dedicated state-machine manages up to 50 concurrent sessions. It monitors success/failure trajectories to dynamically scale concurrency slots, ensuring maximum throughput while maintaining strict rate-limit compliance.
+
+### 🛡️ **MSVP™ (Multi-Stage Verification Pipeline)**
+MSVP ensures continuous integration integrity by decoupling verification from the implementation lifecycle, treating code review as a parallel background-thread.
+*   **Shadow Review Pipeline**: Upon every file-write operation, a parallel reviewer session is instantly snapshotted (Unit-level Verification). This zero-latency audit identifies defects the millisecond they are introduced, without blocking the primary implementation thread.
+*   **Global Barrier-Sync Protocol**: Implements a synchronized verification gate. The system enforces a blocking "Barrier" that requires consistency across all distributed units before transitioning to the final Master Review (E2E Integration) and Mission Sealing.
 
 ```
-              /extreme-mission "Build REST API"
-                          │
-          ╔═══════════════════════════════════════╗
-          ║     🎯 COMMANDER — Orchestrator       ║
-          ║        (Main Session - Single)        ║
-          ╚═══════════════════╤═══════════════════╝
-                              │
-          ┌───────────────────▼───────────────────┐
-          │      📋 PLANNER — Create Plan         │
-          │         (Single, Sync Call)           │
-          │    → Outputs: .opencode/todo.md       │
-          └───────────────────┬───────────────────┘
-                              │
+              /swarm "Build Complex System"
+                           │
+           ╔═══════════════════════════════════════╗
+           ║     🎯 COMMANDER — Orchestrator       ║
+           ║        (Main Session - Single)        ║
+           ╚═══════════════════╤═══════════════════╝
+                               │
+           ┌───────────────────▼───────────────────┐
+           │      📋 PLANNER — Create Plan         │
+           │    → Outputs: Architectural Grid      │
+           └───────────────────┬───────────────────┘
+                               │
     ══════════════════════════╧══════════════════════════
-    ║                  🔥 PARALLEL ZONE                  ║
-    ══════════════════════════════════════════════════════
-          │               │               │
-          ▼               ▼               ▼
-    ┌──────────┐   ┌──────────┐   ┌──────────┐
-    │ 🔨 WORKER│   │ 🔨 WORKER│   │ 🔨 WORKER│  ← Up to 50
-    │  Task 1  │   │  Task 2  │   │  Task 3  │    concurrent
-    │ auth.ts  │   │  api.ts  │   │  db.ts   │    sessions
-    └────┬─────┘   └────┬─────┘   └────┬─────┘
-         │              │              │
+    ║            🔥 HPFA PARALLEL GRID (MSVP)           ║
     ══════════════════════════════════════════════════════
-    ║                  ⏳ SYNC BARRIER                   ║
+    │               │               │               │
+    ▼               ▼               ▼               ▼
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│🔨 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                     ║
     ══════════════════════════════════════════════════════
-                              │
-          ┌───────────────────▼───────────────────┐
-          │      ✅ REVIEWER — Verify All         │
-          │         (Single, Sync Call)           │
-          │    → Tests, Lint, Integration         │
-          └───────────────────┬───────────────────┘
-                              │
-                    ┌─────────┴─────────┐
-                    │   All Complete?   │
-                    │   Issues = 0?     │
-                    └─────────┬─────────┘
-                        No ↙     ↘ Yes
-                    ♻️ LOOP    🎖️ MISSION
-                   (back to     SEALED
-                   Commander)
+                               │
+           ┌───────────────────▼───────────────────┐
+           │      ✅ MASTER REVIEWER — Final Pass  │
+           │         (Cross-module Integration)    │
+           │    → Stage 2: E2E & System Integrity  │
+           └───────────────────┬───────────────────┘
+                               │
+                     ┌─────────┴─────────┐
+                     │   Seal Conditions │
+                     │   Verified?       │
+                     └─────────┬─────────┘
+                         No ↙     ↘ Yes
+                     ♻️ LOOP    🎖️ MISSION
+                    (Adaptive)   SEALED
 ```
 
-### Execution Model
+### Execution Model (MSVP)
 
-| Phase | Agent | Parallelism | Blocking |
-|:------|:------|:------------|:---------|
-| 1️⃣ Plan | Planner | **Single** | Sync (waits) |
-| 2️⃣ Execute | Workers | **Parallel** (up to 50) | Async (background) |
-| 3️⃣ Verify | Reviewer | **Single** | Sync (waits) |
-| 4️⃣ Loop | Commander | **Single** | Coordinates |
+| 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 |
 |:---------|:-------------|
-| 🚀 **60-80% Optimization**| Smart polling & output caching for massive speed gains |
-| ⚡ **50 Parallel Tasks** | Run up to 50 agents simultaneously |
-| 🔄 **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 |
-| 🧬 **Adaptive AI** | Agents learn and adapt based on the project |
+| 🚀 **MSVP™ Pipeline** | Zero-latency unit reviews triggered the millisecond code is written |
+| 🧬 **Fractal Spawning** | Workers recursively spawn sub-agents for infinite structural depth |
+| ⚡ **50 Parallel Tasks** | Titan-class density—run massive swarms without breaking a sweat |
+| 🔄 **Non-Stop Recovery** | WAL-powered cognitive persistence; resumes instantly after any crash |
+| 🔥 **Multi-File Ops** | Massive parallel edits with cross-file context integrity |
+| 🛡️ **Self-Scaling** | Dynamic AI-driven concurrency management based on success velocity |
+| 🩹 **Memory Integrity** | 100% reclamation; engineered for sessions with 10k+ iterations |
+| 🏗️ **Clean-Code Engine**| Enforces industrial modularity and clean architectural patterns |
 
 ---
 
@@ -145,14 +172,13 @@ Built for "Infinite Missions," the OpenCode Orchestrator is engineered to handle
 | 🔨 Build failure | Fix the issue and retry |
 
 
-## 📚 Documentation
-
-- **[System Architecture](docs/SYSTEM_ARCHITECTURE.md)** — Full technical deep-dive
-
+---
 
 ## 🎹 Developer's Words
 
-> [Read the full note →](docs/DEVELOPERS_NOTE.md)
+> "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 →](docs/DEVELOPERS_NOTE.md)
 
 
 ## 📄 License

package/dist/agents/prompts/common/hyper-parallel.d.ts

@@ -0,0 +1,4 @@
+/**
+ * HPFA (Hyper-Parallel Fractal Architecture) Guidelines
+ */
+export declare const HYPER_PARALLEL_ENFORCEMENT: string;

package/dist/agents/prompts/common/index.d.ts

@@ -13,3 +13,4 @@ export { CORE_PHILOSOPHY } from "./core-philosophy.js";
 export { SHARED_LSP_TOOLS } from "./lsp.js";
 export { SHARED_AST_TOOLS } from "./ast.js";
 export { MODULARITY_ENFORCEMENT } from "./modularity.js";
+export { HYPER_PARALLEL_ENFORCEMENT } from "./hyper-parallel.js";

package/dist/core/agents/interfaces/launch-input.interface.d.ts

@@ -7,4 +7,6 @@ export interface LaunchInput {
     agent: string;
     parentSessionID: string;
     depth?: number;
+    mode?: "normal" | "race" | "fractal";
+    groupID?: string;
 }

package/dist/core/agents/interfaces/parallel-task.interface.d.ts

@@ -17,6 +17,8 @@ export interface ParallelTask {
     result?: string;
     concurrencyKey?: string;
     depth: number;
+    mode?: "normal" | "race" | "fractal";
+    groupID?: string;
     lastMsgCount?: number;
     stablePolls?: number;
     progress?: TaskProgress;

package/dist/core/agents/manager/event-handler.d.ts

@@ -14,7 +14,8 @@ export declare class EventHandler {
     private notifyParentIfAllComplete;
     private scheduleCleanup;
     private validateSessionHasOutput;
-    constructor(client: OpencodeClient, store: TaskStore, concurrency: ConcurrencyController, findBySession: (sessionID: string) => ParallelTask | undefined, notifyParentIfAllComplete: (parentSessionID: string) => Promise<void>, scheduleCleanup: (taskId: string) => void, validateSessionHasOutput: (sessionID: string) => Promise<boolean>);
+    private onTaskComplete?;
+    constructor(client: OpencodeClient, store: TaskStore, concurrency: ConcurrencyController, findBySession: (sessionID: string) => ParallelTask | undefined, notifyParentIfAllComplete: (parentSessionID: string) => Promise<void>, scheduleCleanup: (taskId: string) => void, validateSessionHasOutput: (sessionID: string) => Promise<boolean>, onTaskComplete?: ((task: ParallelTask) => void | Promise<void>) | undefined);
     /**
      * Handle OpenCode session events for proper resource cleanup.
      * Call this from your plugin's event hook.

package/dist/core/agents/manager/task-poller.d.ts

@@ -13,8 +13,9 @@ export declare class TaskPoller {
     private notifyParentIfAllComplete;
     private scheduleCleanup;
     private pruneExpiredTasks;
+    private onTaskComplete?;
     private pollingInterval?;
-    constructor(client: OpencodeClient, store: TaskStore, concurrency: ConcurrencyController, notifyParentIfAllComplete: (parentSessionID: string) => Promise<void>, scheduleCleanup: (taskId: string) => void, pruneExpiredTasks: () => void);
+    constructor(client: OpencodeClient, store: TaskStore, concurrency: ConcurrencyController, notifyParentIfAllComplete: (parentSessionID: string) => Promise<void>, scheduleCleanup: (taskId: string) => void, pruneExpiredTasks: () => void, onTaskComplete?: ((task: ParallelTask) => void | Promise<void>) | undefined);
     start(): void;
     stop(): void;
     isRunning(): boolean;

package/dist/core/agents/manager.d.ts

@@ -54,6 +54,7 @@ export declare class ParallelAgentManager {
     }): void;
     private findBySession;
     private handleTaskError;
+    private handleTaskComplete;
     private recoverActiveTasks;
 }
 export declare const parallelAgentManager: {

package/dist/index.js

@@ -288,10 +288,11 @@ var PARALLEL_TASK = {
   // Task lifecycle (24 hours for long tasks)
   TTL_MS: 24 * TIME.HOUR,
   CLEANUP_DELAY_MS: 10 * TIME.MINUTE,
-  MAX_DEPTH: 3,
-  // Concurrency limits (safe for most APIs)
-  DEFAULT_CONCURRENCY: 3,
-  MAX_CONCURRENCY: 10,
+  MAX_DEPTH: 8,
+  // Titan-Class depth for complex fractal missions
+  // Concurrency limits (Aggressive for intense processing)
+  DEFAULT_CONCURRENCY: 10,
+  MAX_CONCURRENCY: 50,
   // Sync polling (for delegate_task sync mode)
   // Optimized: Reduced polling frequency while relying more on events
   SYNC_TIMEOUT_MS: 5 * TIME.MINUTE,
@@ -630,7 +631,7 @@ var PROMPTS = {
 
 // src/shared/message/constants/slash-commands.ts
 var COMMAND_NAMES = {
-  TASK: "extreme-mission",
+  TASK: "swarm",
   PLAN: "plan",
   STATUS: "status",
   STOP: "stop",
@@ -13713,6 +13714,42 @@ If a single unit of code (file or module) starts to handle multiple distinct con
 -   If you have to scroll through "screens of code" to find a different type of logic, it belongs in a new file or sub-folder.
 ${PROMPT_TAGS.QUALITY_CHECKLIST.close}`;
 
+// src/agents/prompts/common/hyper-parallel.ts
+var HYPER_PARALLEL_ENFORCEMENT = `${PROMPT_TAGS.QUALITY_CHECKLIST.open}
+\u{1F680} HYPER-PARALLEL COGNITIVE ARCHITECTURE (HPFA)
+
+To achieve maximum velocity, you MUST leverage these advanced parallel execution patterns:
+
+### 1. Fractal Self-Delegation (Recursive Scaling)
+If you are a Worker and your assigned task is complex (e.g., implementing multiple endpoints, refactoring several files), **do not do it sequentially**.
+-   **Spawn Sub-Workers**: Use \`delegate_task\` to launch sub-agents for independent sub-components.
+-   **Fractal Depth**: You can scale down to any depth. Each worker acts as a local coordinator for its sub-workers.
+-   **Context Sharding**: Give each sub-worker a focused, atomic prompt and relevant file context.
+
+### 2. Speculative Racing (Competitive Implementation)
+When faced with a high-uncertainty problem (bug fixing, complex refactoring with multiple possible approaches):
+-   **Launch a Race**: Spawn multiple Workers (\`mode: "race"\`) with slightly different prompts or strategies.
+-   **Winning Criteria**: The first agent to produce a solution that passes unit tests "wins".
+-   **Efficiency**: This eliminates the "try-fail-repeat" loop by trying all likely solutions simultaneously.
+
+### 3. Asynchronous Batching
+When you need to perform many independent reads or metadata checks:
+-   **Batch Operations**: Group your tool calls to trigger massive parallel execution host-side.
+-   **Avoid Serial Bottlenecks**: Never wait for a tool result if you have other independent tasks you could be launching in parallel.
+
+### 4. Barrier-Sync Integrated Pipeline (BSIP)
+Don't wait for all workers to finish before starting reviews:
+-   **Pipelined Verification**: Immediately spawn a Reviewer task as soon as a Worker finishes its individual sub-task. The review of Module A happens while Module B is still being built.
+-   **Synchronization Point**: Use the "Final Sync Barrier" to wait for all parallel implementation AND individual reviews to complete.
+-   **Global Integration**: The final master Reviewer only acts once all individual units have been verified by their respective sub-reviewers.
+
+### 5. Real-time Brain Sync
+As you work in a parallel session, log your critical findings or discovered interface changes to the shared task log. 
+Assume that:
+-   **Global Awareness**: Other workers are aware of your public findings.
+-   **Consistency**: You must check for "Global Context Updates" to ensure your parallel work aligns with the latest state of the system.
+${PROMPT_TAGS.QUALITY_CHECKLIST.close}`;
+
 // src/agents/prompts/commander/role.ts
 var COMMANDER_ROLE = `${PROMPT_TAGS.ROLE.open}
 You are ${AGENT_NAMES.COMMANDER}. Autonomous mission controller.
@@ -15330,6 +15367,7 @@ var commander = {
 var systemPrompt2 = [
   PLANNER_ROLE,
   MODULARITY_ENFORCEMENT,
+  HYPER_PARALLEL_ENFORCEMENT,
   PLANNER_FORBIDDEN,
   PLANNER_REQUIRED,
   ENVIRONMENT_DISCOVERY,
@@ -15356,6 +15394,7 @@ var planner = {
 var systemPrompt3 = [
   WORKER_ROLE,
   MODULARITY_ENFORCEMENT,
+  HYPER_PARALLEL_ENFORCEMENT,
   WORKER_FORBIDDEN,
   WORKER_REQUIRED,
   ANTI_HALLUCINATION_CORE,
@@ -15384,6 +15423,7 @@ var worker = {
 var systemPrompt4 = [
   REVIEWER_ROLE,
   MODULARITY_ENFORCEMENT,
+  HYPER_PARALLEL_ENFORCEMENT,
   REVIEWER_FORBIDDEN,
   REVIEWER_REQUIRED,
   REVIEWER_VERIFICATION,
@@ -15492,7 +15532,7 @@ $ARGUMENTS
 </execution_rules>
 </mission>`;
 var COMMANDS = {
-  "extreme-mission": {
+  "swarm": {
     description: "MISSION MODE - Execute task autonomously until complete",
     template: MISSION_MODE_TEMPLATE,
     argumentHint: '"mission goal"'
@@ -15553,7 +15593,7 @@ THINK \u2192 PLAN \u2192 DELEGATE \u2192 EXECUTE \u2192 VERIFY \u2192 COMPLETE
 
 ## Usage
 - Select **${AGENT_NAMES.COMMANDER}** and type your request
-- Or use \`/extreme-mission "your mission"\` explicitly
+- Or use \`/swarm "your mission"\` explicitly
 - ${AGENT_NAMES.COMMANDER} automatically coordinates all agents`
   }
 };
@@ -16209,7 +16249,7 @@ var ConcurrencyController = class {
       this.failureCount.set(key, 0);
       if (streak % 5 === 0) {
         const currentLimit = this.getConcurrencyLimit(key);
-        if (currentLimit < 20) {
+        if (currentLimit < PARALLEL_TASK.MAX_CONCURRENCY) {
           this.setLimit(key, currentLimit + 1);
           log(`[concurrency] Auto-scaling UP for ${key}: ${currentLimit + 1}`);
         }
@@ -17020,6 +17060,11 @@ var TaskLauncher = class {
    * Prepare task: Create session and registration without blocking on concurrency
    */
   async prepareTask(input) {
+    const currentDepth = input.depth ?? 0;
+    if (currentDepth >= PARALLEL_TASK.MAX_DEPTH) {
+      log(`[task-launcher.ts] Task depth limit reached (${currentDepth}/${PARALLEL_TASK.MAX_DEPTH}). Generation blocked.`);
+      throw new Error(`Maximum task depth (${PARALLEL_TASK.MAX_DEPTH}) reached. To prevent infinite recursion, no further sub-tasks can be spawned.`);
+    }
     const createResult = await this.client.session.create({
       body: {
         parentID: input.parentSessionID,
@@ -17043,7 +17088,9 @@ var TaskLauncher = class {
       // Start as PENDING
       startedAt: /* @__PURE__ */ new Date(),
       concurrencyKey: input.agent,
-      depth: (input.depth ?? 0) + 1
+      depth: (input.depth ?? 0) + 1,
+      mode: input.mode || "normal",
+      groupID: input.groupID
     };
     this.store.set(taskId, task);
     this.store.trackPending(input.parentSessionID, taskId);
@@ -17079,10 +17126,11 @@ var TaskLauncher = class {
         body: {
           agent: task.agent,
           tools: {
-            delegate_task: false,
-            get_task_result: false,
-            list_tasks: false,
-            cancel_task: false
+            // HPFA: Allow agents to delegate sub-tasks (Fractal Spawning)
+            delegate_task: true,
+            get_task_result: true,
+            list_tasks: true,
+            cancel_task: true
           },
           parts: [{ type: PART_TYPES.TEXT, text: task.prompt }]
         }
@@ -17153,13 +17201,14 @@ var CONFIG = {
 
 // src/core/agents/manager/task-poller.ts
 var TaskPoller = class {
-  constructor(client, store, concurrency, notifyParentIfAllComplete, scheduleCleanup, pruneExpiredTasks) {
+  constructor(client, store, concurrency, notifyParentIfAllComplete, scheduleCleanup, pruneExpiredTasks, onTaskComplete) {
     this.client = client;
     this.store = store;
     this.concurrency = concurrency;
     this.notifyParentIfAllComplete = notifyParentIfAllComplete;
     this.scheduleCleanup = scheduleCleanup;
     this.pruneExpiredTasks = pruneExpiredTasks;
+    this.onTaskComplete = onTaskComplete;
   }
   pollingInterval;
   start() {
@@ -17243,6 +17292,9 @@ var TaskPoller = class {
     this.scheduleCleanup(task.id);
     taskWAL.log(WAL_ACTIONS.COMPLETE, task).catch(() => {
     });
+    if (this.onTaskComplete) {
+      Promise.resolve(this.onTaskComplete(task)).catch((err) => log("Error in onTaskComplete callback:", err));
+    }
     const duration3 = formatDuration(task.startedAt, task.completedAt);
     presets.sessionCompleted(task.sessionID, duration3);
     log(`Completed ${task.id} (${duration3})`);
@@ -17399,7 +17451,7 @@ You will be notified when ALL tasks complete. Continue productive work.`;
 
 // src/core/agents/manager/event-handler.ts
 var EventHandler = class {
-  constructor(client, store, concurrency, findBySession, notifyParentIfAllComplete, scheduleCleanup, validateSessionHasOutput2) {
+  constructor(client, store, concurrency, findBySession, notifyParentIfAllComplete, scheduleCleanup, validateSessionHasOutput2, onTaskComplete) {
     this.client = client;
     this.store = store;
     this.concurrency = concurrency;
@@ -17407,6 +17459,7 @@ var EventHandler = class {
     this.notifyParentIfAllComplete = notifyParentIfAllComplete;
     this.scheduleCleanup = scheduleCleanup;
     this.validateSessionHasOutput = validateSessionHasOutput2;
+    this.onTaskComplete = onTaskComplete;
   }
   /**
    * Handle OpenCode session events for proper resource cleanup.
@@ -17455,6 +17508,9 @@ var EventHandler = class {
     this.scheduleCleanup(task.id);
     taskWAL.log(WAL_ACTIONS.COMPLETE, task).catch(() => {
     });
+    if (this.onTaskComplete) {
+      Promise.resolve(this.onTaskComplete(task)).catch((err) => log("Error in onTaskComplete callback:", err));
+    }
     log(`Task ${task.id} completed via session.idle event (${formatDuration(task.startedAt, task.completedAt)})`);
   }
   handleSessionDeleted(task) {
@@ -17501,7 +17557,8 @@ var ParallelAgentManager = class _ParallelAgentManager {
       this.concurrency,
       (parentSessionID) => this.cleaner.notifyParentIfAllComplete(parentSessionID),
       (taskId) => this.cleaner.scheduleCleanup(taskId),
-      () => this.cleaner.pruneExpiredTasks()
+      () => this.cleaner.pruneExpiredTasks(),
+      (task) => this.handleTaskComplete(task)
     );
     this.launcher = new TaskLauncher(
       client,
@@ -17525,7 +17582,8 @@ var ParallelAgentManager = class _ParallelAgentManager {
       (sessionID) => this.findBySession(sessionID),
       (parentSessionID) => this.cleaner.notifyParentIfAllComplete(parentSessionID),
       (taskId) => this.cleaner.scheduleCleanup(taskId),
-      (sessionID) => this.poller.validateSessionHasOutput(sessionID)
+      (sessionID) => this.poller.validateSessionHasOutput(sessionID),
+      (task) => this.handleTaskComplete(task)
     );
     this.recoverActiveTasks().catch((err) => {
       log("Recovery error:", err);
@@ -17645,6 +17703,30 @@ var ParallelAgentManager = class _ParallelAgentManager {
     taskWAL.log(WAL_ACTIONS.UPDATE, task).catch(() => {
     });
   }
+  async handleTaskComplete(task) {
+    if (task.agent === AGENT_NAMES.WORKER && task.mode !== "race") {
+      log(`[MSVP] Triggering 1\uCC28 \uB9AC\uBDF0 (Unit Review) for task ${task.id}`);
+      try {
+        await this.launch({
+          agent: AGENT_NAMES.REVIEWER,
+          description: `1\uCC28 \uB9AC\uBDF0: ${task.description}`,
+          prompt: `\uC9C4\uD589\uB41C \uC791\uC5C5(\`${task.description}\`)\uC5D0 \uB300\uD574 1\uCC28 \uB9AC\uBDF0(\uC720\uB2DB \uAC80\uC99D)\uB97C \uC218\uD589\uD558\uC138\uC694.
+\uC8FC\uC694 \uC810\uAC80 \uC0AC\uD56D:
+1. \uD574\uB2F9 \uBAA8\uB4C8\uC758 \uC720\uB2DB \uD14C\uC2A4\uD2B8 \uCF54\uB4DC \uC791\uC131 \uC5EC\uBD80 \uBC0F \uD1B5\uACFC \uD655\uC778
+2. \uCF54\uB4DC \uD488\uC9C8 \uBC0F \uBAA8\uB4C8\uC131 \uC900\uC218 \uC5EC\uBD80
+3. \uBC1C\uACAC\uB41C \uACB0\uD568 \uC989\uC2DC \uC218\uC815 \uC9C0\uC2DC \uB610\uB294 \uB9AC\uD3EC\uD2B8
+
+\uC774 \uC791\uC5C5\uC740 \uC804\uCCB4 \uD1B5\uD569 \uC804 \uBD80\uD488 \uB2E8\uC704\uC758 \uC644\uACB0\uC131\uC744 \uBCF4\uC7A5\uD558\uAE30 \uC704\uD568\uC785\uB2C8\uB2E4.`,
+          parentSessionID: task.parentSessionID,
+          depth: task.depth,
+          groupID: task.groupID || task.id
+          // Group reviews with their origins
+        });
+      } catch (error45) {
+        log(`[MSVP] Failed to trigger review for ${task.id}:`, error45);
+      }
+    }
+  }
   async recoverActiveTasks() {
     const tasks = await taskWAL.readAll();
     if (tasks.size === 0) return;
@@ -17824,12 +17906,17 @@ var createDelegateTaskTool = (manager, client) => tool({
     description: tool.schema.string().describe("Task description"),
     prompt: tool.schema.string().describe("Prompt for the agent"),
     background: tool.schema.boolean().describe("true=async, false=sync"),
-    resume: tool.schema.string().optional().describe("Session ID to resume (from previous task.sessionID)")
+    resume: tool.schema.string().optional().describe("Session ID to resume (from previous task.sessionID)"),
+    mode: tool.schema.enum(["normal", "race", "fractal"]).optional().describe("Task mode (race=first wins, fractal=recursive)"),
+    groupID: tool.schema.string().optional().describe("Group ID for racing or tracking recursive families")
   },
   async execute(args, context) {
-    const { agent, description, prompt, background, resume } = args;
+    const { agent, description, prompt, background, resume, mode, groupID } = args;
     const ctx = context;
-    log(`${PARALLEL_LOG.DELEGATE_TASK} execute() called`, { agent, description, background, resume, parentSession: ctx.sessionID });
+    const allTasks = manager.getAllTasks();
+    const parentTask = allTasks.find((t) => t.sessionID === ctx.sessionID);
+    const parentDepth = parentTask?.depth ?? 0;
+    log(`${PARALLEL_LOG.DELEGATE_TASK} execute() called`, { agent, description, background, resume, mode, groupID, parentSession: ctx.sessionID, depth: parentDepth });
     const sessionClient = client;
     if (background === void 0) {
       return `${OUTPUT_LABEL.ERROR} 'background' parameter is REQUIRED.`;
@@ -17842,8 +17929,12 @@ var createDelegateTaskTool = (manager, client) => tool({
           parentSessionID: ctx.sessionID,
           agent,
           // Assuming agent is needed for resume context
-          description
+          description,
           // Assuming description is needed for resume context
+          mode,
+          groupID,
+          depth: parentDepth
+          // Preserve depth on resume
         };
         const launchResult = await manager.launch(input);
         const task = Array.isArray(launchResult) ? launchResult[0] : launchResult;
@@ -17881,7 +17972,10 @@ ${text || "(No output)"}`;
           agent,
           description,
           prompt,
-          parentSessionID: ctx.sessionID
+          parentSessionID: ctx.sessionID,
+          mode,
+          groupID,
+          depth: parentDepth
         });
         const task = Array.isArray(launchResult) ? launchResult[0] : launchResult;
         presets.taskStarted(task.id, agent);

package/dist/shared/message/constants/slash-commands.d.ts

@@ -2,7 +2,7 @@
  * Slash Commands (with slash prefix)
  */
 export declare const SLASH_COMMANDS: {
-    readonly TASK: "/extreme-mission";
+    readonly TASK: "/swarm";
     readonly PLAN: "/plan";
     readonly STATUS: "/status";
     readonly STOP: "/stop";
@@ -12,7 +12,7 @@ export declare const SLASH_COMMANDS: {
  * Command Names (without slash prefix, for comparison after parsing)
  */
 export declare const COMMAND_NAMES: {
-    readonly TASK: "extreme-mission";
+    readonly TASK: "swarm";
     readonly PLAN: "plan";
     readonly STATUS: "status";
     readonly STOP: "stop";

package/dist/shared/task/constants/parallel-task.d.ts

@@ -1,12 +1,17 @@
 /**
  * Parallel Task Configuration
  */
+export declare const TASK_MODE: {
+    readonly NORMAL: "normal";
+    readonly RACE: "race";
+    readonly FRACTAL: "fractal";
+};
 export declare const PARALLEL_TASK: {
     readonly TTL_MS: number;
     readonly CLEANUP_DELAY_MS: number;
-    readonly MAX_DEPTH: 3;
-    readonly DEFAULT_CONCURRENCY: 3;
-    readonly MAX_CONCURRENCY: 10;
+    readonly MAX_DEPTH: 8;
+    readonly DEFAULT_CONCURRENCY: 10;
+    readonly MAX_CONCURRENCY: 50;
     readonly SYNC_TIMEOUT_MS: number;
     readonly POLL_INTERVAL_MS: 2000;
     readonly MIN_IDLE_TIME_MS: number;

package/dist/tools/parallel/delegate-task.d.ts

@@ -18,6 +18,12 @@ export declare const createDelegateTaskTool: (manager: ParallelAgentManager, cli
         prompt: import("zod").ZodString;
         background: import("zod").ZodBoolean;
         resume: import("zod").ZodOptional<import("zod").ZodString>;
+        mode: import("zod").ZodOptional<import("zod").ZodEnum<{
+            normal: "normal";
+            race: "race";
+            fractal: "fractal";
+        }>>;
+        groupID: import("zod").ZodOptional<import("zod").ZodString>;
     };
     execute(args: {
         agent: string;
@@ -25,5 +31,7 @@ export declare const createDelegateTaskTool: (manager: ParallelAgentManager, cli
         prompt: string;
         background: boolean;
         resume?: string | undefined;
+        mode?: "normal" | "race" | "fractal" | undefined;
+        groupID?: string | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };

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.0.7",
+  "version": "1.0.11",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {