opencode-codegraph 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.5 - 2026-03-20
+
+- add unified next-action summary to review-trace status output
+- surface next-action guidance in post-commit OpenCode plugin metadata and review-trace summaries
+- document the next-action workflow in plugin and integration docs
+
 ## 0.1.4 - 2026-03-20
 
 - add conversational pre-edit guidance when a chat message suggests code modification

package/README.md

@@ -45,7 +45,7 @@ Every conversation includes a project summary with file count, top complexity ho
 
 ### Post-Commit Updates
 
-After `git commit`, the plugin triggers incremental CPG re-parsing via GoCPG and syncs the ChromaDB vector store. If durable review-trace artifacts exist for the new `HEAD`, the plugin also appends a short review-trace summary with findings and recommendations.
+After `git commit`, the plugin triggers incremental CPG re-parsing via GoCPG and syncs the ChromaDB vector store. If durable review-trace artifacts exist for the new `HEAD`, the plugin also appends a short review-trace summary with findings, recommendations, and a single next action to take.
 
 ### Custom Tools
 
@@ -89,7 +89,7 @@ Place in `.opencode/commands/`:
 | `experimental.chat.system.transform` | Inject project summary into system prompt |
 | `chat.message` | Add CPG context for mentioned files |
 | `chat.message` (edit intent) | Add pre-edit warnings for files likely to be modified |
-| `tool.execute.after` | Trigger CPG update after git commit |
+| `tool.execute.after` | Trigger CPG update after git commit and append review-trace summary with next action |
 | `permission.ask` | Auto-allow `codegraph_*` tools |
 
 ## License

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "opencode-codegraph",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "OpenCode plugin for CodeGraph CPG-powered code analysis",
   "type": "module",
   "main": "src/index.ts",
   "exports": {
     ".": "./src/index.ts"
   },
-  "files": [
-    "src",
-    "CHANGELOG.md"
-  ],
+  "files": [
+    "src",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "tsc"

package/src/index.ts

@@ -21,6 +21,7 @@ import {
   getHeadCommit,
   isGitCommit,
   messageSuggestsEditing,
+  recommendedNextActionFromReviewTrace,
   readReviewTraceSnapshot,
 } from "./util"
 
@@ -112,6 +113,7 @@ const codegraphPlugin: Plugin = async (input) => {
               codegraph_review_trace_findings: traceSnapshot.review_findings_count ?? null,
               codegraph_review_trace_recommendations:
                 traceSnapshot.review_recommendations?.slice(0, 3) || [],
+              codegraph_review_trace_next_action: recommendedNextActionFromReviewTrace(traceSnapshot),
             }
           }
         }

package/src/util.ts

@@ -163,9 +163,39 @@ export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string
     }
   }
 
+  const nextAction = recommendedNextActionFromReviewTrace(snapshot)
+  if (nextAction) {
+    lines.push("", `**Next action:** ${nextAction}`)
+  }
+
   return lines.length > 2 ? lines.join("\n") : null
 }
 
+export function recommendedNextActionFromReviewTrace(snapshot: ReviewTraceSnapshot): string {
+  const status = (snapshot.status || "").toLowerCase()
+  const findingsCount = snapshot.review_findings_count
+  const recommendations = Array.isArray(snapshot.review_recommendations)
+    ? snapshot.review_recommendations.filter(Boolean)
+    : []
+
+  if (snapshot.error) {
+    return "Investigate the review-trace error, then run /review once the pipeline is healthy."
+  }
+  if (status === "running") {
+    return "Wait for review trace completion, then inspect findings and recommendations."
+  }
+  if (status && status !== "completed") {
+    return "Check the latest review trace status again and rerun /review if the result is incomplete."
+  }
+  if (typeof findingsCount === "number" && findingsCount > 0) {
+    if (recommendations.length) {
+      return "Apply the top CodeGraph recommendations, then run /review to confirm the fixes."
+    }
+    return "Inspect the reported findings, fix the highest-risk issues, then run /review again."
+  }
+  return "No review findings recorded; continue with /review or push once the rest of your checks are green."
+}
+
 // File extensions recognized as source code
 const SOURCE_EXTENSIONS = new Set([
   "py",