estela 0.1.38 → 0.1.40

package/dist/cli.js

@@ -46,6 +46,8 @@ process.on("warning", (w) => {
 const shared_1 = require("@estela/shared");
 const node_fs_1 = require("node:fs");
 const amortize_js_1 = require("./billing/amortize.js");
+const badge_js_1 = require("./export/badge.js");
+const receipt_js_1 = require("./export/receipt.js");
 const invoice_js_1 = require("./billing/invoice.js");
 const sessionize_js_1 = require("./billing/sessionize.js");
 const schema_js_1 = require("./db/schema.js");
@@ -73,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
@@ -141,6 +146,25 @@ 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.
+  estela receipt [--week] [--names] [--out <fichero.png>]
+        Un recibo en PNG: horas medidas y estimadas, coste de IA, lo más
+        caro y lo que ahorró la caché. Con --week, los últimos 7 días.
+        Sin nombres de proyectos ni ramas salvo con --names. Se genera y
+        se queda en tu máquina.
   estela share --project <id> [--from YYYY-MM-DD] [--to YYYY-MM-DD]
                [--author <tu nombre>] [--with-amounts] [--out <fichero.html>]
         Informe compartible en un solo fichero HTML. Horas y commits; sin
@@ -148,12 +172,15 @@ estela — registro de horas para desarrollo asistido por IA
 
   estela publish --project <id> [--author <tu nombre>] [--with-amounts]
                  [--token <existente>] [--no-team] [--client <correo>[,otro]]
+                 [--no-credit]
         Panel de solo lectura para que tu cliente USE el producto, no solo
         reciba un documento. Se aloja en getestela.dev — Free permite uno a
         la vez, Pro y Teams sin límite. Necesita "estela login" antes.
         Con --client se le avisa por correo y le aparece en su cuenta al
         entrar en getestela.dev/app. Sin --client no se toca esa lista: tus
         republicaciones no desvinculan a quien ya lo tenía.
+        --no-credit quita la línea "Horas rellenadas por Estela" del pie
+        (Pro y Teams).
 
   estela team ai-cost --project <id> --allow | --deny
         Si quien te invitó pide ver el coste de IA del proyecto, esta es tu
@@ -289,6 +316,26 @@ 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.
+  estela receipt [--week] [--names] [--out <file.png>]
+        A PNG receipt: measured and estimated hours, AI cost, the most
+        expensive work and what caching saved. With --week, the last 7 days.
+        No project or branch names unless you pass --names. It's generated
+        and stays on your machine.
   estela share --project <id> [--from YYYY-MM-DD] [--to YYYY-MM-DD]
                [--author <your name>] [--with-amounts] [--out <file.html>]
         Shareable report in a single HTML file. Hours and commits; no AI
@@ -296,12 +343,15 @@ estela — time tracking for AI-assisted development
 
   estela publish --project <id> [--author <your name>] [--with-amounts]
                  [--token <existing>] [--no-team] [--client <email>[,other]]
+                 [--no-credit]
         Read-only dashboard so your client can USE the product, not just
         receive a document. Hosted on getestela.dev — Free allows one at a
         time, Pro and Teams have no limit. Requires "estela login" first.
         With --client they get an email and it shows up in their account
         when they sign in to getestela.dev/app. Without --client that list
         isn't touched: republishing never unlinks anyone who already had it.
+        --no-credit removes the "Hours filled in by Estela" line from the
+        footer (Pro and Teams).
 
   estela team ai-cost --project <id> --allow | --deny
         If whoever invited you asks to see the project's AI cost, this is
@@ -1281,6 +1331,7 @@ async function cmdPublish(args, dbPath) {
                 ...(clientes?.length ? { clients: clientes } : {}),
                 withAmounts: args.flags["with-amounts"] === true,
                 includeTeam: args.flags["no-team"] !== true,
+                hideCredit: args.flags["no-credit"] === true,
                 ...(explicitLang(args) ? { language: explicitLang(args) } : {}),
             });
         }
@@ -1820,6 +1871,214 @@ function cmdAiCost(dbPath) {
         db.close();
     }
 }
+/**
+ * El proyecto de un comando: el de --project, o el del repositorio en el que
+ * se está. Es lo natural para lo que se pega en el README de ese repositorio.
+ */
+async function projectFromArgsOrCwd(args, db) {
+    const explicit = str(args, "project");
+    if (explicit) {
+        if (!store.getProject(db, explicit))
+            throw new UserError((0, index_js_1.tr) `No existe el proyecto "${explicit}".`);
+        return explicit;
+    }
+    const root = await (0, git_js_1.repoRoot)(process.cwd());
+    const id = root ? store.projectForRepo(db, root) : null;
+    if (!id)
+        throw new UserError((0, index_js_1.tr) `Este directorio no es de ningún proyecto. Indica cuál con --project <id>.`);
+    return id;
+}
+/**
+ * Lo que costó la IA de un proyecto, en dinero de verdad si se puede.
+ *
+ * Con una cuota registrada, es su reparto (lo que se pagó); sin ella, la
+ * tarifa API equivalente, que es lo que valdría ese uso y así se marca. Los
+ * meses sin cuota vigente no suman: ahí no hay reparto que hacer. `months`
+ * limita a esos meses; sin él, cuenta toda la historia del proyecto.
+ */
+function projectAiCost(db, projectId, entries, months) {
+    const subs = store.listSubscriptions(db);
+    if (subs.length) {
+        const shares = (0, amortize_js_1.amortize)(store.consumptionByProjectMonth(db), subs, store.totalConsumptionByMonth(db))
+            .filter((sh) => sh.projectId === projectId && (0, amortize_js_1.feeForMonth)(subs, sh.month) !== null &&
+            (!months || months.includes(sh.month)));
+        if (shares.length) {
+            const currency = shares[0].amount.currency;
+            return { money: { amount: shares.reduce((n, sh) => n + sh.amount.amount, 0), currency }, api: false };
+        }
+    }
+    const micro = entries.reduce((n, e) => n + e.aiCost.microUsd, 0);
+    if (micro === 0)
+        return null;
+    return { money: { amount: Math.round(micro / 10_000), currency: "USD" }, api: true };
+}
+async function cmdBadge(args, dbPath) {
+    const db = (0, schema_js_1.openDatabase)(dbPath);
+    try {
+        const projectId = await projectFromArgsOrCwd(args, db);
+        const entries = store.getTimeEntries(db, projectId);
+        const measuredSeconds = entries.filter((e) => e.source === "agent").reduce((n, e) => n + e.seconds, 0);
+        if (measuredSeconds === 0) {
+            throw new UserError((0, index_js_1.tr) `"${projectId}" no tiene horas medidas todavía: el badge solo cuenta las de sesiones de agente.`);
+        }
+        const cost = projectAiCost(db, projectId, entries);
+        const text = (0, badge_js_1.badgeText)({ measuredSeconds, aiCost: cost ? (0, shared_1.formatMoneyWhole)(cost.money) : null });
+        console.log((0, badge_js_1.badgeMarkdown)(text));
+        console.log("");
+        console.log((0, index_js_1.tr) `Vista previa: ${(0, badge_js_1.badgeUrl)(text)}`);
+        if (cost?.api) {
+            console.log((0, index_js_1.tr) `El coste es a tarifa API. Si pagas cuota fija, regístrala para que salga lo que pagas de verdad:`);
+            console.log((0, index_js_1.tr) `  estela subscription add --id claude-max --name "Claude Max" --fee 200`);
+        }
+        console.log((0, index_js_1.tr) `Es una imagen estática: para actualizar las cifras, vuelve a generarlo.`);
+    }
+    finally {
+        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 {
+        const week = args.flags["week"] === true;
+        // Hasta el final de hoy, en la hora de quien lo pide; con --week, desde
+        // el principio del día de hace seis: siete días naturales contando hoy.
+        const hoy = new Date();
+        const to = new Date(hoy.getFullYear(), hoy.getMonth(), hoy.getDate() + 1);
+        const from = week ? new Date(hoy.getFullYear(), hoy.getMonth(), hoy.getDate() - 6) : null;
+        const projects = store.listProjects(db);
+        const entries = projects.flatMap((p) => store.getTimeEntries(db, p.id));
+        if (entries.length === 0)
+            throw new UserError((0, index_js_1.tr) `Sin bloques imputados. Ejecuta: estela import`);
+        const turns = db.prepare(`SELECT at, model, tok_cache_read, tok_cache_w5m, tok_cache_w1h FROM agent_turns
+       WHERE at >= ? AND at < ?`).all((from ?? new Date(0)).toISOString(), to.toISOString()).map((t) => ({
+            at: new Date(t.at), model: t.model,
+            cacheRead: t.tok_cache_read, cacheWrite5m: t.tok_cache_w5m, cacheWrite1h: t.tok_cache_w1h,
+        }));
+        const data = (0, receipt_js_1.receiptData)({
+            entries, turns, from, to, projectNames: new Map(projects.map((p) => [p.id, p.name])),
+        });
+        const out = (0, node_path_1.resolve)(str(args, "out") ??
+            (week ? `estela-receipt-${(0, shared_1.localDate)(hoy)}.png` : "estela-receipt.png"));
+        const names = args.flags["names"] === true;
+        (0, node_fs_1.writeFileSync)(out, (0, receipt_js_1.renderReceipt)(data, { week, names }));
+        console.log((0, index_js_1.tr) `Recibo guardado en ${out}`);
+        if (!names)
+            console.log((0, index_js_1.tr) `Sin nombres de proyectos ni ramas, para que puedas compartirlo. Con --names, se incluyen.`);
+        console.log((0, index_js_1.tr) `Se ha generado en tu máquina y no se ha enviado a ningún sitio.`);
+    }
+    finally {
+        db.close();
+    }
+}
 function cmdInvoice(args, dbPath) {
     const db = (0, schema_js_1.openDatabase)(dbPath);
     try {
@@ -1982,6 +2241,15 @@ async function main() {
         case "ai-cost":
             cmdAiCost(dbPath);
             break;
+        case "quota":
+            await cmdQuota(args, dbPath);
+            break;
+        case "badge":
+            await cmdBadge(args, dbPath);
+            break;
+        case "receipt":
+            cmdReceipt(args, dbPath);
+            break;
         case "status":
             cmdStatus(dbPath);
             break;