opencode-codegraph 0.1.24 → 0.1.26

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.26 - 2026-03-21
+
+- include lock holders, recovery steps, and maintenance action details directly in plugin workflow summaries
+
+## 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

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
@@ -120,9 +120,19 @@ Place in `.opencode/commands/`:
 | 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
+- lock holders / recovery steps when DuckDB is blocked
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codegraph",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "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()
@@ -320,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) {
@@ -362,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

@@ -39,10 +39,22 @@ export type DogfoodStatusSnapshot = {
     db_size_mb?: number
     recommended_action?: string
   }
+  db_lock?: {
+    locked?: boolean
+    holders?: string[]
+    recovery?: string[]
+  }
   review_trace?: ReviewTraceSnapshot | null
   workflow_state?: string
   recommended_next_action?: string
   recommended_command?: string
+  blockers?: string[]
+  warnings?: string[]
+  closure?: {
+    what_improved?: string
+    still_blocked?: string
+    before_push?: string
+  }
 }
 
 /**
@@ -393,10 +405,14 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   const worktreeClean = git.worktree_clean
   const reviewTrace = snapshot.review_trace || null
   const maintenance = snapshot.db_maintenance || null
+  const dbLock = snapshot.db_lock || 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
+  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
@@ -421,6 +437,19 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
     lines.push(
       `- DB maintenance: ${maintenance.due ? "due" : "ok"} (${maintenance.reason || "unknown"}${typeof maintenance.db_size_mb === "number" ? `, ${maintenance.db_size_mb} MB` : ""})`,
     )
+    if (maintenance.recommended_action) {
+      lines.push(`- DB maintenance action: ${maintenance.recommended_action}`)
+    }
+  }
+  if (dbLock?.locked) {
+    const holders = Array.isArray(dbLock.holders) ? dbLock.holders.filter(Boolean) : []
+    const recovery = Array.isArray(dbLock.recovery) ? dbLock.recovery.filter(Boolean) : []
+    if (holders.length) {
+      lines.push(`- DB lock holders: ${holders.join("; ")}`)
+    }
+    if (recovery.length) {
+      lines.push(`- DB lock recovery: ${recovery.join("; ")}`)
+    }
   }
   lines.push(`- Review trace: ${traceStatus}`)
   if (workflowState) {
@@ -432,6 +461,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 +483,13 @@ 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 || {}
+  const dbLock = snapshot.db_lock || null
+  const maintenance = snapshot.db_maintenance || null
 
-  if (!workflowState && !nextAction && !nextCommand) {
+  if (!workflowState && !nextAction && !nextCommand && !blockers.length && !warnings.length) {
     return null
   }
 
@@ -454,6 +503,34 @@ 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}`)
+  }
+  if (maintenance?.recommended_action) {
+    lines.push(`- Maintenance action: ${maintenance.recommended_action}`)
+  }
+  if (dbLock?.locked) {
+    const holders = Array.isArray(dbLock.holders) ? dbLock.holders.filter(Boolean) : []
+    const recovery = Array.isArray(dbLock.recovery) ? dbLock.recovery.filter(Boolean) : []
+    if (holders.length) {
+      lines.push(`- Lock holders: ${holders.join("; ")}`)
+    }
+    if (recovery.length) {
+      lines.push(`- Lock recovery: ${recovery.join("; ")}`)
+    }
+  }
   return lines.join("\n")
 }
 
@@ -510,6 +587,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")
 }