@boyingliu01/xp-gate 0.10.16 → 0.10.17

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Mock layering policy enforcement — Gate M3 of pre-push hook. Ensures integration tests use real implementations for internal dependencies, mock external dependencies, and annotate pending mocks with removal plans. Combines project scope scanning, mock decision engine, and per-file validation into a single pipeline.

package/mutation/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MUTATION KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 **Gate M** (incremental mutation testing) + **Gate M2** helpers (test-layer detection used by `src/mock-policy/`). Pre-push quality gate. TypeScript-only; uses Stryker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.10.16",
+  "version": "0.10.17",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.10.16",
+  "version": "0.10.17",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/claude-code/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.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/plugins/claude-code/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → SHIP → LAND → USER ACCEPTANCE → FEEDBACK → 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/plugins/claude-code/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.10.16",
+  "version": "0.10.17",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",
@@ -19,8 +19,8 @@
       "types": "./index.ts"
     },
     "./tui": {
-      "import": "./tui-plugin.ts",
-      "types": "./tui-plugin.ts"
+      "import": "./tui-plugin.tsx",
+      "types": "./tui-plugin.tsx"
     }
   },
   "files": [

package/plugins/opencode/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.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/plugins/opencode/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → SHIP → LAND → USER ACCEPTANCE → FEEDBACK → 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/plugins/opencode/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/tui-plugin.tsx

@@ -0,0 +1,306 @@
+// @no-test-required: TUI rendering plugin — tested via visual verification in OpenCode runtime
+/**
+ * XP-Gate OpenCode TUI Slot Plugin
+ *
+ * Registers sidebar_content slot to display Sprint Flow progress
+ * from active sprint states discovered in .worktrees/sprint/ subdirectories.
+ *
+ * Rendered with @opentui/solid JSX — sidebar_content must return JSX.Element,
+ * NOT string (strings are silently ignored by OpenCode's TUI renderer).
+ *
+ * Users register this file in ~/.config/opencode/tui.json as:
+ *   { "plugin": ["@boyingliu01/opencode-plugin/tui"] }
+ */
+/** @jsxImportSource @opentui/solid */
+
+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"
+import { createMemo, Show, For } from "solid-js"
+
+// ── Phase constants ──
+
+const PHASE_NAMES: Record<string, string> = {
+  '-1': 'ISOLATE', '-0.5': 'AUTO-ESTIMATE', '0': 'THINK',
+  '1': 'PLAN', '2': 'BUILD', '3': 'REVIEW',
+  '4': 'SHIP', '5': 'LAND', '6': 'USER ACCEPT',
+  '7': 'FEEDBACK', '8': 'CLEANUP',
+};
+
+const PHASE_ORDER = ['-1', '-0.5', '0', '1', '2', '3', '4', '5', '6', '7', '8'];
+
+// ── Types ──
+
+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[]
+}
+interface DiscoveredSprint {
+  state: SprintState; sourcePath: string; worktreeExists: boolean
+}
+
+// ── Discovery ──
+
+const MAX_DISCOVERY_RESULTS = 5;
+
+function findGitRoot(startDir: string): string | null {
+  let current = resolve(startDir);
+  const root = parse(current).root;
+  const seen = new Set<string>();
+  while (current !== root) {
+    if (seen.has(current)) break;
+    seen.add(current);
+    if (existsSync(join(current, '.git'))) return current;
+    const parent = dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  if (existsSync(join(root, '.git'))) return root;
+  return null;
+}
+
+function readSprintState(dir: string): SprintState | null {
+  try {
+    const sf = join(dir, '.sprint-state', 'sprint-state.json');
+    if (!existsSync(sf)) return null;
+    return JSON.parse(readFileSync(sf, 'utf8')) as SprintState;
+  } catch { return null; }
+}
+
+function checkWorktreeExists(p: string | undefined): boolean {
+  if (!p) return false;
+  try { return existsSync(p); } catch { return false; }
+}
+
+function parseTime(v: unknown): number {
+  return new Date(v as string).getTime();
+}
+
+function isStaleSprint(s: SprintState | null): boolean {
+  if (!s?.started_at) return false;
+  let latest = parseTime(s.started_at);
+  if (isNaN(latest)) return false;
+  for (const ph of s.phase_history ?? []) {
+    if (ph.completed_at) latest = Math.max(latest, parseTime(ph.completed_at));
+    if (ph.started_at) latest = Math.max(latest, parseTime(ph.started_at));
+  }
+  return latest > 0 && Date.now() - latest > 3_600_000;
+}
+
+function discoverActiveSprints(dir: string): DiscoveredSprint[] {
+  const gitRoot = findGitRoot(dir);
+  const results: DiscoveredSprint[] = [];
+
+  if (gitRoot) {
+    const base = join(gitRoot, '.worktrees', 'sprint');
+    let entries: { name: string; isDirectory: () => boolean }[] = [];
+    try { if (existsSync(base)) entries = readdirSync(base, { withFileTypes: true }); } catch { /* ok */ }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const d = join(base, e.name);
+      const state = readSprintState(d);
+      if (!state?.id) continue;
+      const wt = checkWorktreeExists(d);
+      if (isStaleSprint(state) && !wt) continue;
+      results.push({ state, sourcePath: join(d, '.sprint-state', 'sprint-state.json'), worktreeExists: wt });
+    }
+  }
+
+  const localState = readSprintState(dir);
+  if (localState?.id) {
+    const wp = localState.isolation?.worktree_path;
+    const hasWp = !!wp;
+    const wt = hasWp ? checkWorktreeExists(wp) : false;
+    if (!hasWp || wt) results.push({ state: localState, sourcePath: join(dir, '.sprint-state', 'sprint-state.json'), worktreeExists: wt });
+  }
+
+  const deduped = new Map<string, DiscoveredSprint>();
+  for (const e of results) {
+    const id = e.state.id!;
+    const existing = deduped.get(id);
+    if (!existing) { deduped.set(id, e); continue; }
+    if (e.worktreeExists && !existing.worktreeExists) { deduped.set(id, e); continue; }
+    if (!e.worktreeExists && existing.worktreeExists) continue;
+    const eTs = e.state.started_at ? new Date(e.state.started_at).getTime() : 0;
+    const xTs = existing.state.started_at ? new Date(existing.state.started_at).getTime() : 0;
+    if (eTs > xTs || (eTs === xTs && e.sourcePath < existing.sourcePath)) deduped.set(id, e);
+  }
+
+  return Array.from(deduped.values())
+    .sort((a, b) => {
+      const aTs = a.state.started_at ? new Date(a.state.started_at).getTime() : 0;
+      const bTs = b.state.started_at ? new Date(b.state.started_at).getTime() : 0;
+      return bTs - aTs || String(b.state.id).localeCompare(String(a.state.id));
+    })
+    .slice(0, MAX_DISCOVERY_RESULTS);
+}
+
+// ── Cache ──
+
+let _cache: { data: DiscoveredSprint[]; upgradeNotice: string | null; ts: number; dir: string } | null = null;
+const CACHE_TTL_MS = 5_000;
+
+// ── Render helpers ──
+
+function statusSymbol(status: string | undefined, currentPhase: string | number | undefined, key: string): string {
+  if (status === "completed") return "✓"
+  if (status === "in_progress") return "→"
+  if (String(currentPhase) === key) return "·"
+  return "○"
+}
+
+function buildPhaseLookup(state: SprintState): Record<string, SprintPhaseHistory> {
+  const lookup: Record<string, SprintPhaseHistory> = {}
+  for (const ph of state.phase_history ?? []) lookup[String(ph.phase)] = ph
+  return lookup
+}
+
+function phaseLine(key: string, history: SprintPhaseHistory | undefined, currentPhase: string | number | undefined): string {
+  const name = history?.phase_name || PHASE_NAMES[key] || key
+  const st = history?.status || (String(currentPhase) === key ? "in_progress" : "pending")
+  const sym = statusSymbol(st, currentPhase, key)
+  const suffix = st === "completed" ? "done" : st === "in_progress" ? "active" : ""
+  return `${sym} ${name.padEnd(14)} ${suffix}`.replace(/\s+$/, "")
+}
+
+function renderSprintTitle(state: SprintState): string {
+  if (state.task_description) return state.task_description;
+  if (state.id) {
+    const m = state.id.match(/sprint-(\d{4}-\d{2}-\d{2})-(\d+)/);
+    return m ? `Sprint ${m[1]} #${m[2]}` : state.id;
+  }
+  return 'Unknown Sprint';
+}
+
+// ── Upgrade notice ──
+
+const UPGRADE_NOTICE_FILE = join(homedir(), ".xp-gate", "upgrade-notice.json")
+const UPGRADE_NOTICE_TTL_MS = 86_400_000
+
+function readUpgradeNotice(): string | null {
+  try {
+    if (!existsSync(UPGRADE_NOTICE_FILE)) return null
+    const raw = JSON.parse(readFileSync(UPGRADE_NOTICE_FILE, "utf8"))
+    if (Date.now() - raw.ts < UPGRADE_NOTICE_TTL_MS && raw.message) {
+      const icon = raw.kind === "upgraded" ? "✓" : raw.kind === "outdated" ? "↑" : "⚠"
+      return `${icon} ${raw.message}`
+    }
+    return null
+  } catch { return null; }
+}
+
+// ── JSX Components ──
+
+function SprintCard(props: { sprint: DiscoveredSprint }) {
+  const { state } = props.sprint
+  const lookup = buildPhaseLookup(state)
+
+  return (
+    <box>
+      <text><b>SPRINT:</b> {renderSprintTitle(state)}</text>
+      <Show when={state.isolation?.branch}>
+        {(branch: () => string) => <text fg="#888888">  {branch()}</text>}
+      </Show>
+      <Show when={state.metrics?.tests_passed != null || state.metrics?.coverage_pct != null}>
+        <text fg="#888888">
+          {state.metrics?.tests_passed != null ? `tests:${state.metrics.tests_passed}` : ""}
+          {state.metrics?.coverage_pct != null ? ` cov:${state.metrics.coverage_pct}%` : ""}
+        </text>
+      </Show>
+      <Show when={isStaleSprint(state)}>
+        <text fg="#ffaa00">  ⚠ idle >1h</text>
+      </Show>
+      <For each={PHASE_ORDER}>
+        {(key: string) => {
+          const hist = lookup[key]
+          if (!hist && String(state.phase) !== key) return null
+          return <text>{phaseLine(key, hist, state.phase)}</text>
+        }}
+      </For>
+    </box>
+  )
+}
+
+function SprintSidebar(props: { sprints: DiscoveredSprint[] }) {
+  const display = props.sprints.slice(0, 3)
+
+  return (
+    <box>
+      <For each={display}>
+        {(sprint: DiscoveredSprint, i: () => number) => (
+          <>
+            <Show when={i() > 0}>
+              <text>---</text>
+            </Show>
+            <SprintCard sprint={sprint} />
+          </>
+        )}
+      </For>
+      <Show when={props.sprints.length > 3}>
+        <text>... +{props.sprints.length - 3} more</text>
+      </Show>
+    </box>
+  )
+}
+
+function renderContent(sprints: DiscoveredSprint[], upgradeNotice: string | null, dir: string) {
+  const components: any[] = []
+
+  if (sprints.length > 0) {
+    if (upgradeNotice) components.push(<text>{upgradeNotice}</text>)
+    components.push(<SprintSidebar sprints={sprints} />)
+    return components.length > 1 ? <box>{components}</box> : components[0]
+  }
+
+  const hasStateDir = existsSync(join(dir, ".sprint-state"))
+  const gitRoot = findGitRoot(dir)
+  const hasWorktreesRoot = gitRoot ? existsSync(join(gitRoot, ".worktrees")) : false
+
+  if (hasStateDir) return <box>{upgradeNotice ? <text>{upgradeNotice}</text> : null}<text><b>SPRINT FLOW</b></text><text>  -> Initializing...</text></box>
+  if (hasWorktreesRoot) return <box>{upgradeNotice ? <text>{upgradeNotice}</text> : null}<text><b>SPRINT FLOW</b></text><text>  · Ready...</text></box>
+  if (upgradeNotice) return <box><text>{upgradeNotice}</text></box>
+
+  return null
+}
+
+// ── TUI Slot Plugin ──
+
+const tuiPlugin: TuiSlotPlugin = {
+  slots: {
+    sidebar_content: (_props: TuiSlotProps) => {
+      const dir = process.env.XP_GATE_PROJECT_DIR || process.cwd();
+      const now = Date.now();
+
+      if (_cache && _cache.dir === dir && now - _cache.ts < CACHE_TTL_MS) {
+        return renderContent(_cache.data, _cache.upgradeNotice, dir);
+      }
+
+      const sprints = discoverActiveSprints(dir);
+      const upgradeNotice = readUpgradeNotice()
+      _cache = { data: sprints, ts: now, dir, upgradeNotice };
+      return renderContent(sprints, upgradeNotice, dir);
+    },
+  },
+}
+
+const plugin: TuiPlugin = async (api, _options, _meta) => {
+  api.slots.register(tuiPlugin)
+}
+
+export { plugin as tui, readSprintState }

package/plugins/qoder/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.10.16",
+  "version": "0.10.17",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Qoder. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/qoder/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.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/plugins/qoder/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.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/plugins/qoder/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/principles/AGENTS.md

@@ -1,9 +1,9 @@
 # PRINCIPLES CHECKER MODULE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Clean Code & SOLID principles checker — **Gate 4** of pre-commit. 14 rules × 9 language adapters, SARIF 2.1.0 output. Houses the **Boy Scout Rule** enforcement engine (Gate 6) and warning-baseline storage.

package/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-06-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.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-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → SHIP → LAND → USER ACCEPTANCE → FEEDBACK → 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-25
-**Commit:** 463f7e6
+**Generated:** 2026-06-26
+**Commit:** afab469
 **Branch:** main
-**Version:** 0.10.16.0
+**Version:** 0.10.17.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.