opencode-codegraph 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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
+
 ## 0.1.22 - 2026-03-20
 
 - add DuckDB maintenance guidance and `/maintain-db` workflow command for local database compaction

package/README.md

@@ -117,9 +117,11 @@ 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` |
+| `db_locked` recovery path | Surface lock-holder-aware recovery guidance when DuckDB is blocked by another process |
 | `permission.ask` | Auto-allow `codegraph_*` tools |
 
 ## License

package/package.json

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

package/src/index.ts

@@ -23,6 +23,7 @@ import {
   formatPendingReviewTraceSummary,
   formatReviewTraceSummary,
   formatReviewTraceUpdateSummary,
+  formatWorkflowStateTransition,
   formatWorkflowGuidanceBlock,
   getHeadCommit,
   isGitCommit,
@@ -48,6 +49,32 @@ const codegraphPlugin: Plugin = async (input) => {
   // Detect project ID from environment or opencode.json
   const projectId = process.env.CODEGRAPH_PROJECT || ""
   let pendingReviewCommit: string | null = null
+  let lastWorkflowState: string | null = null
+
+  const workflowFields = (status: Record<string, unknown>) => {
+    const workflowState = typeof status.workflow_state === "string" ? status.workflow_state : null
+    const nextAction =
+      typeof status.recommended_next_action === "string" ? status.recommended_next_action : undefined
+    const nextCommand =
+      typeof status.recommended_command === "string" ? status.recommended_command : undefined
+    return { workflowState, nextAction, nextCommand }
+  }
+
+  const captureWorkflowState = (status: Record<string, unknown>) => {
+    const { workflowState } = workflowFields(status)
+    if (workflowState) {
+      lastWorkflowState = workflowState
+    }
+  }
+
+  const workflowTransition = (status: Record<string, unknown>) => {
+    const { workflowState, nextAction, nextCommand } = workflowFields(status)
+    const message = formatWorkflowStateTransition(lastWorkflowState, workflowState, nextAction, nextCommand)
+    if (workflowState) {
+      lastWorkflowState = workflowState
+    }
+    return message
+  }
 
   const consumePendingReviewTraceUpdate = async (): Promise<string | null> => {
     if (!pendingReviewCommit) return null
@@ -67,10 +94,12 @@ const codegraphPlugin: Plugin = async (input) => {
     "experimental.chat.system.transform": async (_inp, output) => {
       try {
         const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
-        const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
+        const status = JSON.parse(rawStatus)
+        const statusSummary = formatDogfoodStatusSummary(status)
         if (statusSummary) {
           output.system.push(statusSummary)
         }
+        captureWorkflowState(status)
       } catch {
         // Dogfooding status unavailable — keep session startup lightweight
       }
@@ -91,10 +120,12 @@ const codegraphPlugin: Plugin = async (input) => {
     "experimental.session.compacting": async (_inp, output) => {
       try {
         const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
-        const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
+        const status = JSON.parse(rawStatus)
+        const statusSummary = formatDogfoodStatusSummary(status)
         if (statusSummary) {
           output.context.push(statusSummary)
         }
+        captureWorkflowState(status)
       } catch {
         // Keep compaction resilient if status lookup fails
       }
@@ -118,7 +149,15 @@ const codegraphPlugin: Plugin = async (input) => {
         }
 
         const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
-        const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
+        const status = JSON.parse(rawStatus)
+        const transition = workflowTransition(status)
+        if (transition) {
+          output.parts.push({
+            type: "text",
+            text: transition,
+          } as any)
+        }
+        const statusSummary = formatDogfoodStatusSummary(status)
         if (statusSummary) {
           output.parts.push({
             type: "text",
@@ -152,7 +191,15 @@ const codegraphPlugin: Plugin = async (input) => {
         if (workflowIntent) {
           try {
             const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
-            const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
+            const status = JSON.parse(rawStatus)
+            const transition = workflowTransition(status)
+            if (transition) {
+              output.parts.push({
+                type: "text",
+                text: transition,
+              } as any)
+            }
+            const statusSummary = formatDogfoodStatusSummary(status)
             if (statusSummary) {
               output.parts.push({
                 type: "text",
@@ -201,17 +248,20 @@ 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 {
           const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
           const status = JSON.parse(rawStatus)
+          const transition = workflowTransition(status)
           const testFailed = didTestCommandFail(output.output)
           const guidance = formatAfterTestGuidance(status, testFailed)
           if (guidance) {
             output.title = "CodeGraph: after-test guidance ready"
             const existingOutput = output.output?.trimEnd() || ""
-            output.output = existingOutput ? `${existingOutput}\n\n${guidance}` : guidance
+            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",
@@ -229,11 +279,13 @@ 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)
+          const transition = workflowTransition(status)
           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.output = [existingOutput, transition || "", guidance].filter(Boolean).join("\n\n")
+            appendedWorkflowGuidance = true
             output.metadata = {
               ...output.metadata,
               codegraph_git_workflow_state: status.workflow_state || null,
@@ -246,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 {

package/src/util.ts

@@ -457,6 +457,31 @@ export function formatWorkflowGuidanceBlock(snapshot: DogfoodStatusSnapshot): st
   return lines.join("\n")
 }
 
+export function formatWorkflowStateTransition(
+  previousState: string | null,
+  currentState: string | null,
+  nextAction: string | undefined,
+  nextCommand: string | undefined,
+): string | null {
+  if (!previousState || !currentState || previousState === currentState) {
+    return null
+  }
+
+  const lines = [
+    "## CodeGraph Workflow Update",
+    "",
+    `- Workflow state changed: ${previousState} -> ${currentState}`,
+  ]
+
+  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,