@trazum/cli 1.33.0 → 1.35.0

package/dist/index.js

@@ -259,7 +259,7 @@ const COMMAND_FLAGS = {
     ],
     check: ['max-tokens', 'level', 'exact-tokens', 'markdown-out', 'baseline'],
     baseline: ['model', 'calls', 'output-tokens', 'cache-hit-rate', 'batch', 'exact-tokens', 'out', 'o'],
-    profile: ['json', 'pricing', 'pricing-live', 'against', 'what-if', 'markdown-out', 'csv-out', 'csv-shape', 'max-usd', 'max-growth-usd', 'max-cache-loss-usd', 'max-day-usd', 'max-session-usd', 'label', 'since', 'until', 'dry-run'],
+    profile: ['json', 'pricing', 'pricing-live', 'against', 'what-if', 'markdown-out', 'csv-out', 'csv-shape', 'max-usd', 'max-growth-usd', 'max-cache-loss-usd', 'max-day-usd', 'max-session-usd', 'label', 'since', 'until', 'dry-run', 'markdown-summary'],
     route: ['prompt-file', 'cases', 'label', 'concurrency', 'json', 'yes', 'pricing', 'pricing-live'],
     eval: ['cases', 'level', 'concurrency', 'export', 'out', 'o', 'model'],
     prune: ['cases', 'concurrency', 'json', 'yes'],
@@ -1778,6 +1778,41 @@ async function commandProfile(args, config, pricing, t) {
      */
     const gateVerdicts = [];
     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) => {
+        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) => {
+        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 = () => {
         /**
          * Before any verdict: whether the gated figure is the whole bill. A gate
@@ -1825,7 +1860,8 @@ async function commandProfile(args, config, pricing, t) {
                 }
                 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))));
@@ -1886,7 +1922,8 @@ async function commandProfile(args, config, pricing, t) {
                  * 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))));
@@ -1913,11 +1950,15 @@ async function commandProfile(args, config, pricing, t) {
             const worst = blinded[0];
             if (worst !== undefined) {
                 console.error(c.red(t.profile.maxGrowthCoverageLost(blinded.map((d) => t.profile.coverageField(d.field)).join(', '), pct(worst.was), pct(worst.now))));
+                // 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;
             }
         }
         /**
@@ -1933,11 +1974,13 @@ async function commandProfile(args, config, pricing, t) {
             const gateCache = cacheEconomics(report.total);
             if (gateCache.deltaUsd > maxLoss) {
                 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(t.profile.maxCacheLossWorstCase(report.total.assumedWriteTtlCalls, formatUsd(gateCache.worstCaseDeltaUsd), formatUsd(maxLoss))));
-                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))));
@@ -1982,7 +2025,8 @@ async function commandProfile(args, config, pricing, t) {
                 if (worst.usd > maxDay) {
                     console.error(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))));
@@ -2023,7 +2067,8 @@ async function commandProfile(args, config, pricing, t) {
             else if (report.sessionSpend.maxUsd > maxSession) {
                 console.error(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))));
@@ -2091,6 +2136,8 @@ async function commandProfile(args, config, pricing, t) {
                 // The verdict, where the person reading CI will see it. recordGates()
                 // runs before the side files for exactly this.
                 ...(gateVerdicts.length > 0 ? { gates: { failed: gateFailed, lines: gateVerdicts } } : {}),
+                // The short form, for a reader who is not in the terminal.
+                ...(boolFlag(args, 'markdown-summary') ? { summary: true } : {}),
                 // The repricing, when --what-if was given: computed once above and
                 // handed over, so the summary in a pull request cannot disagree
                 // with the terminal about what a move would cost.