opencode-codegraph 0.1.18 → 0.1.20

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ## 0.1.18 - 2026-03-20
 
 - make after-test guidance test-result aware so failing test runs explicitly block review/push guidance until failures are fixed

package/README.md

@@ -115,7 +115,9 @@ Place in `.opencode/commands/`:
 | `chat.message` (edit intent) | Add pre-edit warnings for files likely to be modified |
 | `chat.message` (workflow intent) | Add dogfooding status when the user asks what to do next |
 | `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.18",
+  "version": "0.1.20",
   "description": "OpenCode plugin for CodeGraph CPG-powered code analysis",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -22,8 +22,10 @@ import {
   formatDogfoodStatusSummary,
   formatPendingReviewTraceSummary,
   formatReviewTraceSummary,
+  formatWorkflowGuidanceBlock,
   getHeadCommit,
   isGitCommit,
+  isGitStatusLikeCommand,
   isTestCommand,
   messageSuggestsEditing,
   messageSuggestsWorkflowGuidance,
@@ -194,6 +196,27 @@ const codegraphPlugin: Plugin = async (input) => {
         }
       }
 
+      if (isGitStatusLikeCommand(command)) {
+        try {
+          const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
+          const status = JSON.parse(rawStatus)
+          const guidance = formatDogfoodStatusSummary(status)
+          if (guidance) {
+            output.title = "CodeGraph: git workflow guidance ready"
+            const existingOutput = output.output?.trimEnd() || ""
+            output.output = existingOutput ? `${existingOutput}\n\n${guidance}` : guidance
+            output.metadata = {
+              ...output.metadata,
+              codegraph_git_workflow_state: status.workflow_state || null,
+              codegraph_git_next_action: status.recommended_next_action || null,
+              codegraph_git_recommended_command: status.recommended_command || null,
+            }
+          }
+        } catch {
+          // Best-effort guidance only
+        }
+      }
+
       if (!isGitCommit(output.output)) return
 
       try {
@@ -273,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

@@ -99,6 +99,12 @@ export function isTestCommand(command: string): boolean {
   )
 }
 
+export function isGitStatusLikeCommand(command: string): boolean {
+  if (!command) return false
+  const normalized = command.toLowerCase()
+  return normalized.includes("git status") || normalized.includes("git diff")
+}
+
 export function didTestCommandFail(output: string): boolean {
   if (!output) return false
   const normalized = output.toLowerCase()
@@ -411,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,