quotacap 0.0.7 → 0.0.8

package/dist/advisory/engine.d.ts

@@ -1,6 +1,6 @@
 import type { Quota } from "../adapters/types.js";
 import type { Advisory } from "./types.js";
-export declare function computeAdvisory(q: Quota, burnRate: number, now?: Date): Advisory;
+export declare function computeAdvisory(q: Quota, burnRate: number, now?: Date, burnMeasured?: boolean): Advisory;
 export declare function recommend(quotas: Quota[], _task: string, burnByProvider?: Map<string, number>, now?: Date): {
     use: string;
     reason: string;

package/dist/advisory/engine.js

@@ -1,9 +1,12 @@
-export function computeAdvisory(q, burnRate, now = new Date()) {
+export function computeAdvisory(q, burnRate, now = new Date(), burnMeasured = false) {
     const resets = new Date(q.resetsAt);
     const daysLeft = Math.max(0.1, (resets.getTime() - now.getTime()) / 86400000);
     const remaining = 100 - q.usedPct;
     const idealRate = remaining / daysLeft;
     const wastePct = Math.max(0, remaining - burnRate * daysLeft);
+    // burn > ideal is exactly "quota exhausts before reset": remaining/burn < daysLeft
+    const daysToExhaust = burnRate > 0 ? remaining / burnRate : Infinity;
+    const status = daysToExhaust < daysLeft ? "at risk" : "on track";
     let urgency = "on track";
     if (wastePct > 30 && daysLeft < 3)
         urgency = "burn now";
@@ -13,12 +16,12 @@ export function computeAdvisory(q, burnRate, now = new Date()) {
         urgency = "slow down";
     else if (wastePct > 10)
         urgency = "save";
-    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, wastePct, urgency };
+    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, burnMeasured, daysToExhaust, status, wastePct, urgency };
 }
 export function recommend(quotas, _task, burnByProvider = new Map(), now = new Date()) {
     if (!quotas.length)
         return { use: "none", reason: "no quotas yet", wastePct: 0, idealRate: 0, alternatives: [], advisories: [] };
-    const advisories = quotas.map(q => computeAdvisory(q, burnByProvider.get(q.provider) ?? 2, now));
+    const advisories = quotas.map(q => computeAdvisory(q, burnByProvider.get(q.provider) ?? 2, now, burnByProvider.has(q.provider)));
     const burnNow = advisories.filter(a => a.urgency === "burn now");
     const pool = burnNow.length ? burnNow : advisories;
     const use = pool.sort((a, b) => b.wastePct - a.wastePct)[0];

package/dist/advisory/types.d.ts

@@ -1,10 +1,14 @@
 export type Urgency = "burn now" | "use soon" | "slow down" | "save" | "on track";
+export type BurnStatus = "at risk" | "on track";
 export interface Advisory {
     provider: string;
     daysLeft: number;
     remaining: number;
     idealRate: number;
     burnRate: number;
+    burnMeasured: boolean;
+    daysToExhaust: number;
+    status: BurnStatus;
     wastePct: number;
     urgency: Urgency;
 }

package/dist/http/server.js

@@ -45,7 +45,9 @@ export function buildApp(db) {
         }
         try {
             const task = req.query?.task ?? "any";
-            return recommend(quotas, task);
+            const { getBurnRates } = await import("../store/quotas.js");
+            const burnByProvider = getBurnRates(db);
+            return recommend(quotas, task, burnByProvider);
         }
         catch (e) {
             return { use: quotas[0]?.provider ?? "none", reason: `advisory error: ${e?.message ?? String(e)}`, alternatives: quotas };

package/dist/mcp/server.js

@@ -23,11 +23,13 @@ export function recommendationTable(rec) {
         const resets = q?.resetsAt ? new Date(q.resetsAt).toLocaleString() : "—";
         const daysLeft = a.daysLeft != null ? a.daysLeft.toFixed(1) : "—";
         const ideal = a.idealRate != null ? `${Math.round(a.idealRate)}%/day` : "—";
-        return `| ${a.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${Math.round(a.wastePct)}% |`;
+        const burn = a.burnMeasured ? `${a.burnRate.toFixed(1)}%/day` : "collecting…";
+        const icon = a.status === "at risk" ? "⚠️" : "✅";
+        return `| ${a.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${burn} | ${icon} | ${Math.round(a.wastePct)}% |`;
     });
     return [
-        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Waste if unused |",
-        "|---|---|---|---|---|---|---|",
+        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Burn rate | Status | Waste if unused |",
+        "|---|---|---|---|---|---|---|---|---|",
         ...rows,
     ].join("\n");
 }

package/dist/src/advisory/engine.d.ts

@@ -1,6 +1,6 @@
 import type { Quota } from "../adapters/types.js";
 import type { Advisory } from "./types.js";
-export declare function computeAdvisory(q: Quota, burnRate: number, now?: Date): Advisory;
+export declare function computeAdvisory(q: Quota, burnRate: number, now?: Date, burnMeasured?: boolean): Advisory;
 export declare function recommend(quotas: Quota[], _task: string, burnByProvider?: Map<string, number>, now?: Date): {
     use: string;
     reason: string;

package/dist/src/advisory/engine.js

@@ -1,9 +1,12 @@
-export function computeAdvisory(q, burnRate, now = new Date()) {
+export function computeAdvisory(q, burnRate, now = new Date(), burnMeasured = false) {
     const resets = new Date(q.resetsAt);
     const daysLeft = Math.max(0.1, (resets.getTime() - now.getTime()) / 86400000);
     const remaining = 100 - q.usedPct;
     const idealRate = remaining / daysLeft;
     const wastePct = Math.max(0, remaining - burnRate * daysLeft);
+    // burn > ideal is exactly "quota exhausts before reset": remaining/burn < daysLeft
+    const daysToExhaust = burnRate > 0 ? remaining / burnRate : Infinity;
+    const status = daysToExhaust < daysLeft ? "at risk" : "on track";
     let urgency = "on track";
     if (wastePct > 30 && daysLeft < 3)
         urgency = "burn now";
@@ -13,12 +16,12 @@ export function computeAdvisory(q, burnRate, now = new Date()) {
         urgency = "slow down";
     else if (wastePct > 10)
         urgency = "save";
-    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, wastePct, urgency };
+    return { provider: q.provider, daysLeft, remaining, idealRate, burnRate, burnMeasured, daysToExhaust, status, wastePct, urgency };
 }
 export function recommend(quotas, _task, burnByProvider = new Map(), now = new Date()) {
     if (!quotas.length)
         return { use: "none", reason: "no quotas yet", wastePct: 0, idealRate: 0, alternatives: [], advisories: [] };
-    const advisories = quotas.map(q => computeAdvisory(q, burnByProvider.get(q.provider) ?? 2, now));
+    const advisories = quotas.map(q => computeAdvisory(q, burnByProvider.get(q.provider) ?? 2, now, burnByProvider.has(q.provider)));
     const burnNow = advisories.filter(a => a.urgency === "burn now");
     const pool = burnNow.length ? burnNow : advisories;
     const use = pool.sort((a, b) => b.wastePct - a.wastePct)[0];

package/dist/src/advisory/types.d.ts

@@ -1,10 +1,14 @@
 export type Urgency = "burn now" | "use soon" | "slow down" | "save" | "on track";
+export type BurnStatus = "at risk" | "on track";
 export interface Advisory {
     provider: string;
     daysLeft: number;
     remaining: number;
     idealRate: number;
     burnRate: number;
+    burnMeasured: boolean;
+    daysToExhaust: number;
+    status: BurnStatus;
     wastePct: number;
     urgency: Urgency;
 }

package/dist/src/http/server.js

@@ -45,7 +45,9 @@ export function buildApp(db) {
         }
         try {
             const task = req.query?.task ?? "any";
-            return recommend(quotas, task);
+            const { getBurnRates } = await import("../store/quotas.js");
+            const burnByProvider = getBurnRates(db);
+            return recommend(quotas, task, burnByProvider);
         }
         catch (e) {
             return { use: quotas[0]?.provider ?? "none", reason: `advisory error: ${e?.message ?? String(e)}`, alternatives: quotas };

package/dist/src/mcp/server.js

@@ -23,11 +23,13 @@ export function recommendationTable(rec) {
         const resets = q?.resetsAt ? new Date(q.resetsAt).toLocaleString() : "—";
         const daysLeft = a.daysLeft != null ? a.daysLeft.toFixed(1) : "—";
         const ideal = a.idealRate != null ? `${Math.round(a.idealRate)}%/day` : "—";
-        return `| ${a.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${Math.round(a.wastePct)}% |`;
+        const burn = a.burnMeasured ? `${a.burnRate.toFixed(1)}%/day` : "collecting…";
+        const icon = a.status === "at risk" ? "⚠️" : "✅";
+        return `| ${a.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${burn} | ${icon} | ${Math.round(a.wastePct)}% |`;
     });
     return [
-        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Waste if unused |",
-        "|---|---|---|---|---|---|---|",
+        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Burn rate | Status | Waste if unused |",
+        "|---|---|---|---|---|---|---|---|---|",
         ...rows,
     ].join("\n");
 }

package/dist/src/store/quotas.d.ts

@@ -3,3 +3,4 @@ export declare function getLatestByProvider(db: any, provider: string): any;
 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): Map<string, number>;

package/dist/src/store/quotas.js

@@ -26,3 +26,27 @@ export function getAllLatest(db) {
 // alias for plan's getQuotas naming
 export const getQuotas = getAllLatest;
 export function getSnapshots(db) { return db.prepare(`SELECT * FROM snapshots ORDER BY day DESC`).all(); }
+export function getBurnRates(db) {
+    const rows = db.prepare(`SELECT day, provider, used_pct FROM snapshots`).all();
+    const byProvider = new Map();
+    for (const r of rows) {
+        const pts = byProvider.get(r.provider) ?? [];
+        pts.push({ day: r.day, usedPct: r.used_pct });
+        byProvider.set(r.provider, pts);
+    }
+    const out = new Map();
+    for (const [provider, pts] of byProvider) {
+        if (pts.length < 2)
+            continue;
+        const sorted = [...pts].sort((a, b) => a.day.localeCompare(b.day));
+        const first = sorted[0];
+        const last = sorted[sorted.length - 1];
+        const days = (new Date(last.day).getTime() - new Date(first.day).getTime()) / 86400000;
+        if (days < 1)
+            continue;
+        const burn = (last.usedPct - first.usedPct) / days;
+        if (burn >= 0)
+            out.set(provider, burn);
+    }
+    return out;
+}

package/dist/src/version.js

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