@boyingliu01/opencode-plugin 0.10.9 → 0.10.11

package/index.ts

@@ -55,7 +55,7 @@ async function fetchNpmLatestVersion(url: string): Promise<string | null> {
   }
 }
 
-function readCache(file: string): { ts: number; remoteVersion: string; status?: string } | null {
+function readCache(file: string): { ts: number; remoteVersion: string; localVersion?: string; status?: string } | null {
   try {
     if (!existsSync(file)) return null
     const raw = readFileSync(file, "utf8")
@@ -100,11 +100,16 @@ function getLocalXpGateVersion(): string | 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 cache exists and local version hasn't changed AND status is "current",
+  // the cache is still valid — skip network check
+  if (cached?.status === "current" && cached.remoteVersion && localVersion && cached.localVersion === localVersion) {
+    return { action: "noop", localVersion, remoteVersion: cached.remoteVersion }
   }
 
-  const localVersion = getLocalXpGateVersion()
+  // If we have a valid cache but local version changed (e.g., manual upgrade)
+  // or cache has no "current" status, we need to re-check remote
   if (!localVersion) return { action: "noop", localVersion: null, remoteVersion: null }
 
   const remoteVersion = await fetchNpmLatestVersion(XP_GATE_REGISTRY_URL)
@@ -124,17 +129,19 @@ async function checkXpGateUpdate(): Promise<UpgradeResult> {
 
   writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion })
   try {
-    const child = spawn("npm", ["install", "-g", `${XP_GATE_NPM_PKG}@${remoteVersion}`], {
-      stdio: "pipe",
-      timeout: 120_000,
-    })
-    child.on("close", (code) => {
-      if (code === 0) {
-        writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion: remoteVersion, remoteVersion, status: "current" })
-      }
+    const exitCode = await new Promise<number | null>((resolve, reject) => {
+      const child = spawn("npm", ["install", "-g", `${XP_GATE_NPM_PKG}@${remoteVersion}`], {
+        stdio: "pipe",
+        timeout: 120_000,
+      })
+      child.on("close", (code) => resolve(code))
+      child.on("error", (err) => reject(err))
     })
-    child.on("error", () => { /* empty — cache won't get status:current, so next check retries */ })
-    return { action: "upgraded", localVersion, remoteVersion }
+    if (exitCode === 0) {
+      writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion: remoteVersion, remoteVersion, status: "current" })
+      return { action: "upgraded", localVersion, remoteVersion }
+    }
+    return { action: "error", localVersion, remoteVersion, error: `npm install exited with code ${exitCode}` }
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err)
     return { action: "error", localVersion, remoteVersion, error: msg }
@@ -174,6 +181,22 @@ async function checkPluginUpdate(pluginDir: string): Promise<void> {
   }
 }
 
+// ── TUI upgrade notice ──
+
+const UPGRADE_NOTICE_FILE = join(homedir(), ".xp-gate", "upgrade-notice.json")
+
+type UpgradeNotice = {
+  kind: "upgraded" | "outdated" | "error"
+  localVersion: string | null
+  remoteVersion: string | null
+  message: string
+  ts: number
+}
+
+function writeUpgradeNotice(notice: UpgradeNotice): void {
+  writeCache(UPGRADE_NOTICE_FILE, notice)
+}
+
 // ── Combined background check (runs once on first chat.message) ──
 
 async function runBackgroundUpdates(pluginDir: string): Promise<string | null> {
@@ -181,10 +204,19 @@ async function runBackgroundUpdates(pluginDir: string): Promise<string | null> {
   await checkPluginUpdate(pluginDir)
 
   if (result.action === "upgraded") {
-    return `[XP-Gate] Auto-upgraded from v${result.localVersion} to v${result.remoteVersion}`
+    const msg = `[XP-Gate] Auto-upgraded from v${result.localVersion} to v${result.remoteVersion}`
+    writeUpgradeNotice({ kind: "upgraded", localVersion: result.localVersion, remoteVersion: result.remoteVersion, message: msg, ts: Date.now() })
+    return msg
   }
   if (result.action === "error") {
-    return `[XP-Gate] Upgrade check: v${result.remoteVersion} available (auto-upgrade failed: ${result.error})`
+    const msg = `[XP-Gate] Upgrade check: v${result.remoteVersion} available (auto-upgrade failed: ${result.error})`
+    writeUpgradeNotice({ kind: "error", localVersion: result.localVersion, remoteVersion: result.remoteVersion, message: msg, ts: Date.now() })
+    return msg
+  }
+  if (result.remoteVersion && result.localVersion && semverLt(result.localVersion, result.remoteVersion)) {
+    const msg = `[XP-Gate] New version v${result.remoteVersion} available (you have v${result.localVersion})`
+    writeUpgradeNotice({ kind: "outdated", localVersion: result.localVersion, remoteVersion: result.remoteVersion, message: msg, ts: Date.now() })
+    return msg
   }
   return null
 }
@@ -289,11 +321,9 @@ export const XpGatePlugin = async (input: OpenCodePluginInput) => {
     "chat.message": async (_input: { message: string }) => {
       if (!checked) {
         checked = true
-        runBackgroundUpdates(directory).then((msg) => {
-          if (msg) process.stderr.write(`${msg}\n`)
-        })
+        const msg = await runBackgroundUpdates(directory).catch(() => null)
+        if (msg) process.stderr.write(`${msg}\n`)
       }
-      return { action: "continue" }
     },
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.10.9",
+  "version": "0.10.11",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",

package/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-06-23
-**Commit:** 34d5784
+**Commit:** bac916f
 **Branch:** main
-**Version:** 0.10.8.0
+**Version:** 0.10.11.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-23
-**Commit:** 34d5784
+**Commit:** bac916f
 **Branch:** main
-**Version:** 0.10.8.0
+**Version:** 0.10.11.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-23
-**Commit:** 34d5784
+**Commit:** bac916f
 **Branch:** main
-**Version:** 0.10.8.0
+**Version:** 0.10.11.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/tui-plugin.ts

@@ -17,6 +17,7 @@
 
 import { existsSync, readFileSync, readdirSync } from "node:fs"
 import { join, dirname, resolve, parse } from "node:path"
+import { homedir } from "node:os"
 import type { TuiPlugin, TuiSlotPlugin, TuiSlotProps } from "@opencode-ai/plugin/tui"
 
 // ── Phase constants (inlined from ../../src/npm-package/lib/shared-phase-constants.js) ──
@@ -174,7 +175,7 @@ function discoverActiveSprints(dir: string): DiscoveredSprint[] {
 
 // ── Cache (module-level, 5s TTL) ──
 
-let _cache: { data: DiscoveredSprint[]; ts: number; dir: string } | null = null;
+let _cache: { data: DiscoveredSprint[]; upgradeNotice: string | null; ts: number; dir: string } | null = null;
 const CACHE_TTL_MS = 5_000;
 
 // ── Helpers ──
@@ -328,6 +329,45 @@ function renderMultiSprintSidebar(sprints: DiscoveredSprint[]): string | null {
   return blocks.join("\n---\n");
 }
 
+function renderContent(sprints: DiscoveredSprint[], upgradeNotice: string | null): string | null {
+  const sprintContent = renderMultiSprintSidebar(sprints)
+  if (upgradeNotice && sprintContent) return `${upgradeNotice}\n---\n${sprintContent}`
+  if (upgradeNotice) return upgradeNotice
+  return sprintContent
+}
+
+// ── Upgrade notice ──
+
+const UPGRADE_NOTICE_FILE = join(homedir(), ".xp-gate", "upgrade-notice.json")
+const UPGRADE_NOTICE_TTL_MS = 86_400_000 // 24h
+
+type UpgradeNotice = {
+  kind: string
+  localVersion: string | null
+  remoteVersion: string | null
+  message: string
+  ts: number
+}
+
+function readUpgradeNotice(): UpgradeNotice | null {
+  try {
+    if (!existsSync(UPGRADE_NOTICE_FILE)) return null
+    const raw = readFileSync(UPGRADE_NOTICE_FILE, "utf8")
+    const data = JSON.parse(raw) as UpgradeNotice
+    if (Date.now() - data.ts < UPGRADE_NOTICE_TTL_MS && data.message) return data
+    return null
+  } catch {
+    return null
+  }
+}
+
+function renderUpgradeNotice(): string | null {
+  const notice = readUpgradeNotice()
+  if (!notice) return null
+  const icon = notice.kind === "upgraded" ? "✓" : notice.kind === "outdated" ? "↑" : "⚠"
+  return `${icon} ${notice.message}`
+}
+
 // ── TUI Slot Plugin ──
 
 const tuiPlugin: TuiSlotPlugin = {
@@ -338,12 +378,13 @@ const tuiPlugin: TuiSlotPlugin = {
 
       // Use cache if still valid for current directory
       if (_cache && _cache.dir === dir && now - _cache.ts < CACHE_TTL_MS) {
-        return renderMultiSprintSidebar(_cache.data);
+        return renderContent(_cache.data, _cache.upgradeNotice);
       }
 
       const sprints = discoverActiveSprints(dir);
-      _cache = { data: sprints, ts: now, dir };
-      return renderMultiSprintSidebar(sprints);
+      const upgradeNotice = renderUpgradeNotice()
+      _cache = { data: sprints, ts: now, dir, upgradeNotice };
+      return renderContent(sprints, upgradeNotice);
     },
   },
 }