opencode-codegraph 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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
+
 ## 0.1.21 - 2026-03-20
 
 - append workflow guidance to the `codegraph_review` custom tool so tool results stay aligned with current dogfooding state

package/README.md

@@ -120,6 +120,7 @@ Place in `.opencode/commands/`:
 | `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.21",
+  "version": "0.1.23",
   "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",
@@ -206,12 +253,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 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")
             output.metadata = {
               ...output.metadata,
               codegraph_after_test_result: testFailed ? "failed" : "passed_or_unknown",
@@ -229,11 +277,12 @@ 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")
             output.metadata = {
               ...output.metadata,
               codegraph_git_workflow_state: status.workflow_state || null,

package/src/util.ts

@@ -33,6 +33,12 @@ export type DogfoodStatusSnapshot = {
     unstaged_changes?: boolean
     untracked_files?: boolean
   }
+  db_maintenance?: {
+    due?: boolean
+    reason?: string
+    db_size_mb?: number
+    recommended_action?: string
+  }
   review_trace?: ReviewTraceSnapshot | null
   workflow_state?: string
   recommended_next_action?: string
@@ -386,6 +392,7 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   const branch = git.branch
   const worktreeClean = git.worktree_clean
   const reviewTrace = snapshot.review_trace || null
+  const maintenance = snapshot.db_maintenance || null
   const traceStatus = reviewTrace?.status || "missing"
   const workflowState = snapshot.workflow_state
   const nextAction = snapshot.recommended_next_action
@@ -410,6 +417,11 @@ export function formatDogfoodStatusSummary(snapshot: DogfoodStatusSnapshot): str
   if (typeof worktreeClean === "boolean") {
     lines.push(`- Worktree clean: ${worktreeClean}`)
   }
+  if (maintenance) {
+    lines.push(
+      `- DB maintenance: ${maintenance.due ? "due" : "ok"} (${maintenance.reason || "unknown"}${typeof maintenance.db_size_mb === "number" ? `, ${maintenance.db_size_mb} MB` : ""})`,
+    )
+  }
   lines.push(`- Review trace: ${traceStatus}`)
   if (workflowState) {
     lines.push(`- Workflow state: ${workflowState}`)
@@ -445,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,