@doingdev/opencode-claude-manager-plugin 0.1.46 → 0.1.49

package/README.md

@@ -4,17 +4,20 @@ This package provides an OpenCode plugin that lets an OpenCode-side agent hierar
 
 ## Overview
 
-Use this when you want OpenCode to act as a manager over Claude Code instead of talking to Claude directly. The plugin gives OpenCode a stable tool surface for delegating work to Claude Code sessions, managing session lifecycle (compact, clear, fresh start), reviewing changes via git, and inspecting session history.
+Use this when you want OpenCode to act like a real technical lead over Claude Code instead of being a thin relay. The plugin gives you a CTO agent that can ask better questions, explicitly assign named engineers, reuse each engineer's Claude session for continuity, preserve wrapper-level engineer memory, compare multiple plans, and keep git/review work at the manager layer.
 
 ## Features
 
 - Runs Claude Code tasks from OpenCode through `@anthropic-ai/claude-agent-sdk`.
-- Persistent sessions with `freshSession`, model, and effort controls for safe task isolation.
-- Context lifecycle: compact (preserve state) or clear (start fresh).
+- Creates a persistent named team: `Tom`, `John`, `Maya`, `Sara`, and `Alex`.
+- Reuses one Claude Code session per engineer within the active CTO team.
+- Reloads prior engineer wrapper context so each named subagent can prompt Claude better over time.
+- Uses named engineer subagents for live delegated work while keeping both wrapper memory and Claude session continuity underneath.
+- Keeps session babysitting out of the normal user flow — no public reset/fresh-session controls.
 - Discovers repo-local Claude metadata from `.claude/skills`, `.claude/commands`, `CLAUDE.md`, and settings hooks.
 - Git integration: diff, commit, and reset from the manager layer.
 - Tool approval policy for governing which Claude Code tools are allowed.
-- Optionally persists manager run records under `.claude-manager/runs` for post-hoc inspection (populated when tasks are executed through the run-tracking path).
+- Persists local team state and transcripts under `.claude-manager/` for continuity and inspection.
 
 ## Requirements
 
@@ -51,17 +54,17 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 
 ## OpenCode tools
 
-### Engineer session
+### CTO orchestration
 
-- `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.
-  - `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).
-- `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.
+- Use the built-in OpenCode `task` tool to delegate to named engineers: `tom`, `john`, `maya`, `sara`, `alex`.
+- `team_status` — inspect the current CTO team's engineer bindings, Claude session IDs, busy flags, and context snapshots.
+
+### Engineer bridge
+
+- `claude` — available only inside named engineer subagents. Sends work through that engineer's persistent Claude Code session.
+  - `mode` (required) — `explore`, `implement`, or `verify`.
+  - `message` (required) — the work to do.
+  - `model` (optional) — `claude-opus-4-6` or `claude-sonnet-4-6`.
 
 ### Git operations
 
@@ -72,7 +75,7 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 ### Inspection
 
 - `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.
+- `list_history` — list saved CTO teams for the worktree or inspect one team by ID.
 
 ### Tool approval
 
@@ -82,11 +85,11 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 
 ## Agent hierarchy
 
-The plugin registers a CTO → Manager → Engineer hierarchy through the OpenCode plugin `config` hook:
+The plugin registers a CTO + named engineer team 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 (`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.
+- **`cto`** (primary agent) — owns the outcome, finds missing requirements, spawns named engineers with the Task tool, compares plans, reviews diffs, and manages git.
+- **`tom`**, **`john`**, **`maya`**, **`sara`**, **`alex`** (subagents) — thin named engineer wrappers. Each uses the `claude` tool and keeps one persistent Claude Code session.
+- **Claude Code sessions** — the underlying execution layer. One session per engineer inside the active team.
 
 These are added to OpenCode config at runtime by the plugin, so they do not require separate manual `opencode.json` entries.
 
@@ -94,27 +97,21 @@ These are added to OpenCode config at runtime by the plugin, so they do not requ
 
 Typical flow inside OpenCode:
 
-1. Explore the codebase with `explore`.
-2. Implement changes with `implement`.
+1. Ask the `cto` agent for the work.
+2. Let `cto` spawn one or more named engineers with the Task tool.
 3. Review changes with `git_diff`, then commit or reset.
-4. Inspect saved Claude history with `list_transcripts` or prior orchestration records with `list_history`.
+4. Inspect saved Claude history with `list_transcripts` or saved team state with `list_history` / `team_status`.
 
 Example tasks:
 
 ```text
-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 explore with freshSession:true to investigate the failing CI test in test/api.test.ts.
+Ask CTO to send Tom to implement the new validation logic in src/auth.ts, then review with git_diff.
 ```
 
-Reclaim context mid-session:
+For a larger feature where you want two independent plans first:
 
 ```text
-Use compact_context to free up context, then continue with the next implementation step.
+Ask CTO to spawn Maya and Alex in parallel to create two plans for the new billing feature, then synthesize the best combined plan.
 ```
 
 ## Local Development
@@ -176,6 +173,7 @@ After trusted publishing is working, you can tighten npm package security by dis
 
 - Claude slash commands and skills come primarily from filesystem discovery; SDK probing is available but optional.
 - Session state is local to the repo under `.claude-manager/` and is ignored by git.
+- The strongest team continuity comes when engineers are spawned from the active `cto` session; the plugin maps named engineers back to that active team automatically.
 - Context tracking is heuristic-based; actual SDK context usage may differ slightly.
 
 ## Scripts

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from '@opencode-ai/plugin';
 import { ClaudeManagerPlugin } from './plugin/claude-manager.plugin.js';
-export type { ClaudeCapabilitySnapshot, ClaudeSessionRunResult, ClaudeSessionSummary, ClaudeSessionTranscriptMessage, ManagerPromptRegistry, RunClaudeSessionInput, SessionContextSnapshot, GitDiffResult, GitOperationResult, PersistentRunRecord, PersistentRunResult, ContextWarningLevel, SessionMode, LiveTailEvent, ToolOutputPreview, ToolApprovalRule, ToolApprovalPolicy, ToolApprovalDecision, } from './types/contracts.js';
+export type { ClaudeCapabilitySnapshot, ClaudeSessionRunResult, ClaudeSessionSummary, ClaudeSessionTranscriptMessage, ManagerPromptRegistry, RunClaudeSessionInput, SessionContextSnapshot, GitDiffResult, GitOperationResult, PersistentRunRecord, PersistentRunResult, ContextWarningLevel, SessionMode, EngineerName, EngineerWorkMode, WrapperHistoryEntry, TeamEngineerRecord, TeamRecord, EngineerTaskResult, PlanDraft, SynthesizedPlanResult, LiveTailEvent, ToolOutputPreview, ToolApprovalRule, ToolApprovalPolicy, ToolApprovalDecision, } from './types/contracts.js';
 export { SessionLiveTailer } from './claude/session-live-tailer.js';
 export { ClaudeManagerPlugin };
 export declare const plugin: Plugin;

package/dist/manager/team-orchestrator.d.ts

@@ -0,0 +1,50 @@
+import type { ClaudeSessionEventHandler } from '../claude/claude-agent-sdk-adapter.js';
+import type { ClaudeSessionService } from '../claude/claude-session.service.js';
+import type { TeamStateStore } from '../state/team-state-store.js';
+import type { TranscriptStore } from '../state/transcript-store.js';
+import type { DiscoveredClaudeFile, EngineerName, EngineerTaskResult, EngineerWorkMode, SynthesizedPlanResult, TeamRecord } from '../types/contracts.js';
+interface DispatchEngineerInput {
+    teamId: string;
+    cwd: string;
+    engineer: EngineerName;
+    mode: EngineerWorkMode;
+    message: string;
+    model?: string;
+    abortSignal?: AbortSignal;
+    onEvent?: ClaudeSessionEventHandler;
+}
+export declare class TeamOrchestrator {
+    private readonly sessions;
+    private readonly teamStore;
+    private readonly transcriptStore;
+    private readonly engineerSessionPrompt;
+    private readonly projectClaudeFiles;
+    constructor(sessions: ClaudeSessionService, teamStore: TeamStateStore, transcriptStore: TranscriptStore, engineerSessionPrompt: string, projectClaudeFiles: DiscoveredClaudeFile[]);
+    getOrCreateTeam(cwd: string, teamId: string): Promise<TeamRecord>;
+    listTeams(cwd: string): Promise<TeamRecord[]>;
+    recordWrapperSession(cwd: string, teamId: string, engineer: EngineerName, wrapperSessionId: string): Promise<void>;
+    recordWrapperExchange(cwd: string, teamId: string, engineer: EngineerName, wrapperSessionId: string, mode: EngineerWorkMode, assignment: string, result: string): Promise<void>;
+    getWrapperSystemContext(cwd: string, teamId: string, engineer: EngineerName): Promise<string | null>;
+    findTeamByWrapperSession(cwd: string, wrapperSessionId: string): Promise<{
+        teamId: string;
+        engineer: EngineerName;
+    } | null>;
+    dispatchEngineer(input: DispatchEngineerInput): Promise<EngineerTaskResult>;
+    planWithTeam(input: {
+        teamId: string;
+        cwd: string;
+        request: string;
+        leadEngineer: EngineerName;
+        challengerEngineer: EngineerName;
+        model?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<SynthesizedPlanResult>;
+    private updateEngineer;
+    private reserveEngineer;
+    private getEngineerState;
+    private normalizeTeamRecord;
+    private buildSessionSystemPrompt;
+    private buildEngineerPrompt;
+    private mapWorkModeToSessionMode;
+}
+export {};

package/dist/manager/team-orchestrator.js

@@ -0,0 +1,360 @@
+import { createEmptyEngineerRecord, createEmptyTeamRecord } from '../team/roster.js';
+import { ContextTracker } from './context-tracker.js';
+export class TeamOrchestrator {
+    sessions;
+    teamStore;
+    transcriptStore;
+    engineerSessionPrompt;
+    projectClaudeFiles;
+    constructor(sessions, teamStore, transcriptStore, engineerSessionPrompt, projectClaudeFiles) {
+        this.sessions = sessions;
+        this.teamStore = teamStore;
+        this.transcriptStore = transcriptStore;
+        this.engineerSessionPrompt = engineerSessionPrompt;
+        this.projectClaudeFiles = projectClaudeFiles;
+    }
+    async getOrCreateTeam(cwd, teamId) {
+        const existing = await this.teamStore.getTeam(cwd, teamId);
+        if (existing) {
+            return this.normalizeTeamRecord(existing);
+        }
+        const created = createEmptyTeamRecord(teamId, cwd);
+        await this.teamStore.saveTeam(created);
+        return created;
+    }
+    async listTeams(cwd) {
+        const teams = await this.teamStore.listTeams(cwd);
+        return teams.map((team) => this.normalizeTeamRecord(team));
+    }
+    async recordWrapperSession(cwd, teamId, engineer, wrapperSessionId) {
+        await this.updateEngineer(cwd, teamId, engineer, (entry) => ({
+            ...entry,
+            wrapperSessionId,
+        }));
+    }
+    async recordWrapperExchange(cwd, teamId, engineer, wrapperSessionId, mode, assignment, result) {
+        const timestamp = new Date().toISOString();
+        await this.updateEngineer(cwd, teamId, engineer, (entry) => ({
+            ...entry,
+            wrapperSessionId,
+            wrapperHistory: appendWrapperHistoryEntries(entry.wrapperHistory, [
+                { timestamp, type: 'assignment', mode, text: summarizeText(assignment, 320) },
+                { timestamp, type: 'result', mode, text: summarizeText(result, 320) },
+            ]),
+            lastMode: mode,
+            lastTaskSummary: summarizeMessage(assignment),
+            lastUsedAt: timestamp,
+        }));
+    }
+    async getWrapperSystemContext(cwd, teamId, engineer) {
+        const team = await this.getOrCreateTeam(cwd, teamId);
+        const state = this.getEngineerState(team, engineer);
+        if (state.wrapperHistory.length === 0) {
+            return null;
+        }
+        const historyLines = state.wrapperHistory.map((entry) => {
+            const modeLabel = entry.mode ? ` [${entry.mode}]` : '';
+            return `- ${entry.type}${modeLabel}: ${entry.text}`;
+        });
+        return [
+            `Persistent wrapper memory for ${engineer} in CTO team ${teamId}:`,
+            'Use this only to improve delegation quality and continuity.',
+            'Prefer the current assignment when it conflicts with older context.',
+            ...historyLines,
+        ].join('\n');
+    }
+    async findTeamByWrapperSession(cwd, wrapperSessionId) {
+        const teams = await this.listTeams(cwd);
+        for (const team of teams) {
+            for (const engineer of team.engineers) {
+                if (engineer.wrapperSessionId === wrapperSessionId) {
+                    return {
+                        teamId: team.id,
+                        engineer: engineer.name,
+                    };
+                }
+            }
+        }
+        return null;
+    }
+    async dispatchEngineer(input) {
+        const team = await this.getOrCreateTeam(input.cwd, input.teamId);
+        const engineerState = this.getEngineerState(team, input.engineer);
+        await this.reserveEngineer(input.cwd, input.teamId, input.engineer);
+        try {
+            const tracker = new ContextTracker();
+            if (engineerState.context.sessionId) {
+                tracker.restore({
+                    sessionId: engineerState.context.sessionId,
+                    totalTurns: engineerState.context.totalTurns,
+                    totalCostUsd: engineerState.context.totalCostUsd,
+                    estimatedContextPercent: engineerState.context.estimatedContextPercent,
+                    contextWindowSize: engineerState.context.contextWindowSize,
+                    latestInputTokens: engineerState.context.latestInputTokens,
+                });
+            }
+            const result = await this.sessions.runTask({
+                cwd: input.cwd,
+                prompt: this.buildEngineerPrompt(input.mode, input.message),
+                systemPrompt: engineerState.claudeSessionId
+                    ? undefined
+                    : this.buildSessionSystemPrompt(input.engineer, input.mode),
+                resumeSessionId: engineerState.claudeSessionId ?? undefined,
+                persistSession: true,
+                includePartialMessages: true,
+                permissionMode: this.mapWorkModeToSessionMode(input.mode) === 'plan' ? 'plan' : 'acceptEdits',
+                model: input.model,
+                effort: input.mode === 'implement' ? 'high' : 'medium',
+                settingSources: ['user'],
+                abortSignal: input.abortSignal,
+            }, input.onEvent);
+            tracker.recordResult({
+                sessionId: result.sessionId,
+                turns: result.turns,
+                totalCostUsd: result.totalCostUsd,
+                inputTokens: result.inputTokens,
+                outputTokens: result.outputTokens,
+                contextWindowSize: result.contextWindowSize,
+            });
+            if (result.sessionId && result.events.length > 0) {
+                await this.transcriptStore.appendEvents(input.cwd, result.sessionId, result.events);
+            }
+            const context = tracker.snapshot();
+            await this.updateEngineer(input.cwd, input.teamId, input.engineer, (entry) => ({
+                ...entry,
+                claudeSessionId: result.sessionId ?? engineerState.claudeSessionId,
+                busy: false,
+                lastMode: input.mode,
+                lastTaskSummary: summarizeMessage(input.message),
+                lastUsedAt: new Date().toISOString(),
+                context,
+            }));
+            return {
+                teamId: input.teamId,
+                engineer: input.engineer,
+                mode: input.mode,
+                sessionId: result.sessionId,
+                finalText: result.finalText,
+                turns: result.turns,
+                totalCostUsd: result.totalCostUsd,
+                inputTokens: result.inputTokens,
+                outputTokens: result.outputTokens,
+                contextWindowSize: result.contextWindowSize,
+                context,
+            };
+        }
+        catch (error) {
+            await this.updateEngineer(input.cwd, input.teamId, input.engineer, (engineer) => ({
+                ...engineer,
+                busy: false,
+            }));
+            throw error;
+        }
+    }
+    async planWithTeam(input) {
+        if (input.leadEngineer === input.challengerEngineer) {
+            throw new Error('Choose two different engineers for plan synthesis.');
+        }
+        const [leadDraft, challengerDraft] = await Promise.all([
+            this.dispatchEngineer({
+                teamId: input.teamId,
+                cwd: input.cwd,
+                engineer: input.leadEngineer,
+                mode: 'explore',
+                message: buildPlanDraftRequest('lead', input.request),
+                model: input.model,
+                abortSignal: input.abortSignal,
+            }),
+            this.dispatchEngineer({
+                teamId: input.teamId,
+                cwd: input.cwd,
+                engineer: input.challengerEngineer,
+                mode: 'explore',
+                message: buildPlanDraftRequest('challenger', input.request),
+                model: input.model,
+                abortSignal: input.abortSignal,
+            }),
+        ]);
+        const drafts = [
+            { ...leadDraft, request: input.request },
+            { ...challengerDraft, request: input.request },
+        ];
+        const synthesisResult = await this.sessions.runTask({
+            cwd: input.cwd,
+            prompt: buildSynthesisPrompt(input.request, drafts),
+            systemPrompt: buildSynthesisSystemPrompt(),
+            persistSession: false,
+            includePartialMessages: false,
+            permissionMode: 'plan',
+            model: input.model,
+            effort: 'high',
+            settingSources: ['user'],
+            abortSignal: input.abortSignal,
+        });
+        const parsedSynthesis = parseSynthesisResult(synthesisResult.finalText);
+        return {
+            teamId: input.teamId,
+            request: input.request,
+            leadEngineer: input.leadEngineer,
+            challengerEngineer: input.challengerEngineer,
+            drafts,
+            synthesis: parsedSynthesis.synthesis,
+            recommendedQuestion: parsedSynthesis.recommendedQuestion,
+            recommendedAnswer: parsedSynthesis.recommendedAnswer,
+        };
+    }
+    async updateEngineer(cwd, teamId, engineerName, update) {
+        await this.getOrCreateTeam(cwd, teamId);
+        await this.teamStore.updateTeam(cwd, teamId, (team) => {
+            const normalized = this.normalizeTeamRecord(team);
+            const existing = this.getEngineerState(normalized, engineerName);
+            return {
+                ...normalized,
+                updatedAt: new Date().toISOString(),
+                engineers: normalized.engineers.map((engineer) => engineer.name === engineerName ? update(existing) : engineer),
+            };
+        });
+    }
+    async reserveEngineer(cwd, teamId, engineerName) {
+        await this.getOrCreateTeam(cwd, teamId);
+        await this.teamStore.updateTeam(cwd, teamId, (team) => {
+            const normalized = this.normalizeTeamRecord(team);
+            const engineer = this.getEngineerState(normalized, engineerName);
+            if (engineer.busy) {
+                throw new Error(`${engineerName} is already working on another assignment.`);
+            }
+            return {
+                ...normalized,
+                updatedAt: new Date().toISOString(),
+                engineers: normalized.engineers.map((entry) => entry.name === engineerName
+                    ? {
+                        ...entry,
+                        busy: true,
+                    }
+                    : entry),
+            };
+        });
+    }
+    getEngineerState(team, engineerName) {
+        return (team.engineers.find((engineer) => engineer.name === engineerName) ??
+            createEmptyEngineerRecord(engineerName));
+    }
+    normalizeTeamRecord(team) {
+        const engineerMap = new Map(team.engineers.map((engineer) => [engineer.name, engineer]));
+        return {
+            ...team,
+            engineers: createEmptyTeamRecord(team.id, team.cwd).engineers.map((engineer) => engineerMap.get(engineer.name) ?? engineer),
+        };
+    }
+    buildSessionSystemPrompt(engineer, mode) {
+        const claudeFileSection = this.projectClaudeFiles.length
+            ? `\n\nProject Claude Files:\n${this.projectClaudeFiles
+                .map((file) => `## ${file.relativePath}\n${file.content}`)
+                .join('\n\n')}`
+            : '';
+        return [
+            this.engineerSessionPrompt,
+            '',
+            `Assigned engineer: ${engineer}.`,
+            `Current work mode: ${mode}.`,
+            claudeFileSection,
+        ]
+            .join('\n')
+            .trim();
+    }
+    buildEngineerPrompt(mode, message) {
+        return `${buildModeInstruction(mode)}\n\n${message}`;
+    }
+    mapWorkModeToSessionMode(mode) {
+        return mode === 'explore' ? 'plan' : 'free';
+    }
+}
+function buildModeInstruction(mode) {
+    switch (mode) {
+        case 'explore':
+            return 'Work in planning mode. Investigate, reason, and write the plan inline. Do not make file edits.';
+        case 'implement':
+            return 'Work in implementation mode. Make the changes, verify them, and report clearly.';
+        case 'verify':
+            return 'Work in verification mode. Run the narrowest useful checks first, then broaden only if needed.';
+    }
+}
+function summarizeMessage(message) {
+    const compact = message.replace(/\s+/g, ' ').trim();
+    return compact.length > 120 ? `${compact.slice(0, 117)}...` : compact;
+}
+function summarizeText(text, limit) {
+    const compact = text.replace(/\s+/g, ' ').trim();
+    return compact.length > limit ? `${compact.slice(0, limit - 3)}...` : compact;
+}
+function appendWrapperHistoryEntries(existing, nextEntries) {
+    return [...existing, ...nextEntries].slice(-12);
+}
+function buildPlanDraftRequest(perspective, request) {
+    const posture = perspective === 'lead'
+        ? 'Propose the most direct workable plan.'
+        : 'Challenge weak assumptions, find missing decisions, and propose a stronger alternative if needed.';
+    return [
+        posture,
+        '',
+        'Return exactly these sections:',
+        '1. Objective',
+        '2. Proposed approach',
+        '3. Files or systems likely involved',
+        '4. Risks and open questions',
+        '5. Verification',
+        '6. Step-by-step plan',
+        '',
+        `User request: ${request}`,
+    ].join('\n');
+}
+function buildSynthesisSystemPrompt() {
+    return [
+        'You are the CTO synthesis engine.',
+        'Combine two independent engineering plans into one better plan.',
+        'Prefer the clearest, simplest, highest-leverage path.',
+        'If one user decision is still required, surface exactly one recommended question and one recommended answer.',
+        'Use this output format exactly:',
+        '## Synthesis',
+        '<combined plan>',
+        '## Recommended Question',
+        '<question or NONE>',
+        '## Recommended Answer',
+        '<answer or NONE>',
+    ].join('\n');
+}
+function buildSynthesisPrompt(request, drafts) {
+    return [
+        `User request: ${request}`,
+        '',
+        `Lead engineer (${drafts[0].engineer}) draft:`,
+        drafts[0].finalText,
+        '',
+        `Challenger engineer (${drafts[1].engineer}) draft:`,
+        drafts[1].finalText,
+    ].join('\n');
+}
+function parseSynthesisResult(text) {
+    const synthesis = extractSection(text, 'Synthesis') ?? text.trim();
+    const recommendedQuestion = normalizeOptionalSection(extractSection(text, 'Recommended Question'));
+    const recommendedAnswer = normalizeOptionalSection(extractSection(text, 'Recommended Answer'));
+    return {
+        synthesis,
+        recommendedQuestion,
+        recommendedAnswer,
+    };
+}
+function extractSection(text, heading) {
+    const regex = new RegExp(`## ${escapeRegExp(heading)}\\n([\\s\\S]*?)(?=\\n## |$)`);
+    const match = text.match(regex);
+    return match?.[1]?.trim() ?? null;
+}
+function normalizeOptionalSection(value) {
+    if (!value) {
+        return null;
+    }
+    return value.toUpperCase() === 'NONE' ? null : value;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

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

@@ -1,18 +1,14 @@
-/**
- * Agent hierarchy configuration for the CTO + Engineer Wrapper architecture.
- *
- * CTO (cto)                            — pure orchestrator, spawns engineers, reviews diffs, commits
- * Engineer Explore (engineer_explore)   — manages a Claude Code session for read-only investigation
- * Engineer Implement (engineer_implement) — manages a Claude Code session for implementation
- * Claude Code session                   — the underlying AI session (prompt only, no OpenCode agent)
- */
-import type { ManagerPromptRegistry } from '../types/contracts.js';
+import type { EngineerName, ManagerPromptRegistry } from '../types/contracts.js';
 export declare const AGENT_CTO = "cto";
-export declare const AGENT_ENGINEER_EXPLORE = "engineer_explore";
-export declare const AGENT_ENGINEER_IMPLEMENT = "engineer_implement";
-export declare const AGENT_ENGINEER_VERIFY = "engineer_verify";
-/** All restricted tool IDs (union of all domain groups) */
-export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["explore", "implement", "verify", "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"];
+export declare const ENGINEER_AGENT_IDS: {
+    readonly Tom: "tom";
+    readonly John: "john";
+    readonly Maya: "maya";
+    readonly Sara: "sara";
+    readonly Alex: "alex";
+};
+export declare const ENGINEER_AGENT_NAMES: readonly ["Tom", "John", "Maya", "Sara", "Alex"];
+export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["team_status", "list_transcripts", "list_history", "git_diff", "git_commit", "git_reset", "git_status", "git_log", "approval_policy", "approval_decisions", "approval_update", "claude"];
 type ToolPermission = 'allow' | 'ask' | 'deny';
 type AgentPermission = {
     '*'?: ToolPermission;
@@ -24,13 +20,9 @@ type AgentPermission = {
     webfetch?: ToolPermission;
     websearch?: ToolPermission;
     lsp?: ToolPermission;
-    /** OpenCode built-in: manage session todo list */
     todowrite?: ToolPermission;
-    /** OpenCode built-in: read session todo list */
     todoread?: ToolPermission;
-    /** OpenCode built-in: ask the user structured questions with options */
     question?: ToolPermission;
-    /** OpenCode built-in: launch subagents (matches subagent type, last-match-wins) */
     task?: ToolPermission | Record<string, ToolPermission>;
     bash?: ToolPermission | Record<string, ToolPermission>;
     [tool: string]: ToolPermission | Record<string, ToolPermission> | undefined;
@@ -42,27 +34,13 @@ export declare function buildCtoAgentConfig(prompts: ManagerPromptRegistry): {
     permission: AgentPermission;
     prompt: string;
 };
-export declare function buildEngineerExploreAgentConfig(prompts: ManagerPromptRegistry): {
-    description: string;
-    mode: "subagent";
-    color: string;
-    permission: AgentPermission;
-    prompt: string;
-};
-export declare function buildEngineerImplementAgentConfig(prompts: ManagerPromptRegistry): {
-    description: string;
-    mode: "subagent";
-    color: string;
-    permission: AgentPermission;
-    prompt: string;
-};
-export declare function buildEngineerVerifyAgentConfig(prompts: ManagerPromptRegistry): {
+export declare function buildEngineerAgentConfig(prompts: ManagerPromptRegistry, engineer: EngineerName): {
     description: string;
     mode: "subagent";
+    hidden: boolean;
     color: string;
     permission: AgentPermission;
     prompt: string;
 };
-/** Deny all restricted tools at the global level so only designated agents can use them. */
 export declare function denyRestrictedToolsGlobally(permissions: Record<string, ToolPermission>): void;
 export {};