quotacap 0.0.51 → 0.0.53

package/dist/format/rows.d.ts

@@ -16,6 +16,35 @@ export interface Row {
 }
 export declare const RAIL_CELLS = 20;
 export declare const SORT_KEYS: SortKey[];
+/**
+ * Quota-window resolution, mirroring the dashboard helpers: the advisory
+ * binding window rations the account, so standalone resets, usage,
+ * elapsed, and pace read it. Weekly-bound rows fall back to the weekly
+ * fields unchanged; rate-limit windows never drive these figures.
+ */
+export declare function isMonthlyBound(ps: ProviderSnapshot): boolean;
+/** Reset instant of the quota window, or null without a quota reading. */
+export declare function bindingResetsAt(ps: ProviderSnapshot): string | null;
+/** Used percent of the quota window. Null without a quota reading. */
+export declare function bindingUsedPct(ps: ProviderSnapshot): number | null;
+/**
+ * Binding leftover for a raw quota without an advisory (model catalogs):
+ * the same scarcer-headroom rule the engine applies, so the catalog
+ * leftover and reset name the quota window, not always the week.
+ */
+export declare function bindingLeftover(quota: {
+    weeklyPct?: number;
+    resetsAt?: string;
+    monthlyKind?: string;
+    monthlyPct?: number;
+    monthlyResetsAt?: string;
+    monthlyStatus?: string;
+} | null | undefined, now: Date): {
+    leftoverPct: number | null;
+    resetsAt: string | null;
+};
+/** Window-average pace of the quota window; monthly divides monthly used by elapsed monthly days. */
+export declare function bindingAvgPace(ps: ProviderSnapshot, now: Date): number | null;
 export declare function weeklyPctOf(q: {
     weeklyPct?: number;
     usedPct?: number;
@@ -31,5 +60,5 @@ export declare function forecastText(ps: ProviderSnapshot, now: Date): string;
 export declare function compactSuffix(ps: ProviderSnapshot): CompactSuffix;
 export declare function assertValidSortKey(key: string): asserts key is SortKey;
 export declare function sortProviders(providers: ProviderSnapshot[], key: string, use: string): ProviderSnapshot[];
-export declare function paceText(ps: ProviderSnapshot): string;
+export declare function paceText(ps: ProviderSnapshot, now?: Date): string;
 export declare function buildRow(ps: ProviderSnapshot, now: Date): Row;

package/dist/format/rows.js

@@ -9,6 +9,85 @@ function msOf(iso) {
     const ms = new Date(iso).getTime();
     return Number.isNaN(ms) ? null : ms;
 }
+/**
+ * Quota-window resolution, mirroring the dashboard helpers: the advisory
+ * binding window rations the account, so standalone resets, usage,
+ * elapsed, and pace read it. Weekly-bound rows fall back to the weekly
+ * fields unchanged; rate-limit windows never drive these figures.
+ */
+export function isMonthlyBound(ps) {
+    return (ps.advisory?.bindingWindow === "monthly" &&
+        ps.quota?.monthlyKind === "included" &&
+        typeof ps.quota?.monthlyPct === "number" &&
+        !!ps.quota?.monthlyResetsAt);
+}
+/** Reset instant of the quota window, or null without a quota reading. */
+export function bindingResetsAt(ps) {
+    if (!ps.quota)
+        return null;
+    if (isMonthlyBound(ps))
+        return ps.quota.monthlyResetsAt ?? null;
+    return ps.quota.resetsAt ?? null;
+}
+/** Used percent of the quota window. Null without a quota reading. */
+export function bindingUsedPct(ps) {
+    if (!ps.quota)
+        return null;
+    if (isMonthlyBound(ps)) {
+        const m = ps.quota.monthlyPct;
+        return typeof m === "number" && Number.isFinite(m) ? Math.round(m) : null;
+    }
+    const u = weeklyPctOf(ps.quota);
+    return typeof u === "number" && Number.isFinite(u) ? Math.round(u) : null;
+}
+/** Start of the monthly window: one calendar month before its reported reset. */
+function monthlyStartMs(resetMs) {
+    const start = new Date(resetMs);
+    start.setMonth(start.getMonth() - 1);
+    return start.getTime();
+}
+/**
+ * Binding leftover for a raw quota without an advisory (model catalogs):
+ * the same scarcer-headroom rule the engine applies, so the catalog
+ * leftover and reset name the quota window, not always the week.
+ */
+export function bindingLeftover(quota, now) {
+    if (!quota || typeof quota.weeklyPct !== "number") {
+        return { leftoverPct: null, resetsAt: quota?.resetsAt ?? null };
+    }
+    const weeklyRemaining = 100 - quota.weeklyPct;
+    const weeklyDays = Math.max(0.1, (new Date(quota.resetsAt ?? "").getTime() - now.getTime()) / DAY_MS);
+    if (quota.monthlyKind === "included" &&
+        typeof quota.monthlyPct === "number" &&
+        quota.monthlyResetsAt) {
+        const monthlyRemaining = quota.monthlyStatus === "exhausted" ? 0 : Math.max(0, 100 - quota.monthlyPct);
+        const monthlyDays = Math.max(0.1, (new Date(quota.monthlyResetsAt).getTime() - now.getTime()) / DAY_MS);
+        if (monthlyRemaining / monthlyDays < weeklyRemaining / weeklyDays || monthlyRemaining === 0) {
+            return {
+                leftoverPct: Math.round(monthlyRemaining * 10) / 10,
+                resetsAt: quota.monthlyResetsAt,
+            };
+        }
+    }
+    return {
+        leftoverPct: Math.round(weeklyRemaining * 10) / 10,
+        resetsAt: quota.resetsAt ?? null,
+    };
+}
+/** Window-average pace of the quota window; monthly divides monthly used by elapsed monthly days. */
+export function bindingAvgPace(ps, now) {
+    if (!isMonthlyBound(ps))
+        return ps.advisory?.avgPace ?? null;
+    const used = ps.quota?.monthlyPct;
+    const resetMs = msOf(ps.quota?.monthlyResetsAt);
+    if (typeof used !== "number" || !Number.isFinite(used) || resetMs === null)
+        return null;
+    const elapsedDays = (now.getTime() - monthlyStartMs(resetMs)) / DAY_MS;
+    if (elapsedDays < 0.25)
+        return null;
+    const pace = used / elapsedDays;
+    return Number.isFinite(pace) ? Math.max(0, pace) : null;
+}
 // The CLI talks HTTP to a daemon that may predate the rename, which sent only
 // `usedPct`. Read both for one release; drop the fallback with the aliases.
 export function weeklyPctOf(q) {
@@ -33,7 +112,7 @@ export function dayOf(iso) {
     return `${when.toLocaleDateString("en-US", { weekday: "short" })} ${when.toLocaleDateString("en-US", { day: "numeric", month: "short" })}`;
 }
 export function countdownText(ps, now) {
-    const resetsMs = msOf(ps.quota?.resetsAt);
+    const resetsMs = msOf(bindingResetsAt(ps));
     let text;
     if (resetsMs === null)
         text = "—";
@@ -41,27 +120,31 @@ export function countdownText(ps, now) {
         text = "passed";
     else
         text = fmtDuration(resetsMs - now.getTime());
-    if (ps.quota?.resetsAtEstimated)
+    if (!isMonthlyBound(ps) && ps.quota?.resetsAtEstimated)
         text += " (est.)";
     return text;
 }
 export function elapsedPct(ps, now) {
-    const startMs = msOf(ps.quota?.periodStart);
-    const resetsMs = msOf(ps.quota?.resetsAt);
+    const resetsMs = msOf(bindingResetsAt(ps));
+    const startMs = isMonthlyBound(ps)
+        ? resetsMs === null
+            ? null
+            : monthlyStartMs(resetsMs)
+        : msOf(ps.quota?.periodStart);
     if (startMs === null || resetsMs === null || resetsMs <= startMs)
         return null;
     const pct = ((now.getTime() - startMs) / (resetsMs - startMs)) * 100;
     return Math.round(Math.min(100, Math.max(0, pct)));
 }
 export function usedPctOf(ps) {
-    const u = weeklyPctOf(ps.quota);
-    return typeof u === "number" && Number.isFinite(u) ? Math.round(u) : null;
+    return bindingUsedPct(ps);
 }
 export function railCells(ps, now) {
     const cells = new Array(RAIL_CELLS).fill("unused");
-    if (ps.exclusionReason !== null)
+    const u = bindingUsedPct(ps);
+    const is100Exhausted = typeof u === "number" && u >= 100 && !ps.resetPassed;
+    if (ps.exclusionReason !== null && !is100Exhausted)
         return cells;
-    const u = weeklyPctOf(ps.quota);
     const used = typeof u === "number" && Number.isFinite(u)
         ? Math.min(RAIL_CELLS, Math.max(0, Math.round((u / 100) * RAIL_CELLS)))
         : 0;
@@ -167,7 +250,8 @@ export function forecastText(ps, now) {
         text = "Exhausts before reset";
     }
     // Engine estimate vocabulary, mirroring the snapshot reason transform.
-    if (ps.quota?.resetsAtEstimated) {
+    // A monthly quota forecast never carries the weekly estimate flag.
+    if (!isMonthlyBound(ps) && ps.quota?.resetsAtEstimated) {
         if (text.includes("waste in"))
             text = text.replace("waste in", "estimated waste in");
         else if (text.includes("until reset"))
@@ -189,7 +273,7 @@ export function compactSuffix(ps) {
         return "!";
     if (adv.status === "watch")
         return "~";
-    if (adv.urgency !== "on track" || ps.quota?.resetsAtEstimated)
+    if (adv.urgency !== "on track" || (!isMonthlyBound(ps) && ps.quota?.resetsAtEstimated))
         return "~";
     return "";
 }
@@ -203,8 +287,7 @@ function wasteOf(p) {
     return typeof w === "number" && Number.isFinite(w) ? w : null;
 }
 function finiteUsed(p) {
-    const u = weeklyPctOf(p.quota);
-    return typeof u === "number" && Number.isFinite(u) ? u : null;
+    return bindingUsedPct(p);
 }
 export function sortProviders(providers, key, use) {
     assertValidSortKey(key);
@@ -241,8 +324,8 @@ export function sortProviders(providers, key, use) {
         case "reset-desc": {
             const dir = key === "reset-asc" ? 1 : -1;
             indexed.sort((a, b) => {
-                const ra = msOf(a.p.quota?.resetsAt);
-                const rb = msOf(b.p.quota?.resetsAt);
+                const ra = msOf(bindingResetsAt(a.p));
+                const rb = msOf(bindingResetsAt(b.p));
                 if (ra === null && rb === null)
                     return a.i - b.i;
                 if (ra === null)
@@ -275,21 +358,24 @@ export function sortProviders(providers, key, use) {
         }
     }
 }
-// Compact pace pair: window average first, 24h rate alongside. A pair that
-// renders identically at display precision collapses to one figure.
-export function paceText(ps) {
+// Compact pace pair: quota-window average first, 24h rate alongside. A pair
+// that renders identically at display precision collapses to one figure.
+// The 24h rate is weekly-only: a monthly-bound row shows its monthly
+// average alone.
+export function paceText(ps, now = new Date()) {
     const adv = ps.advisory;
     if (!adv)
         return "—";
-    // avgPace is absent on advisories from a daemon older than the split.
-    const avg = adv.avgPace ?? null;
+    const avg = bindingAvgPace(ps, now);
     // The 24h figure is the measured recentRate, never the blended forecast
     // input; an older daemon omits the field and burnRate was the raw rate then.
-    const recent = adv.recentRate !== undefined
-        ? adv.recentRate
-        : adv.paceSource === "recent"
-            ? adv.burnRate
-            : null;
+    const recent = isMonthlyBound(ps)
+        ? null
+        : adv.recentRate !== undefined
+            ? adv.recentRate
+            : adv.paceSource === "recent"
+                ? adv.burnRate
+                : null;
     if (avg !== null && recent !== null && avg.toFixed(1) !== recent.toFixed(1)) {
         return `${avg.toFixed(1)} avg · ${recent.toFixed(1)} 24h`;
     }
@@ -308,6 +394,6 @@ export function buildRow(ps, now) {
         elapsedPct: elapsedPct(ps, now),
         usedPct: usedPctOf(ps),
         railCells: railCells(ps, now),
-        pace: paceText(ps),
+        pace: paceText(ps, now),
     };
 }

package/dist/format/terminal.js

@@ -1,4 +1,4 @@
-import { buildRow, compactSuffix, sortProviders, weeklyPctOf, } from "./rows.js";
+import { buildRow, compactSuffix, isMonthlyBound, sortProviders, weeklyPctOf, } from "./rows.js";
 const GAP = "  ";
 const MIN_PROV_WIDTH = 12;
 const MAX_PROV_WIDTH = 22;
@@ -83,7 +83,8 @@ export function renderWide(snapshot, opts) {
         const close = p.lastCloses?.[0];
         if (!close)
             return null;
-        const tail = `last week ${close.leftoverPct}% leftover${close.resetsAtEstimated ? " (est.)" : ""}`;
+        const unit = isMonthlyBound(p) ? "month" : "week";
+        const tail = `last ${unit} ${close.leftoverPct}% leftover${close.resetsAtEstimated ? " (est.)" : ""}`;
         return `${resetsIndent}${paint(tail, DIM)}`;
     };
     const header = [
@@ -144,7 +145,8 @@ export function renderNarrow(snapshot, opts) {
         const close = p.lastCloses?.[0];
         if (close) {
             const indent = " ".repeat(row.railCells.length + " resets ".length);
-            const tail = `last week ${close.leftoverPct}% leftover${close.resetsAtEstimated ? " (est.)" : ""}`;
+            const unit = isMonthlyBound(p) ? "month" : "week";
+            const tail = `last ${unit} ${close.leftoverPct}% leftover${close.resetsAtEstimated ? " (est.)" : ""}`;
             lines.push(`${indent}${color ? `${DIM}${tail}${RESET}` : tail}`);
         }
     }

package/dist/http/server.d.ts

@@ -12,6 +12,9 @@ export interface RuntimeContext {
     providerNames?: Record<string, string>;
     /** Detected-but-not-enabled opt-in providers, computed once at start. */
     detectedProviders?: string[];
+    /** Login command for the detected OpenCode CLI version, filled in
+     *  asynchronously after start; null until known. */
+    opencodeLoginCommand?: string | null;
     version: string;
     exec: string;
     now?: () => Date;

package/dist/http/server.js

@@ -19,6 +19,7 @@ import { providerIdentity } from "../advisory/provider-names.js";
 import { setProviderNameOverride, setProviderEnabled } from "../config.js";
 import { ensureCatalogs, catalogProviders, CATALOG_FAIL_COOLDOWN_MS } from "../catalog/index.js";
 import { getAllLatest } from "../store/quotas.js";
+import { bindingLeftover } from "../format/rows.js";
 const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "[::1]", "::1"]);
 export function hostnameFromHostHeader(hostHeader) {
     if (typeof hostHeader !== "string" || !hostHeader.trim())
@@ -122,6 +123,7 @@ function snapshotOf(ctx) {
                 checkedAt: cache?.checkedAt ?? null,
             },
             detectedProviders: ctx.detectedProviders ?? [],
+            opencodeLoginCommand: ctx.opencodeLoginCommand ?? null,
         },
     });
 }
@@ -217,17 +219,18 @@ export function buildApp(ctx) {
     const catalogTtl = ctx.catalogTtlHours ?? 6;
     function projectModels(catalogs, quotaMap) {
         const out = [];
+        const now = ctx.now?.() ?? new Date();
         for (const [id, catalog] of catalogs) {
             const identity = providerIdentity(id, ctx.providerNames);
             const quota = quotaMap.get(id);
-            const leftoverPct = quota?.weeklyPct != null ? Math.round((100 - quota.weeklyPct) * 10) / 10 : null;
+            const binding = bindingLeftover(quota, now);
             out.push({
                 id,
                 displayName: identity.displayName,
                 harness: identity.harness,
                 vendor: identity.vendor,
-                leftoverPct,
-                resetsAt: quota?.resetsAt ?? null,
+                leftoverPct: binding.leftoverPct,
+                resetsAt: binding.resetsAt,
                 catalog,
             });
         }
@@ -454,6 +457,7 @@ export function buildApp(ctx) {
                 plan: parsed.plan,
                 weeklyPct: parsed.weeklyPct,
                 fiveHourPct: parsed.fiveHourPct,
+                fiveHourResetsAt: parsed.fiveHourResetsAt,
                 resetsAt: parsed.resetsAt,
                 periodStart: parsed.periodStart,
                 source: "manual",

package/dist/runtime/service.js

@@ -16,7 +16,7 @@ import { buildApp } from "../http/server.js";
 import { detectChannel, refreshUpdateCache } from "./updates.js";
 import { VERSION } from "../version.js";
 import { claudeAdapter } from "../adapters/claude.js";
-import { opencodeGoDetected } from "../adapters/opencode-go.js";
+import { detectOpenCodeLoginCommand, opencodeGoDetected } from "../adapters/opencode-go.js";
 import { classifyFailure } from "../diagnostics/failure.js";
 import { ensureCatalogs, catalogProviders } from "../catalog/index.js";
 export function resolveClaudeExecPath() {
@@ -196,12 +196,13 @@ export async function startService(opts) {
                 }).catch(() => { });
             },
         });
-        app = buildApp({
+        const appCtx = {
             db,
             token,
             coordinator,
             enabledProviders: config.enabledProviders,
             detectedProviders: opencodeGoDetected() ? ["opencode-go"] : [],
+            opencodeLoginCommand: null,
             providerNames: config.providerNames,
             catalogTtlHours: config.catalogTtlHours,
             version: VERSION,
@@ -213,7 +214,17 @@ export async function startService(opts) {
             // hoisted declaration below; it can only fire after listen, so the
             // shutdown bindings it closes over are initialized by then).
             onRestart: () => onSignal(),
-        });
+        };
+        app = buildApp(appCtx);
+        // Version-specific OpenCode login command for the fault banner:
+        // detected once, in the background, never blocking readiness.
+        if (config.enabledProviders.includes("opencode-go") || appCtx.detectedProviders.length > 0) {
+            void detectOpenCodeLoginCommand()
+                .then((cmd) => {
+                appCtx.opencodeLoginCommand = cmd;
+            })
+                .catch(() => { });
+        }
         // 6. Bind; unwind on failure without polling.
         await app.listen({ port, host: "127.0.0.1" });
         const bound = app.server.address();

package/dist/service/macos.d.ts

@@ -16,6 +16,11 @@ export interface ServiceDeps {
     lintPlist?: (plistFile: string) => void;
     waitReady?: (port: number) => Promise<boolean>;
     waitReleased?: (port: number) => Promise<boolean>;
+    /** Internal: the caller just stopped this job and is replacing it, so a
+     *  still-loaded record at bootstrap time is the dying one — keep
+     *  retrying until it clears instead of treating it as already loaded.
+     *  Only restart sets this; a plain start keeps the idempotent shortcut. */
+    expectReplace?: boolean;
     print?: (msg: string) => void;
     error?: (msg: string) => void;
     now?: () => Date;

package/dist/service/macos.js

@@ -422,7 +422,7 @@ export async function start(deps = {}) {
     const { home, uid, dataDir, print, run, sleep, bootstrapTimeoutMs } = resolved(deps);
     const plistFile = plistFileFor(home);
     await bootstrapWithRetry(run, uid, plistFile, {
-        expectReplace: false,
+        expectReplace: deps.expectReplace ?? false,
         sleep,
         timeoutMs: bootstrapTimeoutMs,
     });
@@ -452,7 +452,11 @@ export async function restart(deps = {}) {
     if (!(await waitReleased(port))) {
         (deps.print ?? console.log)(`port ${port} is still in use after stopping; starting anyway`);
     }
-    await start(deps);
+    // The record we just booted out can still be clearing when start
+    // bootstraps: error 5 plus a loaded record would read as an idempotent
+    // double-start and skip the bootstrap entirely, leaving nothing running
+    // once the old record finishes clearing. Replace, don't shortcut.
+    await start({ ...deps, expectReplace: true });
 }
 function parsePrintOutput(out) {
     const pidMatch = out.match(/^\s*pid\s*=\s*(\d+)/m);

package/dist/store/db.js

@@ -36,7 +36,7 @@ export function openDb(p) {
     return db;
 }
 export function migrate(db) {
-    db.exec(`CREATE TABLE IF NOT EXISTS quotas(id INTEGER PRIMARY KEY, provider TEXT, plan TEXT, used_pct REAL, resets_at TEXT, period_start TEXT, source TEXT, fetched_at TEXT, credits_usd REAL, resets_at_estimated INTEGER, session_pct REAL, monthly_pct REAL, monthly_resets_at TEXT, monthly_status TEXT, monthly_kind TEXT);
+    db.exec(`CREATE TABLE IF NOT EXISTS quotas(id INTEGER PRIMARY KEY, provider TEXT, plan TEXT, used_pct REAL, resets_at TEXT, period_start TEXT, source TEXT, fetched_at TEXT, credits_usd REAL, resets_at_estimated INTEGER, session_pct REAL, monthly_pct REAL, monthly_resets_at TEXT, monthly_status TEXT, monthly_kind TEXT, five_hour_resets_at TEXT);
            CREATE TABLE IF NOT EXISTS snapshots(day TEXT, provider TEXT, used_pct REAL, burn_rate REAL, ideal_rate REAL, PRIMARY KEY(day, provider));
            CREATE TABLE IF NOT EXISTS adapter_attempts(provider TEXT PRIMARY KEY, attempted_at TEXT NOT NULL, completed_at TEXT, succeeded_at TEXT, success INTEGER NOT NULL, failure_category TEXT, diagnostic_code TEXT, summary TEXT, action TEXT, error_detail TEXT);
            CREATE INDEX IF NOT EXISTS idx_quotas_provider ON quotas(provider);
@@ -104,6 +104,7 @@ export function migrate(db) {
         ["monthly_resets_at", "TEXT"],
         ["monthly_status", "TEXT"],
         ["monthly_kind", "TEXT"],
+        ["five_hour_resets_at", "TEXT"],
     ]) {
         if (!quotaCols.has(column))
             db.exec(`ALTER TABLE quotas ADD COLUMN ${column} ${type}`);

package/dist/store/quotas.d.ts

@@ -8,7 +8,7 @@ export declare function isWeeklyCycleBreak(prev: {
     resetsAt: string | null;
 }): boolean;
 export declare function upsertQuota(db: any, q: any): void;
-export declare function getWindowCloses(db: any, provider: string, limit?: number): Array<{
+export declare function getWindowCloses(db: any, provider: string, limit?: number, window?: "weekly" | "monthly"): Array<{
     provider: string;
     plan: string | null;
     usedPct: number;

package/dist/store/quotas.js

@@ -30,6 +30,10 @@ function mapRow(row) {
         delete out.fiveHourPct;
         delete out.sessionPct;
     }
+    out.fiveHourResetsAt = row.five_hour_resets_at ?? row.fiveHourResetsAt ?? undefined;
+    delete out.five_hour_resets_at;
+    if (out.fiveHourResetsAt == null)
+        delete out.fiveHourResetsAt;
     // A junk monthly percent means no usable monthly reading. It never
     // invalidates the provider; only a bad weekly percent does (snapshot.ts).
     const m = row.monthly_pct;
@@ -85,7 +89,7 @@ export function upsertQuota(db, q) {
                     .run(prev.provider, prev.plan ?? null, prev.weeklyPct, Math.max(0, 100 - prev.weeklyPct), prev.fetchedAt, prev.id, prev.periodStart ?? null, prev.resetsAt ?? null, prev.resetsAtEstimated ? 1 : null, q.fetchedAt, reason);
             }
         }
-        db.prepare(`INSERT INTO quotas(provider, plan, used_pct, resets_at, period_start, source, fetched_at, credits_usd, resets_at_estimated, session_pct, monthly_pct, monthly_resets_at, monthly_status, monthly_kind) VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?,?)`).run(q.provider, q.plan, weeklyPct, q.resetsAt, q.periodStart, q.source, q.fetchedAt, credits, estimated, fiveHourPct, q.monthlyPct ?? null, q.monthlyResetsAt ?? null, q.monthlyStatus ?? null, q.monthlyKind ?? null);
+        db.prepare(`INSERT INTO quotas(provider, plan, used_pct, resets_at, period_start, source, fetched_at, credits_usd, resets_at_estimated, session_pct, monthly_pct, monthly_resets_at, monthly_status, monthly_kind, five_hour_resets_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`).run(q.provider, q.plan, weeklyPct, q.resetsAt, q.periodStart, q.source, q.fetchedAt, credits, estimated, fiveHourPct, q.monthlyPct ?? null, q.monthlyResetsAt ?? null, q.monthlyStatus ?? null, q.monthlyKind ?? null, q.fiveHourResetsAt ?? null);
         const day = new Date().toISOString().slice(0, 10);
         db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES(?,?,?) ON CONFLICT(day, provider) DO UPDATE SET used_pct=excluded.used_pct`).run(day, q.provider, weeklyPct);
         db.exec("COMMIT");
@@ -98,7 +102,66 @@ export function upsertQuota(db, q) {
         throw e;
     }
 }
-export function getWindowCloses(db, provider, limit = 4) {
+function monthlyPeriodStart(resetIso) {
+    if (!resetIso)
+        return null;
+    const resetMs = Date.parse(resetIso);
+    if (!Number.isFinite(resetMs))
+        return null;
+    const start = new Date(resetMs);
+    start.setMonth(start.getMonth() - 1);
+    return start.toISOString();
+}
+export function getWindowCloses(db, provider, limit = 4, window = "weekly") {
+    if (window === "monthly") {
+        let qRows = [];
+        try {
+            qRows = db
+                .prepare(`SELECT id, provider, plan, monthly_pct, monthly_resets_at, monthly_kind, fetched_at FROM quotas WHERE provider=? ORDER BY fetched_at ASC, id ASC`)
+                .all(provider);
+        }
+        catch (e) {
+            if (!/no such table|no such column/i.test(String(e?.message ?? "")))
+                throw e;
+        }
+        const valid = qRows.filter((r) => r.monthly_kind === "included" &&
+            typeof r.monthly_pct === "number" &&
+            Number.isFinite(r.monthly_pct) &&
+            r.monthly_pct >= 0 &&
+            r.monthly_pct <= 100 &&
+            typeof r.monthly_resets_at === "string" &&
+            Number.isFinite(Date.parse(r.monthly_resets_at)) &&
+            Number.isFinite(Date.parse(r.fetched_at)));
+        const closes = [];
+        for (let i = 1; i < valid.length; i++) {
+            const prev = valid[i - 1];
+            const cur = valid[i];
+            const reason = cycleBreakReason({
+                usedPct: prev.monthly_pct,
+                t: Date.parse(prev.fetched_at),
+                resetsAt: prev.monthly_resets_at ?? null,
+            }, {
+                usedPct: cur.monthly_pct,
+                t: Date.parse(cur.fetched_at),
+                resetsAt: cur.monthly_resets_at ?? null,
+            });
+            if (reason) {
+                closes.push({
+                    provider: prev.provider,
+                    plan: prev.plan ?? null,
+                    usedPct: prev.monthly_pct,
+                    leftoverPct: Math.max(0, 100 - prev.monthly_pct),
+                    sampledAt: prev.fetched_at,
+                    periodStart: monthlyPeriodStart(prev.monthly_resets_at),
+                    resetsAt: prev.monthly_resets_at ?? null,
+                    resetsAtEstimated: false,
+                    detectedAt: cur.fetched_at,
+                    reason,
+                });
+            }
+        }
+        return closes.reverse().slice(0, limit);
+    }
     let rows = [];
     try {
         rows = db.prepare(`SELECT provider, plan, used_pct, leftover_pct, sampled_at, period_start, resets_at, resets_at_estimated, detected_at, reason FROM window_closes WHERE provider=? ORDER BY detected_at DESC, id DESC LIMIT ?`).all(provider, limit);

package/dist/version.js

@@ -1,2 +1,2 @@
 // generated by scripts/build-embed.mjs — do not edit
-export const VERSION = "0.0.51";
+export const VERSION = "0.0.53";

package/dist/web/src/App.js

@@ -8,6 +8,7 @@ import { Recommendation } from "./components/Recommendation.js";
 import { SubscriptionList } from "./components/SubscriptionList.js";
 import { ResetRail } from "./components/ResetRail.js";
 import { ProviderDrawer } from "./components/ProviderDrawer.js";
+import { DrawerErrorFallback, ErrorBoundary } from "./components/ErrorBoundary.js";
 import { AdviceDrawer } from "./components/AdviceDrawer.js";
 import { SettingsDrawer } from "./components/settings/SettingsDrawer.js";
 import { navigate, routeFor, useRoute } from "./router.js";
@@ -127,7 +128,7 @@ function App() {
         : null;
     const header = (_jsx(Header, { runtime: snapshot?.runtime ?? null, unreachable: error?.kind === "service-unavailable", refreshing: refreshing, onRefresh: () => void refresh(), onSettings: () => setSettingsOpen(true) }));
     if (snapshot && setupMode) {
-        return (_jsxs(_Fragment, { children: [header, _jsxs("main", { children: [notice && (_jsx("div", { "data-testid": "refresh-notice", role: "status", children: notice })), showOpenCodeGoBanner(snapshot.runtime, snapshot.providers, goSuppressed) && (_jsx(OpencodeGoBanner, { onEnable: () => setConsentOpen(true) })), _jsx(Onboarding, { snapshot: snapshot, onFirstPoll: () => void refresh(), polling: refreshing, pollError: pollErrorText })] }), _jsx(SettingsDrawer, { open: settingsOpen, providers: snapshot.providers, onRefresh: () => void refresh(), refreshing: refreshing, onSetProviderEnabled: handleSetProviderEnabled, onClose: () => setSettingsOpen(false) }), consentOpen && (_jsx(ConsentModal, { busy: consentBusy, onCancel: () => setConsentOpen(false), onConfirm: () => void (async () => {
+        return (_jsxs(_Fragment, { children: [header, _jsxs("main", { children: [notice && (_jsx("div", { "data-testid": "refresh-notice", role: "status", children: notice })), showOpenCodeGoBanner(snapshot.runtime, snapshot.providers, goSuppressed) && (_jsx(OpencodeGoBanner, { onEnable: () => setConsentOpen(true) })), _jsx(Onboarding, { snapshot: snapshot, onFirstPoll: () => void refresh(), polling: refreshing, pollError: pollErrorText })] }), _jsx(SettingsDrawer, { open: settingsOpen, providers: snapshot.providers, refreshing: refreshing, onSetProviderEnabled: handleSetProviderEnabled, onClose: () => setSettingsOpen(false) }), consentOpen && (_jsx(ConsentModal, { loginCommand: snapshot?.runtime.opencodeLoginCommand, busy: consentBusy, onCancel: () => setConsentOpen(false), onConfirm: () => void (async () => {
                         setConsentBusy(true);
                         try {
                             await setProviderEnabled("opencode-go", true, true);
@@ -149,13 +150,15 @@ function App() {
                                 border: i === 0 ? "1px solid var(--rec)" : "1px solid var(--line)",
                                 borderRadius: 8,
                                 marginBottom: 8,
-                            } }, i))) })), error?.kind === "service-unavailable" && !snapshot && (_jsx(UnavailablePanel, { endpoint: daemonEndpoint(), lastGood: snapshot, onRetry: () => void load() })), error?.kind === "http-error" && !snapshot && (_jsx(HttpErrorPanel, { status: error.status, message: error.message, lastGood: snapshot, onRetry: () => void load() })), error && snapshot && (_jsxs("div", { "data-testid": "state-stale-error", role: "alert", children: [error.kind === "http-error" ? `Request failed (HTTP ${error.status}): ` : "Service unavailable: ", error.message, " Showing last readings (", ageLabel(snapshot.asOf), ").", " ", _jsx("button", { type: "button", onClick: () => void load(), children: "Retry" })] })), snapshot && (_jsx(FaultBanner, { providers: snapshot.providers, onRepoll: () => void refresh(), repolling: refreshing, polling: snapshot.runtime.polling })), snapshot && showOpenCodeGoBanner(snapshot.runtime, snapshot.providers, goSuppressed) && (_jsx(OpencodeGoBanner, { onEnable: () => setConsentOpen(true) })), snapshot && (_jsx(ReadyView, { snapshot: snapshot, onSelectProvider: (id) => {
+                            } }, i))) })), error?.kind === "service-unavailable" && !snapshot && (_jsx(UnavailablePanel, { endpoint: daemonEndpoint(), lastGood: snapshot, onRetry: () => void load() })), error?.kind === "http-error" && !snapshot && (_jsx(HttpErrorPanel, { status: error.status, message: error.message, lastGood: snapshot, onRetry: () => void load() })), error && snapshot && (_jsxs("div", { "data-testid": "state-stale-error", role: "alert", children: [error.kind === "http-error" ? `Request failed (HTTP ${error.status}): ` : "Service unavailable: ", error.message, " Showing last readings (", ageLabel(snapshot.asOf), ").", " ", _jsx("button", { type: "button", onClick: () => void load(), children: "Retry" })] })), snapshot && (_jsx(FaultBanner, { providers: snapshot.providers, onRepoll: () => void refresh(), repolling: refreshing, polling: snapshot.runtime.polling, opencodeLoginCommand: snapshot.runtime.opencodeLoginCommand })), snapshot && showOpenCodeGoBanner(snapshot.runtime, snapshot.providers, goSuppressed) && (_jsx(OpencodeGoBanner, { onEnable: () => setConsentOpen(true) })), snapshot && (_jsx(ReadyView, { snapshot: snapshot, onSelectProvider: (id) => {
                             setAdviceOpen(false);
                             setSelectedProvider(id);
                         }, onViewAdvice: () => {
                             setSelectedProvider(null);
                             setAdviceOpen(true);
-                        } }))] }), _jsx(ProviderDrawer, { provider: snapshot?.providers.find((p) => p.id === selectedProvider) ?? null, asOf: snapshot?.asOf ?? "", recommendation: snapshot?.recommendation ?? null, onClose: () => setSelectedProvider(null), onRenamed: () => void load() }), consentOpen && (_jsx(ConsentModal, { busy: consentBusy, onCancel: () => setConsentOpen(false), onConfirm: () => void (async () => {
+                        } }))] }), _jsx(ErrorBoundary, { resetKey: selectedProvider, fallback: _jsx(DrawerErrorFallback, { name: snapshot?.providers.find((p) => p.id === selectedProvider)?.displayName ??
+                        selectedProvider ??
+                        "provider", onClose: () => setSelectedProvider(null) }), children: _jsx(ProviderDrawer, { provider: snapshot?.providers.find((p) => p.id === selectedProvider) ?? null, asOf: snapshot?.asOf ?? "", recommendation: snapshot?.recommendation ?? null, onClose: () => setSelectedProvider(null), onRenamed: () => void load() }) }), consentOpen && (_jsx(ConsentModal, { loginCommand: snapshot?.runtime.opencodeLoginCommand, busy: consentBusy, onCancel: () => setConsentOpen(false), onConfirm: () => void (async () => {
                     setConsentBusy(true);
                     try {
                         await setProviderEnabled("opencode-go", true, true);
@@ -169,7 +172,10 @@ function App() {
                     finally {
                         setConsentBusy(false);
                     }
-                })() })), snapshot && (_jsx(AdviceDrawer, { open: adviceOpen, recommendation: snapshot.recommendation, providers: snapshot.providers, asOf: snapshot.asOf, onClose: () => setAdviceOpen(false) })), _jsx(SettingsDrawer, { open: settingsOpen, providers: snapshot?.providers ?? [], onRefresh: () => void refresh(), refreshing: refreshing, onSetProviderEnabled: handleSetProviderEnabled, onClose: () => setSettingsOpen(false) }), _jsx(SiteFooter, { version: snapshot?.runtime.version })] }));
+                })() })), snapshot && (_jsx(AdviceDrawer, { open: adviceOpen, recommendation: snapshot.recommendation, providers: snapshot.providers, asOf: snapshot.asOf, onClose: () => setAdviceOpen(false), onSelectProvider: (id) => {
+                    setAdviceOpen(false);
+                    setSelectedProvider(id);
+                } })), _jsx(SettingsDrawer, { open: settingsOpen, providers: snapshot?.providers ?? [], refreshing: refreshing, onSetProviderEnabled: handleSetProviderEnabled, onClose: () => setSettingsOpen(false) }), _jsx(SiteFooter, { version: snapshot?.runtime.version })] }));
 }
 const el = typeof document === "undefined" ? null : document.getElementById("app");
 if (el)

package/dist/web/src/components/AdviceDrawer.d.ts

@@ -1,9 +1,10 @@
 import React from "react";
 import type { ProviderView, RecommendationView } from "../state.js";
-export declare function AdviceDrawer({ open, recommendation, providers, asOf, onClose, }: {
+export declare function AdviceDrawer({ open, recommendation, providers, asOf, onClose, onSelectProvider, }: {
     open: boolean;
     recommendation: RecommendationView;
     providers: ProviderView[];
     asOf: string;
     onClose: () => void;
+    onSelectProvider?: (id: string) => void;
 }): React.JSX.Element | null;