@boyingliu01/opencode-plugin 0.8.11 → 0.8.13

package/index.ts

@@ -1,33 +1,68 @@
-/**
- * XP-Gate OpenCode Plugin
- *
- * Exposes 3 OpenCode tools that mirror the equivalent `xp-gate` CLI subcommands:
- *  - gate-check:      Run user-invokable quality gates (Gate 4 Principles + Gate 6 Arch) on a path
- *  - gate-principles: Run Clean Code + SOLID principles checker (Gate 4 standalone)
- *  - gate-arch:       Run architecture validation (Gate 6 standalone)
- *
- * Dual-surface design (fixes #208): every tool is callable BOTH from inside an
- * OpenCode session (as these tools) AND from a plain shell (as `xp-gate check`,
- * `xp-gate principles`, `xp-gate arch`). The tools prefer the global `xp-gate`
- * CLI when available, but fall back to running the checker source directly via
- * `npx -y tsx` so they work even before `npm install -g @boyingliu01/xp-gate`.
- */
 import { tool } from "@opencode-ai/plugin"
 import { z } from "zod"
+import { exec } from "child_process"
+import { promisify } from "util"
+
+const execAsync = promisify(exec)
 
 interface OpenCodePluginInput {
   directory: string
   $: (strings: TemplateStringsArray, ...values: unknown[]) => Promise<{ text(): Promise<string> }>
 }
 
+/**
+ * Run a shell command via async exec, returning stdout or error message.
+ * Never throws — returns error string on failure.
+ */
+async function runCmd(cmd: string, cwd: string): Promise<string> {
+  try {
+    const { stdout } = await execAsync(cmd, { cwd, timeout: 30000 })
+    return stdout || "[XP-Gate] Command completed (no output)."
+  } catch (err: any) {
+    if (err.stderr) return err.stderr
+    if (err.message) return `[XP-Gate] Error: ${err.message}`
+    return "[XP-Gate] Command failed."
+  }
+}
+
+/**
+ * Check for xp-gate CLI availability and run a command via exec.
+ */
+async function runXpGate(subcommand: string, cwd: string): Promise<string> {
+  // Check if xp-gate is on PATH
+  try {
+    await execAsync("command -v xp-gate", { cwd })
+  } catch {
+    return ""  // CLI not available — caller should fall back
+  }
+  return runCmd(`xp-gate ${subcommand}`, cwd)
+}
+
+/**
+ * Check for a newer xp-gate version (non-blocking, advisory only).
+ */
+async function getUpgradeSuggestion(cwd: string): Promise<string> {
+  try {
+    const result = await runXpGate("upgrade --preview", cwd)
+    if (!result) return ""
+    const parsed = JSON.parse(result)
+    if (parsed.outdated && parsed.remote) {
+      const releaseUrl = `https://github.com/boyingliu01/xp-gate/releases/tag/v${parsed.remote}`
+      return `[XP-Gate] New version v${parsed.remote} available (${releaseUrl}) — run: xp-gate upgrade`
+    }
+    return ""
+  } catch {
+    return ""
+  }
+}
+
 export const XpGatePlugin = async (input: OpenCodePluginInput) => {
   const { directory, $ } = input
 
   return {
     tool: {
       "gate-check": tool({
-        description:
-          "Run xp-gate user-invokable quality gates (Gate 4 Principles + Gate 6 Architecture) on a file or directory. Prefers global xp-gate CLI; falls back to running checker source directly.",
+        description: "Run xp-gate quality gates (Gate 4 + Gate 6) on a file or directory. Prefers global xp-gate CLI; falls back to direct checker source.",
         args: {
           path: z.string().describe("File or directory path (absolute or relative to workspace)"),
           gates: z.array(z.string()).optional().describe("Optional gate subset (e.g. ['principles', 'arch'])"),
@@ -36,57 +71,50 @@ export const XpGatePlugin = async (input: OpenCodePluginInput) => {
           const cwd = ctx.directory || directory
           const target = args.path.startsWith("/") ? args.path : `${cwd}/${args.path}`
           const gatesFlag = args.gates?.length ? ` --gates ${args.gates.join(",")}` : ""
-          // Prefer the installed xp-gate CLI. Fall back to invoking the same
-          // subcommand source directly via npx tsx so the tool still works in
-          // a fresh clone before `npm install -g @boyingliu01/xp-gate`.
-          const cmd = `cd "${cwd}" && (command -v xp-gate >/dev/null 2>&1 && xp-gate check "${target}"${gatesFlag} || node ${directory}/src/npm-package/bin/xp-gate.js check "${target}"${gatesFlag})`
-          try {
-            const result = await $`bash -c ${cmd}`
-            const text = await result.text()
-            return text || "[XP-Gate] Check complete (no violations)."
-          } catch (err) {
-            return `[XP-Gate] gate-check failed.\nInstall xp-gate CLI: npm install -g @boyingliu01/xp-gate\n${err instanceof Error ? err.message : ""}`
+          const result = await runXpGate(`check "${target}"${gatesFlag}`, cwd)
+          if (result) {
+            const upgrade = await getUpgradeSuggestion(cwd)
+            return upgrade ? `${result}\n${upgrade}` : result
           }
+          // Fallback: invoke xp-gate source directly via node
+          const cmd = `node ${directory}/src/npm-package/bin/xp-gate.js check "${target}"${gatesFlag}`
+          return runCmd(cmd, cwd)
         },
       }),
       "gate-principles": tool({
-        description:
-          "Run Clean Code + SOLID principles checker (Gate 4 standalone) on a file or directory.",
+        description: "Run Clean Code + SOLID principles checker (Gate 4 standalone) on a file or directory.",
         args: {
           path: z.string().describe("Source file or directory path to check"),
         },
         async execute(args, ctx) {
           const cwd = ctx.directory || directory
           const target = args.path.startsWith("/") ? args.path : `${cwd}/${args.path}`
-          // Try xp-gate CLI first, fall back to the principles source directly.
-          const cmd = `cd "${cwd}" && (command -v xp-gate >/dev/null 2>&1 && xp-gate principles "${target}" || npx -y tsx ${directory}/src/principles/index.ts --files "${target}" --format console)`
-          try {
-            const result = await $`bash -c ${cmd}`
-            const text = await result.text()
-            return text || "[XP-Gate] Principles check complete (no violations)."
-          } catch (err) {
-            return `[XP-Gate] Principles checker failed.\nInstall xp-gate CLI: npm install -g @boyingliu01/xp-gate\n${err instanceof Error ? err.message : ""}`
+          const result = await runXpGate(`principles "${target}"`, cwd)
+          if (result) {
+            const upgrade = await getUpgradeSuggestion(cwd)
+            return upgrade ? `${result}\n${upgrade}` : result
           }
+          // Fallback: npx tsx on the principles source
+          const cmd = `npx -y tsx ${directory}/src/principles/index.ts --files "${target}" --format console`
+          return runCmd(cmd, cwd)
         },
       }),
       "gate-arch": tool({
-        description:
-          "Run architecture validation (Gate 6 standalone, layer boundary checks) on the repository.",
+        description: "Run architecture validation (Gate 6 standalone, layer boundary checks) on the repository.",
         args: {
           config: z.string().describe("Path to architecture config file").default("architecture.yaml"),
         },
         async execute(args, ctx) {
           const cwd = ctx.directory || directory
-          // Prefer xp-gate CLI; fall back to @archlinter/cli directly so the tool
-          // also works without xp-gate installed (matches gate-principles pattern).
-          const cmd = `cd "${cwd}" && (command -v xp-gate >/dev/null 2>&1 && xp-gate arch --config ${args.config} || npx -y @archlinter/cli scan . --config ${args.config})`
-          try {
-            const result = await $`bash -c ${cmd}`
-            const text = await result.text()
-            return text || "[XP-Gate] Architecture check complete."
-          } catch (err) {
-            return `[XP-Gate] Architecture validation failed.\nRequires architecture.yaml in repo root.\nInstall xp-gate CLI: npm install -g @boyingliu01/xp-gate\n${err instanceof Error ? err.message : ""}`
+          const config = args.config || "architecture.yaml"
+          const result = await runXpGate(`arch --config ${config}`, cwd)
+          if (result) {
+            const upgrade = await getUpgradeSuggestion(cwd)
+            return upgrade ? `${result}\n${upgrade}` : result
           }
+          // Fallback: @archlinter/cli directly
+          const cmd = `npx -y @archlinter/cli scan . --config ${config}`
+          return runCmd(cmd, cwd)
         },
       }),
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.8.11",
+  "version": "0.8.13",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills for OpenCode",

package/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-06-14
-**Commit:** 348c405
+**Generated:** 2026-06-16
+**Commit:** b1d8786
 **Branch:** main
-**Version:** 0.8.11.0
+**Version:** 0.8.13.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-14
-**Commit:** 348c405
+**Generated:** 2026-06-16
+**Commit:** b1d8786
 **Branch:** main
-**Version:** 0.8.11.0
+**Version:** 0.8.13.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-14
-**Commit:** 348c405
+**Generated:** 2026-06-16
+**Commit:** b1d8786
 **Branch:** main
-**Version:** 0.8.11.0
+**Version:** 0.8.13.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.