@trazum/cli 1.33.0 → 1.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trazum/cli",
-  "version": "1.33.0",
+  "version": "1.34.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.33.0"
+    "@trazum/core": "1.34.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",

package/src/i18n/en.ts

@@ -345,6 +345,11 @@ ${bold('CONFIG FILE')}
     spend     { "maxUsd": 200, "byLabel": { "chat": 40 } } — money budgets for
               "trazum profile", in dollars. A budgeted label with no calls in
               the log is reported as not measured, never as a pass
+    waive     [{ "gate": "maxUsd", "reason": "August migration", "until":
+              "2026-09-15" }] — a gate failure decided about, on the record.
+              All three fields required: a waiver with no end date is a
+              finding deleted with extra steps. Waived failures still print,
+              and the day the waiver expires the gate fails again
 
   Flags beat the config; the config beats the defaults. Budgets resolve to the
   most specific matching pattern — most literal characters wins. A boolean the
@@ -1199,6 +1204,10 @@ ${bold('EXAMPLES')}
       `The 95th percentile is ${ratio}x the median there: most conversations are cheap and a few are not, which is a tail a quota can catch. Where median and p95 sit close together the workload is simply expensive and there is no tail to hunt.`,
     sessionSpendOnly: (sessions, max) =>
       `${sessions} ${sessions === '1' ? 'conversation' : 'conversations'} in this log; the most expensive cost ${max}. Too few per workload for a percentile — a maximum is a fact at any count, and it is the figure --max-session-usd judges.`,
+    waiveActive: (gate, reason, until, daysLeft) =>
+      `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.`,
     gateLargest: (label, model, usd, share) =>
       `Most of it is ${label} on ${model}: ${usd}, ${share} of the bill. That is where the money is, not necessarily where the fix is.`,
     gateLever: (label, action, saving, overage, covers) =>

package/src/i18n/es.ts

@@ -348,6 +348,12 @@ ${bold('FICHERO DE CONFIGURACIÓN')}
     spend     { "maxUsd": 200, "byLabel": { "chat": 40 } } — presupuestos en
               dólares para "trazum profile". Una etiqueta con presupuesto y sin
               llamadas se informa como no medida, nunca como aprobada
+    waive     [{ "gate": "maxUsd", "reason": "migración de agosto", "until":
+              "2026-09-15" }] — un fallo de gate sobre el que se ha decidido,
+              registrado. Los tres campos son obligatorios: un waiver sin
+              fecha de fin es un hallazgo borrado con pasos extra. Los fallos
+              waived se siguen imprimiendo, y el día que caduca el gate
+              vuelve a fallar
 
   Las opciones ganan al config; el config gana a los valores por defecto. Los
   presupuestos se resuelven con el patrón más específico que encaje — gana el
@@ -1214,6 +1220,10 @@ ${bold('EJEMPLOS')}
       `El percentil 95 es ${ratio}x la mediana ahí: casi todas las conversaciones son baratas y unas pocas no, y esa es una cola que una cuota puede cazar. Cuando mediana y p95 quedan cerca, la carga es cara sin más y no hay cola que perseguir.`,
     sessionSpendOnly: (sessions, max) =>
       `${sessions} ${sessions === '1' ? 'conversación' : 'conversaciones'} en este registro; la más cara costó ${max}. Demasiado pocas por carga para un percentil — un máximo es un hecho con cualquier recuento, y es la cifra que juzga --max-session-usd.`,
+    waiveActive: (gate, reason, until, daysLeft) =>
+      `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.`,
     gateLargest: (label, model, usd, share) =>
       `La mayor parte es ${label} en ${model}: ${usd}, el ${share} de la factura. Ahí está el dinero, no necesariamente el arreglo.`,
     gateLever: (label, action, saving, overage, covers) =>

package/src/i18n/types.ts

@@ -784,6 +784,13 @@ export interface CliMessages {
      * computed. Nothing here recommends: whether the cheaper model can do the
      * work is the reader's to judge, and the copy says so.
      */
+    /**
+     * Findings as policy. An active waiver silences one gate's exit code, on
+     * the record, with the reason and the days left; an expired one silences
+     * nothing and says so beside the failure it used to cover.
+     */
+    waiveActive(gate: string, reason: string, until: string, daysLeft: string): string;
+    waiveExpired(gate: string, until: string, reason: string): string;
     gateLargest(label: string, model: string, usd: string, share: string): string;
     gateLever(label: string, action: string, saving: string, overage: string, covers: boolean): string;
     /**

package/src/index.ts

@@ -2312,6 +2312,46 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
    */
   const gateVerdicts: string[] = [];
   let gateFailed = false;
+  /**
+   * Findings as policy. A waiver silences one gate's exit code for a bounded
+   * time, on the record: the failure still prints (waived is shown as
+   * waived, never hidden — the bill still counts it), the reason and the
+   * days left print beside it, and the day the waiver expires the gate
+   * fails again louder, naming the date and the reason somebody wrote.
+   * That expiry is the entire mechanism by which a waiver stays a decision
+   * instead of becoming a habit.
+   */
+  const waiverFor = (gate: string): { entry: { gate: string; reason: string; until: string }; expired: boolean } | null => {
+    const entry = (config.waive ?? []).find((w) => w.gate === gate);
+    if (entry === undefined) return null;
+    // The waiver covers its named day whole: expiry begins the next UTC day.
+    const expiresMs = Date.parse(`${entry.until}T00:00:00Z`) + 86_400_000;
+    return { entry, expired: Date.now() >= expiresMs };
+  };
+  /**
+   * Applies a waiver to one failing gate. Returns true when the failure is
+   * silenced — the caller skips its exitCode — and prints the record either
+   * way, because a waived failure that vanished from the output would be a
+   * finding deleted with extra steps.
+   */
+  const waived = (gate: string): boolean => {
+    const found = waiverFor(gate);
+    if (found === null) return false;
+    if (found.expired) {
+      console.error(
+        c.red(t.profile.waiveExpired(gate, found.entry.until, found.entry.reason)),
+      );
+      return false;
+    }
+    const daysLeft = Math.max(
+      0,
+      Math.ceil((Date.parse(`${found.entry.until}T00:00:00Z`) + 86_400_000 - Date.now()) / 86_400_000),
+    );
+    console.error(
+      c.yellow(t.profile.waiveActive(gate, found.entry.reason, found.entry.until, String(daysLeft))),
+    );
+    return true;
+  };
   const applyGates = (): void => {
     /**
      * Before any verdict: whether the gated figure is the whole bill. A gate
@@ -2358,7 +2398,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
         }
         if (usd > limit) {
           console.error(c.red(t.profile.labelBudgetFailed(label, formatUsd(usd), formatUsd(limit))));
-          process.exitCode = 1;
+          if (!waived(`byLabel:${label}`)) process.exitCode = 1;
         } else {
           console.error(c.dim(t.profile.labelBudgetOk(label, formatUsd(usd), formatUsd(limit))));
         }
@@ -2431,7 +2471,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
          * copy says so.
          */
         explainFailure(report.total.totalUsd - maxUsd);
-        process.exitCode = 1;
+        if (!waived('maxUsd')) process.exitCode = 1;
       } else {
         console.error(c.dim(t.profile.maxUsdOk(formatUsd(report.total.totalUsd), formatUsd(maxUsd))));
         explainMargin(report.total.totalUsd, maxUsd);
@@ -2465,10 +2505,13 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
             ),
           ),
         );
+        // Deliberately unwaivable: this failure is "the comparison cannot
+        // be made", and a waiver on unmeasurability would be a decision to
+        // stop measuring — not a budget decision with an end date.
         process.exitCode = 1;
       } else if (againstDelta > maxGrowth) {
         console.error(c.red(t.profile.maxGrowthUsdFailed(formatSignedUsd(againstDelta), formatUsd(maxGrowth))));
-        process.exitCode = 1;
+        if (!waived('maxGrowthUsd')) process.exitCode = 1;
       }
     }
     /**
@@ -2486,7 +2529,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
         console.error(
           c.red(t.profile.maxCacheLossFailed(formatUsd(gateCache.deltaUsd), formatUsd(maxLoss))),
         );
-        process.exitCode = 1;
+        if (!waived('maxCacheLossUsd')) process.exitCode = 1;
       } else if (gateCache.worstCaseDeltaUsd > maxLoss) {
         console.error(
           c.red(
@@ -2497,7 +2540,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
             ),
           ),
         );
-        process.exitCode = 1;
+        if (!waived('maxCacheLossUsd')) process.exitCode = 1;
       } else {
         console.error(
           c.dim(t.profile.maxCacheLossOk(formatUsd(Math.max(0, gateCache.worstCaseDeltaUsd)), formatUsd(maxLoss))),
@@ -2546,7 +2589,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
             c.red(`${t.profile.maxDayFailed(worst.day, formatUsd(worst.usd), formatUsd(maxDay))}${suspect}`),
           );
           explainFailure(worst.usd - maxDay, { namesLargest: true });
-          process.exitCode = 1;
+          if (!waived('maxDayUsd')) process.exitCode = 1;
         } else {
           console.error(c.dim(t.profile.maxDayOk(worst.day, formatUsd(worst.usd), formatUsd(maxDay))));
           explainMargin(worst.usd, maxDay);
@@ -2588,7 +2631,7 @@ async function commandProfile(args: Args, config: TrazumConfig, pricing: Pricing
           c.red(t.profile.maxSessionFailed(formatUsd(report.sessionSpend.maxUsd), formatUsd(maxSession), n(report.sessionSpend.sessions))),
         );
         explainFailure(report.sessionSpend.maxUsd - maxSession);
-        process.exitCode = 1;
+        if (!waived('maxSessionUsd')) process.exitCode = 1;
       } else {
         console.error(
           c.dim(t.profile.maxSessionOk(formatUsd(report.sessionSpend.maxUsd), formatUsd(maxSession), n(report.sessionSpend.sessions))),