estela 0.1.39 → 0.1.40

package/README.md

@@ -189,6 +189,35 @@ different machine, pass `--token` with the existing one, or your client ends up
 with a dead link. The Free plan allows one published dashboard at a time; Pro
 and Teams have no limit.
 
+The dashboard's footer says "Hours filled in by Estela", linking to
+getestela.dev. On Pro and Teams, `--no-credit` removes that line.
+
+## Showing what you built
+
+A badge for your project's README, with its measured hours and what the AI
+cost:
+
+```sh
+estela badge                     # the project for the repo you're in
+estela badge --project acme-web
+```
+
+It prints a Markdown line with a static [shields.io](https://shields.io) image,
+something like `Built in 42 h · $18 of AI`. Nothing is hosted and nothing is
+looked up: the numbers are baked into the URL, so run it again to update them.
+It only counts **measured** hours, never the ones estimated from commits.
+
+And a receipt of your week (or of your whole history) as a PNG:
+
+```sh
+estela receipt --week
+```
+
+Measured versus estimated hours, the AI cost, what caching saved you, and the
+most expensive project and branch. It's drawn on your machine and stays there.
+Project and branch names are left out by default, because they're usually a
+client's; add `--names` to include them.
+
 ## What the AI actually costs
 
 On a flat subscription, your real spend isn't the sum of the tokens: it's the
@@ -202,6 +231,30 @@ estela ai-cost
 Cache is counted separately because it's usually most of the bill — ignoring it
 underestimated spend fivefold.
 
+## Which project is eating your quota
+
+On Claude Max/Pro or Codex with a subscription, the quota runs out before you
+expect it and nothing tells you where it went. `estela quota` splits it by
+project:
+
+```sh
+estela quota          # current 5-hour window and this week, per project
+estela quota --json   # the same, for scripts
+```
+
+Tokens (input, output, cache read and cache write) per project, for the current
+5-hour window and for this week (Monday to today, in your time zone), plus this
+week against the average of your previous 4 over the same stretch. Claude Code
+and Codex are shown separately: they draw on different quotas. It's also a card
+in the Summary tab of `estela web`, and it's free.
+
+What it never does is tell you how much you have left: Anthropic and OpenAI
+don't publish their plans' limits, so any "X tokens left" would be made up. The
+5-hour window is an estimate — how its start is rounded isn't public, and
+anything you use on claude.ai or another machine counts too but isn't on this
+one. Copilot is left out because it doesn't record reliable tokens. Everything
+is calculated on your machine.
+
 ## Hours no import will infer
 
 Meetings, travel, research, and development without an agent that didn't leave

package/dist/cli-quota.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-quota.test.d.ts.map

package/dist/cli-quota.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-quota.test.d.ts","sourceRoot":"","sources":["../src/cli-quota.test.ts"],"names":[],"mappings":""}

package/dist/cli-quota.test.js

@@ -0,0 +1,216 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_test_1 = require("node:test");
+const schema_js_1 = require("./db/schema.js");
+const store = __importStar(require("./db/store.js"));
+const quota_js_1 = require("./metrics/quota.js");
+/**
+ * `estela quota`, ejecutando la CLI de verdad.
+ *
+ * Cada prueba corre con un HOME temporal: el refresco lee los transcripts de
+ * ~/.claude, y un test no puede ni leer los de quien lo ejecuta ni depender de
+ * que existan.
+ */
+const BIN = (0, node_path_1.join)(__dirname, "bin.js");
+function estela(home, lang, ...args) {
+    const r = (0, node_child_process_1.spawnSync)(process.execPath, [BIN, ...args], {
+        encoding: "utf8",
+        env: { ...process.env, HOME: home, USERPROFILE: home, ESTELA_LANG: lang, NO_COLOR: "1" },
+    });
+    return { code: r.status, out: r.stdout, err: r.stderr };
+}
+/**
+ * Datos fijos para la cuota, válidos a cualquier hora de cualquier día.
+ *
+ * No sirve la demo: pone las sesiones de Codex por la tarde, y un lunes por
+ * la mañana la semana aún no tiene ninguna — estos tests fallaban según el
+ * momento en que se ejecutaran. Aquí todo cae a mitad de camino entre el
+ * lunes a las 00:00 y ahora, que siempre es esta semana.
+ */
+function sembrarCuota(dbPath) {
+    const ahora = new Date();
+    const lunes = (0, quota_js_1.weekStart)(ahora);
+    const enEstaSemana = new Date((lunes.getTime() + ahora.getTime()) / 2);
+    const haceSemanas = (n) => new Date(lunes.getTime() - n * 7 * 86_400_000 + 3600_000);
+    let n = 0;
+    const t = (agent, at, repo, cacheRead) => ({
+        agent, turnId: `q${n++}`, sessionId: "s", at, model: "m", repoPath: repo, branch: "main",
+        tokens: { input: 1, output: 10, cacheRead, cacheWrite5m: 0, cacheWrite1h: 0 }, producerVersion: null,
+    });
+    const db = (0, schema_js_1.openDatabase)(dbPath);
+    try {
+        store.upsertClient(db, { id: "c", name: "C", currency: "EUR" });
+        for (const id of ["web", "api"]) {
+            store.upsertProject(db, { id, clientId: "c", name: id, repoPaths: [`/repos/${id}`], billable: true,
+                roundingMinutes: 0, aiCostPolicy: "absorbed", kind: "client" });
+        }
+        store.saveTurns(db, [
+            // Claude Code: seis semanas de historial, así que compara.
+            t("claude-code", haceSemanas(6), "/repos/web", 100),
+            t("claude-code", enEstaSemana, "/repos/web", 3000),
+            t("claude-code", enEstaSemana, "/repos/api", 1000),
+            // Codex: empezó esta semana, así que no hay con qué comparar.
+            t("codex", enEstaSemana, "/repos/api", 500),
+        ]);
+    }
+    finally {
+        db.close();
+    }
+}
+function entorno() {
+    const home = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "estela-quota-"));
+    return { home, db: (0, node_path_1.join)(home, "estela.db") };
+}
+/** Un transcript de Claude Code con un turno de hace media hora, en `cwd`. */
+function transcript(home, cwd, id, cacheRead) {
+    const dir = (0, node_path_1.join)(home, ".claude", "projects", "-proyecto");
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const at = new Date(Date.now() - 30 * 60_000).toISOString();
+    const linea = JSON.stringify({
+        type: "assistant", timestamp: at, cwd, gitBranch: "main", version: "2.1.238", sessionId: "s1",
+        message: { id, model: "claude-sonnet-4-6",
+            usage: { input_tokens: 10, output_tokens: 100, cache_read_input_tokens: cacheRead,
+                cache_creation_input_tokens: 0 } },
+    });
+    // Dos veces la misma fila: Claude Code repite el turno en el transcript.
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, "sesion.jsonl"), `${linea}\n${linea}\n`);
+}
+(0, node_test_1.test)("sin nada guardado, lo dice y sugiere setup en vez de enseñar una tabla vacía", () => {
+    const { home, db } = entorno();
+    const r = estela(home, "es", "quota", "--db", db, "--no-refresh");
+    strict_1.default.equal(r.code, 0, r.err);
+    strict_1.default.match(r.out, /Sin turnos de agente guardados\. Empieza con: estela setup/);
+    strict_1.default.match(r.out, /no es el límite de tu plan/);
+});
+(0, node_test_1.test)("refresca los transcripts de esta semana antes de calcular, y un turno repetido cuenta una vez", () => {
+    const { home, db } = entorno();
+    transcript(home, "/repos/web", "msg_cuota_1", 5000);
+    const r = estela(home, "es", "quota", "--db", db, "--json");
+    strict_1.default.equal(r.code, 0, r.err);
+    const j = JSON.parse(r.out);
+    strict_1.default.equal(j.agents[0].agent, "claude-code");
+    // 10 + 100 + 5000, una sola vez aunque el transcript traiga la fila dos veces.
+    strict_1.default.equal(j.agents[0].week.total.total, 5110);
+    // Repetirlo no duplica: el turno ya está guardado.
+    const otra = JSON.parse(estela(home, "es", "quota", "--db", db, "--json").out);
+    strict_1.default.equal(otra.agents[0].week.total.total, 5110);
+});
+(0, node_test_1.test)("--no-refresh no lee transcripts: usa solo lo ya guardado", () => {
+    const { home, db } = entorno();
+    transcript(home, "/repos/web", "msg_cuota_2", 5000);
+    const r = estela(home, "es", "quota", "--db", db, "--no-refresh", "--json");
+    strict_1.default.equal(r.code, 0, r.err);
+    strict_1.default.deepEqual(JSON.parse(r.out).agents, []);
+});
+(0, node_test_1.test)("sobre la base de la demo nunca lee tus transcripts, aunque no se pase --no-refresh", () => {
+    // Mezclaría tu trabajo real con los datos inventados, justo lo que la demo
+    // promete no hacer.
+    const { home } = entorno();
+    const demo = (0, node_path_1.join)(home, "estela-demo.db");
+    (0, schema_js_1.openDatabase)(demo).close();
+    transcript(home, "/repos/web", "msg_real", 5000);
+    const r = estela(home, "es", "quota", "--db", demo, "--json");
+    strict_1.default.equal(r.code, 0, r.err);
+    const conn = (0, schema_js_1.openDatabase)(demo);
+    try {
+        strict_1.default.equal(store.firstTurnByAgent(conn).size, 0, "no se guardó ningún turno real en la demo");
+    }
+    finally {
+        conn.close();
+    }
+});
+(0, node_test_1.test)("--json es JSON y nada más: ni avisos ni cabeceras en la salida", () => {
+    const { home, db } = entorno();
+    sembrarCuota(db);
+    const r = estela(home, "es", "quota", "--db", db, "--no-refresh", "--json");
+    strict_1.default.equal(r.code, 0, r.err);
+    const j = JSON.parse(r.out);
+    strict_1.default.equal(j.windowIsEstimate, true);
+    strict_1.default.equal(j.windowHours, 5);
+    strict_1.default.deepEqual(j.agents.map((a) => a.agent), ["claude-code", "codex"]);
+    // Seis semanas de Claude Code y Codex recién empezado: uno compara, el otro no.
+    strict_1.default.equal(j.agents[0].comparison.status, "ok");
+    strict_1.default.equal(j.agents[1].comparison.status, "insufficient");
+    const shares = j.agents[0].week.projects.map((p) => p.share);
+    strict_1.default.ok(Math.abs(shares.reduce((s, x) => s + x, 0) - 1) < 0.001, "los porcentajes suman el 100 %");
+});
+(0, node_test_1.test)("la salida en texto, en los dos idiomas, sin promesas sobre lo que queda", () => {
+    const { home, db } = entorno();
+    sembrarCuota(db);
+    const es = estela(home, "es", "quota", "--db", db, "--no-refresh").out;
+    strict_1.default.match(es, /Claude Code — esta semana \(lun \d+ \w+ → hoy\)/);
+    strict_1.default.match(es, /Proyecto\s+Entrada\s+Salida\s+Lect\. caché\s+Escr\. caché\s+Total\s+%/);
+    strict_1.default.match(es, /Sin historial suficiente para comparar: hacen falta 4 semanas completas y hay \d\./);
+    strict_1.default.match(es, /La ventana de 5 h es una estimación/);
+    const en = estela(home, "en", "quota", "--db", db, "--no-refresh").out;
+    strict_1.default.match(en, /Claude Code — this week \(Mon \w+ \d+ → today\)/);
+    strict_1.default.match(en, /Project\s+Input\s+Output\s+Cache read\s+Cache write\s+Total\s+%/);
+    strict_1.default.match(en, /The 5-hour window is an estimate/);
+    // La regla que no se rompe: nada de "te quedan" ni de cuándo se acaba.
+    for (const out of [es, en]) {
+        strict_1.default.doesNotMatch(out, /te quedan|quedan \d|se te acaba|you have \d|left until|runs out/i);
+    }
+});
+(0, node_test_1.test)("Copilot queda fuera, y se dice en una línea", () => {
+    const { home, db } = entorno();
+    const conn = (0, schema_js_1.openDatabase)(db);
+    try {
+        store.saveTurns(conn, [{
+                agent: "copilot", turnId: "copilot:1:end", sessionId: "s", at: new Date(Date.now() - 60_000),
+                model: "gpt-4o", repoPath: "/repos/web", branch: null,
+                tokens: { input: 900, output: 100, cacheRead: 0, cacheWrite5m: 0, cacheWrite1h: 0 },
+                producerVersion: null,
+            }]);
+    }
+    finally {
+        conn.close();
+    }
+    const r = estela(home, "es", "quota", "--db", db, "--no-refresh");
+    strict_1.default.match(r.out, /Copilot no guarda tokens fiables y queda fuera de este cálculo\./);
+    strict_1.default.match(r.out, /Sin consumo de Claude Code ni Codex esta semana\./);
+    const j = JSON.parse(estela(home, "es", "quota", "--db", db, "--no-refresh", "--json").out);
+    strict_1.default.deepEqual(j.agents, []);
+    strict_1.default.deepEqual(j.excluded.map((e) => e.agent), ["copilot"]);
+});
+//# sourceMappingURL=cli-quota.test.js.map

package/dist/cli-quota.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-quota.test.js","sourceRoot":"","sources":["../src/cli-quota.test.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA6CA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAs/DpD,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA6CA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAsoEpD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/cli.js

@@ -75,6 +75,9 @@ const agents_js_1 = require("./watchers/agents.js");
 const git_js_1 = require("./watchers/git.js");
 const identity_js_1 = require("./watchers/identity.js");
 const index_js_1 = require("./i18n/index.js");
+const dates_js_1 = require("./export/dates.js");
+const quota_js_1 = require("./metrics/quota.js");
+const quota_js_2 = require("./quota.js");
 const labels_js_1 = require("./i18n/labels.js");
 const HELP_ES = `
 estela — registro de horas para desarrollo asistido por IA
@@ -143,6 +146,17 @@ estela — registro de horas para desarrollo asistido por IA
   estela entry link --entry <id> --items PROJ-12[,AB#1234] | --clear
         Pone a mano los tickets de un bloque. El import ya no los cambia.
   estela ai-cost                      Reparto de tu cuota entre proyectos.
+  estela quota [--json] [--no-refresh]
+        ¿Qué proyecto se come tu cuota de Claude Code o Codex? Tokens por
+        proyecto en la ventana de 5 h actual y en la semana (de lunes a
+        hoy), y esta semana frente a la media de tus 4 anteriores en el
+        mismo tramo. Solo consumo real: no dice cuánto te queda, porque
+        Anthropic y OpenAI no publican los límites. La ventana de 5 h es
+        una estimación: no se sabe cómo redondean su inicio, y lo que uses
+        en claude.ai u otro equipo también cuenta y Estela no lo ve.
+        Copilot queda fuera: no guarda tokens fiables. Antes de calcular
+        lee los transcripts desde el lunes (--no-refresh lo evita).
+        A diferencia de ai-cost, que reparte dinero, esto reparte tokens.
   estela badge [--project <id>]
         Badge para el README: horas medidas y coste de IA del proyecto.
         Sin --project, el del repositorio en el que estás.
@@ -302,6 +316,18 @@ estela — time tracking for AI-assisted development
   estela entry link --entry <id> --items PROJ-12[,AB#1234] | --clear
         Sets a block's tickets by hand. Imports won't change them anymore.
   estela ai-cost                      How your subscription splits across projects.
+  estela quota [--json] [--no-refresh]
+        Which project is eating your Claude Code or Codex quota? Tokens per
+        project in the current 5-hour window and this week (Monday to
+        today), and this week against the average of your previous 4 over
+        the same stretch. Real usage only: it never says how much you have
+        left, because Anthropic and OpenAI don't publish the limits. The
+        5-hour window is an estimate: how its start is rounded isn't public,
+        and anything you use on claude.ai or another machine also counts and
+        Estela can't see it. Copilot is left out: it doesn't record reliable
+        tokens. Before calculating it reads transcripts since Monday
+        (--no-refresh skips that). Unlike ai-cost, which splits money, this
+        splits tokens.
   estela badge [--project <id>]
         Badge for your README: the project's measured hours and AI cost.
         Without --project, the one for the repository you're in.
@@ -1910,6 +1936,115 @@ async function cmdBadge(args, dbPath) {
         db.close();
     }
 }
+/**
+ * `estela quota` — qué proyecto se come la cuota. El cálculo vive en
+ * `metrics/quota.ts`; aquí solo se presenta.
+ */
+async function cmdQuota(args, dbPath) {
+    const db = (0, schema_js_1.openDatabase)(dbPath);
+    try {
+        const now = new Date();
+        // Sobre la base de la demo no se lee nada tuyo: mezclaría tus turnos
+        // reales con los inventados, justo lo que la demo promete no hacer.
+        const esDemo = (0, node_path_1.basename)(dbPath) === "estela-demo.db";
+        if (args.flags["no-refresh"] !== true && !esDemo) {
+            try {
+                await (0, quota_js_2.refreshQuotaTurns)(db, (0, quota_js_1.weekStart)(now));
+            }
+            catch {
+                // Sin refrescar se sigue: lo guardado sigue valiendo, solo más viejo.
+                if (args.flags["json"] !== true)
+                    console.log((0, index_js_1.tr) `(No se pudieron leer los transcripts de esta semana; se usa lo ya guardado.)`);
+            }
+        }
+        const report = (0, quota_js_2.loadQuotaReport)(db, now);
+        if (args.flags["json"] === true) {
+            console.log(JSON.stringify((0, quota_js_1.quotaToJson)(report), null, 2));
+            return;
+        }
+        printQuota(report, store.firstTurnByAgent(db).size > 0);
+    }
+    finally {
+        db.close();
+    }
+}
+function printQuota(report, hayTurnos) {
+    console.log((0, index_js_1.tr) `\nConsumo de cuota · lo calcula Estela en tu máquina; no es el límite de tu plan\n`);
+    if (report.agents.length === 0) {
+        console.log(hayTurnos
+            ? (0, index_js_1.tr) `Sin consumo de Claude Code ni Codex esta semana.`
+            : (0, index_js_1.tr) `Sin turnos de agente guardados. Empieza con: estela setup`);
+    }
+    for (const a of report.agents) {
+        const nombre = agentName(a.agent);
+        if (a.window) {
+            console.log((0, index_js_1.tr) `${nombre} — ventana de 5 h actual (estimada): desde las ${hhmm(a.window.start)}, termina a las ${hhmm(a.window.end)}`);
+            printQuotaTable(a.window);
+        }
+        else if (a.lastWindowEnded) {
+            console.log((0, index_js_1.tr) `${nombre} — sin ventana de 5 h abierta ahora; la última terminó ${cuando(a.lastWindowEnded, report.generatedAt)}.\n`);
+        }
+        console.log((0, index_js_1.tr) `${nombre} — esta semana (${diaCorto(report.weekStart)} → hoy)`);
+        printQuotaTable(a.week);
+        console.log(`  ${comparacion(a, report.generatedAt)}\n`);
+    }
+    if (report.copilotExcluded)
+        console.log((0, index_js_1.tr) `Copilot no guarda tokens fiables y queda fuera de este cálculo.`);
+    console.log((0, index_js_1.tr) `La ventana de 5 h es una estimación: no se publica cómo se redondea su inicio, y lo que`);
+    console.log((0, index_js_1.tr) `uses en claude.ai u otro equipo también consume cuota y Estela no lo ve.`);
+}
+function printQuotaTable(b) {
+    const filas = b.rows.map((r) => [nombreDeFila(r.bucket), r.usage, pct(r.share)]);
+    const ancho = Math.min(28, Math.max((0, index_js_1.tr) `Proyecto`.length, (0, index_js_1.tr) `Total`.length, ...filas.map((f) => f[0].length)));
+    const cabeza = [(0, index_js_1.tr) `Entrada`, (0, index_js_1.tr) `Salida`, (0, index_js_1.tr) `Lect. caché`, (0, index_js_1.tr) `Escr. caché`, (0, index_js_1.tr) `Total`];
+    const col = Math.max(10, ...cabeza.map((c) => c.length + 2));
+    const celdas = (u) => [u.input, u.output, u.cacheRead, u.cacheWrite, u.total].map((n) => fmtTokens(n).padStart(col)).join("");
+    const nombre = (t) => (t.length > ancho ? t.slice(0, ancho - 1) + "…" : t).padEnd(ancho);
+    console.log(`  ${nombre((0, index_js_1.tr) `Proyecto`)}${cabeza.map((c) => c.padStart(col)).join("")}${"%".padStart(7)}`);
+    for (const [n, u, p] of filas)
+        console.log(`  ${nombre(n)}${celdas(u)}${p.padStart(7)}`);
+    console.log(`  ${nombre((0, index_js_1.tr) `Total`)}${celdas(b.total)}\n`);
+}
+function nombreDeFila(b) {
+    if (b.kind === "project")
+        return b.projectName;
+    if (b.kind === "folder")
+        return (0, index_js_1.tr) `sin proyecto · ${b.folder}`;
+    return (0, index_js_1.tr) `sin carpeta`;
+}
+function comparacion(a, now) {
+    const c = a.comparison;
+    if (c.status === "insufficient") {
+        return (0, index_js_1.tr) `Sin historial suficiente para comparar: hacen falta ${quota_js_1.HISTORY_WEEKS} semanas completas y hay ${c.completeWeeks}.`;
+    }
+    const tramo = (0, index_js_1.tr) `lunes → ${dates_js_1.DAYS[(0, index_js_1.getLang)()][now.getDay()]} ${hhmm(now)}`;
+    if (c.ratio === null) {
+        return (0, index_js_1.tr) `Frente a tu historial: ${fmtTokens(c.current)} esta semana; en el mismo tramo (${tramo}) de las ${c.weeks} semanas anteriores no hubo consumo.`;
+    }
+    const diff = Math.round((c.ratio - 1) * 100);
+    const cuanto = diff > 0 ? (0, index_js_1.tr) `un ${diff} % más` : diff < 0 ? (0, index_js_1.tr) `un ${-diff} % menos` : (0, index_js_1.tr) `lo mismo`;
+    return (0, index_js_1.tr) `Frente a tu historial: ${fmtTokens(c.current)} esta semana, y una media de ${fmtTokens(c.average)} en el mismo tramo (${tramo}) de las ${c.weeks} semanas anteriores: ${cuanto}.`;
+}
+/** Tokens con el formato corto del idioma: "22,7 M" o "22.7M". */
+function fmtTokens(n) {
+    return new Intl.NumberFormat((0, index_js_1.getLang)() === "en" ? "en-US" : "es-ES", { notation: "compact", maximumFractionDigits: 1 }).format(n);
+}
+function pct(share) {
+    return (0, index_js_1.tr) `${Math.round(share * 100)} %`;
+}
+function hhmm(d) {
+    return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+}
+/** "lun 5 oct" o "Mon Oct 5". */
+function diaCorto(d) {
+    const dia = dates_js_1.DAYS[(0, index_js_1.getLang)()][d.getDay()].slice(0, 3);
+    const mes = dates_js_1.MONTHS[(0, index_js_1.getLang)()][d.getMonth()].slice(0, 3);
+    return (0, index_js_1.getLang)() === "en" ? `${dia} ${mes} ${d.getDate()}` : `${dia} ${d.getDate()} ${mes}`;
+}
+/** "a las 14:00" si fue hoy; si no, con su día. */
+function cuando(d, now) {
+    return (0, shared_1.localDate)(d) === (0, shared_1.localDate)(now) ? (0, index_js_1.tr) `a las ${hhmm(d)}` : (0, index_js_1.tr) `el ${diaCorto(d)} a las ${hhmm(d)}`;
+}
 function cmdReceipt(args, dbPath) {
     const db = (0, schema_js_1.openDatabase)(dbPath);
     try {
@@ -2106,6 +2241,9 @@ async function main() {
         case "ai-cost":
             cmdAiCost(dbPath);
             break;
+        case "quota":
+            await cmdQuota(args, dbPath);
+            break;
         case "badge":
             await cmdBadge(args, dbPath);
             break;