opencode-codegraph 0.1.28 → 0.1.30

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.30 - 2026-03-21
+
+- align git-oriented guidance and workflow-transition rendering with the shared workflow guidance block
+
+## 0.1.29 - 2026-03-21
+
+- align workflow-transition formatting with the shared guidance block so git-oriented guidance uses the same normalized renderer as other status surfaces
+
 ## 0.1.28 - 2026-03-21
 
 - surface primary issue and recovery sequence in plugin workflow summaries so competing blockers are shown in a prioritized order

package/README.md

@@ -127,6 +127,8 @@ Place in `.opencode/commands/`:
 Across status-oriented surfaces, the plugin is converging on one shared summary contract:
 
 - workflow state
+- primary issue
+- recovery sequence
 - blockers
 - warnings
 - what improved

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codegraph",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "OpenCode plugin for CodeGraph CPG-powered code analysis",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -68,8 +68,8 @@ const codegraphPlugin: Plugin = async (input) => {
   }
 
   const workflowTransition = (status: Record<string, unknown>) => {
-    const { workflowState, nextAction, nextCommand } = workflowFields(status)
-    const message = formatWorkflowStateTransition(lastWorkflowState, workflowState, nextAction, nextCommand)
+    const message = formatWorkflowStateTransition(lastWorkflowState, status as any)
+    const { workflowState } = workflowFields(status)
     if (workflowState) {
       lastWorkflowState = workflowState
     }

package/src/util.ts

@@ -119,6 +119,14 @@ function workflowSummaryLines(snapshot: DogfoodStatusSnapshot): string[] {
   }
   return lines
 }
+
+function formatSummaryBlock(title: string, snapshot: DogfoodStatusSnapshot): string | null {
+  const lines = workflowSummaryLines(snapshot)
+  if (!lines.length) {
+    return null
+  }
+  return [title, "", ...lines].join("\n")
+}
 
 /**
  * Extract file references from message parts.
@@ -515,37 +523,42 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
 }
 
 export function formatWorkflowGuidanceBlock(snapshot: DogfoodStatusSnapshot): string | null {
-  const lines = workflowSummaryLines(snapshot)
-
-  if (!lines.length) {
-    return null
-  }
-
-  return ["## CodeGraph Workflow Guidance", "", ...lines].join("\n")
+  return formatSummaryBlock("## CodeGraph Workflow Guidance", snapshot)
 }
 
 export function formatWorkflowStateTransition(
   previousState: string | null,
-  currentState: string | null,
-  nextAction: string | undefined,
-  nextCommand: string | undefined,
+  snapshot: DogfoodStatusSnapshot,
 ): string | null {
+  const currentState = snapshot.workflow_state || null
   if (!previousState || !currentState || previousState === currentState) {
     return null
   }
 
+  const nextAction = snapshot.recommended_next_action
+  const nextCommand = snapshot.recommended_command
+  const primaryIssue = snapshot.primary_issue
+  const blockers = Array.isArray(snapshot.blockers) ? snapshot.blockers.filter(Boolean) : []
+
   const lines = [
     "## CodeGraph Workflow Update",
     "",
     `- Workflow state changed: ${previousState} -> ${currentState}`,
   ]
 
+  if (primaryIssue) {
+    lines.push(`- Primary issue: ${primaryIssue}`)
+  }
+
   if (nextAction) {
     lines.push(`- Next action: ${nextAction}`)
   }
   if (nextCommand) {
     lines.push(`- Suggested command: ${nextCommand}`)
   }
+  if (blockers.length) {
+    lines.push(`- Blockers: ${blockers.join("; ")}`)
+  }
   return lines.join("\n")
 }
 
@@ -568,8 +581,7 @@ export function formatAfterTestGuidance(
     lines.push("- Suggested command: rerun the failing tests after you fix them")
     return lines.join("\n")
   }
-  lines.push(...workflowSummaryLines(snapshot))
-  return lines.join("\n")
+  return formatSummaryBlock("## CodeGraph After-Test Guidance", snapshot)
 }
 
 // File extensions recognized as source code