opencode-orchestrator 1.3.10 → 1.3.12

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.10`
+  **Version:** `1.3.12`
   <!-- VERSION:END -->
 </div>
 
@@ -128,6 +128,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/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
@@ -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/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Multi-agent mission control for OpenCode with Commander, Planner, Worker, and Reviewer workflows.",
-  "version": "1.3.10",
+  "version": "1.3.12",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {