@codemcp/workflows-opencode 6.11.1 → 6.13.4

package/README.md

@@ -90,6 +90,18 @@ When the env var is set, workflow hooks are skipped and tools throw a clear erro
 
 **When unset**, workflows are active for all agents (default behavior).
 
+### Auto-Compaction
+
+When transitioning to a new phase via `proceed_to_phase`, the plugin automatically triggers a session compaction (summarize) to clear prior-phase context from the LLM window. This is enabled by default.
+
+Set `WORKFLOW_AUTO_COMPACT=false` to disable this behavior:
+
+```bash
+WORKFLOW_AUTO_COMPACT=false npx opencode
+```
+
+**When unset or any value other than `false`**, compaction runs on every successful phase transition (default behavior).
+
 ### Per-Agent Behavior
 
 - **Agent in filter**: Workflow instructions are injected on every message, tools work normally

package/dist/index.d.ts

@@ -65,9 +65,26 @@ type ToolDefinition = {
     args: z.ZodRawShape;
     execute(args: unknown, context: ToolContext): Promise<string>;
 };
+type SessionCompactedEvent = {
+    type: 'session.compacted';
+    properties: {
+        sessionID: string;
+    };
+};
+type SessionIdleEvent = {
+    type: 'session.idle';
+    properties: {
+        sessionID: string;
+    };
+};
+type OtherEvent = {
+    type: string;
+    properties: Record<string, unknown>;
+};
+type BusEvent = SessionCompactedEvent | SessionIdleEvent | OtherEvent;
 interface Hooks {
     event?: (input: {
-        event: unknown;
+        event: BusEvent;
     }) => Promise<void>;
     config?: (input: unknown) => Promise<void>;
     tool?: {
@@ -217,4 +234,4 @@ declare const _default: {
     server: Plugin;
 };
 
-export { type Hooks, type Message, type Model, type Part, type Plugin, type PluginInput, type PluginModule, type Project, type ToolContext, type ToolDefinition, type UserMessage, WorkflowsPlugin, _default as default };
+export { type BusEvent, type Hooks, type Message, type Model, type OtherEvent, type Part, type Plugin, type PluginInput, type PluginModule, type Project, type SessionCompactedEvent, type SessionIdleEvent, type ToolContext, type ToolDefinition, type UserMessage, WorkflowsPlugin, _default as default };

package/dist/index.js

@@ -16902,7 +16902,7 @@ var PlanManager = class {
     if (workflowName === "custom") {
       return void 0;
     }
-    return `https://mrsimpson.github.io/responsible-vibe-mcp/workflows/${workflowName}`;
+    return `https://codemcp.github.io/workflows/workflows/${workflowName}`;
   }
   /**
    * Generate base instructions for the LLM after a workflow is started.
@@ -18663,9 +18663,13 @@ var InstructionGenerator = class {
     const { phase, conversationContext, allowedFilePatterns } = context;
     const phaseName = capitalizePhase(phase);
     let workflowSection = `---
-**Read \`${conversationContext.planFilePath}\`** for context.
-- Focus on "${phaseName}" tasks, log decisions in "Key Decisions"
-- Do NOT use other task/todo tools - use only the plan file for task tracking`;
+### YOU MUST FOLLOW THESE INSTRUCTIONS:
+
+**IMPORTANT: Read \`${conversationContext.planFilePath}\`** for context.
+
+**ACTION REQUIRED: Focus on "${phaseName}" tasks** and log decisions in "Key Decisions"
+
+**CRITICAL: Do NOT use other task/todo tools** - use only the plan file for task tracking`;
     if (allowedFilePatterns && allowedFilePatterns.length > 0 && !allowedFilePatterns.includes("**/*") && !allowedFilePatterns.includes("*")) {
       workflowSection += `
 - Files allowed: \`${allowedFilePatterns.join("`, `")}\``;
@@ -21453,7 +21457,7 @@ Then retry \`start_development\`.`;
     if (workflowName === "custom") {
       return void 0;
     }
-    return `https://mrsimpson.github.io/responsible-vibe-mcp/workflows/${workflowName}`;
+    return `https://codemcp.github.io/workflows/workflows/${workflowName}`;
   }
   /**
    * Get the current git branch for a project
@@ -27030,7 +27034,7 @@ var PlanManager2 = class {
     if (workflowName === "custom") {
       return void 0;
     }
-    return `https://mrsimpson.github.io/responsible-vibe-mcp/workflows/${workflowName}`;
+    return `https://codemcp.github.io/workflows/workflows/${workflowName}`;
   }
   /**
    * Generate base instructions for the LLM after a workflow is started.
@@ -28057,9 +28061,13 @@ var InstructionGenerator2 = class {
     const { phase, conversationContext, allowedFilePatterns } = context;
     const phaseName = capitalizePhase3(phase);
     let workflowSection = `---
-**Read \`${conversationContext.planFilePath}\`** for context.
-- Focus on "${phaseName}" tasks, log decisions in "Key Decisions"
-- Do NOT use other task/todo tools - use only the plan file for task tracking`;
+### YOU MUST FOLLOW THESE INSTRUCTIONS:
+
+**IMPORTANT: Read \`${conversationContext.planFilePath}\`** for context.
+
+**ACTION REQUIRED: Focus on "${phaseName}" tasks** and log decisions in "Key Decisions"
+
+**CRITICAL: Do NOT use other task/todo tools** - use only the plan file for task tracking`;
     if (allowedFilePatterns && allowedFilePatterns.length > 0 && !allowedFilePatterns.includes("**/*") && !allowedFilePatterns.includes("*")) {
       workflowSection += `
 - Files allowed: \`${allowedFilePatterns.join("`, `")}\``;
@@ -28202,17 +28210,25 @@ function createProceedToPhaseTool(getServerContext, setBufferedInstructions, cli
           plan_file_path: data.plan_file_path,
           allowed_file_patterns: data.allowed_file_patterns
         });
-        const model = getModel();
-        client.session.summarize({
-          path: { id: context.sessionID },
-          ...model ? { body: model } : {}
-        }).catch(() => {
-        });
-        logger37.info("Triggered compaction after phase transition", {
-          phase: data.phase,
-          sessionID: context.sessionID,
-          hasModel: !!model
-        });
+        const autoCompact = process.env["WORKFLOW_AUTO_COMPACT"]?.trim()?.toLowerCase();
+        if (autoCompact !== "false") {
+          const model = getModel();
+          client.session.summarize({
+            path: { id: context.sessionID },
+            ...model ? { body: model } : {}
+          }).catch(() => {
+          });
+          logger37.info("Triggered compaction after phase transition", {
+            phase: data.phase,
+            sessionID: context.sessionID,
+            hasModel: !!model
+          });
+        } else {
+          logger37.debug("Skipped compaction: WORKFLOW_AUTO_COMPACT=false", {
+            phase: data.phase,
+            sessionID: context.sessionID
+          });
+        }
         const lines = [];
         lines.push(`Transitioned to: ${data.phase}`);
         if (data.transition_reason) {
@@ -28597,6 +28613,8 @@ var WorkflowsPlugin = async (input) => {
   let currentSessionId = null;
   let lastKnownSessionId = null;
   let bufferedInstructions = null;
+  let postCompactionSession = null;
+  let postCompactionMessagePending = false;
   let lastKnownModel = null;
   function setBufferedInstructions(result) {
     bufferedInstructions = {
@@ -28684,6 +28702,13 @@ var WorkflowsPlugin = async (input) => {
       if (hookInput.model) {
         lastKnownModel = hookInput.model;
       }
+      if (postCompactionMessagePending) {
+        postCompactionMessagePending = false;
+        logger37.debug(
+          "chat.message: skipping synthetic part for post-compaction instructions message"
+        );
+        return;
+      }
       if (!isAgentEnabled(hookInput.agent)) {
         logger37.debug(
           "chat.message: Agent not enabled \u2014 injecting tool suppression",
@@ -28822,8 +28847,10 @@ ACTION REQUIRED: Use transition_phase tool to move to a phase that allows editin
     },
     /**
      * Hook 3: experimental.session.compacting
-     * Fires when session is being compacted. We provide minimal guidance on what
-     * to preserve and instruct the summary to end with phase continuation.
+     * Fires when session is being compacted. We provide full phase instructions
+     * so the compaction summary is self-sufficient — the AI knows exactly what
+     * to continue even if the chat.message hook doesn't fire for the synthetic
+     * auto-compaction "continue" message.
      */
     "experimental.session.compacting": async (hookInput, output) => {
       logger37.debug("experimental.session.compacting hook fired", {
@@ -28834,13 +28861,103 @@ ACTION REQUIRED: Use transition_phase tool to move to a phase that allows editin
         logger37.debug("No active workflow - skipping compaction guidance");
         return;
       }
+      let phaseInstructions = null;
+      try {
+        const serverContext = await getServerContext();
+        const handler = new WhatsNextHandler();
+        const handlerResult = await handler.handle({}, serverContext);
+        if (handlerResult.success && handlerResult.data) {
+          phaseInstructions = stripWhatsNextReferences(
+            handlerResult.data.instructions
+          );
+        }
+      } catch (_err) {
+      }
       output.context.push(
         "Preserve: user intents, key decisions, significant changes and the reasoning why they were made. Remove tool calls, intermediate thoughts, and minor details."
       );
-      output.context.push(
-        `End summary with: "Continue ${state.phase} phase. ${state.phaseDescription || ""}"`
-      );
-      logger37.info("Injected compaction guidance", { phase: state.phase });
+      if (phaseInstructions) {
+        output.context.push(
+          `Current workflow phase: ${state.phase}. After compaction, resume with full phase context:
+
+${phaseInstructions}`
+        );
+      } else {
+        output.context.push(
+          `End summary with: "Continue ${state.phase} phase. ${state.phaseDescription || ""}"`
+        );
+      }
+      logger37.info("Injected compaction guidance", {
+        phase: state.phase,
+        fullInstructions: phaseInstructions !== null
+      });
+    },
+    /**
+     * Hook 4: event
+     * Listens for bus events. When a session compaction completes we record it,
+     * then when the session becomes idle we send a real user message so the
+     * normal chat.message hook fires and injects phase instructions — giving the
+     * AI full workflow context to continue after the compaction.
+     *
+     * We intentionally do NOT suppress the default synthetic "continue" message
+     * (experimental.compaction.autocontinue). It may produce a first generic AI
+     * response, but the idle trigger below ensures a proper phase-aware follow-up.
+     */
+    event: async ({ event }) => {
+      logger37.debug("event hook fired", { type: event.type });
+      if (event.type === "session.compacted") {
+        postCompactionSession = event.properties.sessionID;
+        logger37.info("session.compacted: pending phase-aware continue", {
+          sessionID: postCompactionSession
+        });
+        return;
+      }
+      if (event.type === "session.idle" && postCompactionSession === event.properties.sessionID) {
+        const sessionID = postCompactionSession;
+        postCompactionSession = null;
+        logger37.info(
+          "session.idle after compaction: sending phase-aware continue",
+          { sessionID }
+        );
+        await new Promise((resolve6) => setTimeout(resolve6, 500));
+        let promptText = "Continue with the current phase.";
+        let usedPhaseInstructions = false;
+        try {
+          const serverContext = await getServerContext();
+          const handler = new WhatsNextHandler();
+          const handlerResult = await handler.handle({}, serverContext);
+          if (handlerResult.success && handlerResult.data) {
+            const instructions = stripWhatsNextReferences(
+              handlerResult.data.instructions
+            );
+            if (instructions.trim()) {
+              promptText = instructions;
+              usedPhaseInstructions = true;
+            }
+          }
+        } catch (_err) {
+        }
+        if (usedPhaseInstructions) {
+          postCompactionMessagePending = true;
+        }
+        try {
+          const client = input.client;
+          await client.session.promptAsync({
+            path: { id: sessionID },
+            body: {
+              parts: [{ type: "text", text: promptText }]
+            }
+          });
+          logger37.info("session.idle: phase-aware continue sent (async)", {
+            sessionID
+          });
+        } catch (err) {
+          logger37.error("session.idle: failed to send phase-aware continue", {
+            sessionID,
+            error: err instanceof Error ? err.message : String(err)
+          });
+        }
+      }
     },
     /**
      * Custom tools - always registered to allow clear error messages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-opencode",
-  "version": "6.11.1",
+  "version": "6.13.4",
   "description": "OpenCode plugin for structured development workflows",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,8 +19,8 @@
     "rimraf": "^6.0.1",
     "tsup": "^8.0.0",
     "vitest": "4.0.18",
-    "@codemcp/workflows-server": "6.11.1",
-    "@codemcp/workflows-core": "6.11.1"
+    "@codemcp/workflows-core": "6.13.4",
+    "@codemcp/workflows-server": "6.13.4"
   },
   "peerDependencies": {
     "@anthropic-ai/sdk": "*"
@@ -39,7 +39,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mrsimpson/responsible-vibe-mcp"
+    "url": "https://github.com/codemcp/workflows"
   },
   "scripts": {
     "build": "tsup && pnpm copy-resources",

package/resources/agents/architect.yaml

@@ -16,7 +16,7 @@ systemPrompt: |
 
   ## Available Tools
 
-  **Workflow Navigation (responsible-vibe-mcp):**
+  **Workflow Navigation:**
   - `whats_next()`: Call this after EVERY user message to get phase-specific guidance
   - `proceed_to_phase()`: Move to the next phase when your work is complete (only when responsible)
 
@@ -45,7 +45,7 @@ llmSettings:
   reasoningEffort: medium
 
 mcpServers:
-  workflows:
+  'workflows':
     type: stdio
     command: npx
     args:

package/resources/agents/business-analyst.yaml

@@ -16,7 +16,7 @@ systemPrompt: |
 
   ## Available Tools
 
-  **Workflow Navigation (responsible-vibe-mcp):**
+  **Workflow Navigation**
   - `whats_next()`: Call this after EVERY user message to get phase-specific guidance
   - `proceed_to_phase()`: Move to the next phase when your work is complete (only when responsible)
 

package/resources/agents/developer.yaml

@@ -16,7 +16,7 @@ systemPrompt: |
 
   ## Available Tools
 
-  **Workflow Navigation (responsible-vibe-mcp):**
+  **Workflow Navigation**
   - `whats_next()`: Call this after EVERY user message to get phase-specific guidance
   - `proceed_to_phase()`: Move to the next phase when your work is complete (only when responsible)
 

package/resources/templates/skills/POWER.md

@@ -18,6 +18,6 @@ keywords:
 license: MIT
 metadata:
   version: '${VERSION}'
-  repository: https://github.com/mrsimpson/responsible-vibe-mcp
+  repository: https://github.com/codemcp/workflows
   author: mrsimpson
 ---

package/resources/templates/skills/SKILL.md

@@ -8,7 +8,7 @@ description: >
 license: MIT
 metadata:
   version: '${VERSION}'
-  repository: https://github.com/mrsimpson/responsible-vibe-mcp
+  repository: https://github.com/codemcp/workflows
   author: mrsimpson
 requires-mcp-servers:
   - name: workflows