cc-context-stats 1.7.0 → 1.8.1

package/assets/logo/favicon.svg

@@ -1,19 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
-  <defs>
-    <linearGradient id="fav-grad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" stop-color="#22C55E"/>
-      <stop offset="50%" stop-color="#E9AB34"/>
-      <stop offset="100%" stop-color="#EF4444"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="16" height="16" rx="3" fill="#1A1A1A"/>
-
-  <!-- Simplified wave for 16x16 -->
-  <path d="M 2 12 C 4 12, 5 10, 7 8 C 9 6, 10 4, 12 3 C 13 2, 14 3, 14 2.5"
-        stroke="url(#fav-grad)" stroke-width="1.5" fill="none" stroke-linecap="round"/>
-
-  <!-- Dot -->
-  <circle cx="12" cy="3" r="1.5" fill="#E9AB34"/>
-</svg>

package/assets/logo/logo-black.svg

@@ -1,24 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 360 72" width="360" height="72">
-  <!-- Black version for light backgrounds — no background rectangle -->
-
-  <!-- Mark: Context wave -->
-  <g transform="translate(8, 4)">
-    <path d="M 10 48 C 16 48, 18 42, 22 40 C 26 38, 28 36, 32 32 C 36 28, 38 22, 42 18 C 46 14, 50 16, 54 14"
-          stroke="#1A1A1A" stroke-width="3.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
-    <path d="M 10 52 C 16 52, 18 46, 22 44 C 26 42, 28 40, 32 36 C 36 32, 38 26, 42 22 C 46 18, 50 20, 54 18"
-          stroke="#1A1A1A" stroke-width="1.5" fill="none" stroke-linecap="round" opacity="0.25"/>
-    <circle cx="42" cy="18" r="3.5" fill="#1A1A1A"/>
-    <circle cx="42" cy="18" r="6" fill="#1A1A1A" opacity="0.12"/>
-    <line x1="10" y1="54" x2="54" y2="54" stroke="#1A1A1A" stroke-width="1" stroke-linecap="round" opacity="0.3"/>
-  </g>
-
-  <!-- Divider -->
-  <line x1="76" y1="16" x2="76" y2="56" stroke="#1A1A1A" stroke-width="1" opacity="0.2"/>
-
-  <!-- Wordmark -->
-  <text x="90" y="35" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="22" font-weight="700" fill="#1A1A1A" letter-spacing="-0.3">cc-context</text>
-  <text x="90" y="55" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="15" font-weight="500" fill="#1A1A1A" letter-spacing="3" opacity="0.6">stats</text>
-
-  <!-- Right accent bar -->
-  <rect x="348" y="20" width="2" height="32" rx="1" fill="#1A1A1A" opacity="0.35"/>
-</svg>

package/assets/logo/logo-full.svg

@@ -1,40 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 360 72" width="360" height="72">
-  <defs>
-    <linearGradient id="full-wave-grad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" stop-color="#22C55E"/>
-      <stop offset="50%" stop-color="#E9AB34"/>
-      <stop offset="100%" stop-color="#EF4444"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background pill -->
-  <rect width="360" height="72" rx="14" fill="#1A1A1A"/>
-
-  <!-- Mark: Context wave in left area -->
-  <g transform="translate(8, 4)">
-    <!-- Context wave -->
-    <path d="M 10 48 C 16 48, 18 42, 22 40 C 26 38, 28 36, 32 32 C 36 28, 38 22, 42 18 C 46 14, 50 16, 54 14"
-          stroke="url(#full-wave-grad)" stroke-width="3.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
-
-    <!-- Echo line -->
-    <path d="M 10 52 C 16 52, 18 46, 22 44 C 26 42, 28 40, 32 36 C 36 32, 38 26, 42 22 C 46 18, 50 20, 54 18"
-          stroke="url(#full-wave-grad)" stroke-width="1.5" fill="none" stroke-linecap="round" opacity="0.3"/>
-
-    <!-- Cursor dot -->
-    <circle cx="42" cy="18" r="3.5" fill="#E9AB34"/>
-    <circle cx="42" cy="18" r="6" fill="#E9AB34" opacity="0.15"/>
-
-    <!-- Baseline -->
-    <line x1="10" y1="54" x2="54" y2="54" stroke="#8B7D6B" stroke-width="1" stroke-linecap="round" opacity="0.4"/>
-  </g>
-
-  <!-- Divider -->
-  <line x1="76" y1="16" x2="76" y2="56" stroke="#8B7D6B" stroke-width="1" opacity="0.25"/>
-
-  <!-- Wordmark -->
-  <text x="90" y="35" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="22" font-weight="700" fill="#FFFFFF" letter-spacing="-0.3">cc-context</text>
-  <text x="90" y="55" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="15" font-weight="500" fill="#E9AB34" letter-spacing="3">stats</text>
-
-  <!-- Right accent bar -->
-  <rect x="348" y="20" width="2" height="32" rx="1" fill="#E9AB34" opacity="0.5"/>
-</svg>

package/assets/logo/logo-icon.svg

@@ -1,27 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
-  <defs>
-    <linearGradient id="icon-wave-grad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" stop-color="#22C55E"/>
-      <stop offset="50%" stop-color="#E9AB34"/>
-      <stop offset="100%" stop-color="#EF4444"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="512" height="512" rx="96" fill="#1A1A1A"/>
-
-  <!-- Context wave (scaled up) -->
-  <path d="M 96 376 C 144 376, 160 328, 192 312 C 224 296, 240 280, 272 248 C 304 216, 320 168, 352 136 C 384 104, 400 120, 432 104"
-        stroke="url(#icon-wave-grad)" stroke-width="24" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
-
-  <!-- Echo line -->
-  <path d="M 96 408 C 144 408, 160 360, 192 344 C 224 328, 240 312, 272 280 C 304 248, 320 200, 352 168 C 384 136, 400 152, 432 136"
-        stroke="url(#icon-wave-grad)" stroke-width="10" fill="none" stroke-linecap="round" opacity="0.25"/>
-
-  <!-- Cursor dot -->
-  <circle cx="352" cy="136" r="28" fill="#E9AB34"/>
-  <circle cx="352" cy="136" r="48" fill="#E9AB34" opacity="0.12"/>
-
-  <!-- Baseline -->
-  <line x1="96" y1="424" x2="432" y2="424" stroke="#8B7D6B" stroke-width="6" stroke-linecap="round" opacity="0.35"/>
-</svg>

package/assets/logo/logo-mark.svg

@@ -1,28 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
-  <defs>
-    <linearGradient id="wave-grad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" stop-color="#22C55E"/>
-      <stop offset="50%" stop-color="#E9AB34"/>
-      <stop offset="100%" stop-color="#EF4444"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Background -->
-  <rect width="64" height="64" rx="14" fill="#1A1A1A"/>
-
-  <!-- Context wave: a flowing curve rising from left (low usage) to right (high usage) -->
-  <!-- This represents the context growth graph - the core concept of the tool -->
-  <path d="M 10 48 C 16 48, 18 42, 22 40 C 26 38, 28 36, 32 32 C 36 28, 38 22, 42 18 C 46 14, 50 16, 54 14"
-        stroke="url(#wave-grad)" stroke-width="3.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
-
-  <!-- Secondary pulse line (echo effect for depth) -->
-  <path d="M 10 52 C 16 52, 18 46, 22 44 C 26 42, 28 40, 32 36 C 36 32, 38 26, 42 22 C 46 18, 50 20, 54 18"
-        stroke="url(#wave-grad)" stroke-width="1.5" fill="none" stroke-linecap="round" opacity="0.3"/>
-
-  <!-- Cursor dot at the "current position" on the wave -->
-  <circle cx="42" cy="18" r="3.5" fill="#E9AB34"/>
-  <circle cx="42" cy="18" r="6" fill="#E9AB34" opacity="0.15"/>
-
-  <!-- Baseline -->
-  <line x1="10" y1="54" x2="54" y2="54" stroke="#8B7D6B" stroke-width="1" stroke-linecap="round" opacity="0.4"/>
-</svg>

package/assets/logo/logo-white.svg

@@ -1,24 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 360 72" width="360" height="72">
-  <!-- White version for dark backgrounds — no background rectangle -->
-
-  <!-- Mark: Context wave -->
-  <g transform="translate(8, 4)">
-    <path d="M 10 48 C 16 48, 18 42, 22 40 C 26 38, 28 36, 32 32 C 36 28, 38 22, 42 18 C 46 14, 50 16, 54 14"
-          stroke="#FFFFFF" stroke-width="3.5" fill="none" stroke-linecap="round" stroke-linejoin="round"/>
-    <path d="M 10 52 C 16 52, 18 46, 22 44 C 26 42, 28 40, 32 36 C 36 32, 38 26, 42 22 C 46 18, 50 20, 54 18"
-          stroke="#FFFFFF" stroke-width="1.5" fill="none" stroke-linecap="round" opacity="0.25"/>
-    <circle cx="42" cy="18" r="3.5" fill="#FFFFFF"/>
-    <circle cx="42" cy="18" r="6" fill="#FFFFFF" opacity="0.12"/>
-    <line x1="10" y1="54" x2="54" y2="54" stroke="#FFFFFF" stroke-width="1" stroke-linecap="round" opacity="0.3"/>
-  </g>
-
-  <!-- Divider -->
-  <line x1="76" y1="16" x2="76" y2="56" stroke="#FFFFFF" stroke-width="1" opacity="0.2"/>
-
-  <!-- Wordmark -->
-  <text x="90" y="35" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="22" font-weight="700" fill="#FFFFFF" letter-spacing="-0.3">cc-context</text>
-  <text x="90" y="55" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="15" font-weight="500" fill="#FFFFFF" letter-spacing="3" opacity="0.7">stats</text>
-
-  <!-- Right accent bar -->
-  <rect x="348" y="20" width="2" height="32" rx="1" fill="#FFFFFF" opacity="0.4"/>
-</svg>

package/assets/logo/logo-wordmark.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 260 52" width="260" height="52">
-  <!-- Wordmark only — transparent background -->
-  <!-- "cc-context" bold, "stats" in golden amber below -->
-  <text x="0" y="30" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="24" font-weight="700" fill="#1A1A1A" letter-spacing="-0.3">cc-context</text>
-  <text x="0" y="48" font-family="'SF Mono', 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace" font-size="15" font-weight="500" fill="#E9AB34" letter-spacing="3">stats</text>
-</svg>

package/config/settings-example.json

@@ -1,7 +0,0 @@
-{
-  "statusLine": {
-    "type": "command",
-    "command": "~/.claude/statusline.sh",
-    "padding": 0
-  }
-}

package/config/settings-node.json

@@ -1,7 +0,0 @@
-{
-  "statusLine": {
-    "type": "command",
-    "command": "~/.claude/statusline.js",
-    "padding": 0
-  }
-}

package/config/settings-python.json

@@ -1,7 +0,0 @@
-{
-  "statusLine": {
-    "type": "command",
-    "command": "~/.claude/statusline.py",
-    "padding": 0
-  }
-}

package/docs/ARCHITECTURE.md

@@ -1,128 +0,0 @@
-# Architecture
-
-## Overview
-
-cc-context-stats provides real-time context monitoring for Claude Code sessions. It consists of two main components:
-
-1. **Status Line** - A compact one-line display integrated into Claude Code's UI
-2. **Context Stats CLI** - A live terminal dashboard with ASCII graphs
-
-## System Architecture
-
-```mermaid
-graph TD
-    CC[Claude Code Host] -->|JSON stdin| SL[Statusline Script]
-    SL -->|stdout text| CC
-    SL -->|writes CSV| SF[State Files<br/>~/.claude/statusline/]
-    SF -->|reads CSV| CS[Context Stats CLI]
-    CF[Config File<br/>~/.claude/statusline.conf] -->|reads| SL
-    GIT[Git Repository] -->|branch/status| SL
-```
-
-```
-┌─────────────┐     JSON stdin      ┌──────────────────┐
-│ Claude Code  │ ──────────────────> │ Statusline Script │
-│   (host)     │ <────────────────── │  (sh/py/js)       │
-└─────────────┘     stdout text     └──────┬───────────┘
-                                           │ writes
-                                           ▼
-                                    ┌──────────────────┐
-                                    │  State Files      │
-                                    │  ~/.claude/       │
-                                    │  statusline/      │
-                                    └──────┬───────────┘
-                                           │ reads
-                                           ▼
-                                    ┌──────────────────┐
-                                    │ Context Stats CLI │
-                                    │  (Python/Bash)    │
-                                    └──────────────────┘
-```
-
-## Component Details
-
-### Status Line Scripts
-
-Three implementation languages with identical output:
-
-| Script                 | Language   | Dependencies | State Writes |
-| ---------------------- | ---------- | ------------ | ------------ |
-| `statusline-full.sh`   | Bash       | `jq`         | No           |
-| `statusline-git.sh`    | Bash       | `jq`         | No           |
-| `statusline-minimal.sh`| Bash       | `jq`         | No           |
-| `statusline.py`        | Python 3   | None         | Yes          |
-| `statusline.js`        | Node.js 18+| None         | Yes          |
-
-> **Note:** Only the Python and Node.js scripts write state files. The bash scripts provide status line display only, without persisting data for the context-stats CLI.
-
-**Data flow:**
-1. Claude Code pipes JSON state via stdin on each refresh
-2. Script parses model info, context tokens, session data
-3. Script reads `~/.claude/statusline.conf` for user preferences
-4. Script checks git status for branch/changes info (5-second timeout)
-5. Python/Node.js scripts write state to `~/.claude/statusline/<session_id>.state`
-6. Script outputs formatted ANSI text to stdout
-
-### Context Stats CLI
-
-Two implementations of the live dashboard:
-
-| Script             | Language | Install Method            |
-| ------------------ | -------- | ------------------------- |
-| `context-stats.sh` | Bash     | Shell installer           |
-| `context_stats.py` | Python   | `pip install cc-context-stats` |
-
-The Python CLI (installed via pip or npm) is the primary implementation, providing live ASCII graphs with zone awareness. The bash script is a standalone alternative installed by the shell installer.
-
-### Python Package (`src/claude_statusline/`)
-
-The pip-installable package provides both the statusline and context-stats CLI:
-
-```
-src/claude_statusline/
-├── __init__.py              # Package version and exports
-├── __main__.py              # python -m claude_statusline entry
-├── cli/
-│   ├── statusline.py        # claude-statusline entry point
-│   └── context_stats.py     # context-stats entry point
-├── core/
-│   ├── colors.py            # ANSI color management
-│   ├── config.py            # Configuration loading
-│   ├── git.py               # Git status detection (5s timeout)
-│   └── state.py             # State file reading/writing/rotation
-├── formatters/
-│   ├── layout.py            # Output width/layout management
-│   ├── time.py              # Duration formatting
-│   └── tokens.py            # Token count formatting
-├── graphs/
-│   ├── renderer.py          # ASCII graph rendering
-│   └── statistics.py        # Data statistics
-└── ui/
-    ├── icons.py             # Unicode icons
-    └── waiting.py           # Waiting animation
-```
-
-### State Files
-
-State files persist token history between statusline refreshes:
-
-```
-~/.claude/statusline/statusline.<session_id>.state
-```
-
-Each line is a CSV record with 14 comma-separated fields (timestamp, token counts, cost, session metadata, and context metrics). See [CSV_FORMAT.md](CSV_FORMAT.md) for the full field specification. The context-stats CLI reads these files to render graphs.
-
-**Rotation:** Files are automatically rotated at 10,000 lines, keeping the most recent 5,000 entries. This prevents unbounded file growth during long sessions.
-
-**Session ID validation:** IDs are validated to reject path-traversal characters (`/`, `\`, `..`, null bytes).
-
-## Data Privacy
-
-All data stays local:
-- State files are written to `~/.claude/statusline/`
-- No network requests are made
-- No telemetry or analytics
-
-## Configuration
-
-User preferences are stored in `~/.claude/statusline.conf` as simple `key=value` pairs. See [Configuration](configuration.md) for details.

package/docs/CSV_FORMAT.md

@@ -1,42 +0,0 @@
-# CSV State File Format
-
-State files are stored at `~/.claude/statusline/statusline.<session_id>.state`. Each line is a CSV record with 14 comma-separated fields.
-
-## Field Specification
-
-| Index | Field | Type | Description |
-|-------|-------|------|-------------|
-| 0 | `timestamp` | integer | Unix timestamp in seconds |
-| 1 | `total_input_tokens` | integer | Cumulative input tokens for the session |
-| 2 | `total_output_tokens` | integer | Cumulative output tokens for the session |
-| 3 | `current_input_tokens` | integer | Input tokens for the current request |
-| 4 | `current_output_tokens` | integer | Output tokens for the current request |
-| 5 | `cache_creation` | integer | Cache creation input tokens |
-| 6 | `cache_read` | integer | Cache read input tokens |
-| 7 | `cost_usd` | float | Total session cost in USD |
-| 8 | `lines_added` | integer | Total lines added in session |
-| 9 | `lines_removed` | integer | Total lines removed in session |
-| 10 | `session_id` | string | Session identifier (UUID) |
-| 11 | `model_id` | string | Model identifier (e.g., `claude-opus-4-5`) |
-| 12 | `workspace_project_dir` | string | Project directory path (commas replaced with underscores) |
-| 13 | `context_window_size` | integer | Context window size in tokens |
-
-## Constraints
-
-- Fields are separated by commas with no quoting or escaping.
-- The `workspace_project_dir` field (index 12) is sanitized before writing: all comma characters (`,`) are replaced with underscores (`_`) to prevent CSV corruption.
-- Numeric fields default to `0` when absent. String fields default to empty string.
-- Lines are newline-terminated (`\n`).
-- Files are append-only.
-- Files are automatically rotated at 10,000 lines (keeps most recent 5,000) by the Python and Node.js statusline scripts.
-- Duplicate entries (same token count as previous line) are skipped to prevent file bloat.
-
-## Legacy Format
-
-Older state files may contain 2-field lines: `timestamp,total_input_tokens`. The reader defaults all other fields to zero/empty for these lines.
-
-## Example
-
-```
-1710288000,75000,8500,50000,5000,10000,20000,0.05234,250,45,abc-123-def,claude-opus-4-5,/home/user/my-project,200000
-```

package/docs/DEPLOYMENT.md

@@ -1,71 +0,0 @@
-# Deployment
-
-## Distribution Channels
-
-cc-context-stats is distributed through three channels:
-
-| Channel      | Package Name      | Command                              |
-| ------------ | ----------------- | ------------------------------------ |
-| Shell script | N/A               | `curl -fsSL .../install.sh \| bash`  |
-| PyPI         | `cc-context-stats`| `pip install cc-context-stats`       |
-| npm          | `cc-context-stats`| `npm install -g cc-context-stats`    |
-
-Both pip and npm installs provide the `claude-statusline` and `context-stats` CLI commands.
-
-## Publishing to PyPI
-
-```bash
-# Ensure clean build
-rm -rf dist/ build/
-
-# Build
-python -m build
-
-# Check package
-twine check dist/*
-
-# Upload to PyPI
-twine upload dist/*
-```
-
-## Publishing to npm
-
-```bash
-# Verify package.json
-npm pack --dry-run
-
-# Publish
-npm publish
-```
-
-## Release Workflow
-
-The project uses GitHub Actions for automated releases (`.github/workflows/release.yml`):
-
-1. Update versions in all locations (see Version Management below)
-2. Update `CHANGELOG.md` with the new version entry
-3. Create and push a version tag: `git tag v1.x.x && git push --tags`
-4. The release workflow automatically:
-   - Runs the full test suite (Python, Node.js, Bash)
-   - Builds Python and npm packages
-   - Creates a GitHub Release with release notes
-
-CI is also run on every push and PR via `.github/workflows/ci.yml`.
-
-## Version Management
-
-Versions must be updated in sync across these files:
-
-| File | Field |
-| --- | --- |
-| `pyproject.toml` | `[project] version` |
-| `package.json` | `version` |
-| `src/claude_statusline/__init__.py` | `__version__` |
-| `CHANGELOG.md` | New version entry |
-| `RELEASE_NOTES.md` | Current release notes |
-
-## Install Script
-
-The `install.sh` script is fetched directly from the `main` branch on GitHub. Changes to the installer take effect immediately for new users running the curl one-liner.
-
-The installer embeds the version from `package.json` and the current git commit hash into the installed scripts, preventing version drift between the repository and installed copies.

package/docs/DEVELOPMENT.md

@@ -1,161 +0,0 @@
-# Development Guide
-
-## Prerequisites
-
-- **Git** - Version control
-- **jq** - JSON processor (for bash scripts)
-- **Python 3.9+** - For Python package and testing
-- **Node.js 18+** - For Node.js script and testing
-- **Bats** - Bash Automated Testing System (optional, for bash tests)
-- **pre-commit** - Git hook framework (optional, for automated code quality)
-
-## Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/luongnv89/cc-context-stats.git
-cd cc-context-stats
-
-# Python setup
-python3 -m venv venv
-source venv/bin/activate
-pip install -r requirements-dev.txt
-pip install -e ".[dev]"
-
-# Node.js setup
-npm install
-
-# Install pre-commit hooks (optional but recommended)
-pre-commit install
-```
-
-## Project Layout
-
-```
-cc-context-stats/
-├── src/claude_statusline/    # Python package source
-│   ├── cli/                  #   CLI entry points (statusline, context-stats)
-│   ├── core/                 #   Config, state, git, colors
-│   ├── formatters/           #   Token, time, layout formatting
-│   ├── graphs/               #   ASCII graph rendering
-│   └── ui/                   #   Icons, waiting animation
-├── scripts/                  # Standalone scripts (sh/py/js)
-│   ├── statusline-full.sh    #   Full-featured bash statusline
-│   ├── statusline-git.sh     #   Git-focused bash variant
-│   ├── statusline-minimal.sh #   Minimal bash variant
-│   ├── statusline.py         #   Python standalone statusline
-│   ├── statusline.js         #   Node.js standalone statusline
-│   └── context-stats.sh      #   Bash context-stats CLI
-├── tests/
-│   ├── bash/                 # Bats tests
-│   ├── python/               # Pytest tests
-│   └── node/                 # Jest tests
-├── config/                   # Configuration examples
-├── docs/                     # Documentation
-├── .github/workflows/        # CI/CD (ci.yml, release.yml)
-├── pyproject.toml            # Python build config (hatchling)
-└── package.json              # Node.js config
-```
-
-## Running Tests
-
-```bash
-# Python tests
-source venv/bin/activate
-pytest tests/python/ -v
-
-# Node.js tests (Jest)
-npm test
-
-# Bash integration tests
-bats tests/bash/*.bats
-
-# All tests
-pytest && npm test && bats tests/bash/*.bats
-```
-
-### Coverage Reports
-
-```bash
-# Python coverage
-pytest tests/python/ -v --cov=scripts --cov-report=html
-
-# Node.js coverage
-npm run test:coverage
-```
-
-## Linting & Formatting
-
-```bash
-# Run all checks via pre-commit
-pre-commit run --all-files
-
-# Individual tools
-ruff check src/ scripts/statusline.py            # Python lint
-ruff format src/ scripts/statusline.py           # Python format
-npx eslint scripts/statusline.js                 # JavaScript lint
-npx prettier --write scripts/statusline.js       # JavaScript format
-shellcheck scripts/*.sh install.sh               # Bash lint
-```
-
-## Manual Testing
-
-```bash
-# Test statusline scripts with mock input
-echo '{"model":{"display_name":"Test"},"cwd":"/test","session_id":"abc123","context":{"tokens_remaining":64000,"context_window":200000}}' | python3 scripts/statusline.py
-
-echo '{"model":{"display_name":"Test"}}' | node scripts/statusline.js
-
-echo '{"model":{"display_name":"Test"}}' | bash scripts/statusline-full.sh
-```
-
-## Building
-
-```bash
-# Python package
-python -m build
-
-# Verify package
-twine check dist/*
-
-# npm dry run
-npm pack --dry-run
-```
-
-## Cross-Script Consistency
-
-All three implementations (bash, Python, Node.js) must produce identical output for the same input. When modifying status line behavior:
-
-1. Update all three script variants
-2. Run integration tests to verify parity
-3. Test on multiple platforms if possible
-
-The delta parity tests (`tests/bash/`) verify that Python and Node.js produce identical deltas for the same CSV state data.
-
-## Debugging
-
-### State files
-
-```bash
-# View current state files
-ls -la ~/.claude/statusline/statusline.*.state
-
-# Inspect state content (14 CSV fields per line)
-cat ~/.claude/statusline/statusline.<session_id>.state
-
-# Watch state file updates in real-time
-watch -n 1 'tail -5 ~/.claude/statusline/statusline.*.state'
-```
-
-### Verbose testing
-
-```bash
-# Python with verbose output
-pytest tests/python/ -v -s
-
-# Node.js with verbose output
-npx jest --verbose
-
-# Bats with verbose output
-bats --verbose-run tests/bash/*.bats
-```