estela 0.1.0

package/README.md

@@ -0,0 +1,138 @@
+# Estela
+
+Registro de horas de desarrollo que **no hay que rellenar**. Lee lo que tus
+agentes de IA y tu Git ya escribieron en disco y reconstruye en qué se te fue el
+tiempo, con lo que costó de IA.
+
+```sh
+npx estela setup
+```
+
+Veinte segundos después tienes tu historial de los últimos meses. Sin cuenta,
+sin tarjeta y sin que nada salga de tu máquina.
+
+---
+
+## Por qué existe
+
+Un cronómetro que hay que acordarse de arrancar siempre falla. Y con un agente
+de IA el tiempo ya no se mide tecleando: se va en escribir el prompt, leer lo
+que devuelve y probarlo.
+
+Pero ese trabajo **deja rastro**. Claude Code guarda cada sesión en
+`~/.claude/projects/` con su modelo y sus tokens exactos. Git guarda cuándo
+commiteaste y qué. Estela lee ambas cosas y las cruza.
+
+Lo que no hace:
+
+- **No instala hooks.** Tu `husky` y tu `lefthook` siguen intactos, y tus
+  mensajes de commit no se tocan. Un identificador metido en el historial es
+  irreversible una vez subido.
+- **No inspecciona procesos ni la terminal.** Lee ficheros que ya existen.
+- **No guarda el contenido de tus prompts.** Solo cuándo, cuánto y con qué
+  modelo.
+- **No manda nada a ningún sitio.** El plan gratuito es local entero.
+
+## Empezar
+
+Necesitas **Node 22.5 o superior** (por `node:sqlite`).
+
+```sh
+npx estela setup     # detecta agentes y repositorios, reconstruye tu historial
+npx estela web       # abre el panel en http://localhost:4319
+npx estela doctor    # revisa los datos y avisa de lo que está mal
+```
+
+`setup` no pregunta nada y no pisa lo que hayas configurado a mano: se puede
+volver a ejecutar.
+
+## Facturar a un cliente
+
+Los proyectos se crean como internos y sin tarifa, porque inventarla daría
+cifras falsas el primer minuto. Cuando uno sea de un cliente de verdad:
+
+```sh
+estela client add --id acme --name "ACME" --currency EUR
+estela project add --id acme-web --client acme --name "Web de ACME" --repo ~/dev/acme-web
+estela rate set --project acme-web --rate 50
+
+estela author --project acme-web      # con qué correo commiteas ahí
+estela report --project acme-web --cutoff 2026-08-31 --dry-run
+```
+
+**`estela author` importa más de lo que parece.** En el repositorio de un
+cliente casi nunca commiteas con tu correo global, y sin decirlo se capturan
+tres commits de mil setecientos.
+
+## Compartir el avance con tu cliente
+
+```sh
+estela publish --project acme-web --base-url https://tu-dominio.com
+```
+
+Genera un HTML autocontenido con un enlace no adivinable. Enseña horas y
+commits; **nunca tu tarifa ni tu consumo de IA**, porque mientras la pagues tú
+ese gasto es tuyo y un cliente que sabe qué parte generó una IA tiene un
+argumento nuevo para negociar tu tarifa.
+
+Al republicar, pasa el mismo `--token` o tu cliente se queda con un enlace
+muerto.
+
+## El coste de la IA
+
+Con una cuota plana el gasto real no es la suma de los tokens: es la cuota
+repartida entre lo que consumiste.
+
+```sh
+estela subscription add --id max --name "Claude Max" --fee 100
+estela ai-cost
+```
+
+La caché se cuenta aparte porque suele ser la mayor parte de la factura —
+ignorarla subestimaba el gasto cinco veces.
+
+## Horas que ningún import va a deducir
+
+Reuniones, desplazamientos, investigación, y desarrollo sin agente que tampoco
+dejó commits:
+
+```sh
+estela log --project acme-web --hours 1.5 --kind meeting --what "Seguimiento semanal"
+```
+
+Un import nunca las toca.
+
+## Trabajo sin agente
+
+Si programaste a mano, tus commits siguen siendo un rastro: Estela deduce el
+tiempo de ellos y lo marca como **estimado**, para que sepas qué parte de tu
+parte está medida y cuál supuesta. La estimación se queda corta a propósito:
+estas horas acaban en un informe que alguien paga.
+
+## Planes
+
+| | Free | Pro | Teams |
+|---|---|---|---|
+| Todo lo de arriba, en local | ✓ | ✓ | ✓ |
+| Sincronizar varias máquinas | — | ✓ | ✓ |
+| Paneles ilimitados y alojados | 1 | ✓ | ✓ |
+| Horas del equipo **medidas** | — | — | ✓ |
+| Presupuesto de IA por proyecto | — | — | ✓ |
+
+Pro es una persona en varias máquinas; Teams son varias personas. El coste de
+IA se informa **por proyecto, nunca por persona**: lo que cada cual gasta de su
+bolsillo es suyo.
+
+Más en [getestela.dev](https://getestela.dev).
+
+## Desarrollo
+
+```sh
+npm install
+npm run build
+node --test packages/daemon/dist/**/*.test.js
+```
+
+Node 22 y **cero dependencias de runtime**, a propósito: nadie instala un
+programa que lee sus transcripts si no puede auditarlo, y una lista de
+dependencias vacía se audita en una tarde.

package/dist/billing/amortize.d.ts

@@ -0,0 +1,44 @@
+import type { AiCost, AmortizedShare, Money, Subscription } from "@estela/shared";
+/**
+ * Reparto de una cuota fija entre proyectos.
+ *
+ * Con una suscripción de precio fijo, sumar el coste por token da un número que
+ * no salió de tu bolsillo. Lo que gastaste de verdad es la cuota. Para saber
+ * cuánto de esa cuota "se comió" un proyecto, se reparte en proporción a lo que
+ * consumió, usando la tarifa API equivalente como unidad de medida.
+ *
+ *   parte_del_proyecto = cuota_mensual x (consumo_proyecto / consumo_total_mes)
+ *
+ * El denominador es **todo** tu consumo del mes, incluido el de proyectos no
+ * facturables. Si tus experimentos personales se comieron la mitad de la cuota,
+ * a los clientes solo les corresponde la otra mitad. Repartir únicamente entre
+ * lo facturable les cargaría un gasto que no generaron.
+ */
+export interface ConsumptionRow {
+    readonly projectId: string;
+    /** Mes en formato YYYY-MM. */
+    readonly month: string;
+    readonly consumption: AiCost;
+}
+/**
+ * @param monthTotals Consumo total del mes en **toda** tu máquina, incluido el
+ *   trabajo que aún no has asignado a ningún proyecto. Es el denominador
+ *   correcto: la cuota la pagaste entera, la usaras en lo que la usaras.
+ *
+ *   Sin este dato, el denominador sería solo la suma de los proyectos
+ *   configurados y el primero que registres cargaría con toda la cuota, aunque
+ *   la mayor parte de tu consumo estuviera en repos sin configurar.
+ */
+export declare function amortize(rows: readonly ConsumptionRow[], subscriptions: readonly Subscription[], monthTotals?: ReadonlyMap<string, AiCost>): AmortizedShare[];
+/**
+ * Suma de las cuotas vigentes en un mes.
+ *
+ * Se suman porque es habitual pagar varias a la vez (Claude Max y Cursor, por
+ * ejemplo) y todas alimentan el mismo trabajo.
+ */
+export declare function feeForMonth(subscriptions: readonly Subscription[], month: string): Money | null;
+/** Mes (YYYY-MM, en UTC) de una fecha. */
+export declare function monthOf(date: Date): string;
+/** Lo que le corresponde a un proyecto en un rango de meses. */
+export declare function shareForProject(shares: readonly AmortizedShare[], projectId: string, months: readonly string[]): Money | null;
+//# sourceMappingURL=amortize.d.ts.map

package/dist/billing/amortize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amortize.d.ts","sourceRoot":"","sources":["../../src/billing/amortize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGlF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,aAAa,EAAE,SAAS,YAAY,EAAE,EACtC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,cAAc,EAAE,CAiClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAkB/F;AAED,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE1C;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,KAAK,GAAG,IAAI,CAMd"}

package/dist/billing/amortize.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.amortize = amortize;
+exports.feeForMonth = feeForMonth;
+exports.monthOf = monthOf;
+exports.shareForProject = shareForProject;
+const shared_1 = require("@estela/shared");
+/**
+ * @param monthTotals Consumo total del mes en **toda** tu máquina, incluido el
+ *   trabajo que aún no has asignado a ningún proyecto. Es el denominador
+ *   correcto: la cuota la pagaste entera, la usaras en lo que la usaras.
+ *
+ *   Sin este dato, el denominador sería solo la suma de los proyectos
+ *   configurados y el primero que registres cargaría con toda la cuota, aunque
+ *   la mayor parte de tu consumo estuviera en repos sin configurar.
+ */
+function amortize(rows, subscriptions, monthTotals) {
+    const byMonth = new Map();
+    for (const row of rows) {
+        const bucket = byMonth.get(row.month);
+        if (bucket)
+            bucket.push(row);
+        else
+            byMonth.set(row.month, [row]);
+    }
+    const shares = [];
+    for (const [month, monthRows] of byMonth) {
+        const fee = feeForMonth(subscriptions, month);
+        const assigned = monthRows.reduce((sum, r) => sum + r.consumption.microUsd, 0);
+        // Nunca por debajo de lo ya asignado: un total incoherente no puede hacer
+        // que las partes sumen más del 100%.
+        const total = Math.max(monthTotals?.get(month)?.microUsd ?? 0, assigned);
+        for (const row of monthRows) {
+            const share = total === 0 ? 0 : row.consumption.microUsd / total;
+            shares.push({
+                projectId: row.projectId,
+                month,
+                consumption: row.consumption,
+                monthTotal: { microUsd: total },
+                share,
+                amount: fee
+                    ? (0, shared_1.money)(Math.round(fee.amount * share), fee.currency)
+                    : (0, shared_1.money)(0, "USD"),
+            });
+        }
+    }
+    return shares.sort((a, b) => a.month.localeCompare(b.month) || a.projectId.localeCompare(b.projectId));
+}
+/**
+ * Suma de las cuotas vigentes en un mes.
+ *
+ * Se suman porque es habitual pagar varias a la vez (Claude Max y Cursor, por
+ * ejemplo) y todas alimentan el mismo trabajo.
+ */
+function feeForMonth(subscriptions, month) {
+    const start = new Date(`${month}-01T00:00:00Z`);
+    const active = subscriptions.filter((s) => s.effectiveFrom <= start && (s.effectiveTo === null || start < s.effectiveTo));
+    if (active.length === 0)
+        return null;
+    const currency = active[0].monthlyFee.currency;
+    let total = 0;
+    for (const s of active) {
+        if (s.monthlyFee.currency !== currency) {
+            throw new TypeError(`Suscripciones en monedas distintas en ${month} (${currency} y ${s.monthlyFee.currency}). ` +
+                `Únifica la moneda de las suscripciones: no se convierten automáticamente.`);
+        }
+        total += s.monthlyFee.amount;
+    }
+    return (0, shared_1.money)(total, currency);
+}
+/** Mes (YYYY-MM, en UTC) de una fecha. */
+function monthOf(date) {
+    return date.toISOString().slice(0, 7);
+}
+/** Lo que le corresponde a un proyecto en un rango de meses. */
+function shareForProject(shares, projectId, months) {
+    const relevant = shares.filter((s) => s.projectId === projectId && months.includes(s.month));
+    if (relevant.length === 0)
+        return null;
+    const currency = relevant[0].amount.currency;
+    return (0, shared_1.money)(relevant.reduce((sum, s) => sum + s.amount.amount, 0), currency);
+}
+//# sourceMappingURL=amortize.js.map

package/dist/billing/amortize.js.map

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

package/dist/billing/amortize.test.d.ts

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

package/dist/billing/amortize.test.d.ts.map

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

package/dist/billing/amortize.test.js

@@ -0,0 +1,121 @@
+"use strict";
+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_test_1 = require("node:test");
+const shared_1 = require("@estela/shared");
+const amortize_js_1 = require("./amortize.js");
+const CLAUDE_MAX = {
+    id: "claude-max", name: "Claude Max",
+    monthlyFee: (0, shared_1.parseMoney)("200", "USD"),
+    effectiveFrom: new Date("2025-01-01T00:00:00Z"), effectiveTo: null,
+};
+(0, node_test_1.test)("reparte la cuota en proporción al consumo", () => {
+    const shares = (0, amortize_js_1.amortize)([
+        { projectId: "a", month: "2026-08", consumption: { microUsd: 75_000_000 } }, // 75%
+        { projectId: "b", month: "2026-08", consumption: { microUsd: 25_000_000 } }, // 25%
+    ], [CLAUDE_MAX]);
+    const a = shares.find((s) => s.projectId === "a");
+    const b = shares.find((s) => s.projectId === "b");
+    strict_1.default.equal(a.share, 0.75);
+    strict_1.default.equal((0, shared_1.formatMoney)(a.amount), "$150,00");
+    strict_1.default.equal((0, shared_1.formatMoney)(b.amount), "$50,00");
+    strict_1.default.equal(a.amount.amount + b.amount.amount, 20_000, "el reparto suma la cuota entera");
+});
+(0, node_test_1.test)("lo no facturable también consume cuota, y por eso entra en el denominador", () => {
+    // Si tus experimentos se comen la mitad, al cliente solo le toca la otra mitad.
+    const shares = (0, amortize_js_1.amortize)([
+        { projectId: "cliente", month: "2026-08", consumption: { microUsd: 50_000_000 } },
+        { projectId: "experimentos", month: "2026-08", consumption: { microUsd: 50_000_000 } },
+    ], [CLAUDE_MAX]);
+    const cliente = shares.find((s) => s.projectId === "cliente");
+    strict_1.default.equal((0, shared_1.formatMoney)(cliente.amount), "$100,00");
+    strict_1.default.equal(cliente.share, 0.5);
+});
+(0, node_test_1.test)("el trabajo sin asignar a proyecto también diluye la cuota", () => {
+    // El fallo que esto previene: con un solo proyecto configurado y el 90% del
+    // consumo en repos sin registrar, ese proyecto cargaba con la cuota entera.
+    const shares = (0, amortize_js_1.amortize)([{ projectId: "eurosistema", month: "2026-08", consumption: { microUsd: 10_000_000 } }], [CLAUDE_MAX], new Map([["2026-08", { microUsd: 100_000_000 }]])); // total real de la máquina
+    strict_1.default.equal(shares[0].share, 0.1);
+    strict_1.default.equal((0, shared_1.formatMoney)(shares[0].amount), "$20,00");
+    strict_1.default.equal(shares[0].monthTotal.microUsd, 100_000_000, "el denominador es el consumo real de la máquina, no la suma de proyectos");
+});
+(0, node_test_1.test)("un total incoherente nunca hace que las partes pasen del 100%", () => {
+    const shares = (0, amortize_js_1.amortize)([{ projectId: "a", month: "2026-08", consumption: { microUsd: 50_000_000 } }], [CLAUDE_MAX], new Map([["2026-08", { microUsd: 10_000_000 }]])); // menor que lo asignado
+    strict_1.default.equal(shares[0].share, 1, "se limita al 100%, no al 500%");
+    strict_1.default.equal((0, shared_1.formatMoney)(shares[0].amount), "$200,00");
+});
+(0, node_test_1.test)("el reparto es por mes, no acumulado", () => {
+    const shares = (0, amortize_js_1.amortize)([
+        { projectId: "a", month: "2026-07", consumption: { microUsd: 10_000_000 } },
+        { projectId: "a", month: "2026-08", consumption: { microUsd: 30_000_000 } },
+        { projectId: "b", month: "2026-08", consumption: { microUsd: 10_000_000 } },
+    ], [CLAUDE_MAX]);
+    const julio = shares.find((s) => s.projectId === "a" && s.month === "2026-07");
+    const agosto = shares.find((s) => s.projectId === "a" && s.month === "2026-08");
+    strict_1.default.equal((0, shared_1.formatMoney)(julio.amount), "$200,00", "único proyecto en julio: cuota entera");
+    strict_1.default.equal((0, shared_1.formatMoney)(agosto.amount), "$150,00", "75% de agosto");
+});
+(0, node_test_1.test)("varias suscripciones a la vez se suman", () => {
+    const cursor = {
+        id: "cursor", name: "Cursor", monthlyFee: (0, shared_1.parseMoney)("20", "USD"),
+        effectiveFrom: new Date("2025-01-01T00:00:00Z"), effectiveTo: null,
+    };
+    strict_1.default.equal((0, shared_1.formatMoney)((0, amortize_js_1.feeForMonth)([CLAUDE_MAX, cursor], "2026-08")), "$220,00");
+});
+(0, node_test_1.test)("una suscripción no vigente no cuenta", () => {
+    const antigua = {
+        ...CLAUDE_MAX, id: "vieja",
+        effectiveTo: new Date("2026-01-01T00:00:00Z"),
+    };
+    strict_1.default.equal((0, amortize_js_1.feeForMonth)([antigua], "2026-08"), null);
+    strict_1.default.equal((0, shared_1.formatMoney)((0, amortize_js_1.feeForMonth)([antigua], "2025-06")), "$200,00");
+});
+(0, node_test_1.test)("suscripciones en monedas distintas se rechazan en vez de convertirse", () => {
+    const enEuros = {
+        id: "x", name: "X", monthlyFee: (0, shared_1.money)(2000, "EUR"),
+        effectiveFrom: new Date("2025-01-01T00:00:00Z"), effectiveTo: null,
+    };
+    strict_1.default.throws(() => (0, amortize_js_1.feeForMonth)([CLAUDE_MAX, enEuros], "2026-08"), /monedas distintas/);
+});
+(0, node_test_1.test)("sin suscripción, el reparto sale a cero en vez de inventar un coste", () => {
+    const shares = (0, amortize_js_1.amortize)([{ projectId: "a", month: "2026-08", consumption: { microUsd: 8_016_655 } }], []);
+    strict_1.default.equal(shares[0].amount.amount, 0);
+    strict_1.default.equal(shares[0].consumption.microUsd, 8_016_655, "el consumo sí se conserva");
+});
+(0, node_test_1.test)("consumo cero no divide por cero", () => {
+    const shares = (0, amortize_js_1.amortize)([{ projectId: "a", month: "2026-08", consumption: { microUsd: 0 } }], [CLAUDE_MAX]);
+    strict_1.default.equal(shares[0].share, 0);
+    strict_1.default.equal(shares[0].amount.amount, 0);
+});
+(0, node_test_1.test)("suma de un proyecto a lo largo de varios meses", () => {
+    const shares = (0, amortize_js_1.amortize)([
+        { projectId: "a", month: "2026-07", consumption: { microUsd: 100_000_000 } },
+        { projectId: "a", month: "2026-08", consumption: { microUsd: 100_000_000 } },
+    ], [CLAUDE_MAX]);
+    const total = (0, amortize_js_1.shareForProject)(shares, "a", ["2026-07", "2026-08"]);
+    strict_1.default.equal((0, shared_1.formatMoney)(total), "$400,00");
+    const soloJulio = (0, amortize_js_1.shareForProject)(shares, "a", ["2026-07"]);
+    strict_1.default.equal((0, shared_1.formatMoney)(soloJulio), "$200,00");
+});
+(0, node_test_1.test)("monthOf usa UTC de forma consistente", () => {
+    strict_1.default.equal((0, amortize_js_1.monthOf)(new Date("2026-08-26T23:30:00Z")), "2026-08");
+    strict_1.default.equal((0, amortize_js_1.monthOf)(new Date("2026-09-01T00:00:00Z")), "2026-09");
+});
+(0, node_test_1.test)("el reparto de la cuota se congela en el informe", () => {
+    // El fallo que esto previene: el reparto es un valor derivado que cambia al
+    // entrar más consumo del mismo mes. Sin congelarlo, reimprimir un informe de
+    // agosto en diciembre daría otra cifra, y un documento que cambia solo no es
+    // un documento.
+    const enAgosto = (0, amortize_js_1.amortize)([{ projectId: "a", month: "2026-08", consumption: { microUsd: 50_000_000 } }], [CLAUDE_MAX], new Map([["2026-08", { microUsd: 100_000_000 }]]));
+    const congelado = (0, amortize_js_1.shareForProject)(enAgosto, "a", ["2026-08"]);
+    strict_1.default.equal((0, shared_1.formatMoney)(congelado), "$100,00");
+    // En diciembre se conoce el doble de consumo de ese mismo mes.
+    const enDiciembre = (0, amortize_js_1.amortize)([{ projectId: "a", month: "2026-08", consumption: { microUsd: 50_000_000 } }], [CLAUDE_MAX], new Map([["2026-08", { microUsd: 200_000_000 }]]));
+    const recalculado = (0, amortize_js_1.shareForProject)(enDiciembre, "a", ["2026-08"]);
+    strict_1.default.equal((0, shared_1.formatMoney)(recalculado), "$50,00");
+    strict_1.default.notEqual(congelado.amount, recalculado.amount, "el recálculo cambia: por eso hay que guardar el de su día");
+});
+//# sourceMappingURL=amortize.test.js.map

package/dist/billing/amortize.test.js.map

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

package/dist/billing/format.test.d.ts

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

package/dist/billing/format.test.d.ts.map

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

package/dist/billing/format.test.js

@@ -0,0 +1,110 @@
+"use strict";
+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_test_1 = require("node:test");
+const shared_1 = require("@estela/shared");
+const sessionize_js_1 = require("./sessionize.js");
+// ── Duraciones ─────────────────────────────────────────────────────────
+(0, node_test_1.test)("nunca imprime 60 minutos", () => {
+    // El fallo que esto previene: redondear los minutos después de haber
+    // separado las horas. 2h 59m 50s salía como "2h 60m", y en una factura.
+    strict_1.default.equal((0, shared_1.formatDuration)(2 * 3600 + 59 * 60 + 50), "3h");
+    strict_1.default.equal((0, shared_1.formatDuration)(3599), "1h");
+    strict_1.default.equal((0, shared_1.formatDuration)(59 * 60 + 55), "1h");
+});
+(0, node_test_1.test)("duraciones normales", () => {
+    strict_1.default.equal((0, shared_1.formatDuration)(0), "0m");
+    strict_1.default.equal((0, shared_1.formatDuration)(90), "2m");
+    strict_1.default.equal((0, shared_1.formatDuration)(3600), "1h");
+    strict_1.default.equal((0, shared_1.formatDuration)(3660), "1h 01m");
+    strict_1.default.equal((0, shared_1.formatDuration)(4 * 3600 + 16 * 60), "4h 16m");
+});
+(0, node_test_1.test)("ninguna duración razonable produce 60m", () => {
+    for (let s = 0; s < 12 * 3600; s += 7) {
+        const out = (0, shared_1.formatDuration)(s);
+        strict_1.default.ok(!out.includes("60m"), `formatDuration(${s}) = "${out}"`);
+    }
+});
+// ── Fecha local ────────────────────────────────────────────────────────
+(0, node_test_1.test)("el día de trabajo es el del reloj de quien trabaja", () => {
+    // En UTC-5, las 22:00 del día 25 son las 03:00 UTC del 26. Usar la fecha UTC
+    // partiría la jornada de tarde-noche entre dos días.
+    const tarde = new Date("2026-08-26T03:19:00Z"); // 22:19 del 25 en Ecuador
+    const esperado = new Date(tarde.getTime() - tarde.getTimezoneOffset() * 60_000)
+        .toISOString().slice(0, 10);
+    strict_1.default.equal((0, shared_1.localDate)(tarde), esperado);
+    if (tarde.getTimezoneOffset() > 0) {
+        strict_1.default.notEqual((0, shared_1.localDate)(tarde), tarde.toISOString().slice(0, 10), "al oeste de Greenwich, la fecha local y la UTC difieren en esta hora");
+    }
+});
+// ── Agrupación ─────────────────────────────────────────────────────────
+function block(startIso, minutes, branch = "main") {
+    const startedAt = new Date(startIso);
+    return {
+        startedAt,
+        endedAt: new Date(startedAt.getTime() + minutes * 60_000),
+        seconds: minutes * 60,
+        repoPath: "/repo", branch, turnCount: 1,
+        aiCost: { microUsd: 1_000_000 },
+        models: ["claude-opus-5"], sessionIds: ["s"], commits: [], unpricedModels: [],
+    };
+}
+(0, node_test_1.test)("suma el tiempo trabajado, no el lapso entre el primero y el último", () => {
+    // Dos bloques de 30 min con tres horas de comida en medio son 1h, no 4h.
+    // Facturar el hueco sería cobrarle de más al cliente.
+    const merged = (0, sessionize_js_1.groupByBranchAndDay)([
+        block("2026-08-26T14:00:00Z", 30),
+        block("2026-08-26T21:00:00Z", 30),
+    ]);
+    strict_1.default.equal(merged.length, 1);
+    strict_1.default.equal(merged[0].seconds, 3600, "1h de trabajo real");
+    strict_1.default.equal((0, shared_1.formatDuration)(merged[0].seconds), "1h");
+});
+(0, node_test_1.test)("ramas distintas no se fusionan", () => {
+    const merged = (0, sessionize_js_1.groupByBranchAndDay)([
+        block("2026-08-26T14:00:00Z", 30, "main"),
+        block("2026-08-26T15:00:00Z", 30, "feature/auth"),
+    ]);
+    strict_1.default.equal(merged.length, 2);
+});
+(0, node_test_1.test)("se acumulan commits, modelos y coste al fusionar", () => {
+    const a = block("2026-08-26T14:00:00Z", 30);
+    const b = block("2026-08-26T15:00:00Z", 30);
+    const merged = (0, sessionize_js_1.groupByBranchAndDay)([a, b]);
+    strict_1.default.equal(merged[0].aiCost.microUsd, 2_000_000);
+    strict_1.default.equal(merged[0].turnCount, 2);
+});
+// ── Identificador determinista de una imputación ───────────────────────
+/** La misma fórmula que usan la CLI y el servidor para nombrar un bloque. */
+function entryId(projectId, startedAt, branch) {
+    const day = (0, shared_1.localDate)(startedAt);
+    const slug = (branch ?? "sin-rama").replace(/[^a-zA-Z0-9]+/g, "-");
+    return `te_${projectId}_${day}_${slug}`;
+}
+(0, node_test_1.test)("el id usa la fecha local, no la UTC", () => {
+    // El fallo que esto previene: la CLI construía el id con toISOString() (UTC)
+    // y el servidor con localDate(). Para el mismo bloque salían dos ids, así que
+    // en vez de actualizar una fila se creaba otra y el día se contaba doble.
+    const tarde = new Date("2026-08-27T02:49:59Z"); // 21:49 del 26 en UTC-5
+    const id = entryId("euro", tarde, "feature/x");
+    strict_1.default.ok(id.includes((0, shared_1.localDate)(tarde)), "el id lleva la fecha local");
+    if (tarde.getTimezoneOffset() > 0) {
+        strict_1.default.ok(!id.includes(tarde.toISOString().slice(0, 10)), "y no la UTC, que aquí es el día siguiente");
+    }
+});
+(0, node_test_1.test)("el mismo bloque siempre produce el mismo id", () => {
+    const at = new Date("2026-08-26T14:00:00Z");
+    strict_1.default.equal(entryId("p", at, "main"), entryId("p", new Date(at), "main"));
+});
+(0, node_test_1.test)("el id coincide con el local_date de la fila", () => {
+    // La invariante que hace posible detectar filas huérfanas: si un id lleva una
+    // fecha distinta a su local_date, esa fila la creó una versión con el bug.
+    for (const iso of ["2026-08-27T02:49:00Z", "2026-08-26T14:00:00Z", "2026-01-01T03:00:00Z"]) {
+        const at = new Date(iso);
+        strict_1.default.ok(entryId("p", at, "main").includes(`_${(0, shared_1.localDate)(at)}_`));
+    }
+});
+//# sourceMappingURL=format.test.js.map

package/dist/billing/format.test.js.map

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

package/dist/billing/invoice.d.ts

@@ -0,0 +1,52 @@
+import type { Client, Invoice, Money, Project, RatePeriod, TimeEntry } from "@estela/shared";
+/**
+ * Emisión de facturas.
+ *
+ * Tres reglas que no se negocian, porque son las que hacen que una factura de
+ * hace seis meses siga cuadrando hoy:
+ *
+ *  1. La tarifa se busca por la fecha del trabajo, no por la de hoy. Si subes
+ *     el precio a mitad de proyecto, lo ya trabajado mantiene el suyo.
+ *  2. El tipo de cambio se captura al emitir y se guarda en la factura. Jamás
+ *     se recalcula con el del día.
+ *  3. El coste de IA está en USD porque es la moneda en la que factura el
+ *     proveedor. Nunca se suma a un importe en otra moneda sin un tipo
+ *     explícito.
+ */
+export interface IssueInvoiceInput {
+    readonly client: Client;
+    readonly project: Project;
+    readonly rates: readonly RatePeriod[];
+    readonly entries: readonly TimeEntry[];
+    /** Fecha de corte, inclusive. Se factura todo lo anterior o igual. */
+    readonly cutoffAt: Date;
+    readonly number: string;
+    readonly issuedAt?: Date;
+    /**
+     * Unidades de la moneda del cliente por 1 USD. Obligatorio solo cuando el
+     * proyecto repercute el coste de IA y la moneda no es USD.
+     */
+    readonly usdFxRate?: number;
+    /**
+     * Parte de la cuota de suscripción que le toca a este periodo. Se calcula
+     * fuera y se guarda tal cual: es un valor derivado que cambia cuando entran
+     * más datos, así que el informe tiene que quedarse con el de su día.
+     */
+    readonly aiAmortized?: Money;
+    readonly notes?: string;
+}
+export declare class InvoiceError extends Error {
+}
+export declare function issueInvoice(input: IssueInvoiceInput): Invoice;
+/** Tarifa vigente en una fecha. Las tarifas se apilan, no se sobrescriben. */
+export declare function rateAt(rates: readonly RatePeriod[], projectId: string, at: Date): Money | null;
+/** Renderiza la factura como texto plano para revisarla antes de enviarla. */
+export declare function renderInvoice(invoice: Invoice, client: Client, project: Project): string;
+/** Margen real del periodo: lo cobrado menos lo que costó la IA. */
+export declare function marginOf(invoice: Invoice, usdFxRate: number): {
+    revenue: Money;
+    aiCost: Money;
+    margin: Money;
+    marginPct: number;
+};
+//# sourceMappingURL=invoice.d.ts.map

package/dist/billing/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../src/billing/invoice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACF,MAAM,EAAE,OAAO,EAAe,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAC5E,MAAM,gBAAgB,CAAC;AAMxB;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAE1C,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAwF9D;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CACpB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,IAAI,GACP,KAAK,GAAG,IAAI,CAOd;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAgDxF;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG;IAC7D,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;CACjE,CAUA"}