feat: v0.12.1 — bump flash uses reverse-video ▲N outside brackets

Bold-only +N crammed between % and @ inside the brackets was too
subtle in most terminals and read as noise. Move the indicator
outside the badge with a reverse-video ▲ glyph — spatially distinct
and unmissable without adding a fourth color lane.

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

Author: lroolle

CHANGELOG.md

@@ -1,27 +1,38 @@
 # Changelog
 
-## v0.12.0 — 2026-07-02 — quota bump flash (+N when 5h/7d usage climbs)
+## v0.12.1 — 2026-07-02 — bump flash: reverse-video ▲N outside brackets
+
+### Changed
+
+- **Bump flash visual**: the quota-climb indicator moved from bold `+N`
+  inside the badge to a **reverse-video `▲N`** outside the brackets:
+  `5h[44%@1h18m] ▲2` / `7d[10%] ▲1`. Spatially distinct + reverse video
+  (inverted bg/fg) makes it unmissable without adding a fourth color lane.
+  Bold-only was too subtle in most terminals, and cramming `+N` between
+  `%` and `@` inside the brackets made it read as noise.
+- `REVERSE`/`NO_REVERSE` (`ESC[7m`/`ESC[27m`) replaces `BOLD`/`NO_BOLD`.
+
+218 tests, shellcheck warning count unchanged.
+
+## v0.12.0 — 2026-07-02 — quota bump flash (▲N when 5h/7d usage climbs)
 
 ### Added
 
-- **Bump flash**: when the 5h or 7d utilization climbs between renders, the
-  badge shows the increment in bold at its current color for ~60s:
-  `5h[44%+2@1h18m]` / `7d[10%+1]` — "you just burned 2%". Vivid without a
-  new hue, so the three color lanes stay unambiguous (bold is emphasis, not
-  a fourth status color).
+- **Bump flash**: when the 5h or 7d utilization climbs between renders, a
+  reverse-video `▲N` glyph appears outside the badge for ~60s:
+  `5h[44%@1h18m] ▲2` / `7d[10%] ▲1` — "you just burned 2%". Vivid without
+  a new hue, so the three color lanes stay unambiguous.
 - `quota_bump_notice()` + per-session state file
   (`sessions/<session_id>_quota_seen`, same lifecycle as `_cache_health`).
   Per-session on purpose: the flash compares against what THIS statusline
   last rendered, so concurrent sessions each get their own notice instead
   of racing over shared account state.
 - Semantics: first sighting is quiet; a climb records the increment; an
   unchanged value keeps a still-fresh notice alive; a second climb
-  overwrites (latest increment, not a running sum — "+N" answers "what just
+  overwrites (latest increment, not a running sum — "▲N" answers "what just
   happened"); a drop (window reset) clears silently, the fresh low number
   being its own signal.
-- `QUOTA_BUMP_NOTICE_SECS` (60) constant; `BOLD`/`NO_BOLD` attribute
-  toggles (`ESC[22;1m` / `ESC[22m` — 22-first so bold applies cleanly even
-  inside recovery-dimmed text).
+- `QUOTA_BUMP_NOTICE_SECS` (60) constant.
 
 ### Fixed
 

README.md

@@ -82,7 +82,7 @@ Every component earns its place:
 | Effort | Compact lowercase badge: `lo` / `md` / `xh` / `max` / `ultra` / `auto` (`high` is the default and stays hidden). Dim for routine levels; `max` / `ultra` use the pressure color; `fast` shows in fast mode. |
 | Context bar | Merged with model. Green / yellow / red by window pressure. On 1M models the bar also carries the premium input-pricing band: yellow past 200k tokens, red past 800k — the % alone looks calm (320k = 32%) while every request bills at the premium rate. A real 0% (e.g. right after `/compact` resets the window) renders a visibly empty bar `[░░░░░░0%]` — the snap to empty *is* the refresh signal; the bar hides only when no context data exists at all. |
 | User tier | Neutral white-weight (MAX bold, PRO normal, dim otherwise) — identity, never a status color. Truncated display name. |
-| Quota | Integer percentages. The 5h badge always carries its window countdown while a window is live — `5h[42%@1h20m]` reads "42% used, resets in 1h20m" — because on a 5h horizon the time remaining is the number you plan the current sitting around. Same `@remaining` language as the 7d badge; relative, not wall-clock, so no mental subtraction. When a window's utilization climbs between renders, the badge flashes the increment for ~60s in bold at its current color: `5h[44%+2@1h18m]` means "you just burned 2%". A drop (window reset) stays quiet — the fresh low number is its own signal. **7d is forecast, not leveled**: a learned per-weekday burn profile (EWMA over your own usage history) plus your recent 24h burn project whether the quota outlasts the window — your heavy Tuesday counts more than a generic average. The verdict is color alone; under pressure the badge shows explicit time remaining in the window: `7d[44%@5d]` red means "at your pace, dry days before the reset 5 days from now". Cold start (<14 days history) falls back to window-average pacing. Recovery color when reset is imminent. |
+| Quota | Integer percentages. The 5h badge always carries its window countdown while a window is live — `5h[42%@1h20m]` reads "42% used, resets in 1h20m" — because on a 5h horizon the time remaining is the number you plan the current sitting around. Same `@remaining` language as the 7d badge; relative, not wall-clock, so no mental subtraction. When a window's utilization climbs between renders, a reverse-video `▲N` glyph appears outside the badge for ~60s: `5h[44%@1h18m] ▲2` means "you just burned 2%". A drop (window reset) stays quiet — the fresh low number is its own signal. **7d is forecast, not leveled**: a learned per-weekday burn profile (EWMA over your own usage history) plus your recent 24h burn project whether the quota outlasts the window — your heavy Tuesday counts more than a generic average. The verdict is color alone; under pressure the badge shows explicit time remaining in the window: `7d[44%@5d]` red means "at your pace, dry days before the reset 5 days from now". Cold start (<14 days history) falls back to window-average pacing. Recovery color when reset is imminent. |
 | Extra usage | Monthly spend, limit, prepaid balance. `--extra auto` shows when quota runs out. |
 | Cache health | Detects observed prompt-cache rebuilds and cache-read drops. `cache!` on break, `cache~` when building. If a future Claude Code stdin includes TTL breakdown, `--cache always` can show `cache:1h@14:20`; current stdin usually exposes aggregate cache tokens only. Hidden when healthy by default. |
 
@@ -107,7 +107,7 @@ red, matching its Claude Code TUI color) = model family; everything else is
 | 5 themes, 9 bar styles | -- | Yes |
 | Prompt cache break detection | -- | Yes |
 | OAuth + macOS Keychain | -- | Yes |
-| Quota bump flash (+N) | -- | Yes |
+| Quota bump flash (▲N) | -- | Yes |
 | 230 bats tests + CI | -- | Yes |
 
 ## Configuration

statusline.sh

@@ -368,10 +368,10 @@ CYAN='\033[0;36m'
 DIM_CYAN='\033[2;36m'
 WHITE='\033[0;37m'
 BOLD_WHITE='\033[1;37m'
-# Attribute toggles for a brief emphasis at the CURRENT hue (quota bump flash).
-# 22 first clears any dim so bold applies cleanly even inside DIM_GREEN text.
-BOLD='\033[22;1m'
-NO_BOLD='\033[22m'
+# Reverse video for the quota bump flash — inverts fg/bg at whatever the
+# badge's current color is, so the ▲N glyph pops without adding a new hue.
+REVERSE='\033[7m'
+NO_REVERSE='\033[27m'
 RESET='\033[0m'
 
 # Usage quota tracking
@@ -1655,11 +1655,11 @@ build_usage_display() {
             local rel=$(format_reset_relative "$five_reset")
             [ -n "$rel" ] && reset_suffix="${DIM}@${rel}${color}"
         fi
-        # Bump flash: bold "+N" at the badge's current hue — vivid without a
-        # new color, so the status lanes stay unambiguous.
+        # Bump flash: reverse-video ▲N outside the brackets — spatially
+        # distinct and unmissable without adding a fourth color lane.
         local bump_part=""
-        [ "$five_bump" -gt 0 ] 2>/dev/null && bump_part="${BOLD}+${five_bump}${NO_BOLD}${color}"
-        parts+=("${DIM}5h${color}[${five_int}%${bump_part}${reset_suffix}]${RESET}")
+        [ "$five_bump" -gt 0 ] 2>/dev/null && bump_part=" ${color}${REVERSE}▲${five_bump}${NO_REVERSE}"
+        parts+=("${DIM}5h${color}[${five_int}%${reset_suffix}]${bump_part}${RESET}")
     fi
 
     # 7d aggregate quota (if present and >0). Color comes from PACE, not level:
@@ -1727,8 +1727,8 @@ build_usage_display() {
             reset_suffix="${DIM}@${rem}${color}"
         fi
         local bump_part=""
-        [ "$seven_bump" -gt 0 ] 2>/dev/null && bump_part="${BOLD}+${seven_bump}${NO_BOLD}${color}"
-        parts+=("${DIM}7d${color}[${seven_int}%${bump_part}${reset_suffix}]${RESET}")
+        [ "$seven_bump" -gt 0 ] 2>/dev/null && bump_part=" ${color}${REVERSE}▲${seven_bump}${NO_REVERSE}"
+        parts+=("${DIM}7d${color}[${seven_int}%${reset_suffix}]${bump_part}${RESET}")
     fi
 
     # Model-specific 7d quotas

t/statusline.bats

@@ -1148,7 +1148,7 @@ JSON
     rm -rf "$tmpdir"
 }
 
-@test "integration: 5h utilization climb flashes +N on the next render" {
+@test "integration: 5h utilization climb flashes ▲N on the next render" {
     tmpdir=$(mktemp -d)
     mkdir -p "$tmpdir/.claude"
     echo '{"claudeAiOauth":{"accessToken":"fake"}}' > "$tmpdir/.claude/.credentials.json"
@@ -1160,7 +1160,8 @@ JSON
     payload 40 | HOME="$tmpdir" CLAUDE_DATA_DIR="$tmpdir/.claude/statusline" CLAUDE_CACHE_DIR="$tmpdir/sessions" bash "$SCRIPT_DIR/statusline.sh" >/dev/null
     result=$(payload 43 | HOME="$tmpdir" CLAUDE_DATA_DIR="$tmpdir/.claude/statusline" CLAUDE_CACHE_DIR="$tmpdir/sessions" bash "$SCRIPT_DIR/statusline.sh")
     plain=$(strip_ansi "$result")
-    [[ "$plain" == *"5h[43%+3@"* ]]
+    # ▲N lives outside the badge brackets: 5h[43%@3h...] ▲3
+    [[ "$plain" == *"5h[43%@3h"*"▲3"* ]]
     # State is per-session and lives beside the cache-health files.
     [ -f "$tmpdir/sessions/sess-bump_quota_seen" ]
     rm -rf "$tmpdir"
@@ -1273,15 +1274,15 @@ JSON
     [ "$result" = "0 0" ]
 }
 
-@test "build_usage_display: bump renders +N inside the badge" {
+@test "build_usage_display: bump renders ▲N outside the badge" {
     tmpdir=$(mktemp -d)
     usage1='{"five_hour":{"utilization":42},"seven_day":{"utilization":10}}'
     usage2='{"five_hour":{"utilization":45},"seven_day":{"utilization":12}}'
     build_usage_display "$usage1" "" "$tmpdir/state" >/dev/null
     result=$(build_usage_display "$usage2" "" "$tmpdir/state")
     plain=$(strip_ansi "$result")
-    [[ "$plain" == *"5h[45%+3]"* ]]
-    [[ "$plain" == *"7d[12%+2]"* ]]
+    [[ "$plain" == *"5h[45%]"*"▲3"* ]]
+    [[ "$plain" == *"7d[12%]"*"▲2"* ]]
     rm -rf "$tmpdir"
 }
 
@@ -1293,7 +1294,8 @@ JSON
     build_usage_display "$usage1" "" "$tmpdir/state" >/dev/null
     result=$(build_usage_display "$usage2" "" "$tmpdir/state")
     plain=$(strip_ansi "$result")
-    [[ "$plain" == *"5h[45%+3@2h"* ]]
+    # ▲N outside: 5h[45%@2h...] ▲3
+    [[ "$plain" == *"5h[45%@2h"*"▲3"* ]]
     rm -rf "$tmpdir"
 }