@doingdev/opencode-claude-manager-plugin 0.1.34 → 0.1.42

package/README.md

@@ -53,15 +53,15 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 
 ### Engineer session
 
-- `engineer_send` — send a message to the persistent Claude Code session. Auto-creates on first call, resumes on subsequent calls.
+- `explore` — investigate and analyze code without making edits. Read-only exploration of the codebase. Preferred first step before implementation.
   - `message` (required) — the instruction to send.
-  - `mode` — `"plan"` (read-only investigation) or `"free"` (default, normal execution with edits).
   - `freshSession` — set to `true` to clear the active session before sending. Use when switching to an unrelated task or when context is contaminated.
   - `model` — `"claude-opus-4-6"` (default, recommended for most coding work), `"claude-sonnet-4-6"`, or `"claude-sonnet-4-5"` (faster/lighter tasks).
   - `effort` — `"high"` (default), `"medium"` (lighter tasks), `"low"`, or `"max"` (especially hard problems).
-- `engineer_compact` — compress the active session context while preserving session state. Use before clearing when context is high but salvageable.
-- `engineer_clear` — drop the active session entirely; next send starts fresh.
-- `engineer_status` — get current session health: context %, turns, cost, session ID.
+- `implement` — implement code changes; can read, edit, and create files. Use after exploration to make changes. Same args as `explore`.
+- `compact_context` — compress session history to reclaim context window space. Preserves state while reducing token usage.
+- `clear_session` — clear the active session to start fresh. Use when context is full or starting a new task.
+- `session_health` — check session health metrics: context usage %, turn count, cost, and session ID.
 
 ### Git operations
 
@@ -71,9 +71,8 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 
 ### Inspection
 
-- `engineer_metadata` — inspect available Claude commands, skills, hooks, and settings.
-- `engineer_sessions` — list Claude sessions or inspect a saved transcript.
-- `engineer_runs` — list or inspect persisted manager run records (may be empty if tasks were sent directly via `engineer_send` rather than the run-tracking path).
+- `list_transcripts` — list available session transcripts or inspect a specific transcript by ID.
+- `list_history` — list persistent run records from the manager or inspect a specific run.
 
 ### Tool approval
 
@@ -86,7 +85,7 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 The plugin registers a CTO → Manager → Engineer hierarchy through the OpenCode plugin `config` hook:
 
 - **`cto`** (primary agent) — sets direction and orchestrates work by spawning `manager` subagents. Has read/search/web tools but does NOT operate Claude Code directly.
-- **`manager`** (subagent) — operates a Claude Code engineer through a persistent session. Has the full tool surface (`engineer_*`, `git_*`, `approval_*`) plus read/search/web tools for investigation.
+- **`manager`** (subagent) — operates a Claude Code engineer through a persistent session. Has the full tool surface (`explore`, `implement`, `compact_context`, `clear_session`, `session_health`, `list_transcripts`, `list_history`, `git_*`, `approval_*`) plus read/search/web tools for investigation.
 - **Engineer** — the Claude Code persistent session itself (not an OpenCode agent). Receives instructions from the manager, executes code changes, and reports results.
 
 These are added to OpenCode config at runtime by the plugin, so they do not require separate manual `opencode.json` entries.
@@ -95,27 +94,27 @@ These are added to OpenCode config at runtime by the plugin, so they do not requ
 
 Typical flow inside OpenCode:
 
-1. Inspect Claude capabilities with `engineer_metadata`.
-2. Delegate work with `engineer_send`.
+1. Explore the codebase with `explore`.
+2. Implement changes with `implement`.
 3. Review changes with `git_diff`, then commit or reset.
-4. Inspect saved Claude history with `engineer_sessions` or prior orchestration records with `engineer_runs`.
+4. Inspect saved Claude history with `list_transcripts` or prior orchestration records with `list_history`.
 
 Example tasks:
 
 ```text
-Use engineer_send to implement the new validation logic in src/auth.ts, then review with git_diff.
+Use implement to add the new validation logic in src/auth.ts, then review with git_diff.
 ```
 
 Start a fresh session for an unrelated task:
 
 ```text
-Use engineer_send with freshSession:true to investigate the failing CI test in test/api.test.ts using mode:"plan".
+Use explore with freshSession:true to investigate the failing CI test in test/api.test.ts.
 ```
 
 Reclaim context mid-session:
 
 ```text
-Use engineer_compact to free up context, then continue with the next implementation step.
+Use compact_context to free up context, then continue with the next implementation step.
 ```
 
 ## Local Development

package/dist/claude/claude-agent-sdk-adapter.js

@@ -162,6 +162,7 @@ export class ClaudeAgentSdkAdapter {
             forkSession: input.forkSession,
             persistSession: input.persistSession,
             includePartialMessages: input.includePartialMessages,
+            enableFileCheckpointing: false,
             settingSources: input.settingSources,
             maxTurns: input.maxTurns,
             model: input.model,
@@ -409,7 +410,7 @@ function truncateJsonish(value, max) {
         return truncateString(JSON.stringify(value), max);
     }
     catch {
-        return truncateString(String(value), max);
+        return truncateString('[non-serializable]', max);
     }
 }
 function truncateString(s, max) {

package/dist/claude/session-live-tailer.js

@@ -99,7 +99,7 @@ export class SessionLiveTailer {
                 });
                 let chunk = '';
                 stream.on('data', (data) => {
-                    chunk += data;
+                    chunk += typeof data === 'string' ? data : data.toString('utf8');
                 });
                 stream.on('end', () => {
                     reading = false;
@@ -264,6 +264,6 @@ function stringifyContent(value) {
         return JSON.stringify(value);
     }
     catch {
-        return String(value);
+        return '[non-serializable]';
     }
 }

package/dist/manager/git-operations.d.ts

@@ -2,10 +2,19 @@ import type { GitDiffResult, GitOperationResult } from '../types/contracts.js';
 export declare class GitOperations {
     private readonly cwd;
     constructor(cwd: string);
-    diff(): Promise<GitDiffResult>;
+    diff(options?: {
+        paths?: string[];
+        staged?: boolean;
+        ref?: string;
+    }): Promise<GitDiffResult>;
     diffStat(): Promise<string>;
     commit(message: string): Promise<GitOperationResult>;
     resetHard(): Promise<GitOperationResult>;
+    status(): Promise<{
+        output: string;
+        isClean: boolean;
+    }>;
+    log(count?: number): Promise<string>;
     currentBranch(): Promise<string>;
     recentCommits(count?: number): Promise<string>;
     private git;

package/dist/manager/git-operations.js

@@ -6,10 +6,15 @@ export class GitOperations {
     constructor(cwd) {
         this.cwd = cwd;
     }
-    async diff() {
+    async diff(options = {}) {
+        const ref = options.staged ? '--cached' : (options.ref ?? 'HEAD');
+        const args = ['diff', ref];
+        if (options.paths && options.paths.length > 0) {
+            args.push('--', ...options.paths);
+        }
         const [diffText, statOutput] = await Promise.all([
-            this.git(['diff', 'HEAD']),
-            this.git(['diff', 'HEAD', '--stat']),
+            this.git(args),
+            this.git([...args, '--stat']),
         ]);
         const stats = parseStatLine(statOutput);
         return {
@@ -50,6 +55,16 @@ export class GitOperations {
             };
         }
     }
+    async status() {
+        const output = await this.git(['status', '-s']);
+        return {
+            output,
+            isClean: output.trim().length === 0,
+        };
+    }
+    async log(count = 5) {
+        return this.git(['log', '--oneline', `-${count}`]);
+    }
     async currentBranch() {
         const branch = await this.git(['rev-parse', '--abbrev-ref', 'HEAD']);
         return branch.trim();

package/dist/manager/persistent-manager.d.ts

@@ -35,11 +35,26 @@ export declare class PersistentManager {
     /**
      * Get the current git diff.
      */
-    gitDiff(): Promise<GitDiffResult>;
+    gitDiff(options?: {
+        paths?: string[];
+        staged?: boolean;
+        ref?: string;
+    }): Promise<GitDiffResult>;
     /**
      * Commit all current changes.
      */
     gitCommit(message: string): Promise<GitOperationResult>;
+    /**
+     * Get git status summary.
+     */
+    gitStatus(): Promise<{
+        output: string;
+        isClean: boolean;
+    }>;
+    /**
+     * Get recent commit log.
+     */
+    gitLog(count?: number): Promise<string>;
     /**
      * Hard reset to discard all uncommitted changes.
      */

package/dist/manager/persistent-manager.js

@@ -35,8 +35,8 @@ export class PersistentManager {
     /**
      * Get the current git diff.
      */
-    async gitDiff() {
-        return this.gitOps.diff();
+    async gitDiff(options = {}) {
+        return this.gitOps.diff(options);
     }
     /**
      * Commit all current changes.
@@ -44,6 +44,18 @@ export class PersistentManager {
     async gitCommit(message) {
         return this.gitOps.commit(message);
     }
+    /**
+     * Get git status summary.
+     */
+    async gitStatus() {
+        return this.gitOps.status();
+    }
+    /**
+     * Get recent commit log.
+     */
+    async gitLog(count = 5) {
+        return this.gitOps.log(count);
+    }
     /**
      * Hard reset to discard all uncommitted changes.
      */

package/dist/plugin/agent-hierarchy.d.ts

@@ -11,7 +11,7 @@ export declare const AGENT_CTO = "cto";
 export declare const AGENT_ENGINEER_PLAN = "engineer_plan";
 export declare const AGENT_ENGINEER_BUILD = "engineer_build";
 /** All restricted tool IDs (union of all domain groups) */
-export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["engineer_send", "engineer_send_plan", "engineer_send_build", "engineer_compact", "engineer_clear", "engineer_status", "engineer_sessions", "engineer_runs", "git_diff", "git_commit", "git_reset", "approval_policy", "approval_decisions", "approval_update"];
+export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["explore", "implement", "compact_context", "clear_session", "session_health", "list_transcripts", "list_history", "git_diff", "git_commit", "git_reset", "git_status", "git_log", "approval_policy", "approval_decisions", "approval_update"];
 type ToolPermission = 'allow' | 'ask' | 'deny';
 type AgentPermission = {
     '*'?: ToolPermission;

package/dist/plugin/agent-hierarchy.js

@@ -17,25 +17,20 @@ export const AGENT_ENGINEER_BUILD = 'engineer_build';
 // ---------------------------------------------------------------------------
 /** Shared engineer session tools (compact, clear, status, diagnostics) */
 const ENGINEER_SHARED_TOOL_IDS = [
-    'engineer_compact',
-    'engineer_clear',
-    'engineer_status',
-    'engineer_sessions',
-    'engineer_runs',
-];
-/** All engineer tools — generic send + mode-locked sends + shared session tools */
-const ENGINEER_TOOL_IDS = [
-    'engineer_send',
-    'engineer_send_plan',
-    'engineer_send_build',
-    ...ENGINEER_SHARED_TOOL_IDS,
+    'compact_context',
+    'clear_session',
+    'session_health',
+    'list_transcripts',
+    'list_history',
 ];
+/** All engineer tools — mode-locked sends + shared session tools */
+const ENGINEER_TOOL_IDS = ['explore', 'implement', ...ENGINEER_SHARED_TOOL_IDS];
 /** Tools for the engineer_plan wrapper (plan-mode send + shared) */
-const ENGINEER_PLAN_TOOL_IDS = ['engineer_send_plan', ...ENGINEER_SHARED_TOOL_IDS];
+const ENGINEER_PLAN_TOOL_IDS = ['explore', ...ENGINEER_SHARED_TOOL_IDS];
 /** Tools for the engineer_build wrapper (build-mode send + shared) */
-const ENGINEER_BUILD_TOOL_IDS = ['engineer_send_build', ...ENGINEER_SHARED_TOOL_IDS];
+const ENGINEER_BUILD_TOOL_IDS = ['implement', ...ENGINEER_SHARED_TOOL_IDS];
 /** Git tools — owned by CTO */
-const GIT_TOOL_IDS = ['git_diff', 'git_commit', 'git_reset'];
+const GIT_TOOL_IDS = ['git_diff', 'git_commit', 'git_reset', 'git_status', 'git_log'];
 /** Approval tools — owned by CTO */
 const APPROVAL_TOOL_IDS = ['approval_policy', 'approval_decisions', 'approval_update'];
 /** All restricted tool IDs (union of all domain groups) */
@@ -87,7 +82,7 @@ function buildCtoPermissions() {
         },
     };
 }
-/** Engineer plan wrapper: read-only investigation + engineer_send_plan + shared session tools. */
+/** Engineer plan wrapper: read-only investigation + explore + shared session tools. */
 function buildEngineerPlanPermissions() {
     const denied = {};
     for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
@@ -104,7 +99,7 @@ function buildEngineerPlanPermissions() {
         ...allowed,
     };
 }
-/** Engineer build wrapper: read-only investigation + engineer_send_build + shared session tools. */
+/** Engineer build wrapper: read-only investigation + implement + shared session tools. */
 function buildEngineerBuildPermissions() {
     const denied = {};
     for (const toolId of ALL_RESTRICTED_TOOL_IDS) {