@doingdev/opencode-claude-manager-plugin 0.1.0 → 0.1.4

package/README.md

@@ -56,6 +56,16 @@ If you are testing locally, point OpenCode at the local package or plugin file u
 - `claude_manager_runs` - inspect persisted manager run records
 - `claude_manager_cleanup_run` - explicitly remove worktrees created for a prior manager run
 
+## Plugin-provided agents and commands
+
+When the plugin loads successfully, it also injects config entries through the OpenCode plugin `config` hook.
+
+- Primary agent: `claude-manager`
+- Subagent: `claude-manager-research`
+- Commands: `/claude-metadata`, `/claude-run`, `/claude-sessions`
+
+These are added to OpenCode config at runtime by the plugin, so they do not require separate manual `opencode.json` entries.
+
 ## Quick Start
 
 Typical flow inside OpenCode:
@@ -88,6 +98,24 @@ The compiled plugin output is written to `dist/`.
 
 This package is configured for the npm scope `@doingdev`.
 
+This repository uses npm trusted publishing with GitHub Actions OIDC, so you do not need an `NPM_TOKEN` secret once npm is configured correctly.
+
+Before the first automated publish, configure npm trusted publishing for `@doingdev/opencode-claude-manager-plugin` on npmjs.com:
+
+1. Open the package settings on npmjs.com.
+2. Go to the `Trusted Publisher` section.
+3. Choose `GitHub Actions`.
+4. Set the GitHub owner/user to your account or org.
+5. Set the repository name.
+6. Set the workflow filename to `publish.yml`.
+7. Leave the environment name empty unless you later add a GitHub Actions environment back to the workflow.
+
+Notes for trusted publishing:
+
+- npm trusted publishing requires GitHub-hosted runners.
+- npm recommends Node `22.14.0+` with npm CLI `11.5.1+`; the workflows use Node `24`.
+- Provenance is generated automatically by npm for trusted publishes from public GitHub repositories.
+
 Release flow:
 
 ```bash
@@ -98,10 +126,14 @@ npm run lint
 npm run typecheck
 npm run test
 npm run build
-npm publish --access public
 ```
 
-You can also publish through the GitHub Actions workflow after creating a GitHub release and configuring the `NPM_TOKEN` secret.
+Then publish from GitHub by either:
+
+- creating a GitHub Release, or
+- running the `Publish` workflow manually from the Actions tab
+
+After trusted publishing is working, you can tighten npm package security by disabling token-based publishing for the package in npm settings.
 
 ## Limitations
 

package/dist/index.d.ts

@@ -1,13 +1,4 @@
 import type { Plugin } from '@opencode-ai/plugin';
-export { ClaudeAgentSdkAdapter } from './claude/claude-agent-sdk-adapter.js';
-export { ClaudeSessionService } from './claude/claude-session.service.js';
-export { ManagerOrchestrator } from './manager/manager-orchestrator.js';
-export { TaskPlanner } from './manager/task-planner.js';
-export { ClaudeMetadataService } from './metadata/claude-metadata.service.js';
-export { RepoClaudeConfigReader } from './metadata/repo-claude-config-reader.js';
-export { getOrCreatePluginServices } from './plugin/service-factory.js';
-export { FileRunStateStore } from './state/file-run-state-store.js';
-export { WorktreeCoordinator } from './worktree/worktree-coordinator.js';
 import { ClaudeManagerPlugin } from './plugin/claude-manager.plugin.js';
 export type { ClaudeCapabilitySnapshot, ClaudeMetadataSnapshot, ClaudeSessionRunResult, ClaudeSessionSummary, ClaudeSessionTranscriptMessage, ManagerRunRecord, ManagerRunResult, ManagerTaskRequest, ManagerPromptRegistry, RunClaudeSessionInput, } from './types/contracts.js';
 export { ClaudeManagerPlugin };

package/dist/index.js

@@ -1,12 +1,3 @@
-export { ClaudeAgentSdkAdapter } from './claude/claude-agent-sdk-adapter.js';
-export { ClaudeSessionService } from './claude/claude-session.service.js';
-export { ManagerOrchestrator } from './manager/manager-orchestrator.js';
-export { TaskPlanner } from './manager/task-planner.js';
-export { ClaudeMetadataService } from './metadata/claude-metadata.service.js';
-export { RepoClaudeConfigReader } from './metadata/repo-claude-config-reader.js';
-export { getOrCreatePluginServices } from './plugin/service-factory.js';
-export { FileRunStateStore } from './state/file-run-state-store.js';
-export { WorktreeCoordinator } from './worktree/worktree-coordinator.js';
 import { ClaudeManagerPlugin } from './plugin/claude-manager.plugin.js';
 export { ClaudeManagerPlugin };
 export const plugin = ClaudeManagerPlugin;

package/dist/plugin/claude-manager.plugin.js

@@ -1,8 +1,90 @@
 import { tool } from '@opencode-ai/plugin';
+import { managerPromptRegistry } from '../prompts/registry.js';
 import { getOrCreatePluginServices } from './service-factory.js';
+const MANAGER_TOOL_IDS = [
+    'claude_manager_run',
+    'claude_manager_metadata',
+    'claude_manager_sessions',
+    'claude_manager_runs',
+    'claude_manager_cleanup_run',
+];
 export const ClaudeManagerPlugin = async ({ worktree }) => {
     const services = getOrCreatePluginServices(worktree);
     return {
+        config: async (config) => {
+            config.agent ??= {};
+            config.command ??= {};
+            config.permission ??= {};
+            const globalPermissions = config.permission;
+            const managerPermissions = {
+                claude_manager_run: 'allow',
+                claude_manager_metadata: 'allow',
+                claude_manager_sessions: 'allow',
+                claude_manager_runs: 'allow',
+                claude_manager_cleanup_run: 'allow',
+            };
+            const researchPermissions = {
+                claude_manager_run: 'deny',
+                claude_manager_metadata: 'allow',
+                claude_manager_sessions: 'allow',
+                claude_manager_runs: 'allow',
+                claude_manager_cleanup_run: 'deny',
+            };
+            for (const toolId of MANAGER_TOOL_IDS) {
+                globalPermissions[toolId] ??= 'deny';
+            }
+            config.agent['claude-manager'] ??= {
+                description: 'Primary agent that manages Claude Code sessions through the bundled plugin tools.',
+                mode: 'primary',
+                color: 'accent',
+                permission: managerPermissions,
+                prompt: [
+                    managerPromptRegistry.managerSystemPrompt,
+                    'When Claude Code delegation is useful, prefer the claude_manager_run tool instead of simulating the work yourself.',
+                    'Use claude_manager_metadata to inspect available Claude commands, skills, and hooks before making assumptions.',
+                    'Use claude_manager_sessions and claude_manager_runs to inspect prior work before starting a new Claude session.',
+                ].join(' '),
+            };
+            config.agent['claude-manager-research'] ??= {
+                description: 'Subagent that inspects Claude metadata, prior sessions, and manager runs without changing repository state.',
+                mode: 'subagent',
+                color: 'info',
+                permission: researchPermissions,
+                prompt: [
+                    managerPromptRegistry.subagentSystemPrompt,
+                    'Focus on inspection and summarization.',
+                    'Prefer claude_manager_metadata, claude_manager_sessions, and claude_manager_runs over guesswork.',
+                ].join(' '),
+            };
+            config.command['claude-metadata'] ??= {
+                description: 'Inspect bundled Claude commands, skills, hooks, and agents.',
+                agent: 'claude-manager-research',
+                subtask: true,
+                template: [
+                    'Use claude_manager_metadata to inspect the current repository.',
+                    'Summarize Claude commands, skills, hooks, discovered agents, and important config files.',
+                ].join(' '),
+            };
+            config.command['claude-run'] ??= {
+                description: 'Delegate a task to Claude Code through the manager plugin.',
+                agent: 'claude-manager',
+                template: [
+                    'Use claude_manager_run to delegate the following task to Claude Code:',
+                    '$ARGUMENTS',
+                    'Default to worktrees for multi-part work and return a concise result summary.',
+                ].join('\n\n'),
+            };
+            config.command['claude-sessions'] ??= {
+                description: 'Inspect Claude session history and manager run records.',
+                agent: 'claude-manager-research',
+                subtask: true,
+                template: [
+                    'Use claude_manager_sessions and claude_manager_runs to inspect recent Claude activity for this repository.',
+                    'If the user provided extra arguments, use them to focus the inspection:',
+                    '$ARGUMENTS',
+                ].join('\n\n'),
+            };
+        },
         tool: {
             claude_manager_run: tool({
                 description: 'Delegate a task to Claude Code with optional subagents and worktrees.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doingdev/opencode-claude-manager-plugin",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "description": "OpenCode plugin that orchestrates Claude Code sessions.",
   "keywords": [
     "opencode",