opencode-codegraph 0.1.2 → 0.1.3

package/package.json

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

package/src/index.ts

@@ -10,11 +10,17 @@
  * - Toast notifications on CPG update completion
  */
 
-import type { Plugin } from "@opencode-ai/plugin"
-import { tool } from "@opencode-ai/plugin/tool"
-
-import { CodeGraphAPI } from "./api"
-import { extractFileRefs, isGitCommit } from "./util"
+import type { Plugin } from "@opencode-ai/plugin"
+import { tool } from "@opencode-ai/plugin/tool"
+
+import { CodeGraphAPI } from "./api"
+import {
+  extractFileRefs,
+  formatReviewTraceSummary,
+  getHeadCommit,
+  isGitCommit,
+  readReviewTraceSnapshot,
+} from "./util"
 
 const codegraphPlugin: Plugin = async (input) => {
   const { client, directory, $ } = input
@@ -66,21 +72,45 @@ const codegraphPlugin: Plugin = async (input) => {
     // -----------------------------------------------------------------
     // 3. Post-commit: trigger incremental CPG update
     // -----------------------------------------------------------------
-    "tool.execute.after": async (inp, output) => {
-      if (inp.tool !== "bash") return
-      if (!isGitCommit(output.output)) return
-
-      try {
-        await api.triggerIncrementalUpdate(projectId, directory)
-        // Notify user via output metadata (visible in OpenCode UI)
-        output.title = "CodeGraph: CPG update triggered"
-        output.metadata = {
-          ...output.metadata,
-          codegraph_cpg_update: "triggered",
-        }
-      } catch {
-        // Best-effort — don't break the workflow
-      }
+    "tool.execute.after": async (inp, output) => {
+      if (inp.tool !== "bash") return
+      if (!isGitCommit(output.output)) return
+
+      try {
+        const commit = await getHeadCommit($)
+        await api.triggerIncrementalUpdate(projectId, directory)
+
+        let traceSummary: string | null = null
+        if (commit) {
+          const traceSnapshot = await readReviewTraceSnapshot(directory, commit)
+          if (traceSnapshot) {
+            traceSummary = formatReviewTraceSummary(traceSnapshot)
+            output.metadata = {
+              ...output.metadata,
+              codegraph_review_trace_status: traceSnapshot.status || "unknown",
+              codegraph_review_trace_phase: traceSnapshot.phase || "unknown",
+              codegraph_review_trace_findings: traceSnapshot.review_findings_count ?? null,
+              codegraph_review_trace_recommendations:
+                traceSnapshot.review_recommendations?.slice(0, 3) || [],
+            }
+          }
+        }
+
+        // Notify user via output metadata (visible in OpenCode UI)
+        output.title = traceSummary
+          ? "CodeGraph: CPG update triggered + review trace found"
+          : "CodeGraph: CPG update triggered"
+        output.metadata = {
+          ...output.metadata,
+          codegraph_cpg_update: "triggered",
+        }
+        if (traceSummary) {
+          const existingOutput = output.output?.trimEnd() || ""
+          output.output = existingOutput ? `${existingOutput}\n\n${traceSummary}` : traceSummary
+        }
+      } catch {
+        // Best-effort — don't break the workflow
+      }
     },
 
     // -----------------------------------------------------------------

package/src/util.ts

@@ -1,6 +1,20 @@
-/**
- * Utility functions for the CodeGraph OpenCode plugin.
- */
+import { readFile } from "node:fs/promises"
+import path from "node:path"
+
+/**
+ * Utility functions for the CodeGraph OpenCode plugin.
+ */
+
+export type ReviewTraceSnapshot = {
+  commit?: string
+  status?: string
+  phase?: string
+  updated_at?: string
+  review_findings_count?: number
+  review_severity_counts?: Record<string, number>
+  review_recommendations?: string[]
+  error?: string | null
+}
 
 /**
  * Extract file references from message parts.
@@ -43,7 +57,7 @@ export function extractFileRefs(parts: Array<{ type: string; text?: string }>):
 /**
  * Check if a shell command output indicates a git commit was made.
  */
-export function isGitCommit(output: string): boolean {
+export function isGitCommit(output: string): boolean {
   if (!output) return false
 
   // Common git commit success patterns
@@ -52,10 +66,77 @@ export function isGitCommit(output: string): boolean {
     /^\s*create mode/m.test(output) || // create mode 100644
     /^\s*\d+ files? changed/m.test(output) // 3 files changed, 42 insertions
   )
-}
-
-// File extensions recognized as source code
-const SOURCE_EXTENSIONS = new Set([
+}
+
+export async function getHeadCommit($: any): Promise<string | null> {
+  try {
+    const sha = (await $`git rev-parse HEAD`.quiet().text()).trim()
+    return sha || null
+  } catch {
+    return null
+  }
+}
+
+export async function readReviewTraceSnapshot(
+  directory: string,
+  commit: string,
+  attempts = 4,
+  delayMs = 500,
+): Promise<ReviewTraceSnapshot | null> {
+  const statusPath = path.join(directory, "data", "reviews", `${commit}.status.json`)
+
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    try {
+      const raw = await readFile(statusPath, "utf-8")
+      return JSON.parse(raw) as ReviewTraceSnapshot
+    } catch {
+      if (attempt === attempts - 1) return null
+      await new Promise((resolve) => setTimeout(resolve, delayMs))
+    }
+  }
+
+  return null
+}
+
+export function formatReviewTraceSummary(snapshot: ReviewTraceSnapshot): string | null {
+  const status = snapshot.status || "unknown"
+  const phase = snapshot.phase || "unknown"
+  const findingsCount = snapshot.review_findings_count
+  const recommendations = Array.isArray(snapshot.review_recommendations)
+    ? snapshot.review_recommendations.filter(Boolean)
+    : []
+
+  const lines = ["## CodeGraph Review Trace", "", `- Status: ${status}`, `- Phase: ${phase}`]
+
+  if (typeof findingsCount === "number") {
+    lines.push(`- Findings: ${findingsCount}`)
+  }
+
+  const severityCounts = snapshot.review_severity_counts || {}
+  const severitySummary = Object.entries(severityCounts)
+    .filter(([, count]) => typeof count === "number" && count > 0)
+    .map(([severity, count]) => `${severity}:${count}`)
+    .join(", ")
+  if (severitySummary) {
+    lines.push(`- Severity: ${severitySummary}`)
+  }
+
+  if (snapshot.error) {
+    lines.push(`- Error: ${snapshot.error}`)
+  }
+
+  if (recommendations.length) {
+    lines.push("", "### Recommendations")
+    for (const recommendation of recommendations.slice(0, 3)) {
+      lines.push(`- ${recommendation}`)
+    }
+  }
+
+  return lines.length > 2 ? lines.join("\n") : null
+}
+
+// File extensions recognized as source code
+const SOURCE_EXTENSIONS = new Set([
   "py",
   "go",
   "js",