feat: self-update command + install script + workspace restructure (v1.5.0)

Add `cc-token-usage update` subcommand for zero-dependency self-update
from GitHub Releases. Add `install.sh` for curl | sh installation.
Restructure project as Cargo workspace under `crates/`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: LokiQ0713

.github/workflows/ci.yml

@@ -13,6 +13,6 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
       - uses: Swatinem/rust-cache@v2
-      - run: cargo check
-      - run: cargo test
-      - run: cargo clippy -- -D warnings
+      - run: cargo check -p cc-token-usage
+      - run: cargo test -p cc-token-usage
+      - run: cargo clippy -p cc-token-usage -- -D warnings

.github/workflows/release.yml

@@ -50,7 +50,7 @@ jobs:
           echo 'linker = "aarch64-linux-gnu-gcc"' >> .cargo/config.toml
 
       - name: Build
-        run: cargo build --release --target ${{ matrix.target }}
+        run: cargo build --release --target ${{ matrix.target }} -p cc-token-usage
 
       - name: Package for GitHub Release
         run: |
@@ -99,14 +99,26 @@ jobs:
           cat > /tmp/release-notes.md << 'EOF'
           ## Install
 
+          Quick install (macOS / Linux):
+          ```bash
+          curl -fsSL https://raw.githubusercontent.com/LokiQ0713/cc-token-usage/master/install.sh | sh
+          ```
+
+          Or via npm:
           ```bash
           npx cc-token-usage
           ```
 
-          Or with cargo:
+          Or via cargo:
           ```bash
           cargo install cc-token-usage
           ```
+
+          ## Upgrade
+
+          ```bash
+          cc-token-usage update
+          ```
           EOF
           gh release create "$GITHUB_REF_NAME" \
             --title "$GITHUB_REF_NAME" \
@@ -181,6 +193,6 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
       - name: Publish to crates.io
-        run: cargo publish --allow-dirty --token ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish -p cc-token-usage --allow-dirty --token ${{ secrets.CARGO_REGISTRY_TOKEN }}
         env:
           CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}

CLAUDE.md

@@ -1,83 +1,78 @@
-# cc-token-usage
+# CLAUDE.md
 
-Analyze Claude Code session token usage, costs, and efficiency. Reads local JSONL session files, calculates token consumption and API-equivalent costs, and generates terminal summaries and interactive HTML dashboards.
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-- **GitHub:** https://github.com/LokiQ0713/cc-token-usage
-- **npm:** https://www.npmjs.com/package/cc-token-usage
-
-## Tech Stack
-
-- **Language:** Rust (edition 2021)
-- **Dependencies:** serde/serde_json (serialization), clap (CLI), chrono (dates), comfy-table (terminal tables), toml (config), dirs (paths), anyhow (errors)
-- **Frontend:** Chart.js (embedded in HTML output)
-- **Distribution:** cargo (crates.io) + npm (pre-built binaries)
+## Project Overview
 
-## File Structure
+**cc-token-usage** — CLI tool that analyzes Claude Code session token usage, costs, and efficiency. Reads JSONL session files from `~/.claude/projects/`, calculates API-equivalent costs, and outputs terminal tables or interactive HTML dashboards.
 
-```
-src/
-├── main.rs              # Entry point, CLI dispatch
-├── cli.rs               # Clap CLI argument definitions
-├── config.rs            # Config file loading (pricing overrides)
-├── lib.rs               # Library root
-├── data/
-│   ├── mod.rs
-│   ├── scanner.rs       # Discover JSONL session files
-│   ├── parser.rs        # 5-stage pipeline: parse → filter → validate → extract → dedup
-│   ├── models.rs        # Data types (JournalEntry, ValidatedTurn, SessionData, TokenUsage)
-│   └── loader.rs        # Load sessions + merge agent turns (cross-file dedup)
-├── pricing/
-│   ├── mod.rs
-│   └── calculator.rs    # Token cost calculation with cache tiers
-├── analysis/
-│   ├── mod.rs
-│   ├── overview.rs      # Aggregate statistics
-│   ├── project.rs       # Per-project breakdown
-│   ├── session.rs       # Per-session breakdown
-│   ├── trend.rs         # Daily/monthly trend analysis
-│   └── validate.rs      # Independent token verification (dual-path cross-validation)
-└── output/
-    ├── mod.rs
-    ├── text.rs           # Terminal table output
-    └── html.rs           # Interactive HTML dashboard
-
-npm-package/             # npm wrapper for binary distribution
-config.example.toml      # Example config with pricing overrides
-```
+- **GitHub:** https://github.com/LokiQ0713/cc-token-usage
+- **npm:** https://www.npmjs.com/package/cc-token-usage
 
-## Development
+## Commands
 
 ```bash
-# Build
+# Build & run
 cargo build
-
-# Run
 cargo run
 cargo run -- --format html
-cargo run -- project --top 5
 cargo run -- session --latest
-cargo run -- trend --days 30
-cargo run -- validate              # Verify token accuracy (3890+ checks)
 cargo run -- validate --failures-only
 
-# Test
+# Test (all tests, or a single test)
 cargo test
+cargo test parse_valid_assistant_turn
 
-# Lint
+# Lint & format
 cargo clippy -- -D warnings
-
-# Format
 cargo fmt
 ```
 
+## Architecture
+
+### Data Pipeline (src/data/)
+
+The core data flow is a 5-stage pipeline in `parser.rs`:
+
+```
+JSONL line → JSON parse → type filter → validation → content extraction → request_id dedup
+```
+
+Key design decisions:
+- **Sidechain filtering**: Main session files skip `isSidechain=true` entries (abandoned generations), but agent files keep them (agents always have `isSidechain=true`)
+- **Streaming dedup**: Same `requestId` appearing multiple times (streaming retries) keeps the last entry
+- **Cross-file dedup** (in `loader.rs`): Agent turns that already appear in the parent session (by `requestId`) are dropped to prevent double-counting
+
+Session files are discovered by `scanner.rs` which handles three file layouts:
+1. `<project>/<uuid>.jsonl` — main sessions
+2. `<project>/agent-<id>.jsonl` — legacy agents (parent resolved from first line's `sessionId`)
+3. `<project>/<uuid>/subagents/agent-<id>.jsonl` — new-style agents (parent from directory name)
+
+### Pricing (src/pricing/)
+
+`PricingCalculator` resolves model prices with a 4-step fallback: exact override → prefix override → exact builtin → prefix builtin. This handles versioned model IDs like `claude-opus-4-5-20251101` matching `claude-opus-4-5`. Cache write costs distinguish two TTL tiers (5-minute and 1-hour). Built-in prices have a staleness check (>90 days).
+
+### Analysis (src/analysis/)
+
+Each subcommand has its own analysis module (`overview.rs`, `project.rs`, `session.rs`, `trend.rs`). All consume `Vec<SessionData>` + `PricingCalculator` and return typed result structs defined in `mod.rs`.
+
+`validate.rs` implements **dual-path cross-validation**: an independent raw JSON counter (using `serde_json::Value`, no shared types with the main pipeline) re-counts tokens from JSONL files and compares against the pipeline's output.
+
+### Output (src/output/)
+
+- `text.rs` — terminal tables via `comfy-table`
+- `html.rs` — self-contained HTML with embedded Chart.js, supports light/dark theme and i18n (en/zh)
+
 ## Release Workflow
 
-1. Bump version in `Cargo.toml` and `npm-package/package.json`
+1. Bump version in both `Cargo.toml` and `npm-package/package.json`
 2. `npm version patch/minor/major` (creates git tag)
 3. `git push && git push --tags`
-4. GitHub Actions `release.yml` auto-builds binaries for all platforms and publishes to npm
+4. GitHub Actions `release.yml` builds cross-platform binaries and publishes to npm
+
+**Important**: Always commit `Cargo.lock` in release commits — CI needs it for reproducible builds. Never delete and re-create release tags; always bump the version instead.
 
 ## CI/CD
 
-- **CI** (`ci.yml`): Runs `cargo check`, `cargo test`, `cargo clippy` on push/PR to master
-- **Release** (`release.yml`): Triggered by version tags, builds cross-platform binaries, publishes to npm
+- **CI** (`ci.yml`): `cargo check` + `cargo test` + `cargo clippy` on push/PR to master
+- **Release** (`release.yml`): Triggered by `v*` tags, cross-compiles for Linux/macOS/Windows, publishes npm package