@boyingliu01/xp-gate 0.9.1 → 0.9.3

package/adapters/cpp.sh

@@ -13,12 +13,12 @@ _detect_cpp_build() {
 run_static_analysis() {
   if command -v clang-tidy &>/dev/null; then
     local files
-    files=$(find . -name "*.cpp" -o -name "*.cc" -o -name "*.c" -o -name "*.h" 2>/dev/null | head -20)
+    files=$(find . -name "*.cpp" -o -name "*.cc" -o -name "*.c" -o -name "*.h" 2>/dev/null | sed -n '1,20p; 20q')
     if [ -n "$files" ]; then
-      echo "$files" | xargs clang-tidy 2>&1 | head -20
+      echo "$files" | xargs clang-tidy 2>&1 | sed -n '1,20p; 20q'
     fi
   elif command -v cppcheck &>/dev/null; then
-    cppcheck --enable=all --inline-suppr . 2>&1 | head -20
+    cppcheck --enable=all --inline-suppr . 2>&1 | sed -n '1,20p; 20q'
   else
     echo "No C++ analysis tools (clang-tidy/cppcheck)"
     return 1

package/adapters/dart.sh

@@ -2,7 +2,7 @@
 
 run_static_analysis() {
   if command -v dart &>/dev/null; then
-    dart analyze 2>&1 | head -30
+    dart analyze 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "Dart SDK not available"
@@ -12,7 +12,7 @@ run_static_analysis() {
 
 run_lint() {
   if command -v dart &>/dev/null; then
-    dart format --output=none --set-exit-if-changed . 2>&1 | head -30
+    dart format --output=none --set-exit-if-changed . 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "Dart SDK not available"

package/adapters/flutter.sh

@@ -2,7 +2,7 @@
 
 run_static_analysis() {
   if command -v flutter &>/dev/null; then
-    flutter analyze 2>&1 | head -30
+    flutter analyze 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "Flutter SDK not available"
@@ -12,7 +12,7 @@ run_static_analysis() {
 
 run_lint() {
   if command -v flutter &>/dev/null; then
-    flutter format --output=none --set-exit-if-changed . 2>&1 | head -30
+    flutter format --output=none --set-exit-if-changed . 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "Flutter SDK not available"

package/adapters/java.sh

@@ -27,13 +27,13 @@ run_static_analysis() {
   build_system=$(_detect_java_build)
 
   if [ "$build_system" = "maven" ]; then
-    mvn compile -q 2>&1 | grep -i "error\|fail" | head -5
+    mvn compile -q 2>&1 | grep -i "error\|fail" | sed -n '1,5p; 5q'
     if [ "${PIPESTATUS[0]}" -ne 0 ]; then
       echo "❌ Maven compilation failed"
       return 1
     fi
   elif [ "$build_system" = "gradle" ]; then
-    gradle compileJava --quiet 2>&1 | grep -i "error\|fail" | head -5
+    gradle compileJava --quiet 2>&1 | grep -i "error\|fail" | sed -n '1,5p; 5q'
     if [ "${PIPESTATUS[0]}" -ne 0 ]; then
       echo "❌ Gradle compilation failed"
       return 1
@@ -42,12 +42,12 @@ run_static_analysis() {
 
   # CheckStyle with Google style (legacy fallback)
   if command -v checkstyle &>/dev/null; then
-    checkstyle -c /google_checks.xml . 2>&1 | head -20
+    checkstyle -c /google_checks.xml . 2>&1 | sed -n '1,20p; 20q'
   fi
 
   # PMD error detection (legacy fallback)
   if command -v pmd &>/dev/null; then
-    pmd check -d . -R category/java/errorprone.xml 2>&1 | head -20
+    pmd check -d . -R category/java/errorprone.xml 2>&1 | sed -n '1,20p; 20q'
   fi
 
   # p3c-pmd check (Alibaba coding guidelines) — primary Java quality gate

package/adapters/kotlin.sh

@@ -15,13 +15,13 @@ run_static_analysis() {
   build_system=$(_detect_kotlin_build)
 
   if [ "$build_system" = "maven" ]; then
-    mvn compile -q 2>&1 | grep -i "error\|fail" | head -5
+    mvn compile -q 2>&1 | grep -i "error\|fail" | sed -n '1,5p; 5q'
     if [ ${PIPESTATUS[0]} -ne 0 ]; then
       echo "❌ Maven compilation failed"
       return 1
     fi
   elif [ "$build_system" = "gradle" ]; then
-    gradle compileKotlin --quiet 2>&1 | grep -i "error\|fail" | head -5
+    gradle compileKotlin --quiet 2>&1 | grep -i "error\|fail" | sed -n '1,5p; 5q'
     if [ ${PIPESTATUS[0]} -ne 0 ]; then
       echo "❌ Gradle compilation failed"
       return 1
@@ -29,10 +29,10 @@ run_static_analysis() {
   fi
 
   if command -v ktlint &>/dev/null; then
-    ktlint "**/*.kt" 2>&1 | head -20
+    ktlint "**/*.kt" 2>&1 | sed -n '1,20p; 20q'
     return $?
   elif command -v detekt &>/dev/null; then
-    detekt --input . 2>&1 | head -20
+    detekt --input . 2>&1 | sed -n '1,20p; 20q'
     return $?
   else
     echo "No Kotlin lint tools (ktlint/detekt)"

package/adapters/objectivec.sh

@@ -2,10 +2,10 @@
 
 run_static_analysis() {
   if command -v oclint &>/dev/null; then
-    oclint-json-compilation-database 2>&1 | head -30
+    oclint-json-compilation-database 2>&1 | sed -n '1,30p; 30q'
     return $?
   elif command -v clang-tidy &>/dev/null; then
-    find . -name "*.m" -o -name "*.mm" -o -name "*.h" | head -20 | xargs clang-tidy 2>&1 | head -30
+    find . -name "*.m" -o -name "*.mm" -o -name "*.h" | sed -n '1,20p; 20q' | xargs clang-tidy 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "No Objective-C analysis tools available (oclint/clang-tidy)"

package/adapters/plugins/p3c-java/scripts/install-maven-p3c.sh

@@ -46,10 +46,10 @@ if grep -q '<profiles>' pom.xml; then
 
   # Use sed to insert before </profiles>
   # Find the line number of </profiles>
-  PROFILES_END_LINE=$(grep -n '</profiles>' pom.xml | head -1 | cut -d: -f1)
+  PROFILES_END_LINE=$(grep -n '</profiles>' pom.xml | sed -n '1p; 1q' | cut -d: -f1)
 
   if [ -n "$PROFILES_END_LINE" ]; then
-    head -n $((PROFILES_END_LINE - 1)) pom.xml > pom.xml.tmp
+    sed -n "1,$((PROFILES_END_LINE - 1))p; $((PROFILES_END_LINE - 1))q" pom.xml > pom.xml.tmp
     {
       echo ""
       echo "    <!-- XP-Gate: Alibaba p3c-pmd quality gate profile -->"
@@ -66,7 +66,7 @@ else
   PROJECT_END_LINE=$(grep -n '</project>' pom.xml | tail -1 | cut -d: -f1)
 
   if [ -n "$PROJECT_END_LINE" ]; then
-    head -n $((PROJECT_END_LINE - 1)) pom.xml > pom.xml.tmp
+    sed -n "1,$((PROJECT_END_LINE - 1))p; $((PROJECT_END_LINE - 1))q" pom.xml > pom.xml.tmp
     {
       echo ""
       echo "  <!-- XP-Gate: Alibaba p3c-pmd quality gate profile -->"

package/adapters/plugins/whalecloud-java/scripts/install-maven-whalecloud.sh

@@ -154,9 +154,9 @@ else
   echo "Step 2: Installing xp-gate-whalecloud-java profile into pom.xml..."
 
   if grep -q '<profiles>' pom.xml; then
-    PROFILES_END_LINE=$(grep -n '</profiles>' pom.xml | head -1 | cut -d: -f1)
+    PROFILES_END_LINE=$(grep -n '</profiles>' pom.xml | sed -n '1p; 1q' | cut -d: -f1)
     if [ -n "$PROFILES_END_LINE" ]; then
-      head -n $((PROFILES_END_LINE - 1)) pom.xml > pom.xml.tmp
+      sed -n "1,$((PROFILES_END_LINE - 1))p; $((PROFILES_END_LINE - 1))q" pom.xml > pom.xml.tmp
       {
         echo ""
         echo "    <!-- XP-Gate: WhaleCloud Java Coding Standards profile -->"
@@ -169,7 +169,7 @@ else
   else
     PROJECT_END_LINE=$(grep -n '</project>' pom.xml | tail -1 | cut -d: -f1)
     if [ -n "$PROJECT_END_LINE" ]; then
-      head -n $((PROJECT_END_LINE - 1)) pom.xml > pom.xml.tmp
+      sed -n "1,$((PROJECT_END_LINE - 1))p; $((PROJECT_END_LINE - 1))q" pom.xml > pom.xml.tmp
       {
         echo ""
         echo "  <!-- XP-Gate: WhaleCloud Java Coding Standards profile -->"

package/adapters/powershell.sh

@@ -72,7 +72,7 @@ run_tests() {
     test_paths="test/"
   fi
 
-  if [ -n "$test_paths" ] && find "$test_paths" -name "*.Tests.ps1" -type f 2>/dev/null | head -1 | grep -q "."; then
+  if [ -n "$test_paths" ] && find "$test_paths" -name "*.Tests.ps1" -type f 2>/dev/null | sed -n '1p; 1q' | grep -q "."; then
     echo "Running Pester tests..."
     "$PWSH" -NoProfile -Command "
       \$results = Invoke-Pester -Path '$test_paths' -PassThru
@@ -84,7 +84,7 @@ run_tests() {
       exit 0
     "
     return $?
-  elif find . -maxdepth 2 -name "*.Tests.ps1" -type f 2>/dev/null | head -1 | grep -q "."; then
+  elif find . -maxdepth 2 -name "*.Tests.ps1" -type f 2>/dev/null | sed -n '1p; 1q' | grep -q "."; then
     echo "Running Pester tests in current directory..."
     "$PWSH" -NoProfile -Command "
       \$results = Invoke-Pester -CI -PassThru
@@ -117,7 +117,7 @@ run_coverage() {
     test_paths="test/"
   fi
 
-  if [ -n "$test_paths" ] || find . -maxdepth 2 -name "*.Tests.ps1" -type f 2>/dev/null | head -1 | grep -q "."; then
+  if [ -n "$test_paths" ] || find . -maxdepth 2 -name "*.Tests.ps1" -type f 2>/dev/null | sed -n '1p; 1q' | grep -q "."; then
     echo "Running Pester with code coverage..."
     local path_arg="${test_paths:-.}"
     "$PWSH" -NoProfile -Command "

package/adapters/python.sh

@@ -63,7 +63,7 @@ run_tests() {
   fi
 
   # Check for errors in summary line (e.g. "3 errors")
-  ERROR_COUNT=$(echo "$PYTEST_OUTPUT" | grep -oP '\d+ error' | grep -oP '\d+' | head -1)
+  ERROR_COUNT=$(echo "$PYTEST_OUTPUT" | grep -oP '\d+ error' | grep -oP '\d+' | sed -n '1p; 1q')
   if [ -n "$ERROR_COUNT" ] && [ "$ERROR_COUNT" -gt 0 ]; then
     echo "❌ $ERROR_COUNT test collection/execution errors detected"
     return 1
@@ -94,7 +94,7 @@ run_coverage() {
   fi
 
   # Check for errors in summary line (e.g. "3 errors")
-  ERROR_COUNT=$(echo "$PYTEST_OUTPUT" | grep -oP '\d+ error' | grep -oP '\d+' | head -1)
+  ERROR_COUNT=$(echo "$PYTEST_OUTPUT" | grep -oP '\d+ error' | grep -oP '\d+' | sed -n '1p; 1q')
   if [ -n "$ERROR_COUNT" ] && [ "$ERROR_COUNT" -gt 0 ]; then
     echo "❌ $ERROR_COUNT test collection/execution errors detected"
     return 1

package/adapters/shell.sh

@@ -26,13 +26,13 @@ run_lint() {
 
 run_tests() {
   # Look for and run shell test files
-  if [[ -d "tests" ]] && [[ -n "$(find tests -name "*.sh" -type f | head -n 1)" ]]; then
+  if [ -d "tests" ] && [ -n "$(find tests -name "*.sh" -type f | sed -n '1p; 1q')" ]; then
     echo "Running Shell tests..."
     for test_file in tests/*.sh; do
-      if [[ -x "$test_file" ]]; then
+      if [ -x "$test_file" ]; then
         "$test_file"
         local exit_code=$?
-        if [[ $exit_code -ne 0 ]]; then
+        if [ "$exit_code" -ne 0 ]; then
           return $exit_code
         fi
       fi

package/adapters/swift.sh

@@ -2,7 +2,7 @@
 
 run_static_analysis() {
   if command -v swiftlint &>/dev/null; then
-    swiftlint lint 2>&1 | head -30
+    swiftlint lint 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "SwiftLint not available"
@@ -12,7 +12,7 @@ run_static_analysis() {
 
 run_lint() {
   if command -v swiftlint &>/dev/null; then
-    swiftlint lint --strict 2>&1 | head -30
+    swiftlint lint --strict 2>&1 | sed -n '1,30p; 30q'
     return $?
   else
     echo "SwiftLint not available"

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
 **Generated:** 2026-06-18
-**Commit:** 33cf3f2
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.1.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:** 33cf3f2
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.1.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.1",
+  "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.1",
+  "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:** 33cf3f2
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.1.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:** 33cf3f2
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.1.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:** 33cf3f2
+**Commit:** b67fc85
 **Branch:** main
-**Version:** 0.9.1.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}`)
+  })
+})