@vibe-agent-toolkit/cli 0.2.0-rc.7 → 0.2.0-rc.9

package/dist/commands/claude/budget.js

@@ -1,464 +0,0 @@
-/**
- * `vat claude budget [paths...]` — is the always-loaded context at a working
- * location over its budget?
- *
- * ## Why this is a command and not a check inside `vat resources validate`
- *
- * It used to be one: default-on, with a `--no-context-budget` opt-out. That is
- * gone, in both directions — `vat resources validate` has no knowledge of the
- * budget at all any more, not a flag, not a default. The ruling behind the move
- * is short: *a validation run must not emit findings nobody asked for.* An
- * `info` finding attached to a lane people run for link and anchor errors is a
- * finding they scroll past, and a check people scroll past is a check they
- * eventually silence.
- *
- * ## The sibling split: `context` QUERIES, `budget` CHECKS
- *
- * `vat claude context` answers a question and
- * never gates — totals, admissions, the declared limits, no verdict, always
- * exit 0. This command is the other half of that pair: it applies a THRESHOLD,
- * produces findings with severities an adopter can configure, and lets an
- * adopter who promotes the code to `error` fail their build with it. Two verbs
- * because they are two acts, and folding a verdict into the query would make
- * the query's number a number people learn to stop reading.
- *
- * ## Everything below is orchestration — deliberately
- *
- * Which directories exist, what each pays, and whether that is over budget are
- * all decided in `@vibe-agent-toolkit/resources` (`buildClaudeContextPopulation`
- * and `sweepAlwaysLoadedBudgets`); the wording and grouping of the findings in
- * `utils/context-budget-issues.ts`; severity resolution in the two shared
- * filters every other lane runs. This module populates one tree, calls them in
- * order, and renders. It decides nothing about context loading of its own,
- * which is the CLI-stays-dumb rule applied to the lane where the temptation is
- * strongest.
- *
- * ⛔ The threshold is never re-spelled here. It is a MEASURED quantity that
- * lives beside the detector (`DEFAULT_ALWAYS_LOADED_CONTEXT_TOKENS`), and a
- * literal in this package would be a second source of truth that nothing
- * compares.
- *
- * ## The stated bounds ride ONCE on the REPORT, in every format
- *
- * The sibling query publishes 23 stated limits; this command applies a threshold
- * to the same measurement, so it publishes {@link ALWAYS_LOADED_BUDGET_LIMITS}
- * and {@link CLAUDE_CONTEXT_BOUNDS_STATEMENT} beside its verdict — the half that
- * GATES is the half whose bounds a reader most needs. Both are imported, never
- * restated: the sentence is domain content owned beside the list it frames.
- *
- * ⛔ They belong to the REPORT, never to a finding. A per-finding copy is the
- * defect this lane already shipped once on the query side, and it is invisible to
- * any assertion that checks presence rather than counting occurrences.
- */
-import { ALWAYS_LOADED_BUDGET_LIMITS, buildClaudeContextPopulation, CLAUDE_CONTEXT_BOUNDS_STATEMENT, DEFAULT_ALWAYS_LOADED_CONTEXT_TOKENS, sweepAlwaysLoadedBudgets, } from '@vibe-agent-toolkit/resources';
-import { applyAllowFilter, calculateValidationStatus, countBySeverity, } from '@vibe-agent-toolkit/schema';
-import { findProjectRoot } from '@vibe-agent-toolkit/utils';
-import { Command, Option } from 'commander';
-import { handleCommandError } from '../../utils/command-error.js';
-import { loadConfig } from '../../utils/config-loader.js';
-import { contextBudgetIssues, scopeSweepToPaths } from '../../utils/context-budget-issues.js';
-import { targetPathWithin } from '../../utils/corpus-target.js';
-import { resolveIssueSeverity } from '../../utils/issue-severity.js';
-import { createLogger } from '../../utils/logger.js';
-import { writeJsonOutput, writeStdoutSync, writeYamlOutput } from '../../utils/output.js';
-import { populationWiring } from '../../utils/population-wiring.js';
-import { withPopulationCache } from '../../utils/projection-store.js';
-import { runIntegrityFinding } from '../../utils/run-integrity.js';
-import { gitTrackerForProjectRoot } from '../audit/distributed-tree.js';
-/** How this command names itself in a refusal. */
-const COMMAND_NAME = 'vat claude budget';
-/** Soft wrap width for the printed limit statements. */
-const WRAP_COLUMNS = 96;
-/** How the corpus root itself is named to a reader — it has no path of its own. */
-const CORPUS_ROOT_LABEL = '<corpus root>';
-/**
- * Create the `vat claude budget [paths...]` command.
- *
- * @returns The configured Commander command
- */
-export function createBudgetCommand() {
-    const command = new Command('budget');
-    command
-        .description('Check whether the always-loaded context at a working location exceeds its budget')
-        .argument('[paths...]', 'Directories to check, with everything beneath them (default: the whole tree)')
-        .addOption(new Option('--format <format>', 'Output format: text (default), yaml, or json').choices([
-        'text',
-        'yaml',
-        'json',
-    ]).default('text'))
-        .option('--debug', 'Verbose logging to stderr')
-        .action(claudeBudgetCommand)
-        .addHelpText('after', `
-Description:
-  Reports ALWAYS_LOADED_CONTEXT_BUDGET for each instruction chain whose
-  always-loaded context exceeds the budget. The measured chain is the
-  repo-root CLAUDE.md, every CLAUDE.md on the path down to the working
-  location, one level of @ imports from each, and any unscoped rules file in
-  the root .claude/rules/. An AGENTS.md is measured only where a CLAUDE.md
-  imports it (@AGENTS.md) — Claude Code does not load it by name, so a repo
-  standardised on AGENTS.md alone has nothing here to measure. Path-scoped
-  rules (a paths: list) are excluded: they load when the agent touches a
-  matching file, not at launch.
-
-  ONE finding per chain, not per directory: directories loading the same files
-  share a finding, which names how many working locations pay it. Naming paths
-  narrows WHICH chains are reported; the payer count stays the whole tree's,
-  because that is the number that was measured.
-
-  This is the CHECK. 'vat claude context' is the QUERY — same lane, no
-  threshold and no verdict.
-
-Configuration (vibe-agent-toolkit.config.yaml):
-  resources.validation.thresholds.alwaysLoadedContextTokens moves the budget
-  (default ${String(DEFAULT_ALWAYS_LOADED_CONTEXT_TOKENS)}). resources.validation.severity.ALWAYS_LOADED_CONTEXT_BUDGET
-  silences it (ignore) or promotes it to warning/error. A project with no
-  config file is checked at the same default budget.
-
-Output:
-  - threshold:          the budget every chain was measured against
-  - scope/unmatchedScope: what was asked about, and what matched nothing.
-                        A path that matched nothing was NOT checked, so it is
-                        reported as a RESOURCE_CHECK_BROKEN error rather than
-                        passing quietly -- and that code is not configurable
-  - status/issueCounts: the worst actionable severity, plus every severity
-  - workingLocations, distinctChains, skippedUnknownLocations: whole-tree
-                        facts, so an empty findings list is legible
-  - findings:           one per over-budget chain, ascending by directory
-  - limits/boundsStatement: what this verdict does not settle, signed
-                        over-report or under-report. On the REPORT, never on a
-                        finding — they bound the method, not any one chain, so
-                        they are stated exactly once however many chains flag
-
-  Text to stdout by default; --format yaml|json for a program. Diagnostics
-  and blob-stage refusals go to stderr.
-
-Exit Codes:
-  0 - Reported (findings at the default info severity do not gate)
-  1 - A finding resolved to error severity via config, or a requested path
-      matched no working location so nothing was checked there
-  2 - System error (a path outside the corpus root, unreadable tree)
-
-Example:
-  $ vat claude budget packages/cli      # is it over budget where I work?
-`);
-    return command;
-}
-/**
- * Action handler for `vat claude budget [paths...]`.
- *
- * @param pathArgs - Directories to check; empty means the whole tree
- * @param options - The command's flags
- */
-export async function claudeBudgetCommand(pathArgs, options) {
-    const logger = createLogger(options.debug === true ? { debug: true } : {});
-    const startTime = Date.now();
-    try {
-        const root = findProjectRoot(process.cwd()) ?? process.cwd();
-        // 🔑 Every argument is resolved BEFORE the population. A path outside the
-        // corpus is a usage error, and finding it afterwards would charge the caller
-        // a full population — minutes on a cold cache — to be told they mistyped.
-        const scope = scopeWithin(root, pathArgs);
-        const config = loadConfig(root);
-        const validation = config?.resources?.validation;
-        const threshold = validation?.thresholds?.alwaysLoadedContextTokens
-            ?? DEFAULT_ALWAYS_LOADED_CONTEXT_TOKENS;
-        const sweep = await sweepBudgets(root, threshold, logger);
-        const scoped = scopeSweepToPaths(sweep, scope);
-        // The same two shared mechanisms every other lane uses, in the same order:
-        // `validation.allow` suppresses by path glob, then `validation.severity`
-        // resolves — BOTH directions, so an adopter promoting this code to `error`
-        // gets an error, which is the case that gets forgotten.
-        const findings = resolveIssueSeverity(applyAllowFilter(contextBudgetIssues(scoped.sweep), validation ?? {}).emitted, validation);
-        warnUnmatched(scoped.unmatchedScope, logger);
-        const report = buildReport({ root, threshold, scope, sweep, scoped, findings });
-        emit(report, options.format ?? 'text');
-        // `error` gates, and it is reachable two ways: an adopter promoted
-        // ALWAYS_LOADED_CONTEXT_BUDGET, or the run checked nothing — see
-        // {@link nothingCheckedFindings}. At the code's `info` default the first
-        // never fires, so the budget cannot fail a build unless an adopter asked it
-        // to; the second is not a severity anybody may configure away.
-        process.exit(report.issueCounts.errors > 0 ? 1 : 0);
-    }
-    catch (error) {
-        handleCommandError(error, logger, startTime, 'claude budget', options.format);
-    }
-}
-/**
- * Assemble the report from the run's parts.
- *
- * ⛔ The counters come from the UNSCOPED sweep. They answer "what was measured",
- * and a scope changes only what is reported — sourcing them from the narrowed
- * view would let `vat claude budget docs` claim the tree has one chain.
- *
- * ⛔ This is the ONE place the stated bounds enter the machine-readable output,
- * and keeping it a single assignment is what makes "stated once" structural
- * rather than a habit: there is no per-finding site left where a copy could be
- * reintroduced. They are attached unconditionally — a run that flagged nothing
- * used the same method, and a reader acting on "within budget" needs them most.
- *
- * ⛔ Exported so it can be TESTED. What has to be pinned is a COUNT — that the
- * block appears exactly once across a MULTI-finding report — and a presence
- * check passes identically with a copy per finding.
- *
- * ⛔ The run-integrity refusal is DERIVED here from `scoped.unmatchedScope`
- * rather than assembled by the caller, which is what makes "a run that checked
- * nothing never reports success" unrepresentable instead of merely observed:
- * there is no pipeline step left in which a later edit could drop it. See
- * {@link nothingCheckedFindings}.
- *
- * @param input - The run's parts
- * @returns The report, ready to serialize
- */
-export function buildReport(input) {
-    const { root, threshold, scope, sweep, scoped, findings } = input;
-    // The run-integrity report LEADS: every budget finding beneath it is noise
-    // until the operator knows part of what they asked about was never measured.
-    const reported = [...nothingCheckedFindings(scoped.unmatchedScope), ...findings];
-    return {
-        root,
-        threshold,
-        scope,
-        unmatchedScope: scoped.unmatchedScope,
-        status: calculateValidationStatus(reported),
-        issueCounts: countBySeverity(reported),
-        workingLocations: sweep.evaluatedDirectories,
-        distinctChains: sweep.queriedDirectories,
-        skippedUnknownLocations: sweep.skippedUnknownLocations,
-        findings: reported,
-        boundsStatement: CLAUDE_CONTEXT_BOUNDS_STATEMENT,
-        limits: ALWAYS_LOADED_BUDGET_LIMITS,
-    };
-}
-/**
- * Resolve the requested scope, defaulting to the whole tree.
- *
- * ⚠️ No arguments means the WHOLE TREE, not the current directory — the
- * opposite of `vat claude context`'s default, and deliberately so. This is a
- * check: the useful bare invocation is "tell me about everything", the way a
- * linter run from a subdirectory still lints the project. Naming a directory is
- * how a caller asks the narrower question.
- *
- * @param root - The discovered project root
- * @param pathArgs - The path arguments, possibly empty
- * @returns Root-relative directories; `['']` for the whole tree
- */
-function scopeWithin(root, pathArgs) {
-    if (pathArgs.length === 0)
-        return [''];
-    return pathArgs.map((pathArg) => targetPathWithin(root, pathArg, COMMAND_NAME));
-}
-/**
- * Say so, loudly, when a requested path named no working location.
- *
- * ⛔ `warn` (stderr), never `debug`. The human half of
- * {@link nothingCheckedFindings} — the same fact, on the channel a person reads,
- * ahead of the report rather than inside it.
- *
- * @param unmatched - The requested paths that matched nothing
- * @param logger - Where the warning goes
- */
-function warnUnmatched(unmatched, logger) {
-    if (unmatched.length === 0)
-        return;
-    logger.warn(`Warning: no working location matched ${unmatched.join(', ')} — nothing was checked there.`
-        + ' This is NOT a report that those paths are within budget.');
-}
-/**
- * The refusal for a run whose requested paths named no working location.
- *
- * 🔑 **A gate that checked nothing must never answer `success`.** This shipped:
- * `vat claude budget no/such/dir` reported `status: success` on exit 0, because
- * an unmatched scope measures zero chains and zero findings serializes
- * identically to "everything you asked about is within budget". The command
- * already knew — it warned on stderr that nothing had been checked — and then
- * published a document saying the opposite. Only the document gates a build, so
- * the two channels disagreed on the half that matters.
- *
- * 🪤 {@link warnUnmatched} still says the same thing on stderr, and that is not
- * the duplication this file bans elsewhere: stderr is the human channel and
- * stdout is the parsed document, so the two are one statement per audience. What
- * was wrong was never that the warning existed — it was that the DOCUMENT
- * contradicted it, and the exit code was computed from the document.
- *
- * ⛔ Not repeated a THIRD time inside the text rendering, though. That shares a
- * channel with the finding, which {@link renderReportText} already prints.
- *
- * The precedent is `vat resources check`'s `emptyCorpusFinding`, and this
- * follows it through the shared {@link runIntegrityFinding} rather than
- * inventing a third convention — `RESOURCE_CHECK_BROKEN` at `error`, derived in
- * {@link buildReport} rather than assembled in the handler, so it bypasses
- * `applyAllowFilter` and `resolveIssueSeverity` by construction and no report
- * carrying an unmatched path can be built with a clean status. The reasoning
- * behind each of those lives with the mechanism, in `run-integrity.ts`.
- *
- * ⛔ ONE finding however many paths went unmatched. The claim is about the RUN,
- * and one per argument is the per-finding duplication this report is built to
- * make impossible. It is not routed through `nothingCheckedFinding` because the
- * denominator here is not a count but a list of names the message must carry.
- *
- * @param unmatched - The requested paths that matched no working location
- * @returns The finding, or nothing when everything asked about was checked
- */
-function nothingCheckedFindings(unmatched) {
-    if (unmatched.length === 0)
-        return [];
-    const named = unmatched.map((path) => (path === '' ? CORPUS_ROOT_LABEL : path)).join(', ');
-    return [runIntegrityFinding(`No working location matched ${named}, so nothing was checked there and this`
-            + ' report is NOT a statement that those paths are within budget.'
-            + ' A working location is any non-ignored directory holding an enumerated file,'
-            + ' so a path matching none is usually a typo, a directory that is empty, or one'
-            + ' `.gitignore` declines — and the whole corpus root matching none means the'
-            + ' enumeration came back empty, which a broad ignore pattern or a shallow or'
-            + ' sparse checkout produces.'
-            + ' `vat resources scan` over the same path lists what an enumeration finds.')];
-}
-/**
- * Populate the Claude-context lane for one tree and sweep every location.
- *
- * ⚠️ Roots at the discovered project root and NOWHERE else, whatever paths were
- * named. A budget is a property of a position in the directory tree, and rooting
- * a population at a subdirectory would compute one against a corpus whose
- * ancestors are missing — a confidently wrong number.
- *
- * @param root - The absolute corpus root; the ONLY tree populated
- * @param threshold - The always-loaded token budget
- * @param logger - Where blob-stage refusals go. **stderr**, never stdout: this
- *   command's stdout is the document a caller parses
- * @returns Every working location's budget
- */
-async function sweepBudgets(root, threshold, logger) {
-    const projection = await withPopulationCache({ root }, async (cache) => {
-        const gitTracker = await gitTrackerForProjectRoot(root);
-        return buildClaudeContextPopulation({ root, ...populationWiring(logger, gitTracker, cache, root) });
-    });
-    return sweepAlwaysLoadedBudgets(projection, threshold);
-}
-/**
- * Write the report in the requested format.
- *
- * @param report - The report
- * @param format - The selected format
- */
-function emit(report, format) {
-    if (format === 'json') {
-        writeJsonOutput(report);
-        return;
-    }
-    if (format === 'yaml') {
-        writeYamlOutput(report);
-        return;
-    }
-    writeStdoutSync(renderReportText(report));
-}
-/**
- * Render the report for a person.
- *
- * ⛔ Exported so the "stated once" property can be pinned in TEXT as well as in
- * json. The two renderings are separate code paths and this lane has already
- * shipped a defect where they disagreed while each looked right alone.
- *
- * @param report - The report
- * @returns The text rendering, newline-terminated
- */
-export function renderReportText(report) {
-    const lines = [
-        `Always-loaded context budget at ${report.root}`,
-        `  budget ${count(report.threshold)} tokens`
-            + ` · ${count(report.workingLocations)} working locations`
-            + ` · ${count(report.distinctChains)} distinct chains`
-            + ` · ${count(report.skippedUnknownLocations)} unrealized`,
-        '',
-        ...findingLines(report.findings),
-        ...limitLines(report),
-    ];
-    return `${lines.join('\n')}\n`;
-}
-/**
- * The stated bounds, printed once at the foot of the report.
- *
- * ⛔ Never omitted, and never per finding. A clean report is subject to exactly
- * the same signed bounds as a flagged one — more so, since "within budget" is the
- * verdict a reader is most likely to act on without reading further.
- *
- * The sibling `vat claude context` prints a section of the same shape from its
- * own list. They are deliberately NOT sharing a renderer: two commands, two
- * report types, and the query additionally prints the modelled-behaviour
- * citations that no bound of this verdict rests on.
- *
- * @param report - The report carrying the bounds
- * @returns The section's lines
- */
-function limitLines(report) {
-    const lines = ['What this verdict does not settle', ...wrapped(report.boundsStatement, '  '), ''];
-    for (const limit of report.limits) {
-        lines.push(`  ${limit.direction}: ${limit.id}`);
-        lines.push(...wrapped(limit.statement, '    '));
-    }
-    return lines;
-}
-/**
- * Soft-wrap a statement under a fixed indent.
- *
- * The statements run to several sentences and are the part of this output a
- * reader has to actually read; unwrapped they arrive as one 500-column line that
- * a terminal breaks mid-word. A word longer than the width overflows its own line
- * rather than being split — no character of a statement is ever dropped.
- *
- * @param text - The statement
- * @param indent - Leading whitespace for every produced line
- * @returns One or more indented lines
- */
-function wrapped(text, indent) {
-    const width = Math.max(WRAP_COLUMNS - indent.length, 24);
-    const lines = [];
-    let pending = '';
-    for (const word of text.split(' ')) {
-        const candidate = pending === '' ? word : `${pending} ${word}`;
-        if (pending !== '' && candidate.length > width) {
-            lines.push(indent + pending);
-            pending = word;
-        }
-        else {
-            pending = candidate;
-        }
-    }
-    if (pending !== '')
-        lines.push(indent + pending);
-    return lines;
-}
-/**
- * The findings, or the sentence that says there were none.
- *
- * ⛔ The empty case is a SENTENCE, not blank output. A command that prints
- * nothing is indistinguishable from one that failed to run.
- *
- * @param findings - The reported findings
- * @returns The lines, blank-terminated
- */
-function findingLines(findings) {
-    if (findings.length === 0)
-        return ['Every instruction chain checked is within budget.', ''];
-    const lines = [];
-    for (const finding of findings) {
-        lines.push(`${finding.severity} ${finding.code} at ${finding.location ?? CORPUS_ROOT_LABEL}`);
-        lines.push(`  ${finding.message}`);
-        if (finding.fix !== undefined)
-            lines.push(`  Fix: ${finding.fix}`);
-        lines.push('');
-    }
-    return lines;
-}
-/**
- * A count as a reader reads it.
- *
- * Pinned to `en-US` rather than left to the host locale, so the same run renders
- * byte-identically on two developers' machines — the same rule the findings
- * themselves follow in `utils/context-budget-issues.ts`.
- *
- * @param value - The number
- * @returns Its thousands-separated form
- */
-function count(value) {
-    return value.toLocaleString('en-US');
-}
-//# sourceMappingURL=budget.js.map

package/dist/commands/claude/budget.js.map

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

package/dist/utils/context-budget-issues.d.ts

@@ -1,108 +0,0 @@
-/**
- * The always-loaded context budget sweep, rendered as validation findings.
- *
- * Pure: no I/O, no config, no severity resolution, no exit code. It takes the
- * {@link BudgetSweep} `@vibe-agent-toolkit/resources` produced and answers
- * "which of these does a reader need to be told about, and in what words". The
- * command that calls it stays a thin orchestrator, and this file is where the
- * decision worth testing lives.
- *
- * ## ONE issue per REPRESENTATIVE, never one per working location
- *
- * A sweep reports every working location, and locations sharing an instruction
- * chain share one budget — that is the whole point of the collapse. Re-measured
- * on VAT's own tree 2026-08-23, after the context population began declining the
- * gitignored half: **366 of 589 directories** pay the single chain
- * `['CLAUDE.md']`, so emitting per location would print 366 byte-identical
- * findings, all blaming one file, the moment the root `CLAUDE.md` crossed the
- * budget. (It read *"553 of 819"* against the wider population; the ratio barely
- * moved, and the argument does not turn on it.) There are **9** distinct chains
- * on this tree either way, so per-representative emission caps the output at 9
- * findings at any threshold.
- *
- * That is not a formatting preference. A check that emits 366 findings for one
- * cause is a check an adopter silences with
- * `severity.ALWAYS_LOADED_CONTEXT_BUDGET: ignore` rather than fixes — and a
- * silenced check reports nothing forever, which is strictly worse than the
- * finding it was trying to deliver.
- *
- * ## What the message may and may not claim
- *
- * ⛔ Never "the total cost". A global `~/.claude/CLAUDE.md` and the enabled skill
- * index are real always-loaded cost that this TREE-ONLY projection cannot see, so
- * even a budget reporting zero exclusions is a floor — see the module doc of
- * `packages/resources/src/projection/claude-context-budget.ts`, which states the
- * bound precisely and which this wording must not contradict. The messages here
- * therefore say "estimated at", and the narrower, checkable claim carried by
- * {@link AlwaysLoadedBudget.lowerBound} — that rows VAT *did* see were left out
- * of the sum — is appended as its own sentence with the three counts behind it.
- *
- * 🔑 `excludedRuleRows` is deliberately NOT one of those counts. What it counts is
- * PATH-SCOPED rules — the ones carrying a `paths:` list — and those are excluded
- * by DESIGN: they are `selected`, not `always`, so their absence from the sum is a
- * decision rather than a gap in what we know, and only ignorance makes a sum a
- * lower bound.
- *
- * ⛔ Not "rules files" as a class. An UNSCOPED rule in the root `.claude/rules/`
- * is classed `always` and IS charged into the budget — nothing gates it on a path,
- * so it loads at launch exactly as a CLAUDE.md does. The blanket reading was true
- * while every rule was excluded and became a false statement about a check that
- * gates the moment the root-rule admission started qualifying. It matters here
- * because the largest contributor a message names may now be a rules file, which
- * is why the registry `fix` points at the named contributors rather than at a file
- * type.
- */
-import type { BudgetSweep } from '@vibe-agent-toolkit/resources';
-import { type ValidationIssue } from '@vibe-agent-toolkit/schema';
-/** A sweep narrowed to the paths a caller asked about, and what did not match. */
-export interface ScopedSweep {
-    /**
-     * The narrowed sweep.
-     *
-     * ⚠️ It retains EVERY location of every selected chain, not only the ones
-     * inside the scope — see {@link scopeSweepToPaths} for why that is the whole
-     * point rather than an oversight.
-     */
-    readonly sweep: BudgetSweep;
-    /**
-     * Requested paths that named no working location in this sweep.
-     *
-     * ⛔ Reported rather than dropped. A scope that matched nothing produces zero
-     * findings, which is byte-identical to "everything you asked about is within
-     * budget" — the one confusion this field exists to prevent.
-     */
-    readonly unmatchedScope: readonly string[];
-}
-/**
- * Narrow a sweep to the instruction chains the requested paths inherit.
- *
- * ## The retention rule, which is the whole design
- *
- * A scope selects CHAINS, never payers. Every location paying a selected chain
- * is retained even when it sits outside the scope, because the finding's message
- * says how many working locations pay it — and that number is a fact about the
- * TREE. Retaining only the in-scope payers would make `vat claude budget
- * docs/guides` report *"1 working location pays it"* for a chain 366 directories
- * pay: a confidently wrong number, which costs more than no number.
- *
- * ## Matching is on SEGMENT boundaries
- *
- * `'packages/cli-x'.startsWith('packages/cli')` is true, so a bare prefix test
- * hands a sibling directory its neighbour's scope. The same trap
- * `representativeFor` in `claude-context-budget-sweep.ts` exists to avoid, one
- * layer down.
- *
- * @param sweep - Every working location's budget, from `sweepAlwaysLoadedBudgets`
- * @param scope - Root-relative directories to report for. `''` is the corpus
- *   root and selects the whole tree; an empty list selects nothing
- * @returns The narrowed sweep and the requested paths that matched no location
- */
-export declare function scopeSweepToPaths(sweep: BudgetSweep, scope: readonly string[]): ScopedSweep;
-/**
- * One finding per over-budget instruction chain, ordered for a clean diff.
- *
- * @param sweep - Every working location's budget, from `sweepAlwaysLoadedBudgets`
- * @returns The issues, ascending by representative directory (code point)
- */
-export declare function contextBudgetIssues(sweep: BudgetSweep): ValidationIssue[];
-//# sourceMappingURL=context-budget-issues.d.ts.map

package/dist/utils/context-budget-issues.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-budget-issues.d.ts","sourceRoot":"","sources":["../../src/utils/context-budget-issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAYvF,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAoB3F;AA4BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,EAAE,CAKzE"}