claude-finops 0.3.0 → 0.4.1

package/finops/analytics.py

@@ -30,22 +30,57 @@ def _merge(base, over):
     return base
 
 
+# claude_max -> "Max", claude_pro -> "Pro": the tier string carries a 5x/20x
+# suffix we keep, because which Max you are on changes every limit in the app.
+_PLANS = {"claude_max": "Max", "claude_pro": "Pro", "claude_team": "Team",
+          "claude_enterprise": "Enterprise"}
+
+
+def _plan(acct):
+    base = _PLANS.get(acct.get("organizationType") or "")
+    mult = ""
+    tier = str(acct.get("organizationRateLimitTier") or "")
+    if base == "Max":
+        for m in ("5x", "20x"):
+            if tier.endswith(m):
+                mult = " " + m
+    return (base + mult) if base else ""
+
+
 def detect_account():
-    """The signed-in Claude Code account, read from ~/.claude.json (actual, not guessed)."""
+    """Who Claude Code is signed in as, read from ~/.claude.json (actual, not guessed).
+
+    Everything here is already on this machine, written by Claude Code itself at
+    login. We only surface it, so a shared screenshot says whose numbers these
+    are — a dashboard with no name on it is the one people misread.
+    """
     try:
         with open(os.path.expanduser("~/.claude.json")) as fh:
             acct = json.load(fh).get("oauthAccount") or {}
     except (OSError, ValueError):
         return {}
-    return {"label": acct.get("emailAddress")} if acct.get("emailAddress") else {}
+    email = acct.get("emailAddress") or ""
+    name = acct.get("fullName") or acct.get("displayName") or ""
+    org = acct.get("organizationName") or ""
+    out = {"name": name, "email": email,
+           # A personal plan names the org after the person; repeating it is noise.
+           "org": "" if org == name else org,
+           "plan": _plan(acct)}
+    if email:
+        out["label"] = email
+    return {k: v for k, v in out.items() if v}
 
 
 def load_settings():
     """Shared defaults (settings.json) + this machine's overrides (settings.local.json)."""
     with open(SETTINGS_PATH) as fh:
         cur = json.load(fh)
-    if not cur.get("account", {}).get("label"):
-        cur.setdefault("account", {}).update(detect_account())
+    # Detected identity first, so a configured settings.json still wins below.
+    detected = detect_account()
+    acct = cur.setdefault("account", {})
+    for k, v in detected.items():
+        if not acct.get(k):
+            acct[k] = v
     if os.path.exists(LOCAL_SETTINGS_PATH):
         with open(LOCAL_SETTINGS_PATH) as fh:
             _merge(cur, json.load(fh))

package/finops/api.py

@@ -58,12 +58,34 @@ def flatten(rows):
     return buf.getvalue()
 
 
+# A browser that navigates away, reloads, or is closed mid-response resets the
+# socket. That is the client's normal behaviour, not our error, but socketserver
+# prints a full traceback for it — pages of noise in server.log that look like a
+# crash. These two are the only disconnect shapes it produces.
+DISCONNECTS = (ConnectionResetError, BrokenPipeError, ConnectionAbortedError)
+
+
+class Server(ThreadingHTTPServer):
+    def handle_error(self, request, client_address):
+        import sys
+        if not isinstance(sys.exception(), DISCONNECTS):
+            super().handle_error(request, client_address)
+
+
 class Handler(BaseHTTPRequestHandler):
     protocol_version = "HTTP/1.1"
 
     def log_message(self, *a):
         pass
 
+    def handle_one_request(self):
+        # The reset can also land while we are still writing the response, past
+        # the point handle_error covers.
+        try:
+            super().handle_one_request()
+        except DISCONNECTS:
+            self.close_connection = True
+
     def send_json(self, obj, code=200):
         body = json.dumps(obj, default=str).encode()
         self.send_response(code)
@@ -423,7 +445,7 @@ def serve(port=8787, db=DB_PATH, background=None):
     if background and hasattr(os, "fork"):
         detach(port)
     A = Analytics(db)
-    srv = ThreadingHTTPServer(("127.0.0.1", port), Handler)
+    srv = Server(("127.0.0.1", port), Handler)
     print(f"Claude FinOps Command Center -> http://127.0.0.1:{port}")
     print(f"  warehouse: {db}")
     print(f"  data      : {A.first_day} .. {A.last_day}")

package/finops/diagnose.py

@@ -686,7 +686,7 @@ class Diagnoser:
         rows = a.q(f"""SELECT r.session_id, s.title, pj.name project, COUNT(*) steps,
             MAX(r.context_tokens) peak, AVG(r.context_tokens) avg_ctx,
             SUM(r.billable_tokens) tokens, SUM(r.est_cost_usd) cost,
-            SUM(CASE WHEN r.context_tokens > {base} THEN r.context_tokens - {base} ELSE 0 END) over_base,
+            COALESCE(SUM(CASE WHEN r.context_tokens > {base} THEN r.context_tokens - {base} ELSE 0 END), 0) over_base,
             SUM(CASE WHEN r.context_tokens > {self.CTX_WARN} THEN 1 ELSE 0 END) heavy_steps,
             COUNT(DISTINCT r.prompt_id) prompts, SUM(r.is_sidechain) side
             FROM requests r JOIN sessions s ON s.id=r.session_id JOIN projects pj ON pj.id=r.project_id
@@ -698,8 +698,12 @@ class Diagnoser:
         for r in rows:
             sid = r["session_id"]
             fixes = []
-            r["avoidable_tokens"] = r["over_base"]
-            r["avoidable_cost"] = r["over_base"] * rate
+            # A session with no priced requests sums to NULL, not 0 — and one
+            # NULL used to take the whole diagnose page down with a 500.
+            over = r["over_base"] or 0
+            r["over_base"] = over
+            r["avoidable_tokens"] = over
+            r["avoidable_cost"] = over * rate
             if not compacts.get(sid):
                 fixes.append(f"Never compacted. {r['heavy_steps']:,} steps ran above "
                              f"{self.CTX_WARN // 1000}K context; /compact (or /clear between the "

package/finops/report.py

@@ -3,6 +3,15 @@ import html
 from datetime import datetime, timezone
 
 
+def _who(acct):
+    """"Mohit Raj Purohit <mohit@example.com>" when we know both, else whichever
+    one we have. A report that leaves the house should name its account."""
+    name, email = acct.get("name") or "", acct.get("email") or acct.get("label") or ""
+    if name and email:
+        return f"{name} <{email}>"
+    return name or email or "unknown"
+
+
 def _f(v, kind="usd"):
     if v is None:
         return "&mdash;"
@@ -52,7 +61,7 @@ td:nth-child(n+2) {{ font-variant-numeric: tabular-nums; }}
 ul {{ margin:6px 0 12px 18px; padding:0; }} li {{ margin-bottom:4px; }}
 </style></head><body>
 <h1>Claude AI FinOps Report</h1>
-<div class="sub">Account {html.escape(str(a.settings['account'].get('label')))} &middot;
+<div class="sub">Account {html.escape(_who(a.settings['account']))} &middot;
  Billing period {bp['start']} &rarr; {bp['end']} &middot;
  Data {ov['date_range']['first']} &ndash; {ov['date_range']['last']} &middot;
  Generated {datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')}</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-finops",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Local FinOps dashboard for Claude Code: what you used, what it cost, why it cost that much, and what to change. Reads your own transcripts, no API key, no data leaves the machine.",
   "bin": {
     "claude-finops": "bin/claude-finops.js"

package/web/app.js

@@ -151,7 +151,8 @@ function shell() {
       <nav class="nav">${NAV.map(([g, items], gi) => `<div class="group g${gi}">${g}</div>` +
         items.map(([id, ic, label]) =>
           `<a data-view="${id}" class="g${gi}${id === 'diagnose' ? ' start' : ''}"><span class="ic">${ic}</span>${label}<span class="nb" data-nb="${id}"></span></a>`).join('')).join('')}
-      </nav></aside>
+      </nav>
+      <div class="who" id="who"></div></aside>
     <div class="main">
       <header class="topbar">
         <div class="r1">
@@ -2223,9 +2224,27 @@ const navAllowed = scope => !scope || (scope === 'claude' ? hasClaude()
   : scope === 'cloud' ? hasCloudKey() : hasPriced());
 // "Claude Code", "Codex", or "agent" for a mixed selection: used in data-availability text
 const agentWord = () => { const a = selAgents(); return a.length === 1 ? a[0].name : 'agent'; };
+// Whose usage this is. Read from ~/.claude.json by the server, so a screenshot
+// or a shared dashboard always says which account the numbers belong to.
+function whoBlock() {
+  const el = $('#who'), a = S.opts?.settings?.account || {};
+  if (!el) return;
+  if (!a.name && !a.email) { el.innerHTML = ''; return; }
+  const initials = (a.name || a.email || '?').split(/[\s@.]+/).filter(Boolean)
+    .slice(0, 2).map(w => w[0].toUpperCase()).join('');
+  el.innerHTML = `<div class="av">${esc(initials)}</div>
+    <div class="id">
+      <div class="nm">${esc(a.name || a.email)}</div>
+      <div class="em" title="${esc(a.email || '')}">${esc(a.email || '')}</div>
+      ${a.plan || a.org ? `<div class="pl">${esc([a.plan, a.org].filter(Boolean).join(' · '))}</div>` : ''}
+    </div>`;
+  el.title = `Claude Code is signed in as ${a.name || ''} <${a.email || ''}>`.trim();
+}
+
 function applyAgentChrome() {
   const a = selAgents();
   const label = a.length === 1 ? a[0].name.replace(/ (Code|CLI)$/, '') : a.length ? 'Multi-agent' : 'AI';
+  whoBlock();
   const mark = $('.brand .mark');
   if (mark) mark.innerHTML = `<span class="dot"></span>${esc(label)} FinOps`;
   const sub = $('.brand .sub');

package/web/styles.css

@@ -77,7 +77,8 @@ button, input, select { font: inherit; color: inherit; }
 /* ---------- shell ---------- */
 .app { display: grid; grid-template-columns: 216px 1fr; min-height: 100vh; }
 .sidebar { background: var(--surface); border-right: 1px solid var(--border);
-           padding: 14px 0; position: sticky; top:0; height:100vh; overflow-y:auto; }
+           padding: 14px 0; position: sticky; top:0; height:100vh; overflow-y:auto;
+           display:flex; flex-direction:column; }
 .brand { padding: 0 16px 14px; border-bottom: 1px solid var(--border); margin-bottom: 10px; }
 .brand .mark { display:flex; align-items:center; gap:8px; font-weight:660; font-size:14px;
                letter-spacing:-0.01em; }
@@ -395,3 +396,21 @@ table.tbl .sub { font-size:10.5px; color:var(--muted); }
   white-space: nowrap;
 }
 .iconbtn.upd:hover { background: var(--accent, #eb6834); color: #fff; }
+
+/* Whose account this dashboard is reading — pinned to the foot of the sidebar,
+   so every screenshot carries the name of the account it came from. */
+/* Sticky, because the nav is taller than the viewport and an identity you have
+   to scroll to find is one nobody checks. */
+.who { margin-top:auto; position:sticky; bottom:0; z-index:2;
+       display:flex; align-items:center; gap:9px;
+       padding:12px 16px; background:var(--surface);
+       border-top:1px solid var(--border); }
+.who:empty { display:none; }
+.who .av { flex:none; width:26px; height:26px; border-radius:50%; display:grid;
+           place-items:center; font-size:10.5px; font-weight:700; color:#fff;
+           background: var(--accent, #eb6834); }
+.who .id { min-width:0; }
+.who .nm { font-size:11.5px; font-weight:620; line-height:1.25;
+           overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+.who .em, .who .pl { font-size:10px; color:var(--muted); line-height:1.35;
+                     overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }