@boyingliu01/xp-gate 0.9.2 → 0.9.3

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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.9.2",
+  "version": "0.9.3",
   "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.9.2",
+  "version": "0.9.3",
   "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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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/claude-code/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/__tests__/tui-plugin.test.ts

@@ -0,0 +1,306 @@
+/**
+ * TUI Slot Plugin tests
+ *
+ * Tests for pure functions:
+ * - readSprintState: file I/O + JSON parse
+ * - isStale: staleness detection
+ * - statusSymbol: status → icon mapping
+ * - renderPhaseLine: single phase → formatted line
+ * - renderSprintSidebar: full state → sidebar string
+ */
+
+import { describe, it, before, after } from "node:test"
+import assert from "node:assert/strict"
+import { randomUUID } from "node:crypto"
+import { mkdirSync, writeFileSync, existsSync, rmSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir } from "node:os"
+
+// Import the functions under test
+// Since the file uses type-only imports from @opencode-ai/plugin/tui,
+// test runner provides a separate copy of the pure functions
+import { readSprintState, renderSprintSidebar } from "../tui-plugin.ts"
+
+// Duplicate helpers here to test in isolation
+function isStale(state: { started_at?: string; phase_history?: Array<{ started_at?: string; completed_at?: string }> }): boolean {
+  if (!state || !state.started_at) return false
+  const started = new Date(state.started_at).getTime()
+  if (isNaN(started)) return false
+  let latest = started
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      if (ph.completed_at) {
+        const t = new Date(ph.completed_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+      if (ph.started_at) {
+        const t = new Date(ph.started_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+    }
+  }
+  return Date.now() - latest > 3_600_000
+}
+
+function statusSymbol(status: string | undefined, key: string, currentPhase: string | number | undefined): string {
+  if (status === "completed") return "✓"
+  if (status === "in_progress") return "→"
+  if (String(currentPhase) === key) return "·"
+  return "○"
+}
+
+const PHASE_NAMES: Record<string, string> = {
+  "-1": "ISOLATE",
+  "-0.5": "AUTO-ESTIMATE",
+  "0": "THINK",
+  "1": "PLAN",
+  "2": "BUILD",
+  "3": "REVIEW",
+  "4": "USER ACCEPT",
+  "5": "FEEDBACK",
+  "6": "SHIP",
+  "7": "LAND",
+  "8": "CLEANUP",
+}
+
+function renderPhaseLine(key: string, history: { status?: string; phase_name?: string } | undefined, currentPhase: string | number | undefined): string {
+  const name = history?.phase_name || PHASE_NAMES[key] || key
+  const status = history?.status || (String(currentPhase) === key ? "in_progress" : "pending")
+  const sym = statusSymbol(status, key, currentPhase)
+  return `${sym} ${name.padEnd(14)} ${status === "completed" ? "done" : status === "in_progress" ? "active" : ""}`
+    .replace(/\s+$/, "")
+}
+
+// ── Test fixtures ──
+
+function makeSprintState(overrides: Record<string, unknown> = {}) {
+  const base = {
+    id: "sprint-001",
+    phase: "2",
+    status: "in_progress",
+    started_at: new Date(Date.now() - 3_600_000).toISOString(),
+    task_description: "Implement user login with OAuth2",
+    metrics: { tests_passed: 42, coverage_pct: 87 },
+    phase_history: [
+      { phase: "-1", phase_name: "ISOLATE", status: "completed" as const, started_at: new Date(Date.now() - 86_400_000).toISOString(), completed_at: new Date(Date.now() - 86_000_000).toISOString() },
+      { phase: "0", status: "completed" as const, started_at: new Date(Date.now() - 86_000_000).toISOString(), completed_at: new Date(Date.now() - 72_000_000).toISOString() },
+      { phase: "1", status: "completed" as const, started_at: new Date(Date.now() - 72_000_000).toISOString(), completed_at: new Date(Date.now() - 36_000_000).toISOString() },
+      { phase: "2", status: "in_progress" as const, reqs: { "REQ-001": { name: "JWT auth", status: "completed" as const }, "REQ-002": { name: "OAuth2 flow", status: "in_progress" as const } } },
+    ],
+  }
+  return { ...base, ...overrides } as any
+}
+
+// ── isStale ──
+
+void describe("isStale", () => {
+  void it("returns false when state has no started_at", () => {
+    assert.equal(isStale({}), false)
+  })
+
+  void it("returns false when started_at is recent", () => {
+    const state = { started_at: new Date().toISOString() }
+    assert.equal(isStale(state), false)
+  })
+
+  void it("returns true when started_at is >1h ago and no phase_history", () => {
+    const state = { started_at: new Date(Date.now() - 7_200_000).toISOString() }
+    assert.equal(isStale(state), true)
+  })
+
+  void it("returns false when latest phase_history is recent", () => {
+    const state = {
+      started_at: new Date(Date.now() - 7_200_000).toISOString(),
+      phase_history: [
+        { phase: "0", started_at: new Date(Date.now() - 3_600_000).toISOString(), completed_at: new Date(Date.now() - 60_000).toISOString() },
+      ],
+    }
+    assert.equal(isStale(state), false)
+  })
+
+  void it("returns true when all activity is >1h ago", () => {
+    const state = {
+      started_at: new Date(Date.now() - 86_400_000).toISOString(),
+      phase_history: [
+        { phase: "-1", started_at: new Date(Date.now() - 86_000_000).toISOString(), completed_at: new Date(Date.now() - 85_000_000).toISOString() },
+      ],
+    }
+    assert.equal(isStale(state), true)
+  })
+
+  void it("returns false when started_at is invalid date", () => {
+    const state = { started_at: "not-a-date" }
+    assert.equal(isStale(state), false)
+  })
+})
+
+// ── statusSymbol ──
+
+void describe("statusSymbol", () => {
+  void it("returns ✓ for completed", () => {
+    assert.equal(statusSymbol("completed", "0", undefined), "✓")
+  })
+
+  void it("returns → for in_progress", () => {
+    assert.equal(statusSymbol("in_progress", "1", undefined), "→")
+  })
+
+  void it("returns · when key matches currentPhase", () => {
+    assert.equal(statusSymbol(undefined, "2", "2"), "·")
+  })
+
+  void it("returns ○ for pending (no match)", () => {
+    assert.equal(statusSymbol("pending", "3", "2"), "○")
+  })
+
+  void it("returns ✓ for completed even when key matches", () => {
+    // completed takes priority over currentPhase match
+    assert.equal(statusSymbol("completed", "2", "2"), "✓")
+  })
+})
+
+// ── renderPhaseLine ──
+
+void describe("renderPhaseLine", () => {
+  void it("renders completed phase", () => {
+    const line = renderPhaseLine("0", { status: "completed" }, "2")
+    assert.ok(line.includes("✓"))
+    assert.ok(line.includes("THINK"))
+    assert.ok(line.includes("done"))
+  })
+
+  void it("renders in_progress phase", () => {
+    const line = renderPhaseLine("2", { status: "in_progress" }, "2")
+    assert.ok(line.includes("→"))
+    assert.ok(line.includes("BUILD"))
+    assert.ok(line.includes("active"))
+  })
+
+  void it("renders pending phase (current phase match)", () => {
+    const line = renderPhaseLine("3", undefined, "2")
+    assert.ok(line.includes("○"))
+    assert.ok(line.includes("REVIEW"))
+  })
+
+  void it("renders current phase with arrow when no history entry (current assigned in_progress)", () => {
+    const line = renderPhaseLine("2", undefined, "2")
+    assert.ok(line.includes("→"))
+    assert.ok(line.includes("BUILD"))
+    assert.ok(line.includes("active"))
+  })
+
+  void it("uses custom phase_name from history", () => {
+    const line = renderPhaseLine("2", { status: "completed", phase_name: "MY BUILD" }, "2")
+    assert.ok(line.includes("MY BUILD"))
+  })
+})
+
+// ── readSprintState ──
+
+void describe("readSprintState", () => {
+  const tmpDir = join(tmpdir(), "xp-gate-tui-test-" + randomUUID())
+
+  before(() => {
+    mkdirSync(join(tmpDir, ".sprint-state"), { recursive: true })
+  })
+
+  after(() => {
+    rmSync(tmpDir, { recursive: true, force: true })
+  })
+
+  void it("returns null when no sprint-state.json", () => {
+    assert.equal(readSprintState(tmpDir), null)
+  })
+
+  void it("returns parsed state when file exists", () => {
+    const state = { id: "test", phase: "1", task_description: "Test" }
+    writeFileSync(join(tmpDir, ".sprint-state", "sprint-state.json"), JSON.stringify(state))
+    const result = readSprintState(tmpDir)
+    assert.notEqual(result, null)
+    assert.equal(result?.id, "test")
+    assert.equal(result?.phase, "1")
+  })
+
+  void it("returns null on malformed JSON", () => {
+    writeFileSync(join(tmpDir, ".sprint-state", "sprint-state.json"), "{not-json")
+    assert.equal(readSprintState(tmpDir), null)
+  })
+
+  void it("returns null when directory does not exist", () => {
+    assert.equal(readSprintState("/nonexistent/path"), null)
+  })
+})
+
+// ── renderSprintSidebar ──
+
+void describe("renderSprintSidebar", () => {
+  void it("returns empty string for null state", () => {
+    assert.equal(renderSprintSidebar(null as unknown as Parameters<typeof renderSprintSidebar>[0]), "")
+  })
+
+  void it("returns empty string when no task_description", () => {
+    assert.equal(renderSprintSidebar({} as Parameters<typeof renderSprintSidebar>[0]), "")
+  })
+
+  void it("includes sprint title on first line", () => {
+    const output = renderSprintSidebar(makeSprintState())
+    const lines = output.split("\n")
+    assert.ok(lines[0].includes("SPRINT:"))
+    assert.ok(lines[0].includes("OAuth2"))
+  })
+
+  void it("includes metrics when available", () => {
+    const output = renderSprintSidebar(makeSprintState())
+    assert.ok(output.includes("tests:42"))
+    assert.ok(output.includes("cov:87%"))
+  })
+
+  void it("omits metrics section when none present", () => {
+    const output = renderSprintSidebar(makeSprintState({ metrics: {} }))
+    assert.ok(!output.includes("tests:"))
+    assert.ok(!output.includes("cov:"))
+  })
+
+  void it("shows stale warning when >1h idle", () => {
+    const state = makeSprintState({ started_at: new Date(Date.now() - 7_200_000).toISOString(), phase_history: [] })
+    const output = renderSprintSidebar(state)
+    assert.ok(output.includes("idle"))
+  })
+
+  void it("does not show stale warning when recent activity", () => {
+    const state = makeSprintState({
+      started_at: new Date(Date.now() - 7_200_000).toISOString(),
+      phase_history: [
+        { phase: "0", started_at: new Date().toISOString(), completed_at: new Date().toISOString() },
+      ],
+    })
+    const output = renderSprintSidebar(state)
+    assert.ok(!output.includes("idle"))
+  })
+
+  void it("shows phases with activity or current", () => {
+    const output = renderSprintSidebar(makeSprintState())
+    // Should show ISOLATE (completed in history), THINK, PLAN, BUILD (current)
+    assert.ok(output.includes("ISOLATE"))
+    assert.ok(output.includes("THINK"))
+    assert.ok(output.includes("PLAN"))
+    assert.ok(output.includes("BUILD"))
+    // Should NOT show REVIEW, FEEDBACK, etc. (no history, not current)
+    assert.ok(!output.includes("REVIEW"))
+    assert.ok(!output.includes("FEEDBACK"))
+  })
+
+  void it("shows REQ-level progress for BUILD phase", () => {
+    const output = renderSprintSidebar(makeSprintState())
+    assert.ok(output.includes("JWT"))
+    assert.ok(output.includes("OAuth2"))
+  })
+
+  void it("renders correct status symbols per phase", () => {
+    const output = renderSprintSidebar(makeSprintState())
+    // ISOLATE completed → ✓
+    const lines = output.split("\n")
+    const isolateLine = lines.find((l: string) => l.includes("ISOLATE"))
+    assert.ok(isolateLine && isolateLine.startsWith("✓"), `Expected ISOLATE line to start with ✓, got: ${isolateLine}`)
+  })
+})

package/plugins/opencode/__tests__/xp-gate-update.test.ts

@@ -0,0 +1,255 @@
+/**
+ * XP-Gate auto-update tests
+ *
+ * Tests for:
+ * - semverLt: version comparison
+ * - checkXpGateUpdate: xp-gate npm registry check + cache + auto-upgrade
+ * - chat.message integration
+ * - Legacy checkPluginUpdate modified to detect BOTH packages
+ */
+
+import { describe, it, before, after } from "node:test"
+import assert from "node:assert/strict"
+import { randomUUID } from "node:crypto"
+import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from "node:fs"
+import { join } from "node:path"
+import { tmpdir, homedir } from "node:os"
+import { execSync } from "node:child_process"
+
+// ── Pure function: semverLt ──
+
+function semverLt(a: string, b: string): boolean {
+  const pa = a.replace(/^v/, "").split(".").map(Number)
+  const pb = b.replace(/^v/, "").split(".").map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0
+    const nb = pb[i] ?? 0
+    if (na !== nb) return na < nb
+  }
+  return false
+}
+
+// ── XP-GATE specific: these are the new functions we need to implement ──
+
+const XP_GATE_CACHE_FILE = join(homedir(), ".xp-gate", "xp-gate-version-check.json")
+const XP_GATE_NPM_PKG = "@boyingliu01/xp-gate"
+const XP_GATE_REGISTRY_URL = `https://registry.npmjs.org/-/package/${encodeURIComponent(XP_GATE_NPM_PKG)}/dist-tags`
+const CACHE_TTL_MS = 86_400_000 // 24h
+
+type XpGateCache = {
+  ts: number
+  localVersion: string
+  remoteVersion: string
+  status?: "current" | "upgraded"
+}
+
+/**
+ * Read version from installed xp-gate npm package.
+ * Returns null if not installed.
+ */
+function getLocalXpGateVersion(): string | null {
+  try {
+    const pkgPath = join(
+      execSync("npm root -g", { encoding: "utf8" }).trim(),
+      XP_GATE_NPM_PKG,
+      "package.json"
+    )
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"))
+    return pkg.version || null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Read cache file, returns null if absent / stale.
+ */
+function readXpGateCache(): XpGateCache | null {
+  try {
+    if (!existsSync(XP_GATE_CACHE_FILE)) return null
+    const raw = readFileSync(XP_GATE_CACHE_FILE, "utf8")
+    const data: XpGateCache = JSON.parse(raw)
+    if (Date.now() - data.ts < CACHE_TTL_MS && data.remoteVersion) {
+      return data
+    }
+    return null // stale
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Write cache file.
+ */
+function writeXpGateCache(data: XpGateCache): void {
+  try {
+    mkdirSync(join(homedir(), ".xp-gate"), { recursive: true })
+    const tmp = XP_GATE_CACHE_FILE + ".tmp." + process.pid
+    writeFileSync(tmp, JSON.stringify(data), "utf8")
+    try { rmSync(XP_GATE_CACHE_FILE) } catch {}
+    const orig = readFileSync(tmp, "utf8")
+    writeFileSync(XP_GATE_CACHE_FILE, orig, "utf8")
+    rmSync(tmp)
+  } catch {
+    // silent
+  }
+}
+
+/**
+ * Fetch latest version from npm registry. Returns null on failure.
+ */
+async function fetchNpmLatestVersion(url: string, timeoutMs = 5000): Promise<string | null> {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeoutMs)
+  try {
+    const response = await fetch(url, { signal: controller.signal })
+    if (!response.ok) return null
+    const data: Record<string, unknown> = await response.json()
+    const latest = data.latest
+    return typeof latest === "string" ? latest : null
+  } catch {
+    return null
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+type UpgradeResult = {
+  action: "noop" | "upgraded" | "error"
+  localVersion: string | null
+  remoteVersion: string | null
+  error?: string
+}
+
+/**
+ * Check xp-gate version and auto-upgrade if outdated.
+ *
+ * - Respects daily cache
+ * - Fires npm install -g in background
+ * - Returns result for user notification
+ */
+async function checkXpGateUpdate(): Promise<UpgradeResult> {
+  // 1. Check cache
+  const cached = readXpGateCache()
+  if (cached && cached.status === "current") {
+    return { action: "noop", localVersion: cached.localVersion, remoteVersion: cached.remoteVersion }
+  }
+
+  // 2. Get local version
+  const localVersion = getLocalXpGateVersion()
+  if (!localVersion) {
+    return { action: "noop", localVersion: null, remoteVersion: null }
+  }
+
+  // 3. Fetch remote
+  const remoteVersion = await fetchNpmLatestVersion(XP_GATE_REGISTRY_URL)
+  if (!remoteVersion) {
+    return { action: "noop", localVersion, remoteVersion: null }
+  }
+
+  // 4. Compare
+  if (!semverLt(localVersion, remoteVersion)) {
+    writeXpGateCache({ ts: Date.now(), localVersion, remoteVersion, status: "current" })
+    return { action: "noop", localVersion, remoteVersion }
+  }
+
+  // 5. Outdated — auto upgrade
+  writeXpGateCache({ ts: Date.now(), localVersion, remoteVersion })
+  try {
+    execSync(`npm install -g ${XP_GATE_NPM_PKG}@${remoteVersion}`, {
+      stdio: "pipe",
+      timeout: 120_000,
+    })
+    writeXpGateCache({ ts: Date.now(), localVersion: remoteVersion, remoteVersion, status: "current" })
+    return { action: "upgraded", localVersion, remoteVersion }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    return { action: "error", localVersion, remoteVersion, error: msg }
+  }
+}
+
+// ── Tests ──
+
+void describe("semverLt", () => {
+  void it("returns true when local < remote", () => {
+    assert.equal(semverLt("0.9.1", "0.9.2"), true)
+  })
+
+  void it("returns false when local > remote", () => {
+    assert.equal(semverLt("0.9.3", "0.9.2"), false)
+  })
+
+  void it("returns false when versions equal", () => {
+    assert.equal(semverLt("0.9.2", "0.9.2"), false)
+  })
+
+  void it("handles 'v' prefix", () => {
+    assert.equal(semverLt("v0.9.1", "v0.9.2"), true)
+  })
+
+  void it("handles mixed prefix", () => {
+    assert.equal(semverLt("v0.9.1", "0.9.2"), true)
+  })
+
+  void it("handles different segment counts", () => {
+    assert.equal(semverLt("0.9", "0.9.2"), true)
+  })
+
+  void it("handles major version bumps", () => {
+    assert.equal(semverLt("0.9.2", "1.0.0"), true)
+  })
+
+  void it("returns false for identical versions with v prefix", () => {
+    assert.equal(semverLt("v1.0.0", "1.0.0"), false)
+  })
+})
+
+void describe("checkXpGateUpdate — cache & upgrade", () => {
+  const fakeHome = join(tmpdir(), "xp-gate-upd-test-" + randomUUID())
+  const origHome = process.env.HOME
+
+  before(() => {
+    process.env.HOME = fakeHome
+    mkdirSync(join(fakeHome, ".xp-gate"), { recursive: true })
+  })
+
+  after(() => {
+    process.env.HOME = origHome
+    rmSync(fakeHome, { recursive: true, force: true })
+  })
+
+  void it("returns noop when no xp-gate installed locally", async () => {
+    const result = await checkXpGateUpdate()
+    assert.equal(result.action, "noop")
+    // localVersion may be null (no install) or the actual version (test env has global)
+    // Either is acceptable — the key behavior is noop, not the value
+  })
+
+  void it("returns noop when cache says current", async () => {
+    const cachePath = join(fakeHome, ".xp-gate", "xp-gate-version-check.json")
+    writeFileSync(cachePath, JSON.stringify({
+      ts: Date.now(),
+      localVersion: "0.9.2",
+      remoteVersion: "0.9.2",
+      status: "current",
+    }))
+
+    const result = await checkXpGateUpdate()
+    assert.equal(result.action, "noop")
+    assert.equal(result.remoteVersion, "0.9.2")
+  })
+
+  void it("handles cache expiry correctly", async () => {
+    const cachePath = join(fakeHome, ".xp-gate", "xp-gate-version-check.json")
+    writeFileSync(cachePath, JSON.stringify({
+      ts: Date.now() - 86_400_000 - 3600_000, // 25h old
+      localVersion: "0.9.1",
+      remoteVersion: "0.9.2",
+    }))
+
+    const result = await checkXpGateUpdate()
+    // Stale cache should be ignored — should check npm registry
+    // If network check fails, returns noop with localVersion if found
+    assert.equal(result.action, "noop")
+  })
+})

package/plugins/opencode/index.ts

@@ -1,8 +1,8 @@
 import { tool } from "@opencode-ai/plugin"
 import { z } from "zod"
-import { exec } from "child_process"
-import { promisify } from "util"
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs"
+import { exec, execSync } from "node:child_process"
+import { promisify } from "node:util"
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs"
 import { join } from "node:path"
 import { homedir } from "node:os"
 
@@ -13,6 +13,158 @@ interface OpenCodePluginInput {
   $: (strings: TemplateStringsArray, ...values: unknown[]) => Promise<{ text(): Promise<string> }>
 }
 
+// ── Constants ──
+
+const CACHE_TTL_MS = 86_400_000 // 24h
+const FETCH_TIMEOUT_MS = 5_000
+
+const XP_GATE_NPM_PKG = "@boyingliu01/xp-gate"
+const XP_GATE_CACHE_FILE = join(homedir(), ".xp-gate", "xp-gate-version-check.json")
+const XP_GATE_REGISTRY_URL = `https://registry.npmjs.org/-/package/${encodeURIComponent(XP_GATE_NPM_PKG)}/dist-tags`
+
+const OPENCODE_PLUGIN_REGISTRY = "https://registry.npmjs.org/-/package/@boyingliu01%2Fopencode-plugin/dist-tags"
+const OPENCODE_CACHE_FILE = join(homedir(), ".xp-gate", "opencode-plugin-version-check.json")
+
+let checked = false
+
+// ── Utilities ──
+
+function semverLt(a: string, b: string): boolean {
+  const pa = a.replace(/^v/, "").split(".").map(Number)
+  const pb = b.replace(/^v/, "").split(".").map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0
+    const nb = pb[i] ?? 0
+    if (na !== nb) return na < nb
+  }
+  return false
+}
+
+async function fetchNpmLatestVersion(url: string): Promise<string | null> {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
+  try {
+    const response = await fetch(url, { signal: controller.signal })
+    if (!response.ok) return null
+    const data: Record<string, unknown> = await response.json()
+    return typeof data.latest === "string" ? data.latest : null
+  } catch {
+    return null
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+function readCache(file: string): { ts: number; remoteVersion: string; status?: string } | null {
+  try {
+    if (!existsSync(file)) return null
+    const raw = readFileSync(file, "utf8")
+    const data = JSON.parse(raw)
+    if (Date.now() - data.ts < CACHE_TTL_MS && data.remoteVersion) return data
+    return null
+  } catch {
+    return null
+  }
+}
+
+function writeCache(file: string, data: object): void {
+  try {
+    mkdirSync(join(homedir(), ".xp-gate"), { recursive: true })
+    writeFileSync(file + ".tmp", JSON.stringify(data), "utf8")
+    try { rmSync(file) } catch {}
+    writeFileSync(file, readFileSync(file + ".tmp", "utf8"), "utf8")
+    try { rmSync(file + ".tmp") } catch {}
+  } catch {
+    // silent
+  }
+}
+
+// ── XP-Gate npm package auto-update ──
+
+type UpgradeResult = {
+  action: "noop" | "upgraded" | "error"
+  localVersion: string | null
+  remoteVersion: string | null
+  error?: string
+}
+
+function getLocalXpGateVersion(): string | null {
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf8" }).trim()
+    const pkg = JSON.parse(readFileSync(join(globalRoot, XP_GATE_NPM_PKG, "package.json"), "utf8"))
+    return pkg.version || null
+  } catch {
+    return 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 (!localVersion) return { action: "noop", localVersion: null, remoteVersion: null }
+
+  const remoteVersion = await fetchNpmLatestVersion(XP_GATE_REGISTRY_URL)
+  if (!remoteVersion) return { action: "noop", localVersion, remoteVersion: null }
+
+  if (!semverLt(localVersion, remoteVersion)) {
+    writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion, status: "current" })
+    return { action: "noop", localVersion, remoteVersion }
+  }
+
+  writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion })
+  try {
+    execSync(`npm install -g ${XP_GATE_NPM_PKG}@${remoteVersion}`, { stdio: "pipe", timeout: 120_000 })
+    writeCache(XP_GATE_CACHE_FILE, { ts: Date.now(), localVersion: remoteVersion, remoteVersion, status: "current" })
+    return { action: "upgraded", localVersion, remoteVersion }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    return { action: "error", localVersion, remoteVersion, error: msg }
+  }
+}
+
+// ── OpenCode plugin version check (notification only) ──
+
+async function checkPluginUpdate(pluginDir: string): Promise<void> {
+  const cached = readCache(OPENCODE_CACHE_FILE)
+  if (cached?.status === "current" && cached.remoteVersion) return
+
+  let localVersion = ""
+  try {
+    const pkg = JSON.parse(readFileSync(join(pluginDir, "package.json"), "utf8"))
+    localVersion = pkg.version || ""
+  } catch {
+    return
+  }
+
+  const remoteVersion = await fetchNpmLatestVersion(OPENCODE_PLUGIN_REGISTRY)
+  if (!remoteVersion) return
+
+  if (remoteVersion && localVersion && semverLt(localVersion, remoteVersion)) {
+    writeCache(OPENCODE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion })
+  } else if (remoteVersion && localVersion) {
+    writeCache(OPENCODE_CACHE_FILE, { ts: Date.now(), localVersion, remoteVersion, status: "current" })
+  }
+}
+
+// ── Combined background check (runs once on first chat.message) ──
+
+async function runBackgroundUpdates(pluginDir: string): Promise<string | null> {
+  const result = await checkXpGateUpdate()
+  await checkPluginUpdate(pluginDir)
+
+  if (result.action === "upgraded") {
+    return `[XP-Gate] Auto-upgraded from v${result.localVersion} to v${result.remoteVersion}`
+  }
+  if (result.action === "error") {
+    return `[XP-Gate] Upgrade check: v${result.remoteVersion} available (auto-upgrade failed: ${result.error})`
+  }
+  return null
+}
+
 async function runCmd(cmd: string, cwd: string): Promise<string> {
   try {
     const { stdout } = await execAsync(cmd, { cwd, timeout: 30000 })
@@ -49,77 +201,6 @@ async function getUpgradeSuggestion(cwd: string): Promise<string> {
   }
 }
 
-// ── Auto-update check for opencode-plugin ──
-
-const CACHE_TTL_MS = 86_400_000
-const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/@boyingliu01%2Fopencode-plugin/dist-tags"
-const FETCH_TIMEOUT_MS = 5_000
-const CACHE_FILE = join(homedir(), ".xp-gate", "opencode-plugin-version-check.json")
-
-let checked = false
-let checkInFlight: Promise<void> | null = null
-
-function semverLt(a: string, b: string): boolean {
-  const pa = a.replace(/^v/, "").split(".").map(Number)
-  const pb = b.replace(/^v/, "").split(".").map(Number)
-  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
-    const na = pa[i] ?? 0
-    const nb = pb[i] ?? 0
-    if (na !== nb) return na < nb
-  }
-  return false
-}
-
-async function checkPluginUpdate(pluginDir: string): Promise<void> {
-  if (checkInFlight) return
-
-  checkInFlight = (async () => {
-    try {
-      mkdirSync(join(homedir(), ".xp-gate"), { recursive: true })
-
-      if (existsSync(CACHE_FILE)) {
-        const cached = JSON.parse(readFileSync(CACHE_FILE, "utf8"))
-        if (Date.now() - cached.ts < CACHE_TTL_MS) return
-      }
-
-      let localVersion = ""
-      try {
-        const pkg = JSON.parse(readFileSync(join(pluginDir, "package.json"), "utf8"))
-        localVersion = pkg.version || ""
-      } catch {
-        return
-      }
-
-      const controller = new AbortController()
-      const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
-      try {
-        const response = await fetch(NPM_REGISTRY_URL, { signal: controller.signal })
-        if (!response.ok) return
-        const data: Record<string, unknown> = await response.json()
-        const remoteVersion = String(data.latest || "")
-
-        if (remoteVersion && localVersion && semverLt(localVersion, remoteVersion)) {
-          writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), localVersion, remoteVersion }))
-          process.stderr.write(
-            `[XP-Gate] New opencode-plugin version v${remoteVersion} available (you have v${localVersion})\n` +
-            `[XP-Gate] Update with: cd ~/.config/opencode && npm update @boyingliu01/opencode-plugin\n`
-          )
-        } else if (remoteVersion && localVersion) {
-          // Cache "up to date" to avoid re-fetching every session
-          writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), localVersion, remoteVersion, status: "current" }))
-        }
-      } finally {
-        clearTimeout(timer)
-      }
-    } catch {
-      // All errors silently ignored
-    }
-  })()
-
-  await checkInFlight
-  checkInFlight = null
-}
-
 // ── Plugin definition ──
 
 export const XpGatePlugin = async (input: OpenCodePluginInput) => {
@@ -184,7 +265,9 @@ export const XpGatePlugin = async (input: OpenCodePluginInput) => {
     "chat.message": async (_input: { message: string }) => {
       if (!checked) {
         checked = true
-        checkPluginUpdate(directory).catch((_err) => { /* silent: non-critical background check */ })
+        runBackgroundUpdates(directory).then((msg) => {
+          if (msg) process.stderr.write(`${msg}\n`)
+        })
       }
       return { action: "continue" }
     },

package/plugins/opencode/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "type": "module",
   "main": "index.ts",
-  "description": "XP-Gate quality gates + AI workflow skills for OpenCode",
+  "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",
   "repository": {
     "type": "git",
     "url": "https://github.com/boyingliu01/xp-gate",
@@ -13,8 +13,19 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./tui": {
+      "import": "./tui-plugin.ts",
+      "types": "./tui-plugin.ts"
+    }
+  },
   "files": [
     "index.ts",
+    "tui-plugin.ts",
     "skills/",
     "tsconfig.json",
     "README.md"
@@ -24,7 +35,7 @@
     "check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.15.0"
+    "@opencode-ai/plugin": "^1.17.8"
   },
   "devDependencies": {
     "typescript": "^5.4.0"

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

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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/opencode/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/tsconfig.json

@@ -10,6 +10,6 @@
     "declaration": false,
     "noEmit": true
   },
-  "include": ["index.ts"],
+  "include": ["index.ts", "tui-plugin.ts"],
   "exclude": ["node_modules", "dist", "skills"]
 }

package/plugins/opencode/tui-plugin.ts

@@ -0,0 +1,188 @@
+/**
+ * XP-Gate OpenCode TUI Slot Plugin
+ *
+ * Registers sidebar_content slot to display Sprint Flow progress
+ * from .sprint-state/sprint-state.json.
+ *
+ * This is a separate plugin file because SDK 1.x PluginModule does not
+ * support server + tui in the same module. Users register this file
+ * in ~/.config/opencode/tui.json as:
+ *   { "plugin": ["@boyingliu01/opencode-plugin/tui"] }
+ *
+ * The npm package exports "./tui" from package.json for this resolution.
+ */
+
+import { existsSync, readFileSync } from "node:fs"
+import { join } from "node:path"
+import type { TuiPlugin, TuiSlotPlugin, TuiSlotProps } from "@opencode-ai/plugin/tui"
+
+// ── Sprint state schema ──
+
+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[]
+}
+
+// ── Constants ──
+
+const PHASE_NAMES: Record<string, string> = {
+  "-1": "ISOLATE",
+  "-0.5": "AUTO-ESTIMATE",
+  "0": "THINK",
+  "1": "PLAN",
+  "2": "BUILD",
+  "3": "REVIEW",
+  "4": "USER ACCEPT",
+  "5": "FEEDBACK",
+  "6": "SHIP",
+  "7": "LAND",
+  "8": "CLEANUP",
+}
+
+const PHASE_ORDER = ["-1", "-0.5", "0", "1", "2", "3", "4", "5", "6", "7", "8"]
+
+// ── Helpers ──
+
+function readSprintState(dir: string): SprintState | null {
+  try {
+    const stateFile = join(dir, ".sprint-state", "sprint-state.json")
+    if (!existsSync(stateFile)) return null
+    return JSON.parse(readFileSync(stateFile, "utf8"))
+  } catch {
+    return null
+  }
+}
+
+function isStale(state: SprintState): boolean {
+  if (!state || !state.started_at) return false
+  const started = new Date(state.started_at).getTime()
+  if (isNaN(started)) return false
+  let latest = started
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      if (ph.completed_at) {
+        const t = new Date(ph.completed_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+      if (ph.started_at) {
+        const t = new Date(ph.started_at).getTime()
+        if (!isNaN(t) && t > latest) latest = t
+      }
+    }
+  }
+  return Date.now() - latest > 3_600_000
+}
+
+function statusSymbol(status: string | undefined, key: string, currentPhase: string | number | undefined): string {
+  if (status === "completed") return "✓"
+  if (status === "in_progress") return "→"
+  if (String(currentPhase) === key) return "·"
+  return "○"
+}
+
+function renderPhaseLine(key: string, history: SprintPhaseHistory | undefined, currentPhase: string | number | undefined): string {
+  const name = history?.phase_name || PHASE_NAMES[key] || key
+  const status = history?.status || (String(currentPhase) === key ? "in_progress" : "pending")
+  const sym = statusSymbol(status, key, currentPhase)
+  return `${sym} ${name.padEnd(14)} ${status === "completed" ? "done" : status === "in_progress" ? "active" : ""}`
+    .replace(/\s+$/, "")
+}
+
+function renderSprintSidebar(state: SprintState): string {
+  if (!state || !state.task_description) return ""
+
+  const lines: string[] = []
+  const metrics = state.metrics || {}
+  const currentPhase = state.phase
+
+  // Build lookup
+  const historyByPhase: Record<string, SprintPhaseHistory> = {}
+  if (Array.isArray(state.phase_history)) {
+    for (const ph of state.phase_history) {
+      historyByPhase[String(ph.phase)] = ph
+    }
+  }
+
+  // Title
+  lines.push(`SPRINT: ${state.task_description}`)
+
+  // Metrics
+  const metricParts: string[] = []
+  if (metrics.tests_passed != null) {
+    metricParts.push(`tests:${metrics.tests_passed}`)
+  }
+  if (metrics.coverage_pct != null) {
+    metricParts.push(`cov:${metrics.coverage_pct}%`)
+  }
+  if (metricParts.length > 0) {
+    lines.push(metricParts.join(" "))
+  }
+
+  // Stale warning
+  if (isStale(state)) {
+    lines.push("⚠ idle >1h")
+  }
+
+  // Phase progress
+  for (const key of PHASE_ORDER) {
+    const history = historyByPhase[key]
+    // Only show phases with activity or current
+    if (!history && String(currentPhase) !== key) continue
+    const line = renderPhaseLine(key, history, currentPhase)
+    lines.push(line)
+
+    // REQ-level progress for BUILD phase
+    if (key === "2" && history?.reqs) {
+      const reqNames = Object.entries(history.reqs)
+        .filter(([, r]) => r.name)
+        .map(([id, r]) => `  ${statusSymbol(r.status, id, undefined)} ${r.name}`)
+      if (reqNames.length > 0) lines.push(...reqNames)
+    }
+  }
+
+  return lines.join("\n")
+}
+
+// ── TUI Slot Plugin ──
+
+const tuiPlugin: TuiSlotPlugin = {
+  slots: {
+    sidebar_content: (_props: TuiSlotProps) => {
+      const dir = process.env.XP_GATE_PROJECT_DIR || process.cwd()
+      const state = readSprintState(dir)
+      if (!state) return null
+      const text = renderSprintSidebar(state)
+      if (!text) return null
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return text as any
+    },
+  },
+}
+
+// Wrap as TuiPlugin (async factory)
+const plugin: TuiPlugin = async (api, _options, _meta) => {
+  api.slots.register(tuiPlugin)
+}
+
+export { plugin as tui, readSprintState, renderSprintSidebar }

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

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.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-18
-**Commit:** 5ee2fa4
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.0.0
+**Version:** 0.9.3.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.