@boyingliu01/opencode-plugin 0.9.2 → 0.9.3

package/index.ts

@@ -1,8 +1,8 @@
 import { tool } from "@opencode-ai/plugin"
 import { z } from "zod"
-import { exec } from "child_process"
-import { promisify } from "util"
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs"
+import { exec, execSync } from "node:child_process"
+import { promisify } from "node:util"
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs"
 import { join } from "node:path"
 import { homedir } from "node:os"
 
@@ -13,6 +13,158 @@ interface OpenCodePluginInput {
   $: (strings: TemplateStringsArray, ...values: unknown[]) => Promise<{ text(): Promise<string> }>
 }
 
+// ── Constants ──
+
+const CACHE_TTL_MS = 86_400_000 // 24h
+const FETCH_TIMEOUT_MS = 5_000
+
+const XP_GATE_NPM_PKG = "@boyingliu01/xp-gate"
+const XP_GATE_CACHE_FILE = join(homedir(), ".xp-gate", "xp-gate-version-check.json")
+const XP_GATE_REGISTRY_URL = `https://registry.npmjs.org/-/package/${encodeURIComponent(XP_GATE_NPM_PKG)}/dist-tags`
+
+const OPENCODE_PLUGIN_REGISTRY = "https://registry.npmjs.org/-/package/@boyingliu01%2Fopencode-plugin/dist-tags"
+const OPENCODE_CACHE_FILE = join(homedir(), ".xp-gate", "opencode-plugin-version-check.json")
+
+let checked = false
+
+// ── Utilities ──
+
+function semverLt(a: string, b: string): boolean {
+  const pa = a.replace(/^v/, "").split(".").map(Number)
+  const pb = b.replace(/^v/, "").split(".").map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0
+    const nb = pb[i] ?? 0
+    if (na !== nb) return na < nb
+  }
+  return false
+}
+
+async function fetchNpmLatestVersion(url: string): Promise<string | null> {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
+  try {
+    const response = await fetch(url, { signal: controller.signal })
+    if (!response.ok) return null
+    const data: Record<string, unknown> = await response.json()
+    return typeof data.latest === "string" ? data.latest : null
+  } catch {
+    return null
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+function readCache(file: string): { ts: number; remoteVersion: string; status?: string } | null {
+  try {
+    if (!existsSync(file)) return null
+    const raw = readFileSync(file, "utf8")
+    const data = JSON.parse(raw)
+    if (Date.now() - data.ts < CACHE_TTL_MS && data.remoteVersion) return data
+    return null
+  } catch {
+    return null
+  }
+}
+
+function writeCache(file: string, data: object): void {
+  try {
+    mkdirSync(join(homedir(), ".xp-gate"), { recursive: true })
+    writeFileSync(file + ".tmp", JSON.stringify(data), "utf8")
+    try { rmSync(file) } catch {}
+    writeFileSync(file, readFileSync(file + ".tmp", "utf8"), "utf8")
+    try { rmSync(file + ".tmp") } catch {}
+  } catch {
+    // silent
+  }
+}
+
+// ── XP-Gate npm package auto-update ──
+
+type UpgradeResult = {
+  action: "noop" | "upgraded" | "error"
+  localVersion: string | null
+  remoteVersion: string | null
+  error?: string
+}
+
+function getLocalXpGateVersion(): string | null {
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf8" }).trim()
+    const pkg = JSON.parse(readFileSync(join(globalRoot, XP_GATE_NPM_PKG, "package.json"), "utf8"))
+    return pkg.version || null
+  } catch {
+    return null
+  }
+}
+
+async function checkXpGateUpdate(): Promise<UpgradeResult> {
+  const cached = readCache(XP_GATE_CACHE_FILE)
+  if (cached?.status === "current" && cached.remoteVersion) {
+    return { action: "noop", localVersion: cached.remoteVersion, remoteVersion: cached.remoteVersion }
+  }
+
+  const localVersion = getLocalXpGateVersion()
+  if (!localVersion) return { action: "noop", localVersion: null, remoteVersion: null }
+
+  const remoteVersion = await fetchNpmLatestVersion(XP_GATE_REGISTRY_URL)
+  if (!remoteVersion) return { action: "noop", localVersion, remoteVersion: null }
+
+  if (!semverLt(localVersion, remoteVersion)) {
+    writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion, status: "current" })
+    return { action: "noop", localVersion, remoteVersion }
+  }
+
+  writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion })
+  try {
+    execSync(`npm install -g ${XP_GATE_NPM_PKG}@${remoteVersion}`, { stdio: "pipe", timeout: 120_000 })
+    writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion: remoteVersion, remoteVersion, status: "current" })
+    return { action: "upgraded", localVersion, remoteVersion }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    return { action: "error", localVersion, remoteVersion, error: msg }
+  }
+}
+
+// ── OpenCode plugin version check (notification only) ──
+
+async function checkPluginUpdate(pluginDir: string): Promise<void> {
+  const cached = readCache(OPENCODE_CACHE_FILE)
+  if (cached?.status === "current" && cached.remoteVersion) return
+
+  let localVersion = ""
+  try {
+    const pkg = JSON.parse(readFileSync(join(pluginDir, "package.json"), "utf8"))
+    localVersion = pkg.version || ""
+  } catch {
+    return
+  }
+
+  const remoteVersion = await fetchNpmLatestVersion(OPENCODE_PLUGIN_REGISTRY)
+  if (!remoteVersion) return
+
+  if (remoteVersion && localVersion && semverLt(localVersion, remoteVersion)) {
+    writeCache(OPENCODE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion })
+  } else if (remoteVersion && localVersion) {
+    writeCache(OPENCODE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion, status: "current" })
+  }
+}
+
+// ── Combined background check (runs once on first chat.message) ──
+
+async function runBackgroundUpdates(pluginDir: string): Promise<string | null> {
+  const result = await checkXpGateUpdate()
+  await checkPluginUpdate(pluginDir)
+
+  if (result.action === "upgraded") {
+    return `[XP-Gate] Auto-upgraded from v${result.localVersion} to v${result.remoteVersion}`
+  }
+  if (result.action === "error") {
+    return `[XP-Gate] Upgrade check: v${result.remoteVersion} available (auto-upgrade failed: ${result.error})`
+  }
+  return null
+}
+
 async function runCmd(cmd: string, cwd: string): Promise<string> {
   try {
     const { stdout } = await execAsync(cmd, { cwd, timeout: 30000 })
@@ -49,77 +201,6 @@ async function getUpgradeSuggestion(cwd: string): Promise<string> {
   }
 }
 
-// ── Auto-update check for opencode-plugin ──
-
-const CACHE_TTL_MS = 86_400_000
-const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/@boyingliu01%2Fopencode-plugin/dist-tags"
-const FETCH_TIMEOUT_MS = 5_000
-const CACHE_FILE = join(homedir(), ".xp-gate", "opencode-plugin-version-check.json")
-
-let checked = false
-let checkInFlight: Promise<void> | null = null
-
-function semverLt(a: string, b: string): boolean {
-  const pa = a.replace(/^v/, "").split(".").map(Number)
-  const pb = b.replace(/^v/, "").split(".").map(Number)
-  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-    const na = pa[i] ?? 0
-    const nb = pb[i] ?? 0
-    if (na !== nb) return na < nb
-  }
-  return false
-}
-
-async function checkPluginUpdate(pluginDir: string): Promise<void> {
-  if (checkInFlight) return
-
-  checkInFlight = (async () => {
-    try {
-      mkdirSync(join(homedir(), ".xp-gate"), { recursive: true })
-
-      if (existsSync(CACHE_FILE)) {
-        const cached = JSON.parse(readFileSync(CACHE_FILE, "utf8"))
-        if (Date.now() - cached.ts < CACHE_TTL_MS) return
-      }
-
-      let localVersion = ""
-      try {
-        const pkg = JSON.parse(readFileSync(join(pluginDir, "package.json"), "utf8"))
-        localVersion = pkg.version || ""
-      } catch {
-        return
-      }
-
-      const controller = new AbortController()
-      const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
-      try {
-        const response = await fetch(NPM_REGISTRY_URL, { signal: controller.signal })
-        if (!response.ok) return
-        const data: Record<string, unknown> = await response.json()
-        const remoteVersion = String(data.latest || "")
-
-        if (remoteVersion && localVersion && semverLt(localVersion, remoteVersion)) {
-          writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), localVersion, remoteVersion }))
-          process.stderr.write(
-            `[XP-Gate] New opencode-plugin version v${remoteVersion} available (you have v${localVersion})\n` +
-            `[XP-Gate] Update with: cd ~/.config/opencode && npm update @boyingliu01/opencode-plugin\n`
-          )
-        } else if (remoteVersion && localVersion) {
-          // Cache "up to date" to avoid re-fetching every session
-          writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), localVersion, remoteVersion, status: "current" }))
-        }
-      } finally {
-        clearTimeout(timer)
-      }
-    } catch {
-      // All errors silently ignored
-    }
-  })()
-
-  await checkInFlight
-  checkInFlight = null
-}
-
 // ── Plugin definition ──
 
 export const XpGatePlugin = async (input: OpenCodePluginInput) => {
@@ -184,7 +265,9 @@ export const XpGatePlugin = async (input: OpenCodePluginInput) => {
     "chat.message": async (_input: { message: string }) => {
       if (!checked) {
         checked = true
-        checkPluginUpdate(directory).catch((_err) => { /* silent: non-critical background check */ })
+        runBackgroundUpdates(directory).then((msg) => {
+          if (msg) process.stderr.write(`${msg}\n`)
+        })
       }
       return { action: "continue" }
     },

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "type": "module",
   "main": "index.ts",
-  "description": "XP-Gate quality gates + AI workflow skills for OpenCode",
+  "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",
   "repository": {
     "type": "git",
     "url": "https://github.com/boyingliu01/xp-gate",
@@ -13,8 +13,19 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./tui": {
+      "import": "./tui-plugin.ts",
+      "types": "./tui-plugin.ts"
+    }
+  },
   "files": [
     "index.ts",
+    "tui-plugin.ts",
     "skills/",
     "tsconfig.json",
     "README.md"
@@ -24,7 +35,7 @@
     "check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.15.0"
+    "@opencode-ai/plugin": "^1.17.8"
   },
   "devDependencies": {
     "typescript": "^5.4.0"

package/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP. Phase 2 default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE in Phase 1: design must pass Delphi review (≥90% consensus) before any coding.

package/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/tsconfig.json

@@ -10,6 +10,6 @@
     "declaration": false,
     "noEmit": true
   },
-  "include": ["index.ts"],
+  "include": ["index.ts", "tui-plugin.ts"],
   "exclude": ["node_modules", "dist", "skills"]
 }

package/tui-plugin.ts

@@ -0,0 +1,188 @@
+/**
+ * XP-Gate OpenCode TUI Slot Plugin
+ *
+ * Registers sidebar_content slot to display Sprint Flow progress
+ * from .sprint-state/sprint-state.json.
+ *
+ * This is a separate plugin file because SDK 1.x PluginModule does not
+ * support server + tui in the same module. Users register this file
+ * in ~/.config/opencode/tui.json as:
+ *   { "plugin": ["@boyingliu01/opencode-plugin/tui"] }
+ *
+ * The npm package exports "./tui" from package.json for this resolution.
+ */
+
+import { existsSync, readFileSync } from "node:fs"
+import { join } from "node:path"
+import type { TuiPlugin, TuiSlotPlugin, TuiSlotProps } from "@opencode-ai/plugin/tui"
+
+// ── Sprint state schema ──
+
+interface SprintReq {
+  name?: string
+  status?: "completed" | "in_progress" | "pending"
+}
+
+interface SprintPhaseHistory {
+  phase: number | string
+  phase_name?: string
+  status?: "completed" | "in_progress" | "pending"
+  started_at?: string
+  completed_at?: string
+  duration_seconds?: number
+  reqs?: Record<string, SprintReq>
+}
+
+interface SprintState {
+  id?: string
+  phase?: number | string
+  status?: string
+  started_at?: string
+  task_description?: string
+  isolation?: { branch?: string; worktree_path?: string }
+  metrics?: { tests_passed?: number; tests_failed?: number; coverage_pct?: number }
+  phase_history?: SprintPhaseHistory[]
+}
+
+// ── Constants ──
+
+const PHASE_NAMES: Record<string, string> = {
+  "-1": "ISOLATE",
+  "-0.5": "AUTO-ESTIMATE",
+  "0": "THINK",
+  "1": "PLAN",
+  "2": "BUILD",
+  "3": "REVIEW",
+  "4": "USER ACCEPT",
+  "5": "FEEDBACK",
+  "6": "SHIP",
+  "7": "LAND",
+  "8": "CLEANUP",
+}
+
+const PHASE_ORDER = ["-1", "-0.5", "0", "1", "2", "3", "4", "5", "6", "7", "8"]
+
+// ── Helpers ──
+
+function readSprintState(dir: string): SprintState | null {
+  try {
+    const stateFile = join(dir, ".sprint-state", "sprint-state.json")
+    if (!existsSync(stateFile)) return null
+    return JSON.parse(readFileSync(stateFile, "utf8"))
+  } catch {
+    return null
+  }
+}
+
+function isStale(state: SprintState): boolean {
+  if (!state || !state.started_at) return false
+  const started = new Date(state.started_at).getTime()
+  if (isNaN(started)) return false
+  let latest = started
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      if (ph.completed_at) {
+        const t = new Date(ph.completed_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+      if (ph.started_at) {
+        const t = new Date(ph.started_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+    }
+  }
+  return Date.now() - latest > 3_600_000
+}
+
+function statusSymbol(status: string | undefined, key: string, currentPhase: string | number | undefined): string {
+  if (status === "completed") return "✓"
+  if (status === "in_progress") return "→"
+  if (String(currentPhase) === key) return "·"
+  return "○"
+}
+
+function renderPhaseLine(key: string, history: SprintPhaseHistory | undefined, currentPhase: string | number | undefined): string {
+  const name = history?.phase_name || PHASE_NAMES[key] || key
+  const status = history?.status || (String(currentPhase) === key ? "in_progress" : "pending")
+  const sym = statusSymbol(status, key, currentPhase)
+  return `${sym} ${name.padEnd(14)} ${status === "completed" ? "done" : status === "in_progress" ? "active" : ""}`
+    .replace(/\s+$/, "")
+}
+
+function renderSprintSidebar(state: SprintState): string {
+  if (!state || !state.task_description) return ""
+
+  const lines: string[] = []
+  const metrics = state.metrics || {}
+  const currentPhase = state.phase
+
+  // Build lookup
+  const historyByPhase: Record<string, SprintPhaseHistory> = {}
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      historyByPhase[String(ph.phase)] = ph
+    }
+  }
+
+  // Title
+  lines.push(`SPRINT: ${state.task_description}`)
+
+  // Metrics
+  const metricParts: string[] = []
+  if (metrics.tests_passed != null) {
+    metricParts.push(`tests:${metrics.tests_passed}`)
+  }
+  if (metrics.coverage_pct != null) {
+    metricParts.push(`cov:${metrics.coverage_pct}%`)
+  }
+  if (metricParts.length > 0) {
+    lines.push(metricParts.join(" "))
+  }
+
+  // Stale warning
+  if (isStale(state)) {
+    lines.push("⚠ idle >1h")
+  }
+
+  // Phase progress
+  for (const key of PHASE_ORDER) {
+    const history = historyByPhase[key]
+    // Only show phases with activity or current
+    if (!history && String(currentPhase) !== key) continue
+    const line = renderPhaseLine(key, history, currentPhase)
+    lines.push(line)
+
+    // REQ-level progress for BUILD phase
+    if (key === "2" && history?.reqs) {
+      const reqNames = Object.entries(history.reqs)
+        .filter(([, r]) => r.name)
+        .map(([id, r]) => `  ${statusSymbol(r.status, id, undefined)} ${r.name}`)
+      if (reqNames.length > 0) lines.push(...reqNames)
+    }
+  }
+
+  return lines.join("\n")
+}
+
+// ── TUI Slot Plugin ──
+
+const tuiPlugin: TuiSlotPlugin = {
+  slots: {
+    sidebar_content: (_props: TuiSlotProps) => {
+      const dir = process.env.XP_GATE_PROJECT_DIR || process.cwd()
+      const state = readSprintState(dir)
+      if (!state) return null
+      const text = renderSprintSidebar(state)
+      if (!text) return null
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return text as any
+    },
+  },
+}
+
+// Wrap as TuiPlugin (async factory)
+const plugin: TuiPlugin = async (api, _options, _meta) => {
+  api.slots.register(tuiPlugin)
+}
+
+export { plugin as tui, readSprintState, renderSprintSidebar }