quotacap 0.0.34 → 0.0.35

package/dist/store/quotas.js

@@ -26,6 +26,21 @@ function mapRow(row) {
         delete out.sessionPct;
     return out;
 }
+function cycleBreakReason(prev, cur) {
+    const dropped = cur.usedPct < prev.usedPct;
+    const prevResets = prev.resetsAt ? new Date(prev.resetsAt).getTime() : NaN;
+    const boundaryRolled = !Number.isNaN(prevResets) && prevResets <= cur.t && prev.resetsAt !== cur.resetsAt;
+    if (dropped && boundaryRolled)
+        return "both";
+    if (dropped)
+        return "usage-drop";
+    if (boundaryRolled)
+        return "resets-at-rolled";
+    return null;
+}
+export function isWeeklyCycleBreak(prev, cur) {
+    return cycleBreakReason(prev, cur) !== null;
+}
 export function upsertQuota(db, q) {
     if (Array.isArray(q)) {
         for (const item of q)
@@ -35,9 +50,52 @@ export function upsertQuota(db, q) {
     const credits = q.creditsUsd ?? q.credits_usd ?? null;
     const estimated = q.resetsAtEstimated ? 1 : null;
     const sessionPct = q.sessionPct ?? q.session_pct ?? null;
-    db.prepare(`INSERT INTO quotas(provider, plan, used_pct, resets_at, period_start, source, fetched_at, credits_usd, resets_at_estimated, session_pct) VALUES(?,?,?,?,?,?,?,?,?,?)`).run(q.provider, q.plan, q.usedPct, q.resetsAt, q.periodStart, q.source, q.fetchedAt, credits, estimated, sessionPct);
-    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, q.usedPct);
+    db.exec("BEGIN");
+    try {
+        const prev = getLatestByProvider(db, q.provider);
+        if (prev) {
+            const reason = cycleBreakReason({ usedPct: prev.usedPct, t: Date.parse(prev.fetchedAt), resetsAt: prev.resetsAt ?? null }, { usedPct: q.usedPct, t: Date.parse(q.fetchedAt), resetsAt: q.resetsAt ?? null });
+            if (reason) {
+                db.prepare(`INSERT OR IGNORE INTO window_closes(provider, plan, used_pct, leftover_pct, sampled_at, sampled_quota_id, period_start, resets_at, resets_at_estimated, detected_at, reason) VALUES(?,?,?,?,?,?,?,?,?,?,?)`)
+                    .run(prev.provider, prev.plan ?? null, prev.usedPct, Math.max(0, 100 - prev.usedPct), 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) VALUES(?,?,?,?,?,?,?,?,?,?)`).run(q.provider, q.plan, q.usedPct, q.resetsAt, q.periodStart, q.source, q.fetchedAt, credits, estimated, sessionPct);
+        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, q.usedPct);
+        db.exec("COMMIT");
+    }
+    catch (e) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch { }
+        throw e;
+    }
+}
+export function getWindowCloses(db, provider, limit = 4) {
+    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);
+    }
+    catch (e) {
+        // A pre-observability database read offline is never migrated, so the
+        // table can be absent. No table means no recorded closes.
+        if (!/no such table/i.test(String(e?.message ?? "")))
+            throw e;
+    }
+    return rows.map((r) => ({
+        provider: r.provider,
+        plan: r.plan ?? null,
+        usedPct: r.used_pct,
+        leftoverPct: r.leftover_pct,
+        sampledAt: r.sampled_at,
+        periodStart: r.period_start ?? null,
+        resetsAt: r.resets_at ?? null,
+        resetsAtEstimated: !!r.resets_at_estimated,
+        detectedAt: r.detected_at,
+        reason: r.reason,
+    }));
 }
 export function getLatestByProvider(db, provider) {
     const row = db.prepare(`SELECT * FROM quotas WHERE provider=? ORDER BY fetched_at DESC LIMIT 1`).get(provider);
@@ -60,11 +118,7 @@ export function getSnapshots(db) { return db.prepare(`SELECT * FROM snapshots OR
 function currentCycle(sorted) {
     let start = 0;
     for (let i = 1; i < sorted.length; i++) {
-        const prev = sorted[i - 1];
-        const cur = sorted[i];
-        const prevResets = prev.resetsAt ? new Date(prev.resetsAt).getTime() : NaN;
-        const boundaryRolled = !Number.isNaN(prevResets) && prevResets <= cur.t && prev.resetsAt !== cur.resetsAt;
-        if (boundaryRolled || cur.usedPct < prev.usedPct)
+        if (isWeeklyCycleBreak(sorted[i - 1], sorted[i]))
             start = i;
     }
     return start === 0 ? sorted : sorted.slice(start);
@@ -97,3 +151,34 @@ export function getBurnRates(db, now = Date.now()) {
     }
     return out;
 }
+export function getHistoryBaseline(db, limit = 4) {
+    let rows = [];
+    try {
+        rows = db.prepare(`SELECT provider, used_pct, resets_at_estimated FROM window_closes ORDER BY detected_at DESC, id DESC`).all();
+    }
+    catch (e) {
+        // A pre-observability database read offline is never migrated, so the
+        // table can be absent. No table means no recorded closes.
+        if (!/no such table/i.test(String(e?.message ?? "")))
+            throw e;
+    }
+    const byProvider = new Map();
+    for (const r of rows) {
+        const closes = byProvider.get(r.provider) ?? [];
+        closes.push({ usedPct: r.used_pct, verified: !r.resets_at_estimated });
+        byProvider.set(r.provider, closes);
+    }
+    const out = new Map();
+    for (const [provider, newestFirst] of byProvider) {
+        const pool = newestFirst.slice(0, limit);
+        if (!pool.length)
+            continue;
+        const verified = pool.filter((c) => c.verified);
+        const chosen = verified.length ? verified : pool;
+        const mean = chosen.reduce((sum, c) => sum + c.usedPct, 0) / chosen.length;
+        const rate = mean / 7;
+        if (Number.isFinite(rate))
+            out.set(provider, rate);
+    }
+    return out;
+}

package/dist/version.js

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

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

@@ -0,0 +1,16 @@
+import React from "react";
+import type { WindowCloseView } from "../state.js";
+export declare function lastClose(provider: {
+    lastCloses?: WindowCloseView[];
+}): WindowCloseView | null;
+export declare function closeDateLabel(resetsAt: string | null): string | null;
+export declare function closeIsStale(c: WindowCloseView): boolean;
+export declare function closeSampleStamp(sampledAt: string): string | null;
+export declare function closeResetStamp(resetsAt: string): string | null;
+/** Four-cell strip of closed weekly windows, oldest left. Fill is used at
+ * close, the hatch is the stored leftover. One cell per real close, never a
+ * placeholder. Stale samples name their reading on the cell and under the
+ * strip. */
+export declare function ClosedWeeks({ closes }: {
+    closes: WindowCloseView[];
+}): React.JSX.Element | null;

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

@@ -0,0 +1,102 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { format } from "date-fns";
+const STALE_EARLY_MS = 15 * 60 * 1000;
+export function lastClose(provider) {
+    const closes = provider.lastCloses;
+    return Array.isArray(closes) && closes.length > 0 ? closes[0] : null;
+}
+export function closeDateLabel(resetsAt) {
+    if (!resetsAt)
+        return null;
+    const ms = Date.parse(resetsAt);
+    if (!Number.isFinite(ms))
+        return null;
+    return format(new Date(ms), "d MMM");
+}
+export function closeIsStale(c) {
+    if (!c.resetsAt)
+        return true;
+    const resetMs = Date.parse(c.resetsAt);
+    const sampledMs = Date.parse(c.sampledAt);
+    if (!Number.isFinite(resetMs) || !Number.isFinite(sampledMs))
+        return true;
+    return resetMs - sampledMs > STALE_EARLY_MS;
+}
+export function closeSampleStamp(sampledAt) {
+    const ms = Date.parse(sampledAt);
+    if (!Number.isFinite(ms))
+        return null;
+    return format(new Date(ms), "EEE d MMM H:mm");
+}
+export function closeResetStamp(resetsAt) {
+    const ms = Date.parse(resetsAt);
+    if (!Number.isFinite(ms))
+        return null;
+    return format(new Date(ms), "d MMM HH:mm");
+}
+/** One floored duration for both the compact cell line and the strip note. */
+function earlyParts(ms) {
+    if (ms < 60_000)
+        return { n: Math.max(1, Math.floor(ms / 1000)), unit: "s" };
+    const minutes = Math.floor(ms / 60_000);
+    if (minutes < 60)
+        return { n: minutes, unit: "m" };
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return { n: hours, unit: "h" };
+    return { n: Math.floor(hours / 24), unit: "d" };
+}
+const EARLY_UNIT_WORDS = {
+    s: "second",
+    m: "minute",
+    h: "hour",
+    d: "day",
+};
+function earlyCompact(ms) {
+    const { n, unit } = earlyParts(ms);
+    return `${n}${unit}`;
+}
+function earlyWords(ms) {
+    const { n, unit } = earlyParts(ms);
+    return `${n} ${EARLY_UNIT_WORDS[unit]}${n === 1 ? "" : "s"}`;
+}
+/** Four-cell strip of closed weekly windows, oldest left. Fill is used at
+ * close, the hatch is the stored leftover. One cell per real close, never a
+ * placeholder. Stale samples name their reading on the cell and under the
+ * strip. */
+export function ClosedWeeks({ closes }) {
+    if (!Array.isArray(closes) || closes.length === 0)
+        return null;
+    const cells = [...closes].reverse();
+    const labels = cells.map((c) => closeDateLabel(c.resetsAt));
+    return (_jsxs("section", { className: "dsec", "aria-label": "Closed weeks", children: [_jsx("h3", { children: "Closed weeks" }), _jsx("div", { className: "weeks", "data-testid": "closed-weeks", children: cells.map((c, i) => {
+                    const used = Math.min(100, Math.max(0, c.usedPct));
+                    const leftover = Math.min(100, Math.max(0, c.leftoverPct));
+                    const stale = closeIsStale(c);
+                    const sampled = closeSampleStamp(c.sampledAt);
+                    const reset = c.resetsAt ? closeResetStamp(c.resetsAt) : null;
+                    const earlyMs = c.resetsAt ? Date.parse(c.resetsAt) - Date.parse(c.sampledAt) : NaN;
+                    const est = c.resetsAtEstimated ? " (est.)" : "";
+                    const title = [
+                        `${c.usedPct}% used`,
+                        `${c.leftoverPct}% leftover`,
+                        reset ? `reset ${reset}${est}` : "reset unknown",
+                        stale && sampled ? `last reading ${sampled}` : null,
+                    ]
+                        .filter(Boolean)
+                        .join(", ");
+                    return (_jsxs("div", { className: "week", title: title, children: [_jsxs("div", { className: "track", role: "img", "aria-label": title, children: [_jsx("div", { className: "fill", style: { width: `${used}%` } }), leftover > 0 && (_jsx("div", { className: "band band-waste", style: { left: `${used}%`, width: `${leftover}%` } }))] }), _jsxs("div", { className: "lab", children: [_jsx("span", { children: labels[i] ?? "date unknown" }), _jsxs("b", { children: [c.leftoverPct, "% leftover", est] }), stale && Number.isFinite(earlyMs) && earlyMs > 0 && (_jsxs("span", { className: "stale-note", children: ["read ", earlyCompact(earlyMs), " early"] }))] })] }, `${c.detectedAt}-${c.sampledAt}`));
+                }) }), cells.map((c, i) => {
+                const resetMs = c.resetsAt ? Date.parse(c.resetsAt) : NaN;
+                const sampledMs = Date.parse(c.sampledAt);
+                const sampled = closeSampleStamp(c.sampledAt);
+                if (!closeIsStale(c) ||
+                    !sampled ||
+                    !Number.isFinite(resetMs) ||
+                    !Number.isFinite(sampledMs) ||
+                    resetMs <= sampledMs) {
+                    return null;
+                }
+                return (_jsxs("p", { className: "cell-s stale-note", children: [labels[i] ?? "Date unknown", " leftover is from the ", sampled, " reading, ", earlyWords(resetMs - sampledMs), " ", "before that reset."] }, `note-${c.detectedAt}-${c.sampledAt}`));
+            })] }));
+}

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

@@ -1,9 +1,11 @@
 import React from "react";
 import type { ExclusionReason, ProviderView } from "../state.js";
-export type PaceBadge = "Not reporting" | "Cap risk" | "Behind pace" | "Ahead of pace" | "On track" | "Measuring";
+export type PaceBadge = "Not reporting" | "Cap risk" | "Watch" | "Behind pace" | "Ahead of pace" | "On track" | "Measuring";
 /**
  * Pace-state badge from the mapping table. Exclusion always wins; otherwise
- * status "at risk" wins; otherwise urgency decides. No client thresholds.
+ * status "at risk" wins, then "watch", then "unknown"; on-track rows ahead of
+ * cumulative elapsed time read Ahead of pace; otherwise urgency decides. No
+ * client thresholds.
  */
 export declare function paceBadge(provider: ProviderView): PaceBadge;
 export interface PaceFigures {
@@ -12,11 +14,14 @@ export interface PaceFigures {
     /** Recent burn: last-24h rolling rate. Null unless paceSource is "recent". */
     recent: number | null;
 }
-/** Split the advisory into its two displayed paces. `burnRate` doubles as the
- * forecast input, so the recent figure only exists when it was measured. */
+/** Split the advisory into its two displayed paces. The 24h figure is the
+ * measured `recentRate`, not the blended `burnRate` forecast input; an
+ * advisory from a daemon older than the blend falls back to `burnRate`,
+ * which was the raw measured rate then. */
 export declare function paceFigures(advisory: {
     avgPace?: number | null;
     burnRate: number | null;
+    recentRate?: number | null;
     paceSource: string;
 } | null | undefined): PaceFigures;
 export interface PaceCells {
@@ -29,6 +34,7 @@ export interface PaceCells {
 export declare function paceCells(advisory: {
     avgPace?: number | null;
     burnRate: number | null;
+    recentRate?: number | null;
     paceSource: string;
 } | null | undefined): PaceCells;
 /** Hover explanations shared by cards and rows. Plain words, no jargon. */
@@ -48,6 +54,7 @@ export interface PaceLine {
 export declare function paceLines(advisory: {
     avgPace?: number | null;
     burnRate: number | null;
+    recentRate?: number | null;
     paceSource: string;
     idealRate: number;
 } | null | undefined): PaceLine[];
@@ -89,12 +96,17 @@ export declare function barGeometry(provider: ProviderView, asOfMs: number): Bar
 export declare function badgeColor(badge: PaceBadge): string;
 export declare function fillToken(badge: PaceBadge): string;
 export declare function edgeToken(badge: PaceBadge): string;
-export declare function outKind(badge: PaceBadge): "behind" | "cap" | "ontrack" | "none";
+export declare function outKind(badge: PaceBadge): "behind" | "watch" | "cap" | "ontrack" | "none";
 /**
  * Hatch fill for unused quota. Ink mix (not an alpha suffix on a custom
  * property) so the browser always paints a gradient.
  */
 export declare function hatchGradient(_badge?: PaceBadge): string;
+/**
+ * Badge hover copy: red and amber explain the verdict; an estimated reset is
+ * confessed on the end. Other badges read their own label and need no title.
+ */
+export declare function badgeTitle(badge: PaceBadge, estimated: boolean): string | undefined;
 export declare function Badge({ provider }: {
     provider: ProviderView;
 }): React.JSX.Element;

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

@@ -2,7 +2,9 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { ageDuration } from "../state.js";
 /**
  * Pace-state badge from the mapping table. Exclusion always wins; otherwise
- * status "at risk" wins; otherwise urgency decides. No client thresholds.
+ * status "at risk" wins, then "watch", then "unknown"; on-track rows ahead of
+ * cumulative elapsed time read Ahead of pace; otherwise urgency decides. No
+ * client thresholds.
  */
 export function paceBadge(provider) {
     if (provider.exclusionReason !== null)
@@ -12,8 +14,12 @@ export function paceBadge(provider) {
         return "Not reporting";
     if (advisory.status === "at risk")
         return "Cap risk";
+    if (advisory.status === "watch")
+        return "Watch";
     if (advisory.status === "unknown")
         return "Measuring";
+    if (advisory.aheadOfElapsed === true)
+        return "Ahead of pace";
     switch (advisory.urgency) {
         case "burn now":
         case "use soon":
@@ -25,13 +31,19 @@ export function paceBadge(provider) {
             return "On track";
     }
 }
-/** Split the advisory into its two displayed paces. `burnRate` doubles as the
- * forecast input, so the recent figure only exists when it was measured. */
+/** Split the advisory into its two displayed paces. The 24h figure is the
+ * measured `recentRate`, not the blended `burnRate` forecast input; an
+ * advisory from a daemon older than the blend falls back to `burnRate`,
+ * which was the raw measured rate then. */
 export function paceFigures(advisory) {
     if (!advisory)
         return { avg: null, recent: null };
     const avg = advisory.avgPace ?? null;
-    const recent = advisory.paceSource === "recent" ? advisory.burnRate : null;
+    const recent = advisory.recentRate !== undefined
+        ? advisory.recentRate
+        : advisory.paceSource === "recent"
+            ? advisory.burnRate
+            : null;
     return { avg, recent };
 }
 /** Card pace cells: average and 24h rate side by side, each "—" when unknown.
@@ -187,6 +199,8 @@ export function badgeColor(badge) {
             return "var(--warn)";
         case "Ahead of pace":
             return "var(--ahead)";
+        case "Watch":
+            return "var(--watch)";
         case "Cap risk":
             return "var(--danger)";
         case "Measuring":
@@ -203,6 +217,8 @@ export function fillToken(badge) {
             return "var(--fill-behind)";
         case "Ahead of pace":
             return "var(--fill-ahead)";
+        case "Watch":
+            return "var(--fill-watch)";
         case "Cap risk":
             return "var(--fill-cap)";
         case "Measuring":
@@ -219,6 +235,8 @@ export function edgeToken(badge) {
             return "var(--edge-behind)";
         case "Ahead of pace":
             return "var(--edge-ahead)";
+        case "Watch":
+            return "var(--edge-watch)";
         case "Cap risk":
             return "var(--edge-cap)";
         case "Measuring":
@@ -231,6 +249,8 @@ export function outKind(badge) {
     switch (badge) {
         case "Behind pace":
             return "behind";
+        case "Watch":
+            return "watch";
         case "Cap risk":
             return "cap";
         case "On track":
@@ -246,6 +266,22 @@ export function outKind(badge) {
 export function hatchGradient(_badge) {
     return "repeating-linear-gradient(45deg, color-mix(in oklch, var(--ink) 20%, transparent) 0 1.5px, transparent 1.5px 7px)";
 }
+/**
+ * Badge hover copy: red and amber explain the verdict; an estimated reset is
+ * confessed on the end. Other badges read their own label and need no title.
+ */
+export function badgeTitle(badge, estimated) {
+    let title;
+    if (badge === "Cap risk") {
+        title = "Burning faster than the window allows and ahead of elapsed time";
+    }
+    else if (badge === "Watch") {
+        title = "Pace points at the cap, but position or the reset clock is uncertain";
+    }
+    if (title && estimated)
+        title += " (estimated reset)";
+    return title;
+}
 export function Badge({ provider }) {
     const badge = paceBadge(provider);
     const detail = exclusionDetail(provider.exclusionReason);
@@ -255,10 +291,12 @@ export function Badge({ provider }) {
             ? "pace-ontrack"
             : badge === "Ahead of pace"
                 ? "pace-ahead"
-                : badge === "Cap risk"
-                    ? "pace-cap"
-                    : "pace-out"; // Not reporting and Measuring share the neutral style
-    return (_jsxs("span", { "data-testid": "pace-badge", className: `pace ${badgeClass}`, children: [badge, detail ? ` · ${detail}` : ""] }));
+                : badge === "Watch"
+                    ? "pace-watch"
+                    : badge === "Cap risk"
+                        ? "pace-cap"
+                        : "pace-out"; // Not reporting and Measuring share the neutral style
+    return (_jsxs("span", { "data-testid": "pace-badge", className: `pace ${badgeClass}`, title: badgeTitle(badge, provider.quota?.resetsAtEstimated === true), children: [badge, detail ? ` · ${detail}` : ""] }));
 }
 /**
  * Two-tier pacing rail: used fill, elapsed tick, projected-unused hatch.
@@ -316,6 +354,11 @@ export function forecastLine(provider) {
             ? `Cap risk · exhausts in ${advisory.daysToExhaust.toFixed(1)}d at current pace`
             : "Cap risk at current pace";
     }
+    if (advisory.status === "watch") {
+        return advisory.daysToExhaust !== null && Number.isFinite(advisory.daysToExhaust)
+            ? `Watch · exhausts in ${advisory.daysToExhaust.toFixed(1)}d at current pace`
+            : "Watch at current pace";
+    }
     if (advisory.wastePct !== null) {
         return `${Math.round(advisory.wastePct)}% waste in ${advisory.daysLeft.toFixed(1)}d`;
     }

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

@@ -5,6 +5,7 @@ const STATES = [
     { label: "Behind pace", cls: "pace-behind", meaning: "Burning slow; risk of unused quota waste" },
     { label: "Ahead of pace", cls: "pace-ahead", meaning: "Burning faster than time; monitor usage" },
     { label: "Cap risk", cls: "pace-cap", meaning: "Will hit cap before reset window closes" },
+    { label: "Watch", cls: "pace-watch", meaning: "Pace points at the cap, but position or the reset clock is uncertain" },
     { label: "Measuring", cls: "pace-out", meaning: "Not enough data yet; pace appears after 6h" },
     { label: "Not reporting", cls: "pace-out", meaning: "No usable reading; excluded from ranking" },
 ];

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

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ageDuration, displayPlan } from "../state.js";
 import { Badge, PACE_TIPS, PaceBar, isEstimated, paceCells, resetClock, resetCountdown, timeLeft, } from "./PaceBar.js";
 import { ProviderIcon, providerTint } from "./ProviderIcon.js";
+import { lastClose } from "./ClosedWeeks.js";
 function resetsDate(provider) {
     if (!provider.quota)
         return null;
@@ -19,10 +20,11 @@ export function ProviderCard({ provider, recommended, asOf, onSelect, }) {
     const resetsIn = quota ? timeLeft(quota.resetsAt, asOfMs) : null;
     const name = provider.displayName;
     const plan = displayPlan(quota?.plan);
+    const last = lastClose(provider);
     return (_jsxs("article", { "data-testid": `provider-card-${provider.id}`, role: "button", tabIndex: 0, "aria-label": `${name} details`, onClick: () => onSelect(provider.id), onKeyDown: (e) => {
             if (e.key === "Enter" || e.key === " ") {
                 e.preventDefault();
                 onSelect(provider.id);
             }
-        }, className: `pcard ${recommended ? "is-recommended is-top-pick" : ""}`, children: [_jsxs("div", { className: "pcard-head", children: [_jsx("span", { className: "picon", style: providerTint(provider.id), "aria-hidden": "true", children: _jsx(ProviderIcon, { id: provider.id, title: name }) }), _jsxs("div", { className: "who", children: [_jsxs("b", { children: [name, recommended && (_jsx("span", { className: "rec-icon", title: "Recommended for next session", role: "img", "aria-label": "recommended", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.3", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3z" }) }) }))] }), plan && _jsx("span", { className: "pl", children: plan }), updated && _jsxs("span", { className: "src", children: ["Updated ", updated, " ago"] })] }), _jsx(Badge, { provider: provider })] }), _jsxs("div", { className: "pcard-body", children: [_jsx(PaceBar, { provider: provider, asOf: asOf }), _jsxs("div", { className: "pstats", children: [_jsxs("div", { title: PACE_TIPS.avg, children: [_jsx("span", { className: "l", children: "Avg pace" }), _jsx("span", { className: "v", children: pace.avg })] }), _jsxs("div", { title: PACE_TIPS.recent, children: [_jsx("span", { className: "l", children: "24h pace" }), _jsx("span", { className: "v", children: pace.recent })] }), _jsxs("div", { title: PACE_TIPS.ideal, children: [_jsx("span", { className: "l", children: "Ideal pace" }), _jsx("span", { className: "v", children: advisory ? `${advisory.idealRate.toFixed(1)}%/day` : "—" })] }), _jsxs("div", { children: [_jsx("span", { className: "l", children: "Resets in" }), _jsx("span", { className: "v", children: resetsIn ? `${resetsIn}${isEstimated(provider) ? " (est.)" : ""}` : resetCountdown(provider, asOfMs) })] })] })] }), _jsxs("div", { className: "pcard-foot", children: [_jsx("span", { children: resetsDate(provider) ?? resetCountdown(provider, asOfMs) }), _jsx("span", { className: "rowbtn", "aria-hidden": "true", children: "Inspect" })] })] }));
+        }, className: `pcard ${recommended ? "is-recommended is-top-pick" : ""}`, children: [_jsxs("div", { className: "pcard-head", children: [_jsx("span", { className: "picon", style: providerTint(provider.id), "aria-hidden": "true", children: _jsx(ProviderIcon, { id: provider.id, title: name }) }), _jsxs("div", { className: "who", children: [_jsxs("b", { children: [name, recommended && (_jsx("span", { className: "rec-icon", title: "Recommended for next session", role: "img", "aria-label": "recommended", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.3", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3z" }) }) }))] }), plan && _jsx("span", { className: "pl", children: plan }), updated && _jsxs("span", { className: "src", children: ["Updated ", updated, " ago"] })] }), _jsx(Badge, { provider: provider })] }), _jsxs("div", { className: "pcard-body", children: [_jsx(PaceBar, { provider: provider, asOf: asOf }), _jsxs("div", { className: "pstats", children: [_jsxs("div", { title: PACE_TIPS.avg, children: [_jsx("span", { className: "l", children: "Avg pace" }), _jsx("span", { className: "v", children: pace.avg })] }), _jsxs("div", { title: PACE_TIPS.recent, children: [_jsx("span", { className: "l", children: "24h pace" }), _jsx("span", { className: "v", children: pace.recent })] }), _jsxs("div", { title: PACE_TIPS.ideal, children: [_jsx("span", { className: "l", children: "Ideal pace" }), _jsx("span", { className: "v", children: advisory ? `${advisory.idealRate.toFixed(1)}%/day` : "—" })] }), _jsxs("div", { children: [_jsx("span", { className: "l", children: "Resets in" }), _jsx("span", { className: "v", children: resetsIn ? `${resetsIn}${isEstimated(provider) ? " (est.)" : ""}` : resetCountdown(provider, asOfMs) })] })] })] }), _jsxs("div", { className: "pcard-foot", children: [_jsxs("div", { className: "foot-meta", children: [_jsx("span", { children: resetsDate(provider) ?? resetCountdown(provider, asOfMs) }), last && (_jsxs("span", { className: "last-week", children: ["Last week ", last.leftoverPct, "% leftover", last.resetsAtEstimated ? " (est.)" : ""] }))] }), _jsx("span", { className: "rowbtn", "aria-hidden": "true", children: "Inspect" })] })] }));
 }

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

@@ -3,6 +3,7 @@ import { useEffect, useRef, useState } from "react";
 import { ageDuration, displayPlan, providerSubtitle, shortWindowLabel } from "../state.js";
 import { Badge, PaceBar, barGeometry, isEstimated, paceBadge, paceFigures, resetClock, timeLeft, } from "./PaceBar.js";
 import { ProviderIcon, providerTint } from "./ProviderIcon.js";
+import { ClosedWeeks } from "./ClosedWeeks.js";
 import { renameProvider } from "../api.js";
 export function exclusionWords(reason) {
     switch (reason) {
@@ -120,6 +121,8 @@ export function pacingStatusToken(provider) {
             return "ontrack";
         case "Ahead of pace":
             return "ahead";
+        case "Watch":
+            return "watch";
         case "Cap risk":
             return "cap";
         case "Measuring":
@@ -181,6 +184,9 @@ export function rankingCopy(provider, recommendation) {
     else if (advisory?.status === "at risk") {
         decision = "Forecast to hit the cap before reset; flagged to ease off.";
     }
+    else if (advisory?.status === "watch") {
+        decision = "Near the cap — position or reset clock uncertain.";
+    }
     else if (advisory?.urgency === "slow down") {
         decision = "Burning faster than the window; ease off.";
     }
@@ -362,7 +368,7 @@ export function ProviderDrawer({ provider, asOf, recommendation, onClose, onRena
                                         width: `${Math.min(100, Math.max(0, model.sessionPct))}%`,
                                         background: "var(--fill-ontrack)",
                                         ["--fill-edge"]: "var(--edge-ontrack)",
-                                    } }) })] })), _jsxs("section", { className: "dsec", "aria-label": "Adapter and provenance", children: [_jsx("h3", { children: "Adapter and provenance" }), _jsxs("dl", { className: "dkv", children: [_jsx("dt", { children: "Read by" }), _jsx("dd", { children: sourceLabel(provider.quota?.source) }), _jsx("dt", { children: "Credential" }), _jsx("dd", { children: credentialLabel(provider) }), _jsx("dt", { children: "Window" }), _jsx("dd", { children: [
+                                    } }) })] })), _jsx(ClosedWeeks, { closes: provider.lastCloses }), _jsxs("section", { className: "dsec", "aria-label": "Adapter and provenance", children: [_jsx("h3", { children: "Adapter and provenance" }), _jsxs("dl", { className: "dkv", children: [_jsx("dt", { children: "Read by" }), _jsx("dd", { children: sourceLabel(provider.quota?.source) }), _jsx("dt", { children: "Credential" }), _jsx("dd", { children: credentialLabel(provider) }), _jsx("dt", { children: "Window" }), _jsx("dd", { children: [
                                             provider.quota?.plan && provider.quota.plan !== "unknown" ? provider.quota.plan : null,
                                             resetStamp(provider) ? `resets ${resetStamp(provider)}` : null,
                                         ]

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { displayPlan, shortWindowLabel } from "../state.js";
 import { Badge, PaceBar, forecastLine, paceLines, resetCellLines, } from "./PaceBar.js";
+import { lastClose } from "./ClosedWeeks.js";
 export function ProviderRow({ provider, recommended, asOf, onSelect, }) {
     const quota = provider.quota;
     const advisory = provider.advisory;
@@ -10,7 +11,8 @@ export function ProviderRow({ provider, recommended, asOf, onSelect, }) {
     const plan = displayPlan(quota?.plan);
     const shortWindow = shortWindowLabel(provider.id);
     const reset = resetCellLines(provider, asOfMs);
-    return (_jsxs("div", { "data-testid": `provider-row-${provider.id}`, className: `lrow ${recommended ? "is-recommended is-top-pick" : ""}`, onClick: () => onSelect(provider.id), children: [_jsxs("div", { className: "prov", "data-label": "Provider", children: [_jsx("span", { className: "dot", style: { background: `var(--p-${provider.id.split(":")[0]}, var(--surface-raised))` }, "aria-hidden": "true" }), _jsxs("span", { children: [_jsxs("span", { className: "nm", children: [name, recommended && (_jsx("span", { className: "rec-icon", title: "Recommended for next session", role: "img", "aria-label": "recommended", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.3", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3z" }) }) }))] }), plan && _jsx("span", { className: "pl", children: plan }), quota?.sessionPct !== undefined && quota.sessionPct !== null && (_jsxs("span", { className: "src", children: [shortWindow ?? "5h Limit", " \u00B7 ", quota.sessionPct, "% used"] }))] })] }), _jsx("div", { "data-label": "Used vs elapsed", children: quota ? _jsx(PaceBar, { provider: provider, asOf: asOf }) : "—" }), _jsxs("div", { "data-label": "Reset", className: "reset-cell", children: [_jsx("span", { className: "cell-b", children: reset.top }), reset.bottom && _jsx("span", { className: "cell-s", children: reset.bottom })] }), _jsxs("div", { "data-label": "Pace", children: [_jsx(Badge, { provider: provider }), lines.length > 0 && (_jsx("div", { style: { marginTop: 2 }, children: lines.map((l) => (_jsxs("div", { className: "cell-s paceline", title: l.tip, children: [_jsx("span", { children: l.label }), _jsx("span", { className: "cell-b", children: l.value })] }, l.label))) }))] }), _jsx("button", { type: "button", className: "rowbtn", onClick: (e) => {
+    const last = lastClose(provider);
+    return (_jsxs("div", { "data-testid": `provider-row-${provider.id}`, className: `lrow ${recommended ? "is-recommended is-top-pick" : ""}`, onClick: () => onSelect(provider.id), children: [_jsxs("div", { className: "prov", "data-label": "Provider", children: [_jsx("span", { className: "dot", style: { background: `var(--p-${provider.id.split(":")[0]}, var(--surface-raised))` }, "aria-hidden": "true" }), _jsxs("span", { children: [_jsxs("span", { className: "nm", children: [name, recommended && (_jsx("span", { className: "rec-icon", title: "Recommended for next session", role: "img", "aria-label": "recommended", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.3", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3z" }) }) }))] }), plan && _jsx("span", { className: "pl", children: plan }), quota?.sessionPct !== undefined && quota.sessionPct !== null && (_jsxs("span", { className: "src", children: [shortWindow ?? "5h Limit", " \u00B7 ", quota.sessionPct, "% used"] }))] })] }), _jsx("div", { "data-label": "Used vs elapsed", children: quota ? _jsx(PaceBar, { provider: provider, asOf: asOf }) : "—" }), _jsxs("div", { "data-label": "Reset", className: "reset-cell", children: [_jsx("span", { className: "cell-b", children: reset.top }), reset.bottom && _jsx("span", { className: "cell-s", children: reset.bottom }), last && (_jsxs("span", { className: "cell-s", children: ["last week ", last.leftoverPct, "% leftover", last.resetsAtEstimated ? " (est.)" : ""] }))] }), _jsxs("div", { "data-label": "Pace", children: [_jsx(Badge, { provider: provider }), lines.length > 0 && (_jsx("div", { style: { marginTop: 2 }, children: lines.map((l) => (_jsxs("div", { className: "cell-s paceline", title: l.tip, children: [_jsx("span", { children: l.label }), _jsx("span", { className: "cell-b", children: l.value })] }, l.label))) }))] }), _jsx("button", { type: "button", className: "rowbtn", onClick: (e) => {
                     e.stopPropagation();
                     onSelect(provider.id);
                 }, children: "Inspect" }), _jsx("span", { className: "sr-only", children: forecastLine(provider) })] }));

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

@@ -56,9 +56,18 @@ export function Recommendation({ recommendation, providers, asOf, onSelectProvid
     const { useMore, easeOff } = lanesFor(recommendation.advisories, providers);
     const asOfMs = Date.parse(asOf);
     const measuring = recommendation.use !== "none" && recommendation.wastePct === null;
-    const isClear = recommendation.use === "none" && useMore.length === 0 && easeOff.length === 0;
+    // Lane membership keys off urgency, and both risk tiers can carry urgency
+    // "on track" (burn inside 1.4x ideal), so a board with any at-risk or Watch
+    // provider is never "clear" even when both lanes are empty.
+    const hasRiskOrWatch = recommendation.advisories.some((a) => a.status === "at risk" || a.status === "watch");
+    const isClear = recommendation.use === "none" && useMore.length === 0 && easeOff.length === 0 && !hasRiskOrWatch;
     const tracked = providers.filter((p) => p.enabled && p.id !== "manual").length;
-    const easeTint = easeOff.some((a) => a.status === "at risk") ? "tint-cap" : "tint-ahead";
+    const easeTint = easeOff.some((a) => a.status === "watch")
+        ? "tint-watch"
+        : easeOff.some((a) => a.status === "at risk")
+            ? "tint-cap"
+            : "tint-ahead";
+    const easeLane = easeTint === "tint-cap" ? "l-cap" : easeTint === "tint-watch" ? "l-watch" : "l-ahead";
     const pick = providers.find((p) => p.id === recommendation.use);
     const pickLeft = pick?.quota ? timeLeft(pick.quota.resetsAt, asOfMs) : null;
     const openAdvice = () => {
@@ -72,5 +81,5 @@ export function Recommendation({ recommendation, providers, asOf, onSelectProvid
                                             background: "var(--ahead-soft)",
                                             color: "var(--ahead)",
                                             borderColor: "var(--ahead)",
-                                        }, children: "measuring pace" }))] }), recommendation.use !== "none" && (_jsxs("button", { type: "button", className: "btn", "data-testid": "view-advice", title: "Open recommended provider", onClick: openAdvice, children: ["View advice", _jsx("svg", { width: "13", height: "13", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M5 12h14M12 5l7 7-7 7" }) })] }))] }), (useMore.length > 0 || easeOff.length > 0) && (_jsxs("div", { className: "recB", children: [_jsx(LaneSection, { testId: "lane-use-more", label: "Use more", tintClass: "tint-behind", laneClass: "l-behind", icon: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.6", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M12 20V5M6 11l6-6 6 6" }) }), members: useMore, providers: providers, asOfMs: asOfMs, onSelectProvider: onSelectProvider }), _jsx(LaneSection, { testId: "lane-ease-off", label: "Ease off", tintClass: easeTint, laneClass: easeTint === "tint-cap" ? "l-cap" : "l-ahead", icon: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.6", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M12 4v15M6 13l6 6 6-6" }) }), members: easeOff, providers: providers, asOfMs: asOfMs, onSelectProvider: onSelectProvider })] }))] })] }));
+                                        }, children: "measuring pace" }))] }), recommendation.use !== "none" && (_jsxs("button", { type: "button", className: "btn", "data-testid": "view-advice", title: "Open recommended provider", onClick: openAdvice, children: ["View advice", _jsx("svg", { width: "13", height: "13", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M5 12h14M12 5l7 7-7 7" }) })] }))] }), (useMore.length > 0 || easeOff.length > 0) && (_jsxs("div", { className: "recB", children: [_jsx(LaneSection, { testId: "lane-use-more", label: "Use more", tintClass: "tint-behind", laneClass: "l-behind", icon: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.6", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M12 20V5M6 11l6-6 6 6" }) }), members: useMore, providers: providers, asOfMs: asOfMs, onSelectProvider: onSelectProvider }), _jsx(LaneSection, { testId: "lane-ease-off", label: "Ease off", tintClass: easeTint, laneClass: easeLane, icon: _jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.6", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M12 4v15M6 13l6 6 6-6" }) }), members: easeOff, providers: providers, asOfMs: asOfMs, onSelectProvider: onSelectProvider })] }))] })] }));
 }

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

@@ -134,6 +134,8 @@ function pinPace(provider) {
             return { cls: "pace-ontrack", color: "var(--good)" };
         case "Ahead of pace":
             return { cls: "pace-ahead", color: "var(--ahead)" };
+        case "Watch":
+            return { cls: "pace-watch", color: "var(--watch)" };
         case "Cap risk":
             return { cls: "pace-cap", color: "var(--danger)" };
         default: