@boyingliu01/opencode-plugin 0.8.4

package/README.md

@@ -0,0 +1,38 @@
+# XP-Gate OpenCode Plugin
+
+OpenCode plugin exposing xp-gate quality gates and AI workflow skills.
+
+## Tools
+
+- **gate-check**: Run all 6 quality gates on a file/directory
+- **gate-principles**: Run Clean Code + SOLID principles checker
+- **gate-arch**: Run architecture validation
+
+## Installation
+
+In your `opencode.json`:
+
+```json
+{
+  "plugin": ["@boyingliu01/opencode-plugin"]
+}
+```
+
+Or via local path (development):
+
+```json
+{
+  "plugin": ["./plugins/opencode"]
+}
+```
+
+## Requirements
+
+- OpenCode v0.11+
+- xp-gate npm package installed globally (for `gate-check` tool)
+- Repository with `src/principles/index.ts` (for `gate-principles` tool)
+- `architecture.yaml` in repo root (for `gate-arch` tool)
+
+## Graceful Degradation
+
+If xp-gate CLI is unavailable, tools return helpful install instructions instead of failing.

package/index.ts

@@ -0,0 +1,85 @@
+/**
+ * XP-Gate OpenCode Plugin
+ *
+ * Exposes 3 custom tools for OpenCode users:
+ *  - gate-check:      Run all xp-gate quality checks on a file or directory
+ *  - gate-principles: Run Clean Code + SOLID principles checker
+ *  - gate-arch:       Run architecture validation
+ *
+ * Graceful degradation: if xp-gate CLI not installed, tools return install instructions.
+ */
+import type { Plugin, PluginModule } from "@opencode-ai/plugin"
+import { tool } from "@opencode-ai/plugin"
+import { z } from "zod"
+
+export const XpGatePlugin: Plugin = async (input) => {
+  const { directory, $ } = input
+
+  return {
+    tool: {
+      "gate-check": tool({
+        description:
+          "Run xp-gate quality checks on a file or directory. Requires xp-gate CLI installed globally.",
+        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', 'tests'])"),
+        },
+        async execute(args, ctx) {
+          const cwd = ctx.directory || directory
+          const target = args.path.startsWith("/") ? args.path : `${cwd}/${args.path}`
+          const gates = args.gates?.length ? ` --gates ${args.gates.join(",")}` : ""
+          try {
+            const result = await $`bash -c ${`cd "${cwd}" && command -v xp-gate >/dev/null 2>&1 && xp-gate check "${target}"${gates}`}`
+            const text = await result.text()
+            return text || "[XP-Gate] Check complete."
+          } catch (err: unknown) {
+            return `[XP-Gate] xp-gate CLI not found.\nInstall: npm install -g @boyingliu01/xp-gate\n${err instanceof Error ? err.message : ""}`
+          }
+        },
+      }),
+      "gate-principles": tool({
+        description:
+          "Run Clean Code + SOLID principles checker on a file.",
+        args: {
+          path: z.string().describe("Source file path to check"),
+        },
+        async execute(args, ctx) {
+          const cwd = ctx.directory || directory
+          const target = args.path.startsWith("/") ? args.path : `${cwd}/${args.path}`
+          const cmd = `cd "${cwd}" && npx -y tsx 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."
+          } catch (err: unknown) {
+            return `[XP-Gate] Principles checker failed.\nEnsure src/principles/index.ts exists.\n${err instanceof Error ? err.message : ""}`
+          }
+        },
+      }),
+      "gate-arch": tool({
+        description:
+          "Run architecture validation (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
+          try {
+            const result = await $`bash -c ${`cd "${cwd}" && npx archlint check --config ${args.config}`}`
+            const text = await result.text()
+            return text || "[XP-Gate] Architecture check complete."
+          } catch (err: unknown) {
+            return `[XP-Gate] Architecture validation requires archlint + ${args.config}.\n${err instanceof Error ? err.message : ""}`
+          }
+        },
+      }),
+    },
+  }
+}
+
+const pluginModule: PluginModule = {
+  id: "xp-gate",
+  server: XpGatePlugin,
+}
+
+export default pluginModule

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@boyingliu01/opencode-plugin",
+  "version": "0.8.4",
+  "type": "module",
+  "main": "index.ts",
+  "description": "XP-Gate quality gates + AI workflow skills for OpenCode",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boyingliu01/xp-gate",
+    "directory": "plugins/opencode"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "skills/",
+    "tsconfig.json",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "node scripts/prepack.cjs",
+    "check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.15.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "xp-gate",
+    "quality-gates",
+    "code-review",
+    "sprint-flow"
+  ],
+  "author": "boyingliu01",
+  "license": "MIT"
+}