opencode-codegraph 0.1.28 → 0.1.32

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.32 - 2026-03-21
+
+- align workflow-update blocks with the same closure-oriented framing used by other status-oriented surfaces
+
+## 0.1.31 - 2026-03-21
+
+- add current workflow guidance to `codegraph_explain_function` so tool-level explanations align with command-level DX
+
+## 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

@@ -119,6 +119,7 @@ Place in `.opencode/commands/`:
 | `tool.execute.after` | Trigger CPG update after git commit and append structured post-commit review summary |
 | generic `tool.execute.after` | Surface workflow-state transitions after other bash commands when the underlying state changes |
 | `codegraph_review` tool | Returns review results together with current workflow guidance and suggested follow-up command |
+| `codegraph_explain_function` tool | Returns function analysis together with current workflow guidance |
 | `experimental.session.compacting` | Preserve current dogfooding status when OpenCode compacts long sessions |
 | `command.execute.before` | Inject current dogfooding status into `/review`, `/audit`, `/update`, `/status`, `/next`, `/continue`, `/maintain-db`, and `/unlock-db` |
 | `db_locked` recovery path | Surface lock-holder-aware recovery guidance when DuckDB is blocked by another process |
@@ -127,6 +128,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.32",
   "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
     }
@@ -425,14 +425,21 @@ const codegraphPlugin: Plugin = async (input) => {
         description:
           "Deep analysis of a function using CPG. Shows callers, callees, " +
           "complexity, taint paths, and security findings.",
-        args: {
-          name: tool.schema.string().describe("Function or method name to analyze"),
-        },
-        async execute(args) {
-          const result = await api.explainFunction(projectId, args.name)
-          return result
-        },
-      }),
+        args: {
+          name: tool.schema.string().describe("Function or method name to analyze"),
+        },
+        async execute(args) {
+          const result = await api.explainFunction(projectId, args.name)
+          try {
+            const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
+            const status = JSON.parse(rawStatus)
+            const guidance = formatWorkflowGuidanceBlock(status)
+            return guidance ? `${result}\n\n${guidance}` : result
+          } catch {
+            return result
+          }
+        },
+      }),
     },
 
     // -----------------------------------------------------------------

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,30 +523,31 @@ 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 lines = [
-    "## CodeGraph Workflow Update",
-    "",
-    `- Workflow state changed: ${previousState} -> ${currentState}`,
-  ]
+  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", "", "### What changed", ""]
+  lines.push(`- Workflow state changed: ${previousState} -> ${currentState}`)
+
+  if (primaryIssue) {
+    lines.push(`- Primary issue: ${primaryIssue}`)
+  }
+
+  lines.push("", "### What to do now", "")
 
   if (nextAction) {
     lines.push(`- Next action: ${nextAction}`)
@@ -546,6 +555,9 @@ export function formatWorkflowStateTransition(
   if (nextCommand) {
     lines.push(`- Suggested command: ${nextCommand}`)
   }
+  if (blockers.length) {
+    lines.push(`- Blockers: ${blockers.join("; ")}`)
+  }
   return lines.join("\n")
 }
 
@@ -568,8 +580,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