xp-gate 0.5.1

package/lib/update-skill.js

@@ -0,0 +1,90 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Cross-platform home directory resolution
+const HOME = process.env.HOME || process.env.USERPROFILE || os.homedir();
+
+const CONFIG_DIR = path.join(HOME, '.config', 'xp-gate');
+const SKILLS_DIR = path.join(HOME, '.config', 'opencode', 'skills');
+
+async function updateSkill(name, options = {}) {
+  const { all = false, check = false, verbose = false } = options;
+  
+  if (check) {
+    console.log('Checking for updates...');
+    const config = getConfig();
+    const skills = config.installedSkills || {};
+    
+    for (const [skillName, info] of Object.entries(skills)) {
+      console.log(`  ${skillName}: ${info.version || 'unknown'}`);
+    }
+    console.log('Update check complete');
+    return 0;
+  }
+  
+  if (all) {
+    const config = getConfig();
+    const skills = config.installedSkills || {};
+    
+    console.log('Updating all skills...');
+    let hasErrors = false;
+    
+    for (const skillName of Object.keys(skills)) {
+      try {
+        await updateSingleSkill(skillName, verbose);
+      } catch (err) {
+        console.error(`Failed to update ${skillName}: ${err.message}`);
+        hasErrors = true;
+      }
+    }
+    
+    return hasErrors ? 1 : 0;
+  }
+  
+  if (!name) {
+    console.error('Error: Skill name required');
+    console.error('Usage: xp-gate update-skill <name> or --all');
+    return 1;
+  }
+  
+  const config = getConfig();
+  const skills = config.installedSkills || {};
+  
+  if (!skills[name]) {
+    console.error(`Error: ${name} is not installed`);
+    return 1;
+  }
+  
+  return updateSingleSkill(name, verbose);
+}
+
+async function updateSingleSkill(name, verbose) {
+  console.log(`Updating ${name}...`);
+  
+  const targetDir = path.join(SKILLS_DIR, name);
+  if (fs.existsSync(targetDir)) {
+    fs.rmSync(targetDir, { recursive: true });
+  }
+  
+  const { installSkill } = require('./install-skill.js');
+  const result = await installSkill(name, { force: true, verbose });
+  
+  if (result === 0) {
+    console.log(`✓ ${name} updated`);
+  }
+  
+  return result;
+}
+
+function getConfig() {
+  const configFile = path.join(CONFIG_DIR, 'xp-gate.json');
+  if (fs.existsSync(configFile)) {
+    try {
+      return JSON.parse(fs.readFileSync(configFile, 'utf8'));
+    } catch {}
+  }
+  return {};
+}
+
+module.exports = { updateSkill };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "xp-gate",
+  "version": "0.5.1",
+  "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
+  "bin": {
+    "xp-gate": "./bin/xp-gate.js"
+  },
+  "files": [
+    "bin/",
+    "hooks/",
+    "adapters/",
+    "lib/",
+    "skills/",
+    "plugins/",
+    "adapter-common.sh"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boyingliu01/xp-gate"
+  },
+  "publishConfig": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "version": "node scripts/sync-package-content.js && git add -A skills/ plugins/ 2>/dev/null || true",
+    "prepack": "node scripts/sync-package-content.js",
+    "test": "echo \"Run tests\" && exit 0"
+  },
+  "keywords": [
+    "xp-gate",
+    "quality-gates",
+    "delphi-review",
+    "sprint-flow",
+    "ai-development"
+  ],
+  "author": "boyingliu01",
+  "license": "MIT"
+}

package/plugins/claude-code/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "xp-gate",
+  "version": "0.4.0",
+  "displayName": "XP-Gate",
+  "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 6 quality gates, Sprint Flow, and Delphi multi-expert review.",
+  "author": {
+    "name": "boyingliu01"
+  },
+  "homepage": "https://github.com/boyingliu01/xp-gate",
+  "repository": "https://github.com/boyingliu01/xp-gate",
+  "license": "MIT",
+  "keywords": [
+    "quality-gates",
+    "sprint-flow",
+    "delphi-review",
+    "xp",
+    "ai-development"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json"
+}

package/plugins/claude-code/bin/delphi-review-guard.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# delphi-review-guard.sh — PreToolUse Hook Guard
+#
+# PURPOSE: Physically prevent LLM from editing/writing code before
+# delphi-review is APPROVED. Blocks Edit/Write/ApplyEdit tools.
+#
+# INTEGRATION: Registered in plugins/claude-code/hooks/hooks.json
+# as a PreToolUse hook.
+#
+# MECHANISM:
+#   - Reads .sprint-state/delphi-reviewed.json
+#   - If file missing or verdict != "APPROVED" → deny
+#   - If verdict == "APPROVED" → allow
+#
+# GRACEFUL DEGRADATION:
+#   - If .sprint-state/ directory doesn't exist → ALLOW (not a sprint project)
+#   - If jq not available → ALLOW with warning (zero degradation for existing projects)
+
+# Check if this is a sprint project
+SPRINT_STATE_DIR="$(git rev-parse --show-toplevel 2>/dev/null)/.sprint-state"
+APPROVED_FILE="$SPRINT_STATE_DIR/delphi-reviewed.json"
+
+# If no .sprint-state directory, this isn't a sprint project → allow
+if [ ! -d "$SPRINT_STATE_DIR" ]; then
+  exit 0
+fi
+
+# If delphi-reviewed.json doesn't exist, delphi-review hasn't completed → DENY
+if [ ! -f "$APPROVED_FILE" ]; then
+  echo '{"decision":"deny","reason":"delphi-review not APPROVED. Complete Phase 1 delphi-review before any code modification. Run: /delphi-review"}'
+  exit 1
+fi
+
+# Check jq availability
+if ! command -v jq &> /dev/null; then
+  # jq not available → warn but allow (degradation for existing project)
+  echo '{"decision":"allow","warning":"jq not available, cannot verify delphi-review verdict. Install jq for full protection."}'
+  exit 0
+fi
+
+# Validate JSON
+if ! jq empty "$APPROVED_FILE" 2>/dev/null; then
+  echo '{"decision":"deny","reason":"delphi-reviewed.json is not valid JSON. Re-run: /delphi-review"}'
+  exit 1
+fi
+
+# Check verdict
+VERDICT=$(jq -r '.verdict' "$APPROVED_FILE" 2>/dev/null)
+MODE=$(jq -r '.mode' "$APPROVED_FILE" 2>/dev/null)
+
+if [ "$VERDICT" != "APPROVED" ]; then
+  DENY_MSG="{\"decision\":\"deny\",\"reason\":\"delphi-review verdict is '${VERDICT}', not APPROVED. Fix issues and re-run: /delphi-review\"}"
+  echo "$DENY_MSG"
+  exit 1
+fi
+
+# APPROVED → allow
+if [ "$MODE" = "design" ]; then
+  SPEC_PATH=$(jq -r '.specification_path // "not found"' "$APPROVED_FILE" 2>/dev/null)
+  echo "{\"decision\":\"allow\",\"message\":\"delphi-review design APPROVED. specification: ${SPEC_PATH}\"}"
+elif [ "$MODE" = "code-walkthrough" ]; then
+  COMMIT=$(jq -r '.commit // "unknown"' "$APPROVED_FILE" 2>/dev/null)
+  echo "{\"decision\":\"allow\",\"message\":\"delphi-review code-walkthrough APPROVED. commit: ${COMMIT}\"}"
+else
+  echo '{"decision":"allow","message":"delphi-review APPROVED"}'
+fi
+
+exit 0

package/plugins/claude-code/bin/xp-gate-check

@@ -0,0 +1,47 @@
+#!/bin/bash
+# xp-gate-check: Quality gate wrapper for Claude Code plugin
+# Usage: xp-gate-check <file_path>
+#
+# Graceful degradation: if xp-gate CLI unavailable, logs warning to stderr and exits 0.
+# This script always exits 0 to avoid blocking Claude Code sessions.
+
+set -euo pipefail
+
+FILE_PATH="${1:-}"
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Skip if file doesn't exist
+[ -f "$FILE_PATH" ] || exit 0
+
+# Skip non-source files
+case "$FILE_PATH" in
+  *.ts|*.tsx|*.js|*.jsx|*.py|*.go|*.java|*.kt|*.rb|*.rs)
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+# Resolve repo root from script location (avoids dependence on CLAUDE_PLUGIN_ROOT env var)
+# Plugin is at plugins/claude-code/bin/, repo root is 3 dirname calls up:
+#   bin/ → claude-code/ → plugins/ → repo-root/
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(dirname "$(dirname "$(dirname "$SCRIPT_DIR")")")"
+
+if command -v xp-gate >/dev/null 2>&1; then
+  # xp-gate globally installed — run principles check on the file
+  npx -y tsx "${REPO_ROOT}/src/principles/index.ts" --files "$FILE_PATH" --format console 2>&1 || true
+elif [ -f "${REPO_ROOT}/src/principles/index.ts" ]; then
+  # Fallback: run principles checker directly from repo source
+  echo "[XP-Gate] Running principles check (xp-gate CLI not installed)" >&2
+  npx -y tsx "${REPO_ROOT}/src/principles/index.ts" --files "$FILE_PATH" --format console 2>&1 || true
+else
+  # Graceful degradation: log once per session
+  echo "[XP-Gate] Quality check skipped: xp-gate not installed. Run 'npm install -g xp-gate'" >&2
+fi
+
+# Always exit 0 to avoid blocking the Claude session
+exit 0

package/plugins/claude-code/hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|ApplyEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/bin/delphi-review-guard.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/bin/xp-gate-check \"${TOOL_INPUT_FILE}\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo \"[XP-Gate] Session complete. Run 'xp-gate init' for full git hook integration.\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/delphi-review/.delphi-config.json.example

@@ -0,0 +1,45 @@
+{
+  "$schema": "./.delphi-config.schema.json",
+  "version": 1,
+  "description": "Delphi review expert mapping — customize with your own models. Copy to .delphi-config.json and edit.",
+  "num_experts": 3,
+  "model_policy": {
+    "domestic_only": true,
+    "description": "Only domestic Chinese open-source models are allowed. NEVER use Anthropic, OpenAI, Google, or other foreign expensive models.",
+    "allowed_models": [
+      "glm-5.1", "glm-5.0",
+      "kimi-k2.6", "kimi-k2.5",
+      "minimax-m2.7", "minimax-m2.5",
+      "qwen3.6-plus", "qwen3.5-plus",
+      "deepseek-v4-pro", "deepseek-v4-lite"
+    ]
+  },
+  "experts": {
+    "architecture": {
+      "agent_name": "delphi-reviewer-architecture",
+      "perspective": "Architecture and requirements alignment",
+      "requirements_alignment": true,
+      "recommended_model": "deepseek-v4-pro",
+      "alternatives": ["qwen3.6-plus", "glm-5.1"]
+    },
+    "technical": {
+      "agent_name": "delphi-reviewer-technical",
+      "perspective": "Technical implementation, code correctness, edge cases",
+      "requirements_alignment": true,
+      "recommended_model": "kimi-k2.6",
+      "alternatives": ["deepseek-v4-pro", "minimax-m2.7"]
+    },
+    "feasibility": {
+      "agent_name": "delphi-reviewer-feasibility",
+      "perspective": "Feasibility analysis, risk assessment, execution complexity",
+      "requirements_alignment": true,
+      "recommended_model": "qwen3.6-plus",
+      "alternatives": ["kimi-k2.6", "glm-5.1"]
+    }
+  },
+  "consensus": {
+    "threshold_percent": 95,
+    "max_review_rounds": 5,
+    "cross_provider_required": true
+  }
+}

package/skills/delphi-review/AGENTS.md

@@ -0,0 +1,54 @@
+# SKILLS/DEPHI-REVIEW KNOWLEDGE BASE
+
+**Generated:** 2026-05-02
+**Commit:** 1f6bc7d
+**Branch:** main
+
+## OVERVIEW
+Delphi Consensus Review - Multi-round anonymous review system to reach expert consensus on code changes and design decisions.
+
+## STRUCTURE
+```
+skills/delphi-review/
+├── SKILL.md              # Core Delphi review methodology
+├── INSTALL.md            # Setup instructions
+├── references/           # Code walkthrough mode specification
+└── .delphi-config.json.example  # 3-expert config template
+```
+
+## WHERE TO LOOK
+| Task | Location | Notes |
+|------|----------|-------|
+| Core Logic | SKILL.md | Main Delphi methodology and workflow |
+
+## CODE MAP
+| Symbol | Type | Location | Refs | Role |
+|--------|------|----------|------|------|
+| Delphi Method | Review Process | SKILL.md | N/A | Anonymous multi-round consensus |
+
+## CONVENTIONS
+- Experts work anonymously in Round 1 to avoid bias
+- Iterative review till consensus reached (>=95% agreement)
+- Zero tolerance quality checks required
+- No skipping rounds when disagreement occurs
+
+## ANTI-PATTERNS (THIS PROJECT)
+- Do NOT terminate before achieving true consensus
+- Do NOT reveal other experts' opinions during Round 1
+- Do NOT accept partial agreement without resolution
+
+## UNIQUE STYLES
+- Anonymous expert reviews
+- Multiple rounds until full agreement
+- Statistical consensus measurement (>=95% threshold)
+- Mandatory agreement before approval
+
+## COMMANDS
+```bash
+# Trigger Delphi review
+/delphi-review
+```
+
+## NOTES
+- Implements traditional Delphi method for anonymous expert consensus
+- Used by code-walkthrough mode

package/skills/delphi-review/INSTALL.md

@@ -0,0 +1,152 @@
+# Installing and Configuring Delphi Review
+
+This guide walks you through setting up the Delphi consensus review skill in your OpenCode environment.
+
+## Prerequisites
+
+- OpenCode installed and configured
+- At least **2 different model providers** available (cross-provider requirement prevents homogenized blind spots)
+- Access to at least 3 different models (for 3-expert mode) or 2 models (for 2-expert mode)
+
+> **Why cross-provider?** Using models from the same vendor (e.g., all OpenAI) means they share training data and biases, defeating the purpose of multi-expert consensus.
+
+## Quick Setup (3 steps)
+
+### Step 1: Copy the configuration template
+
+```bash
+# From your project root (where opencode.json lives):
+cp skills/delphi-review/.delphi-config.json.example .delphi-config.json
+```
+
+This file maps abstract expert roles to agent names. You typically don't need to edit this unless you want custom agent names.
+
+### Step 2: Add agent definitions to opencode.json
+
+Copy the `agent` block from `skills/delphi-review/opencode.json.delphi.example` into your `opencode.json`.
+
+Then replace the provider/model placeholders:
+
+```json
+// Before (template):
+"model": "YOUR_PROVIDER/YOUR_MODEL_A"
+
+// After (your config):
+"model": "openai/gpt-4o"
+// or
+"model": "anthropic/claude-sonnet-4-20250514"
+// or
+"model": "bailian-coding-plan/qwen3.6-plus"
+```
+
+### Step 3: Ensure provider configuration exists
+
+Your `opencode.json` must have the provider definitions. If you're using OpenCode's built-in providers (OpenAI, Anthropic, etc.), you just need API keys set in your environment.
+
+For custom providers (like Ali Bailian), add a provider entry:
+
+```json
+"provider": {
+  "my-custom-provider": {
+    "npm": "@ai-sdk/anthropic",
+    "name": "My Custom Provider",
+    "options": {
+      "baseURL": "https://your-api-endpoint.com/v1",
+      "apiKey": "your-api-key"
+    },
+    "models": {
+      "my-model-name": {
+        "name": "My Model Name",
+        "modalities": {
+          "input": ["text"],
+          "output": ["text"]
+        },
+        "limit": {
+          "context": 128000,
+          "output": 8192
+        }
+      }
+    }
+  }
+}
+```
+
+## Model Recommendations
+
+The skill requires at least 2 experts for code changes, 3 for architecture decisions. Here are recommended model selections:
+
+| Expert Role | Recommended | Alternatives |
+|-------------|-------------|-------------|
+| **Architecture (Expert A)** | Claude Sonnet 4 | GPT-4o, Qwen-Plus, Gemini 2.5 Pro |
+| **Technical (Expert B)** | Claude Haiku | Qwen-Coder, DeepSeek-Coder, GPT-4o-mini |
+| **Feasibility (Expert C)** | Claude Opus | GPT-4, Gemini 2.5 Pro, Qwen-Max |
+
+**Minimum viable setup** (2-expert mode):
+- Expert A: Any reasoning-strong model
+- Expert B: Any code-understanding-strong model
+- **Must be from different providers**
+
+## Configuration File Reference
+
+### `.delphi-config.json`
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `num_experts` | Number of experts to use (2 or 3) | 3 |
+| `experts.architecture` | Architecture reviewer configuration | Required |
+| `experts.technical` | Technical reviewer configuration | Required |
+| `experts.feasibility` | Feasibility reviewer configuration | Required for 3-expert mode |
+    | `consensus.threshold_percent` | Agreement threshold | 95 |
+| `consensus.max_review_rounds` | Maximum review rounds | 5 |
+| `consensus.cross_provider_required` | Require different providers | true |
+
+### `opencode.json` agent block
+
+| Field | Description |
+|-------|-------------|
+| `model` | Provider/model identifier (e.g., `openai/gpt-4o`) |
+| `mode` | Must be `"subagent"` |
+| `prompt` | Expert role instructions |
+| `tools` | Tool permissions (read: true, write: false recommended) |
+
+## Usage
+
+Once configured, invoke the skill via:
+
+```bash
+/delphi-review
+```
+
+Or reference it in your workflows. The skill will automatically use the agents defined in your `opencode.json`.
+
+## Troubleshooting
+
+### "Agent delphi-reviewer-xxx not found"
+
+The agent definitions in `opencode.json` don't match the names in `.delphi-config.json`. Verify:
+1. Agent names in `.delphi-config.json` match keys in `opencode.json` `agent` block
+2. opencode.js is valid JSON (use `jq . opencode.json` to verify)
+
+### "Model YOUR_PROVIDER/YOUR_MODEL not available"
+
+You forgot to replace the placeholder. Search for `YOUR_PROVIDER` in your opencode.json and replace with actual values.
+
+### Both experts gave identical feedback
+
+Your models are from the same provider. Configure agents to use different providers.
+
+### Review takes too long / costs too much
+
+Reduce to 2-expert mode in `.delphi-config.json`: set `num_experts: 2`.
+
+## Advanced: JSON Schema Validation
+
+For IDE autocompletion and validation, reference the schema in your `.delphi-config.json`:
+
+```json
+{
+  "$schema": "https://example.com/delphi-config.schema.json"
+}
+```
+
+The schema file is available at `.delphi-config.schema.json` in this directory.