estela 0.1.38 → 0.1.39

package/README.md

@@ -51,6 +51,13 @@ What it doesn't do:
   with which model.
 - **It doesn't send anything anywhere.** The free plan is entirely local.
 
+### Already using ccusage?
+
+Keep it. [ccusage](https://github.com/ryoppippi/ccusage) reads the same files
+and tells you what the AI cost you; Estela tells you how many hours you worked
+and what to bill the client. Both only read, so they run side by side.
+[Side-by-side comparison](https://getestela.dev/en/vs/ccusage).
+
 ## Getting started
 
 You need **Node 22.5 or later** (for `node:sqlite`).
@@ -248,6 +255,16 @@ Node 22 and **zero runtime dependencies**, on purpose: nobody installs a program
 that reads their transcripts if they can't audit it, and an empty dependency
 list can be audited in an afternoon.
 
+## Contributing
+
+Issues and pull requests are welcome, and the
+[good first issues](https://github.com/jdleonruiz/estela-cli/labels/good%20first%20issue)
+are a good place to start. One thing to know so nobody's put off: this
+repository mirrors the open part of a larger repo where the paid service also
+lives, which is why each commit here is a release. I review PRs here and apply
+them to the main repo keeping you as the author, and the next release commit
+credits you as co-author. PRs welcome — I merge them into the main repo.
+
 ## Open source, closed service
 
 Everything that installs on your machine is open source under the MIT license:

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

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

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

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

package/dist/cli-badge.test.js

@@ -0,0 +1,118 @@
+"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"));
+/**
+ * `estela badge`, ejecutando la CLI de verdad: lo que importa es la línea que
+ * alguien pega en su README, y que no cuente como medido lo que no lo es.
+ */
+const BIN = (0, node_path_1.join)(__dirname, "bin.js");
+function estela(db, ...args) {
+    const r = (0, node_child_process_1.spawnSync)(process.execPath, [BIN, ...args, "--db", db], {
+        encoding: "utf8",
+        env: { ...process.env, ESTELA_LANG: "es", NO_COLOR: "1" },
+    });
+    return { code: r.status, out: `${r.stdout}${r.stderr}` };
+}
+function bloque(id, source, hours, aiUsd) {
+    const startedAt = new Date("2026-08-10T10:00:00Z");
+    return {
+        id, projectId: "p", startedAt, endedAt: new Date(startedAt.getTime() + hours * 3600_000),
+        seconds: hours * 3600, description: "Trabajo", billable: true, invoiceId: null,
+        aiCost: { microUsd: aiUsd * 1_000_000 }, agentSeconds: source === "agent" ? hours * 3600 : 0,
+        commitHashes: [], agents: [], source, kind: "development", branch: "main",
+    };
+}
+function preparar(bloques, cuota) {
+    const path = (0, node_path_1.join)((0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "estela-badge-")), "estela.db");
+    const db = (0, schema_js_1.openDatabase)(path);
+    try {
+        store.upsertClient(db, { id: "c", name: "Interno", currency: "EUR" });
+        store.upsertProject(db, {
+            id: "p", clientId: "c", name: "Web", repoPaths: [],
+            billable: true, roundingMinutes: 0, aiCostPolicy: "absorbed", kind: "client",
+        });
+        for (const b of bloques)
+            store.saveTimeEntry(db, b);
+        if (cuota !== undefined) {
+            store.upsertSubscription(db, {
+                id: "max", name: "Claude Max", monthlyFee: { amount: cuota * 100, currency: "EUR" },
+                effectiveFrom: new Date("2026-01-01T00:00:00Z"), effectiveTo: null,
+            });
+        }
+    }
+    finally {
+        db.close();
+    }
+    return path;
+}
+(0, node_test_1.test)("badge: horas medidas y coste a tarifa API, sin contar lo estimado", () => {
+    const db = preparar([bloque("a", "agent", 42, 18.4), bloque("b", "commit", 5, 0)]);
+    const r = estela(db, "badge", "--project", "p");
+    strict_1.default.equal(r.code, 0, r.out);
+    strict_1.default.match(r.out, /^\[!\[Built in 42 h · \$18 of AI\]\(https:\/\/img\.shields\.io\/badge\/[^)]+\)\]\(https:\/\/getestela\.dev\/en\/\)$/m);
+    strict_1.default.match(r.out, /tarifa API/);
+});
+(0, node_test_1.test)("badge: con una cuota registrada, sale lo que se pagó de verdad", () => {
+    // Único proyecto con consumo ese mes: se lleva la cuota entera.
+    const db = preparar([bloque("a", "agent", 10, 50)], 100);
+    const r = estela(db, "badge", "--project", "p");
+    strict_1.default.equal(r.code, 0, r.out);
+    strict_1.default.match(r.out, /Built in 10 h · €100 of AI/);
+    strict_1.default.doesNotMatch(r.out, /tarifa API/);
+});
+(0, node_test_1.test)("badge: sin horas medidas no se inventa un badge", () => {
+    const db = preparar([bloque("b", "commit", 5, 0)]);
+    const r = estela(db, "badge", "--project", "p");
+    strict_1.default.notEqual(r.code, 0);
+    strict_1.default.match(r.out, /no tiene horas medidas/);
+});
+(0, node_test_1.test)("badge: un proyecto que no existe se dice así", () => {
+    const db = preparar([]);
+    const r = estela(db, "badge", "--project", "nada");
+    strict_1.default.notEqual(r.code, 0);
+    strict_1.default.match(r.out, /No existe el proyecto "nada"/);
+});
+//# sourceMappingURL=cli-badge.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-badge.test.js","sourceRoot":"","sources":["../src/cli-badge.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":";AAyCA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAu3DpD,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;AAs/DpD,OAAO,EAAE,eAAe,EAAE,CAAC"}

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");
@@ -141,6 +143,14 @@ 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 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 +158,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 +302,14 @@ 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 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 +317,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 +1305,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 +1845,105 @@ 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();
+    }
+}
+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 +2106,12 @@ async function main() {
         case "ai-cost":
             cmdAiCost(dbPath);
             break;
+        case "badge":
+            await cmdBadge(args, dbPath);
+            break;
+        case "receipt":
+            cmdReceipt(args, dbPath);
+            break;
         case "status":
             cmdStatus(dbPath);
             break;