@codemcp/workflows 6.4.0 → 6.5.0

package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { ProceedToPhaseHandler, } from '@codemcp/workflows-server';
+import { tool } from './tool-helper.js';
+import { handleMcpError, unwrapResult } from '../server-context.js';
+import { createLogger } from '@codemcp/workflows-core';
+import { stripWhatsNextReferences } from '../utils.js';
+export function createProceedToPhaseTool(getServerContext, setBufferedInstructions) {
+    return tool({
+        description: 'Move to a development phase. Args: target_phase (from plan file), reason (optional), review_state (not-required|pending|performed)',
+        args: {
+            target_phase: z.string().describe('Phase name from plan file'),
+            reason: z.string().optional().describe('Why transitioning now'),
+            review_state: z
+                .enum(['not-required', 'pending', 'performed'])
+                .optional()
+                .describe('Review state'),
+        },
+        execute: async (args) => {
+            const { target_phase, reason, review_state } = args;
+            const serverContext = await getServerContext();
+            const logger = serverContext.loggerFactory
+                ? serverContext.loggerFactory('proceed_to_phase')
+                : createLogger('proceed_to_phase');
+            logger.debug('proceed_to_phase called', { to: target_phase, reason });
+            try {
+                // Delegate to ProceedToPhaseHandler
+                const handler = new ProceedToPhaseHandler();
+                const result = await handler.handle({
+                    target_phase,
+                    reason,
+                    review_state: review_state ?? 'not-required',
+                }, serverContext);
+                // Handle errors gracefully
+                const errorMsg = handleMcpError(result);
+                if (errorMsg) {
+                    return errorMsg;
+                }
+                const data = unwrapResult(result);
+                // Buffer instructions so the next chat.message hook uses them
+                // instead of re-querying WhatsNextHandler (which may read stale disk state)
+                setBufferedInstructions({
+                    phase: data.phase,
+                    instructions: data.instructions,
+                    plan_file_path: data.plan_file_path,
+                    allowed_file_patterns: data.allowed_file_patterns,
+                });
+                // Build response with instructions (strip whats_next references)
+                const lines = [];
+                lines.push(`Transitioned to: ${data.phase}`);
+                if (data.transition_reason) {
+                    lines.push(`Reason: ${data.transition_reason}`);
+                }
+                if (data.instructions) {
+                    lines.push('');
+                    lines.push(stripWhatsNextReferences(data.instructions));
+                }
+                // File restrictions
+                const patterns = data.allowed_file_patterns;
+                if (patterns.includes('*') || patterns.includes('**/*')) {
+                    lines.push('Files: All allowed');
+                }
+                else {
+                    lines.push(`Allowed: ${patterns.join(', ')}`);
+                }
+                return lines.join('\n');
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return `Error: ${errorMessage}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=proceed-to-phase.js.map

package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proceed-to-phase.js","sourceRoot":"","sources":["../../src/tool-handlers/proceed-to-phase.ts"],"names":[],"mappings":"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"}

package/packages/opencode-plugin/dist/tool-handlers/reset-development.d.ts

@@ -0,0 +1,3 @@
+import { type ServerContext } from '@codemcp/workflows-server';
+import type { ToolDefinition } from '../types.js';
+export declare function createResetDevelopmentTool(projectDir: string, getServerContext: () => Promise<ServerContext>): ToolDefinition;

package/packages/opencode-plugin/dist/tool-handlers/reset-development.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import * as path from 'node:path';
+import { ResetDevelopmentHandler, } from '@codemcp/workflows-server';
+import { FileStorage, ConversationManager, WorkflowManager, createLogger, } from '@codemcp/workflows-core';
+import { tool } from './tool-helper.js';
+import { handleMcpError } from '../server-context.js';
+export function createResetDevelopmentTool(projectDir, getServerContext) {
+    return tool({
+        description: 'Reset workflow state. Args: confirm (required: true), reason (optional), delete_plan (optional: also delete plan file)',
+        args: {
+            confirm: z.boolean().describe('Must be true'),
+            reason: z.string().optional().describe('Reason for reset'),
+            delete_plan: z.boolean().optional().describe('Also delete plan file'),
+        },
+        execute: async (args) => {
+            const { confirm, reason, delete_plan } = args;
+            const serverContext = await getServerContext();
+            const logger = serverContext.loggerFactory
+                ? serverContext.loggerFactory('reset_development')
+                : createLogger('reset_development');
+            logger.debug('reset_development called', { confirm, delete_plan });
+            if (!confirm) {
+                return `Reset requires confirm: true. Will delete conversation state${delete_plan ? ' and plan file' : ''}.`;
+            }
+            try {
+                if (delete_plan) {
+                    // Full reset: delegate to ResetDevelopmentHandler
+                    const handler = new ResetDevelopmentHandler();
+                    const result = await handler.handle({ confirm, reason }, serverContext);
+                    const errorMsg = handleMcpError(result);
+                    if (errorMsg) {
+                        return errorMsg;
+                    }
+                    const deleted = result.data?.resetItems?.join(', ') || 'workflow state';
+                    return `Reset complete. Deleted: ${deleted}. Use \`start_workflow\` to begin.`;
+                }
+                else {
+                    // Partial reset: delete conversation state only, preserve plan file
+                    const storageDir = path.join(projectDir, '.vibe', 'storage');
+                    const fileStorage = new FileStorage(storageDir);
+                    await fileStorage.initialize();
+                    const conversationManager = new ConversationManager(fileStorage, new WorkflowManager(), projectDir);
+                    let context;
+                    try {
+                        context = await conversationManager.getConversationContext();
+                    }
+                    catch (_err) {
+                        return 'No active workflow. Use `start_workflow` to begin.';
+                    }
+                    if (context) {
+                        await conversationManager.cleanupConversationData(context.conversationId);
+                    }
+                    return `Reset complete. Use \`start_workflow\` to begin.`;
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return `Error: ${errorMessage}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=reset-development.js.map

package/packages/opencode-plugin/dist/tool-handlers/reset-development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-development.js","sourceRoot":"","sources":["../../src/tool-handlers/reset-development.ts"],"names":[],"mappings":"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"}

package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.d.ts

@@ -0,0 +1,3 @@
+import { type ServerContext } from '@codemcp/workflows-server';
+import type { ToolDefinition } from '../types.js';
+export declare function createSetupProjectDocsTool(projectDir: string, getServerContext: () => Promise<ServerContext>): Promise<ToolDefinition>;

package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { SetupProjectDocsHandler, } from '@codemcp/workflows-server';
+import { tool } from './tool-helper.js';
+import { handleMcpError, unwrapResult } from '../server-context.js';
+import { createLogger, TemplateManager } from '@codemcp/workflows-core';
+export async function createSetupProjectDocsTool(projectDir, getServerContext) {
+    // Get available templates for description
+    const templateManager = new TemplateManager();
+    const availableTemplates = await templateManager.getAvailableTemplates();
+    const archOptions = availableTemplates.architecture.join(', ');
+    const reqOptions = availableTemplates.requirements.join(', ');
+    const designOptions = availableTemplates.design.join(', ');
+    return tool({
+        description: `Create project docs with templates or link existing files. Options - architecture: ${archOptions}, none, or file path; requirements: ${reqOptions}, none, or file path; design: ${designOptions}, none, or file path`,
+        args: {
+            architecture: z
+                .string()
+                .default('freestyle')
+                .describe('Template name, "none", or file path'),
+            requirements: z
+                .string()
+                .default('none')
+                .describe('Template name, "none", or file path'),
+            design: z
+                .string()
+                .default('freestyle')
+                .describe('Template name, "none", or file path'),
+        },
+        execute: async (args) => {
+            const serverContext = await getServerContext();
+            const logger = serverContext.loggerFactory
+                ? serverContext.loggerFactory('setup_project_docs')
+                : createLogger('setup_project_docs');
+            logger.debug('setup_project_docs called', args);
+            try {
+                // Delegate to SetupProjectDocsHandler
+                const handler = new SetupProjectDocsHandler();
+                const result = await handler.handle({
+                    architecture: args.architecture,
+                    requirements: args.requirements,
+                    design: args.design,
+                    project_path: projectDir,
+                }, serverContext);
+                // Handle errors gracefully
+                const errorMsg = handleMcpError(result);
+                if (errorMsg) {
+                    return errorMsg;
+                }
+                const data = unwrapResult(result);
+                logger.info('setup_project_docs: Completed', {
+                    created: data.created,
+                    linked: data.linked,
+                    skipped: data.skipped,
+                });
+                // Build response
+                const lines = [];
+                lines.push(data.message);
+                if (data.paths) {
+                    lines.push('');
+                    lines.push('Document paths:');
+                    lines.push(`  Architecture: ${data.paths.architecture}`);
+                    lines.push(`  Requirements: ${data.paths.requirements}`);
+                    lines.push(`  Design: ${data.paths.design}`);
+                }
+                return lines.join('\n');
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return `Error: ${errorMessage}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=setup-project-docs.js.map

package/packages/opencode-plugin/dist/tool-handlers/setup-project-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-project-docs.js","sourceRoot":"","sources":["../../src/tool-handlers/setup-project-docs.ts"],"names":[],"mappings":"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"}

package/packages/opencode-plugin/dist/tool-handlers/start-development.d.ts

@@ -0,0 +1,3 @@
+import { type WhatsNextResult, type ServerContext } from '@codemcp/workflows-server';
+import type { ToolDefinition } from '../types.js';
+export declare function createStartDevelopmentTool(projectDir: string, getServerContext: () => Promise<ServerContext>, setBufferedInstructions: (result: WhatsNextResult) => void): ToolDefinition;

package/packages/opencode-plugin/dist/tool-handlers/start-development.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { StartDevelopmentHandler, } from '@codemcp/workflows-server';
+import { tool } from './tool-helper.js';
+import { handleMcpError, unwrapResult } from '../server-context.js';
+import { WorkflowManager, createLogger } from '@codemcp/workflows-core';
+import { stripWhatsNextReferences } from '../utils.js';
+export function createStartDevelopmentTool(projectDir, getServerContext, setBufferedInstructions) {
+    // Load available workflows for description
+    // NOTE: Using getAvailableWorkflowsForProject() to respect:
+    //   1. VIBE_WORKFLOW_DOMAINS configuration (domain filtering)
+    //   2. Project-specific workflow configuration
+    const workflowManager = new WorkflowManager();
+    const availableWorkflows = workflowManager.getAvailableWorkflowsForProject(projectDir);
+    const workflowNames = availableWorkflows.map(w => w.name);
+    // Build tool description with workflow list
+    const toolDescription = workflowNames.length > 0
+        ? `Start a development workflow. Available: ${workflowNames.join(', ')}`
+        : 'Start a development workflow (no workflows available - check VIBE_WORKFLOW_DOMAINS)';
+    return tool({
+        description: toolDescription,
+        args: {
+            workflow: z.string().describe('Workflow name'),
+            require_reviews: z
+                .boolean()
+                .optional()
+                .describe('Require reviews before phase transitions'),
+        },
+        execute: async (args) => {
+            const serverContext = await getServerContext();
+            const logger = serverContext.loggerFactory
+                ? serverContext.loggerFactory('start_development')
+                : createLogger('start_development');
+            logger.debug('start_development called', { workflow: args.workflow });
+            try {
+                // Delegate to StartDevelopmentHandler
+                const handler = new StartDevelopmentHandler();
+                const result = await handler.handle({
+                    workflow: args.workflow,
+                    require_reviews: args.require_reviews,
+                    project_path: projectDir,
+                }, serverContext);
+                // Handle errors gracefully
+                const errorMsg = handleMcpError(result);
+                if (errorMsg) {
+                    return errorMsg;
+                }
+                const data = unwrapResult(result);
+                logger.info('start_development: Successfully started workflow', {
+                    workflow: args.workflow,
+                    phase: data.phase,
+                });
+                // Buffer instructions for the next chat.message hook
+                setBufferedInstructions({
+                    phase: data.phase,
+                    instructions: data.instructions,
+                    plan_file_path: data.plan_file_path,
+                    allowed_file_patterns: data.allowed_file_patterns ?? ['**/*'],
+                });
+                // Return the instructions from the handler (strip whats_next references)
+                return stripWhatsNextReferences(data.instructions);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return `Error: ${errorMessage}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=start-development.js.map

package/packages/opencode-plugin/dist/tool-handlers/start-development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-development.js","sourceRoot":"","sources":["../../src/tool-handlers/start-development.ts"],"names":[],"mappings":"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"}

package/packages/opencode-plugin/dist/tool-handlers/tool-helper.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types.js';
+/**
+ * Tool definition helper
+ */
+export declare function tool<Args extends z.ZodRawShape>(input: {
+    description: string;
+    args: Args;
+    execute(args: z.infer<z.ZodObject<Args>>, context: unknown): Promise<string>;
+}): ToolDefinition;

package/packages/opencode-plugin/dist/tool-handlers/tool-helper.js

@@ -0,0 +1,7 @@
+/**
+ * Tool definition helper
+ */
+export function tool(input) {
+    return input;
+}
+//# sourceMappingURL=tool-helper.js.map

package/packages/opencode-plugin/dist/tool-handlers/tool-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helper.js","sourceRoot":"","sources":["../../src/tool-handlers/tool-helper.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,IAAI,CAA6B,KAIhD;IACC,OAAO,KAAuB,CAAC;AACjC,CAAC"}

package/packages/opencode-plugin/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * OpenCode Plugin Types
+ *
+ * Minimal type definitions needed for the plugin.
+ * Based on @opencode-ai/plugin package types.
+ */
+import { z } from 'zod';
+export type Part = {
+    type: 'text' | 'image' | 'file' | 'tool_use' | 'tool_result';
+    text?: string;
+    [key: string]: unknown;
+};
+export type UserMessage = {
+    id: string;
+    sessionID: string;
+    role: 'user';
+    [key: string]: unknown;
+};
+export type Message = {
+    id: string;
+    sessionID: string;
+    role: 'user' | 'assistant';
+    [key: string]: unknown;
+};
+export type Model = {
+    providerID: string;
+    modelID: string;
+    [key: string]: unknown;
+};
+export type Project = {
+    id: string;
+    path: string;
+    [key: string]: unknown;
+};
+export type PluginInput = {
+    client: unknown;
+    project: Project;
+    directory: string;
+    worktree: string;
+    serverUrl: URL;
+    $: unknown;
+};
+export type ToolContext = {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    directory: string;
+    worktree: string;
+    abort: AbortSignal;
+    metadata(input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    ask(input: {
+        permission: string;
+        patterns: string[];
+        always: string[];
+        metadata: Record<string, unknown>;
+    }): Promise<void>;
+};
+export type ToolDefinition = {
+    description: string;
+    args: z.ZodRawShape;
+    execute(args: unknown, context: ToolContext): Promise<string>;
+};
+export interface Hooks {
+    event?: (input: {
+        event: unknown;
+    }) => Promise<void>;
+    config?: (input: unknown) => Promise<void>;
+    tool?: {
+        [key: string]: ToolDefinition;
+    };
+    auth?: unknown;
+    /**
+     * Called when a new message is received
+     */
+    'chat.message'?: (input: {
+        sessionID: string;
+        agent?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+        messageID?: string;
+        variant?: string;
+    }, output: {
+        message: UserMessage;
+        parts: Part[];
+    }) => Promise<void>;
+    /**
+     * Modify parameters sent to LLM
+     */
+    'chat.params'?: (input: {
+        sessionID: string;
+        agent: string;
+        model: Model;
+        provider: unknown;
+        message: UserMessage;
+    }, output: {
+        temperature: number;
+        topP: number;
+        topK: number;
+        options: Record<string, unknown>;
+    }) => Promise<void>;
+    'chat.headers'?: (input: {
+        sessionID: string;
+        agent: string;
+        model: Model;
+        provider: unknown;
+        message: UserMessage;
+    }, output: {
+        headers: Record<string, string>;
+    }) => Promise<void>;
+    'permission.ask'?: (input: unknown, output: {
+        status: 'ask' | 'deny' | 'allow';
+    }) => Promise<void>;
+    'command.execute.before'?: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Part[];
+    }) => Promise<void>;
+    'tool.execute.before'?: (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        args: Record<string, unknown>;
+    }) => Promise<void>;
+    'shell.env'?: (input: {
+        cwd: string;
+        sessionID?: string;
+        callID?: string;
+    }, output: {
+        env: Record<string, string>;
+    }) => Promise<void>;
+    'tool.execute.after'?: (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+        args: unknown;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+    'experimental.chat.messages.transform'?: (input: Record<string, never>, output: {
+        messages: {
+            info: Message;
+            parts: Part[];
+        }[];
+    }) => Promise<void>;
+    'experimental.chat.system.transform'?: (input: {
+        sessionID?: string;
+        model: Model;
+    }, output: {
+        system: string[];
+    }) => Promise<void>;
+    /**
+     * Called before session compaction starts. Allows plugins to customize
+     * the compaction prompt.
+     */
+    'experimental.session.compacting'?: (input: {
+        sessionID: string;
+    }, output: {
+        context: string[];
+        prompt?: string;
+    }) => Promise<void>;
+    'experimental.text.complete'?: (input: {
+        sessionID: string;
+        messageID: string;
+        partID: string;
+    }, output: {
+        text: string;
+    }) => Promise<void>;
+    /**
+     * Modify tool definitions (description and parameters) sent to LLM
+     */
+    'tool.definition'?: (input: {
+        toolID: string;
+    }, output: {
+        description: string;
+        parameters: unknown;
+    }) => Promise<void>;
+}
+export type Plugin = (input: PluginInput) => Promise<Hooks>;
+export type PluginModule = {
+    id?: string;
+    server: Plugin;
+    tui?: never;
+};

package/packages/opencode-plugin/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * OpenCode Plugin Types
+ *
+ * Minimal type definitions needed for the plugin.
+ * Based on @opencode-ai/plugin package types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/opencode-plugin/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/packages/opencode-plugin/dist/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Format a date as YYYY-MM-DD
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Get the current git branch for a project
+ */
+export declare function getCurrentGitBranch(projectPath: string): string;
+/**
+ * Strip whats_next() references from instructions.
+ * The plugin auto-injects instructions via chat.message hook,
+ * so users don't need to call whats_next() manually.
+ */
+export declare function stripWhatsNextReferences(text: string): string;

package/packages/opencode-plugin/dist/utils.js

@@ -0,0 +1,26 @@
+import { GitManager } from '@codemcp/workflows-core';
+/**
+ * Format a date as YYYY-MM-DD
+ */
+export function formatDate(date) {
+    return date.toISOString().split('T')[0];
+}
+/**
+ * Get the current git branch for a project
+ */
+export function getCurrentGitBranch(projectPath) {
+    return GitManager.getCurrentBranch(projectPath);
+}
+/**
+ * Strip whats_next() references from instructions.
+ * The plugin auto-injects instructions via chat.message hook,
+ * so users don't need to call whats_next() manually.
+ */
+export function stripWhatsNextReferences(text) {
+    return text
+        .split('\n')
+        .filter(line => !line.toLowerCase().includes('whats_next'))
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n'); // Collapse multiple blank lines
+}
+//# sourceMappingURL=utils.js.map

package/packages/opencode-plugin/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;SAC1D,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,gCAAgC;AACjE,CAAC"}

package/packages/opencode-plugin/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@codemcp/workflows-opencode",
+  "version": "6.5.0",
+  "description": "OpenCode plugin for structured development workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "clean:build": "rimraf ./dist",
+    "test": "vitest --run",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@codemcp/workflows-core": "workspace:*",
+    "@codemcp/workflows-server": "workspace:*",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "vitest": "4.0.18"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "*"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "workflows",
+    "development"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrsimpson/responsible-vibe-mcp"
+  }
+}