@trazum/core 1.8.0

package/dist/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../src/baseline.ts"],"names":[],"mappings":"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"}

package/dist/cache.d.ts

@@ -0,0 +1,26 @@
+import type { TokenCounter } from './types.js';
+/**
+ * Cacheable-prefix analysis.
+ *
+ * Prompt caching is a byte-for-byte prefix match, so as soon as a template
+ * placeholder ({{user}}, ${query}...) is filled with a different value,
+ * everything after it stops being cached. The real cacheable prefix of a
+ * template is therefore NOT the whole prompt, but whatever precedes the first
+ * variable placeholder.
+ */
+export interface CachePrefixAnalysis {
+    /** Total tokens in the prompt. */
+    totalTokens: number;
+    /** Tokens before the first variable placeholder. With no placeholders, the total. */
+    stablePrefixTokens: number;
+    /** Text of the first variable placeholder, or `null` when there is none. */
+    firstPlaceholder: string | null;
+    /**
+     * Tokens of NON-placeholder content sitting after the first placeholder:
+     * stable instructions that are not cached today and that would be cached if
+     * moved ahead of the first placeholder.
+     */
+    staticTokensAfter: number;
+}
+export declare function analyzeCachePrefix(prompt: string, count: TokenCounter): CachePrefixAnalysis;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,mBAAmB,CA0B3F"}

package/dist/cache.js

@@ -0,0 +1,28 @@
+import { segment } from './segment.js';
+export function analyzeCachePrefix(prompt, count) {
+    const segments = segment(prompt);
+    const totalTokens = count(prompt);
+    let firstPlaceholder = null;
+    let prefix = '';
+    let staticAfter = '';
+    for (const seg of segments) {
+        if (firstPlaceholder === null) {
+            if (seg.kind === 'protected' && seg.protection === 'placeholder') {
+                firstPlaceholder = seg.text;
+            }
+            else {
+                prefix += seg.text;
+            }
+        }
+        else if (!(seg.kind === 'protected' && seg.protection === 'placeholder')) {
+            staticAfter += seg.text;
+        }
+    }
+    return {
+        totalTokens,
+        stablePrefixTokens: firstPlaceholder === null ? totalTokens : count(prefix),
+        firstPlaceholder,
+        staticTokensAfter: firstPlaceholder === null ? 0 : count(staticAfter),
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA2BvC,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,KAAmB;IACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;gBACjE,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,KAAK,aAAa,CAAC,EAAE,CAAC;YAC3E,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW;QACX,kBAAkB,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3E,gBAAgB;QAChB,iBAAiB,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/dist/changes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-rule change extraction.
+ *
+ * The report says a rule fired four times and saved nineteen tokens. That is
+ * enough to trust the `safe` level and nowhere near enough to review the
+ * `aggressive` one, where the honest advice has always been "read the diff" —
+ * and the diff was one undifferentiated block for every rule at once.
+ *
+ * This turns each rule into its own short list of "this became that", so an
+ * aggressive run can be judged rule by rule and a single bad rule disabled
+ * with `--disable`, instead of the whole level.
+ */
+export interface RuleChange {
+    /** The text the rule removed or replaced. */
+    before: string;
+    /** What it became. Empty when the text was simply deleted. */
+    after: string;
+}
+/** Changes reported per rule. The hit count carries the true total. */
+export declare const DEFAULT_CHANGE_LIMIT = 5;
+/**
+ * Extracts what a rule changed, as a short list of before/after pairs.
+ *
+ * Returns an empty list rather than a partial one when the change is too large
+ * to summarise usefully — an empty list reads as "nothing to show here", which
+ * is honest, where a truncated one would read as "this is all that happened".
+ */
+export declare function extractChanges(before: string, after: string, limit?: number): RuleChange[];
+//# sourceMappingURL=changes.d.ts.map

package/dist/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAeD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AA2CtC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAA6B,GACnC,UAAU,EAAE,CAqEd"}

package/dist/changes.js

@@ -0,0 +1,142 @@
+/**
+ * Per-rule change extraction.
+ *
+ * The report says a rule fired four times and saved nineteen tokens. That is
+ * enough to trust the `safe` level and nowhere near enough to review the
+ * `aggressive` one, where the honest advice has always been "read the diff" —
+ * and the diff was one undifferentiated block for every rule at once.
+ *
+ * This turns each rule into its own short list of "this became that", so an
+ * aggressive run can be judged rule by rule and a single bad rule disabled
+ * with `--disable`, instead of the whole level.
+ */
+/**
+ * Longest run of text either side will be diffed word by word.
+ *
+ * Everything here runs on attacker-controlled input, so the cost has to be
+ * bounded by construction rather than by hoping prompts are small. The common
+ * prefix and suffix are trimmed first, which is linear and usually leaves very
+ * little, but a rule that edits in a hundred scattered places leaves a middle
+ * as long as the prompt. Past this size the extraction is skipped: a list of
+ * changes that long is not something anyone reads anyway, and the hit count
+ * already says how much happened.
+ */
+const MAX_DIFF_CHARS = 4000;
+/** Changes reported per rule. The hit count carries the true total. */
+export const DEFAULT_CHANGE_LIMIT = 5;
+function splitWords(text) {
+    return text.match(/\s+|[^\s]+/g) ?? [];
+}
+/** Length of the common prefix, in characters. */
+function commonPrefix(a, b) {
+    const max = Math.min(a.length, b.length);
+    let i = 0;
+    while (i < max && a[i] === b[i])
+        i++;
+    return i;
+}
+/** Length of the common suffix, in characters, not overlapping `start`. */
+function commonSuffix(a, b, start) {
+    const max = Math.min(a.length, b.length) - start;
+    let i = 0;
+    while (i < max && a[a.length - 1 - i] === b[b.length - 1 - i])
+        i++;
+    return i;
+}
+/** Walks a prefix length back to the start of the word it lands inside. */
+function toWordStart(text, length) {
+    let i = length;
+    while (i > 0 && !/\s/.test(text[i - 1]))
+        i--;
+    return i;
+}
+/**
+ * Shrinks a suffix until it begins at a word boundary.
+ *
+ * Shrinking rather than growing is the whole point: the common suffix is only
+ * common up to the length `commonSuffix` found, so extending it past that
+ * would claim two different strings match. Pulling it back instead keeps the
+ * guarantee and hands the partial word to the diff, where it belongs.
+ */
+function toWordEnd(before, length) {
+    let i = length;
+    while (i > 0 && !/\s/.test(before[before.length - i]))
+        i--;
+    return i;
+}
+/**
+ * Extracts what a rule changed, as a short list of before/after pairs.
+ *
+ * Returns an empty list rather than a partial one when the change is too large
+ * to summarise usefully — an empty list reads as "nothing to show here", which
+ * is honest, where a truncated one would read as "this is all that happened".
+ */
+export function extractChanges(before, after, limit = DEFAULT_CHANGE_LIMIT) {
+    if (before === after)
+        return [];
+    // Rules make local edits, so trimming the shared ends first usually leaves a
+    // middle small enough to diff properly — and does it in linear time.
+    //
+    // The trim is by character but the diff is by word, so both boundaries are
+    // pushed back out to whitespace. Without that the middle starts mid-word and
+    // the change reads as gibberish: removing "quite" from "be quite accurate"
+    // reported itself as `be quit → b`, which is accurate, useless, and worse
+    // than showing nothing.
+    const start = toWordStart(before, commonPrefix(before, after));
+    const end = toWordEnd(before, commonSuffix(before, after, start));
+    const beforeMiddle = before.slice(start, before.length - end);
+    const afterMiddle = after.slice(start, after.length - end);
+    if (beforeMiddle.length > MAX_DIFF_CHARS || afterMiddle.length > MAX_DIFF_CHARS) {
+        return [];
+    }
+    const a = splitWords(beforeMiddle);
+    const b = splitWords(afterMiddle);
+    // Longest common subsequence over words, to align the two sides.
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const table = new Int32Array(rows * cols);
+    for (let i = a.length - 1; i >= 0; i--) {
+        for (let j = b.length - 1; j >= 0; j--) {
+            table[i * cols + j] =
+                a[i] === b[j]
+                    ? table[(i + 1) * cols + (j + 1)] + 1
+                    : Math.max(table[(i + 1) * cols + j], table[i * cols + (j + 1)]);
+        }
+    }
+    const changes = [];
+    let removed = '';
+    let added = '';
+    const flush = () => {
+        if (!removed && !added)
+            return;
+        // Whitespace-only churn is not a change anyone needs to review; the
+        // whitespace rule's hit count already reports it.
+        if (removed.trim() || added.trim()) {
+            changes.push({ before: removed.trim(), after: added.trim() });
+        }
+        removed = '';
+        added = '';
+    };
+    let i = 0;
+    let j = 0;
+    while (i < a.length && j < b.length) {
+        if (a[i] === b[j]) {
+            flush();
+            i++;
+            j++;
+        }
+        else if (table[(i + 1) * cols + j] >= table[i * cols + (j + 1)]) {
+            removed += a[i++];
+        }
+        else {
+            added += b[j++];
+        }
+    }
+    while (i < a.length)
+        removed += a[i++];
+    while (j < b.length)
+        added += b[j++];
+    flush();
+    return changes.slice(0, limit);
+}
+//# sourceMappingURL=changes.js.map

package/dist/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"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"}

package/dist/compare.d.ts

@@ -0,0 +1,65 @@
+import type { AdvisoryId, RuleId } from './types.js';
+import type { OptimizeOptions, UsageProfile } from './types.js';
+/**
+ * Comparing two versions of a prompt.
+ *
+ * `optimize()` answers "how much fat is in this prompt". This answers a
+ * different question, and the one a pull request actually raises: "somebody
+ * edited this — did it get worse?"
+ *
+ * Sign convention, stated once and held everywhere: **every number here is a
+ * delta, `after - before`, and positive means the change made things worse.**
+ * That is deliberately the opposite of the rest of the codebase, where every
+ * figure is a saving. Mixing the two conventions in one report is the single
+ * easiest way to make a cost tool lie, so nothing in this module is called a
+ * saving and nothing reuses that name.
+ */
+export interface RuleDelta {
+    /** Rules that fire on the new version but did not on the old one. */
+    newlyFiring: RuleId[];
+    /** Rules that fired on the old version and no longer do. */
+    noLongerFiring: RuleId[];
+}
+export interface AdvisoryDelta {
+    /** Advisories the new version raises that the old one did not. */
+    appeared: AdvisoryId[];
+    /** Advisories the old version raised that the new one has resolved. */
+    resolved: AdvisoryId[];
+}
+export interface PromptComparison {
+    tokensBefore: number;
+    tokensAfter: number;
+    /** `after - before`. Positive means the prompt grew. */
+    tokenDelta: number;
+    /** The delta as a percentage of the old size. 0 when the old size was 0. */
+    deltaPct: number;
+    /** Monthly cost change in USD. Positive means it now costs more. */
+    monthlyDeltaUsd: number;
+    /** Per-call cost change in USD. Positive means it now costs more. */
+    perCallDeltaUsd: number;
+    rules: RuleDelta;
+    advisories: AdvisoryDelta;
+    usage: UsageProfile;
+}
+export interface CompareOptions extends OptimizeOptions {
+    /**
+     * Compare what the rules would leave, rather than what was written.
+     *
+     * Off by default, and that default matters: a pull request changed the file
+     * on disk, so the file on disk is what the reviewer is being asked about.
+     * Optimising both sides first would hide a prompt that doubled in length but
+     * happened to double in courtesy, which is exactly the change worth seeing.
+     */
+    optimizeBoth?: boolean;
+}
+/**
+ * Compares two prompt versions.
+ *
+ * Both sides go through `optimize()` regardless, because that is what produces
+ * the rule and advisory findings — but by default the *token and cost figures*
+ * come from the text as written. `optimizeBoth` switches the figures to the
+ * optimised text, for a team that runs Trazum in their pipeline and cares
+ * about what actually reaches the model.
+ */
+export declare function comparePrompts(before: string, after: string, options?: CompareOptions): PromptComparison;
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,uEAAuE;IACvE,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,gBAAgB,CAyClB"}

package/dist/compare.js

@@ -0,0 +1,58 @@
+import { optimize } from './optimize.js';
+import { computeSavings } from './savings.js';
+const difference = (a, b) => {
+    const inB = new Set(b);
+    return a.filter((item) => !inB.has(item));
+};
+/**
+ * Collapses negative zero.
+ *
+ * Negating a saving of zero produces `-0`, which is arithmetically fine and
+ * renders as `-$0` in a cost report — a change that did not happen, shown with
+ * a direction.
+ */
+const noNegativeZero = (value) => (value === 0 ? 0 : value);
+/**
+ * Compares two prompt versions.
+ *
+ * Both sides go through `optimize()` regardless, because that is what produces
+ * the rule and advisory findings — but by default the *token and cost figures*
+ * come from the text as written. `optimizeBoth` switches the figures to the
+ * optimised text, for a team that runs Trazum in their pipeline and cares
+ * about what actually reaches the model.
+ */
+export function comparePrompts(before, after, options = {}) {
+    const { optimizeBoth = false, ...optimizeOptions } = options;
+    const beforeResult = optimize(before, optimizeOptions);
+    const afterResult = optimize(after, optimizeOptions);
+    const tokensBefore = optimizeBoth ? beforeResult.tokensAfter : beforeResult.tokensBefore;
+    const tokensAfter = optimizeBoth ? afterResult.tokensAfter : afterResult.tokensBefore;
+    const tokenDelta = tokensAfter - tokensBefore;
+    const usage = afterResult.usage;
+    // computeSavings is before-minus-after, so its "saving" is our delta with
+    // the sign flipped. Negating once, here, is what keeps the convention above
+    // true everywhere else.
+    const savings = computeSavings(tokensBefore, tokensAfter, usage);
+    const beforeRules = beforeResult.rules.map((r) => r.id);
+    const afterRules = afterResult.rules.map((r) => r.id);
+    const beforeAdvisories = beforeResult.advisories.map((a) => a.id);
+    const afterAdvisories = afterResult.advisories.map((a) => a.id);
+    return {
+        tokensBefore,
+        tokensAfter,
+        tokenDelta,
+        deltaPct: tokensBefore > 0 ? (tokenDelta / tokensBefore) * 100 : 0,
+        monthlyDeltaUsd: noNegativeZero(-savings.monthlySavingsUsd),
+        perCallDeltaUsd: noNegativeZero(savings.perCall.after.totalUsd - savings.perCall.before.totalUsd),
+        rules: {
+            newlyFiring: difference(afterRules, beforeRules),
+            noLongerFiring: difference(beforeRules, afterRules),
+        },
+        advisories: {
+            appeared: difference(afterAdvisories, beforeAdvisories),
+            resolved: difference(beforeAdvisories, afterAdvisories),
+        },
+        usage,
+    };
+}
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"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"}

package/dist/config-schema.d.ts

@@ -0,0 +1,118 @@
+import type { PricingCatalogue } from './pricing.js';
+import type { Locale } from './i18n/index.js';
+import type { RuleId, RuleLevel, UsageProfile } from './types.js';
+/**
+ * The shape and validation of `trazum.config.json`. No filesystem access — the
+ * loader that reads the file lives in `config.ts`, which is only reachable via
+ * `@trazum/core/node`. Keeping the schema pure is what lets the browser bundle
+ * import the types and key lists without dragging `node:fs` into its graph.
+ *
+ * The problem this solves is small and real: every command in a repository's CI
+ * repeats the same four flags, and the one place they get out of step is the
+ * place the numbers stop meaning anything.
+ *
+ * **Every validation failure here throws.** That is the whole design. A config
+ * file is trusted to carry a budget, and the failure mode of a lenient parser
+ * is a typo'd key silently ignored, defaults quietly restored, and a green
+ * build for a prompt nobody measured. An unreadable config is a loud error; a
+ * config that half-applies is a lie.
+ */
+export declare const CONFIG_FILENAME = "trazum.config.json";
+/**
+ * Largest config file this will read.
+ *
+ * A config is a couple of dozen lines. This exists so a hostile or accidental
+ * multi-megabyte file is refused before `JSON.parse` is handed the whole thing.
+ */
+export declare const MAX_CONFIG_BYTES: number;
+/** How far up the tree the search for a config file will walk. */
+export declare const MAX_CONFIG_SEARCH_DEPTH = 32;
+export interface BaselineConfig {
+    /** Path to the baseline file, relative to the config. */
+    path: string;
+    /**
+     * Thresholds. At least one is required — see `parseBaselineConfig` for why a
+     * baseline with no threshold is a configuration error rather than a default.
+     */
+    maxGrowthTokens?: number;
+    maxGrowthPct?: number;
+}
+export interface TrazumConfig {
+    level?: RuleLevel;
+    locale?: Locale;
+    disable?: RuleId[];
+    usage?: Partial<UsageProfile>;
+    /**
+     * Token budgets by glob pattern. The most specific matching pattern wins —
+     * see `mostSpecificMatch`, which states what "specific" means rather than
+     * leaving it to be inferred.
+     */
+    budgets?: Record<string, number>;
+    /** Default for `trazum diff --max-growth`, in tokens. */
+    maxGrowth?: number;
+    /**
+     * The cost baseline, and how much drift from it is tolerated.
+     *
+     * This is the difference between a ceiling and a gate. `budgets` asks whether
+     * a file fits; this asks whether the repository got worse than it was at the
+     * commit somebody recorded. Present in the config means `trazum check` in
+     * directory mode reads the baseline and gates on it without a flag — a gate
+     * you have to remember to pass an argument to is a gate that runs in the
+     * author's terminal and not in CI.
+     */
+    baseline?: BaselineConfig;
+    /** File extensions directory mode treats as prompts. */
+    extensions?: string[];
+    /**
+     * Path to a pricing overlay, relative to the config file.
+     *
+     * Lets a project correct a published price without upgrading the library. The
+     * bundled catalogue stays the default; this only layers on top.
+     */
+    pricing?: string;
+}
+/**
+ * Every key the config accepts. Exported so the CLI's help can be tested
+ * against it rather than against a second hand-maintained list — a setting the
+ * help never mentions is one only the changelog knows about.
+ */
+export declare const CONFIG_KEYS: readonly ['level', 'locale', 'disable', 'usage', 'budgets', 'maxGrowth', 'baseline', 'extensions', 'pricing'];
+export declare const CONFIG_BASELINE_KEYS: readonly ['path', 'maxGrowthTokens', 'maxGrowthPct'];
+export declare const CONFIG_USAGE_KEYS: readonly ['model', 'callsPerMonth', 'avgOutputTokens', 'cacheHitRate', 'batchEligible'];
+/** Extensions directory mode reads when the config does not say otherwise. */
+export declare const DEFAULT_EXTENSIONS: string[];
+export declare class ConfigError extends Error {
+    readonly source: string;
+    constructor(message: string, source: string);
+}
+/**
+ * Checks a config's `usage.model` against a resolved catalogue.
+ *
+ * Separate from `parseConfig` because it needs the catalogue, and the catalogue
+ * may be defined by the very document being parsed — `pricing` is a config key.
+ * `loadConfig` calls this once the overlay is in hand, so a typo'd model is still
+ * a loud error, just one raised at the point where "unknown model" can be
+ * answered truthfully.
+ */
+export declare function validateConfigModel(config: TrazumConfig, catalogue: PricingCatalogue, source: string): void;
+/**
+ * Validates a config document.
+ *
+ * `source` names the file in every error, because a config error found while
+ * running `trazum check` in a monorepo is useless without knowing which of
+ * several config files it came from.
+ */
+export declare function parseConfig(raw: string, source?: string): TrazumConfig;
+export interface ResolvedBudget {
+    /** The pattern the budget came from, so a surprising number can be traced. */
+    pattern: string;
+    maxTokens: number;
+}
+/**
+ * The budget that applies to a path, or null when no pattern matches.
+ *
+ * Returning the pattern alongside the number is the point: a file failing
+ * against a budget the reader cannot locate in their config is a bug report.
+ */
+export declare function budgetFor(path: string, budgets: Record<string, number> | undefined): ResolvedBudget | null;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,YACtB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,CACD,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAAI,MAAM,EAAE,iBAAiB,EAAE,cAAc,CAAU,CAAC;AAEzF,eAAO,MAAM,iBAAiB,YAC5B,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,CACP,CAAC;AAKX,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,UAAsC,CAAC;AAEtE,qBAAa,WAAY,SAAQ,KAAK;IAGlC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAFzB,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EAIxB;CACF;AAqLD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAkB,GAAG,YAAY,CAwF/E;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,cAAc,GAAG,IAAI,CAIvB"}