quotacap 0.0.39 → 0.0.41

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

@@ -3,12 +3,16 @@ import { ageLabel } from "../state.js";
 import { timeLeft } from "./PaceBar.js";
 import { ProviderIcon, providerTint } from "./ProviderIcon.js";
 /**
- * Lane membership from server urgency only. Any exclusionReason keeps the
- * provider out of both lanes; "on track" belongs to neither lane.
+ * Lane membership from server urgency only. Any exclusionReason, or an
+ * exhausted binding month, keeps the provider out of both lanes; "on track"
+ * belongs to neither lane.
  */
 export function laneOf(advisory, exclusionReason) {
     if (exclusionReason !== null)
         return null;
+    // A blocked month vetoes weekly leftover: no lane, exactly like an exclusion.
+    if (advisory.bindingWindow === "monthly" && advisory.bindingRemaining === 0)
+        return null;
     switch (advisory.urgency) {
         case "burn now":
         case "use soon":
@@ -45,7 +49,7 @@ function LaneSection({ testId, label, tintClass, laneClass, icon, members, provi
                     const quota = byId.get(m.provider)?.quota;
                     const left = quota ? timeLeft(quota.resetsAt, asOfMs) : null;
                     const name = byId.get(m.provider)?.displayName ?? m.provider;
-                    return (_jsxs("div", { className: "rsub", children: [_jsx("span", { className: "sq", style: providerTint(m.provider), "aria-hidden": "true", children: _jsx(ProviderIcon, { id: m.provider, title: name, size: 13 }) }), _jsx("div", { className: "rnm-group", children: _jsx("button", { type: "button", className: "rnm", onClick: () => onSelectProvider?.(m.provider), "aria-label": `View ${name} details`, children: name }) }), _jsx("span", { className: "rnum", children: quota ? (_jsxs(_Fragment, { children: [_jsxs("b", { children: [quota.usedPct, "%"] }), " used", left ? (_jsxs(_Fragment, { children: [" · ", _jsx("b", { children: left }), " left"] })) : null] })) : null })] }, m.provider));
+                    return (_jsxs("div", { className: "rsub", children: [_jsx("span", { className: "sq", style: providerTint(m.provider), "aria-hidden": "true", children: _jsx(ProviderIcon, { id: m.provider, title: name, size: 13 }) }), _jsx("div", { className: "rnm-group", children: _jsx("button", { type: "button", className: "rnm", onClick: () => onSelectProvider?.(m.provider), "aria-label": `View ${name} details`, children: name }) }), _jsx("span", { className: "rnum", children: quota ? (_jsxs(_Fragment, { children: [_jsxs("b", { children: [quota.weeklyPct, "%"] }), " used", left ? (_jsxs(_Fragment, { children: [" · ", _jsx("b", { children: left }), " left"] })) : null] })) : null })] }, m.provider));
                 }) })] }));
 }
 /**
@@ -77,7 +81,7 @@ export function Recommendation({ recommendation, providers, asOf, onSelectProvid
     if (isClear) {
         return (_jsxs("section", { "aria-label": "Quota advice and pacing", children: [head, _jsxs("section", { "data-testid": "recommendation", "aria-label": "Recommendation", className: "recwrap is-clear", role: "status", children: [_jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.4", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20z" }), _jsx("path", { d: "M8 12.5l2.8 2.8L16 10" })] }), _jsxs("div", { children: [_jsx("b", { children: "No subscription needs priority" }), _jsx("span", { "data-testid": "rec-prose", children: recommendation.reason })] })] })] }));
     }
-    return (_jsxs("section", { "aria-label": "Quota advice and pacing", children: [head, _jsxs("section", { "data-testid": "recommendation", "aria-label": "Recommendation", className: "recwrap", role: "status", children: [_jsxs("div", { className: "rec-top", children: [_jsxs("div", { className: "rec-lead", children: [_jsxs("span", { className: "rec-badge", children: [_jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", 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" }) }), "Recommendation"] }), recommendation.use === "none" ? (_jsx("p", { className: "rec-advice-prose", "data-testid": "rec-prose", children: recommendation.reason })) : (_jsxs("p", { className: "rec-advice-prose", "data-testid": "rec-prose", children: ["Switch to ", _jsx("strong", { children: pick?.displayName ?? recommendation.use }), " next", recommendation.wastePct !== null ? (_jsxs(_Fragment, { children: [" — ", _jsxs("strong", { children: [Math.round(recommendation.wastePct), "%"] }), " unused quota forecast", pickLeft ? _jsxs(_Fragment, { children: [" to expire in ", _jsx("strong", { children: pickLeft })] }) : null, "."] })) : (_jsxs(_Fragment, { children: [" \u2014 ", recommendation.reason] }))] })), measuring && (_jsx("span", { className: "rec-badge", "data-testid": "rec-measuring", style: {
+    return (_jsxs("section", { "aria-label": "Quota advice and pacing", children: [head, _jsxs("section", { "data-testid": "recommendation", "aria-label": "Recommendation", className: "recwrap", role: "status", children: [_jsxs("div", { className: "rec-top", children: [_jsxs("div", { className: "rec-lead", children: [_jsxs("span", { className: "rec-badge", children: [_jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", 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" }) }), "Recommendation"] }), recommendation.use === "none" ? (_jsx("p", { className: "rec-advice-prose", "data-testid": "rec-prose", children: recommendation.reason })) : (_jsxs("p", { className: "rec-advice-prose", "data-testid": "rec-prose", children: ["Switch to ", _jsx("strong", { children: pick?.displayName ?? recommendation.use }), " next", recommendation.wastePct !== null && recommendation.bindingWindow !== "monthly" ? (_jsxs(_Fragment, { children: [" — ", _jsxs("strong", { children: [Math.round(recommendation.wastePct), "%"] }), " unused quota forecast", pickLeft ? _jsxs(_Fragment, { children: [" to expire in ", _jsx("strong", { children: pickLeft })] }) : null, "."] })) : (_jsxs(_Fragment, { children: [" \u2014 ", recommendation.reason] }))] })), measuring && (_jsx("span", { className: "rec-badge", "data-testid": "rec-measuring", style: {
                                             background: "var(--ahead-soft)",
                                             color: "var(--ahead)",
                                             borderColor: "var(--ahead)",

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

@@ -112,7 +112,7 @@ function ClusterPopover({ cluster, providers, asOfMs, onSelect, onClose, }) {
                     return (_jsx("li", { children: _jsxs("button", { type: "button", onClick: () => {
                                 onSelect(id);
                                 onClose();
-                            }, children: [_jsx("b", { children: name }), _jsxs("span", { children: [provider?.quota ? `${provider.quota.usedPct}% · ` : "", provider ? resetCountdown(provider, asOfMs) : ""] })] }) }, id));
+                            }, children: [_jsx("b", { children: name }), _jsxs("span", { children: [provider?.quota ? `${provider.quota.weeklyPct}% · ` : "", provider ? resetCountdown(provider, asOfMs) : ""] })] }) }, id));
                 }) }), _jsx("button", { type: "button", className: "btn btn-sm btn-quiet", style: { marginTop: "var(--s2)", width: "100%" }, onClick: onClose, children: "Close" })] }));
 }
 function tzAbbrev() {
@@ -136,6 +136,7 @@ function pinPace(provider) {
             return { cls: "pace-ahead", color: "var(--ahead)" };
         case "Watch":
             return { cls: "pace-watch", color: "var(--watch)" };
+        case "Monthly exhausted":
         case "Cap risk":
             return { cls: "pace-cap", color: "var(--danger)" };
         default:
@@ -177,7 +178,7 @@ export function ResetRail({ providers, asOf, onSelectProvider, }) {
                             return (_jsxs("button", { "data-testid": "pin", type: "button", className: `pin ${pin.band} ${tierClass} ${alignClass}`, style: {
                                     left: `${pin.positionPct}%`,
                                     "--dot-color": paceColor,
-                                }, "aria-label": `${name}: ${pace}, resets ${when}`, onClick: () => onSelectProvider(pin.id), children: [pin.band === "above" ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "pin-when", children: pin.estimated ? `${when} (est.)` : when }), _jsx("span", { className: `pin-label ${paceCls}`, style: pinBorder, children: name }), _jsx("span", { className: "pin-stem" }), _jsx("span", { className: "pin-dot" })] })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "pin-dot" }), _jsx("span", { className: "pin-stem" }), _jsx("span", { className: `pin-label ${paceCls}`, style: pinBorder, children: name }), _jsx("span", { className: "pin-when", children: pin.estimated ? `${when} (est.)` : when })] })), _jsxs("span", { className: "pin-tooltip", role: "tooltip", children: [_jsx("b", { children: name }), _jsx("span", { className: "pt-sep", children: "\u00B7" }), provider?.quota ? `${provider.quota.usedPct}% used` : "no readings", _jsx("span", { className: "pt-sep", children: "\u00B7" }), left ? `${left} left` : when, pin.estimated ? " (est.)" : ""] })] }, pin.id));
+                                }, "aria-label": `${name}: ${pace}, resets ${when}`, onClick: () => onSelectProvider(pin.id), children: [pin.band === "above" ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "pin-when", children: pin.estimated ? `${when} (est.)` : when }), _jsx("span", { className: `pin-label ${paceCls}`, style: pinBorder, children: name }), _jsx("span", { className: "pin-stem" }), _jsx("span", { className: "pin-dot" })] })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "pin-dot" }), _jsx("span", { className: "pin-stem" }), _jsx("span", { className: `pin-label ${paceCls}`, style: pinBorder, children: name }), _jsx("span", { className: "pin-when", children: pin.estimated ? `${when} (est.)` : when })] })), _jsxs("span", { className: "pin-tooltip", role: "tooltip", children: [_jsx("b", { children: name }), _jsx("span", { className: "pt-sep", children: "\u00B7" }), provider?.quota ? `${provider.quota.weeklyPct}% used` : "no readings", _jsx("span", { className: "pt-sep", children: "\u00B7" }), left ? `${left} left` : when, pin.estimated ? " (est.)" : ""] })] }, pin.id));
                         }), placement.clusters.map((cluster, index) => {
                             const alignClass = cluster.positionPct < 12 ? "pin-start" : cluster.positionPct > 88 ? "pin-end" : "";
                             const tierClass = cluster.tier > 0 ? `tier${cluster.tier + 1}` : "tier1";

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

@@ -4,7 +4,8 @@ export type SortKey = "recommended" | "reset-asc" | "reset-desc" | "used-desc" |
 export type Density = "cards" | "table";
 /**
  * Sort over server fields only. Recommended puts the server pick first, then
- * lane members, then the rest in server order, excluded last. Sort is stable.
+ * lane members, then the rest in server order, excluded last. A blocked month
+ * sorts with the excluded rows. Sort is stable.
  */
 export declare function sortProviders(providers: ProviderView[], key: SortKey, recommendation: RecommendationView): ProviderView[];
 /** Density follows the control at every width — the prototype keeps Cards and Table visible on mobile. */

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

@@ -7,7 +7,8 @@ import { ProviderRow } from "./ProviderRow.js";
 import { resetCountdown } from "./PaceBar.js";
 /**
  * Sort over server fields only. Recommended puts the server pick first, then
- * lane members, then the rest in server order, excluded last. Sort is stable.
+ * lane members, then the rest in server order, excluded last. A blocked month
+ * sorts with the excluded rows. Sort is stable.
  */
 export function sortProviders(providers, key, recommendation) {
     const list = [...providers];
@@ -21,15 +22,17 @@ export function sortProviders(providers, key, recommendation) {
             if (!order.has(a.provider))
                 order.set(a.provider, rank++);
         }
+        const blocked = (p) => p.exclusionReason !== null ||
+            (p.advisory?.bindingWindow === "monthly" && p.advisory.bindingRemaining === 0);
         const ranked = list
-            .filter((p) => p.exclusionReason === null && order.has(p.id))
+            .filter((p) => !blocked(p) && order.has(p.id))
             .sort((a, b) => order.get(a.id) - order.get(b.id));
-        const rest = list.filter((p) => p.exclusionReason === null && !order.has(p.id));
-        const excluded = list.filter((p) => p.exclusionReason !== null);
+        const rest = list.filter((p) => !blocked(p) && !order.has(p.id));
+        const excluded = list.filter(blocked);
         return [...ranked, ...rest, ...excluded];
     }
     const resetMs = (p) => (p.quota ? Date.parse(p.quota.resetsAt) : NaN);
-    const used = (p) => (p.quota ? p.quota.usedPct : NaN);
+    const used = (p) => (p.quota ? p.quota.weeklyPct : NaN);
     const withInvalidLast = (cmp, value) => list.sort((a, b) => {
         const va = value(a);
         const vb = value(b);

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

@@ -0,0 +1,30 @@
+import React from "react";
+import type { ProviderView } from "../state.js";
+/** One-unit countdown for a window tag: "7d", "4h" or "40m". Null when passed or unparseable. */
+export declare function windowCountdown(resetsAt: string, asOfMs: number): string | null;
+export interface WindowUnit {
+    win: "five" | "month";
+    tag: "5h" | "Mth";
+    cardLabel: string;
+    rowLabel: string;
+    pct: number;
+    /** Presentation-only heat: < 80 none, 80–99 hot, 100 or exhausted full. */
+    heat: "" | "hot" | "full";
+    /** Tag time outside the pill: "in 7d", or the weekday alone when the month is exhausted. */
+    time: string | null;
+    /** Expanded card track's reset line. */
+    reset: string | null;
+}
+/** Present windows only; a unit with no data is not rendered at all. */
+export declare function windowUnits(provider: ProviderView, asOfMs: number): WindowUnit[];
+/**
+ * Collapsed windows line under the weekly bar, with a per-card chevron that
+ * expands thin tracks. A real button inside the card's role="button": click
+ * stops propagation so it never opens the drawer, and the card's own keydown
+ * ignores keys aimed at this button.
+ */
+export declare function WindowsRow({ provider, asOf, variant }: {
+    provider: ProviderView;
+    asOf: string;
+    variant: "card" | "row";
+}): React.JSX.Element | null;

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

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React from "react";
+import { resetClock, resetWeekday } from "./PaceBar.js";
+const MIN_MS = 60_000;
+const HOUR_MS = 60 * MIN_MS;
+const DAY_MS = 24 * HOUR_MS;
+/** One-unit countdown for a window tag: "7d", "4h" or "40m". Null when passed or unparseable. */
+export function windowCountdown(resetsAt, asOfMs) {
+    const diff = Date.parse(resetsAt) - asOfMs;
+    if (!Number.isFinite(diff) || diff <= 0)
+        return null;
+    if (diff >= DAY_MS)
+        return `${Math.floor(diff / DAY_MS)}d`;
+    if (diff >= HOUR_MS)
+        return `${Math.floor(diff / HOUR_MS)}h`;
+    return `${Math.max(1, Math.floor(diff / MIN_MS))}m`;
+}
+function heatOf(pct, exhausted) {
+    if (exhausted || pct >= 100)
+        return "full";
+    return pct >= 80 ? "hot" : "";
+}
+/** Present windows only; a unit with no data is not rendered at all. */
+export function windowUnits(provider, asOfMs) {
+    const q = provider.quota;
+    if (!q)
+        return [];
+    const units = [];
+    if (typeof q.fiveHourPct === "number" && Number.isFinite(q.fiveHourPct)) {
+        // No adapter reports a 5h reset, so the 5h tag carries no time.
+        units.push({ win: "five", tag: "5h", cardLabel: "5h limit", rowLabel: "5h",
+            pct: q.fiveHourPct, heat: heatOf(q.fiveHourPct, false), time: null, reset: null });
+    }
+    if (q.monthlyKind === "included" && typeof q.monthlyPct === "number" && q.monthlyResetsAt) {
+        const exhausted = q.monthlyStatus === "exhausted";
+        const left = windowCountdown(q.monthlyResetsAt, asOfMs);
+        const clock = resetClock(q.monthlyResetsAt);
+        units.push({ win: "month", tag: "Mth", cardLabel: "Monthly", rowLabel: "Month",
+            pct: q.monthlyPct, heat: heatOf(q.monthlyPct, exhausted),
+            time: exhausted ? resetWeekday(q.monthlyResetsAt) : left ? `in ${left}` : null,
+            reset: exhausted ? (clock ? `resets ${clock}` : null) : left ? `in ${left}` : null });
+    }
+    return units;
+}
+function trackFill(u) {
+    const cap = u.pct >= 80 || u.heat === "full";
+    return {
+        width: `${Math.min(100, Math.max(0, u.pct))}%`,
+        background: cap ? "var(--fill-cap)" : "var(--fill-ontrack)",
+        ["--fill-edge"]: cap ? "var(--edge-cap)" : "var(--edge-ontrack)",
+    };
+}
+/**
+ * Collapsed windows line under the weekly bar, with a per-card chevron that
+ * expands thin tracks. A real button inside the card's role="button": click
+ * stops propagation so it never opens the drawer, and the card's own keydown
+ * ignores keys aimed at this button.
+ */
+export function WindowsRow({ provider, asOf, variant }) {
+    const [open, setOpen] = React.useState(false);
+    const units = windowUnits(provider, Date.parse(asOf));
+    if (units.length === 0)
+        return null;
+    return (_jsxs(_Fragment, { children: [_jsxs("button", { type: "button", className: "wline", "data-testid": `wline-${provider.id}`, "aria-expanded": open, "aria-label": `${provider.displayName} other windows: ${units.map((u) => `${u.tag} ${u.pct}%${u.time ? ` ${u.time}` : ""}`).join(", ")}`, onClick: (e) => {
+                    e.stopPropagation();
+                    setOpen((v) => !v);
+                }, children: [units.map((u) => (_jsxs("span", { className: "unit", "data-win": u.win, children: [_jsxs("span", { className: u.heat ? `seg ${u.heat}` : "seg", children: [_jsx("span", { className: "k", children: u.tag }), _jsxs("span", { className: "n", children: [u.pct, "%"] })] }), u.time && _jsx("span", { className: "t", children: u.time })] }, u.win))), _jsx("span", { className: "chev", "aria-hidden": "true", children: _jsx("svg", { viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.7", strokeLinecap: "round", children: _jsx("path", { d: "M4 6l4 4 4-4" }) }) })] }), open && (_jsx("div", { className: "windows", "data-testid": `windows-${provider.id}`, children: units.map((u) => (_jsxs("div", { className: "win", "data-win": u.win, children: [_jsx("span", { className: "lab", children: variant === "card" ? u.cardLabel : u.rowLabel }), _jsx("div", { className: "track", children: _jsx("div", { className: "fill", style: trackFill(u) }) }), _jsxs("span", { className: "pct", children: [u.pct, "%"] }), variant === "card" && u.reset && _jsx("span", { className: "reset", children: u.reset })] }, u.win))) }))] }));
+}

package/dist/web/src/pages/Onboarding.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { ageDuration } from "../state.js";
 import { failureWords } from "../components/ProviderDrawer.js";
+import { authInstruction } from "../components/FaultBanner.js";
 /**
  * Provider readiness from server state only. The browser cannot probe local
  * paths, so this reports what the daemon reported — never a local scan.
@@ -27,7 +28,7 @@ export function readiness(provider) {
     if (provider.lastAttempt?.failureCategory === "auth") {
         return {
             status: "Sign in first",
-            detail: `Sign in to the ${cli} CLI, then re-poll. ${credentialNote}`,
+            detail: authInstruction(cli, provider.lastAttempt),
         };
     }
     if (!provider.lastAttempt) {

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

@@ -23,6 +23,9 @@ export interface AdvisoryView {
     status: BurnStatus;
     wastePct: number | null;
     urgency: Urgency;
+    bindingWindow: "weekly" | "monthly";
+    bindingRemaining: number;
+    bindingDaysLeft: number;
 }
 export interface RecommendationView {
     use: string;
@@ -30,6 +33,7 @@ export interface RecommendationView {
     wastePct: number | null;
     idealRate: number;
     recommendationBasis: RecommendationBasis;
+    bindingWindow: "weekly" | "monthly";
     alternatives: unknown[];
     advisories: AdvisoryView[];
 }
@@ -48,7 +52,15 @@ export interface WindowCloseView {
 export interface QuotaView {
     provider: string;
     plan: string;
+    weeklyPct: number;
+    fiveHourPct?: number;
+    monthlyPct?: number;
+    monthlyResetsAt?: string;
+    monthlyStatus?: "ok" | "exhausted";
+    monthlyKind?: "included";
+    /** @deprecated wire alias for weeklyPct. */
     usedPct: number;
+    /** @deprecated wire alias for fiveHourPct. */
     sessionPct?: number;
     resetsAt: string;
     periodStart: string;