cctally 1.43.1 → 1.43.2

package/CHANGELOG.md

@@ -5,6 +5,11 @@ based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.43.2] - 2026-06-13
+
+### Added
+- `refresh-usage` now repaints a locally-running dashboard instantly. After a successful force-refresh it sends a best-effort `POST /api/sync?refresh=0` (a new rebuild-only mode that skips the embedded OAuth re-fetch) to `127.0.0.1:8789`, so the dashboard reflects the new 7d/5h value within ~1s instead of waiting up to one `--sync-interval`. Fully best-effort: with no dashboard running, output and exit codes are unchanged (#180).
+
 ## [1.43.1] - 2026-06-13
 
 ### Fixed

package/bin/_cctally_dashboard.py

@@ -5459,8 +5459,12 @@ class DashboardHTTPHandler(BaseHTTPRequestHandler):
             self.send_error(503, "sync in progress")
             return
         try:
+            do_refresh = (
+                urllib.parse.parse_qs(urllib.parse.urlsplit(self.path).query)
+                .get("refresh", ["1"])[0] != "0"
+            )
             warnings: list = []
-            if not type(self).no_sync:
+            if do_refresh and not type(self).no_sync:
                 result = _refresh_usage_inproc()
                 if result.status != "ok":
                     warnings.append({"code": result.status})

package/bin/_cctally_refresh.py

@@ -649,6 +649,42 @@ def _refresh_usage_inproc(timeout_seconds: float = 5.0) -> _RefreshUsageResult:
     return _RefreshUsageResult(status="ok", payload=payload, warnings=warnings)
 
 
+def _nudge_dashboard_repaint(port: int = 8789, timeout_seconds: float = 3.0) -> None:
+    """Best-effort: tell a locally-running dashboard to rebuild+broadcast NOW.
+
+    refresh-usage already persisted the new usage value; this only shortens
+    the dashboard's repaint latency from <=sync-interval to ~instant by
+    POSTing the rebuild-only /api/sync?refresh=0 path. Swallows EVERY error
+    (no dashboard listening, timeout, HTTP non-2xx) — never raises, never
+    prints, never changes cmd_refresh_usage's exit code.
+
+    Targets loopback 127.0.0.1 (reaches a local dashboard even when it bound
+    0.0.0.0) on the default port 8789. A dashboard on a non-default port (or
+    none) simply isn't nudged and self-heals within its --sync-interval.
+
+    CSRF: the dashboard's _check_origin_csrf requires Origin/Host authority
+    parity. urllib auto-sets Host from the URL; we set Origin to the
+    byte-identical authority so the POST is accepted (not 403). The timeout
+    is 3.0s — comfortably above the server's _DASHBOARD_SYNC_LOCK_TIMEOUT_
+    SECONDS (2.0s) bounded lock-wait — so the client stays connected until
+    the 204 lands and never leaves a broken-pipe log line in the dashboard's
+    terminal. In the common case (lock free) it returns in single-digit ms.
+    """
+    # Whole body (incl. Request construction) inside the try so the
+    # "swallows EVERY error" contract holds structurally, not just because
+    # Request() happens to be total for the hardcoded loopback URL.
+    try:
+        url = f"http://127.0.0.1:{port}/api/sync?refresh=0"
+        req = urllib.request.Request(
+            url, data=b"", method="POST",
+            headers={"Origin": f"http://127.0.0.1:{port}"},
+        )
+        with urllib.request.urlopen(req, timeout=timeout_seconds) as resp:
+            resp.read()
+    except Exception:
+        pass
+
+
 def cmd_refresh_usage(args: argparse.Namespace) -> int:
     """Force-fetch the OAuth usage API and persist via cmd_record_usage.
 
@@ -681,6 +717,9 @@ def cmd_refresh_usage(args: argparse.Namespace) -> int:
             color = c._forecast_color_enabled(color_mode, sys.stdout)
             now_epoch = int(dt.datetime.now(dt.timezone.utc).timestamp())
             print(_render_refresh_usage_text(payload, color=color, now_epoch=now_epoch))
+        # Best-effort: repaint a locally-running dashboard NOW (the value is
+        # already persisted). Fires in normal/--json/--quiet alike; only on ok.
+        c._nudge_dashboard_repaint()
         return 0
 
     if result.status == "rate_limited":

package/bin/cctally

@@ -718,6 +718,7 @@ _bust_statusline_cache = _cctally_refresh._bust_statusline_cache
 _freshness_label = _cctally_refresh._freshness_label
 _cmd_refresh_usage_handle_rate_limit = _cctally_refresh._cmd_refresh_usage_handle_rate_limit
 _refresh_usage_inproc = _cctally_refresh._refresh_usage_inproc
+_nudge_dashboard_repaint = _cctally_refresh._nudge_dashboard_repaint
 cmd_refresh_usage = _cctally_refresh.cmd_refresh_usage
 _hook_tick_oauth_refresh = _cctally_refresh._hook_tick_oauth_refresh
 _hook_tick_make_mock_refresh = _cctally_refresh._hook_tick_make_mock_refresh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cctally",
-  "version": "1.43.1",
+  "version": "1.43.2",
   "description": "Claude Code usage tracker and local dashboard for Pro/Max subscription limits - weekly cost-per-percent trend, quota forecasts, threshold alerts. ccusage-compatible.",
   "homepage": "https://github.com/omrikais/cctally",
   "repository": {