opencode-codegraph 0.1.19 → 0.1.20

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.20 - 2026-03-20
+
+- append workflow guidance to the `codegraph_review` custom tool so tool results stay aligned with current dogfooding state
+
 ## 0.1.19 - 2026-03-20
 
 - add workflow guidance directly to `git status` and `git diff` command output inside OpenCode

package/README.md

@@ -117,6 +117,7 @@ Place in `.opencode/commands/`:
 | `tool.execute.after` on test commands | Add after-test workflow guidance and detect failed test runs before suggesting the next command |
 | `tool.execute.after` on `git status` / `git diff` | Add current workflow guidance directly to common git inspection commands |
 | `tool.execute.after` | Trigger CPG update after git commit and append structured post-commit review summary |
+| `codegraph_review` tool | Returns review results together with current workflow guidance and suggested follow-up command |
 | `experimental.session.compacting` | Preserve current dogfooding status when OpenCode compacts long sessions |
 | `command.execute.before` | Inject current dogfooding status into `/review`, `/audit`, `/update`, `/status`, and `/next` |
 | `permission.ask` | Auto-allow `codegraph_*` tools |

package/package.json

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

package/src/index.ts

@@ -22,6 +22,7 @@ import {
   formatDogfoodStatusSummary,
   formatPendingReviewTraceSummary,
   formatReviewTraceSummary,
+  formatWorkflowGuidanceBlock,
   getHeadCommit,
   isGitCommit,
   isGitStatusLikeCommand,
@@ -295,17 +296,22 @@ const codegraphPlugin: Plugin = async (input) => {
             .optional()
             .describe("Base git ref to compare against (default: HEAD~1)"),
         },
-        async execute(args) {
-          const baseRef = args.base_ref || "HEAD~1"
-          const diff = await $`git diff ${baseRef}`.quiet().text()
-          if (!diff.trim()) {
-            return "No changes found."
-          }
-
-          const result = await api.reviewChanges(projectId, diff, baseRef)
-          return result
-        },
-      }),
+        async execute(args) {
+          const baseRef = args.base_ref || "HEAD~1"
+          const diff = await $`git diff ${baseRef}`.quiet().text()
+          const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
+          const status = JSON.parse(rawStatus)
+          const guidance = formatWorkflowGuidanceBlock(status)
+          if (!diff.trim()) {
+            return guidance ? `No changes found.\n\n${guidance}` : "No changes found."
+          }
+
+          const result = await api.reviewChanges(projectId, diff, baseRef)
+          return guidance
+            ? `${result}\n\n${guidance}\n\nUse the suggested command if the review result and session state disagree.`
+            : result
+        },
+      }),
 
       codegraph_explain_function: tool({
         description:

package/src/util.ts

@@ -417,6 +417,28 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   return lines.join("\n")
 }
 
+export function formatWorkflowGuidanceBlock(snapshot: DogfoodStatusSnapshot): string | null {
+  const workflowState = snapshot.workflow_state
+  const nextAction = snapshot.recommended_next_action
+  const nextCommand = snapshot.recommended_command
+
+  if (!workflowState && !nextAction && !nextCommand) {
+    return null
+  }
+
+  const lines = ["## CodeGraph Workflow Guidance", ""]
+  if (workflowState) {
+    lines.push(`- Workflow state: ${workflowState}`)
+  }
+  if (nextAction) {
+    lines.push(`- Next action: ${nextAction}`)
+  }
+  if (nextCommand) {
+    lines.push(`- Suggested command: ${nextCommand}`)
+  }
+  return lines.join("\n")
+}
+
 export function formatAfterTestGuidance(
   snapshot: DogfoodStatusSnapshot,
   testFailed = false,