@trazum/cli 1.47.0 → 1.49.0

package/dist/waiver-log.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Where a waiver's uses are written down.
+ *
+ * The core decides what a use means and what a run of them adds up to; this
+ * decides where the bytes go — the same split every module here follows, so
+ * `@trazum/core` stays browser-safe and the CLI keeps its monopoly on I/O.
+ *
+ * **Append-only, and never rewritten.** There is deliberately no prune, no
+ * compaction and no `--clear`: a record of decisions that the tool can erase
+ * is a record nobody can rely on, and the one thing a waiver history is for is
+ * being awkward six months later. Deleting the file is a thing a person does
+ * with `rm`, on purpose, having seen it.
+ *
+ * **A write that fails never fails the run.** The gate's job is the exit code.
+ * A read-only checkout, a full disk or a directory somebody's CI cannot create
+ * must not turn a passing build red on account of bookkeeping — the failure is
+ * reported and the gate's own verdict stands.
+ *
+ * **A line that will not parse is counted and skipped**, exactly as in the
+ * store. Losing the whole history because one line is broken would be the
+ * worst possible response; pretending the history is complete would be the
+ * second worst.
+ */
+import type { WaiverUse } from '@trazum/core';
+/** One file, not one per month: a waiver history is small and read whole. */
+export declare const WAIVER_LOG = ".trazum/waivers.jsonl";
+export interface WaiverReadResult {
+    uses: WaiverUse[];
+    /** 1-based positions of lines that would not parse. Named, never dropped quietly. */
+    unreadable: number[];
+    /** False when the file does not exist — "nothing recorded" is not "no file". */
+    present: boolean;
+}
+export declare function readWaiverLog(root: string): Promise<WaiverReadResult>;
+/**
+ * Appends one use, and swallows any failure after reporting it.
+ *
+ * Returns the error message rather than throwing, so the caller can print it
+ * beside the gate's own output without the gate ever depending on the write.
+ */
+export declare function appendWaiverUse(root: string, use: WaiverUse): Promise<string | null>;
+//# sourceMappingURL=waiver-log.d.ts.map

package/dist/waiver-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiver-log.d.ts","sourceRoot":"","sources":["../src/waiver-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,qFAAqF;IACrF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuB3E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1F"}

package/dist/waiver-log.js

@@ -0,0 +1,74 @@
+/**
+ * Where a waiver's uses are written down.
+ *
+ * The core decides what a use means and what a run of them adds up to; this
+ * decides where the bytes go — the same split every module here follows, so
+ * `@trazum/core` stays browser-safe and the CLI keeps its monopoly on I/O.
+ *
+ * **Append-only, and never rewritten.** There is deliberately no prune, no
+ * compaction and no `--clear`: a record of decisions that the tool can erase
+ * is a record nobody can rely on, and the one thing a waiver history is for is
+ * being awkward six months later. Deleting the file is a thing a person does
+ * with `rm`, on purpose, having seen it.
+ *
+ * **A write that fails never fails the run.** The gate's job is the exit code.
+ * A read-only checkout, a full disk or a directory somebody's CI cannot create
+ * must not turn a passing build red on account of bookkeeping — the failure is
+ * reported and the gate's own verdict stands.
+ *
+ * **A line that will not parse is counted and skipped**, exactly as in the
+ * store. Losing the whole history because one line is broken would be the
+ * worst possible response; pretending the history is complete would be the
+ * second worst.
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isWaiverUse } from '@trazum/core';
+/** One file, not one per month: a waiver history is small and read whole. */
+export const WAIVER_LOG = '.trazum/waivers.jsonl';
+export async function readWaiverLog(root) {
+    let raw;
+    try {
+        raw = await readFile(join(root, WAIVER_LOG), 'utf8');
+    }
+    catch {
+        // Absent is the normal state of a repository that has never waived
+        // anything, and it is not an error.
+        return { uses: [], unreadable: [], present: false };
+    }
+    const uses = [];
+    const unreadable = [];
+    raw.split('\n').forEach((line, index) => {
+        if (line.trim() === '')
+            return;
+        try {
+            const parsed = JSON.parse(line);
+            if (isWaiverUse(parsed))
+                uses.push(parsed);
+            else
+                unreadable.push(index + 1);
+        }
+        catch {
+            unreadable.push(index + 1);
+        }
+    });
+    return { uses, unreadable, present: true };
+}
+/**
+ * Appends one use, and swallows any failure after reporting it.
+ *
+ * Returns the error message rather than throwing, so the caller can print it
+ * beside the gate's own output without the gate ever depending on the write.
+ */
+export async function appendWaiverUse(root, use) {
+    const path = join(root, WAIVER_LOG);
+    try {
+        await mkdir(join(path, '..'), { recursive: true });
+        await writeFile(path, `${JSON.stringify(use)}\n`, { flag: 'a', mode: 0o600 });
+        return null;
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+//# sourceMappingURL=waiver-log.js.map

package/dist/waiver-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiver-log.js","sourceRoot":"","sources":["../src/waiver-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAUlD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,oCAAoC;QACpC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,WAAW,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;gBACtC,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,GAAc;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trazum/cli",
-  "version": "1.47.0",
+  "version": "1.49.0",
   "description": "Trazum CLI: find where your LLM bill goes, price every finding per month, and enforce token budgets in CI.",
   "license": "MIT",
   "author": "David Mu\u00f1oz Rey",
@@ -37,7 +37,7 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@trazum/core": "1.47.0"
+    "@trazum/core": "1.49.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",

package/src/i18n/en.ts

@@ -1554,6 +1554,8 @@ ${bold('EXAMPLES')}
       `WAIVED — the ${gate} failure above is on the record and silenced until ${until} (${daysLeft} days left): "${reason}". The bill still counts it; only the exit code is quiet, and the day the waiver expires this gate fails again.`,
     waiveExpired: (gate, until, reason) =>
       `The waiver on ${gate} expired on ${until} and no longer silences anything. It was written for: "${reason}". Renew it with a new date and a current reason, or fix what it was covering — an expired waiver left in place is a finding deleted with extra steps.`,
+    waiveNotRecorded: (path, because) =>
+      `  (This waiver was not written to ${path}: ${because}. The gate's verdict above is unaffected.)`,
     summaryNoComparison: () =>
       'No previous log was given, so nothing here says whether the bill moved — a summary without a comparison states the bill, not its stability.',
     summaryFooter: () =>
@@ -1664,7 +1666,9 @@ ${bold('EXAMPLES')}
     nothingMeasured: (dir) =>
       `Nothing is measured yet (the store at ${dir} is empty), so the budget half of every answer will say so. The cost half still answers from the catalogue: offline is a mode, not a failure.`,
     noBudget: () =>
-      'No spend.maxUsd is configured, so "is there budget left" has no subject and every answer says so rather than guessing one.',
+      'No spend.monthlyUsd is configured, so "is there budget left" has no subject and every answer says so rather than guessing one. spend.maxUsd is deliberately not read here: it gates whatever period a log covers, and reading it as a monthly limit is how two surfaces of this tool come to disagree.',
+    partialCoverage: (measuredDays, elapsedDays, period) =>
+      `Only ${measuredDays} of the ${elapsedDays} elapsed days of ${period} carry any measurement, so the consumed figure is a floor on the period rather than the period. Pull the missing days with trazum connect before treating what is left as headroom.`,
     badPort: (value) => `"${value}" is not a port. Give a whole number from 0 to 65535, or use --socket.`,
   },
 
@@ -1740,6 +1744,27 @@ ${bold('EXAMPLES')}
       span === null
         ? `Nothing was older than ${days} days. ${kept} measurements kept, and the append log compacted.`
         : `Deleted ${count} measurements older than ${days} days, covering ${span} and ${usd} of measured spend. ${kept} kept, and the append log compacted to what the store already resolved to.`,
+    budgetHeading: (period) => `Budget for ${period}`,
+    budgetStanding: (consumed, limit, share, measuredDays, periodDays) =>
+      `${consumed} of ${limit} (${share}), measured over ${measuredDays} of the month's ${periodDays} days.`,
+    budgetShape: (shape, elapsedPct, coverage) =>
+      shape === 'ahead'
+        ? `The money is going faster than the calendar: ${elapsedPct}% of the month has elapsed.`
+        : shape === 'behind'
+          ? `The money is going slower than the calendar: ${elapsedPct}% of the month has elapsed.`
+          : shape === 'on-pace'
+            ? `Tracking the calendar: ${elapsedPct}% of the month has elapsed.`
+            : coverage === 'partial'
+              ? 'Whether that is fast or slow for the month cannot be told from a floor: the unmeasured days spent something, and only an overrun would be unarguable.'
+              : 'There is nothing to compare the spend against yet.',
+    budgetNeverForecast: () =>
+      'That is a shape, not a forecast. Where this goes next depends on what you do next, and no arithmetic here knows that.',
+    budgetNothingMeasured: (elapsedDays) =>
+      `Nothing has been measured this month, across ${elapsedDays} elapsed ${elapsedDays === 1 ? 'day' : 'days'}. That is not a budget under control — it is a budget nobody is watching. Run trazum connect to pull what the provider has.`,
+    budgetPartial: (measuredDays, elapsedDays, days) =>
+      `Only ${measuredDays} of ${elapsedDays} elapsed days carry any measurement, so the figure below is a floor on the month rather than the month. Missing: ${days}.`,
+    budgetScopesUnmeasured: (count) =>
+      `${count} budgeted ${count === 1 ? 'scope' : 'scopes'} (per label or per service) cannot be answered from the store: a store record carries a provider and a model, not a workload label. Gate those with trazum profile against a per-call log.`,
   },
 
   connect: {
@@ -1807,6 +1832,33 @@ ${bold('EXAMPLES')}
     unrecognized: (name) => `${name} is neither a stored report nor a saved plan, so it is in no series above.`,
     footer: () =>
       'A series names shapes, not futures. Twenty points make a trend visible; they do not make next month knowable — where these lines go next is yours to judge.',
+    waiverHeading: () => 'What this repository has been living with',
+    waiverSince: (day, uses) =>
+      `${uses} recorded ${uses === 1 ? 'use' : 'uses'} since ${day}, when recording started.`,
+    waiverNoneRecorded: () =>
+      'No waiver has silenced a gate since recording started. Nothing here is inferred from the config — a waiver written down and never hit is not a decision anyone is living with.',
+    waiverHabit: (gate, uses, days, firstDay, lastDay) =>
+      `${gate}: ${uses} ${uses === 1 ? 'use' : 'uses'} across ${days} ${days === 1 ? 'day' : 'days'}, ${firstDay} to ${lastDay}`,
+    waiverVerdict: (verdict) =>
+      verdict === 'used-once'
+        ? 'Used once. Nothing to read into it yet.'
+        : verdict === 'recurring'
+          ? 'The same decision, holding. The gate keeps firing and the reason has not moved.'
+          : verdict === 'renewed-without-revisiting'
+            ? 'The expiry has moved and the reason has not. That is the shape a decision takes when nobody is revisiting it — which is sometimes exactly right, and worth saying out loud either way.'
+            : 'The reason changed between uses. Somebody looked again.',
+    waiverReasonNow: (reason) => `Reason: ${reason}`,
+    waiverReasonsChanged: (count) => `${count} different reasons given over that time.`,
+    waiverExpiriesMoved: (from, to, count) =>
+      `Expiry moved ${count} ${count === 1 ? 'time' : 'times'}: ${from} → ${to}.`,
+    waiverNoLongerConfigured: () =>
+      'Not in the config any more. The decision was reversed; the record keeps it.',
+    waiverNeverUsed: (gates) =>
+      `Waived in the config and never hit by a recorded run: ${gates}. Either the gate stopped failing — good news nobody wrote down — or the waiver names a situation that does not arise. Both are worth deleting.`,
+    waiverUnreadable: (count, path) =>
+      `${count} ${count === 1 ? 'line' : 'lines'} in ${path} could not be read and are not counted above.`,
+    waiverStartsHere: () =>
+      'Nothing before that day exists. This record began when recording did, and no past was reconstructed from the config as it stands.',
   },
 
   verify: {

package/src/i18n/es.ts

@@ -1584,6 +1584,8 @@ ${bold('EJEMPLOS')}
       `WAIVED — el fallo de ${gate} de arriba queda registrado y silenciado hasta ${until} (${daysLeft} días restantes): "${reason}". La factura lo sigue contando; solo el código de salida calla, y el día que caduque el waiver este gate vuelve a fallar.`,
     waiveExpired: (gate, until, reason) =>
       `El waiver de ${gate} caducó el ${until} y ya no silencia nada. Se escribió por: "${reason}". Renuévalo con fecha nueva y razón vigente, o arregla lo que cubría — un waiver caducado dejado ahí es un hallazgo borrado con pasos extra.`,
+    waiveNotRecorded: (path, because) =>
+      `  (Este waiver no se pudo escribir en ${path}: ${because}. El veredicto de la puerta de arriba no cambia.)`,
     summaryNoComparison: () =>
       'No se dio un registro anterior, así que nada de aquí dice si la factura se movió — un resumen sin comparación indica la factura, no su estabilidad.',
     summaryFooter: () =>
@@ -1694,7 +1696,9 @@ ${bold('EJEMPLOS')}
     nothingMeasured: (dir) =>
       `Todavía no hay nada medido (el almacén de ${dir} está vacío), así que la mitad de presupuesto de cada respuesta lo dirá. La mitad del coste sigue respondiendo desde el catálogo: sin conexión es un modo, no un fallo.`,
     noBudget: () =>
-      'No hay spend.maxUsd configurado, así que "queda presupuesto" no tiene sujeto y cada respuesta lo dice en vez de inventarse uno.',
+      'No hay spend.monthlyUsd configurado, así que "queda presupuesto" no tiene sujeto y cada respuesta lo dice en vez de inventarse uno. spend.maxUsd no se lee aquí a propósito: ese controla el periodo que cubra un registro, y leerlo como límite mensual es justo como dos superficies de esta herramienta acaban en desacuerdo.',
+    partialCoverage: (measuredDays, elapsedDays, period) =>
+      `Solo ${measuredDays} de los ${elapsedDays} días transcurridos de ${period} tienen alguna medición, así que la cifra consumida es un suelo del periodo y no el periodo. Descarga los días que faltan con trazum connect antes de tratar lo que queda como margen.`,
     badPort: (value) => `"${value}" no es un puerto. Da un número entero de 0 a 65535, o usa --socket.`,
   },
 
@@ -1770,6 +1774,27 @@ ${bold('EJEMPLOS')}
       span === null
         ? `Nada era más antiguo que ${days} días. ${kept} mediciones conservadas, y el log compactado.`
         : `Borradas ${count} mediciones de más de ${days} días, que cubren ${span} y ${usd} de gasto medido. ${kept} conservadas, y el log compactado a lo que el almacén ya resolvía.`,
+    budgetHeading: (period) => `Presupuesto de ${period}`,
+    budgetStanding: (consumed, limit, share, measuredDays, periodDays) =>
+      `${consumed} de ${limit} (${share}), medido sobre ${measuredDays} de los ${periodDays} días del mes.`,
+    budgetShape: (shape, elapsedPct, coverage) =>
+      shape === 'ahead'
+        ? `El dinero va más rápido que el calendario: ha transcurrido el ${elapsedPct}% del mes.`
+        : shape === 'behind'
+          ? `El dinero va más lento que el calendario: ha transcurrido el ${elapsedPct}% del mes.`
+          : shape === 'on-pace'
+            ? `Al ritmo del calendario: ha transcurrido el ${elapsedPct}% del mes.`
+            : coverage === 'partial'
+              ? 'Si eso es rápido o lento para el mes no se puede saber desde un suelo: los días sin medir gastaron algo, y solo un exceso sería incontestable.'
+              : 'Todavía no hay nada con lo que comparar el gasto.',
+    budgetNeverForecast: () =>
+      'Eso es una forma, no un pronóstico. A dónde va esto después depende de lo que hagas después, y ninguna aritmética de aquí lo sabe.',
+    budgetNothingMeasured: (elapsedDays) =>
+      `No se ha medido nada este mes, en ${elapsedDays} ${elapsedDays === 1 ? 'día transcurrido' : 'días transcurridos'}. Eso no es un presupuesto bajo control — es un presupuesto que nadie está mirando. Ejecuta trazum connect para descargar lo que tenga el proveedor.`,
+    budgetPartial: (measuredDays, elapsedDays, days) =>
+      `Solo ${measuredDays} de ${elapsedDays} días transcurridos tienen alguna medición, así que la cifra de abajo es un suelo del mes y no el mes. Faltan: ${days}.`,
+    budgetScopesUnmeasured: (count) =>
+      `${count} ${count === 1 ? 'ámbito presupuestado' : 'ámbitos presupuestados'} (por etiqueta o por servicio) no se pueden responder desde el almacén: un registro del almacén lleva un proveedor y un modelo, no una etiqueta de flujo. Contrólalos con trazum profile contra un registro por llamada.`,
   },
 
   connect: {
@@ -1837,6 +1862,33 @@ ${bold('EJEMPLOS')}
     unrecognized: (name) => `${name} no es ni un informe guardado ni un plan guardado, así que no está en ninguna serie de arriba.`,
     footer: () =>
       'Una serie nombra formas, no futuros. Veinte puntos hacen visible una tendencia; no hacen conocible el mes que viene — adónde van estas líneas después lo juzgas tú.',
+    waiverHeading: () => 'Con lo que este repositorio ha estado conviviendo',
+    waiverSince: (day, uses) =>
+      `${uses} ${uses === 1 ? 'uso registrado' : 'usos registrados'} desde el ${day}, cuando empezó el registro.`,
+    waiverNoneRecorded: () =>
+      'Ningún waiver ha silenciado una puerta desde que empezó el registro. Nada de aquí se deduce de la configuración — un waiver escrito y nunca usado no es una decisión con la que nadie conviva.',
+    waiverHabit: (gate, uses, days, firstDay, lastDay) =>
+      `${gate}: ${uses} ${uses === 1 ? 'uso' : 'usos'} en ${days} ${days === 1 ? 'día' : 'días'}, del ${firstDay} al ${lastDay}`,
+    waiverVerdict: (verdict) =>
+      verdict === 'used-once'
+        ? 'Usado una vez. Todavía no hay nada que leer en ello.'
+        : verdict === 'recurring'
+          ? 'La misma decisión, sosteniéndose. La puerta sigue saltando y el motivo no ha cambiado.'
+          : verdict === 'renewed-without-revisiting'
+            ? 'La fecha de caducidad se ha movido y el motivo no. Esa es la forma que toma una decisión que nadie está revisando — a veces es exactamente lo correcto, y merece decirse en voz alta igualmente.'
+            : 'El motivo cambió entre usos. Alguien volvió a mirarlo.',
+    waiverReasonNow: (reason) => `Motivo: ${reason}`,
+    waiverReasonsChanged: (count) => `${count} motivos distintos dados en ese tiempo.`,
+    waiverExpiriesMoved: (from, to, count) =>
+      `La caducidad se movió ${count} ${count === 1 ? 'vez' : 'veces'}: ${from} → ${to}.`,
+    waiverNoLongerConfigured: () =>
+      'Ya no está en la configuración. La decisión se revirtió; el registro la conserva.',
+    waiverNeverUsed: (gates) =>
+      `Con waiver en la configuración y nunca usados por una ejecución registrada: ${gates}. O la puerta dejó de fallar — buenas noticias que nadie anotó — o el waiver nombra una situación que no ocurre. Ambos merecen borrarse.`,
+    waiverUnreadable: (count, path) =>
+      `${count} ${count === 1 ? 'línea' : 'líneas'} de ${path} no se pudieron leer y no cuentan arriba.`,
+    waiverStartsHere: () =>
+      'Nada anterior a ese día existe. Este registro empezó cuando empezó a registrarse, y no se reconstruyó ningún pasado a partir de la configuración actual.',
   },
 
   verify: {

package/src/i18n/types.ts

@@ -877,6 +877,14 @@ export interface CliMessages {
      */
     waiveActive(gate: string, reason: string, until: string, daysLeft: string): string;
     waiveExpired(gate: string, until: string, reason: string): string;
+    /**
+     * A use that could not be written down.
+     *
+     * Printed dim and never as an error: the gate's verdict is unaffected, and
+     * a read-only checkout must not turn a passing build red on account of
+     * bookkeeping.
+     */
+    waiveNotRecorded(path: string, because: string): string;
     /**
      * `--markdown-summary`: the short form for a pull-request body or a weekly
      * note. A view over the same report, never a different set of figures.
@@ -1143,6 +1151,12 @@ export interface CliMessages {
     measuredFrom(usd: string): string;
     nothingMeasured(dir: string): string;
     noBudget(): string;
+    /**
+     * The period is only partly measured — said out loud, because a position
+     * standing on three days out of thirty must not read as a comfortable
+     * ninety per cent remaining.
+     */
+    partialCoverage(measuredDays: number, elapsedDays: number, period: string): string;
     badPort(value: string): string;
   };
 
@@ -1197,6 +1211,15 @@ export interface CliMessages {
     pruneNeedsPolicy(): string;
     pruneDryRun(count: string, days: string, span: string | null, usd: string): string;
     pruned(count: string, days: string, span: string | null, usd: string, kept: string): string;
+    /** The live budget — the one number `serve` and the MCP guard also read. */
+    budgetHeading(period: string): string;
+    budgetStanding(consumed: string, limit: string, share: string, measuredDays: string, periodDays: string): string;
+    /** The shape of the burn, named. Never a date — see `budgetNeverForecast`. */
+    budgetShape(shape: string, elapsedPct: number, coverage: string): string;
+    budgetNeverForecast(): string;
+    budgetNothingMeasured(elapsedDays: number): string;
+    budgetPartial(measuredDays: number, elapsedDays: number, days: string): string;
+    budgetScopesUnmeasured(count: number): string;
   };
 
   /**
@@ -1254,6 +1277,19 @@ export interface CliMessages {
     undated(name: string): string;
     unrecognized(name: string): string;
     footer(): string;
+    /** The waiver record — what this team has been living with, and for how long. */
+    waiverHeading(): string;
+    waiverSince(day: string, uses: number): string;
+    waiverNoneRecorded(): string;
+    waiverHabit(gate: string, uses: number, days: number, firstDay: string, lastDay: string): string;
+    waiverVerdict(verdict: string): string;
+    waiverReasonNow(reason: string): string;
+    waiverReasonsChanged(count: number): string;
+    waiverExpiriesMoved(from: string, to: string, count: number): string;
+    waiverNoLongerConfigured(): string;
+    waiverNeverUsed(gates: string): string;
+    waiverUnreadable(count: number, path: string): string;
+    waiverStartsHere(): string;
   };
 
   /**