opencode-codegraph 0.1.30 → 0.1.33

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.33 - 2026-03-21
+
+- expose workflow policy transparency in plugin summaries via `policy_version` and `priority_reason`
+
+## 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 |
@@ -127,6 +128,7 @@ Place in `.opencode/commands/`:
 Across status-oriented surfaces, the plugin is converging on one shared summary contract:
 
 - workflow state
+- policy version / priority reason
 - primary issue
 - recovery sequence
 - blockers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codegraph",
-  "version": "0.1.30",
+  "version": "0.1.33",
   "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

@@ -46,6 +46,8 @@ export type DogfoodStatusSnapshot = {
   }
   review_trace?: ReviewTraceSnapshot | null
   workflow_state?: string
+  policy_version?: string
+  priority_reason?: string
   recommended_next_action?: string
   recommended_command?: string
   primary_issue?: string
@@ -61,6 +63,8 @@ export type DogfoodStatusSnapshot = {
 
 function workflowSummaryLines(snapshot: DogfoodStatusSnapshot): string[] {
   const workflowState = snapshot.workflow_state
+  const policyVersion = snapshot.policy_version
+  const priorityReason = snapshot.priority_reason
   const nextAction = snapshot.recommended_next_action
   const nextCommand = snapshot.recommended_command
   const primaryIssue = snapshot.primary_issue
@@ -77,6 +81,12 @@ function workflowSummaryLines(snapshot: DogfoodStatusSnapshot): string[] {
   if (workflowState) {
     lines.push(`- Workflow state: ${workflowState}`)
   }
+  if (policyVersion) {
+    lines.push(`- Policy version: ${policyVersion}`)
+  }
+  if (priorityReason) {
+    lines.push(`- Priority reason: ${priorityReason}`)
+  }
   if (nextAction) {
     lines.push(`- Next action: ${nextAction}`)
   }
@@ -540,16 +550,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}`)
   }