claude-terminal-prism 1.0.1 → 1.1.0

package/README.md

@@ -1,9 +1,54 @@
 # claude-terminal-prism
 
+```
+██████╗ ██████╗ ██╗███████╗███╗   ███╗
+██╔══██╗██╔══██╗██║██╔════╝████╗ ████║
+██████╔╝██████╔╝██║███████╗██╔████╔██║
+██╔═══╝ ██╔══██╗██║╚════██║██║╚██╔╝██║
+██║     ██║  ██║██║███████║██║ ╚═╝ ██║
+╚═╝     ╚═╝  ╚═╝╚═╝╚══════╝╚═╝     ╚═╝
+```
+
 **PRISM** — Agentic visibility layer for Claude. Intercept, record, and debug multi-agent sessions in a real-time dashboard.
 
 ---
 
+## What's new in 1.1.0
+
+- **Cost dedup** — `parseTranscript` now collapses duplicate turn entries (same token tuple within 30s) that Claude Code writes under distinct UUIDs during tool-use round-trips and `--resume` replays. Previously these inflated session cost by ~30%.
+- **Opus 4.7 pricing** — Added to the pricing table. Prior releases fell back to Sonnet rates, undercounting Opus cost by ~5×.
+- **Session totals are event-sourced** — Top-bar and Cost Analytics now SUM per-turn `cost.update` events instead of relying on a stale `sessions.total_cost` column.
+- **Idempotent ingest** — `insertEvent` uses `INSERT OR IGNORE` and returns a boolean; session mutations only fire on real inserts, so collector restarts no longer double-count.
+
+### Upgrade from v1.0.x (existing data)
+
+v1.1.0 changes how cost is aggregated. Sessions recorded with v1.0.x will show **inflated costs** (2-3×) in the dashboard unless you reset or migrate your database.
+
+**Option A — wipe (recommended, loses session history):**
+
+```bash
+npm update -g claude-terminal-prism
+prism reset-db --restart
+```
+
+**Option B — migrate (keeps history, surgically fixes cost data):**
+
+```bash
+npm update -g claude-terminal-prism
+prism reset-db --migrate --restart
+```
+
+`--migrate` requires Node.js 22.5+. It removes duplicate hook cost events from v1.0.x so that SUM-ing them gives the correct session total. New sessions recorded after the upgrade are unaffected regardless of which option you choose.
+
+### Fresh install / already on v1.1.0
+
+```bash
+npm update -g claude-terminal-prism
+prism stop && prism start
+```
+
+---
+
 ## Install
 
 ```bash
@@ -12,18 +57,16 @@ npm install -g claude-terminal-prism
 
 ---
 
-## Getting started — two commands
+## Setup
 
 ```bash
 prism setup
 source ~/.zshrc
 ```
 
-`prism setup` starts the collector + dashboard daemon, adds a shell alias so every `claude` session is auto-captured, and opens the browser at `http://localhost:4700`.
-
----
+`prism setup` starts the collector + dashboard daemon, adds a shell alias so every `claude` session is auto-captured, and opens the browser at **http://localhost:4700**.
 
-## Global setup (all Claude sessions on this machine)
+For more control, run the steps individually:
 
 ```bash
 prism start                    # Start collector + dashboard → http://localhost:4700
@@ -45,10 +88,11 @@ prism uninit   # Remove shell integration and hooks
 prism start [--port N] [--no-open]   # Start collector + dashboard daemon
 prism stop                            # Stop the daemon
 prism status                          # Show running state
-prism init                            # Global: shell integration + hooks
-prism init --local [--port N]         # Local: project hooks only (default port: 4701)
-prism uninit                          # Remove global shell integration
-prism uninit --local                  # Remove local project hooks
+prism init                            # Add shell integration + Claude Code hooks
+prism uninit                          # Remove shell integration and hooks
+prism reset-db                        # Wipe local database (v1.0.x upgrade fix)
+prism reset-db --migrate              # Surgical fix — keep history, dedupe cost events
+prism reset-db --restart              # Wipe + restart in one step
 prism tui                             # Inline terminal dashboard
 prism exec <cmd>                      # Run a command with full capture
 prism shell                           # Spawn a captured interactive shell