opencode-codegraph 0.1.30 → 0.1.32

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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

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 |

package/package.json

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

package/src/index.ts

@@ -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

@@ -540,16 +540,15 @@ export function formatWorkflowStateTransition(
   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}`,
-  ]
+  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}`)
   }