opencode-codegraph 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.8 - 2026-03-20
+
+- add normalized workflow states (`refresh_needed`, `trace_pending`, `review_required`, `ready_to_continue`) across dogfooding status and review trace flows
+- surface a recommended command alongside next-action guidance in session-start, status, and post-commit summaries
+- align `/review`, `/audit`, and `/update` around the same status-derived command guidance
+
 ## 0.1.7 - 2026-03-20
 
 - add command-oriented next-step guidance (`/status`, `/update`, `/review`) to review-trace and dogfooding status flows

package/README.md

@@ -46,6 +46,7 @@ Every conversation includes:
 - a project summary with file count, top complexity hotspots, and open security findings;
 - a lightweight dogfooding status block when available, including freshness, current `HEAD`, review-trace state, and recommended next action.
 - a recommended command (`/status`, `/update`, or `/review`) when the workflow can point to a deterministic next step.
+- a normalized workflow state so the session can distinguish `refresh_needed`, `trace_pending`, `review_required`, and `ready_to_continue`.
 
 ### Post-Commit Updates
 
@@ -56,6 +57,7 @@ After `git commit`, the plugin triggers incremental CPG re-parsing via GoCPG and
 - top recommendations
 - one clear next action
 - one suggested command to run next
+- one normalized workflow state
 
 If the durable review trace is not available yet, the plugin still appends a pending summary telling the developer to check `/status` instead of leaving the post-commit state ambiguous.
 

package/package.json

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

package/src/index.ts

@@ -26,6 +26,7 @@ import {
   recommendedCommandFromReviewTrace,
   recommendedNextActionFromReviewTrace,
   readReviewTraceSnapshot,
+  workflowStateFromReviewTrace,
   whatChangedFromReviewTrace,
   whyItMattersFromReviewTrace,
 } from "./util"
@@ -124,6 +125,8 @@ const codegraphPlugin: Plugin = async (input) => {
             output.metadata = {
               ...output.metadata,
               codegraph_review_trace_status: traceSnapshot.status || "unknown",
+              codegraph_review_trace_workflow_state:
+                traceSnapshot.workflow_state || workflowStateFromReviewTrace(traceSnapshot),
               codegraph_review_trace_phase: traceSnapshot.phase || "unknown",
               codegraph_review_trace_findings: traceSnapshot.review_findings_count ?? null,
               codegraph_review_trace_recommendations:
@@ -139,6 +142,7 @@ const codegraphPlugin: Plugin = async (input) => {
             output.metadata = {
               ...output.metadata,
               codegraph_review_trace_status: "pending_or_missing",
+              codegraph_review_trace_workflow_state: "trace_pending",
               codegraph_review_trace_phase: "awaiting_trace",
               codegraph_review_trace_findings: null,
               codegraph_review_trace_recommendations: [],

package/src/util.ts

@@ -14,6 +14,7 @@ export type ReviewTraceSnapshot = {
   review_severity_counts?: Record<string, number>
   review_recommendations?: string[]
   error?: string | null
+  workflow_state?: string
   recommended_command?: string
 }
 
@@ -26,7 +27,9 @@ export type DogfoodStatusSnapshot = {
   }
   head_commit?: string
   review_trace?: ReviewTraceSnapshot | null
+  workflow_state?: string
   recommended_next_action?: string
+  recommended_command?: string
 }
 
 /**
@@ -160,6 +163,7 @@ export function formatPendingReviewTraceSummary(commit: string | null): string {
     "",
     "- Wait briefly for review trace completion, then run `/status` to check the latest result.",
     "- Suggested command: `/status`",
+    "- Workflow state: `trace_pending`",
   ].join("\n")
 }
 
@@ -171,6 +175,7 @@ export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string
   const whyItMatters = whyItMattersFromReviewTrace(snapshot)
   const nextAction = recommendedNextActionFromReviewTrace(snapshot)
   const nextCommand = recommendedCommandFromReviewTrace(snapshot)
+  const workflowState = workflowStateFromReviewTrace(snapshot)
 
   const lines = ["## CodeGraph Post-Commit Summary", ""]
 
@@ -192,6 +197,7 @@ export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string
 
   lines.push("### What to do now", "", `- ${nextAction}`)
   lines.push(`- Suggested command: \`${nextCommand}\``)
+  lines.push(`- Workflow state: \`${workflowState}\``)
 
   return lines.join("\n")
 }
@@ -252,12 +258,12 @@ export function recommendedNextActionFromReviewTrace(snapshot: ReviewTraceSnapsh
     ? snapshot.review_recommendations.filter(Boolean)
     : []
 
+  if (workflowStateFromReviewTrace(snapshot) === "trace_pending") {
+    return "Wait for review trace completion, then inspect findings and recommendations."
+  }
   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."
   }
@@ -273,13 +279,14 @@ export function recommendedNextActionFromReviewTrace(snapshot: ReviewTraceSnapsh
 export function recommendedCommandFromReviewTrace(snapshot: ReviewTraceSnapshot): string {
   const status = (snapshot.status || "").toLowerCase()
   const findingsCount = snapshot.review_findings_count
+  const workflowState = workflowStateFromReviewTrace(snapshot)
 
+  if (workflowState === "trace_pending") {
+    return "/status"
+  }
   if (snapshot.error) {
     return "/review"
   }
-  if (status === "running") {
-    return "/status"
-  }
   if (status && status !== "completed") {
     return "/review"
   }
@@ -289,6 +296,25 @@ export function recommendedCommandFromReviewTrace(snapshot: ReviewTraceSnapshot)
   return "/review"
 }
 
+export function workflowStateFromReviewTrace(snapshot: ReviewTraceSnapshot): string {
+  const status = (snapshot.status || "").toLowerCase()
+  const findingsCount = snapshot.review_findings_count
+
+  if (snapshot.error) {
+    return "review_required"
+  }
+  if (status === "running" || status === "pending_or_missing") {
+    return "trace_pending"
+  }
+  if (status && status !== "completed") {
+    return "review_required"
+  }
+  if (typeof findingsCount === "number" && findingsCount > 0) {
+    return "review_required"
+  }
+  return "ready_to_continue"
+}
+
 export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): string | null {
   const cpg = snapshot.cpg_status || {}
   const isFresh = cpg.is_fresh
@@ -297,6 +323,7 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   const headCommit = snapshot.head_commit ? snapshot.head_commit.slice(0, 12) : null
   const reviewTrace = snapshot.review_trace || null
   const traceStatus = reviewTrace?.status || "missing"
+  const workflowState = snapshot.workflow_state
   const nextAction = snapshot.recommended_next_action
   const nextCommand = (snapshot as { recommended_command?: string }).recommended_command
 
@@ -314,6 +341,9 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
     lines.push(`- HEAD: ${headCommit}`)
   }
   lines.push(`- Review trace: ${traceStatus}`)
+  if (workflowState) {
+    lines.push(`- Workflow state: ${workflowState}`)
+  }
   if (nextAction) {
     lines.push(`- Next action: ${nextAction}`)
   }