opencode-codegraph 0.1.23 → 0.1.25

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.25 - 2026-03-21
+
+- append full workflow guidance alongside post-commit review summaries so commit-time output matches the normalized status contract more closely
+
+## 0.1.24 - 2026-03-20
+
+- surface workflow-state transitions after later bash interactions so async state changes become visible without waiting for explicit status checks
+
 ## 0.1.23 - 2026-03-20
 
 - surface workflow-state transitions on later interactions so async status changes become visible without waiting for a fresh session

package/README.md

@@ -54,7 +54,7 @@ Every conversation includes:
 
 ### 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 structured post-commit block with:
+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 structured post-commit block plus the current workflow guidance with:
 
 - what changed in the review trace
 - why it matters
@@ -117,11 +117,21 @@ 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 |
+| generic `tool.execute.after` | Surface workflow-state transitions after other bash commands when the underlying state changes |
 | `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` |
+| `command.execute.before` | Inject current dogfooding status into `/review`, `/audit`, `/update`, `/status`, `/next`, `/continue`, `/maintain-db`, and `/unlock-db` |
 | `db_locked` recovery path | Surface lock-holder-aware recovery guidance when DuckDB is blocked by another process |
 | `permission.ask` | Auto-allow `codegraph_*` tools |
+
+Across status-oriented surfaces, the plugin is converging on one shared summary contract:
+
+- workflow state
+- blockers
+- warnings
+- what improved
+- still blocked
+- recommended command
 
 ## License
 

package/package.json

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

package/src/index.ts

@@ -135,7 +135,7 @@ const codegraphPlugin: Plugin = async (input) => {
     // 1c. Command execution: inject current dogfooding status into guided commands
     // -----------------------------------------------------------------
     "command.execute.before": async (inp, output) => {
-      if (!["review", "audit", "update", "status", "next"].includes(inp.command)) {
+      if (!["review", "audit", "update", "status", "next", "continue", "maintain-db", "unlock-db"].includes(inp.command)) {
         return
       }
 
@@ -177,7 +177,7 @@ const codegraphPlugin: Plugin = async (input) => {
       const editIntent = messageSuggestsEditing(output.parts)
       const workflowIntent = messageSuggestsWorkflowGuidance(output.parts)
 
-      if (!files.length && !workflowIntent) return
+      if (!files.length && !workflowIntent && !pendingReviewCommit) return
 
       try {
         const pendingUpdate = await consumePendingReviewTraceUpdate()
@@ -248,6 +248,7 @@ const codegraphPlugin: Plugin = async (input) => {
     "tool.execute.after": async (inp, output) => {
       if (inp.tool !== "bash") return
       const command = typeof inp.args?.command === "string" ? inp.args.command : ""
+      let appendedWorkflowGuidance = false
 
       if (isTestCommand(command)) {
         try {
@@ -260,6 +261,7 @@ const codegraphPlugin: Plugin = async (input) => {
             output.title = "CodeGraph: after-test guidance ready"
             const existingOutput = output.output?.trimEnd() || ""
             output.output = [existingOutput, transition || "", guidance].filter(Boolean).join("\n\n")
+            appendedWorkflowGuidance = true
             output.metadata = {
               ...output.metadata,
               codegraph_after_test_result: testFailed ? "failed" : "passed_or_unknown",
@@ -283,6 +285,7 @@ const codegraphPlugin: Plugin = async (input) => {
             output.title = "CodeGraph: git workflow guidance ready"
             const existingOutput = output.output?.trimEnd() || ""
             output.output = [existingOutput, transition || "", guidance].filter(Boolean).join("\n\n")
+            appendedWorkflowGuidance = true
             output.metadata = {
               ...output.metadata,
               codegraph_git_workflow_state: status.workflow_state || null,
@@ -295,6 +298,21 @@ const codegraphPlugin: Plugin = async (input) => {
         }
       }
 
+      if (!appendedWorkflowGuidance) {
+        try {
+          const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
+          const status = JSON.parse(rawStatus)
+          const transition = workflowTransition(status)
+          if (transition) {
+            output.title = "CodeGraph: workflow update detected"
+            const existingOutput = output.output?.trimEnd() || ""
+            output.output = [existingOutput, transition].filter(Boolean).join("\n\n")
+          }
+        } catch {
+          // Best-effort guidance only
+        }
+      }
+
       if (!isGitCommit(output.output)) return
 
       try {
@@ -302,6 +320,7 @@ const codegraphPlugin: Plugin = async (input) => {
         await api.triggerIncrementalUpdate(projectId, directory)
 
         let traceSummary: string | null = null
+        let workflowGuidance: string | null = null
         if (commit) {
           const traceSnapshot = await readReviewTraceSnapshot(directory, commit)
           if (traceSnapshot) {
@@ -344,17 +363,27 @@ const codegraphPlugin: Plugin = async (input) => {
           }
         }
 
+        try {
+          const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
+          const status = JSON.parse(rawStatus)
+          workflowGuidance = formatWorkflowGuidanceBlock(status)
+        } catch {
+          // keep commit flow resilient if unified status is unavailable
+        }
+
         // Notify user via output metadata (visible in OpenCode UI)
-        output.title = traceSummary
+        output.title = traceSummary || workflowGuidance
           ? "CodeGraph: post-commit review summary ready"
           : "CodeGraph: CPG update triggered"
         output.metadata = {
           ...output.metadata,
           codegraph_cpg_update: "triggered",
         }
-        if (traceSummary) {
+        if (traceSummary || workflowGuidance) {
           const existingOutput = output.output?.trimEnd() || ""
-          output.output = existingOutput ? `${existingOutput}\n\n${traceSummary}` : traceSummary
+          output.output = [existingOutput, traceSummary || "", workflowGuidance || ""]
+            .filter(Boolean)
+            .join("\n\n")
         }
       } catch {
         // Best-effort — don't break the workflow

package/src/util.ts

@@ -43,6 +43,13 @@ export type DogfoodStatusSnapshot = {
   workflow_state?: string
   recommended_next_action?: string
   recommended_command?: string
+  blockers?: string[]
+  warnings?: string[]
+  closure?: {
+    what_improved?: string
+    still_blocked?: string
+    before_push?: string
+  }
 }
 
 /**
@@ -397,6 +404,9 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   const workflowState = snapshot.workflow_state
   const nextAction = snapshot.recommended_next_action
   const nextCommand = (snapshot as { recommended_command?: string }).recommended_command
+  const blockers = Array.isArray(snapshot.blockers) ? snapshot.blockers.filter(Boolean) : []
+  const warnings = Array.isArray(snapshot.warnings) ? snapshot.warnings.filter(Boolean) : []
+  const closure = snapshot.closure || {}
 
   if (typeof isFresh === "undefined" && !headCommit && !nextAction) {
     return null
@@ -432,6 +442,21 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   if (nextCommand) {
     lines.push(`- Suggested command: ${nextCommand}`)
   }
+  if (blockers.length) {
+    lines.push(`- Blockers: ${blockers.join("; ")}`)
+  }
+  if (warnings.length) {
+    lines.push(`- Warnings: ${warnings.join("; ")}`)
+  }
+  if (closure.what_improved) {
+    lines.push(`- What improved: ${closure.what_improved}`)
+  }
+  if (closure.still_blocked) {
+    lines.push(`- Still blocked: ${closure.still_blocked}`)
+  }
+  if (closure.before_push) {
+    lines.push(`- Before push: ${closure.before_push}`)
+  }
   return lines.join("\n")
 }
 
@@ -439,8 +464,11 @@ export function formatWorkflowGuidanceBlock(snapshot: DogfoodStatusSnapshot): st
   const workflowState = snapshot.workflow_state
   const nextAction = snapshot.recommended_next_action
   const nextCommand = snapshot.recommended_command
+  const blockers = Array.isArray(snapshot.blockers) ? snapshot.blockers.filter(Boolean) : []
+  const warnings = Array.isArray(snapshot.warnings) ? snapshot.warnings.filter(Boolean) : []
+  const closure = snapshot.closure || {}
 
-  if (!workflowState && !nextAction && !nextCommand) {
+  if (!workflowState && !nextAction && !nextCommand && !blockers.length && !warnings.length) {
     return null
   }
 
@@ -454,6 +482,21 @@ export function formatWorkflowGuidanceBlock(snapshot: DogfoodStatusSnapshot): st
   if (nextCommand) {
     lines.push(`- Suggested command: ${nextCommand}`)
   }
+  if (blockers.length) {
+    lines.push(`- Blockers: ${blockers.join("; ")}`)
+  }
+  if (warnings.length) {
+    lines.push(`- Warnings: ${warnings.join("; ")}`)
+  }
+  if (closure.what_improved) {
+    lines.push(`- What improved: ${closure.what_improved}`)
+  }
+  if (closure.still_blocked) {
+    lines.push(`- Still blocked: ${closure.still_blocked}`)
+  }
+  if (closure.before_push) {
+    lines.push(`- Before push: ${closure.before_push}`)
+  }
   return lines.join("\n")
 }
 
@@ -510,6 +553,24 @@ export function formatAfterTestGuidance(
   if (nextCommand) {
     lines.push(`- Suggested command: ${nextCommand}`)
   }
+  const blockers = Array.isArray(snapshot.blockers) ? snapshot.blockers.filter(Boolean) : []
+  const warnings = Array.isArray(snapshot.warnings) ? snapshot.warnings.filter(Boolean) : []
+  const closure = snapshot.closure || {}
+  if (blockers.length) {
+    lines.push(`- Blockers: ${blockers.join("; ")}`)
+  }
+  if (warnings.length) {
+    lines.push(`- Warnings: ${warnings.join("; ")}`)
+  }
+  if (closure.what_improved) {
+    lines.push(`- What improved: ${closure.what_improved}`)
+  }
+  if (closure.still_blocked) {
+    lines.push(`- Still blocked: ${closure.still_blocked}`)
+  }
+  if (closure.before_push) {
+    lines.push(`- Before push: ${closure.before_push}`)
+  }
   return lines.join("\n")
 }