opencode-codegraph 0.1.19 → 0.1.21

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.21 - 2026-03-20
+
+- append workflow guidance to the `codegraph_review` custom tool so tool results stay aligned with current dogfooding state
+- add `/continue` as a safe guided execution command for refresh/review workflow steps
+
+## 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.21",
   "description": "OpenCode plugin for CodeGraph CPG-powered code analysis",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -22,6 +22,8 @@ import {
   formatDogfoodStatusSummary,
   formatPendingReviewTraceSummary,
   formatReviewTraceSummary,
+  formatReviewTraceUpdateSummary,
+  formatWorkflowGuidanceBlock,
   getHeadCommit,
   isGitCommit,
   isGitStatusLikeCommand,
@@ -43,8 +45,20 @@ const codegraphPlugin: Plugin = async (input) => {
   const apiUrl = process.env.CODEGRAPH_API_URL || "http://localhost:8000"
   const api = new CodeGraphAPI(apiUrl)
 
-  // Detect project ID from environment or opencode.json
-  const projectId = process.env.CODEGRAPH_PROJECT || ""
+  // Detect project ID from environment or opencode.json
+  const projectId = process.env.CODEGRAPH_PROJECT || ""
+  let pendingReviewCommit: string | null = null
+
+  const consumePendingReviewTraceUpdate = async (): Promise<string | null> => {
+    if (!pendingReviewCommit) return null
+    const commit = pendingReviewCommit
+    const traceSnapshot = await readReviewTraceSnapshot(directory, commit, 1, 0)
+    if (!traceSnapshot) return null
+    const workflowState = traceSnapshot.workflow_state || workflowStateFromReviewTrace(traceSnapshot)
+    if (workflowState === "trace_pending") return null
+    pendingReviewCommit = null
+    return formatReviewTraceUpdateSummary(traceSnapshot)
+  }
 
   return {
     // -----------------------------------------------------------------
@@ -95,6 +109,14 @@ const codegraphPlugin: Plugin = async (input) => {
       }
 
       try {
+        const pendingUpdate = await consumePendingReviewTraceUpdate()
+        if (pendingUpdate) {
+          output.parts.push({
+            type: "text",
+            text: pendingUpdate,
+          } as any)
+        }
+
         const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
         const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
         if (statusSummary) {
@@ -119,6 +141,14 @@ const codegraphPlugin: Plugin = async (input) => {
       if (!files.length && !workflowIntent) return
 
       try {
+        const pendingUpdate = await consumePendingReviewTraceUpdate()
+        if (pendingUpdate) {
+          output.parts.push({
+            type: "text",
+            text: pendingUpdate,
+          } as any)
+        }
+
         if (workflowIntent) {
           try {
             const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
@@ -244,6 +274,7 @@ const codegraphPlugin: Plugin = async (input) => {
             }
           } else {
             traceSummary = formatPendingReviewTraceSummary(commit)
+            pendingReviewCommit = commit
             output.metadata = {
               ...output.metadata,
               codegraph_review_trace_status: "pending_or_missing",
@@ -295,17 +326,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

@@ -257,6 +257,12 @@ export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string
   return lines.join("\n")
 }
 
+export function formatReviewTraceUpdateSummary(snapshot: ReviewTraceSnapshot): string | null {
+  const base = formatReviewTraceSummary(snapshot)
+  if (!base) return null
+  return base.replace("## CodeGraph Post-Commit Summary", "## CodeGraph Review Trace Update")
+}
+
 export function whatChangedFromReviewTrace(snapshot: ReviewTraceSnapshot): string[] {
   const items: string[] = []
   const status = snapshot.status || "unknown"
@@ -417,6 +423,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,