claude-finops 0.4.0 → 0.4.2

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-finops",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "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/run.py

@@ -93,6 +93,7 @@ HELP = """Claude FinOps Command Center
   claude-finops --set-key       store a provider API key (prompts, never echoes)
   claude-finops --keys          list which provider keys are configured
   claude-finops --share         write ../claude-finops.zip (code only, never your data)
+  claude-finops --version       print the installed version, and whether a newer one is out
   claude-finops --help          this message
 
 Environment:
@@ -104,6 +105,33 @@ Environment:
 """
 
 
+def version():
+    """Which copy is this, and is it current?
+
+    The second half matters more than the first: people run a global install and
+    a repo checkout side by side, and the usual confusion is not "what version
+    am I on" but "why does the one I am looking at not have the feature".
+    """
+    from finops.update import check, disabled, _key
+    # Asking outright is worth a fresh request: a day-old cached answer is the
+    # one thing this command must not give you.
+    u = check(force=True)
+    print(f"  claude-finops {u['current'] or 'unknown'}")
+    print(f"  installed at  {ROOT}")
+    if u.get("update_available"):
+        print(f"  update        {u['latest']} is out - {u['command']}")
+    elif disabled():
+        print("  update        check is off (NO_UPDATE_NOTIFIER)")
+    elif u.get("latest") and _key(u["current"]) > _key(u["latest"]):
+        # A checkout mid-release is ahead of what is published. Saying "up to
+        # date" there would hide exactly the gap you are looking for.
+        print(f"  update        ahead of npm (published latest is {u['latest']})")
+    elif u.get("latest"):
+        print(f"  update        up to date (npm latest is {u['latest']})")
+    else:
+        print("  update        could not reach the npm registry")
+
+
 def where():
     from finops.paths import (HOME_DIR, DB_PATH, LOCAL_SETTINGS_PATH, SECRETS_PATH,
                               LOGFILE, CONFIG_DIR)
@@ -180,6 +208,8 @@ def main():
     migrate()
     if "--help" in args or "-h" in args:
         return print(HELP)
+    if "--version" in args or "-v" in args or "-V" in args:
+        return version()
     if "--where" in args:
         return where()
     if "--keys" in args: