estela 0.2.4 → 0.3.2

package/dist/plan-report.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPlanReport = renderPlanReport;
+exports.recommendationText = recommendationText;
+exports.pricesStale = pricesStale;
+exports.renderNoPlan = renderNoPlan;
+exports.renderNoData = renderNoData;
+exports.planToJson = planToJson;
+const index_js_1 = require("./i18n/index.js");
+const plan_prices_js_1 = require("./plan-prices.js");
+const statusline_js_1 = require("./statusline.js");
+const ESC = "\x1b[";
+const JADE = `${ESC}38;2;70;192;167m`; // #46C0A7, como en la status line
+const AMBER = `${ESC}38;2;221;168;90m`;
+const DIM = `${ESC}90m`;
+const RESET = `${ESC}0m`;
+const LABEL = 21;
+function renderPlanReport(a, o) {
+    const paint = (code, text) => (o.color ? `${code}${text}${RESET}` : text);
+    const row = (label, value) => `${label.padEnd(LABEL)}${value}`;
+    const out = [];
+    out.push(header(a, paint));
+    out.push("");
+    const f = a.fiveHour;
+    out.push(row((0, index_js_1.tr) `Ventanas de 5 h`, f.windows.length === 0
+        ? (0, index_js_1.tr) `ninguna completa todavía`
+        : (0, index_js_1.tr) `${f.windows.length} ventanas · pico mediano ${pct(f.medianPeak)} % · p90 ${pct(f.p90Peak)} % · máximo ${pct(f.maxPeak)} %`));
+    out.push(row((0, index_js_1.tr) `Topes (≥95 %)`, String(f.caps)));
+    if (f.stoppedMs > 0) {
+        out.push(row((0, index_js_1.tr) `Parado tras topes`, (0, index_js_1.tr) `hasta ${(0, statusline_js_1.compactDuration)(f.stoppedMs / 1000)} (estimado: no sabemos si seguías trabajando)`));
+    }
+    const w = a.week;
+    out.push(row((0, index_js_1.tr) `Semana`, w.weeks.length === 0
+        ? (0, index_js_1.tr) `sin datos de la semana`
+        : (0, index_js_1.tr) `pico mediano ${pct(w.medianPeak)} % · máximo ${pct(w.maxPeak)} % · ${w.weeksAtOrAbove90} semanas ≥ 90 %`));
+    if (o.blocks) {
+        out.push(row((0, index_js_1.tr) `Bloqueos (429)`, (0, index_js_1.tr) `${o.blocks.fiveHour} de 5 h · ${o.blocks.sevenDay} semanales, según los transcripts de Claude Code`));
+    }
+    if (f.windows.length > 0) {
+        out.push("");
+        out.push((0, index_js_1.tr) `Si estuvieras en…`);
+        for (const alt of [...a.alternatives].sort((x, y) => x.plan.monthlyUsd - y.plan.monthlyUsd)) {
+            out.push(`  ${`${alt.plan.name} (${usd(alt.plan.monthlyUsd)})`.padEnd(LABEL - 2)}${alternativeText(alt, a)}`);
+        }
+    }
+    out.push("");
+    if (a.dataState === "insufficient") {
+        out.push(paint(AMBER, (0, index_js_1.tr) `Datos de ${a.daysWithData} días. La recomendación necesita al menos 14.`));
+    }
+    else if (a.recommendation) {
+        const label = a.dataState === "provisional"
+            ? (0, index_js_1.tr) `Recomendación (provisional, ${a.daysWithData} días)`
+            : (0, index_js_1.tr) `Recomendación`;
+        const text = recommendationText(a);
+        out.push(row(label, paint(a.recommendation.kind === "tight" ? AMBER : JADE, text)));
+        const diff = priceDiffText(a);
+        if (diff)
+            out.push(row("", paint(DIM, diff)));
+    }
+    out.push("");
+    out.push((0, index_js_1.tr) `Límite semanal entre planes: Anthropic no publica la relación. No lo estimamos.`);
+    out.push((0, index_js_1.tr) `Basado en el multiplicador por sesión publicado por Anthropic:`);
+    out.push(plan_prices_js_1.MULTIPLIER_SOURCE);
+    out.push((0, index_js_1.tr) `Anthropic puede cambiar los límites; repite el análisis cada mes.`);
+    out.push((0, index_js_1.tr) `Precios según la web de Anthropic a ${plan_prices_js_1.PRICES_CHECKED_AT}; compruébalo: ${plan_prices_js_1.PRICES_SOURCE}`);
+    if (pricesStale(o.now))
+        out.push(paint(AMBER, (0, index_js_1.tr) `Esa fecha tiene más de ${plan_prices_js_1.PRICES_STALE_DAYS} días: los precios pueden estar desactualizados.`));
+    return out.join("\n");
+}
+function header(a, paint) {
+    return `${paint(JADE, "estela")} plan · ${a.plan.name} ${(0, index_js_1.tr) `(desde ${day(a.since)})`} · ${(0, index_js_1.tr) `${a.daysWithData} días con datos`}`;
+}
+function alternativeText(alt, a) {
+    const n = a.fiveHour.windows.length;
+    if (alt.direction === "higher") {
+        if (a.fiveHour.caps === 0)
+            return (0, index_js_1.tr) `sin topes, igual que ahora`;
+        return (0, index_js_1.tr) `p90 equivalente ${pct(alt.p90Equivalent)} % · habrías evitado ${alt.capsAvoided} de ${a.fiveHour.caps} topes (con el uso que llegó a registrarse)`;
+    }
+    return alt.blockedWindows === 0
+        ? (0, index_js_1.tr) `p90 equivalente ${pct(alt.p90Equivalent)} % · no te habría bloqueado en ninguna de las ${n} ventanas`
+        : (0, index_js_1.tr) `p90 equivalente ${pct(alt.p90Equivalent)} % · te habría bloqueado en ${alt.blockedWindows} de ${n} ventanas`;
+}
+function recommendationText(a) {
+    const r = a.recommendation;
+    if (!r)
+        return "";
+    switch (r.kind) {
+        case "tight":
+            return r.higher && r.capsAvoided !== null
+                ? (0, index_js_1.tr) `Vas justo con tu plan. Con ${r.higher.name} habrías evitado ${r.capsAvoided} de ${a.fiveHour.caps} topes.`
+                : (0, index_js_1.tr) `Vas justo con tu plan.`;
+        case "enough":
+            return (0, index_js_1.tr) `Con los datos de estas ${r.weeks} semanas, el plan ${r.plan.name} te habría bastado en todas las ventanas de 5 h.`;
+        case "almost":
+            return (0, index_js_1.tr) `El plan ${r.plan.name} te habría bastado casi siempre: te habría bloqueado ${r.blocked} veces en estas semanas.`;
+        case "fits":
+            return (0, index_js_1.tr) `Tu plan actual encaja con tu uso.`;
+    }
+}
+/** La diferencia de precio de lo que se recomienda, si es cambiar de plan. */
+function priceDiffText(a) {
+    const r = a.recommendation;
+    const other = r?.kind === "enough" || r?.kind === "almost" ? r.plan
+        : r?.kind === "tight" ? r.higher : null;
+    if (!other)
+        return null;
+    const diff = other.monthlyUsd - a.plan.monthlyUsd;
+    return diff < 0
+        ? (0, index_js_1.tr) `${usd(-diff)} menos al mes, según la web de Anthropic a ${plan_prices_js_1.PRICES_CHECKED_AT}; compruébalo.`
+        : (0, index_js_1.tr) `${usd(diff)} más al mes, según la web de Anthropic a ${plan_prices_js_1.PRICES_CHECKED_AT}; compruébalo.`;
+}
+function pricesStale(now) {
+    return now.getTime() - Date.parse(`${plan_prices_js_1.PRICES_CHECKED_AT}T00:00:00Z`) > plan_prices_js_1.PRICES_STALE_DAYS * 86_400_000;
+}
+/** Sin plan declarado: cómo declararlo. */
+function renderNoPlan() {
+    return [
+        (0, index_js_1.tr) `estela plan compara tu uso real de Claude con los otros planes. Primero dime cuál pagas:`,
+        "",
+        "  estela plan set pro",
+        "  estela plan set max5",
+        "  estela plan set max20",
+        "",
+        (0, index_js_1.tr) `Si ya lo tenías antes de hoy, añade desde cuándo: --since AAAA-MM-DD`,
+    ].join("\n");
+}
+function renderNoData(a, apiKey, color) {
+    const paint = (code, text) => (color ? `${code}${text}${RESET}` : text);
+    return [
+        header(a, paint), "",
+        apiKey
+            ? (0, index_js_1.tr) `Este análisis solo funciona con planes Pro o Max.`
+            : (0, index_js_1.tr) `Aún no hay datos. Instala la status line (estela statusline install) y vuelve en unos días.`,
+        ...(apiKey ? [] : [(0, index_js_1.tr) `Solo se recogen en Claude Code en la terminal: la extensión de VS Code no ejecuta la status line.`]),
+    ].join("\n");
+}
+// ---------------------------------------------------------------------------
+/**
+ * `estela plan --json`. Estructura estable (documentada en el README):
+ * campos nuevos se pueden añadir, ninguno cambia de nombre ni de significado.
+ */
+function planToJson(a, o) {
+    const r1 = (n) => (n === null ? null : Math.round(n * 10) / 10);
+    const rec = a.recommendation;
+    return {
+        version: 1,
+        plan: { id: a.plan.id, name: a.plan.name, since: a.since.toISOString(), sessionMultiplier: a.plan.sessionMultiplier },
+        period: { from: a.from.toISOString(), to: a.to.toISOString(), days: a.days, daysWithData: a.daysWithData, samples: a.samples },
+        dataState: a.dataState,
+        fiveHour: {
+            windows: a.fiveHour.windows.length,
+            medianPeak: r1(a.fiveHour.medianPeak), p90Peak: r1(a.fiveHour.p90Peak), maxPeak: r1(a.fiveHour.maxPeak),
+            caps: a.fiveHour.caps,
+            stoppedMinutesUpperBound: Math.round(a.fiveHour.stoppedMs / 60_000),
+        },
+        week: {
+            weeks: a.week.weeks.length,
+            medianPeak: r1(a.week.medianPeak), maxPeak: r1(a.week.maxPeak),
+            weeksAtOrAbove90: a.week.weeksAtOrAbove90,
+        },
+        blocks429: o.blocks,
+        alternatives: [...a.alternatives].sort((x, y) => x.plan.monthlyUsd - y.plan.monthlyUsd).map((x) => ({
+            plan: x.plan.id, name: x.plan.name, direction: x.direction,
+            monthlyUsd: x.plan.monthlyUsd, monthlyDiffUsd: x.plan.monthlyUsd - a.plan.monthlyUsd,
+            p90Equivalent: r1(x.p90Equivalent), maxEquivalent: r1(x.maxEquivalent),
+            blockedWindows: x.blockedWindows, capsAvoided: x.capsAvoided,
+        })),
+        recommendation: rec === null ? null : {
+            kind: rec.kind,
+            provisional: a.dataState === "provisional",
+            plan: rec.kind === "enough" || rec.kind === "almost" ? rec.plan.id : rec.kind === "tight" ? rec.higher?.id ?? null : null,
+            blockedWindows: rec.kind === "almost" ? rec.blocked : null,
+            capsAvoided: rec.kind === "tight" ? rec.capsAvoided : null,
+            text: recommendationText(a),
+        },
+        weeklyBetweenPlans: "not_published",
+        sources: {
+            sessionMultiplier: plan_prices_js_1.MULTIPLIER_SOURCE,
+            prices: plan_prices_js_1.PRICES_SOURCE, pricesCheckedAt: plan_prices_js_1.PRICES_CHECKED_AT, pricesStale: pricesStale(o.now),
+        },
+        plans: plan_prices_js_1.CLAUDE_PLANS.map((p) => ({ id: p.id, name: p.name, sessionMultiplier: p.sessionMultiplier, monthlyUsd: p.monthlyUsd })),
+    };
+}
+function pct(n) { return Math.round(n); }
+function usd(n) { return (0, index_js_1.tr) `${n} $`; }
+function day(d) {
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+//# sourceMappingURL=plan-report.js.map

package/dist/server.js

@@ -142,7 +142,7 @@ async function importOnce(dbPath) {
         // Solo tus commits producen horas tuyas.
         const commits = (0, identity_js_1.onlyMine)(allRepoCommits, mine);
         const fromAgents = (0, sessionize_js_1.attachCommits)((0, sessionize_js_1.sessionize)(turns), commits);
-        const fromCommits = (0, sessionize_js_1.withoutOverlap)((0, sessionize_js_1.sessionizeCommits)(commits), fromAgents);
+        const fromCommits = (0, assign_js_1.commitOnlyBlocks)(db, commits, fromAgents);
         // Las mismas reglas que `estela import` (billing/assign.ts). Las horas de
         // subcarpetas y worktrees solo se recuperan si ya se confirmó una vez
         // desde la terminal: el panel no cambia horas importadas en segundo plano
@@ -581,11 +581,11 @@ async function api(req, res, url, dbPath) {
         // recalcular nada: el mismo papel que salió el día que se emitió.
         const reimpresion = /^\/api\/invoices\/([A-Za-z0-9-]+)\/pdf$/.exec(path);
         if (reimpresion && req.method === "GET") {
-            return sendStoredInvoicePdf(db, res, reimpresion[1], url.searchParams.get("author") ?? "");
+            return sendStoredInvoicePdf(db, res, reimpresion[1], url.searchParams.get("author") ?? "", url.searchParams.get("amounts") !== "0");
         }
         if (path === "/api/invoice" && req.method === "POST") {
             const body = await readJson(req);
-            return sendInvoice(db, res, String(body["projectId"] ?? ""), String(body["cutoff"] ?? ""), typeof body["author"] === "string" ? body["author"] : "");
+            return sendInvoice(db, res, String(body["projectId"] ?? ""), String(body["cutoff"] ?? ""), typeof body["author"] === "string" ? body["author"] : "", body["withAmounts"] !== false);
         }
         if (path === "/api/entry" && req.method === "POST") {
             const body = await readJson(req);
@@ -1368,7 +1368,7 @@ function sendReport(db, res, projectId, from, to, withAmounts, author) {
  * congeló al emitirla. Es lo que hace que el papel de agosto siga siendo el
  * papel de agosto cuando se pide en diciembre.
  */
-function sendStoredInvoicePdf(db, res, number, author) {
+function sendStoredInvoicePdf(db, res, number, author, withAmounts) {
     const invoice = store.getInvoice(db, number);
     if (!invoice)
         return json(res, 404, { error: "Esa factura no existe." });
@@ -1382,15 +1382,20 @@ function sendStoredInvoicePdf(db, res, number, author) {
     const pdf = (0, index_js_2.withLang)((0, index_js_2.documentLang)({ clientLanguage: client.language }), () => (0, invoice_pdf_js_1.invoiceToPdf)(invoice, client, project, {
         ...(author ? { issuer: { name: author } } : {}),
         ...(invoice.aiAmortized ? { amortizedAiCost: invoice.aiAmortized } : {}),
+        withAmounts,
     }));
     res.writeHead(200, {
         "Content-Type": "application/pdf",
-        "Content-Disposition": `attachment; filename="${invoice.number}.pdf"`,
+        "Content-Disposition": `attachment; filename="${invoicePdfName(invoice.number, withAmounts)}"`,
         "Content-Length": pdf.length,
     });
     res.end(pdf);
 }
-function sendInvoice(db, res, projectId, cutoffRaw, author) {
+/** Con otro nombre, para no confundir al guardarlos juntos cuál lleva importes. */
+function invoicePdfName(number, withAmounts) {
+    return withAmounts ? `${number}.pdf` : `${number}-sin-importes.pdf`;
+}
+function sendInvoice(db, res, projectId, cutoffRaw, author, withAmounts) {
     const project = store.getProject(db, projectId);
     if (!project)
         return json(res, 404, { error: (0, index_js_2.tr) `No existe el proyecto "${projectId}".` });
@@ -1429,8 +1434,9 @@ function sendInvoice(db, res, projectId, cutoffRaw, author) {
     const pdf = (0, index_js_2.withLang)((0, index_js_2.documentLang)({ clientLanguage: client.language }), () => (0, invoice_pdf_js_1.invoiceToPdf)(invoice, client, project, {
         ...(author ? { issuer: { name: author } } : {}),
         ...(invoice.aiAmortized ? { amortizedAiCost: invoice.aiAmortized } : {}),
+        withAmounts,
     }));
-    const filename = `${invoice.number}.pdf`;
+    const filename = invoicePdfName(invoice.number, withAmounts);
     res.writeHead(200, {
         "Content-Type": "application/pdf",
         "Content-Disposition": `attachment; filename="${filename}"`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "estela",
-  "version": "0.2.4",
+  "version": "0.3.2",
   "description": "Time tracking you never fill in: rebuilds your billable hours from Claude Code, Codex and GitHub Copilot sessions and your Git history, and splits what the AI cost per project.",
   "keywords": [
     "time-tracking",

package/web/app.css

@@ -900,6 +900,7 @@ main.wide { max-width: 1180px; }
    subraye y que se centre como el resto. */
 .invoice-dl{flex:0 0 auto;text-decoration:none;display:inline-flex;
   align-items:center;padding:9px 18px;font-size:.9rem}
+.invoice-dls{flex:0 0 auto;display:flex;gap:8px;flex-wrap:wrap}
 @media(max-width:620px){
   .invoice-row{flex-wrap:wrap}
   .invoice-main{flex:1 1 100%}

package/web/app.js

@@ -1469,8 +1469,12 @@ function renderReports() {
           <div class="report-hours">${fmtDuration(f.totalSeconds)}</div>
           <div class="report-amount">${importe}</div>
         </div>
-        <a class="btn-main invoice-dl" download
-           href="/api/invoices/${encodeURIComponent(f.number)}/pdf">${tr("invoices.download")}</a>
+        <div class="invoice-dls">
+          <a class="btn-main invoice-dl" download
+             href="/api/invoices/${encodeURIComponent(f.number)}/pdf">${tr("invoices.withAmounts")}</a>
+          <a class="chip invoice-dl" download
+             href="/api/invoices/${encodeURIComponent(f.number)}/pdf?amounts=0">${tr("invoices.withoutAmounts")}</a>
+        </div>
       </div>`;
     }).join("") + "</div>");
   }
@@ -1535,6 +1539,7 @@ function renderReports() {
       const projectId = form.dataset.project;
       const cutoff = form.querySelector(".rep-to").value;
       const author = form.querySelector(".rep-author").value;
+      const withAmounts = form.querySelector(".rep-amounts").checked;
       const row = (state.reportsOverview?.unbilled || []).find((r) => r.projectId === projectId);
       const proyecto = row ? row.projectName : projectId;
 
@@ -1542,7 +1547,7 @@ function renderReports() {
 
       btn.disabled = true;
       try {
-        await cutoffAndInvoice(projectId, cutoff, author);
+        await cutoffAndInvoice(projectId, cutoff, author, withAmounts);
         toast(tr("toast.invoiced"));
         await loadReports();
       } catch (error) {
@@ -1561,11 +1566,11 @@ function renderReports() {
  * con un enlace sintético — el mismo patrón que usa cualquier app sin
  * framework para esto.
  */
-async function cutoffAndInvoice(projectId, cutoff, author) {
+async function cutoffAndInvoice(projectId, cutoff, author, withAmounts) {
   const res = await fetch("/api/invoice", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ projectId, cutoff, author }),
+    body: JSON.stringify({ projectId, cutoff, author, withAmounts }),
   });
   if (!res.ok) {
     let message = `Error ${res.status}`;

package/web/i18n.js

@@ -308,9 +308,10 @@
       "reports.allbilled.title": "Todo facturado",
       "reports.allbilled.body": "No queda nada pendiente en este periodo. Lo ya emitido está abajo, y se puede volver a descargar.",
       "invoices.title": "Ya facturado",
-      "invoices.note": "Se reimprime tal y como se emitió: los importes y el reparto de IA quedaron congelados ese día.",
+      "invoices.note": "Se reimprime tal y como se emitió, con o sin importes: las cifras quedaron congeladas ese día.",
       "invoices.upto": "Hasta el {date}",
-      "invoices.download": "Descargar",
+      "invoices.withAmounts": "Con importes",
+      "invoices.withoutAmounts": "Sin importes",
       "reports.noMatch": "Ningún proyecto coincide con «{q}».",
       "reports.client": "{client} · {blocks} · todo lo pendiente desde {date}",
       "reports.from": "Desde",
@@ -613,9 +614,10 @@
       "reports.allbilled.title": "All invoiced",
       "reports.allbilled.body": "Nothing pending in this period. What you already issued is below, and can be downloaded again.",
       "invoices.title": "Already invoiced",
-      "invoices.note": "Reprinted exactly as issued: amounts and the AI split were frozen that day.",
+      "invoices.note": "Reprinted exactly as issued, with or without amounts: the figures were frozen that day.",
       "invoices.upto": "Up to {date}",
-      "invoices.download": "Download",
+      "invoices.withAmounts": "With amounts",
+      "invoices.withoutAmounts": "Without amounts",
       "reports.noMatch": "No project matches “{q}”.",
       "reports.client": "{client} · {blocks} · everything pending since {date}",
       "reports.from": "From",