opencode-codegraph 0.1.20 → 0.1.22

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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
+- add `/continue` as a safe guided execution command for refresh/review workflow steps
+
 ## 0.1.20 - 2026-03-20
 
 - append workflow guidance to the `codegraph_review` custom tool so tool results stay aligned with current dogfooding state

package/package.json

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

package/src/index.ts

@@ -22,6 +22,7 @@ import {
   formatDogfoodStatusSummary,
   formatPendingReviewTraceSummary,
   formatReviewTraceSummary,
+  formatReviewTraceUpdateSummary,
   formatWorkflowGuidanceBlock,
   getHeadCommit,
   isGitCommit,
@@ -44,8 +45,20 @@ const codegraphPlugin: Plugin = async (input) => {
   const apiUrl = process.env.CODEGRAPH_API_URL || "http://localhost:8000"
   const api = new CodeGraphAPI(apiUrl)
 
-  // Detect project ID from environment or opencode.json
-  const projectId = process.env.CODEGRAPH_PROJECT || ""
+  // Detect project ID from environment or opencode.json
+  const projectId = process.env.CODEGRAPH_PROJECT || ""
+  let pendingReviewCommit: string | null = null
+
+  const consumePendingReviewTraceUpdate = async (): Promise<string | null> => {
+    if (!pendingReviewCommit) return null
+    const commit = pendingReviewCommit
+    const traceSnapshot = await readReviewTraceSnapshot(directory, commit, 1, 0)
+    if (!traceSnapshot) return null
+    const workflowState = traceSnapshot.workflow_state || workflowStateFromReviewTrace(traceSnapshot)
+    if (workflowState === "trace_pending") return null
+    pendingReviewCommit = null
+    return formatReviewTraceUpdateSummary(traceSnapshot)
+  }
 
   return {
     // -----------------------------------------------------------------
@@ -96,6 +109,14 @@ const codegraphPlugin: Plugin = async (input) => {
       }
 
       try {
+        const pendingUpdate = await consumePendingReviewTraceUpdate()
+        if (pendingUpdate) {
+          output.parts.push({
+            type: "text",
+            text: pendingUpdate,
+          } as any)
+        }
+
         const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
         const statusSummary = formatDogfoodStatusSummary(JSON.parse(rawStatus))
         if (statusSummary) {
@@ -120,6 +141,14 @@ const codegraphPlugin: Plugin = async (input) => {
       if (!files.length && !workflowIntent) return
 
       try {
+        const pendingUpdate = await consumePendingReviewTraceUpdate()
+        if (pendingUpdate) {
+          output.parts.push({
+            type: "text",
+            text: pendingUpdate,
+          } as any)
+        }
+
         if (workflowIntent) {
           try {
             const rawStatus = await $`python -m src.cli.import_commands dogfood status --json`.quiet().text()
@@ -245,6 +274,7 @@ const codegraphPlugin: Plugin = async (input) => {
             }
           } else {
             traceSummary = formatPendingReviewTraceSummary(commit)
+            pendingReviewCommit = commit
             output.metadata = {
               ...output.metadata,
               codegraph_review_trace_status: "pending_or_missing",

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
@@ -257,6 +263,12 @@ export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string
   return lines.join("\n")
 }
 
+export function formatReviewTraceUpdateSummary(snapshot: ReviewTraceSnapshot): string | null {
+  const base = formatReviewTraceSummary(snapshot)
+  if (!base) return null
+  return base.replace("## CodeGraph Post-Commit Summary", "## CodeGraph Review Trace Update")
+}
+
 export function whatChangedFromReviewTrace(snapshot: ReviewTraceSnapshot): string[] {
   const items: string[] = []
   const status = snapshot.status || "unknown"
@@ -380,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
@@ -404,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}`)