quotacap 0.0.7 → 0.0.9

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/cli/index.js

@@ -17,12 +17,16 @@ program.command("status").option("--json", "json").action(async (opts) => {
     ensureDbDir();
     const db = openDb(getDbPath());
     migrate(db);
-    const { getAllLatest } = await import("../store/quotas.js");
+    const { getAllLatest, getBurnRates } = await import("../store/quotas.js");
     const quotas = getAllLatest(db);
     if (opts.json)
         console.log(JSON.stringify(quotas, null, 2));
-    else
-        console.table(quotas);
+    else {
+        const { recommend } = await import("../advisory/engine.js");
+        const { renderQuotasTable } = await import("../format/table.js");
+        const rec = quotas.length ? recommend(quotas, "any", getBurnRates(db)) : null;
+        console.log(rec ? renderQuotasTable(quotas, rec.advisories) : "no quotas yet — run quotacap ingest or start the daemon");
+    }
 });
 program.command("advise").option("--json", "json").option("--task <t>", "task", "any").action(async (opts) => {
     ensureDbDir();

package/dist/format/table.d.ts

@@ -0,0 +1 @@
+export declare function renderQuotasTable(quotas: any[], advisories?: any[]): string;

package/dist/format/table.js

@@ -0,0 +1,21 @@
+// The one table every surface renders: MCP tools, CLI status, web dashboard.
+// Quotas carry used/resets; advisories add days-left, burn and waste analysis.
+// Without advisories the analysis columns render as placeholders.
+export function renderQuotasTable(quotas, advisories = []) {
+    const rows = quotas.map((q) => {
+        const a = advisories.find((x) => x.provider === q.provider);
+        const used = Math.round(q.usedPct ?? 0);
+        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` : "—";
+        const burn = a?.burnMeasured ? `${a.burnRate.toFixed(1)}%/day` : a != null ? "collecting…" : "—";
+        const icon = a?.status === "at risk" ? "⚠️" : a != null ? "✅" : "—";
+        const waste = a?.wastePct != null ? `${Math.round(a.wastePct)}%` : "—";
+        return `| ${q.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${burn} | ${icon} | ${waste} |`;
+    });
+    return [
+        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Burn rate | Status | Waste if unused |",
+        "|---|---|---|---|---|---|---|---|---|",
+        ...rows,
+    ].join("\n");
+}

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.d.ts

@@ -37,6 +37,16 @@ export declare const tools: ({
         required: string[];
     };
 })[];
-export declare function recommendationTable(rec: any): string;
-export declare function handleTool(name: string, args: any): Promise<any>;
+export declare function handleTool(name: string, args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    quota?: undefined;
+    advisory?: undefined;
+} | {
+    quota: any;
+    advisory: any;
+    content?: undefined;
+}>;
 export declare function runMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -1,3 +1,4 @@
+import { renderQuotasTable } from "../format/table.js";
 export const tools = [
     { name: "get_quotas", description: "All quotas with resets and health", inputSchema: { type: "object", properties: {}, required: [] } },
     { name: "get_recommendation", description: "Which provider to use next", inputSchema: { type: "object", properties: { task: { type: "string", enum: ["any", "heavy", "light"] } } } },
@@ -16,27 +17,16 @@ async function fetchJson(path) {
         throw new Error(`daemon not running, run quotacap web — ${e?.message ?? String(e)}`);
     }
 }
-export function recommendationTable(rec) {
-    const rows = (rec.advisories ?? []).map((a) => {
-        const q = (rec.alternatives ?? []).find((x) => x.provider === a.provider);
-        const used = Math.round(q?.usedPct ?? 0);
-        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)}% |`;
-    });
-    return [
-        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Waste if unused |",
-        "|---|---|---|---|---|---|---|",
-        ...rows,
-    ].join("\n");
-}
 export async function handleTool(name, args) {
-    if (name === "get_quotas")
-        return fetchJson("/api/quotas");
+    if (name === "get_quotas") {
+        const [quotas, rec] = await Promise.all([fetchJson("/api/quotas"), fetchJson("/api/recommendation")]);
+        const table = renderQuotasTable(quotas, rec?.advisories ?? []);
+        const json = JSON.stringify(quotas, null, 2);
+        return { content: [{ type: "text", text: table }, { type: "text", text: json }] };
+    }
     if (name === "get_recommendation") {
         const rec = await fetchJson(`/api/recommendation?task=${args?.task ?? "any"}`);
-        const table = recommendationTable(rec);
+        const table = renderQuotasTable(rec.alternatives ?? [], rec.advisories ?? []);
         const json = JSON.stringify(rec, null, 2);
         return { content: [{ type: "text", text: table }, { type: "text", text: json }] };
     }

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/cli/index.js

@@ -17,12 +17,16 @@ program.command("status").option("--json", "json").action(async (opts) => {
     ensureDbDir();
     const db = openDb(getDbPath());
     migrate(db);
-    const { getAllLatest } = await import("../store/quotas.js");
+    const { getAllLatest, getBurnRates } = await import("../store/quotas.js");
     const quotas = getAllLatest(db);
     if (opts.json)
         console.log(JSON.stringify(quotas, null, 2));
-    else
-        console.table(quotas);
+    else {
+        const { recommend } = await import("../advisory/engine.js");
+        const { renderQuotasTable } = await import("../format/table.js");
+        const rec = quotas.length ? recommend(quotas, "any", getBurnRates(db)) : null;
+        console.log(rec ? renderQuotasTable(quotas, rec.advisories) : "no quotas yet — run quotacap ingest or start the daemon");
+    }
 });
 program.command("advise").option("--json", "json").option("--task <t>", "task", "any").action(async (opts) => {
     ensureDbDir();

package/dist/src/format/table.d.ts

@@ -0,0 +1 @@
+export declare function renderQuotasTable(quotas: any[], advisories?: any[]): string;

package/dist/src/format/table.js

@@ -0,0 +1,21 @@
+// The one table every surface renders: MCP tools, CLI status, web dashboard.
+// Quotas carry used/resets; advisories add days-left, burn and waste analysis.
+// Without advisories the analysis columns render as placeholders.
+export function renderQuotasTable(quotas, advisories = []) {
+    const rows = quotas.map((q) => {
+        const a = advisories.find((x) => x.provider === q.provider);
+        const used = Math.round(q.usedPct ?? 0);
+        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` : "—";
+        const burn = a?.burnMeasured ? `${a.burnRate.toFixed(1)}%/day` : a != null ? "collecting…" : "—";
+        const icon = a?.status === "at risk" ? "⚠️" : a != null ? "✅" : "—";
+        const waste = a?.wastePct != null ? `${Math.round(a.wastePct)}%` : "—";
+        return `| ${q.provider} | ${used}% | ${100 - used}% | ${resets} | ${daysLeft} | ${ideal} | ${burn} | ${icon} | ${waste} |`;
+    });
+    return [
+        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Burn rate | Status | Waste if unused |",
+        "|---|---|---|---|---|---|---|---|---|",
+        ...rows,
+    ].join("\n");
+}

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.d.ts

@@ -37,6 +37,16 @@ export declare const tools: ({
         required: string[];
     };
 })[];
-export declare function recommendationTable(rec: any): string;
-export declare function handleTool(name: string, args: any): Promise<any>;
+export declare function handleTool(name: string, args: any): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    quota?: undefined;
+    advisory?: undefined;
+} | {
+    quota: any;
+    advisory: any;
+    content?: undefined;
+}>;
 export declare function runMcpServer(): Promise<void>;

package/dist/src/mcp/server.js

@@ -1,3 +1,4 @@
+import { renderQuotasTable } from "../format/table.js";
 export const tools = [
     { name: "get_quotas", description: "All quotas with resets and health", inputSchema: { type: "object", properties: {}, required: [] } },
     { name: "get_recommendation", description: "Which provider to use next", inputSchema: { type: "object", properties: { task: { type: "string", enum: ["any", "heavy", "light"] } } } },
@@ -16,27 +17,16 @@ async function fetchJson(path) {
         throw new Error(`daemon not running, run quotacap web — ${e?.message ?? String(e)}`);
     }
 }
-export function recommendationTable(rec) {
-    const rows = (rec.advisories ?? []).map((a) => {
-        const q = (rec.alternatives ?? []).find((x) => x.provider === a.provider);
-        const used = Math.round(q?.usedPct ?? 0);
-        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)}% |`;
-    });
-    return [
-        "| Provider | Used | Remaining | Resets | Days left | Ideal daily burn | Waste if unused |",
-        "|---|---|---|---|---|---|---|",
-        ...rows,
-    ].join("\n");
-}
 export async function handleTool(name, args) {
-    if (name === "get_quotas")
-        return fetchJson("/api/quotas");
+    if (name === "get_quotas") {
+        const [quotas, rec] = await Promise.all([fetchJson("/api/quotas"), fetchJson("/api/recommendation")]);
+        const table = renderQuotasTable(quotas, rec?.advisories ?? []);
+        const json = JSON.stringify(quotas, null, 2);
+        return { content: [{ type: "text", text: table }, { type: "text", text: json }] };
+    }
     if (name === "get_recommendation") {
         const rec = await fetchJson(`/api/recommendation?task=${args?.task ?? "any"}`);
-        const table = recommendationTable(rec);
+        const table = renderQuotasTable(rec.alternatives ?? [], rec.advisories ?? []);
         const json = JSON.stringify(rec, null, 2);
         return { content: [{ type: "text", text: table }, { type: "text", text: json }] };
     }

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