quotacap 0.0.54 → 0.0.55

package/dist/advisory/engine.d.ts

@@ -9,10 +9,13 @@ import type { Advisory, RecommendationBasis, BindingWindow } from "./types.js";
  * when less than MIN_PACE_SPAN_DAYS has elapsed (annualizing a smaller
  * denominator fabricates verdicts).
  */
-export declare function averagePace(q: Quota, now?: Date): number | null;
+export declare function averagePace(q: Quota, now?: Date, exhaustedAt?: string | null): number | null;
 export declare function blendForecast(recent: number | null, baseline: number | null): number | null;
 export declare function baselineFor(historyAvg: number | null, q: Quota, now: Date): number | null;
-export declare function computeAdvisory(q: Quota, recent: number | null, baseline: number | null, now?: Date): Advisory;
+export declare function computeAdvisory(q: Quota, recent: number | null, baseline: number | null, now?: Date, exhaustedTimestamps?: string | {
+    weekly?: string | null;
+    monthly?: string | null;
+} | null): Advisory;
 export declare function recommend(quotas: Quota[], _task: string, paceByProvider?: Map<string, {
     recent: number | null;
     baseline: number | null;

package/dist/advisory/engine.js

@@ -9,16 +9,22 @@ const DAY_MS = 86400000;
  * when less than MIN_PACE_SPAN_DAYS has elapsed (annualizing a smaller
  * denominator fabricates verdicts).
  */
-export function averagePace(q, now = new Date()) {
+export function averagePace(q, now = new Date(), exhaustedAt) {
     if (!q.periodStart)
         return null;
     const start = new Date(q.periodStart).getTime();
     if (Number.isNaN(start))
         return null;
-    const elapsedDays = (now.getTime() - start) / DAY_MS;
-    if (elapsedDays < MIN_PACE_SPAN_DAYS)
+    const endMs = exhaustedAt && q.weeklyPct >= 100
+        ? new Date(exhaustedAt).getTime()
+        : now.getTime();
+    if (Number.isNaN(endMs))
         return null;
-    const pace = q.weeklyPct / elapsedDays;
+    const elapsedDays = (endMs - start) / DAY_MS;
+    const effectiveDays = q.weeklyPct >= 100 ? Math.max(MIN_PACE_SPAN_DAYS, elapsedDays) : elapsedDays;
+    if (effectiveDays < MIN_PACE_SPAN_DAYS)
+        return null;
+    const pace = q.weeklyPct / effectiveDays;
     if (!Number.isFinite(pace))
         return null;
     return Math.max(0, pace);
@@ -57,15 +63,15 @@ function elapsedPctOf(q, now) {
         return null;
     return Math.min(100, Math.max(0, (elapsed / span) * 100));
 }
-export function computeAdvisory(q, recent, baseline, now = new Date()) {
+export function computeAdvisory(q, recent, baseline, now = new Date(), exhaustedTimestamps) {
     const resets = new Date(q.resetsAt);
     const daysLeft = Math.max(0.1, (resets.getTime() - now.getTime()) / DAY_MS);
     const remaining = 100 - q.weeklyPct;
     const idealRate = remaining / daysLeft;
-    const avgPace = averagePace(q, now);
-    // Nothing left to burn: force the capped verdict even when the recent
-    // window is flat (burn 0 at 100% used must not read "on track").
-    const exhausted = remaining <= 0;
+    const weeklyExhaustedAt = typeof exhaustedTimestamps === "string"
+        ? exhaustedTimestamps
+        : exhaustedTimestamps?.weekly ?? (q.weeklyPct >= 100 ? (q.fetchedAt ?? null) : null);
+    const avgPace = averagePace(q, now, weeklyExhaustedAt);
     const burnRate = blendForecast(recent, baseline);
     // Above every return: the unknown-pace path below is exactly what pool 2
     // ranks, so a binding computed later would leave it on weekly numbers.
@@ -83,6 +89,16 @@ export function computeAdvisory(q, recent, baseline, now = new Date()) {
             bindingDaysLeft = monthlyDaysLeft;
         }
     }
+    const monthlyExhaustedAt = typeof exhaustedTimestamps === "object" && exhaustedTimestamps !== null
+        ? exhaustedTimestamps.monthly ?? (bindingRemaining <= 0 ? (q.fetchedAt ?? null) : null)
+        : null;
+    const monthlyExhausted = bindingWindow === "monthly" && bindingRemaining <= 0;
+    const exhausted = remaining <= 0;
+    const exhaustedAt = monthlyExhausted
+        ? monthlyExhaustedAt
+        : exhausted
+            ? weeklyExhaustedAt
+            : null;
     // paceSource describes recent availability; the blend's composition is
     // carried by recentRate and baselineRate.
     const paceSource = recent !== null ? "recent" : burnRate !== null ? "window-average" : "unknown";
@@ -107,6 +123,7 @@ export function computeAdvisory(q, recent, baseline, now = new Date()) {
             bindingWindow,
             bindingRemaining,
             bindingDaysLeft,
+            exhaustedAt,
         };
     }
     if (exhausted) {
@@ -129,6 +146,7 @@ export function computeAdvisory(q, recent, baseline, now = new Date()) {
             bindingWindow,
             bindingRemaining,
             bindingDaysLeft,
+            exhaustedAt,
         };
     }
     // Red needs a deadband margin and a cumulatively-ahead position on a
@@ -159,7 +177,7 @@ export function computeAdvisory(q, recent, baseline, now = new Date()) {
         urgency = "save";
     if (estimated && urgency === "burn now")
         urgency = "use soon";
-    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, recentRate: recent, baselineRate: baseline, aheadOfElapsed, avgPace, burnMeasured, paceSource, daysToExhaust, status, wastePct, urgency, bindingWindow, bindingRemaining, bindingDaysLeft };
+    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, recentRate: recent, baselineRate: baseline, aheadOfElapsed, avgPace, burnMeasured, paceSource, daysToExhaust, status, wastePct, urgency, bindingWindow, bindingRemaining, bindingDaysLeft, exhaustedAt };
 }
 /**
  * Known-waste sort key. `wastePct` is a flow (budget forecast to go unspent

package/dist/advisory/snapshot.js

@@ -1,4 +1,4 @@
-import { getAllLatest, getBurnRates, getHistoryBaseline, getWindowCloses } from "../store/quotas.js";
+import { getAllLatest, getBurnRates, getExhaustedTimestamps, getHistoryBaseline, getWindowCloses } from "../store/quotas.js";
 import { getAttempts } from "../store/attempts.js";
 import { getCatalogs } from "../store/catalogs.js";
 import { emptyCatalog } from "../catalog/types.js";
@@ -27,6 +27,7 @@ function normalizeAdvisory(adv) {
         bindingDaysLeft: Number.isFinite(adv.bindingDaysLeft)
             ? adv.bindingDaysLeft
             : Number.isFinite(adv.daysLeft) ? adv.daysLeft : 0,
+        exhaustedAt: typeof adv.exhaustedAt === "string" ? adv.exhaustedAt : null,
     };
 }
 export function buildSnapshot(db, opts) {
@@ -49,6 +50,7 @@ export function buildSnapshot(db, opts) {
     }
     const unionIds = Array.from(new Set([...opts.enabledProviders, ...storedIds])).sort((a, b) => a.localeCompare(b));
     const burnRates = getBurnRates(db, asOfMs);
+    const exhaustedTimestamps = getExhaustedTimestamps(db, asOfMs);
     const history = getHistoryBaseline(db);
     const catalogMap = getCatalogs(db);
     const providerSnapshots = [];
@@ -128,7 +130,11 @@ export function buildSnapshot(db, opts) {
             const recent = burnRates.get(id) ?? null;
             const baseline = baselineFor(history.get(id) ?? null, quota, now);
             pace = { recent, baseline };
-            rawAdvisory = computeAdvisory(quota, recent, baseline, now);
+            const exhausted = {
+                weekly: exhaustedTimestamps.weekly.get(id) ?? null,
+                monthly: exhaustedTimestamps.monthly.get(id) ?? null,
+            };
+            rawAdvisory = computeAdvisory(quota, recent, baseline, now, exhausted);
         }
         const advisory = normalizeAdvisory(rawAdvisory);
         // Controlled evidence vocabulary

package/dist/advisory/types.d.ts

@@ -46,6 +46,8 @@ export interface Advisory {
     bindingRemaining: number;
     /** Days until the binding window resets. Equals `daysLeft` when weekly binds. */
     bindingDaysLeft: number;
+    /** ISO timestamp when the binding quota reached 100% in this window, or null if not exhausted. */
+    exhaustedAt?: string | null;
 }
 export interface Recommendation {
     use: string;

package/dist/config.js

@@ -32,7 +32,7 @@ export const ProviderDisplayNameSchema = z
     .transform((val) => val.trim());
 const ConfigSchema = z.object({
     port: z.number().default(8787),
-    pollMinutes: z.number().default(15),
+    pollMinutes: z.number().default(10),
     catalogTtlHours: z.number().finite().positive().default(6),
     enabledProviders: z.array(z.string()).default(["claude", "codex", "kimi", "grok", "agy", "muse"]),
     knownProviders: z.array(z.string()).default(["claude", "codex", "kimi", "grok", "agy", "muse"]),

package/dist/store/quotas.d.ts

@@ -25,4 +25,8 @@ export declare function getAllLatest(db: any): any;
 export declare const getQuotas: typeof getAllLatest;
 export declare function getSnapshots(db: any): any;
 export declare function getBurnRates(db: any, now?: number): Map<string, number>;
+export declare function getExhaustedTimestamps(db: any, now?: number): {
+    weekly: Map<string, string>;
+    monthly: Map<string, string>;
+};
 export declare function getHistoryBaseline(db: any, limit?: number): Map<string, number>;

package/dist/store/quotas.js

@@ -239,6 +239,58 @@ export function getBurnRates(db, now = Date.now()) {
     }
     return out;
 }
+export function getExhaustedTimestamps(db, now = Date.now()) {
+    let rows = [];
+    try {
+        rows = db
+            .prepare(`SELECT provider, used_pct, fetched_at, resets_at, monthly_pct, monthly_status FROM quotas`)
+            .all();
+    }
+    catch (e) {
+        if (!/no such column/i.test(String(e?.message ?? "")))
+            throw e;
+        rows = db
+            .prepare(`SELECT provider, used_pct, fetched_at, resets_at FROM quotas`)
+            .all();
+    }
+    const byProvider = new Map();
+    for (const r of rows) {
+        const t = new Date(r.fetched_at).getTime();
+        if (Number.isNaN(t) || t > now)
+            continue;
+        const pts = byProvider.get(r.provider) ?? [];
+        pts.push({
+            usedPct: r.used_pct,
+            t,
+            resetsAt: r.resets_at,
+            monthlyPct: r.monthly_pct,
+            monthlyStatus: r.monthly_status,
+        });
+        byProvider.set(r.provider, pts);
+    }
+    const weekly = new Map();
+    const monthly = new Map();
+    for (const [provider, all] of byProvider) {
+        const sorted = currentCycle(all.sort((a, b) => a.t - b.t));
+        if (sorted.length === 0)
+            continue;
+        const latest = sorted[sorted.length - 1];
+        if (latest.usedPct >= 100) {
+            const first = sorted.find((p) => p.usedPct >= 100);
+            if (first)
+                weekly.set(provider, new Date(first.t).toISOString());
+        }
+        const latestMonthlyExhausted = latest.monthlyStatus === "exhausted" ||
+            (typeof latest.monthlyPct === "number" && latest.monthlyPct >= 100);
+        if (latestMonthlyExhausted) {
+            const firstMonthly = sorted.find((p) => p.monthlyStatus === "exhausted" ||
+                (typeof p.monthlyPct === "number" && p.monthlyPct >= 100));
+            if (firstMonthly)
+                monthly.set(provider, new Date(firstMonthly.t).toISOString());
+        }
+    }
+    return { weekly, monthly };
+}
 export function getHistoryBaseline(db, limit = 4) {
     let rows = [];
     try {

package/dist/version.js

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

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

@@ -11,6 +11,7 @@ export interface BurnGeometry {
     projYPct: number;
     exhaustsBeforeReset: boolean;
     tone: BurnTone;
+    exhaustedElapsedPct: number | null;
 }
 /**
  * Burn-down geometry in quota-window data space (x = elapsed %, y = used %).

package/dist/web/src/components/BurnDown.js

@@ -52,38 +52,60 @@ export function burnGeometry(provider, asOfMs) {
     const { usedPct, elapsedPct } = barGeometry(provider, asOfMs);
     if (elapsedPct === null || !Number.isFinite(elapsedPct))
         return null;
+    let exhaustedElapsedPct = null;
+    const isExhausted = usedPct >= 100 ||
+        (monthly && advisory.bindingRemaining <= 0) ||
+        advisory.remaining <= 0;
+    if (isExhausted) {
+        if (advisory.exhaustedAt) {
+            const exMs = Date.parse(advisory.exhaustedAt);
+            const startIso = monthly ? provider.quota.periodStart : quotaWindowStartIso(provider);
+            const resetIso = monthly ? provider.quota.monthlyResetsAt : quotaResetsAt(provider);
+            const startMs = startIso ? Date.parse(startIso) : NaN;
+            const resetMs = resetIso ? Date.parse(resetIso) : NaN;
+            if (Number.isFinite(exMs) &&
+                Number.isFinite(startMs) &&
+                Number.isFinite(resetMs) &&
+                resetMs > startMs) {
+                exhaustedElapsedPct = Math.min(elapsedPct, Math.max(0, ((exMs - startMs) / (resetMs - startMs)) * 100));
+            }
+        }
+        if (exhaustedElapsedPct === null) {
+            exhaustedElapsedPct = elapsedPct;
+        }
+    }
     let projXPct;
     let projYPct;
     let exhaustsBeforeReset = false;
-    if (daysToExhaust !== null &&
+    if (isExhausted) {
+        exhaustsBeforeReset = true;
+        projYPct = 100;
+        projXPct = 100;
+    }
+    else if (daysToExhaust !== null &&
         Number.isFinite(daysToExhaust) &&
         daysToExhaust < daysLeft) {
         exhaustsBeforeReset = true;
         projYPct = 100;
-        if (usedPct >= 100) {
-            projXPct = elapsedPct;
+        const startIso = quotaWindowStartIso(provider);
+        const resetIso = quotaResetsAt(provider);
+        const startMs = startIso ? Date.parse(startIso) : NaN;
+        const resetMs = resetIso ? Date.parse(resetIso) : NaN;
+        if (Number.isFinite(startMs) &&
+            Number.isFinite(resetMs) &&
+            resetMs > startMs &&
+            Number.isFinite(asOfMs)) {
+            const totalDays = (resetMs - startMs) / 86_400_000;
+            const elapsedDays = (asOfMs - startMs) / 86_400_000;
+            projXPct = ((elapsedDays + daysToExhaust) / totalDays) * 100;
+        }
+        else if (elapsedPct < 100 && daysLeft > 0) {
+            projXPct = elapsedPct + (daysToExhaust * (100 - elapsedPct)) / daysLeft;
         }
         else {
-            const startIso = quotaWindowStartIso(provider);
-            const resetIso = quotaResetsAt(provider);
-            const startMs = startIso ? Date.parse(startIso) : NaN;
-            const resetMs = resetIso ? Date.parse(resetIso) : NaN;
-            if (Number.isFinite(startMs) &&
-                Number.isFinite(resetMs) &&
-                resetMs > startMs &&
-                Number.isFinite(asOfMs)) {
-                const totalDays = (resetMs - startMs) / 86_400_000;
-                const elapsedDays = (asOfMs - startMs) / 86_400_000;
-                projXPct = ((elapsedDays + daysToExhaust) / totalDays) * 100;
-            }
-            else if (elapsedPct < 100 && daysLeft > 0) {
-                projXPct = elapsedPct + (daysToExhaust * (100 - elapsedPct)) / daysLeft;
-            }
-            else {
-                projXPct = 100;
-            }
-            projXPct = Math.min(100, Math.max(elapsedPct, projXPct));
+            projXPct = 100;
         }
+        projXPct = Math.min(100, Math.max(elapsedPct, projXPct));
     }
     else {
         projXPct = 100;
@@ -99,12 +121,17 @@ export function burnGeometry(provider, asOfMs) {
         projYPct,
         exhaustsBeforeReset,
         tone: burnTone(provider),
+        exhaustedElapsedPct,
     };
 }
 export function burnAriaLabel(provider, geo) {
     const used = Math.round(geo.usedPct);
     const elapsed = Math.round(geo.elapsedPct);
     const window = `${quotaWindowName(provider).toLowerCase()} quota window`;
+    if (geo.exhaustedElapsedPct !== null && geo.usedPct >= 100) {
+        const exElapsed = Math.round(geo.exhaustedElapsedPct);
+        return `Burn-down: 100 percent used at ${exElapsed} percent elapsed, currently ${elapsed} percent elapsed (${window})`;
+    }
     if (geo.exhaustsBeforeReset) {
         return `Burn-down: ${used} percent used at ${elapsed} percent elapsed, forecast exhausts the quota before reset (${window})`;
     }
@@ -126,10 +153,17 @@ function fallbackBasis(provider, asOfMs) {
         return PACE_TIPS.recent;
     const startIso = quotaWindowStartIso(provider);
     const start = startIso ? Date.parse(startIso) : NaN;
-    if (Number.isFinite(start) && Number.isFinite(asOfMs) && asOfMs > start) {
-        const days = (asOfMs - start) / 86_400_000;
-        if (days >= 0.1)
+    const isExhausted = (provider.quota && provider.quota.weeklyPct >= 100) ||
+        (advisory.bindingRemaining <= 0);
+    const endMs = isExhausted && advisory.exhaustedAt ? Date.parse(advisory.exhaustedAt) : asOfMs;
+    if (Number.isFinite(start) && Number.isFinite(endMs) && endMs > start) {
+        const days = (endMs - start) / 86_400_000;
+        if (days >= 0.1) {
+            if (isExhausted && advisory.exhaustedAt) {
+                return `averaged over ${days.toFixed(1)} days to reach 100%`;
+            }
             return `averaged over ${days.toFixed(1)} days of this window`;
+        }
     }
     if (provider.evidence.includes("measured") || advisory.burnMeasured)
         return "Measured";
@@ -167,9 +201,13 @@ export function BurnDown({ provider, asOf, basis, }) {
     const tone = geo.tone;
     const nowX = sx(geo.elapsedPct);
     const nowY = sy(geo.usedPct);
+    const isExhausted = geo.exhaustedElapsedPct !== null && geo.usedPct >= 100;
+    const exhaustX = isExhausted ? sx(geo.exhaustedElapsedPct) : nowX;
+    const dotX = isExhausted ? exhaustX : nowX;
+    const dotY = isExhausted ? PLOT.top : nowY;
     const projX = sx(geo.projXPct);
     const projY = sy(geo.projYPct);
-    const showProjDot = Math.hypot(projX - nowX, projY - nowY) >= 3;
+    const showProjDot = !isExhausted && Math.hypot(projX - nowX, projY - nowY) >= 3;
     const label = burnAriaLabel(provider, geo);
     const windowName = quotaWindowName(provider);
     const elapsedLabel = `${Math.round(geo.elapsedPct)}% elapsed`;
@@ -179,5 +217,5 @@ export function BurnDown({ provider, asOf, basis, }) {
     const idealPct = geo.elapsedPct > 52 ? 35 : 66;
     const idealX = sx(idealPct);
     const idealY = sy(idealPct) - 5;
-    return (_jsxs("section", { className: "dsec", "aria-label": "Pace", "data-testid": "burn-down-section", children: [_jsxs("div", { className: "burn-head", children: [_jsx("h3", { children: "Pace" }), _jsxs("span", { className: "burn-win", children: [windowName, " quota window"] })] }), _jsxs("svg", { className: "burn", viewBox: "0 0 400 184", role: "img", "aria-label": label, "data-testid": "burn-down", children: [_jsx("text", { x: 11, y: PLOT_MID_Y, className: "axis-y", transform: `rotate(-90 11 ${PLOT_MID_Y})`, children: "Quota used (%)" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.bottom, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT_MID_Y, x2: PLOT.right, y2: PLOT_MID_Y, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT.top, x2: PLOT.right, y2: PLOT.top, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.left, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("line", { x1: PLOT_MID_X, y1: PLOT.bottom, x2: PLOT_MID_X, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("line", { x1: PLOT.right, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("text", { x: 40, y: PLOT.bottom + 3.5, className: "ylab", children: "0%" }), _jsx("text", { x: 40, y: PLOT_MID_Y + 3.5, className: "ylab", children: "50%" }), _jsx("text", { x: 40, y: PLOT.top + 3.5, className: "ylab", children: "100%" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.top, className: "ideal" }), _jsx("text", { x: n(idealX), y: n(idealY), className: "ideal-lab", textAnchor: "middle", transform: `rotate(-18.5 ${n(idealX)} ${n(idealY)})`, children: "ideal pace" }), _jsx("line", { x1: n(nowX), y1: PLOT.top - 8, x2: n(nowX), y2: PLOT.bottom, className: "now" }), _jsxs("text", { x: n(nowTextX), y: 12, className: "now-lab", textAnchor: "middle", children: ["now \u00B7 ", elapsedLabel] }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: n(nowX), y2: n(nowY), className: `actual ${tone}`, "data-testid": "burn-actual" }), _jsx("line", { x1: n(nowX), y1: n(nowY), x2: n(projX), y2: n(projY), className: `proj ${tone}`, "data-testid": "burn-proj", "data-proj-x": n(geo.projXPct), "data-proj-y": n(geo.projYPct) }), _jsx("circle", { cx: n(nowX), cy: n(nowY), r: 4.5, className: `dot ${tone}` }), showProjDot && (_jsx("circle", { cx: n(projX), cy: n(projY), r: 3.5, className: `dot ${tone} hollow` })), _jsx("text", { x: PLOT.left, y: 160, className: "xlab", children: "start \u00B7 0%" }), _jsx("text", { x: PLOT_MID_X, y: 160, className: "xlab mid", children: "50%" }), _jsx("text", { x: PLOT.right, y: 160, className: "xlab end", children: "quota reset \u00B7 100%" }), _jsx("text", { x: PLOT_MID_X, y: 178, className: "axis-x", children: "Time elapsed in window (%)" })] }), _jsxs("p", { className: "burn-legend", children: [_jsx("span", { className: "legend-label", children: "Legend" }), _jsxs("span", { className: "legend-item", children: [_jsx("span", { className: `burn-swatch-dot ${tone}`, "aria-hidden": "true" }), "Dot is now"] }), _jsxs("span", { className: "legend-item", children: [_jsx("span", { className: `burn-swatch-proj ${tone}`, "aria-hidden": "true" }), "Dashed is forecast"] })] }), _jsx(PaceStats, { provider: provider, asOf: asOf }), _jsx("p", { className: "pacecap", children: _jsx("span", { className: "basis", children: basisLine }) })] }));
+    return (_jsxs("section", { className: "dsec", "aria-label": "Pace", "data-testid": "burn-down-section", children: [_jsxs("div", { className: "burn-head", children: [_jsx("h3", { children: "Pace" }), _jsxs("span", { className: "burn-win", children: [windowName, " quota window"] })] }), _jsxs("svg", { className: "burn", viewBox: "0 0 400 184", role: "img", "aria-label": label, "data-testid": "burn-down", children: [_jsx("text", { x: 11, y: PLOT_MID_Y, className: "axis-y", transform: `rotate(-90 11 ${PLOT_MID_Y})`, children: "Quota used (%)" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.bottom, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT_MID_Y, x2: PLOT.right, y2: PLOT_MID_Y, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT.top, x2: PLOT.right, y2: PLOT.top, className: "grid" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.left, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("line", { x1: PLOT_MID_X, y1: PLOT.bottom, x2: PLOT_MID_X, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("line", { x1: PLOT.right, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.bottom + 4, className: "grid-tick" }), _jsx("text", { x: 40, y: PLOT.bottom + 3.5, className: "ylab", children: "0%" }), _jsx("text", { x: 40, y: PLOT_MID_Y + 3.5, className: "ylab", children: "50%" }), _jsx("text", { x: 40, y: PLOT.top + 3.5, className: "ylab", children: "100%" }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: PLOT.right, y2: PLOT.top, className: "ideal" }), _jsx("text", { x: n(idealX), y: n(idealY), className: "ideal-lab", textAnchor: "middle", transform: `rotate(-18.5 ${n(idealX)} ${n(idealY)})`, children: "ideal pace" }), _jsx("line", { x1: n(nowX), y1: PLOT.top - 8, x2: n(nowX), y2: PLOT.bottom, className: "now" }), _jsxs("text", { x: n(nowTextX), y: 12, className: "now-lab", textAnchor: "middle", children: ["now \u00B7 ", elapsedLabel] }), _jsx("line", { x1: PLOT.left, y1: PLOT.bottom, x2: n(isExhausted ? exhaustX : nowX), y2: n(isExhausted ? PLOT.top : nowY), className: `actual ${tone}`, "data-testid": "burn-actual" }), isExhausted && nowX > exhaustX && (_jsx("line", { x1: n(exhaustX), y1: PLOT.top, x2: n(nowX), y2: PLOT.top, className: `actual ${tone}`, "data-testid": "burn-exhausted-plateau" })), _jsx("line", { x1: n(nowX), y1: n(isExhausted ? PLOT.top : nowY), x2: n(projX), y2: n(projY), className: `proj ${tone}`, "data-testid": "burn-proj", "data-proj-x": n(geo.projXPct), "data-proj-y": n(geo.projYPct) }), _jsx("circle", { cx: n(dotX), cy: n(dotY), r: 4.5, className: `dot ${tone}`, "data-testid": "burn-dot" }), showProjDot && (_jsx("circle", { cx: n(projX), cy: n(projY), r: 3.5, className: `dot ${tone} hollow` })), _jsx("text", { x: PLOT.left, y: 160, className: "xlab", children: "start \u00B7 0%" }), _jsx("text", { x: PLOT_MID_X, y: 160, className: "xlab mid", children: "50%" }), _jsx("text", { x: PLOT.right, y: 160, className: "xlab end", children: "quota reset \u00B7 100%" }), _jsx("text", { x: PLOT_MID_X, y: 178, className: "axis-x", children: "Time elapsed in window (%)" })] }), _jsxs("p", { className: "burn-legend", children: [_jsx("span", { className: "legend-label", children: "Legend" }), _jsxs("span", { className: "legend-item", children: [_jsx("span", { className: `burn-swatch-dot ${tone}`, "aria-hidden": "true" }), isExhausted ? "Dot is quota exhausted" : "Dot is now"] }), _jsxs("span", { className: "legend-item", children: [_jsx("span", { className: `burn-swatch-proj ${tone}`, "aria-hidden": "true" }), "Dashed is forecast"] })] }), _jsx(PaceStats, { provider: provider, asOf: asOf }), _jsx("p", { className: "pacecap", children: _jsx("span", { className: "basis", children: basisLine }) })] }));
 }

package/dist/web/src/components/PaceBar.js

@@ -140,7 +140,11 @@ export function quotaAvgPace(provider, asOfMs) {
     const startMs = Date.parse(startIso);
     if (!Number.isFinite(startMs) || !Number.isFinite(asOfMs))
         return null;
-    const elapsedDays = (asOfMs - startMs) / 86_400_000;
+    const isExhausted = provider.advisory.bindingRemaining <= 0 || used >= 100;
+    const endMs = isExhausted && provider.advisory.exhaustedAt
+        ? Date.parse(provider.advisory.exhaustedAt)
+        : asOfMs;
+    const elapsedDays = (endMs - startMs) / 86_400_000;
     if (elapsedDays < 0.25)
         return null;
     const pace = used / elapsedDays;

package/dist/web/src/components/ProviderDrawer.js

@@ -116,10 +116,17 @@ export function paceBasis(provider, asOfMs) {
         return "No current reading";
     const startIso = quotaWindowStartIso(provider);
     const start = startIso ? Date.parse(startIso) : NaN;
-    if (Number.isFinite(start) && Number.isFinite(asOfMs) && asOfMs > start) {
-        const days = (asOfMs - start) / 86_400_000;
-        if (days >= 0.1)
+    const isExhausted = (provider.quota && provider.quota.weeklyPct >= 100) ||
+        (advisory.bindingRemaining <= 0);
+    const endMs = isExhausted && advisory.exhaustedAt ? Date.parse(advisory.exhaustedAt) : asOfMs;
+    if (Number.isFinite(start) && Number.isFinite(endMs) && endMs > start) {
+        const days = (endMs - start) / 86_400_000;
+        if (days >= 0.1) {
+            if (isExhausted && advisory.exhaustedAt) {
+                return `averaged over ${days.toFixed(1)} days to reach 100%`;
+            }
             return `averaged over ${days.toFixed(1)} days of this window`;
+        }
     }
     if (provider.evidence.includes("measured") || advisory.burnMeasured)
         return "Measured";
@@ -312,9 +319,11 @@ export function verdictFor(provider, asOfMs) {
         return { tone: "use-more", label: "↑ Use more", detail };
     }
     if (lane === "ease-off" || advisory.status === "at risk" || advisory.status === "watch") {
-        const detail = advisory.daysToExhaust !== null && Number.isFinite(advisory.daysToExhaust)
-            ? `exhausts in ${daysToDuration(advisory.daysToExhaust)} at current pace`
-            : paceBadge(provider);
+        const detail = advisory.remaining <= 0 || paceBadge(provider) === "Quota exhausted"
+            ? "quota fully used"
+            : advisory.daysToExhaust !== null && Number.isFinite(advisory.daysToExhaust)
+                ? `exhausts in ${daysToDuration(advisory.daysToExhaust)} at current pace`
+                : paceBadge(provider);
         return { tone: "ease-off", label: "↓ Ease off", detail };
     }
     return { tone: "neutral", label: "• On track", detail: forecastLine(provider) };

package/dist/web/src/components/settings/DaemonPanel.js

@@ -14,5 +14,5 @@ function servingPort() {
  */
 export function DaemonPanel() {
     const port = servingPort();
-    return (_jsxs("div", { children: [_jsx("h3", { className: "settings-h3", children: "Local Daemon Process" }), _jsx("p", { className: "settings-desc", children: "Background process managing provider adapters and SQLite store." }), _jsxs("dl", { className: "dkv", children: [_jsx("dt", { children: "HTTP Service" }), _jsx("dd", { children: _jsxs("code", { children: ["127.0.0.1:", port ?? "8787"] }) }), _jsx("dt", { children: "Polling Cadence" }), _jsx("dd", { children: "Every 15 minutes (default)" }), _jsx("dt", { children: "Database File" }), _jsx("dd", { children: _jsx("code", { children: "~/.quotacap/quotacap.db" }) })] }), _jsxs("p", { className: "settings-note", children: ["Change the port and polling cadence in ", _jsx("code", { children: "~/.quotacap/config.json" }), " (", _jsx("code", { children: "port" }), ",", " ", _jsx("code", { children: "pollMinutes" }), "; defaults 8787 and 15), then restart the daemon. These controls stay read-only until the server offers a settings API."] })] }));
+    return (_jsxs("div", { children: [_jsx("h3", { className: "settings-h3", children: "Local Daemon Process" }), _jsx("p", { className: "settings-desc", children: "Background process managing provider adapters and SQLite store." }), _jsxs("dl", { className: "dkv", children: [_jsx("dt", { children: "HTTP Service" }), _jsx("dd", { children: _jsxs("code", { children: ["127.0.0.1:", port ?? "8787"] }) }), _jsx("dt", { children: "Polling Cadence" }), _jsx("dd", { children: "Every 15 minutes (default)" }), _jsx("dt", { children: "Database File" }), _jsx("dd", { children: _jsx("code", { children: "~/.quotacap/quotacap.db" }) })] }), _jsxs("p", { className: "settings-note", children: ["Change the port and polling cadence in ", _jsx("code", { children: "~/.quotacap/config.json" }), " (", _jsx("code", { children: "port" }), ",", " ", _jsx("code", { children: "pollMinutes" }), "; defaults 8787 and 10), then restart the daemon. These controls stay read-only until the server offers a settings API."] })] }));
 }

package/dist/web/src/state.d.ts

@@ -26,6 +26,7 @@ export interface AdvisoryView {
     bindingWindow: "weekly" | "monthly";
     bindingRemaining: number;
     bindingDaysLeft: number;
+    exhaustedAt?: string | null;
 }
 export interface RecommendationView {
     use: string;

package/dist/web/src/state.js

@@ -96,7 +96,7 @@ export function ageLabel(asOf, nowMs = Date.now()) {
     return `read ${Math.floor(hours / 24)}d ago`;
 }
 /** Default poll interval; matches `pollMinutes` in `src/config.ts`. */
-export const DEFAULT_POLL_INTERVAL_MS = 15 * 60 * 1000;
+export const DEFAULT_POLL_INTERVAL_MS = 10 * 60 * 1000;
 /** Health-strip copy for the next scheduled poll. */
 export function nextRefreshLabel(lastCompletedPollAt, polling, nowMs = Date.now(), intervalMs = DEFAULT_POLL_INTERVAL_MS) {
     if (polling === "in-progress")