oh-my-opencode-slim 0.9.14 → 1.0.0

package/dist/interview/service.d.ts

@@ -3,6 +3,7 @@ import type { InterviewConfig } from '../config';
 import type { InterviewAnswer, InterviewFileItem, InterviewListItem, InterviewRecord, InterviewState } from './types';
 export declare function createInterviewService(ctx: PluginInput, config?: InterviewConfig, deps?: {
     openBrowser?: (url: string) => void;
+    env?: NodeJS.ProcessEnv;
 }): {
     setBaseUrlResolver: (resolver: () => Promise<string>) => void;
     setStatePushCallback: (callback: (interviewId: string, state: InterviewState) => void) => void;

package/dist/multiplexer/factory.d.ts

@@ -4,7 +4,11 @@
 import type { MultiplexerConfig } from '../config/schema';
 import type { Multiplexer } from './types';
 /**
- * Create or retrieve a multiplexer instance based on config
+ * Create a multiplexer instance based on config.
+ *
+ * Do not cache instances: tmux/zellij integrations may depend on
+ * per-process environment like TMUX_PANE/ZELLIJ, which should be captured
+ * fresh for each plugin context.
  */
 export declare function getMultiplexer(config: MultiplexerConfig): Multiplexer | null;
 /**

package/dist/multiplexer/index.d.ts

@@ -2,6 +2,7 @@
  * Multiplexer module exports
  */
 export { clearMultiplexerCache, getMultiplexer, startAvailabilityCheck, } from './factory';
+export { MultiplexerSessionManager, TmuxSessionManager, } from './session-manager';
 export { TmuxMultiplexer } from './tmux';
 export type { Multiplexer, PaneResult } from './types';
 export { isServerRunning } from './types';

package/dist/multiplexer/session-manager.d.ts

@@ -0,0 +1,46 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { MultiplexerConfig } from '../config/schema';
+interface SessionEvent {
+    type: string;
+    properties?: {
+        info?: {
+            id?: string;
+            parentID?: string;
+            title?: string;
+            directory?: string;
+        };
+        sessionID?: string;
+        status?: {
+            type: string;
+        };
+    };
+}
+/**
+ * Tracks child sessions and spawns/closes multiplexer panes for them.
+ *
+ * Uses session.status events for completion detection instead of polling,
+ * with polling kept as a fallback for reliability.
+ */
+export declare class MultiplexerSessionManager {
+    private client;
+    private serverUrl;
+    private directory;
+    private multiplexer;
+    private sessions;
+    private pollInterval?;
+    private enabled;
+    constructor(ctx: PluginInput, config: MultiplexerConfig);
+    onSessionCreated(event: SessionEvent): Promise<void>;
+    onSessionStatus(event: SessionEvent): Promise<void>;
+    onSessionDeleted(event: SessionEvent): Promise<void>;
+    private startPolling;
+    private stopPolling;
+    private pollSessions;
+    private closeSession;
+    cleanup(): Promise<void>;
+}
+/**
+ * @deprecated Use MultiplexerSessionManager instead
+ */
+export declare const TmuxSessionManager: typeof MultiplexerSessionManager;
+export {};

package/dist/multiplexer/tmux/index.d.ts

@@ -9,12 +9,14 @@ export declare class TmuxMultiplexer implements Multiplexer {
     private hasChecked;
     private storedLayout;
     private storedMainPaneSize;
+    private targetPane;
     constructor(layout?: MultiplexerLayout, mainPaneSize?: number);
     isAvailable(): Promise<boolean>;
     isInsideSession(): boolean;
-    spawnPane(sessionId: string, description: string, serverUrl: string): Promise<PaneResult>;
+    spawnPane(sessionId: string, description: string, serverUrl: string, directory: string): Promise<PaneResult>;
     closePane(paneId: string): Promise<boolean>;
     applyLayout(layout: MultiplexerLayout, mainPaneSize: number): Promise<void>;
     private getBinary;
+    private targetArgs;
     private findBinary;
 }

package/dist/multiplexer/types.d.ts

@@ -2,7 +2,7 @@
  * Multiplexer abstraction layer
  *
  * Provides a unified interface for terminal multiplexers (tmux, zellij, etc.)
- * to spawn and manage panes for background task visualization.
+ * to spawn and manage panes for child agent sessions.
  */
 import type { MultiplexerConfig, MultiplexerLayout } from '../config/schema';
 export interface PaneResult {
@@ -28,9 +28,9 @@ export interface Multiplexer {
      * @param sessionId - The OpenCode session ID to attach to
      * @param description - Human-readable description for the pane
      * @param serverUrl - The OpenCode server URL to attach to
-     * @returns PaneResult with pane ID for later cleanup
+     * @param directory - The project directory to attach from
      */
-    spawnPane(sessionId: string, description: string, serverUrl: string): Promise<PaneResult>;
+    spawnPane(sessionId: string, description: string, serverUrl: string, directory: string): Promise<PaneResult>;
     /**
      * Close a pane by its ID
      * @param paneId - The pane ID returned by spawnPane

package/dist/multiplexer/zellij/index.d.ts

@@ -18,7 +18,7 @@ export declare class ZellijMultiplexer implements Multiplexer {
     constructor(layout?: MultiplexerLayout, mainPaneSize?: number);
     isAvailable(): Promise<boolean>;
     isInsideSession(): boolean;
-    spawnPane(sessionId: string, description: string, serverUrl: string): Promise<PaneResult>;
+    spawnPane(sessionId: string, description: string, serverUrl: string, directory: string): Promise<PaneResult>;
     private createPaneInAgentTab;
     private runInPane;
     private ensureAgentTab;

package/dist/tools/ast-grep/index.d.ts

@@ -1,10 +1,10 @@
 import type { ToolDefinition } from '@opencode-ai/plugin';
 import { ast_grep_replace, ast_grep_search } from './tools';
 export declare const builtinTools: Record<string, ToolDefinition>;
-export { ast_grep_search, ast_grep_replace };
 export { ensureCliAvailable, getAstGrepPath, isCliAvailable, startBackgroundInit, } from './cli';
 export type { EnvironmentCheckResult } from './constants';
 export { checkEnvironment, formatEnvironmentCheck } from './constants';
 export { ensureAstGrepBinary, getCacheDir, getCachedBinaryPath, } from './downloader';
 export type { CliLanguage, CliMatch, SgResult } from './types';
 export { CLI_LANGUAGES } from './types';
+export { ast_grep_replace, ast_grep_search };

package/dist/tools/background.d.ts

@@ -8,6 +8,6 @@ import type { MultiplexerConfig } from '../config/schema';
  * @param manager - Background task manager for launching and tracking tasks
  * @param _multiplexerConfig - Optional multiplexer configuration for session management
  * @param _pluginConfig - Optional plugin configuration for agent variants
- * @returns Object containing background_task, background_output, and background_cancel tools
+ * @returns Object containing background_task, background_output, background_cancel, and ask_orchestrator tools
  */
 export declare function createBackgroundTools(_ctx: PluginInput, manager: BackgroundTaskManager, _multiplexerConfig?: MultiplexerConfig, _pluginConfig?: PluginConfig): Record<string, ToolDefinition>;

package/dist/tools/council.d.ts

@@ -4,6 +4,7 @@ import type { CouncilManager } from '../council/council-manager';
  * Creates the council_session tool for multi-LLM orchestration.
  *
  * This tool triggers a full council session: parallel councillors →
- * master synthesis. Available to the council agent.
+ * formatted results returned to the council agent for synthesis.
+ * Available to the council agent.
  */
 export declare function createCouncilTool(_ctx: PluginInput, councilManager: CouncilManager): Record<string, ToolDefinition>;

package/dist/tools/index.d.ts

@@ -1,5 +1,3 @@
 export { ast_grep_replace, ast_grep_search } from './ast-grep';
-export { createBackgroundTools } from './background';
 export { createCouncilTool } from './council';
-export { lsp_diagnostics, lsp_find_references, lsp_goto_definition, lsp_rename, lspManager, setUserLspConfig, } from './lsp';
 export { createWebfetchTool } from './smartfetch';

package/dist/tools/lsp/types.d.ts

@@ -32,7 +32,7 @@ export type ServerLookupResult = {
     server: ResolvedServer;
     installHint: string;
 };
-export type { Position, Range, Location, LocationLink, Diagnostic, TextDocumentIdentifier, VersionedTextDocumentIdentifier, TextEdit, TextDocumentEdit, CreateFile, RenameFile, DeleteFile, WorkspaceEdit, SymbolInfo, DocumentSymbol, };
+export type { CreateFile, DeleteFile, Diagnostic, DocumentSymbol, Location, LocationLink, Position, Range, RenameFile, SymbolInfo, TextDocumentEdit, TextDocumentIdentifier, TextEdit, VersionedTextDocumentIdentifier, WorkspaceEdit, };
 export interface DocumentDiagnosticReportFull {
     kind: 'full';
     items: Diagnostic[];

package/dist/utils/agent-variant.d.ts

@@ -1,4 +1,4 @@
-import type { PluginConfig } from '../config';
+import { type PluginConfig } from '../config';
 /**
  * Normalizes an agent name by trimming whitespace and removing the optional @ prefix.
  *
@@ -27,6 +27,20 @@ export declare function normalizeAgentName(agentName: string): string;
  * resolveAgentVariant(config, "@oracle") // returns "high" if configured
  */
 export declare function resolveAgentVariant(config: PluginConfig | undefined, agentName: string): string | undefined;
+/**
+ * Resolve a runtime-provided agent name to an internal agent name.
+ *
+ * Supports:
+ * - internal names (e.g. "oracle")
+ * - @-prefixed names (e.g. "@oracle")
+ * - displayName aliases (e.g. "advisor" -> "oracle")
+ */
+export declare function resolveRuntimeAgentName(config: PluginConfig | undefined, agentName: string): string;
+/**
+ * Rewrites user-facing display-name mentions (e.g. @advisor) into internal
+ * agent mentions (e.g. @oracle) for runtime routing.
+ */
+export declare function rewriteDisplayNameMentions(config: PluginConfig | undefined, text: string): string;
 /**
  * Applies a variant to a request body if the body doesn't already have one.
  *

package/dist/utils/subagent-depth.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tracks subagent spawn depth to prevent excessive nesting.
+ *
+ * Depth 0 = root session (user's main conversation)
+ * Depth 1 = agent spawned by root (e.g., explorer, council)
+ * Depth 2 = agent spawned by depth-1 agent (e.g., councillor spawned by council)
+ * Depth 3 = agent spawned by depth-2 agent (max depth by default)
+ *
+ * When max depth is exceeded, the spawn is blocked.
+ */
+export declare class SubagentDepthTracker {
+    private depthBySession;
+    private readonly _maxDepth;
+    constructor(maxDepth?: number);
+    /** Maximum allowed depth. */
+    get maxDepth(): number;
+    /**
+     * Get the current depth of a session.
+     * Root sessions (not tracked) have depth 0.
+     */
+    getDepth(sessionId: string): number;
+    /**
+     * Register a child session and check if the spawn is allowed.
+     * @returns true if allowed, false if max depth exceeded
+     */
+    registerChild(parentSessionId: string, childSessionId: string): boolean;
+    /**
+     * Clean up session tracking when a session is deleted.
+     */
+    cleanup(sessionId: string): void;
+    /**
+     * Clean up all tracking data.
+     */
+    cleanupAll(): void;
+}

package/dist/utils/tmux-debug-log.d.ts

@@ -0,0 +1,2 @@
+export declare function logTmuxDebug(event: string, data?: unknown): void;
+export declare function getTmuxDebugLogPath(): string;

package/oh-my-opencode-slim.schema.json

@@ -19,6 +19,10 @@
     "balanceProviderUsage": {
       "type": "boolean"
     },
+    "showStartupToast": {
+      "description": "Show the startup activation toast when OpenCode starts. Defaults to true.",
+      "type": "boolean"
+    },
     "manualPlan": {
       "type": "object",
       "properties": {
@@ -214,6 +218,7 @@
                   "type": "string"
                 },
                 {
+                  "minItems": 1,
                   "type": "array",
                   "items": {
                     "anyOf": [
@@ -259,14 +264,27 @@
                 "type": "string"
               }
             },
+            "prompt": {
+              "type": "string",
+              "minLength": 1
+            },
+            "orchestratorPrompt": {
+              "type": "string",
+              "minLength": 1
+            },
             "options": {
               "type": "object",
               "propertyNames": {
                 "type": "string"
               },
               "additionalProperties": {}
+            },
+            "displayName": {
+              "type": "string",
+              "minLength": 1
             }
-          }
+          },
+          "additionalProperties": false
         }
       }
     },
@@ -284,6 +302,7 @@
                 "type": "string"
               },
               {
+                "minItems": 1,
                 "type": "array",
                 "items": {
                   "anyOf": [
@@ -329,18 +348,31 @@
               "type": "string"
             }
           },
+          "prompt": {
+            "type": "string",
+            "minLength": 1
+          },
+          "orchestratorPrompt": {
+            "type": "string",
+            "minLength": 1
+          },
           "options": {
             "type": "object",
             "propertyNames": {
               "type": "string"
             },
             "additionalProperties": {}
+          },
+          "displayName": {
+            "type": "string",
+            "minLength": 1
           }
-        }
+        },
+        "additionalProperties": false
       }
     },
     "disabled_agents": {
-      "description": "Agent names to disable completely. Disabled agents are not instantiated and cannot be delegated to. Orchestrator and council internal agents (councillor, council-master) cannot be disabled. By default, 'observer' is disabled. Remove it from this list and configure a vision-capable model to enable.",
+      "description": "Agent names to disable completely. Disabled agents are not instantiated and cannot be delegated to. Orchestrator and council internal agents (councillor) cannot be disabled. By default, 'observer' is disabled. Remove it from this list and configure a vision-capable model to enable.",
       "type": "array",
       "items": {
         "type": "string"
@@ -423,17 +455,6 @@
         }
       }
     },
-    "background": {
-      "type": "object",
-      "properties": {
-        "maxConcurrentStarts": {
-          "default": 10,
-          "type": "number",
-          "minimum": 1,
-          "maximum": 50
-        }
-      }
-    },
     "interview": {
       "type": "object",
       "properties": {
@@ -450,6 +471,7 @@
         },
         "autoOpenBrowser": {
           "default": true,
+          "description": "Automatically open the interview UI in your default browser during interactive runs. Disabled automatically in tests and CI.",
           "type": "boolean"
         },
         "port": {
@@ -577,26 +599,6 @@
     "council": {
       "type": "object",
       "properties": {
-        "master": {
-          "type": "object",
-          "properties": {
-            "model": {
-              "type": "string",
-              "pattern": "^[^/\\s]+\\/[^\\s]+$",
-              "description": "Model ID for the council master (e.g. \"anthropic/claude-opus-4-6\")"
-            },
-            "variant": {
-              "type": "string"
-            },
-            "prompt": {
-              "description": "Optional role/guidance injected into the master synthesis prompt",
-              "type": "string"
-            }
-          },
-          "required": [
-            "model"
-          ]
-        },
         "presets": {
           "type": "object",
           "propertyNames": {
@@ -616,12 +618,7 @@
             }
           }
         },
-        "master_timeout": {
-          "default": 300000,
-          "type": "number",
-          "minimum": 0
-        },
-        "councillors_timeout": {
+        "timeout": {
           "default": 180000,
           "type": "number",
           "minimum": 0
@@ -630,14 +627,6 @@
           "default": "default",
           "type": "string"
         },
-        "master_fallback": {
-          "description": "Fallback models for the council master. Tried in order if the primary model fails. Example: [\"anthropic/claude-sonnet-4-6\", \"openai/gpt-5.4\"]",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[^/\\s]+\\/[^\\s]+$"
-          }
-        },
         "councillor_execution_mode": {
           "default": "parallel",
           "description": "Execution mode for councillors. \"serial\" runs them one at a time (required for single-model systems). \"parallel\" runs them concurrently (default, faster for multi-model systems).",
@@ -649,14 +638,22 @@
         },
         "councillor_retries": {
           "default": 3,
-          "description": "Number of retry attempts for councillors and master that return empty responses (e.g. due to provider rate limiting). Default: 3 retries.",
+          "description": "Number of retry attempts for councillors that return empty responses (e.g. due to provider rate limiting). Default: 3 retries.",
           "type": "integer",
           "minimum": 0,
           "maximum": 5
+        },
+        "master": {
+          "description": "DEPRECATED — ignored. Council agent synthesizes directly."
+        },
+        "master_timeout": {
+          "description": "DEPRECATED — ignored. Use \"timeout\" instead."
+        },
+        "master_fallback": {
+          "description": "DEPRECATED — ignored. No separate master session."
         }
       },
       "required": [
-        "master",
         "presets"
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-slim",
-  "version": "0.9.14",
+  "version": "1.0.0",
   "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,14 +36,16 @@
     "LICENSE"
   ],
   "scripts": {
-    "build:plugin": "bun build src/index.ts --outdir dist --target node --format esm --external @ast-grep/napi --external @opencode-ai/plugin --external @opencode-ai/sdk --external jsdom",
-    "build:cli": "bun build src/cli/index.ts --outdir dist/cli --target node --format esm --external @ast-grep/napi --external @opencode-ai/plugin --external @opencode-ai/sdk --external jsdom",
+    "build:plugin": "bun build src/index.ts --outdir dist --target node --format esm --external @ast-grep/napi --external @opencode-ai/plugin --external @opencode-ai/sdk --external jsdom --external zod",
+    "build:cli": "bun build src/cli/index.ts --outdir dist/cli --target node --format esm --external @ast-grep/napi --external @opencode-ai/plugin --external @opencode-ai/sdk --external jsdom --external zod",
     "build": "bun run build:plugin && bun run build:cli && tsc --emitDeclarationOnly && bun run generate-schema",
     "prepare": "bun run build",
     "contributors:add": "all-contributors add",
     "contributors:check": "all-contributors check",
     "contributors:generate": "all-contributors generate",
     "generate-schema": "bun run scripts/generate-schema.ts",
+    "verify:release": "bun run scripts/verify-release-artifact.ts",
+    "verify:host-smoke": "bun run scripts/verify-opencode-host-smoke.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "lint": "biome lint .",
@@ -64,21 +66,20 @@
     "@opencode-ai/sdk": "^1.3.17",
     "jsdom": "^26.1.0",
     "lru-cache": "^11.3.3",
-    "turndown": "^7.2.4",
-    "vscode-jsonrpc": "^8.2.1",
-    "vscode-languageserver-protocol": "^3.17.5",
-    "which": "^6.0.1",
-    "zod": "^4.3.6"
+    "turndown": "^7.2.4"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.11",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^24.6.1",
     "@types/turndown": "^5.0.6",
-    "@types/which": "^3.0.4",
     "all-contributors-cli": "^6.26.1",
     "bun-types": "1.3.12",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
   },
   "trustedDependencies": [
     "@ast-grep/cli"

package/src/skills/{cartography → codemap}/README.md

@@ -1,31 +1,33 @@
-# Cartography Skill
+# Codemap Skill
 
 Repository understanding and hierarchical codemap generation.
 
 ## Overview
 
-Cartography helps orchestrators map and understand codebases by:
+Codemap helps orchestrators map and understand codebases by:
 
 1. Selecting relevant code/config files using LLM judgment
-2. Creating `.slim/cartography.json` for change tracking
-3. Generating empty `codemap.md` templates for explorers to fill in
+2. Creating `.slim/codemap.json` for change tracking
+3. Generating empty `codemap.md` templates for fixers to fill in
+
+Legacy `.slim/cartography.json` state is migrated to `.slim/codemap.json` automatically.
 
 ## Commands
 
 ```bash
 # Initialize mapping
-python3 cartographer.py init --root /repo --include "src/**/*.ts" --exclude "node_modules/**"
+node codemap.mjs init --root /repo --include "src/**/*.ts" --exclude "node_modules/**"
 
 # Check what changed
-python3 cartographer.py changes --root /repo
+node codemap.mjs changes --root /repo
 
 # Update hashes
-python3 cartographer.py update --root /repo
+node codemap.mjs update --root /repo
 ```
 
 ## Outputs
 
-### .slim/cartography.json
+### .slim/codemap.json
 
 ```json
 {
@@ -46,7 +48,7 @@ python3 cartographer.py update --root /repo
 
 ### codemap.md (per folder)
 
-Empty templates created in each folder for explorers to fill with:
+Empty templates created in each folder for fixers to fill with:
 - Responsibility
 - Design patterns
 - Data/control flow

package/src/skills/{cartography → codemap}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: cartography
+name: codemap
 description: Generate comprehensive hierarchical codemaps for UNFAMILIAR repositories. Expensive operation - only use when explicitly asked for codebase documentation or initial repository mapping
 ---
 
-# Cartography Skill
+# Codemap Skill
 
 You help users understand and map repositories by creating hierarchical codemaps.
 
@@ -17,11 +17,15 @@ You help users understand and map repositories by creating hierarchical codemaps
 
 ### Step 1: Check for Existing State
 
-**First, check if `.slim/cartography.json` exists in the repo root.**
+**First, check if `.slim/codemap.json` exists in the repo root.**
 
-If it **exists**: Skip to Step 3 (Detect Changes) - no need to re-initialize.
+If it does not exist, check for legacy state at `.slim/cartography.json`.
 
-If it **doesn't exist**: Continue to Step 2 (Initialize).
+If legacy state exists: move `.slim/cartography.json` to `.slim/codemap.json`, then continue with change detection.
+
+If `.slim/codemap.json` exists: Skip to Step 3 (Detect Changes) - no need to re-initialize.
+
+If neither file exists: Continue to Step 2 (Initialize).
 
 ### Step 2: Initialize (Only if no state exists)
 
@@ -33,27 +37,27 @@ If it **doesn't exist**: Continue to Step 2 (Initialize).
      - Docs: `docs/**`, `*.md` (except root `README.md` if needed), `LICENSE`
      - Build/Deps: `node_modules/**`, `dist/**`, `build/**`, `*.min.js`
    - Respect `.gitignore` automatically
-3. **Run cartographer.py init**:
+3. **Run codemap.mjs init**:
 
 ```bash
-python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py init \
+node ~/.config/opencode/skills/codemap/scripts/codemap.mjs init \
   --root ./ \
   --include "src/**/*.ts" \
   --exclude "**/*.test.ts" --exclude "dist/**" --exclude "node_modules/**"
 ```
 
 This creates:
-- `.slim/cartography.json` - File and folder hashes for change detection
+- `.slim/codemap.json` - File and folder hashes for change detection
 - Empty `codemap.md` files in all relevant subdirectories
 
-4. **Delegate to Explorer agents** - Spawn one explorer per folder to read code and fill in its specific `codemap.md` file.
+4. **Delegate codemap writing to Fixer agents** - Spawn one fixer per folder to read code and create or update its specific `codemap.md` file.
 
 ### Step 3: Detect Changes (If state already exists)
 
-1. **Run cartographer.py changes** to see what changed:
+1. **Run codemap.mjs changes** to see what changed:
 
 ```bash
-python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py changes \
+node ~/.config/opencode/skills/codemap/scripts/codemap.mjs changes \
   --root ./
 ```
 
@@ -63,11 +67,11 @@ python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py changes \
    - Modified files
    - Affected folders
 
-3. **Only update affected codemaps** - Spawn one explorer per affected folder to update its `codemap.md`.
+3. **Only update affected codemaps** - Spawn one fixer per affected folder to update its `codemap.md`.
 4. **Run update** to save new state:
 
 ```bash
-python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py update \
+node ~/.config/opencode/skills/codemap/scripts/codemap.mjs update \
   --root ./
 ```
 
@@ -100,12 +104,11 @@ Before working on any task, read `codemap.md` to understand:
 For deep work on a specific folder, also read that folder's `codemap.md`.
 ```
 
-This is idempotent — repeated cartography runs will detect the existing section and skip. No duplication.
-
+This is idempotent — repeated codemap runs will detect the existing section and skip. No duplication.
 
 ## Codemap Content
 
-Explorers are granted write permissions for `codemap.md` files during this workflow. Use precise technical terminology to document the implementation:
+Fixers are responsible for writing `codemap.md` files during this workflow. Use precise technical terminology to document the implementation:
 
 - **Responsibility** - Define the specific role of this directory using standard software engineering terms (e.g., "Service Layer", "Data Access Object", "Middleware").
 - **Design Patterns** - Identify and name specific patterns used (e.g., "Observer", "Singleton", "Factory", "Strategy"). Detail the abstractions and interfaces.
@@ -144,7 +147,7 @@ Example **Root Codemap (Atlas)**:
 # Repository Atlas: oh-my-opencode-slim
 
 ## Project Responsibility
-A high-performance, low-latency agent orchestration plugin for OpenCode, focusing on specialized sub-agent delegation and background task management.
+A high-performance, low-latency agent orchestration plugin for OpenCode, focusing on specialized sub-agent delegation and multiplexer-assisted child sessions.
 
 ## System Entry Points
 - `src/index.ts`: Plugin initialization and OpenCode integration.
@@ -155,6 +158,6 @@ A high-performance, low-latency agent orchestration plugin for OpenCode, focusin
 | Directory | Responsibility Summary | Detailed Map |
 |-----------|------------------------|--------------|
 | `src/agents/` | Defines agent personalities (Orchestrator, Explorer) and manages model routing. | [View Map](src/agents/codemap.md) |
-| `src/features/` | Core logic for tmux integration, background task spawning, and session state. | [View Map](src/features/codemap.md) |
+| `src/features/` | Core logic for tmux integration and session state. | [View Map](src/features/codemap.md) |
 | `src/config/` | Implements the configuration loading pipeline and environment variable injection. | [View Map](src/config/codemap.md) |
 ```