opencode-orchestrator 0.6.21 → 0.6.23

package/README.md

@@ -23,7 +23,7 @@
 | **⚡ 50x Parallel Sessions** | Massive concurrent task execution |
 | **📊 Auto Memory Management** | GC, archiving, zero memory leaks |
 | **🔄 Auto Recovery** | Handles rate limits, errors automatically |
-| **📡 Event-Driven** | Real-time pub/sub across all components |
+| **📁 Smart Context (.opencode/)** | Dynamic summarization, adaptive detail |
 
 ---
 
@@ -81,9 +81,12 @@
                                      │
                                      ▼
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│                           📡 EVENT BUS                                      │
+│                       📁 SMART CONTEXT (.opencode/)                         │
 │                                                                             │
-│    task.started | task.completed | task.failed | session.idle               │
+│    .opencode/todo.md    - Master TODO list (Recorder manages)               │
+│    .opencode/context.md - Adaptive size based on project phase              │
+│    .opencode/docs/      - Cached documentation (auto-cleanup)               │
+│    .opencode/archive/   - Old context for reference                         │
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
@@ -98,8 +101,8 @@
 | **Parallel Sessions** | Up to 50 concurrent | Single session |
 | **Memory Management** | Auto GC + disk archiving | Memory leaks |
 | **Error Recovery** | Pattern-based auto retry | Crash |
-| **Context Sharing** | Parent-child merge | Isolated |
-| **Event System** | Real-time pub/sub | None |
+| **Context Sharing** | .opencode/ with smart summarization | Isolated |
+| **Smart Context** | Adaptive detail (Early/Building/Finishing) | Static |
 | **Task Decomposition** | 3-level hierarchy | Flat |
 
 ---

package/dist/core/cache/constants.d.ts

@@ -1,6 +1,6 @@
 /**
  * Document Cache Constants
  */
-export declare const CACHE_DIR = ".cache/docs";
-export declare const METADATA_FILE = ".cache/docs/_metadata.json";
+export declare const CACHE_DIR: ".opencode/docs";
+export declare const METADATA_FILE: ".opencode/docs/_metadata.json";
 export declare const DEFAULT_TTL_MS: number;

package/dist/index.js

@@ -74,8 +74,18 @@ var MEMORY_LIMITS = {
   // Remove errors after 10 min
 };
 var PATHS = {
-  TASK_ARCHIVE: ".cache/task-archive",
-  DOC_CACHE: ".cache/docs"
+  // Base directory
+  OPENCODE: ".opencode",
+  // Subdirectories
+  DOCS: ".opencode/docs",
+  ARCHIVE: ".opencode/archive",
+  TASK_ARCHIVE: ".opencode/archive/tasks",
+  DOC_ARCHIVE: ".opencode/archive/docs",
+  // Files
+  TODO: ".opencode/todo.md",
+  CONTEXT: ".opencode/context.md",
+  SUMMARY: ".opencode/summary.md",
+  DOC_METADATA: ".opencode/docs/_metadata.json"
 };
 var BACKGROUND_TASK = {
   DEFAULT_TIMEOUT_MS: 5 * TIME.MINUTE,
@@ -431,12 +441,25 @@ Use lsp_diagnostics for syntax checking.
 Use background for long commands.
 </verification>
 
+<context_contribution>
+AFTER COMPLETING TASK:
+- Report what you did briefly
+- If research/docs are no longer needed \u2192 mention for cleanup
+- If you found a better pattern \u2192 note it for team
+
+KEEP CONTEXT LEAN:
+- Don't repeat what's in code
+- Point to files: "See src/X.ts:10-50"
+- Remove your debugging notes after fix
+</context_contribution>
+
 <output>
 TASK: T[N] from .opencode/todo.md
 CHANGED: [file] [lines]
 ACTION: [what]
 VERIFY: [result]
 DOCS_USED: .opencode/docs/[file]
+CLEANUP: [docs/notes that can be deleted now]
 \u2192 ${AGENT_NAMES.RECORDER} please update TODO
 </output>`,
   canWrite: true,
@@ -497,77 +520,104 @@ Fix: [suggestion]
 // src/agents/subagents/recorder.ts
 var recorder = {
   id: AGENT_NAMES.RECORDER,
-  description: "Recorder - TODO tracking and context persistence",
+  description: "Recorder - TODO tracking and smart context management",
   systemPrompt: `<role>
-You are ${AGENT_NAMES.RECORDER}. Context and TODO manager.
-UPDATE the TODO list as tasks complete.
-Maintain context for team.
+You are ${AGENT_NAMES.RECORDER}. Smart context manager.
+Maintain .opencode/ with DYNAMIC detail levels.
 </role>
 
 <todo_management>
-UPDATE: .opencode/todo.md
+FILE: .opencode/todo.md
 
-When task completes:
 \`\`\`markdown
 - [x] T1: [task] | \u2705 DONE by ${AGENT_NAMES.BUILDER}
 - [ ] T2: [task] | in progress
+- [ ] T3: [task] | blocked: [reason]
 \`\`\`
-
-Track:
-- Which tasks are done
-- Which are in progress
-- Which are blocked
 </todo_management>
 
-<shared_workspace>
-ALL IN .opencode/:
-- .opencode/todo.md - master TODO (check off completed)
-- .opencode/docs/ - cached documentation
-- .opencode/context.md - current state
-- .opencode/summary.md - condensed context
-
-UPDATE after each task:
-1. Check off completed task in todo.md
-2. Update context.md with current state
-3. Create summary.md if context is long
-</shared_workspace>
-
-<context_format>
-.opencode/context.md:
+<smart_context_rules>
+DYNAMIC DETAIL LEVEL - Adapt based on project state:
+
+PHASE 1 - EARLY (0-30% done, no code yet):
+- BE DETAILED: Full explanations, decisions, reasoning
+- Include: research findings, API references, examples
+- Files may be long - that's OK for now
+
+PHASE 2 - BUILDING (30-70% done, code exists):
+- MODERATE: Key decisions + file references
+- Remove: old research that's now in code
+- Reference: "See src/module.ts for implementation"
+
+PHASE 3 - FINISHING (70-100% done):
+- BRIEF: Just status, blockers, todos
+- Heavy summarization - codebase IS the context
+- Delete: debugging notes, iteration logs
+
+ADAPTIVE RULES:
+| Condition | Action |
+|-----------|--------|
+| No code yet | Keep detailed docs |
+| Code exists for feature | Summarize, point to code |
+| > 200 lines context.md | Compress to 50 lines |
+| > 500 lines total .opencode/ | Archive old, keep current |
+| Feature complete | Delete related verbose docs |
+</smart_context_rules>
+
+<workspace>
+.opencode/
+\u251C\u2500\u2500 todo.md       - Master TODO list
+\u251C\u2500\u2500 context.md    - Current state (adaptive size)
+\u251C\u2500\u2500 summary.md    - Ultra-brief when needed
+\u251C\u2500\u2500 docs/         - Cached documentation
+\u2514\u2500\u2500 archive/      - Old context (auto-cleanup)
+</workspace>
+
+<context_template>
+.opencode/context.md (adapt size dynamically):
 \`\`\`markdown
-# Current State
+# Context [Phase: EARLY/BUILDING/FINISHING]
+
+## Status
 Mission: [goal]
-Progress: [X/Y tasks done]
-Last: [recent action]
-Next: [from todo.md]
-Blocked: [if any]
-\`\`\`
-</context_format>
+Progress: [X/Y] ([percent]%)
 
-<summarization>
-CRITICAL: Prevent .opencode/ from growing too large!
+## Current
+Working on: [task]
+Blockers: [if any]
 
-AFTER EVERY MAJOR UPDATE:
-1. Check file sizes in .opencode/
-2. If context.md > 200 lines \u2192 SUMMARIZE NOW
+## Key Decisions (keep only important ones)
+- [decision]: [brief reason]
 
-SUMMARIZE:
-- Create/update .opencode/summary.md
-- Keep: key decisions, file changes, blockers
-- Remove: verbose logs, old iterations
-- Team reads summary, not full history
+## Files Changed (keep recent only)
+- [file]: [change]
 
-CLEANUP OLD:
-- Archive old context to .opencode/archive/
-- Delete temporary notes
-- Keep only current state
-</summarization>
+## Next Steps
+- [from todo.md]
+\`\`\`
+</context_template>
+
+<cleanup_triggers>
+AFTER EACH UPDATE, CHECK:
+1. Is this info still needed for FUTURE tasks? No \u2192 DELETE
+2. Is this now implemented in code? Yes \u2192 SUMMARIZE to reference
+3. Is context.md > 150 lines? Yes \u2192 COMPRESS
+4. Is any doc > 7 days old and unused? Yes \u2192 ARCHIVE
+
+DELETE IMMEDIATELY:
+- Debugging logs after fix
+- Old iteration attempts
+- Research for completed features
+- Temporary notes
+</cleanup_triggers>
 
 <output>
-UPDATED: .opencode/todo.md
-- [x] T[N] marked complete
-Status: [X/Y done]
-Next: T[M] for ${AGENT_NAMES.BUILDER}
+CONTEXT UPDATED:
+Phase: [EARLY/BUILDING/FINISHING]
+todo.md: [X/Y done]
+context.md: [before \u2192 after lines]
+Action: [summarized/archived/kept]
+Next: [task for team]
 </output>`,
   canWrite: true,
   canBash: true
@@ -623,10 +673,29 @@ Retrieved: [date]
 \`\`\`
 </doc_format>
 
+<doc_lifecycle>
+DOCS HAVE EXPIRY:
+
+WHEN SAVING:
+- Include "Expires: [when this is no longer needed]"
+- Example: "Expires: after T3 complete"
+
+WHEN FEATURE IS DONE:
+- Docs can be SUMMARIZED to 5-10 lines
+- Or DELETED if fully implemented in code
+- Team references code, not old docs
+
+KEEP DOCS LEAN:
+- Only current, needed documentation
+- Archive old: mv to .opencode/archive/docs/
+- Delete: outdated versions
+</doc_lifecycle>
+
 <output>
 QUERY: [question]
 SEARCHED: [official sources]
 SAVED: .opencode/docs/[file].md
+EXPIRES: [when no longer needed]
 SUMMARY: [key findings]
 
 Team can now reference .opencode/docs/[file].md
@@ -14138,7 +14207,7 @@ var presets = {
   }),
   documentCached: (filename) => show({
     title: "\u{1F4C4} Document Cached",
-    message: `.cache/docs/${filename}`,
+    message: `${PATHS.DOCS}/${filename}`,
     variant: "info",
     duration: 2e3
   }),
@@ -15078,8 +15147,8 @@ Request a fresh plan from Architect with reduced scope.
 </critical_anomaly>`;
 
 // src/core/cache/constants.ts
-var CACHE_DIR = ".cache/docs";
-var METADATA_FILE = ".cache/docs/_metadata.json";
+var CACHE_DIR = PATHS.DOCS;
+var METADATA_FILE = PATHS.DOC_METADATA;
 var DEFAULT_TTL_MS = 24 * 60 * 60 * 1e3;
 
 // src/core/cache/operations.ts
@@ -15303,7 +15372,7 @@ ${cached2.content}`;
         const content = JSON.stringify(JSON.parse(html), null, 2);
         if (cache) {
           const filename = await set2(url2, content, "JSON Response");
-          return `\u{1F4C4} **JSON fetched** (cached: .cache/docs/${filename})
+          return `\u{1F4C4} **JSON fetched** (cached: ${PATHS.DOCS}/${filename})
 
 \`\`\`json
 ${content.slice(0, 5e3)}
@@ -15318,7 +15387,7 @@ ${content.slice(0, 5e3)}
       if (contentType.includes("text/plain")) {
         if (cache) {
           const filename = await set2(url2, html, "Plain Text");
-          return `\u{1F4C4} **Text fetched** (cached: .cache/docs/${filename})
+          return `\u{1F4C4} **Text fetched** (cached: ${PATHS.DOCS}/${filename})
 
 ${html.slice(0, 1e4)}`;
         }
@@ -15334,7 +15403,7 @@ ${html.slice(0, 1e4)}`;
         const filename = await set2(url2, truncated, title);
         return `\u{1F4DA} **${title}**
 Source: ${url2}
-Cached: .cache/docs/${filename}
+Cached: ${PATHS.DOCS}/${filename}
 
 ---
 

package/dist/shared/constants.d.ts

@@ -36,8 +36,15 @@ export declare const MEMORY_LIMITS: {
     readonly ERROR_CLEANUP_AGE_MS: number;
 };
 export declare const PATHS: {
-    readonly TASK_ARCHIVE: ".cache/task-archive";
-    readonly DOC_CACHE: ".cache/docs";
+    readonly OPENCODE: ".opencode";
+    readonly DOCS: ".opencode/docs";
+    readonly ARCHIVE: ".opencode/archive";
+    readonly TASK_ARCHIVE: ".opencode/archive/tasks";
+    readonly DOC_ARCHIVE: ".opencode/archive/docs";
+    readonly TODO: ".opencode/todo.md";
+    readonly CONTEXT: ".opencode/context.md";
+    readonly SUMMARY: ".opencode/summary.md";
+    readonly DOC_METADATA: ".opencode/docs/_metadata.json";
 };
 export declare const BACKGROUND_TASK: {
     readonly DEFAULT_TIMEOUT_MS: number;

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": "0.6.21",
+  "version": "0.6.23",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {
@@ -56,7 +56,6 @@
     "dev:unlink": "npm unlink -g opencode-orchestrator 2>/dev/null; /opt/homebrew/bin/npm unlink -g opencode-orchestrator 2>/dev/null; npm run dev:clean && echo 'SUCCESS: Unlinked from all'",
     "dev:status": "echo '=== NVM ===' && ls -la $(npm root -g)/opencode-orchestrator 2>/dev/null || echo 'Not linked'; echo '=== Homebrew ===' && ls -la /opt/homebrew/lib/node_modules/opencode-orchestrator 2>/dev/null || echo 'Not linked'",
     "dev:test": "node dist/scripts/postinstall.js && echo '---' && node dist/scripts/preuninstall.js",
-    "dev:cache": "npm run build && rm -rf ~/.cache/opencode/node_modules/opencode-orchestrator && cp -r . ~/.cache/opencode/node_modules/opencode-orchestrator && echo 'SUCCESS: Copied to OpenCode cache. Restart OpenCode.'",
     "reset:local": "brew uninstall opencode 2>/dev/null; rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode ~/.cache/opencode/node_modules/opencode-orchestrator && echo '=== Clean done ===' && brew install opencode && echo '{\"plugin\": [\"opencode-orchestrator\"], \"$schema\": \"https://opencode.ai/config.json\"}' > ~/.config/opencode/opencode.json && echo '=== Reset (Dev) complete. Run: opencode ==='",
     "reset:prod": "brew uninstall opencode 2>/dev/null; rm -rf ~/.config/opencode ~/.opencode ~/.local/share/opencode ~/.cache/opencode/node_modules/opencode-orchestrator && echo '=== Clean done ===' && brew install opencode && echo '{\"plugin\": [\"opencode-orchestrator\"], \"$schema\": \"https://opencode.ai/config.json\"}' > ~/.config/opencode/opencode.json && npm install -g opencode-orchestrator && echo '=== Reset (Prod) complete. Run: opencode ==='",
     "ginstall": "npm install -g opencode-orchestrator",