Release v2.2.0

README viral enhancement:
- Card-style HTML tables (2-col max, mobile-friendly)
- Tool logo badges (shields.io) and tech stack logos (skillicons.dev)
- Competitive positioning vs Superpowers/GSD/gstack
- Market stats, persona cards, "At a Glance" grid
- Tanjiro "Spec Breathing" parody quote
- Section reorder: Problem/Fix first
- Karpathy and Garry Tan centered quotes

All 5 translations updated (zh-CN, ja-JP, ko-KR, vi-VN, pt-BR):
- Full structural parity with English README
- Translated Tanjiro quote with locale anime terminology
- Fixed logo paths for docs/i18n/ relative location

Harness improvements:
- New: intent-clarification protocol
- New: parallel fan-out checkpoint protocol
- Hardened phase-program loop (regression checks, commit checkpoints)
- Inline fan-out signals in all 4 CLAUDE.md phase transitions
- vc-publish: added mandatory resolver-diff rule
- Hook test suite (18 new test files)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: withkynam

.claude/hooks/__tests__/session-state.test.cjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+'use strict';
+
+const { handleSessionStateEvent } = require('../session-state.cjs');
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+async function runCase(name, fn) {
+  try {
+    await fn();
+    console.log(`✓ ${name}`);
+    return true;
+  } catch (error) {
+    console.log(`✗ ${name}`);
+    console.log(`  Error: ${error.message}`);
+    return false;
+  }
+}
+
+async function run() {
+  const results = [];
+
+  results.push(await runCase('skips cleanly when hook disabled', async () => {
+    const result = await handleSessionStateEvent(
+      { hook_event_name: 'PostToolUse', session_id: 'abc' },
+      { enabled: false }
+    );
+    assert(result.action === 'skipped-disabled', 'expected disabled skip');
+  }));
+
+  results.push(await runCase('skips when session id missing', async () => {
+    const result = await handleSessionStateEvent(
+      { hook_event_name: 'PostToolUse' },
+      { enabled: true }
+    );
+    assert(result.action === 'skipped-no-session', 'expected missing session skip');
+  }));
+
+  results.push(await runCase('refreshes snapshot on PostToolUse', async () => {
+    let refreshed = 0;
+    const result = await handleSessionStateEvent(
+      { hook_event_name: 'PostToolUse', session_id: 'abc' },
+      {
+        enabled: true,
+        refresh: async () => {
+          refreshed += 1;
+          return { success: true };
+        },
+        persist: () => ({ success: false })
+      }
+    );
+    assert(refreshed === 1, 'expected one refresh');
+    assert(result.refreshed === true, 'expected refreshed flag');
+    assert(result.persisted === false, 'expected no persist');
+  }));
+
+  results.push(await runCase('persists and refreshes on Stop', async () => {
+    let persisted = 0;
+    let refreshed = 0;
+    const result = await handleSessionStateEvent(
+      { hook_event_name: 'Stop', session_id: 'abc', cwd: process.cwd() },
+      {
+        enabled: true,
+        refresh: async () => {
+          refreshed += 1;
+          return { success: true };
+        },
+        persist: () => {
+          persisted += 1;
+          return { success: true };
+        }
+      }
+    );
+    assert(persisted === 1, 'expected one persist');
+    assert(refreshed === 1, 'expected one refresh');
+    assert(result.persisted === true, 'expected persisted flag');
+    assert(result.refreshed === true, 'expected refreshed flag');
+  }));
+
+  if (results.every(Boolean)) return;
+  process.exit(1);
+}
+
+run().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

.claude/hooks/lib/__tests__/README.md

@@ -0,0 +1,91 @@
+# Statusline Test Suite
+
+Comprehensive tests for `.claude/statusline.cjs` and supporting libraries.
+
+## Files
+
+- `usage-limits-cache.test.cjs` - Unit tests for the usage quota cache helper (5 tests)
+- `statusline.test.cjs` - Unit/regression tests for helpers and parser logic (57 tests)
+- `statusline-integration.test.cjs` - End-to-end rendering tests for `statusline.cjs` (30 tests)
+- `statusline-scenarios.test.cjs` - Cross-platform and user workflow scenarios (19 tests)
+- `statusline-suite.cjs` - Aggregate runner for all statusline suites
+- `vc-config-utils.test.cjs` - Existing config utility coverage
+
+## Running Tests
+
+```bash
+# From repository root
+node .claude/hooks/lib/__tests__/statusline-suite.cjs
+```
+
+Run individual suites when debugging:
+
+```bash
+node .claude/hooks/lib/__tests__/usage-limits-cache.test.cjs
+node .claude/hooks/lib/__tests__/statusline.test.cjs
+node .claude/hooks/lib/__tests__/statusline-integration.test.cjs
+node .claude/hooks/lib/__tests__/statusline-scenarios.test.cjs
+```
+
+## Current Coverage Scope
+
+### Usage Cache Helper (`usage-limits-cache.test.cjs`)
+- live OAuth whole-number percentage handling plus defensive `0..1` fallback
+- additive `snapshot` generation for cosmetic `5h` / `wk` chips
+- cache age helpers that keep refresh work off the render path
+- success and failure writes for the shared quota cache file
+
+### Unit and Regression (`statusline.test.cjs`)
+- color behavior and ANSI toggles (`NO_COLOR`, `FORCE_COLOR`)
+- context thresholds and bar rendering
+- transcript parsing and target extraction
+- native task mapping (`TaskCreate`/`TaskUpdate`/`TaskGet`/`TaskList`)
+- stdin timeout and fallback behavior
+- usage cache parse and render behavior
+- git info cache timeout race regressions
+
+### End-to-End (`statusline-integration.test.cjs`)
+- minimal/default payload rendering
+- git workspace behavior
+- context usage and cost display paths
+- invalid/empty input fallback handling
+- home path shortening and multi-line behavior
+- environment behavior (`NO_COLOR`, billing mode)
+
+### Scenario Suite (`statusline-scenarios.test.cjs`)
+- Linux/macOS/Windows/UNC/WSL path rendering
+- statusline modes (`none`, `minimal`, `compact`, default/full)
+- delayed stdin and optional timeout (`CK_STATUSLINE_STDIN_TIMEOUT_MS`)
+- normalized snapshot rendering, legacy raw cache fallback, and unavailable cache behavior
+- display remaining visible when `usage-context-awareness` is disabled
+- native task transcript flows and legacy TodoWrite coexistence
+- terminal width wrapping (wide + narrow unicode paths)
+
+## Latest Verified Result
+
+- total tests: 111
+- passed: 111
+- failed: 0
+- suites run: 4
+
+## Maintenance
+
+When changing statusline logic:
+
+1. Update/add tests in the relevant suite.
+2. Run the aggregate suite:
+   ```bash
+   node .claude/hooks/lib/__tests__/statusline-suite.cjs
+   ```
+3. Keep this README counts and scope notes in sync with test changes.
+
+## Related Files
+
+- `/.claude/statusline.cjs`
+- `/.claude/hooks/lib/colors.cjs`
+- `/.claude/hooks/lib/transcript-parser.cjs`
+- `/.claude/hooks/lib/config-counter.cjs`
+- `/.claude/hooks/lib/git-info-cache.cjs`
+
+**Last Updated:** 2026-02-26
+**Status:** passing