estela 0.1.28 → 0.1.32

package/dist/cli-idioma.test.js

@@ -0,0 +1,190 @@
+"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"));
+/**
+ * El idioma de los documentos, ejecutando la CLI de verdad.
+ *
+ * Lo que se prueba aquí es lo que ve una persona: qué idioma sale en el fichero
+ * que le manda a su cliente, cuándo se le avisa de dónde fijarlo, y que volver a
+ * ejecutar `client add` para cambiar un correo no le cambie los PDFs de idioma
+ * sin decirle nada. Ver `documentLang` en i18n/index.ts.
+ */
+const BIN = (0, node_path_1.join)(__dirname, "bin.js");
+function estela(db, lang, ...args) {
+    const r = (0, node_child_process_1.spawnSync)(process.execPath, [BIN, ...args, "--db", db], {
+        encoding: "utf8",
+        env: { ...process.env, ESTELA_LANG: lang, NO_COLOR: "1" },
+    });
+    return { code: r.status, out: `${r.stdout}${r.stderr}` };
+}
+/** Una base con un cliente, un proyecto con tarifa y un bloque facturable. */
+function preparar(language) {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), "estela-idioma-"));
+    const path = (0, node_path_1.join)(dir, "estela.db");
+    const db = (0, schema_js_1.openDatabase)(path);
+    try {
+        store.upsertClient(db, {
+            id: "acme", name: "ACME", currency: "EUR", taxId: "B-1", email: "ap@acme.test",
+            ...(language ? { language } : {}),
+        });
+        store.upsertProject(db, {
+            id: "p", clientId: "acme", name: "Web", repoPaths: [],
+            billable: true, roundingMinutes: 0, aiCostPolicy: "absorbed", kind: "client",
+        });
+        store.addRatePeriod(db, {
+            projectId: "p", hourlyRate: { amount: 5000, currency: "EUR" },
+            effectiveFrom: new Date("2026-01-01T00:00:00Z"), effectiveTo: null,
+        });
+        const startedAt = new Date("2026-08-10T10:00:00Z");
+        store.saveTimeEntry(db, {
+            id: "e1", projectId: "p", startedAt,
+            endedAt: new Date(startedAt.getTime() + 3600_000), seconds: 3600,
+            description: "Trabajo", billable: true, invoiceId: null,
+            aiCost: { microUsd: 0 }, agentSeconds: 3600, commitHashes: [], agents: [],
+            source: "agent", kind: "development", branch: "main",
+        });
+    }
+    finally {
+        db.close();
+    }
+    return { db: path, dir };
+}
+const htmlLang = (file) => /<html lang="(\w+)"/.exec((0, node_fs_1.readFileSync)(file, "utf8"))[1];
+// ── share: el documento sale en el idioma del cliente ───────────────────
+(0, node_test_1.test)("sin idioma fijado, el informe sale en el de la terminal y avisa dónde fijarlo", () => {
+    const { db, dir } = preparar();
+    const out = (0, node_path_1.join)(dir, "r.html");
+    const es = estela(db, "es", "share", "--project", "p", "--out", out);
+    strict_1.default.equal(es.code, 0, es.out);
+    strict_1.default.equal(htmlLang(out), "es");
+    strict_1.default.match(es.out, /Sale en español, el idioma de tu terminal/);
+    // El comando viene ya escrito, con los datos del cliente: `client add` reescribe
+    // la ficha entera y teclearlo de memoria es perder el NIF sin querer.
+    strict_1.default.match(es.out, /estela client add --id acme --name "ACME" --currency EUR --tax-id "B-1" --email "ap@acme.test" --language <es\|en>/);
+    const en = estela(db, "en", "share", "--project", "p", "--out", out);
+    strict_1.default.equal(htmlLang(out), "en");
+    strict_1.default.match(en.out, /It comes out in English, your terminal's language/);
+});
+(0, node_test_1.test)("el idioma del cliente manda sobre el de la terminal, y no hay aviso", () => {
+    // Es el caso para el que existe todo esto: terminal en inglés, cliente en español.
+    const { db, dir } = preparar("es");
+    const out = (0, node_path_1.join)(dir, "r.html");
+    const r = estela(db, "en", "share", "--project", "p", "--out", out);
+    strict_1.default.equal(r.code, 0, r.out);
+    strict_1.default.equal(htmlLang(out), "es", "el documento sale en el idioma del cliente");
+    strict_1.default.doesNotMatch(r.out, /It comes out in|To set it/, "ya está decidido: no se avisa");
+    strict_1.default.match(r.out, /Report:/, "lo que imprime la terminal sigue en el idioma de la terminal");
+});
+(0, node_test_1.test)("--lang en el comando manda sobre todo", () => {
+    const { db, dir } = preparar("es");
+    const out = (0, node_path_1.join)(dir, "r.html");
+    const r = estela(db, "es", "share", "--project", "p", "--out", out, "--lang", "en");
+    strict_1.default.equal(r.code, 0, r.out);
+    strict_1.default.equal(htmlLang(out), "en");
+    strict_1.default.doesNotMatch(r.out, /To set it|Para fijarlo/);
+});
+// ── export y report ─────────────────────────────────────────────────────
+(0, node_test_1.test)("el CSV sale en el idioma del cliente; por la salida estándar no lleva ningún aviso dentro", () => {
+    const { db, dir } = preparar("en");
+    const aFichero = estela(db, "es", "export", "--project", "p", "--out", (0, node_path_1.join)(dir, "h.csv"));
+    strict_1.default.equal(aFichero.code, 0, aFichero.out);
+    strict_1.default.ok((0, node_fs_1.readFileSync)((0, node_path_1.join)(dir, "h.csv"), "utf8").includes("date,start,end,hours"));
+    // Sin idioma fijado y por stdout: el aviso se colaría dentro del CSV.
+    const sin = preparar();
+    const porStdout = estela(sin.db, "es", "export", "--project", "p");
+    strict_1.default.equal(porStdout.code, 0, porStdout.out);
+    strict_1.default.doesNotMatch(porStdout.out, /Para fijarlo|Sale en/);
+    strict_1.default.ok(porStdout.out.replace("", "").startsWith("fecha,inicio"));
+});
+(0, node_test_1.test)("el PDF del informe de horas sale en el idioma del cliente", () => {
+    const en = preparar("en");
+    const pdf = (0, node_path_1.join)(en.dir, "f.pdf");
+    const r = estela(en.db, "es", "report", "--project", "p", "--cutoff", "2026-08-31", "--dry-run", "--pdf", pdf);
+    strict_1.default.equal(r.code, 0, r.out);
+    const texto = (0, node_fs_1.readFileSync)(pdf).toString("latin1");
+    strict_1.default.ok(texto.includes("(HOURS REPORT)"));
+    strict_1.default.ok(!texto.includes("INFORME DE HORAS"));
+    const es = preparar("es");
+    const pdfEs = (0, node_path_1.join)(es.dir, "f.pdf");
+    estela(es.db, "en", "report", "--project", "p", "--cutoff", "2026-08-31", "--dry-run", "--pdf", pdfEs);
+    strict_1.default.ok((0, node_fs_1.readFileSync)(pdfEs).toString("latin1").includes("(INFORME DE HORAS)"));
+});
+// ── client add ──────────────────────────────────────────────────────────
+const idiomaEnBase = (db) => {
+    const conn = (0, schema_js_1.openDatabase)(db);
+    try {
+        return store.getClient(conn, "acme")?.language;
+    }
+    finally {
+        conn.close();
+    }
+};
+(0, node_test_1.test)("client add --language lo fija, volver a ejecutarlo sin él lo conserva, y auto lo quita", () => {
+    const { db } = preparar();
+    const fija = estela(db, "es", "client", "add", "--id", "acme", "--name", "ACME", "--currency", "EUR", "--language", "en");
+    strict_1.default.equal(fija.code, 0, fija.out);
+    strict_1.default.match(fija.out, /Sus documentos salen en inglés/);
+    strict_1.default.equal(idiomaEnBase(db), "en");
+    // Cambiar un correo no puede cambiar el idioma de los PDFs sin avisar.
+    estela(db, "es", "client", "add", "--id", "acme", "--name", "ACME", "--currency", "EUR", "--email", "nuevo@acme.test");
+    strict_1.default.equal(idiomaEnBase(db), "en", "sin --language se conserva el que había");
+    estela(db, "es", "client", "add", "--id", "acme", "--name", "ACME", "--currency", "EUR", "--language", "auto");
+    strict_1.default.equal(idiomaEnBase(db), undefined, "auto vuelve a seguir la terminal");
+});
+(0, node_test_1.test)("client add rechaza un idioma que no existe, sin guardar nada", () => {
+    const { db } = preparar();
+    const r = estela(db, "es", "client", "add", "--id", "acme", "--name", "Otro", "--currency", "EUR", "--language", "fr");
+    strict_1.default.notEqual(r.code, 0);
+    strict_1.default.match(r.out, /--language admite es, en o auto, y recibí "fr"/);
+    const conn = (0, schema_js_1.openDatabase)(db);
+    try {
+        strict_1.default.equal(store.getClient(conn, "acme").name, "ACME", "no se tocó la ficha");
+    }
+    finally {
+        conn.close();
+    }
+});
+//# sourceMappingURL=cli-idioma.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-idioma.test.js","sourceRoot":"","sources":["../src/cli-idioma.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":";AAuCA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA0kDpD,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAuCA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmrDpD,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/cli.js

@@ -67,10 +67,11 @@ const auth_js_1 = require("./cloud/auth.js");
 const client_js_1 = require("./cloud/client.js");
 const cost_js_1 = require("./pricing/cost.js");
 Object.defineProperty(exports, "breakdownOfTurn", { enumerable: true, get: function () { return cost_js_1.breakdownOfTurn; } });
-const claude_js_1 = require("./watchers/claude.js");
+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 labels_js_1 = require("./i18n/labels.js");
 const HELP_ES = `
 estela — registro de horas para desarrollo asistido por IA
 
@@ -83,10 +84,17 @@ estela — registro de horas para desarrollo asistido por IA
 
   estela client add --id <id> --name <nombre> --currency <EUR|USD|...>
                     [--tax-id <NIF/CIF>] [--email <a@b.com>]
+                    [--language es|en|auto]
         --tax-id y --email son los datos del cliente que saldrán impresos en
         el informe de "estela report". Repetir el comando con el mismo --id
         reescribe la ficha entera: vuelve a pasar todo lo que quieras
         conservar, lo que omitas se queda vacío.
+        --language es el idioma de lo que recibe ESE cliente: el PDF, el CSV,
+        el informe y el panel compartido. Es del cliente y no de tu terminal:
+        puedes usar Estela en español y facturarle a una empresa en inglés.
+        Sin --language se usa el de tu terminal (y se te avisa). Es lo único
+        que NO se borra al repetir el comando; "auto" lo quita a propósito.
+        Un "--lang en" suelto en cualquier comando manda sobre todo.
   estela project add --id <id> --client <id> --name <nombre> --repo <ruta>
                      [--rounding <min>] [--ai-cost absorbed|passthrough]
   estela project close --project <id>
@@ -210,10 +218,17 @@ estela — time tracking for AI-assisted development
 
   estela client add --id <id> --name <name> --currency <EUR|USD|...>
                     [--tax-id <tax ID>] [--email <a@b.com>]
+                    [--language es|en|auto]
         --tax-id and --email are the client details printed on the report
         from "estela report". Running the command again with the same --id
         rewrites the whole record: pass everything you want to keep again,
         anything you leave out is cleared.
+        --language is the language of what THAT client receives: the PDF, the
+        CSV, the report and the shared panel. It belongs to the client, not to
+        your terminal: you can use Estela in Spanish and bill a company in
+        English. Without --language your terminal's is used (and you're told).
+        It's the one thing that is NOT cleared when you run the command again;
+        "auto" removes it on purpose. A bare "--lang en" on any command wins.
   estela project add --id <id> --client <id> --name <name> --repo <path>
                      [--rounding <min>] [--ai-cost absorbed|passthrough]
   estela project close --project <id>
@@ -360,20 +375,34 @@ function required(args, key) {
 }
 class UserError extends Error {
 }
+/** El `--lang` escrito en el comando, si es uno que existe. Distinto del de la terminal. */
+function explicitLang(args) {
+    const v = str(args, "lang");
+    return v === "es" || v === "en" ? v : undefined;
+}
 /**
- * Nombre de un tipo de trabajo en el idioma de la terminal. WORK_KIND_LABELS
- * vive en `shared` y está en español; aquí se traduce sin tocar ese paquete.
+ * En qué idioma sale el documento que recibe este cliente: `--lang`, luego el
+ * idioma que se le fijó, y solo si nada de eso, el de la terminal.
  */
-function kindLabel(kind) {
-    switch (kind) {
-        case "development": return (0, index_js_1.tr) `Desarrollo`;
-        case "meeting": return (0, index_js_1.tr) `Reunión`;
-        case "research": return (0, index_js_1.tr) `Investigación`;
-        case "review": return (0, index_js_1.tr) `Revisión`;
-        case "travel": return (0, index_js_1.tr) `Desplazamiento`;
-        case "support": return (0, index_js_1.tr) `Soporte`;
-        case "other": return (0, index_js_1.tr) `Otro`;
-    }
+function docLangOf(args, client) {
+    return (0, index_js_1.documentLang)({ explicit: explicitLang(args), clientLanguage: client.language });
+}
+/**
+ * Si el idioma salió de la terminal, y no de una decisión, se dice — con el
+ * comando ya escrito. `client add` reescribe la ficha entera, así que pedirle a
+ * alguien que lo teclee de memoria es pedirle que pierda el NIF sin querer.
+ */
+function hintDocLang(args, client, lang) {
+    if (client.language || explicitLang(args))
+        return;
+    const dice = lang === "es" ? (0, index_js_1.tr) `español` : (0, index_js_1.tr) `inglés`;
+    const cmd = `estela client add --id ${client.id} --name ${JSON.stringify(client.name)} ` +
+        `--currency ${client.currency}` +
+        (client.taxId ? ` --tax-id ${JSON.stringify(client.taxId)}` : "") +
+        (client.email ? ` --email ${JSON.stringify(client.email)}` : "") +
+        ` --language <es|en>`;
+    console.log((0, index_js_1.tr) `\n  Sale en ${dice}, el idioma de tu terminal: a este cliente no se le fijó ninguno.`);
+    console.log((0, index_js_1.tr) `  Para fijarlo: ${cmd}`);
 }
 // ---------------------------------------------------------------------------
 /**
@@ -382,9 +411,24 @@ function kindLabel(kind) {
  * Quien instala la CLI no tiene forma de arrancar el servidor: hasta ahora
  * vivía en un script del repositorio, que solo existe si te lo has clonado.
  */
+/**
+ * Arranca el panel convirtiendo el fallo en algo legible.
+ *
+ * `startServer` ya rechaza con una frase en vez de un errno, pero si llega
+ * como Error normal, el catch del final imprime el objeto entero con su
+ * traza. Como UserError, sale la frase sola.
+ */
+async function arrancarPanel(opciones) {
+    try {
+        return await (0, server_js_1.startServer)(opciones);
+    }
+    catch (error) {
+        throw new UserError(error instanceof Error ? error.message : String(error));
+    }
+}
 async function cmdWeb(args, dbPath) {
     const port = Number(str(args, "port") ?? 4319);
-    const url = await (0, server_js_1.startServer)({ port, dbPath });
+    const url = await arrancarPanel({ port, dbPath });
     console.log((0, index_js_1.tr) `\n  Estela  ${url}`);
     console.log((0, index_js_1.tr) `  Datos:  ${dbPath}`);
     console.log((0, index_js_1.tr) `\n  Ctrl+C para parar.\n`);
@@ -410,7 +454,7 @@ async function cmdDemo(args, dbPath) {
         db.close();
     }
     const port = Number(str(args, "port") ?? 4320);
-    const url = await (0, server_js_1.startServer)({ port, dbPath: rutaDemo, autoImportMinutes: 0, demo: true });
+    const url = await arrancarPanel({ port, dbPath: rutaDemo, autoImportMinutes: 0, demo: true });
     console.log((0, index_js_1.tr) `\n  Estela — demo con datos inventados  ${url}`);
     console.log((0, index_js_1.tr) `  No es tu trabajo: no se ha tocado tu base ni se ha leído nada tuyo.`);
     console.log((0, index_js_1.tr) `  Para el tuyo de verdad:  estela setup`);
@@ -447,13 +491,45 @@ async function cmdLogout(dbPath) {
  * Dos minutos, sin preguntas y sin cuenta. Si al terminar esa persona no ve
  * algo cierto sobre su propio trabajo, no habrá una segunda ejecución.
  */
+/** Nombre del agente tal y como lo llama quien lo usa, no como lo llamamos aquí. */
+function agentName(agent) {
+    switch (agent) {
+        case "claude-code": return "Claude Code";
+        case "codex": return "Codex";
+        case "cursor": return "Cursor";
+        case "gemini-cli": return "Gemini CLI";
+    }
+}
+/**
+ * El parte de un escaneo.
+ *
+ * Se imprime por agente y no sumado: si Codex cambia de formato y empieza a
+ * dar registros malformados, un total conjunto lo diluye con la salud de
+ * Claude Code y el canario deja de avisar de nada.
+ */
+function printScanReport(scan) {
+    const r = scan.report;
+    console.log(`  ${agentName(scan.agent)}`);
+    console.log((0, index_js_1.tr) `    ${r.filesRead} archivos · ${r.recordsSeen} registros`);
+    console.log((0, index_js_1.tr) `    ${r.turnsAccepted} turnos aceptados`);
+    console.log((0, index_js_1.tr) `    ${r.duplicatesDropped} duplicados descartados` +
+        (r.turnsAccepted > 0
+            ? (0, index_js_1.tr) ` (${(r.duplicatesDropped / (r.turnsAccepted + r.duplicatesDropped) * 100).toFixed(0)}% de las filas)`
+            : ""));
+    console.log((0, index_js_1.tr) `    ${r.unknownRecords} registros internos ignorados · ${r.malformedRecords} malformados`);
+    if (r.producerVersions.length) {
+        console.log((0, index_js_1.tr) `    versiones: ${r.producerVersions.join(", ")}`);
+    }
+    for (const warning of r.warnings)
+        console.warn(`  ⚠ ${agentName(scan.agent)}: ${warning}`);
+}
 async function cmdSetup(args, dbPath) {
     const db = (0, schema_js_1.openDatabase)(dbPath);
     try {
         console.log((0, index_js_1.tr) `\nEstela\n`);
         console.log((0, index_js_1.tr) `Leyendo lo que tus agentes ya guardaron en disco…`);
-        const scan = await (0, claude_js_1.scanClaudeCode)({});
-        const turns = (0, claude_js_1.resolveScratchpads)(scan.turns);
+        const scans = await (0, agents_js_1.scanAgents)({});
+        const turns = (0, agents_js_1.allTurns)(scans);
         // Los repos no pueden salir solo de los transcripts: quien programa sin
         // IA, o con un agente que no deja rastro en ~/.claude (Cursor, Copilot),
         // tenía cero repos que mirar y `setup` se rendía ahí mismo — aunque la
@@ -469,19 +545,22 @@ async function cmdSetup(args, dbPath) {
         if (cwdRoot)
             repos.add(cwdRoot);
         if (turns.length === 0 && repos.size === 0) {
-            console.log((0, index_js_1.tr) `\n  No se han encontrado sesiones de Claude Code en ~/.claude, ni`);
-            console.log((0, index_js_1.tr) `  un repositorio de Git en esta carpeta. Corre esto de nuevo desde`);
+            console.log((0, index_js_1.tr) `\n  No se han encontrado sesiones de agentes en ~/.claude ni ~/.codex,`);
+            console.log((0, index_js_1.tr) `  ni un repositorio de Git en esta carpeta. Corre esto de nuevo desde`);
             console.log((0, index_js_1.tr) `  dentro de tu proyecto, o trabaja un rato con tu agente y vuelve.\n`);
             return;
         }
         if (turns.length > 0) {
             store.saveTurns(db, turns);
-            store.logScan(db, "claude-code", scan.report);
-            console.log((0, index_js_1.tr) `  ${scan.report.turnsAccepted} turnos · ` +
-                (0, index_js_1.tr) `${scan.report.producerVersions.length} versiones de Claude Code`);
+            for (const scan of scans)
+                store.logScan(db, scan.agent, scan.report);
+            // Nombrar los agentes encontrados, en vez de contar versiones: es lo
+            // que quien acaba de instalar quiere confirmar —que ha visto lo suyo—.
+            const vistos = scans.filter((s) => s.report.turnsAccepted > 0).map((s) => agentName(s.agent));
+            console.log((0, index_js_1.tr) `  ${turns.length} turnos · ${vistos.join(", ")}`);
         }
         else {
-            console.log((0, index_js_1.tr) `  No se han encontrado sesiones de Claude Code en ~/.claude —`);
+            console.log((0, index_js_1.tr) `  No se han encontrado sesiones de agentes en ~/.claude ni ~/.codex —`);
             console.log((0, index_js_1.tr) `  sin problema, se reconstruye igual desde tus commits de Git.`);
         }
         console.log((0, index_js_1.tr) `\nBuscando repositorios… (${repos.size})`);
@@ -536,29 +615,25 @@ async function cmdImport(args, dbPath) {
         const repoFilter = str(args, "repo");
         const repoPaths = repoFilter ? [(0, node_path_1.resolve)(repoFilter)] : undefined;
         console.log((0, index_js_1.tr) `Leyendo transcripts de agentes…`);
-        const scan = await (0, claude_js_1.scanClaudeCode)({
+        const scans = await (0, agents_js_1.scanAgents)({
             ...(since ? { since } : {}),
             ...(repoPaths ? { repoPaths } : {}),
         });
-        const report = scan.report;
         // Devolver al repositorio el trabajo hecho en scratchpads, o esas horas
         // quedan sin proyecto y desaparecen del parte.
-        const turns = (0, claude_js_1.resolveScratchpads)(scan.turns);
-        const rescued = turns.filter((t, i) => t.repoPath !== scan.turns[i].repoPath).length;
+        const turns = (0, agents_js_1.allTurns)(scans);
+        const rescued = scans.reduce((n, s) => n + s.scratchpadsResolved, 0);
         const savedTurns = store.saveTurns(db, turns);
-        store.logScan(db, "claude-code", report);
-        console.log((0, index_js_1.tr) `  ${report.filesRead} archivos · ${report.recordsSeen} registros`);
-        console.log((0, index_js_1.tr) `  ${report.turnsAccepted} turnos aceptados · ${savedTurns} nuevos`);
-        console.log((0, index_js_1.tr) `  ${report.duplicatesDropped} duplicados descartados` +
-            (report.turnsAccepted > 0
-                ? (0, index_js_1.tr) ` (${(report.duplicatesDropped / (report.turnsAccepted + report.duplicatesDropped) * 100).toFixed(0)}% de las filas)`
-                : ""));
-        console.log((0, index_js_1.tr) `  ${report.unknownRecords} registros internos ignorados · ${report.malformedRecords} malformados`);
-        if (report.producerVersions.length) {
-            console.log((0, index_js_1.tr) `  versiones de Claude Code: ${report.producerVersions.join(", ")}`);
-        }
-        for (const warning of report.warnings)
-            console.warn(`  ⚠ ${warning}`);
+        for (const scan of scans)
+            store.logScan(db, scan.agent, scan.report);
+        // Un bloque por agente, y solo de los que tienen algo. Quien no use Codex
+        // no debe leer cuatro líneas de ceros para enterarse de eso.
+        console.log((0, index_js_1.tr) `  ${savedTurns} turnos nuevos guardados`);
+        for (const scan of scans) {
+            if (scan.report.filesRead === 0)
+                continue;
+            printScanReport(scan);
+        }
         // Commits de cada repositorio que aparece en los transcripts, MÁS todo
         // repo ya vinculado a un proyecto aunque ningún transcript lo mencione
         // — si no, un proyecto que `setup` acaba de registrar desde el
@@ -680,14 +755,28 @@ function cmdClientAdd(args, dbPath) {
     const db = (0, schema_js_1.openDatabase)(dbPath);
     try {
         const currency = required(args, "currency").toUpperCase();
+        const id = required(args, "id");
+        // El idioma es la única parte de la ficha que NO se borra al repetir el
+        // comando sin ella: quien vuelve a ejecutar `client add` solo para cambiar un
+        // correo no espera que los PDFs de ese cliente cambien de idioma sin avisar.
+        // "auto" es la forma de quitarlo a propósito.
+        const asked = str(args, "language");
+        if (asked !== undefined && asked !== "es" && asked !== "en" && asked !== "auto") {
+            throw new UserError((0, index_js_1.tr) `--language admite es, en o auto, y recibí "${asked}".`);
+        }
+        const language = asked === "auto" ? undefined : (asked ?? store.getClient(db, id)?.language);
         store.upsertClient(db, {
-            id: required(args, "id"),
+            id,
             name: required(args, "name"),
             currency,
             ...(str(args, "tax-id") ? { taxId: str(args, "tax-id") } : {}),
             ...(str(args, "email") ? { email: str(args, "email") } : {}),
+            ...(language ? { language } : {}),
         });
         console.log((0, index_js_1.tr) `Cliente "${required(args, "name")}" guardado. Factura en ${currency}.`);
+        if (language) {
+            console.log((0, index_js_1.tr) `  Sus documentos salen en ${language === "es" ? (0, index_js_1.tr) `español` : (0, index_js_1.tr) `inglés`}.`);
+        }
     }
     finally {
         db.close();
@@ -928,7 +1017,8 @@ function cmdShare(args, dbPath) {
         const to = str(args, "to") ?? (0, shared_1.localDate)(new Date());
         const from = str(args, "from") ?? to.slice(0, 8) + "01";
         const rates = store.getRates(db, projectId);
-        const html = (0, share_js_1.buildShareReport)({
+        const lang = docLangOf(args, client);
+        const html = (0, index_js_1.withLang)(lang, () => (0, share_js_1.buildShareReport)({
             project, client,
             entries: store.getTimeEntries(db, projectId),
             from, to,
@@ -941,7 +1031,7 @@ function cmdShare(args, dbPath) {
             commitsOf: (hashes) => hashes.length
                 ? db.prepare(`SELECT hash, subject FROM commits WHERE hash IN (${hashes.map(() => "?").join(",")})`).all(...hashes)
                 : [],
-        });
+        }));
         const out = str(args, "out") ?? `informe-${projectId}-${to}.html`;
         (0, node_fs_1.writeFileSync)(out, html, "utf8");
         console.log((0, index_js_1.tr) `\nInforme: ${out}`);
@@ -951,6 +1041,7 @@ function cmdShare(args, dbPath) {
             console.log((0, index_js_1.tr) `\n  Incluye horas y commits. Sin importes (añade --with-amounts) y sin`);
             console.log((0, index_js_1.tr) `  consumo de IA, que es tuyo mientras la pagues tú.`);
         }
+        hintDocLang(args, client, lang);
     }
     finally {
         db.close();
@@ -991,7 +1082,7 @@ function cmdLog(args, dbPath) {
             throw new UserError((0, index_js_1.tr) `Fecha inválida: ${day}`);
         // A media mañana: no sabemos la hora real y fingir precisión sería peor.
         const startedAt = new Date(`${day}T10:00:00`);
-        const what = str(args, "what") ?? kindLabel(kind);
+        const what = str(args, "what") ?? (0, labels_js_1.kindLabel)(kind);
         const id = store.saveTimeEntry(db, {
             projectId,
             startedAt,
@@ -1012,7 +1103,7 @@ function cmdLog(args, dbPath) {
         const amount = rate
             ? ` · ${(0, shared_1.formatMoney)({ amount: Math.round((rate.amount * seconds) / 3600), currency: rate.currency })}`
             : "";
-        console.log(`\n${kindLabel(kind)} · ${(0, shared_1.formatDuration)(seconds)}${amount}`);
+        console.log(`\n${(0, labels_js_1.kindLabel)(kind)} · ${(0, shared_1.formatDuration)(seconds)}${amount}`);
         console.log(`  ${what}`);
         console.log(`  ${project.name} · ${day}`);
         console.log((0, index_js_1.tr) `\n  Registro manual: un import no lo va a tocar.  (${id})`);
@@ -1057,6 +1148,7 @@ async function cmdPublish(args, dbPath) {
                 ...(clientes?.length ? { clients: clientes } : {}),
                 withAmounts: args.flags["with-amounts"] === true,
                 includeTeam: args.flags["no-team"] !== true,
+                ...(explicitLang(args) ? { language: explicitLang(args) } : {}),
             });
         }
         catch (error) {
@@ -1076,6 +1168,8 @@ async function cmdPublish(args, dbPath) {
         console.log((0, index_js_1.tr) `  El token es lo único que protege la página: quien tenga el enlace, entra.`);
         console.log((0, index_js_1.tr) `  Al volver a publicar desde esta máquina, este enlace se reusa solo.`);
         console.log((0, index_js_1.tr) `  Desde otra máquina, pasa --token ${result.token} o el cliente perderá su enlace.`);
+        const owner = store.getClient(db, store.getProject(db, projectId).clientId);
+        hintDocLang(args, owner, docLangOf(args, owner));
     }
     finally {
         db.close();
@@ -1441,11 +1535,15 @@ function cmdExport(args, dbPath) {
             throw new UserError((0, index_js_1.tr) `No existe el proyecto "${projectId}".`);
         const client = store.getClient(db, project.clientId);
         const rates = store.getRates(db, projectId);
-        const csv = (0, csv_js_1.timeEntriesToCsv)(store.getTimeEntries(db, projectId), project, client, (at) => (0, invoice_js_1.rateAt)(rates, projectId, at));
+        const lang = docLangOf(args, client);
+        const csv = (0, index_js_1.withLang)(lang, () => (0, csv_js_1.timeEntriesToCsv)(store.getTimeEntries(db, projectId), project, client, (at) => (0, invoice_js_1.rateAt)(rates, projectId, at)));
         const out = str(args, "out");
         if (out) {
             (0, node_fs_1.writeFileSync)(out, csv, "utf8");
             console.log((0, index_js_1.tr) `CSV: ${out}`);
+            // Solo si va a un fichero: por la salida estándar el aviso se colaría
+            // dentro del propio CSV.
+            hintDocLang(args, client, lang);
         }
         else {
             process.stdout.write(csv);
@@ -1540,13 +1638,16 @@ function cmdInvoice(args, dbPath) {
         const amortized = subs.length
             ? (0, amortize_js_1.shareForProject)((0, amortize_js_1.amortize)(store.consumptionByProjectMonth(db), subs, store.totalConsumptionByMonth(db)), projectId, [...months])
             : null;
-        const invoice = (0, invoice_js_1.issueInvoice)({
+        // Las líneas de un informe se congelan al emitirlo, así que se emiten ya en
+        // el idioma del cliente: es el que verá en el PDF y en el CSV.
+        const lang = docLangOf(args, client);
+        const invoice = (0, index_js_1.withLang)(lang, () => (0, invoice_js_1.issueInvoice)({
             client, project,
             rates: store.getRates(db, projectId),
             entries, cutoffAt, number,
             ...(fx ? { usdFxRate: Number(fx) } : {}),
             ...(amortized ? { aiAmortized: amortized } : {}),
-        });
+        }));
         console.log((0, invoice_js_1.renderInvoice)(invoice, client, project));
         // Coste real de IA del periodo: la cuota de tus suscripciones repartida
         // por consumo. Es lo que de verdad te costó, frente a la tarifa API.
@@ -1567,7 +1668,7 @@ function cmdInvoice(args, dbPath) {
         const pdfPath = str(args, "pdf");
         if (pdfPath) {
             const issuerName = str(args, "from-name");
-            const pdf = (0, invoice_pdf_js_1.invoiceToPdf)(invoice, client, project, {
+            const pdf = (0, index_js_1.withLang)(lang, () => (0, invoice_pdf_js_1.invoiceToPdf)(invoice, client, project, {
                 ...(issuerName ? {
                     issuer: {
                         name: issuerName,
@@ -1576,15 +1677,17 @@ function cmdInvoice(args, dbPath) {
                     },
                 } : {}),
                 ...(invoice.aiAmortized ? { amortizedAiCost: invoice.aiAmortized } : {}),
-            });
+            }));
             (0, node_fs_1.writeFileSync)(pdfPath, pdf);
             console.log((0, index_js_1.tr) `\nPDF: ${pdfPath}  (${(pdf.length / 1024).toFixed(1)} KB, ${invoice.lines.length} conceptos)`);
         }
         const csvPath = str(args, "csv");
         if (csvPath) {
-            (0, node_fs_1.writeFileSync)(csvPath, (0, csv_js_1.invoiceToCsv)(invoice, client, project), "utf8");
+            (0, node_fs_1.writeFileSync)(csvPath, (0, index_js_1.withLang)(lang, () => (0, csv_js_1.invoiceToCsv)(invoice, client, project)), "utf8");
             console.log((0, index_js_1.tr) `CSV: ${csvPath}`);
         }
+        if (pdfPath || csvPath)
+            hintDocLang(args, client, lang);
         if (dryRun) {
             console.log((0, index_js_1.tr) `\n[--dry-run] No se guardó nada. Repite sin --dry-run para emitirlo.`);
             return;