quotacap 0.0.7 → 0.0.9

package/dist/src/webHtml.js

@@ -1,2 +1,2 @@
 // generated by scripts/build-embed.mjs — do not edit
-export const webHtml = "<!doctype html><html><head><meta charset=\"utf-8\"><title>QuotaCap</title>  <script type=\"module\" crossorigin src=\"/assets/index-G2N84rBQ.js\"></script>\n</head><body><div id=\"app\"></div></body></html>\n";
+export const webHtml = "<!doctype html><html><head><meta charset=\"utf-8\"><title>QuotaCap</title>  <script type=\"module\" crossorigin src=\"/assets/index-C7g0JA14.js\"></script>\n</head><body><div id=\"app\"></div></body></html>\n";

package/dist/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/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/tests/advisory/engine.test.js

@@ -8,4 +8,27 @@ describe("advisory", () => {
         expect(adv.wastePct).toBeGreaterThan(0);
         expect(adv.urgency).toBe("burn now");
     });
+    it("flags at risk when measured burn exhausts the quota before reset", () => {
+        const now = new Date("2026-08-28T06:00:00+10:00");
+        const q = { provider: "kimi", usedPct: 16, resetsAt: "2026-08-31T11:00:00+10:00" };
+        const adv = computeAdvisory(q, 40, now, true);
+        expect(adv.burnMeasured).toBe(true);
+        expect(adv.burnRate).toBe(40);
+        expect(adv.daysToExhaust).toBeCloseTo(2.1, 1);
+        expect(adv.status).toBe("at risk");
+    });
+    it("marks on track when burn stays under the ideal rate", () => {
+        const now = new Date("2026-08-28T06:00:00+10:00");
+        const q = { provider: "kimi", usedPct: 16, resetsAt: "2026-08-31T11:00:00+10:00" };
+        const adv = computeAdvisory(q, 20, now, true);
+        expect(adv.daysToExhaust).toBeCloseTo(4.2, 1);
+        expect(adv.status).toBe("on track");
+    });
+    it("reports unmeasured burn as a default", () => {
+        const now = new Date("2026-08-28T06:00:00+10:00");
+        const q = { provider: "kimi", usedPct: 16, resetsAt: "2026-08-31T11:00:00+10:00" };
+        const adv = computeAdvisory(q, 2, now, false);
+        expect(adv.burnMeasured).toBe(false);
+        expect(adv.burnRate).toBe(2);
+    });
 });

package/dist/tests/cli/cli.test.js

@@ -1,10 +1,26 @@
 import { describe, it, expect } from "vitest";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 const exec = promisify(execFile);
 describe("cli", () => {
     it("--help lists commands", async () => {
         const { stdout } = await exec("node", ["dist/cli/index.js", "--help"]);
         expect(stdout).toMatch(/status/);
     });
+    it("status prints the shared quota table", async () => {
+        const home = fs.mkdtempSync(path.join(os.tmpdir(), "qc-cli-"));
+        const env = { ...process.env, HOME: home };
+        try {
+            await exec("node", ["dist/cli/index.js", "ingest", "--provider", "kimi", "--text", "Weekly limit 16% used resets in 3d"], { env });
+            const { stdout } = await exec("node", ["dist/cli/index.js", "status"], { env });
+            expect(stdout).toMatch(/\| Provider \| Used \| Remaining \| Resets \| Days left \|/);
+            expect(stdout).toMatch(/\| kimi \| 16% \| 84% \|/);
+        }
+        finally {
+            fs.rmSync(home, { recursive: true, force: true });
+        }
+    }, 10000);
 });

package/dist/tests/format/table.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/format/table.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect } from "vitest";
+import { renderQuotasTable } from "../../src/format/table.js";
+describe("format table", () => {
+    it("renders a markdown table with one row per provider", () => {
+        const quotas = [
+            { provider: "kimi", usedPct: 16, resetsAt: "2026-09-01T09:02:00+10:00" },
+            { provider: "claude", usedPct: 37, resetsAt: "2026-09-03T21:00:00+10:00" },
+        ];
+        const advisories = [
+            { provider: "kimi", wastePct: 78.0, daysLeft: 3.0, idealRate: 28.0, burnRate: 40, burnMeasured: true, status: "at risk" },
+            { provider: "claude", wastePct: 52.9, daysLeft: 5.5, idealRate: 11.6, burnRate: 2, burnMeasured: false, status: "on track" },
+        ];
+        const table = renderQuotasTable(quotas, advisories);
+        expect(table).toMatch(/\| Provider \| Used \| Remaining \| Resets \| Days left \| Ideal daily burn \| Burn rate \| Status \| Waste if unused \|/);
+        expect(table).toMatch(/\| kimi \| 16% \| 84% \|.*\| 3.0 \| 28%\/day \| 40.0%\/day \| ⚠️ \| 78% \|/);
+        expect(table).toMatch(/\| claude \| 37% \| 63% \|.*\| 5.5 \| 12%\/day \| collecting… \| ✅ \| 53% \|/);
+    });
+    it("renders quota-only rows with placeholders when no advisories exist", () => {
+        const quotas = [{ provider: "kimi", usedPct: 16, resetsAt: "2026-09-01T09:02:00+10:00" }];
+        const table = renderQuotasTable(quotas, []);
+        expect(table).toMatch(/\| kimi \| 16% \| 84% \|.*\| — \| — \| — \| — \| — \|/);
+    });
+});

package/dist/tests/mcp/quotas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/mcp/quotas.test.js

@@ -0,0 +1,24 @@
+import { describe, it, expect } from "vitest";
+import { handleTool } from "../../src/mcp/server.js";
+import { buildApp } from "../../src/http/server.js";
+import { openDb, migrate } from "../../src/store/db.js";
+import { upsertQuota } from "../../src/store/quotas.js";
+describe("mcp get_quotas", () => {
+    it("renders the shared table for quota status", async () => {
+        const db = openDb(":memory:");
+        migrate(db);
+        upsertQuota(db, { provider: "claude", plan: "max", usedPct: 40, resetsAt: "2026-09-03T21:00:00+10:00", periodStart: "2026-08-26T00:00:00Z", raw: "x", source: "cli", fetchedAt: new Date().toISOString() });
+        const app = buildApp(db);
+        const addr = await app.listen({ port: 0, host: "127.0.0.1" });
+        process.env.QUOTACAP_URL = addr;
+        try {
+            const res = await handleTool("get_quotas", {});
+            expect(res.content[0].text).toMatch(/\| Provider \| Used \| Remaining \| Resets \| Days left \|/);
+            expect(res.content[0].text).toMatch(/\| claude \| 40% \| 60% \|/);
+        }
+        finally {
+            delete process.env.QUOTACAP_URL;
+            await app.close();
+        }
+    });
+});

package/dist/tests/mcp/server.test.js

@@ -1,25 +1,7 @@
 import { describe, it, expect } from "vitest";
-import { tools, recommendationTable } from "../../src/mcp/server.js";
+import { tools } from "../../src/mcp/server.js";
 describe("mcp", () => {
     it("exposes three tools", () => {
         expect(tools.map(t => t.name)).toEqual(expect.arrayContaining(["get_quotas", "get_recommendation", "forecast"]));
     });
-    it("renders a markdown table with one row per provider", () => {
-        const rec = {
-            use: "kimi",
-            reason: "78% waste in 3.0d",
-            alternatives: [
-                { provider: "kimi", usedPct: 16, resetsAt: "2026-09-01T09:02:00+10:00" },
-                { provider: "claude", usedPct: 37, resetsAt: "2026-09-03T21:00:00+10:00" },
-            ],
-            advisories: [
-                { provider: "kimi", wastePct: 78.0, daysLeft: 3.0, idealRate: 28.0 },
-                { provider: "claude", wastePct: 52.9, daysLeft: 5.5, idealRate: 11.6 },
-            ],
-        };
-        const table = recommendationTable(rec);
-        expect(table).toMatch(/\| Provider \| Used \| Remaining \| Resets \| Days left \| Ideal daily burn \| Waste if unused \|/);
-        expect(table).toMatch(/\| kimi \| 16% \| 84% \|.*\| 3.0 \| 28%\/day \| 78% \|/);
-        expect(table).toMatch(/\| claude \| 37% \| 63% \|.*\| 5.5 \| 12%\/day \| 53% \|/);
-    });
 });

package/dist/tests/store/db.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect } from "vitest";
 import { openDb, migrate } from "../../src/store/db.js";
-import { upsertQuota, getLatestByProvider } from "../../src/store/quotas.js";
+import { upsertQuota, getLatestByProvider, getBurnRates } from "../../src/store/quotas.js";
 describe("store", () => {
     it("migrates and upserts", async () => {
         const db = openDb(":memory:");
@@ -10,4 +10,21 @@ describe("store", () => {
         const got = getLatestByProvider(db, "claude");
         expect(got?.usedPct).toBe(25);
     });
+    it("measures burn rate from snapshot history", () => {
+        const db = openDb(":memory:");
+        migrate(db);
+        db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES('2026-08-26','claude',35)`).run();
+        db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES('2026-08-28','claude',40)`).run();
+        db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES('2026-08-28','kimi',16)`).run();
+        const rates = getBurnRates(db);
+        expect(rates.get("claude")).toBeCloseTo(2.5, 5);
+        expect(rates.has("kimi")).toBe(false);
+    });
+    it("skips a burn measurement across a reset (usage went down)", () => {
+        const db = openDb(":memory:");
+        migrate(db);
+        db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES('2026-08-26','claude',40)`).run();
+        db.prepare(`INSERT INTO snapshots(day, provider, used_pct) VALUES('2026-08-28','claude',16)`).run();
+        expect(getBurnRates(db).has("claude")).toBe(false);
+    });
 });

package/dist/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.9";

package/dist/web/src/App.js

@@ -42,19 +42,21 @@ function App() {
         advisoriesByProvider.set(a.provider, a);
     const hasStale = sorted.some((q) => q.stale ?? (q.fetchedAt ? Date.now() - new Date(q.fetchedAt).getTime() > 60 * 60 * 1000 : false));
     const isDegraded = !!fetchError || (quotas.length === 0 && !rec);
-    return (_jsxs("div", { style: { fontFamily: "system-ui", padding: 16, maxWidth: 900, margin: "0 auto" }, children: [_jsx("h1", { style: { fontSize: 20, margin: "0 0 12px" }, children: "QuotaCap" }), _jsx(Banner, { rec: rec }), isDegraded && (_jsxs("div", { "data-testid": "error-banner", style: { background: "#fecaca", padding: 10, borderRadius: 8, marginBottom: 12, fontSize: 13 }, children: ["no fresh data", lastPollAt ? `, last ${new Date(lastPollAt).toLocaleString()}` : "", " \u2014 check network/daemon", fetchError ? `: ${fetchError}` : ""] })), hasStale && (_jsxs("div", { "data-testid": "stale-banner", style: { background: "#ffedd5", padding: 8, borderRadius: 8, marginBottom: 12, fontSize: 12 }, children: ["some quotas stale \u2014 ", _jsx("button", { onClick: () => fetch("/api/refresh", { method: "POST" }).then(() => location.reload()), style: { border: "1px solid #d1d5db", background: "#fff", borderRadius: 4, padding: "2px 6px", cursor: "pointer" }, children: "Refresh now" })] })), _jsxs("div", { "data-testid": "strip", style: { display: "flex", gap: 8, margin: "12px 0", overflowX: "auto", alignItems: "center" }, children: [_jsx("span", { style: { color: "#2563eb", fontWeight: 700 }, children: "NOW" }), sorted.map((q) => (_jsxs("span", { style: { border: "1px solid #d1d5db", borderRadius: 999, padding: "4px 10px", whiteSpace: "nowrap", background: "#fff" }, children: [q.provider, " ", formatReset(q.resetsAt)] }, q.provider))), sorted.length === 0 && _jsx("span", { style: { color: "#9ca3af" }, children: "no quotas yet" })] }), _jsxs("table", { style: { width: "100%", borderCollapse: "collapse", fontSize: 14 }, children: [_jsx("thead", { children: _jsxs("tr", { style: { textAlign: "left", borderBottom: "2px solid #e5e7eb" }, children: [_jsx("th", { style: { padding: "8px 6px" }, children: "Provider" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Quota" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Rate" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Ideal" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Advice" }), _jsx("th", { style: { padding: "8px 6px" } })] }) }), _jsxs("tbody", { children: [sorted.map((q) => {
+    return (_jsxs("div", { style: { fontFamily: "system-ui", padding: 16, maxWidth: 900, margin: "0 auto" }, children: [_jsx("h1", { style: { fontSize: 20, margin: "0 0 12px" }, children: "QuotaCap" }), _jsx(Banner, { rec: rec }), isDegraded && (_jsxs("div", { "data-testid": "error-banner", style: { background: "#fecaca", padding: 10, borderRadius: 8, marginBottom: 12, fontSize: 13 }, children: ["no fresh data", lastPollAt ? `, last ${new Date(lastPollAt).toLocaleString()}` : "", " \u2014 check network/daemon", fetchError ? `: ${fetchError}` : ""] })), hasStale && (_jsxs("div", { "data-testid": "stale-banner", style: { background: "#ffedd5", padding: 8, borderRadius: 8, marginBottom: 12, fontSize: 12 }, children: ["some quotas stale \u2014 ", _jsx("button", { onClick: () => fetch("/api/refresh", { method: "POST" }).then(() => location.reload()), style: { border: "1px solid #d1d5db", background: "#fff", borderRadius: 4, padding: "2px 6px", cursor: "pointer" }, children: "Refresh now" })] })), _jsxs("div", { "data-testid": "strip", style: { display: "flex", gap: 8, margin: "12px 0", overflowX: "auto", alignItems: "center" }, children: [_jsx("span", { style: { color: "#2563eb", fontWeight: 700 }, children: "NOW" }), sorted.map((q) => (_jsxs("span", { style: { border: "1px solid #d1d5db", borderRadius: 999, padding: "4px 10px", whiteSpace: "nowrap", background: "#fff" }, children: [q.provider, " ", formatReset(q.resetsAt)] }, q.provider))), sorted.length === 0 && _jsx("span", { style: { color: "#9ca3af" }, children: "no quotas yet" })] }), _jsxs("table", { style: { width: "100%", borderCollapse: "collapse", fontSize: 14 }, children: [_jsx("thead", { children: _jsxs("tr", { style: { textAlign: "left", borderBottom: "2px solid #e5e7eb" }, children: [_jsx("th", { style: { padding: "8px 6px" }, children: "Provider" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Quota" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Remaining" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Resets" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Days left" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Ideal" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Rate" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Status" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Waste" }), _jsx("th", { style: { padding: "8px 6px" }, children: "Advice" }), _jsx("th", { style: { padding: "8px 6px" } })] }) }), _jsxs("tbody", { children: [sorted.map((q) => {
                                 const adv = advisoriesByProvider.get(q.provider);
                                 const waste = adv?.wastePct ?? 0;
                                 const ideal = adv?.idealRate;
                                 const burn = adv?.burnRate;
+                                const burnMeasured = adv?.burnMeasured;
                                 const urgency = adv?.urgency ?? "";
+                                const status = adv?.status ?? "on track";
                                 const isExpanded = expanded === q.provider;
                                 const isStale = q.stale ?? (q.fetchedAt ? Date.now() - new Date(q.fetchedAt).getTime() > 60 * 60 * 1000 : false);
                                 return (_jsxs(React.Fragment, { children: [_jsxs("tr", { style: { background: waste > 30 ? "#fff7ed" : isStale ? "#fffbeb" : undefined, borderBottom: "1px solid #f3f4f6" }, children: [_jsxs("td", { style: { padding: "8px 6px", fontWeight: 600 }, children: [q.provider, " ", isStale && _jsx("span", { style: { background: "#f59e0b", color: "#fff", fontSize: 10, padding: "2px 4px", borderRadius: 4, marginLeft: 6 }, children: "stale" })] }), _jsx("td", { style: { padding: "8px 6px" }, children: _jsxs("div", { style: { display: "flex", alignItems: "center", gap: 8 }, children: [_jsx("div", { style: { width: 80, height: 8, background: "#e5e7eb", borderRadius: 4, overflow: "hidden" }, children: _jsx("div", { style: {
                                                                         width: `${Math.min(100, q.usedPct)}%`,
                                                                         height: "100%",
                                                                         background: waste > 30 ? "#f59e0b" : "#3b82f6",
-                                                                    } }) }), _jsxs("span", { children: [q.usedPct, "%"] })] }) }), _jsx("td", { style: { padding: "8px 6px" }, children: burn != null ? `${burn.toFixed(1)}%/d` : "— collecting…" }), _jsx("td", { style: { padding: "8px 6px" }, children: ideal != null ? `${ideal.toFixed(1)}%/d` : "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: urgency || "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: _jsx("button", { "aria-label": `expand ${q.provider}`, onClick: () => setExpanded(isExpanded ? null : q.provider), style: { cursor: "pointer", border: "1px solid #d1d5db", background: "#fff", borderRadius: 4, padding: "2px 6px" }, children: isExpanded ? "▼" : "▶" }) })] }), isExpanded && (_jsx("tr", { children: _jsx("td", { colSpan: 6, style: { padding: 0 }, children: _jsxs("div", { style: { padding: 12, background: "#f9fafb", borderTop: "1px solid #e5e7eb" }, children: [_jsxs("div", { style: { position: "relative", height: 24, background: "#e5e7eb", borderRadius: 4, overflow: "hidden", marginBottom: 8 }, children: [_jsx("div", { style: {
+                                                                    } }) }), _jsxs("span", { children: [q.usedPct, "%"] })] }) }), _jsxs("td", { style: { padding: "8px 6px" }, children: [100 - q.usedPct, "%"] }), _jsx("td", { style: { padding: "8px 6px" }, children: formatReset(q.resetsAt) }), _jsx("td", { style: { padding: "8px 6px" }, children: adv?.daysLeft != null ? adv.daysLeft.toFixed(1) : "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: ideal != null ? `${ideal.toFixed(1)}%/d` : "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: burn != null ? (burnMeasured ? `${burn.toFixed(1)}%/d` : "collecting…") : "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: status === "at risk" ? "⚠️ at risk" : "✅ on track" }), _jsx("td", { style: { padding: "8px 6px" }, children: adv?.wastePct != null ? `${Math.round(adv.wastePct)}%` : "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: urgency || "—" }), _jsx("td", { style: { padding: "8px 6px" }, children: _jsx("button", { "aria-label": `expand ${q.provider}`, onClick: () => setExpanded(isExpanded ? null : q.provider), style: { cursor: "pointer", border: "1px solid #d1d5db", background: "#fff", borderRadius: 4, padding: "2px 6px" }, children: isExpanded ? "▼" : "▶" }) })] }), isExpanded && (_jsx("tr", { children: _jsx("td", { colSpan: 6, style: { padding: 0 }, children: _jsxs("div", { style: { padding: 12, background: "#f9fafb", borderTop: "1px solid #e5e7eb" }, children: [_jsxs("div", { style: { position: "relative", height: 24, background: "#e5e7eb", borderRadius: 4, overflow: "hidden", marginBottom: 8 }, children: [_jsx("div", { style: {
                                                                         position: "absolute",
                                                                         left: "10%",
                                                                         top: 0,