fix(agents-usage): parse Claude usage as direct percentages

- Treat all Claude `/api/oauth/usage` windows as 0-100 percentages
- Update fixtures and add regression coverage for weekly parsing

Author: SDSLeon

packages/agents-usage/src/collectors/claude.test.ts

@@ -8,15 +8,17 @@ import {
   parseClaudeUsage,
 } from "./claude";
 
+// The Claude /api/oauth/usage endpoint reports `utilization` in percent (0-100)
+// for every window, not as a 0-1 fraction. These values mirror a real response.
 const FIXTURE = {
-  five_hour: { utilization: 1, resets_at: "2026-05-29T12:00:00Z" },
-  seven_day: { utilization: 0.22, resets_at: "2026-06-01T00:00:00Z" },
-  seven_day_opus: { utilization: 0.1, resets_at: "2026-06-01T00:00:00Z" },
+  five_hour: { utilization: 21, resets_at: "2026-05-29T12:00:00Z" },
+  seven_day: { utilization: 1, resets_at: "2026-06-01T00:00:00Z" },
+  seven_day_opus: { utilization: 10, resets_at: "2026-06-01T00:00:00Z" },
   extra_usage: {
     is_enabled: true,
     monthly_limit: 25000,
     used_credits: 7836,
-    utilization: 0.31,
+    utilization: 31,
     currency: "USD",
   },
 };
@@ -30,13 +32,13 @@ describe("formatClaudePlan", () => {
 });
 
 describe("parseClaudeUsage", () => {
-  it("maps windows and normalizes mixed Claude utilization units", () => {
+  it("maps every Claude window as a direct percentage", () => {
     const snap = parseClaudeUsage(FIXTURE, FAKE_NOW_MS, { plan: "Claude Pro Subscription" });
     expect(snap.status).toBe("ok");
     const session = snap.windows.find((w) => w.id === "session-5h");
-    expect(session?.usedPercent).toBe(1);
+    expect(session?.usedPercent).toBe(21);
     expect(session?.resetsAt).toBe(Date.parse("2026-05-29T12:00:00Z"));
-    expect(snap.windows.find((w) => w.id === "weekly")?.usedPercent).toBe(22);
+    expect(snap.windows.find((w) => w.id === "weekly")?.usedPercent).toBe(1);
     expect(snap.windows.find((w) => w.id === "weekly-opus")?.usedPercent).toBe(10);
     // extra_usage is pay-as-you-go overage, surfaced as a dollar "extra-usage"
     // line — never as a "monthly" rate window.
@@ -60,6 +62,18 @@ describe("parseClaudeUsage", () => {
     const snap = parseClaudeUsage({ five_hour: { utilization: 1 } }, FAKE_NOW_MS);
     expect(snap.windows.find((w) => w.id === "session-5h")?.usedPercent).toBe(1);
   });
+
+  it("treats weekly utilization as a direct percentage, not a 0-1 fraction", () => {
+    // Regression: the API reports weekly utilization in percent like every other
+    // window. A value of 1 means 1% and must not be read as the fraction 1.0 →
+    // 100% (which rendered a freshly-reset weekly window as a full red bar).
+    const snap = parseClaudeUsage(
+      { seven_day: { utilization: 1 }, seven_day_sonnet: { utilization: 0.5 } },
+      FAKE_NOW_MS,
+    );
+    expect(snap.windows.find((w) => w.id === "weekly")?.usedPercent).toBe(1);
+    expect(snap.windows.find((w) => w.id === "weekly-sonnet")?.usedPercent).toBe(0.5);
+  });
 });
 
 describe("collectClaude", () => {

packages/agents-usage/src/collectors/claude.ts

@@ -1,5 +1,5 @@
 import { DEFAULT_CLIENT_VERSIONS } from "../clientVersions";
-import { normalizePercent, toEpochMs } from "../formatters";
+import { toEpochMs } from "../formatters";
 import type { CollectOptions, HostPort } from "../host";
 import type { UsageSnapshot, UsageWindow, UsageWindowId } from "../types";
 
@@ -52,9 +52,8 @@ function windowFrom(
   id: UsageWindowId,
   label: string,
   raw: ClaudeWindowRaw | undefined,
-  normalize: (value: number | undefined) => number | undefined = normalizePercent,
 ): UsageWindow | undefined {
-  const usedPercent = normalize(raw?.utilization);
+  const usedPercent = normalizeClaudePercent(raw?.utilization);
   if (usedPercent === undefined) return undefined;
   const resetsAt = toEpochMs(raw?.resets_at);
   return {
@@ -66,7 +65,13 @@ function windowFrom(
   };
 }
 
-function normalizeClaudeSessionPercent(value: number | undefined): number | undefined {
+/**
+ * The Claude `/api/oauth/usage` endpoint reports `utilization` already in
+ * percent (0-100) for every window — session, weekly, and overage alike. Clamp
+ * to 0-100 and round to one decimal; never rescale (a value of 1 means 1%, not
+ * the fraction 1.0 → 100%).
+ */
+function normalizeClaudePercent(value: number | undefined): number | undefined {
   if (value === undefined || !Number.isFinite(value) || value < 0) return undefined;
   return Math.min(100, Math.max(0, Math.round(value * 10) / 10));
 }
@@ -80,7 +85,7 @@ export function parseClaudeUsage(
   const data = (body ?? {}) as ClaudeUsageResponse;
   const windows: UsageWindow[] = [];
   for (const w of [
-    windowFrom("session-5h", "Session (5h)", data.five_hour, normalizeClaudeSessionPercent),
+    windowFrom("session-5h", "Session (5h)", data.five_hour),
     windowFrom("weekly", "Weekly", data.seven_day),
     windowFrom("weekly-opus", "Weekly (Opus)", data.seven_day_opus),
     windowFrom("weekly-sonnet", "Weekly (Sonnet)", data.seven_day_sonnet),
@@ -95,7 +100,7 @@ export function parseClaudeUsage(
     const usedCents = data.extra_usage.used_credits;
     const limitCents = data.extra_usage.monthly_limit;
     const pct =
-      normalizePercent(data.extra_usage.utilization) ??
+      normalizeClaudePercent(data.extra_usage.utilization) ??
       (usedCents !== undefined && limitCents ? Math.min(100, (usedCents / limitCents) * 100) : 0);
     windows.push({
       id: "extra-usage",