opencode-orchestrator 1.3.11 → 1.5.0

package/README.md

@@ -6,7 +6,7 @@
   [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
   [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
   <!-- VERSION:START -->
-  **Version:** `1.3.11`
+  **Version:** `1.5.0`
   <!-- VERSION:END -->
 </div>
 
@@ -34,8 +34,8 @@ Manual fallback: remove `"opencode-orchestrator"` or `["opencode-orchestrator",
 Tested compatibility:
 
 1. Node.js `24+`
-2. `@opencode-ai/plugin` `1.17.3`
-3. `@opencode-ai/sdk` `1.17.3`
+2. `@opencode-ai/plugin` `1.17.4`
+3. `@opencode-ai/sdk` `1.17.4`
 
 OpenCode plugin options belong inside the `plugin` array as `["plugin-name", {...}]` tuples. Configure `agentConcurrency` and `missionLoop` there:
 
@@ -99,6 +99,35 @@ Mission controls:
 3. `/cancel` and `/stop` deactivate the current mission loop.
 4. The default mission iteration ceiling is `1,000,000,000`.
 
+### Authorized Shell Listener TUI
+
+For owned lab machines or explicitly authorized test environments, the bundled Rust CLI can run a multi-session TCP shell listener:
+
+```bash
+orchestrator shell-listener --bind 127.0.0.1 --port 4444
+```
+
+The listener is intentionally outside the OpenCode JSON-RPC tool surface. It is an operator-driven terminal workflow, not an LLM-callable tool.
+
+Safety defaults:
+
+1. Loopback-only bind by default.
+2. Non-loopback bind addresses require `--allow-remote`.
+3. Raw stream logs are stored under `.opencode-orchestrator/shell-listener/`.
+4. The CLI does not generate payloads, exploit targets, or bypass authentication.
+
+TUI commands:
+
+| Command | Purpose |
+| --- | --- |
+| `sessions` | Show connected sessions, peer addresses, status, and raw log paths. |
+| `use <id>` | Select the active session. |
+| `send <text>` | Send one input line to the active session. Use this for login, registry, CDK, or reverse-proxy prompts that need human input. |
+| `run <cmd>` | Send a command followed by a unique sentinel marker so completion can be recognized in output. |
+| `pty` | Send a manual PTY helper to the active session when the remote environment supports Python. |
+| `close [id]` | Close a session. |
+| `quit` | Stop the listener UI. |
+
 ## 4. How It Works
 
 ```mermaid
@@ -128,6 +157,7 @@ Runtime evidence is written only when enabled:
 | `.opencode/mission-ledger.jsonl` | Bounded event trail for mission decisions. |
 | `.opencode/docs/brain/scratchpad.md` | Generated Markdown memory surface for active missions. |
 | `.opencode/docs/brain/knowledge-map.canvas` | Obsidian-compatible visual map of objective, evidence, and verification nodes. |
+| `.opencode/docs/brain/memories/*.md` | Generated mission-relevant memory notes indexed by the knowledge retriever. |
 
 ## 5. Developer Notes
 

package/dist/agents/prompts/02_discovery/discovery_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  DISCOVERY CORE PHILOSOPHY                                 ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  발견 단계의 핵심 철학: 실행 전 충분한 탐색               ║
+ * ║  Core Philosophy of Discovery: Thorough Exploration Before Execution  ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const DISCOVERY_CORE = "\n# Discovery Phase Philosophy\n\nBefore any execution, thoroughly explore:\n1. Workspace structure\n2. Environment capabilities\n3. Available skills and tools\n4. Project patterns and conventions\n\nThe discovery phase sets the foundation for all subsequent actions.\n";

package/dist/agents/prompts/03_planning/planning_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  PLANNING CORE PHILOSOPHY                                  ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  계획 단계의 핵심 철학: 실행 가능한 명확한 계획 수립        ║
+ * ║  Core Philosophy of Planning: Establishing Clear, Actionable Plans   ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const PLANNING_CORE = "\n# Planning Phase Philosophy\n\nCreate actionable, granular plans:\n1. Break down complex tasks into atomic units\n2. Identify dependencies and execution order\n3. Plan for parallel execution where possible\n4. Define clear success criteria\n\nGood planning makes execution straightforward.\n";

package/dist/agents/prompts/04_execution/execution_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  EXECUTION CORE PHILOSOPHY                                 ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  실행 단계의 핵심 철학: 계획을 정확하게 실행                ║
+ * ║  Core Philosophy of Execution: Executing Plans with Precision       ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const EXECUTION_CORE = "\n# Execution Phase Philosophy\n\nExecute with precision and quality:\n1. Follow the plan systematically\n2. Handle errors gracefully\n3. Provide clear progress updates\n4. Maintain code quality standards\n\nExecution transforms plans into reality.\n";

package/dist/agents/prompts/05_verification/verification_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  VERIFICATION CORE PHILOSOPHY                              ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  검증 단계의 핵심 철학: 실행 기반 품질 보증                 ║
+ * ║  Core Philosophy of Verification: Execution-Based Quality Assurance ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const VERIFICATION_CORE = "\n# Verification Phase Philosophy\n\nVerify through actual execution:\n1. Build the project\n2. Run tests\n3. Check linting and type errors\n4. Validate runtime behavior\n\nReal execution is the ultimate verification.\n";

package/dist/agents/prompts/06_mission/mission_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  MISSION CORE PHILOSOPHY                                   ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  미션 관리의 핵심 철학: 전체 생명주기 관리                  ║
+ * ║  Core Philosophy of Mission Control: Managing Full Lifecycle        ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const MISSION_CORE = "\n# Mission Management Philosophy\n\nManage the entire mission lifecycle:\n1. Track mission status throughout execution\n2. Handle recovery from failures\n3. Determine completion conditions\n4. Ensure clean mission closure\n\nA mission succeeds when all objectives are met.\n";

package/dist/agents/prompts/08_tools/tools_core.d.ts

@@ -2,7 +2,7 @@
  * ╔════════════════════════════════════════════════════════════╗
  * ║  TOOLS CORE PHILOSOPHY                                     ║
  * ╠════════════════════════════════════════════════════════════╣
- * ║  도구 사용의 핵심 철학: 올바른 도구를 올바르게 사용          ║
+ * ║  Core Philosophy of Tools: Using the Right Tools Correctly          ║
  * ╚════════════════════════════════════════════════════════════╝
  */
 export declare const TOOLS_CORE = "\n# Tools Usage Philosophy\n\nUse the right tool for the right job:\n1. Understand each tool's capabilities and limitations\n2. Choose the most appropriate tool for each task\n3. Use tools efficiently and correctly\n4. Validate tool outputs\n\nProper tool usage amplifies effectiveness.\n";

package/dist/core/knowledge/context-provider.d.ts

@@ -4,5 +4,6 @@ export declare class KnowledgeContextProvider {
     private walkDirectory;
     private indexKnowledge;
     private buildSnippet;
+    private isDirectInjectedScratchpad;
     private formatPrompt;
 }

package/dist/core/knowledge/mission-memory.d.ts

@@ -2,3 +2,5 @@ import type { MissionLoopState } from "../../shared/loop/interfaces/mission-loop
 export declare function syncMissionMemory(directory: string, state: MissionLoopState): boolean;
 export declare function getMissionScratchpadPath(directory: string): string;
 export declare function getMissionCanvasPath(directory: string): string;
+export declare function getMissionMemoryNotesDirPath(directory: string): string;
+export declare function readMissionScratchpadSnapshot(directory: string, maxChars?: number): string | null;

package/dist/index.js

@@ -36437,7 +36437,7 @@ init_logger();
 // src/core/loop/mission-loop.ts
 init_logger();
 init_shared();
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync, mkdirSync as mkdirSync4 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, mkdirSync as mkdirSync4 } from "node:fs";
 import { join as join6 } from "node:path";
 
 // src/shared/constants/system-messages.ts
@@ -36515,15 +36515,15 @@ var CONTINUE_INSTRUCTION = `<auto_continue>
 </auto_continue>`;
 var STAGNATION_INTERVENTION = `
 <system_intervention type="stagnation_detected">
-\u26A0\uFE0F **\uACBD\uACE0: \uC9C4\uD589 \uC815\uCCB4 \uAC10\uC9C0 (STAGNATION DETECTED)**
-\uCD5C\uADFC \uC5EC\uB7EC \uD134 \uB3D9\uC548 \uC2E4\uC9C8\uC801\uC778 \uC9C4\uC804\uC774 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uB2E8\uC21C "\uBAA8\uB2C8\uD130\uB9C1"\uC774\uB098 \uAC19\uC740 \uD589\uB3D9\uC744 \uBC18\uBCF5\uD558\uB294 \uAC83\uC740 \uAE08\uC9C0\uB429\uB2C8\uB2E4.
+\u26A0\uFE0F **WARNING: STAGNATION DETECTED**
+No substantive progress has been detected for the past several turns. Repeating the same action or merely "monitoring" is prohibited.
 
-**\uC790\uC728\uC801 \uC9C4\uB2E8 \uBC0F \uD574\uACB0 \uC9C0\uCE68:**
-1. **\uC2E4\uC2DC\uAC04 \uB85C\uADF8 \uD655\uC778**: \`check_background_task\` \uB610\uB294 \`read_file\`\uC744 \uC0AC\uC6A9\uD558\uC5EC \uC9C4\uD589 \uC911\uC778 \uC791\uC5C5\uC758 \uCD9C\uB825 \uB85C\uADF8\uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC2ED\uC2DC\uC624.
-2. **\uD504\uB85C\uC138\uC2A4 \uC0DD\uC874 \uC9C4\uB2E8**: \uC791\uC5C5\uC774 \uC880\uBE44 \uC0C1\uD0DC\uC774\uAC70\uB098 \uBA48\uCD98 \uAC83 \uAC19\uB2E4\uBA74 \uACFC\uAC10\uD558\uAC8C \`kill\`\uD558\uACE0 \uB2E8\uACC4\uB97C \uC138\uBD84\uD654\uD558\uC5EC \uB2E4\uC2DC \uC2E4\uD589\uD558\uC2ED\uC2DC\uC624.
-3. **\uC804\uB7B5 \uC804\uD658**: \uB3D9\uC77C\uD55C \uC811\uADFC \uBC29\uC2DD\uC774 \uC2E4\uD328\uD558\uACE0 \uC788\uB2E4\uBA74, \uB2E4\uB978 \uB3C4\uAD6C\uB098 \uBC29\uBC95\uC744 \uC0AC\uC6A9\uD558\uC5EC \uBAA9\uD45C\uC5D0 \uB3C4\uB2EC\uD558\uC2ED\uC2DC\uC624.
+**Guidelines for Autonomous Diagnosis and Resolution:**
+1. **Check Real-time Logs**: Use \`check_background_task\` or \`read_file\` to directly check the output logs of the running task.
+2. **Process Liveness Diagnosis**: If the task appears to be in a zombie state or hung, proactively \`kill\` it, break down the steps, and run it again.
+3. **Strategy Pivot**: If the same approach keeps failing, use alternative tools or methods to reach the goal.
 
-**\uC9C0\uAE08 \uBC14\uB85C \uB2A5\uB3D9\uC801\uC73C\uB85C \uAC1C\uC785\uD558\uC2ED\uC2DC\uC624. \uB300\uAE30\uD558\uC9C0 \uB9C8\uC2ED\uC2DC\uC624.**
+**Intervene proactively right now. Do not wait.**
 </system_intervention>`;
 var CLEANUP_INSTRUCTION = `
 <system_maintenance type="continuous_hygiene">
@@ -36548,7 +36548,7 @@ You must maintain a pristine workspace. **As part of your move**, perform these
 
 // src/core/knowledge/mission-memory.ts
 init_shared();
-import { mkdirSync as mkdirSync3, renameSync, writeFileSync } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname as dirname2, join as join5 } from "node:path";
 
 // src/core/loop/mission-ledger.ts
@@ -36625,8 +36625,17 @@ function parseLedgerLine(line) {
 var BRAIN_DIR = join5(PATHS.DOCS, "brain");
 var SCRATCHPAD_FILE = "scratchpad.md";
 var CANVAS_FILE = "knowledge-map.canvas";
+var MEMORY_NOTES_DIR = "memories";
 var MAX_CANVAS_EVENTS = 3;
 var MAX_SCRATCHPAD_EVENTS = 6;
+var MAX_MEMORY_NOTES = 8;
+var MAX_MEMORY_BODY_CHARS = 900;
+var SCRATCHPAD_SNAPSHOT_CHARS = 1600;
+var MISSION_MEMORY_LEVELS = [
+  "project" /* PROJECT */,
+  "mission" /* MISSION */,
+  "task" /* TASK */
+];
 function syncMissionMemory(directory, state2) {
   const options = getMissionRuntimeOptions();
   if (!options.markdownMemory) return false;
@@ -36637,6 +36646,7 @@ function syncMissionMemory(directory, state2) {
   try {
     writeScratchpad(directory, state2, events);
     writeCanvas(directory, state2, events);
+    syncMissionMemoryNotes(directory, state2);
     return true;
   } catch {
     return false;
@@ -36648,6 +36658,17 @@ function getMissionScratchpadPath(directory) {
 function getMissionCanvasPath(directory) {
   return join5(directory, BRAIN_DIR, CANVAS_FILE);
 }
+function getMissionMemoryNotesDirPath(directory) {
+  return join5(directory, BRAIN_DIR, MEMORY_NOTES_DIR);
+}
+function readMissionScratchpadSnapshot(directory, maxChars = SCRATCHPAD_SNAPSHOT_CHARS) {
+  const path11 = getMissionScratchpadPath(directory);
+  if (!existsSync3(path11)) return null;
+  const content = stripFrontmatter(readFileSync2(path11, "utf8")).trim();
+  if (!content) return null;
+  if (content.length <= maxChars) return content;
+  return `${content.slice(0, maxChars)}...`;
+}
 function writeScratchpad(directory, state2, events) {
   const content = [
     "---",
@@ -36682,6 +36703,22 @@ function writeCanvas(directory, state2, events) {
   const edges = buildCanvasEdges(nodes);
   atomicWrite(getMissionCanvasPath(directory), JSON.stringify({ nodes, edges }, null, 2));
 }
+function syncMissionMemoryNotes(directory, state2) {
+  const notesDir = getMissionMemoryNotesDirPath(directory);
+  const expectedFiles = /* @__PURE__ */ new Set();
+  for (const entry of selectMissionMemoryEntries(state2)) {
+    const fileName = buildMemoryNoteFileName(entry);
+    expectedFiles.add(fileName);
+    atomicWrite(join5(notesDir, fileName), buildMemoryNoteContent(state2, entry));
+  }
+  if (!existsSync3(notesDir)) return;
+  for (const entry of readdirSync(notesDir, { withFileTypes: true })) {
+    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+    if (!expectedFiles.has(entry.name)) {
+      unlinkSync(join5(notesDir, entry.name));
+    }
+  }
+}
 function buildCanvasNodes(state2, events) {
   const nodes = [
     textNode("objective", `Objective
@@ -36711,6 +36748,67 @@ function buildCanvasEdges(nodes) {
 function textNode(id, text, x, y) {
   return { id, type: "text", text, x, y, width: 360, height: 180 };
 }
+function selectMissionMemoryEntries(state2) {
+  const snapshot = MemoryManager.getInstance().export();
+  const query = `${state2.objective ?? ""} ${state2.prompt}`.trim();
+  const selected = [];
+  for (const level of MISSION_MEMORY_LEVELS) {
+    const entries = snapshot[level] ?? [];
+    for (const entry of entries) {
+      if (shouldPersistMissionEntry(entry, level, query)) {
+        selected.push(entry);
+      }
+    }
+  }
+  return selected.sort((left, right) => right.importance - left.importance || right.timestamp - left.timestamp).slice(0, MAX_MEMORY_NOTES);
+}
+function shouldPersistMissionEntry(entry, level, query) {
+  const matchesQuery = query ? isRelevantToQuery(entry.content, query) : false;
+  switch (level) {
+    case "project" /* PROJECT */:
+      return entry.importance >= 0.7 || matchesQuery;
+    case "mission" /* MISSION */:
+      return entry.importance >= 0.5 || matchesQuery;
+    case "task" /* TASK */:
+      return entry.importance >= 0.7 || matchesQuery;
+    default:
+      return false;
+  }
+}
+function isRelevantToQuery(content, query) {
+  const normalizedContent = content.toLowerCase();
+  const keywords = query.toLowerCase().split(/\s+/).map((token) => token.trim()).filter((token) => token.length > 3);
+  if (keywords.length === 0) return false;
+  return keywords.some((keyword) => normalizedContent.includes(keyword));
+}
+function buildMemoryNoteFileName(entry) {
+  return `${entry.level}-${sanitizeFilePart(entry.id)}.md`;
+}
+function buildMemoryNoteContent(state2, entry) {
+  const recordedAt = new Date(entry.timestamp).toISOString();
+  const body = entry.content.length > MAX_MEMORY_BODY_CHARS ? `${entry.content.slice(0, MAX_MEMORY_BODY_CHARS)}...` : entry.content;
+  return [
+    "---",
+    `tags: [mission-memory, orchestrator, ${entry.level}]`,
+    `title: "${escapeYaml(`${entry.level} memory ${entry.id}`)}"`,
+    "keep: true",
+    `level: "${entry.level}"`,
+    `importance: ${entry.importance.toFixed(3)}`,
+    `session: "${escapeYaml(state2.sessionID)}"`,
+    `recorded_at: "${recordedAt}"`,
+    `objective: "${escapeYaml(state2.objective ?? state2.prompt)}"`,
+    "---",
+    `# ${capitalize(entry.level)} Memory`,
+    "",
+    `- Session: ${state2.sessionID}`,
+    `- Recorded at: ${recordedAt}`,
+    `- Importance: ${entry.importance.toFixed(3)}`,
+    "",
+    "## Content",
+    body,
+    ""
+  ].join("\n");
+}
 function formatEventLines(events) {
   if (events.length === 0) return ["- No runtime evidence recorded yet."];
   return events.map((event) => `- ${event.timestamp} ${event.type}: ${event.summary ?? event.reason ?? "recorded"}`);
@@ -36724,6 +36822,15 @@ function atomicWrite(path11, content) {
 function escapeYaml(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
+function stripFrontmatter(content) {
+  return content.replace(/^---\n[\s\S]*?\n---\n?/u, "");
+}
+function sanitizeFilePart(value) {
+  return value.replace(/[^a-zA-Z0-9_-]+/g, "-");
+}
+function capitalize(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
 
 // src/core/loop/mission-loop.ts
 var STATE_FILE = MISSION_CONTROL.STATE_FILE;
@@ -36734,11 +36841,11 @@ function getStateFilePath(directory) {
 }
 function readLoopState(directory) {
   const filePath = getStateFilePath(directory);
-  if (!existsSync3(filePath)) {
+  if (!existsSync4(filePath)) {
     return null;
   }
   try {
-    const content = readFileSync2(filePath, "utf-8");
+    const content = readFileSync3(filePath, "utf-8");
     return JSON.parse(content);
   } catch (error95) {
     log(`[${MISSION_CONTROL.LOG_SOURCE}] Failed to read state: ${error95}`);
@@ -36749,7 +36856,7 @@ function writeLoopState(directory, state2) {
   const filePath = getStateFilePath(directory);
   const dirPath = join6(directory, PATHS.OPENCODE);
   try {
-    if (!existsSync3(dirPath)) {
+    if (!existsSync4(dirPath)) {
       mkdirSync4(dirPath, { recursive: true });
     }
     writeFileSync2(filePath, JSON.stringify(state2, null, 2), "utf-8");
@@ -36761,11 +36868,11 @@ function writeLoopState(directory, state2) {
 }
 function clearLoopState(directory) {
   const filePath = getStateFilePath(directory);
-  if (!existsSync3(filePath)) {
+  if (!existsSync4(filePath)) {
     return false;
   }
   try {
-    unlinkSync(filePath);
+    unlinkSync2(filePath);
     return true;
   } catch (error95) {
     log(`[${MISSION_CONTROL.LOG_SOURCE}] Failed to clear state: ${error95}`);
@@ -37251,7 +37358,7 @@ ${commandList}`;
 // src/core/loop/verification.ts
 init_shared();
 init_logger();
-import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
 import { join as join7 } from "node:path";
 var CHECKLIST_FILE = CHECKLIST.FILE;
 function parseChecklistLine(line, currentCategory) {
@@ -37318,11 +37425,11 @@ function parseChecklist(content) {
 }
 function readChecklist(directory) {
   const filePath = join7(directory, CHECKLIST_FILE);
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     return [];
   }
   try {
-    const content = readFileSync3(filePath, "utf-8");
+    const content = readFileSync4(filePath, "utf-8");
     return parseChecklist(content);
   } catch (error95) {
     log(`[checklist] Failed to read checklist: ${error95}`);
@@ -37340,7 +37447,7 @@ function verifyChecklist(directory) {
     errors: []
   };
   const filePath = join7(directory, CHECKLIST_FILE);
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     result.errors.push(`Verification checklist not found at ${CHECKLIST_FILE}`);
     result.errors.push("Create checklist with at least: build, tests, and any environment-specific checks");
     return result;
@@ -37417,9 +37524,9 @@ function verifyMissionCompletion(directory) {
     }
   }
   const todoPath = join7(directory, PATHS.TODO);
-  if (existsSync4(todoPath)) {
+  if (existsSync5(todoPath)) {
     try {
-      const content = readFileSync3(todoPath, "utf-8");
+      const content = readFileSync4(todoPath, "utf-8");
       const incompleteCount = countMatches(content, TODO_INCOMPLETE_PATTERN);
       const completeCount = countMatches(content, TODO_COMPLETE_PATTERN);
       const total = incompleteCount + completeCount;
@@ -37442,9 +37549,9 @@ function verifyMissionCompletion(directory) {
     result.errors.push(`TODO file not found at ${PATHS.TODO}`);
   }
   const syncPath = join7(directory, PATHS.SYNC_ISSUES);
-  if (existsSync4(syncPath)) {
+  if (existsSync5(syncPath)) {
     try {
-      const content = readFileSync3(syncPath, "utf-8");
+      const content = readFileSync4(syncPath, "utf-8");
       result.syncIssuesEmpty = !hasRealSyncIssues(content);
       if (!result.syncIssuesEmpty) {
         const issueLines = content.split("\n").filter(
@@ -37532,7 +37639,7 @@ function buildVerificationSummary(result) {
 init_logger();
 import { exec as exec2 } from "node:child_process";
 import { promisify as promisify2 } from "node:util";
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 
 // src/shared/notification/os-notify/constants/notification-commands.ts
 var NOTIFICATION_COMMANDS = {
@@ -37610,7 +37717,7 @@ async function notifyDarwin(title, message) {
 function isWSL() {
   try {
     if (process.env.WSL_DISTRO_NAME || process.env.WSLENV) return true;
-    const procVersion = readFileSync4("/proc/version", "utf-8");
+    const procVersion = readFileSync5("/proc/version", "utf-8");
     return /microsoft|WSL/i.test(procVersion);
   } catch {
     return false;
@@ -39131,9 +39238,9 @@ import * as path6 from "node:path";
 
 // src/core/cache/utils.ts
 import * as fs6 from "node:fs/promises";
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 async function ensureCacheDir() {
-  if (!existsSync6(CACHE_DIR)) {
+  if (!existsSync7(CACHE_DIR)) {
     await fs6.mkdir(CACHE_DIR, { recursive: true });
   }
 }
@@ -39635,14 +39742,14 @@ var backgroundTaskManager = BackgroundTaskManager.instance;
 
 // src/tools/rust-pool.ts
 import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 
 // src/utils/binary.ts
 init_shared();
 import { join as join12, dirname as dirname5 } from "path";
 import { fileURLToPath } from "url";
 import { platform, arch } from "os";
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 var __dirname = dirname5(fileURLToPath(import.meta.url));
 function getPlatformBinaryName(os = platform(), cpu = arch()) {
   if (os === PLATFORM.WIN32) {
@@ -39663,7 +39770,7 @@ function resolveBinaryPath(options = {}) {
   const moduleDir = options.moduleDir ?? __dirname;
   const os = options.os ?? platform();
   const cpu = options.cpu ?? arch();
-  const exists = options.exists ?? existsSync8;
+  const exists = options.exists ?? existsSync9;
   const binaryName = getPlatformBinaryName(os, cpu);
   for (const binDir of getCandidateBinDirs(moduleDir)) {
     const binaryPath = join12(binDir, binaryName);
@@ -39702,7 +39809,7 @@ var RustToolPool = class {
   constructor(maxSize = 4, options = {}) {
     this.maxSize = maxSize;
     this.binaryPath = options.binaryPath ?? getBinaryPath;
-    this.exists = options.exists ?? existsSync9;
+    this.exists = options.exists ?? existsSync10;
     this.idleTimeout = options.idleTimeoutMs ?? this.idleTimeout;
     this.processReadyDelay = options.processReadyDelayMs ?? this.processReadyDelay;
     this.requestTimeout = options.requestTimeoutMs ?? this.requestTimeout;
@@ -42478,7 +42585,7 @@ Wait for these tasks to complete before concluding the mission.
 init_shared();
 
 // src/core/knowledge/context-provider.ts
-import { existsSync as existsSync10, readFileSync as readFileSync6, readdirSync } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync7, readdirSync as readdirSync2 } from "node:fs";
 import path10 from "node:path";
 
 // src/core/knowledge/graph-parser.ts
@@ -42772,7 +42879,7 @@ var HybridSearch = class {
 };
 
 // src/core/knowledge/tag-indexer.ts
-import { readFileSync as readFileSync5 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 var TagIndexer = class {
   tagMap = /* @__PURE__ */ new Map();
   fileCache = /* @__PURE__ */ new Map();
@@ -42846,7 +42953,7 @@ var TagIndexer = class {
    */
   indexFileFromDisk(filePath) {
     try {
-      const content = readFileSync5(filePath, "utf8");
+      const content = readFileSync6(filePath, "utf8");
       this.indexFile(filePath, content);
     } catch {
       this.clearIndexForFile(filePath);
@@ -42946,6 +43053,7 @@ var MAX_RESULTS = 3;
 var MAX_SNIPPET_CHARS = 220;
 var KNOWLEDGE_ROOTS = ["docs", path10.join(".opencode", "docs")];
 var SKIP_SEGMENTS = /* @__PURE__ */ new Set(["node_modules", "dist", "bin", ".git", "archive"]);
+var GENERATED_SCRATCHPAD_PATH = path10.join(".opencode", "docs", "brain", "scratchpad.md");
 var KnowledgeContextProvider = class {
   buildPrompt(directory, query) {
     const normalizedQuery = query.trim();
@@ -42961,14 +43069,14 @@ var KnowledgeContextProvider = class {
     const files = [];
     for (const root of KNOWLEDGE_ROOTS) {
       const fullRoot = path10.join(directory, root);
-      if (!existsSync10(fullRoot)) continue;
+      if (!existsSync11(fullRoot)) continue;
       files.push(...this.walkDirectory(fullRoot));
     }
-    return files.sort();
+    return files.filter((filePath) => !this.isDirectInjectedScratchpad(directory, filePath)).sort();
   }
   walkDirectory(directory) {
     const files = [];
-    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync2(directory, { withFileTypes: true })) {
       const fullPath = path10.join(directory, entry.name);
       if (entry.isDirectory()) {
         if (SKIP_SEGMENTS.has(entry.name)) continue;
@@ -42989,7 +43097,7 @@ var KnowledgeContextProvider = class {
     const noteToSnippet = /* @__PURE__ */ new Map();
     for (const filePath of files) {
       try {
-        const content = readFileSync6(filePath, "utf8");
+        const content = readFileSync7(filePath, "utf8");
         const noteName = graphParser.getNoteName(filePath);
         const { body } = tagIndexer.parseFrontmatter(content);
         const normalizedBody = body.trim();
@@ -43009,6 +43117,9 @@ var KnowledgeContextProvider = class {
     if (normalized.length <= MAX_SNIPPET_CHARS) return normalized;
     return `${normalized.slice(0, MAX_SNIPPET_CHARS)}...`;
   }
+  isDirectInjectedScratchpad(directory, filePath) {
+    return path10.relative(directory, filePath) === GENERATED_SCRATCHPAD_PATH;
+  }
   formatPrompt(query, results, indexed) {
     const lines = [
       "<knowledge_rag_context>",
@@ -43050,13 +43161,17 @@ function createSystemTransformHandler(ctx) {
       const { commander: commander2 } = await Promise.resolve().then(() => (init_commander(), commander_exports));
       systemAdditions.push(commander2.systemPrompt);
       systemAdditions.push(buildMissionLoopSystemPrompt(loopState));
+      const scratchpadPrompt = buildMissionScratchpadPrompt(directory);
+      if (scratchpadPrompt) {
+        systemAdditions.push(scratchpadPrompt);
+      }
     }
     if (session?.active) {
       systemAdditions.push(buildActiveSessionPrompt(session.step));
     }
     const knowledgePrompt = buildKnowledgeContextPrompt(
       directory,
-      loopState?.prompt,
+      loopState,
       state2.sessions.get(sessionID)?.currentTask
     );
     if (knowledgePrompt) {
@@ -43077,10 +43192,24 @@ function createSystemTransformHandler(ctx) {
     }
   };
 }
-function buildKnowledgeContextPrompt(directory, missionPrompt, currentTask) {
-  const queryParts = [missionPrompt ?? "", currentTask ?? ""].filter(Boolean);
+function buildKnowledgeContextPrompt(directory, loopState, currentTask) {
+  const queryParts = [
+    loopState?.objective ?? "",
+    loopState?.prompt ?? "",
+    currentTask ?? "",
+    loopState?.lastProgress ?? "",
+    loopState?.lastVerificationSummary ?? "",
+    loopState?.lastContinuationReason ?? ""
+  ].filter(Boolean);
   return knowledgeContextProvider.buildPrompt(directory, queryParts.join(" ").trim());
 }
+function buildMissionScratchpadPrompt(directory) {
+  const snapshot = readMissionScratchpadSnapshot(directory);
+  if (!snapshot) return null;
+  return `<mission_scratchpad path="${PATHS.DOCS}/brain/scratchpad.md">
+${snapshot}
+</mission_scratchpad>`;
+}
 function buildMissionLoopSystemPrompt(loopState) {
   return `<orchestrator_mission_loop>
 \u{1F3AF} MISSION LOOP ACTIVE: Iteration ${loopState.iteration}/${loopState.maxIterations}

package/dist/shared/constants/system-messages.d.ts

@@ -21,5 +21,5 @@ export declare const MISSION_MESSAGES: {
 };
 export declare const COMPACTION_PROMPT: string;
 export declare const CONTINUE_INSTRUCTION: string;
-export declare const STAGNATION_INTERVENTION = "\n<system_intervention type=\"stagnation_detected\">\n\u26A0\uFE0F **\uACBD\uACE0: \uC9C4\uD589 \uC815\uCCB4 \uAC10\uC9C0 (STAGNATION DETECTED)**\n\uCD5C\uADFC \uC5EC\uB7EC \uD134 \uB3D9\uC548 \uC2E4\uC9C8\uC801\uC778 \uC9C4\uC804\uC774 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uB2E8\uC21C \"\uBAA8\uB2C8\uD130\uB9C1\"\uC774\uB098 \uAC19\uC740 \uD589\uB3D9\uC744 \uBC18\uBCF5\uD558\uB294 \uAC83\uC740 \uAE08\uC9C0\uB429\uB2C8\uB2E4.\n\n**\uC790\uC728\uC801 \uC9C4\uB2E8 \uBC0F \uD574\uACB0 \uC9C0\uCE68:**\n1. **\uC2E4\uC2DC\uAC04 \uB85C\uADF8 \uD655\uC778**: `check_background_task` \uB610\uB294 `read_file`\uC744 \uC0AC\uC6A9\uD558\uC5EC \uC9C4\uD589 \uC911\uC778 \uC791\uC5C5\uC758 \uCD9C\uB825 \uB85C\uADF8\uB97C \uC9C1\uC811 \uD655\uC778\uD558\uC2ED\uC2DC\uC624.\n2. **\uD504\uB85C\uC138\uC2A4 \uC0DD\uC874 \uC9C4\uB2E8**: \uC791\uC5C5\uC774 \uC880\uBE44 \uC0C1\uD0DC\uC774\uAC70\uB098 \uBA48\uCD98 \uAC83 \uAC19\uB2E4\uBA74 \uACFC\uAC10\uD558\uAC8C `kill`\uD558\uACE0 \uB2E8\uACC4\uB97C \uC138\uBD84\uD654\uD558\uC5EC \uB2E4\uC2DC \uC2E4\uD589\uD558\uC2ED\uC2DC\uC624.\n3. **\uC804\uB7B5 \uC804\uD658**: \uB3D9\uC77C\uD55C \uC811\uADFC \uBC29\uC2DD\uC774 \uC2E4\uD328\uD558\uACE0 \uC788\uB2E4\uBA74, \uB2E4\uB978 \uB3C4\uAD6C\uB098 \uBC29\uBC95\uC744 \uC0AC\uC6A9\uD558\uC5EC \uBAA9\uD45C\uC5D0 \uB3C4\uB2EC\uD558\uC2ED\uC2DC\uC624.\n\n**\uC9C0\uAE08 \uBC14\uB85C \uB2A5\uB3D9\uC801\uC73C\uB85C \uAC1C\uC785\uD558\uC2ED\uC2DC\uC624. \uB300\uAE30\uD558\uC9C0 \uB9C8\uC2ED\uC2DC\uC624.**\n</system_intervention>";
+export declare const STAGNATION_INTERVENTION = "\n<system_intervention type=\"stagnation_detected\">\n\u26A0\uFE0F **WARNING: STAGNATION DETECTED**\nNo substantive progress has been detected for the past several turns. Repeating the same action or merely \"monitoring\" is prohibited.\n\n**Guidelines for Autonomous Diagnosis and Resolution:**\n1. **Check Real-time Logs**: Use `check_background_task` or `read_file` to directly check the output logs of the running task.\n2. **Process Liveness Diagnosis**: If the task appears to be in a zombie state or hung, proactively `kill` it, break down the steps, and run it again.\n3. **Strategy Pivot**: If the same approach keeps failing, use alternative tools or methods to reach the goal.\n\n**Intervene proactively right now. Do not wait.**\n</system_intervention>";
 export declare const CLEANUP_INSTRUCTION = "\n<system_maintenance type=\"continuous_hygiene\">\n\uD83E\uDDF9 **DOCUMENTATION & STATE HYGIENE (Iteration %ITER%)**\nYou must maintain a pristine workspace. **As part of your move**, perform these checks:\n\n1. **Relevance Assessment**:\n   - Review active documents (`.opencode/*.md`). Are they needed for the *current* objective?\n   - If a file represents a solved problem or obsolete context, **Archive it** to `.opencode/archive/` or delete it.\n\n2. **Synchronization**:\n   - Verify `TODO.md` matches the actual code state. Mark completed items immediately.\n   - Check `sync-issues.md`. If issues are resolved, remove them.\n\n3. **Context Optimization**:\n   - If `work-log.md` is getting noisy, summarize key decisions into `summary.md` and truncate the log.\n   - Keep context lightweight.\n\n**Rule**: A cluttered workspace leads to hallucinations. Clean as you go.\n</system_maintenance>\n";

package/package.json

@@ -2,14 +2,14 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Multi-agent mission control for OpenCode with Commander, Planner, Worker, and Reviewer workflows.",
-  "version": "1.3.11",
+  "version": "1.5.0",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/agnusdei1207/opencode-orchestrator.git"
   },
-  "homepage": "https://github.com/agnusdei1207/opencode-orchestrator/issues",
+  "homepage": "https://agnusdei1207.github.io/opencode-orchestrator/",
   "bugs": {
     "url": "https://github.com/agnusdei1207/opencode-orchestrator/issues"
   },
@@ -74,8 +74,8 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.17.3",
-    "@opencode-ai/sdk": "1.17.3",
+    "@opencode-ai/plugin": "1.17.4",
+    "@opencode-ai/sdk": "1.17.4",
     "jsonc-parser": "^3.3.1",
     "zod": "^4.3.6"
   },