@doingdev/opencode-claude-manager-plugin 0.1.57 → 0.1.59

package/dist/src/plugin/agent-hierarchy.js

@@ -1,123 +1,2 @@
-import { TEAM_ENGINEERS } from '../team/roster.js';
-export const AGENT_CTO = 'cto';
-export const AGENT_TEAM_PLANNER = 'team-planner';
-export const ENGINEER_AGENT_IDS = {
-    Tom: 'tom',
-    John: 'john',
-    Maya: 'maya',
-    Sara: 'sara',
-    Alex: 'alex',
-};
-export const ENGINEER_AGENT_NAMES = TEAM_ENGINEERS;
-const CTO_ONLY_TOOL_IDS = [
-    'team_status',
-    'reset_engineer',
-    'list_transcripts',
-    'list_history',
-    'git_diff',
-    'git_commit',
-    'git_reset',
-    'git_status',
-    'git_log',
-    'approval_policy',
-    'approval_decisions',
-    'approval_update',
-];
-const ENGINEER_TOOL_IDS = ['claude'];
-const ALL_RESTRICTED_TOOL_IDS = [...CTO_ONLY_TOOL_IDS, ...ENGINEER_TOOL_IDS];
-const CTO_READONLY_TOOLS = {
-    read: 'allow',
-    grep: 'allow',
-    glob: 'allow',
-    list: 'allow',
-    codesearch: 'allow',
-    webfetch: 'allow',
-    websearch: 'allow',
-    lsp: 'allow',
-    todowrite: 'allow',
-    todoread: 'allow',
-    question: 'allow',
-};
-function buildTeamPlannerPermissions() {
-    const denied = {};
-    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
-        denied[toolId] = 'deny';
-    }
-    return {
-        '*': 'deny',
-        plan_with_team: 'allow',
-        question: 'allow',
-        ...denied,
-    };
-}
-function buildCtoPermissions() {
-    const denied = {};
-    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
-        denied[toolId] = 'deny';
-    }
-    const allowed = {};
-    for (const toolId of CTO_ONLY_TOOL_IDS) {
-        allowed[toolId] = 'allow';
-    }
-    const taskPermissions = { '*': 'deny' };
-    for (const engineer of ENGINEER_AGENT_NAMES) {
-        const agentId = ENGINEER_AGENT_IDS[engineer];
-        // Support both uppercase (user-friendly) and lowercase (canonical) agent IDs.
-        // This ensures both task({ subagent_type: 'Tom' }) and task({ subagent_type: 'tom' }) work.
-        taskPermissions[engineer] = 'allow'; // 'Tom', 'John', etc.
-        taskPermissions[agentId] = 'allow'; // 'tom', 'john', etc.
-    }
-    taskPermissions[AGENT_TEAM_PLANNER] = 'allow';
-    return {
-        '*': 'deny',
-        ...CTO_READONLY_TOOLS,
-        ...denied,
-        ...allowed,
-        task: taskPermissions,
-    };
-}
-function buildEngineerPermissions() {
-    const denied = {};
-    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
-        denied[toolId] = 'deny';
-    }
-    return {
-        '*': 'deny',
-        ...denied,
-        claude: 'allow',
-    };
-}
-export function buildCtoAgentConfig(prompts) {
-    return {
-        description: 'Principal engineer who orchestrates AI-powered engineers. Decomposes work, asks clarifying questions, delegates precisely, reviews diffs, and owns the outcome.',
-        mode: 'primary',
-        color: '#D97757',
-        permission: buildCtoPermissions(),
-        prompt: prompts.ctoSystemPrompt,
-    };
-}
-export function buildEngineerAgentConfig(prompts, engineer) {
-    return {
-        description: `${engineer} is a persistent engineer who works through one Claude Code session and remembers prior turns. Receives structured assignments (goal, mode, context, acceptance criteria, relevant paths, constraints, verification).`,
-        mode: 'subagent',
-        hidden: false,
-        color: '#D97757',
-        permission: buildEngineerPermissions(),
-        prompt: `You are ${engineer}.\n\n${prompts.engineerAgentPrompt}`,
-    };
-}
-export function buildTeamPlannerAgentConfig(prompts) {
-    return {
-        description: 'Runs dual-engineer planning by calling plan_with_team. Automatically selects two non-overlapping available engineers if engineer names are not provided.',
-        mode: 'subagent',
-        hidden: false,
-        color: '#D97757',
-        permission: buildTeamPlannerPermissions(),
-        prompt: prompts.teamPlannerPrompt,
-    };
-}
-export function denyRestrictedToolsGlobally(permissions) {
-    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
-        permissions[toolId] ??= 'deny';
-    }
-}
+// Re-export barrel — all symbols now live in src/plugin/agents/.
+export * from './agents/index.js';

package/dist/src/plugin/agents/browser-qa.d.ts

@@ -0,0 +1,14 @@
+import type { EngineerName, ManagerPromptRegistry, WorkerCapabilities } from '../../types/contracts.js';
+/**
+ * Build the worker capabilities map for all specialist workers.
+ * Called once at service-factory construction time to avoid re-building on each tool call.
+ */
+export declare function buildWorkerCapabilities(prompts: ManagerPromptRegistry): Partial<Record<EngineerName, WorkerCapabilities>>;
+export declare function buildBrowserQaAgentConfig(prompts: ManagerPromptRegistry): {
+    description: string;
+    mode: "subagent";
+    hidden: boolean;
+    color: string;
+    permission: import("./common.js").AgentPermission;
+    prompt: string;
+};

package/dist/src/plugin/agents/browser-qa.js

@@ -0,0 +1,27 @@
+import { buildEngineerPermissions } from './common.js';
+/**
+ * Build the worker capabilities map for all specialist workers.
+ * Called once at service-factory construction time to avoid re-building on each tool call.
+ */
+export function buildWorkerCapabilities(prompts) {
+    return {
+        BrowserQA: {
+            sessionPrompt: prompts.browserQaSessionPrompt,
+            restrictWriteTools: true,
+            skipModeInstructions: true,
+            plannerEligible: false,
+            isRuntimeUnavailableResponse: (text) => text.trimStart().startsWith('PLAYWRIGHT_UNAVAILABLE:'),
+            runtimeUnavailableTitle: '❌ Playwright unavailable',
+        },
+    };
+}
+export function buildBrowserQaAgentConfig(prompts) {
+    return {
+        description: 'Browser QA specialist who uses the Playwright skill/command to test web features and user flows. Maintains a persistent Claude Code session that remembers prior verification runs.',
+        mode: 'subagent',
+        hidden: false,
+        color: '#D97757',
+        permission: buildEngineerPermissions(), // Same permissions as engineers (claude tool only)
+        prompt: prompts.browserQaAgentPrompt,
+    };
+}

package/dist/src/plugin/agents/common.d.ts

@@ -0,0 +1,37 @@
+export declare const AGENT_CTO = "cto";
+export declare const AGENT_TEAM_PLANNER = "team-planner";
+export declare const AGENT_BROWSER_QA = "browser-qa";
+export declare const ENGINEER_AGENT_IDS: {
+    readonly Tom: "tom";
+    readonly John: "john";
+    readonly Maya: "maya";
+    readonly Sara: "sara";
+    readonly Alex: "alex";
+    readonly BrowserQA: "browser-qa";
+};
+/** General named engineers only (Tom/John/Maya/Sara/Alex). BrowserQA is a specialist registered separately. */
+export declare const ENGINEER_AGENT_NAMES: readonly ["Tom", "John", "Maya", "Sara", "Alex"];
+export declare const CTO_ONLY_TOOL_IDS: readonly ["team_status", "reset_engineer", "list_transcripts", "list_history", "git_diff", "git_commit", "git_reset", "git_status", "git_log", "approval_policy", "approval_decisions", "approval_update"];
+export declare const ENGINEER_TOOL_IDS: readonly ["claude"];
+export declare const ALL_RESTRICTED_TOOL_IDS: readonly ["team_status", "reset_engineer", "list_transcripts", "list_history", "git_diff", "git_commit", "git_reset", "git_status", "git_log", "approval_policy", "approval_decisions", "approval_update", "claude"];
+export type ToolPermission = 'allow' | 'ask' | 'deny';
+export type AgentPermission = {
+    '*'?: ToolPermission;
+    read?: ToolPermission;
+    grep?: ToolPermission;
+    glob?: ToolPermission;
+    list?: ToolPermission;
+    codesearch?: ToolPermission;
+    webfetch?: ToolPermission;
+    websearch?: ToolPermission;
+    lsp?: ToolPermission;
+    todowrite?: ToolPermission;
+    todoread?: ToolPermission;
+    question?: ToolPermission;
+    task?: ToolPermission | Record<string, ToolPermission>;
+    bash?: ToolPermission | Record<string, ToolPermission>;
+    [tool: string]: ToolPermission | Record<string, ToolPermission> | undefined;
+};
+export declare const CTO_READONLY_TOOLS: Record<string, ToolPermission>;
+export declare function buildEngineerPermissions(): AgentPermission;
+export declare function denyRestrictedToolsGlobally(permissions: Record<string, ToolPermission>): void;

package/dist/src/plugin/agents/common.js

@@ -0,0 +1,59 @@
+import { PLANNER_ELIGIBLE_ENGINEERS } from '../../team/roster.js';
+export const AGENT_CTO = 'cto';
+export const AGENT_TEAM_PLANNER = 'team-planner';
+export const AGENT_BROWSER_QA = 'browser-qa';
+export const ENGINEER_AGENT_IDS = {
+    Tom: 'tom',
+    John: 'john',
+    Maya: 'maya',
+    Sara: 'sara',
+    Alex: 'alex',
+    BrowserQA: 'browser-qa',
+};
+/** General named engineers only (Tom/John/Maya/Sara/Alex). BrowserQA is a specialist registered separately. */
+export const ENGINEER_AGENT_NAMES = PLANNER_ELIGIBLE_ENGINEERS;
+export const CTO_ONLY_TOOL_IDS = [
+    'team_status',
+    'reset_engineer',
+    'list_transcripts',
+    'list_history',
+    'git_diff',
+    'git_commit',
+    'git_reset',
+    'git_status',
+    'git_log',
+    'approval_policy',
+    'approval_decisions',
+    'approval_update',
+];
+export const ENGINEER_TOOL_IDS = ['claude'];
+export const ALL_RESTRICTED_TOOL_IDS = [...CTO_ONLY_TOOL_IDS, ...ENGINEER_TOOL_IDS];
+export const CTO_READONLY_TOOLS = {
+    read: 'allow',
+    grep: 'allow',
+    glob: 'allow',
+    list: 'allow',
+    codesearch: 'allow',
+    webfetch: 'allow',
+    websearch: 'allow',
+    lsp: 'allow',
+    todowrite: 'allow',
+    todoread: 'allow',
+    question: 'allow',
+};
+export function buildEngineerPermissions() {
+    const denied = {};
+    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
+        denied[toolId] = 'deny';
+    }
+    return {
+        '*': 'deny',
+        ...denied,
+        claude: 'allow',
+    };
+}
+export function denyRestrictedToolsGlobally(permissions) {
+    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
+        permissions[toolId] ??= 'deny';
+    }
+}

package/dist/src/plugin/agents/cto.d.ts

@@ -0,0 +1,9 @@
+import type { ManagerPromptRegistry } from '../../types/contracts.js';
+import type { AgentPermission } from './common.js';
+export declare function buildCtoAgentConfig(prompts: ManagerPromptRegistry): {
+    description: string;
+    mode: "primary";
+    color: string;
+    permission: AgentPermission;
+    prompt: string;
+};

package/dist/src/plugin/agents/cto.js

@@ -0,0 +1,39 @@
+import { AGENT_BROWSER_QA, AGENT_TEAM_PLANNER, ALL_RESTRICTED_TOOL_IDS, CTO_ONLY_TOOL_IDS, CTO_READONLY_TOOLS, ENGINEER_AGENT_IDS, ENGINEER_AGENT_NAMES, } from './common.js';
+function buildCtoPermissions() {
+    const denied = {};
+    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
+        denied[toolId] = 'deny';
+    }
+    const allowed = {};
+    for (const toolId of CTO_ONLY_TOOL_IDS) {
+        allowed[toolId] = 'allow';
+    }
+    const taskPermissions = { '*': 'deny' };
+    for (const engineer of ENGINEER_AGENT_NAMES) {
+        const agentId = ENGINEER_AGENT_IDS[engineer];
+        // Support both uppercase (user-friendly) and lowercase (canonical) agent IDs.
+        // This ensures both task({ subagent_type: 'Tom' }) and task({ subagent_type: 'tom' }) work.
+        taskPermissions[engineer] = 'allow'; // 'Tom', 'John', etc.
+        taskPermissions[agentId] = 'allow'; // 'tom', 'john', etc.
+    }
+    // BrowserQA is a specialist registered separately from ENGINEER_AGENT_NAMES; add both forms.
+    taskPermissions['BrowserQA'] = 'allow'; // uppercase (user-friendly)
+    taskPermissions[AGENT_BROWSER_QA] = 'allow'; // 'browser-qa' canonical
+    taskPermissions[AGENT_TEAM_PLANNER] = 'allow';
+    return {
+        '*': 'deny',
+        ...CTO_READONLY_TOOLS,
+        ...denied,
+        ...allowed,
+        task: taskPermissions,
+    };
+}
+export function buildCtoAgentConfig(prompts) {
+    return {
+        description: 'Principal engineer who orchestrates AI-powered engineers. Decomposes work, asks clarifying questions, delegates precisely, reviews diffs, and owns the outcome.',
+        mode: 'primary',
+        color: '#D97757',
+        permission: buildCtoPermissions(),
+        prompt: prompts.ctoSystemPrompt,
+    };
+}

package/dist/src/plugin/agents/engineers.d.ts

@@ -0,0 +1,9 @@
+import type { EngineerName, ManagerPromptRegistry } from '../../types/contracts.js';
+export declare function buildEngineerAgentConfig(prompts: ManagerPromptRegistry, engineer: EngineerName): {
+    description: string;
+    mode: "subagent";
+    hidden: boolean;
+    color: string;
+    permission: import("./common.js").AgentPermission;
+    prompt: string;
+};

package/dist/src/plugin/agents/engineers.js

@@ -0,0 +1,11 @@
+import { buildEngineerPermissions } from './common.js';
+export function buildEngineerAgentConfig(prompts, engineer) {
+    return {
+        description: `${engineer} is a persistent engineer who works through one Claude Code session and remembers prior turns. Receives structured assignments (goal, mode, context, acceptance criteria, relevant paths, constraints, verification).`,
+        mode: 'subagent',
+        hidden: false,
+        color: '#D97757',
+        permission: buildEngineerPermissions(),
+        prompt: `You are ${engineer}.\n\n${prompts.engineerAgentPrompt}`,
+    };
+}

package/dist/src/plugin/agents/index.d.ts

@@ -0,0 +1,6 @@
+export { AGENT_BROWSER_QA, AGENT_CTO, AGENT_TEAM_PLANNER, ALL_RESTRICTED_TOOL_IDS, buildEngineerPermissions, CTO_ONLY_TOOL_IDS, CTO_READONLY_TOOLS, denyRestrictedToolsGlobally, ENGINEER_AGENT_IDS, ENGINEER_AGENT_NAMES, ENGINEER_TOOL_IDS, } from './common.js';
+export type { AgentPermission, ToolPermission } from './common.js';
+export { buildCtoAgentConfig } from './cto.js';
+export { buildTeamPlannerAgentConfig } from './team-planner.js';
+export { buildEngineerAgentConfig } from './engineers.js';
+export { buildBrowserQaAgentConfig, buildWorkerCapabilities } from './browser-qa.js';

package/dist/src/plugin/agents/index.js

@@ -0,0 +1,5 @@
+export { AGENT_BROWSER_QA, AGENT_CTO, AGENT_TEAM_PLANNER, ALL_RESTRICTED_TOOL_IDS, buildEngineerPermissions, CTO_ONLY_TOOL_IDS, CTO_READONLY_TOOLS, denyRestrictedToolsGlobally, ENGINEER_AGENT_IDS, ENGINEER_AGENT_NAMES, ENGINEER_TOOL_IDS, } from './common.js';
+export { buildCtoAgentConfig } from './cto.js';
+export { buildTeamPlannerAgentConfig } from './team-planner.js';
+export { buildEngineerAgentConfig } from './engineers.js';
+export { buildBrowserQaAgentConfig, buildWorkerCapabilities } from './browser-qa.js';

package/dist/src/plugin/agents/team-planner.d.ts

@@ -0,0 +1,10 @@
+import type { ManagerPromptRegistry } from '../../types/contracts.js';
+import type { AgentPermission } from './common.js';
+export declare function buildTeamPlannerAgentConfig(prompts: ManagerPromptRegistry): {
+    description: string;
+    mode: "subagent";
+    hidden: boolean;
+    color: string;
+    permission: AgentPermission;
+    prompt: string;
+};

package/dist/src/plugin/agents/team-planner.js

@@ -0,0 +1,23 @@
+import { ALL_RESTRICTED_TOOL_IDS } from './common.js';
+function buildTeamPlannerPermissions() {
+    const denied = {};
+    for (const toolId of ALL_RESTRICTED_TOOL_IDS) {
+        denied[toolId] = 'deny';
+    }
+    return {
+        '*': 'deny',
+        plan_with_team: 'allow',
+        question: 'allow',
+        ...denied,
+    };
+}
+export function buildTeamPlannerAgentConfig(prompts) {
+    return {
+        description: 'Runs dual-engineer planning by calling plan_with_team. Automatically selects two non-overlapping available engineers if engineer names are not provided.',
+        mode: 'subagent',
+        hidden: false,
+        color: '#D97757',
+        permission: buildTeamPlannerPermissions(),
+        prompt: prompts.teamPlannerPrompt,
+    };
+}