claude-pace 0.8.6 → 0.9.0

package/README.md

@@ -108,12 +108,12 @@ Claude Code polls the statusline every ~300ms:
 | Data | Source | Cache |
 |------|--------|-------|
 | Model, context, cost | stdin JSON (single `jq` call) | None needed |
-| Quota (5h, 7d, pace) | stdin `rate_limits`; fallback to last-known private cache when `rate_limits` is absent | Private cache root, accepted only before cached reset |
+| Quota (5h, 7d, pace) | stdin `rate_limits` (live, no fallback) | None |
 | Git branch + diff | `git` commands | Private cache dir, 5s TTL |
 
-Best experience is on Claude Code `2.1.80+`, where `rate_limits` is available in statusline stdin. When a later statusline run omits `rate_limits`, claude-pace can reuse the last known stdin quota snapshot from its private cache until either cached reset time expires.
+Requires Claude Code `2.1.80+`, where `rate_limits` is available in statusline stdin. When stdin omits `rate_limits` (older Claude Code, or providers that do not surface the field), claude-pace shows `--` for 5h/7d quota and the session cost if available. No cached or stale quota is ever shown, because a cached account-level snapshot cannot be proven to belong to the current provider/account.
 
-Cache files live in a private per-user directory (`$XDG_RUNTIME_DIR/claude-pace` or `~/.cache/claude-pace`, mode 700). All cache reads are validated before use. No files are ever written to shared `/tmp`.
+Git cache files live in a private per-user directory (`$XDG_RUNTIME_DIR/claude-pace` or `~/.cache/claude-pace`, mode 700). All cache reads are validated before use. No files are ever written to shared `/tmp`.
 
 ## Claude Code Statusline FAQ
 
@@ -124,7 +124,7 @@ No. Only `jq` (available via `brew install jq` or your package manager). No npm,
 claude-pace compares your current usage percentage to the fraction of time elapsed in each window (5-hour and 7-day). If you've used 40% of your quota but only 30% of the time has passed, the pace delta shows ⇡10% (red, burning too fast). If you've used 30% with 40% of time elapsed, it shows ⇣10% (green, headroom).
 
 **Does it make network calls?**
-No. Quota data comes from stdin `rate_limits` on Claude Code `2.1.80+`. If a later statusline run omits `rate_limits`, claude-pace can reuse the last known stdin quota snapshot from its private cache as long as that snapshot's reset times are still in the future. Otherwise it falls back to `--` and may still show the local session cost.
+No. Quota data comes from stdin `rate_limits` on Claude Code `2.1.80+`. If `rate_limits` is absent (older Claude Code, or providers that omit it), claude-pace shows `--` for 5h/7d and the local session cost when present. No stale quota fallback — see [the removal decision](docs/decisions/2026-05-20-quota-cache-removal.md).
 
 **Can I inspect the source?**
 The entire tool is [one Bash file](claude-pace.sh). Read it before you install it.
@@ -137,4 +137,4 @@ The entire tool is [one Bash file](claude-pace.sh). Read it before you install i
 
 MIT
 
-*Last updated: 2026-04-20 · v0.8.3*
+*Last updated: 2026-05-20 · v0.9.0*

package/claude-pace.sh

@@ -65,17 +65,6 @@ _write_cache_record() {
     printf '%s\n' "$*"
   ) >"$tmp" && mv "$tmp" "$path"
 }
-# Avoids rewriting the quota cache when the live snapshot is unchanged.
-_write_quota_snapshot_if_changed() {
-  local path="$1" u5="$2" u7="$3" r5="$4" r7="$5"
-  if [ -f "$path" ] && [ ! -L "$path" ] && [ -r "$path" ] && _load_cache_record_file "$path"; then
-    [[ "${CACHE_FIELDS[0]:-}" == "$u5" ]] &&
-      [[ "${CACHE_FIELDS[1]:-}" == "$u7" ]] &&
-      [[ "${CACHE_FIELDS[2]:-}" == "$r5" ]] &&
-      [[ "${CACHE_FIELDS[3]:-}" == "$r7" ]] && return 0
-  fi
-  _write_cache_record "$path" "$u5" "$u7" "$r5" "$r7"
-}
 # Computes remaining whole minutes until a future epoch. Missing or expired
 # timestamps return an empty string so callers can skip countdown formatting.
 _minutes_until() {
@@ -85,16 +74,6 @@ _minutes_until() {
   ((mins < 0)) && mins=0
   printf '%s\n' "$mins"
 }
-# Valid quota snapshots must contain integer usage values and future reset
-# epochs for both windows. Partial or expired snapshots never enter the cache.
-_valid_quota_snapshot() {
-  local u5="$1" u7="$2" r5="$3" r7="$4"
-  [[ "$u5" =~ ^[0-9]+$ ]] || return 1
-  [[ "$u7" =~ ^[0-9]+$ ]] || return 1
-  [[ "$r5" =~ ^[0-9]+$ ]] || return 1
-  [[ "$r7" =~ ^[0-9]+$ ]] || return 1
-  ((r5 > NOW && r7 > NOW))
-}
 # Collects live Git metadata for DIR. On non-repos, leaves defaults in place
 # and returns non-zero so callers can decide whether to cache the empty result.
 _collect_git_info() {
@@ -122,8 +101,6 @@ for _BASE in "${XDG_RUNTIME_DIR:-}" "${HOME}/.cache"; do
   CACHE_OK=1
   break
 done
-QC=""
-[[ "$CACHE_OK" == "1" ]] && QC="${_CD}/claude-sl-quota"
 # Returns true (exit 0) when file is missing or older than $2 seconds.
 _stale() { [ ! -f "$1" ] || [ $((NOW - $(stat -f%m "$1" 2>/dev/null || stat -c%Y "$1" 2>/dev/null || echo 0))) -gt "$2" ]; }
 
@@ -223,34 +200,18 @@ elif [[ "$IS_WT" == "1" ]]; then
   ((${#L1R} > 25)) && L1R="${L1R:0:25}…"
 fi
 
-# Usage data: read stdin rate_limits when available, otherwise show session cost.
+# Usage data: read stdin rate_limits when available. When absent we show
+# placeholders and the session cost instead of falling back to a possibly stale
+# (or wrong-account) cached snapshot. See docs/decisions/2026-05-20-quota-cache-removal.md.
 SHOW_COST=0
 if [[ "$HAS_RL" == "1" ]]; then
   # Stdin path: real-time, no network. U5/U7 already set by jq read above.
   # Guard: resets_at=0 means field missing, leave RM empty so _usage skips it.
   RM5=$(_minutes_until "$R5")
   RM7=$(_minutes_until "$R7")
-  if [[ -n "$QC" ]] && _valid_quota_snapshot "$U5" "$U7" "$R5" "$R7"; then
-    _write_quota_snapshot_if_changed "$QC" "$U5" "$U7" "$R5" "$R7" || true
-  fi
 else
   U5="--" U7="--" RM5="" RM7=""
   SHOW_COST=1
-  if [[ -n "$QC" ]] && _load_cache_record_file "$QC"; then
-    _CU5=${CACHE_FIELDS[0]:-}
-    _CU7=${CACHE_FIELDS[1]:-}
-    _CR5=${CACHE_FIELDS[2]:-}
-    _CR7=${CACHE_FIELDS[3]:-}
-    if _valid_quota_snapshot "$_CU5" "$_CU7" "$_CR5" "$_CR7"; then
-      U5="$_CU5"
-      U7="$_CU7"
-      R5="$_CR5"
-      R7="$_CR7"
-      RM5=$(_minutes_until "$R5")
-      RM7=$(_minutes_until "$R7")
-      SHOW_COST=0
-    fi
-  fi
 fi
 
 # Combined usage formatter: used% [pace delta] (countdown)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pace",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "description": "Claude Code statusline and rate limit tracker. Pure Bash + jq, single file.",
   "bin": {
     "claude-pace": "cli.js"