@trazum/cli 1.25.0 → 1.27.0

package/dist/index.js

@@ -2,7 +2,7 @@
 import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { join, resolve as resolvePath } from 'node:path';
 import { gunzipSync } from 'node:zlib';
-import { applyRewrites, BASELINE_FILENAME, BASELINE_VERSION, breaches, cacheableMinimum, analyzeCachePrefix, billLevers, cacheEconomics, cacheHitRate, comparePrompts, compareToBaseline, computeSavings, countTokensAnthropic, DEFAULT_USAGE, detectFromSource, driversBetween, estimateTokens, evaluate, extractPrompts, findExamples, formatBaseline, formatSignedUsd, formatUsd, getMessages, getModel, hasMarker, LOCALES, MAX_BASELINE_BYTES, moneyIsComparable, mostSpecificMatch, nearestName, optimize, parseBaseline, PHRASE_LANGUAGES, plannedCalls, profilePrompt, profileToCsv, profileUsage, promptId, providerFromEnv, pruneExamples, refineWithLlm, rejectionText, reorderForCache, repriceProfile, reviewAgeDays, reviewExamples, RULES, sharedPrefixes, sharesOf, SOURCE_EXTENSIONS, suggestRewrites, toOtlpMetrics, toPromptfoo, TTL_1H_MS, UNLABELLED, withExactTokenCounts, } from '@trazum/core';
+import { applyRewrites, BASELINE_FILENAME, BASELINE_VERSION, breaches, cacheableMinimum, analyzeCachePrefix, billLevers, cacheEconomics, cacheHitRate, contextPressure, comparePrompts, compareToBaseline, computeSavings, countTokensAnthropic, DEFAULT_USAGE, detectFromSource, driversBetween, estimateTokens, evaluate, extractPrompts, findExamples, formatBaseline, formatSignedUsd, formatUsd, getMessages, getModel, hasMarker, LOCALES, MAX_BASELINE_BYTES, moneyIsComparable, mostSpecificMatch, nearestName, optimize, parseBaseline, PHRASE_LANGUAGES, plannedCalls, profilePrompt, profileToCsv, profileUsage, promptId, providerFromEnv, pruneExamples, refineWithLlm, rejectionText, reorderForCache, repriceProfile, reviewAgeDays, reviewExamples, RULES, sharedPrefixes, sharesOf, SOURCE_EXTENSIONS, suggestRewrites, toOtlpMetrics, toPromptfoo, TTL_1H_MS, UNLABELLED, withExactTokenCounts, } from '@trazum/core';
 import { cacheDir, cacheStats, cachingProvider, clearCache } from './suggest-cache.js';
 import { dayOf, formatGap, median, spanDays } from './time.js';
 // Everything that reads the filesystem, on its own entry point so the web
@@ -1660,6 +1660,12 @@ async function commandProfile(args, config, pricing, t) {
      * got a report with no answer in it, and has no way to tell a typo from a
      * model this comparison had nothing to say about.
      */
+    /**
+     * The largest call against each model's window, computed once here so the
+     * terminal, the JSON and the markdown state the same ratio — the
+     * denominator lives in the (possibly overlaid) catalogue.
+     */
+    const pressures = contextPressure(report, pricing);
     const whatIfModel = stringFlag(args, 'what-if');
     const whatIf = whatIfModel !== undefined ? repriceProfile(report, whatIfModel, pricing) : null;
     if (whatIfModel !== undefined && whatIf === null) {
@@ -1899,6 +1905,7 @@ async function commandProfile(args, config, pricing, t) {
                 // handed over, so the summary in a pull request cannot disagree
                 // with the terminal about what a move would cost.
                 ...(whatIf !== null ? { whatIf } : {}),
+                pressure: pressures,
                 // The comparison, when there was one — the same figures and the same
                 // drivers the terminal printed, never re-derived here.
                 ...(previous !== null
@@ -1994,6 +2001,10 @@ async function commandProfile(args, config, pricing, t) {
                     },
                 }
                 : {}),
+            // How close each slice's largest call is to its model's window —
+            // derived like `cache` and `levers`, so a dashboard need not
+            // re-derive a ratio whose denominator lives in the catalogue.
+            contextPressure: pressures,
             // Present only when --what-if was passed. `sameTokensAssumed` rides
             // along inside it so a consumer cannot print the dollar figure
             // without the caveat being in the same object.
@@ -2697,6 +2708,52 @@ async function commandProfile(args, config, pricing, t) {
             }
         }
     }
+    /**
+     * How close the largest call is to the model's ceiling.
+     *
+     * The failure a bill cannot show: input grows turn by turn or document by
+     * document, costs nothing extra to grow, and then one call crosses the
+     * context window and the API refuses it. Loud from 85% — close enough
+     * that the next retrieval bump or long conversation plausibly crosses —
+     * and quiet above half, so the reader sees it coming either way. No
+     * prediction of *when*: a straight line through two points is a guess
+     * wearing arithmetic's clothes.
+     */
+    {
+        if (pressures.length > 0) {
+            console.log();
+            console.log(c.bold(t.profile.pressureHeading()));
+            for (const row of pressures.slice(0, 3)) {
+                const label = row.label === UNLABELLED ? t.profile.unlabelled() : row.label;
+                const line = t.profile.pressureLine(label, row.modelName, n(row.maxCallInputTokens), n(row.contextWindow), pct(row.share));
+                console.log();
+                if (row.share >= 0.85) {
+                    console.log(`  ${c.yellow('!')} ${c.bold(wrap(line, 74, '    '))}`);
+                    console.log(`  ${c.dim(wrap(t.profile.pressureAdvice(), 74, '  '))}`);
+                }
+                else {
+                    console.log(`  ${c.dim(wrap(line, 74, '  '))}`);
+                }
+            }
+        }
+    }
+    /**
+     * The mix moving inside one log — the drift `--against` needs a second log
+     * to see. Spoken only past fifteen points, a presentation threshold stated
+     * in the copy; the data states exact shares and the JSON carries them all.
+     */
+    if (report.modelMixDrift !== null) {
+        const moved = report.modelMixDrift.models.filter((m) => Math.abs(m.lastShare - m.firstShare) >= 0.15);
+        if (moved.length > 0) {
+            console.log();
+            console.log(c.bold(t.profile.mixDriftHeading()));
+            for (const m of moved.slice(0, 3)) {
+                console.log();
+                console.log(`  ${c.yellow('!')} ${c.bold(wrap(t.profile.mixDriftLine(m.model, pct(m.firstShare), pct(m.lastShare), n(report.modelMixDrift.firstDays), n(report.modelMixDrift.lastDays), formatUsd(m.lastUsd)), 74, '    '))}`);
+            }
+            console.log(`  ${c.dim(wrap(t.profile.mixDriftNote(), 74, '  '))}`);
+        }
+    }
     /**
      * The same request, sent again a moment later.
      *