@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/read-output-contracts.js

@@ -1,1226 +1,2 @@
-/**
- * @module sdk/read-output-contracts
- *
- * Declares and applies one output-bounding vocabulary to every built-in read
- * surface without coupling package authors to command-specific option names.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2103a4dc-3037-5768-b2c7-5964de4ac86b")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { compactReadOutputToBudget, estimateReadOutputTokens, resolveReadOutputRecoveryBudget, updateReadOutputReceiptEstimate, } from "./read-output-budget.js";
-export { resolveReadOutputRecoveryBudget } from "./read-output-budget.js";
-import { resolvePmCommandOutputBudget } from "./cli-contracts/agent-output-contracts.js";
-import { boundReadOutputRows, countReadOutputRows, mapReadOutputRows, readOutputBudgetCollections, readOutputContinuationRowCollections, readOutputRowPaths, } from "./read-output-rows.js";
-import { applyReadOutputContinuation, decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, prioritizeAssuranceAssertions, readOutputCollectionFingerprint, } from "./read-output/continuation.js";
-export { decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES, readOutputCollectionFingerprint, } from "./read-output/continuation.js";
-import { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
-import { decodeQueryCursorEnvelope, encodeQueryCursor } from "./pagination.js";
-/** Stable output dimensions shared by every read surface. */
-export const PM_READ_OUTPUT_DIMENSIONS = [
-    "include",
-    "amount",
-    "cost",
-    "encoding",
-];
-/** Built-in command roots whose primary operation is a read. */
-export const PM_READ_OUTPUT_SURFACES = [
-    "list",
-    "context",
-    "search",
-    "get",
-    "next",
-    "health",
-    "deps",
-    "graph",
-    "history",
-    "activity",
-    "validate",
-    "events",
-    "contracts",
-    "comments",
-    "notes",
-    "files",
-    "docs",
-    "stats",
-    "aggregate",
-    "duplicates",
-    "package-catalog",
-    "package-manage",
-    "comments-audit",
-    "assurance",
-];
-const READ_OUTPUT_PRECEDENCE = [
-    "canonical",
-    "legacy",
-    "intent",
-    "default",
-];
-const CANONICAL_OPTIONS = {
-    include: "--output-include",
-    amount: "--output-limit",
-    cost: "--output-budget",
-    encoding: "--output-format",
-};
-const READ_OUTPUT_INVOCATION_PROVENANCE = Symbol.for("pm.readOutputInvocationProvenance");
-/** Canonical CLI flags that opt a read invocation into universal output shaping. */
-export const PM_READ_OUTPUT_OPTION_FLAGS = Object.freeze(PM_READ_OUTPUT_DIMENSIONS.map((dimension) => CANONICAL_OPTIONS[dimension]));
-/** Canonical control that composes the four per-call dimensions across reads. */
-export const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS = Object.freeze([
-    "--output-session",
-    "--output-cursor",
-    "--output-row-contract",
-]);
-const LEGACY_FLAGS_BY_COMMAND = {
-    list: {
-        include: ["--brief", "--compact", "--fields", "--full"],
-        amount: ["--after", "--limit", "--no-truncate"],
-        cost: ["--token-budget"],
-        encoding: ["--format", "--stream"],
-    },
-    context: {
-        include: ["--fields", "--section"],
-        amount: ["--after", "--depth", "--limit"],
-        cost: ["--token-budget"],
-        encoding: ["--format"],
-    },
-    search: {
-        include: ["--compact", "--fields", "--full"],
-        amount: ["--after", "--limit"],
-        cost: ["--token-budget"],
-        encoding: ["--format"],
-    },
-    get: {
-        include: ["--fields", "--full"],
-        amount: ["--depth"],
-        cost: ["--token-budget"],
-        encoding: ["--format"],
-    },
-    next: {
-        amount: ["--blocked-limit", "--limit"],
-        cost: ["--token-budget"],
-        encoding: ["--format"],
-    },
-    health: {
-        include: ["--brief", "--check-only", "--full", "--summary"],
-    },
-    deps: {
-        include: ["--collapse", "--full", "--summary"],
-        amount: ["--edge-limit", "--max-depth", "--node-limit"],
-        cost: ["--token-budget"],
-        encoding: ["--format"],
-    },
-    graph: {
-        include: ["--full", "--summary"],
-        amount: ["--after", "--limit", "--max-depth", "--max-paths"],
-    },
-    history: {
-        include: ["--compact", "--full"],
-        amount: ["--limit"],
-        encoding: ["--format"],
-    },
-    activity: {
-        include: ["--compact", "--full"],
-        amount: ["--limit", "--unbounded"],
-        encoding: ["--stream"],
-    },
-    validate: { include: ["--counts", "--full"] },
-    events: {
-        include: ["--full"],
-        amount: ["--limit"],
-        encoding: ["--follow"],
-    },
-    contracts: { include: ["--full", "--summary"] },
-    comments: { amount: ["--limit"] },
-    notes: { amount: ["--limit"] },
-    files: {
-        amount: ["--limit", "--no-truncate", "--offset"],
-    },
-    docs: {},
-    stats: {},
-    aggregate: {},
-    duplicates: { amount: ["--limit"] },
-    "package-catalog": {},
-    "package-manage": {},
-    "comments-audit": {},
-    assurance: {},
-};
-const VALUE_BEARING_INCLUDE_ALIASES = new Set([
-    "--collapse",
-    "--fields",
-    "--section",
-]);
-const BEHAVIOR_PRESERVING_MIGRATION_HINTS = Object.freeze({
-    "--after": "--after retains cursor-position semantics; use --output-limit <n> separately to bound returned rows.",
-    "--check-only": "--check-only retains health side-effect semantics; --output-include does not suppress vector refresh.",
-    "--collapse": "--collapse retains dependency grouping semantics; --output-include does not replace it.",
-    "--depth": "--depth retains traversal or detail-depth semantics; --output-limit does not replace it.",
-    "--follow": "--follow retains event-tail semantics; --output-format does not enable following.",
-    "--max-depth": "--max-depth retains graph traversal-depth semantics; --output-limit does not replace it.",
-    "--max-paths": "--max-paths retains graph path-search semantics; use --output-limit separately to bound returned rows.",
-    "--no-truncate": "--no-truncate is a compatibility alias; prefer --output-limit unbounded.",
-    "--offset": "--offset retains positional pagination semantics; use --output-limit separately to bound returned rows.",
-    "--stream": "--stream retains command streaming semantics; --output-format selects only static result encoding.",
-    "--unbounded": "--unbounded is a compatibility alias; prefer --output-limit unbounded.",
-});
-function flagSelector(flag) {
-    return flag.slice(2).replaceAll("-", "_");
-}
-function migrationHint(flag, dimension) {
-    const behaviorHint = BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag];
-    if (behaviorHint !== undefined)
-        return behaviorHint;
-    const suffix = dimension === "include"
-        ? VALUE_BEARING_INCLUDE_ALIASES.has(flag)
-            ? "<csv>"
-            : flagSelector(flag)
-        : dimension === "amount"
-            ? "<n>"
-            : dimension === "cost"
-                ? "<tokens>"
-                : "<toon|json>";
-    return `${flag} is a compatibility alias; prefer ${CANONICAL_OPTIONS[dimension]} ${suffix}.`;
-}
-function buildSurfaceContract(command) {
-    const legacy = LEGACY_FLAGS_BY_COMMAND[command];
-    const dimensions = Object.freeze(Object.fromEntries(PM_READ_OUTPUT_DIMENSIONS.map((dimension) => [
-        dimension,
-        Object.freeze({
-            dimension,
-            canonical_option: CANONICAL_OPTIONS[dimension],
-            applicable: true,
-            inapplicable_reason: null,
-            legacy_aliases: Object.freeze((legacy[dimension] ?? []).map((flag) => Object.freeze({
-                flag,
-                semantics: BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag] === undefined
-                    ? "replacement"
-                    : "behavior_preserving",
-                migration_hint: migrationHint(flag, dimension),
-                visibility: "hidden_alias",
-            }))),
-        }),
-    ])));
-    return Object.freeze({
-        command,
-        dimensions,
-        precedence: READ_OUTPUT_PRECEDENCE,
-        budget_retention_policy: command === "assurance" ? "verdict_priority" : "ordered_prefix",
-        projection_modes: Object.freeze([
-            ...readOutputIncludeModeOptions(command).keys(),
-        ]),
-    });
-}
-/** Universal output contract for every built-in read surface. */
-export const PM_READ_OUTPUT_SURFACE_CONTRACTS = Object.freeze(PM_READ_OUTPUT_SURFACES.map(buildSurfaceContract));
-const SURFACE_CONTRACT_BY_COMMAND = new Map(PM_READ_OUTPUT_SURFACE_CONTRACTS.map((contract) => [
-    contract.command,
-    contract,
-]));
-/** Resolve a command or list/context alias to its canonical read-output surface. */
-export function resolveReadOutputSurface(command, options = {}) {
-    const normalizedCommand = command
-        .trim()
-        .toLowerCase()
-        .replaceAll(/\s+/gu, " ");
-    const packageMode = normalizedCommand === "package catalog" ||
-        normalizedCommand === "packages catalog" ||
-        normalizedCommand === "package-catalog" ||
-        ((normalizedCommand === "package" ||
-            normalizedCommand === "packages" ||
-            normalizedCommand === "extension") &&
-            (options.catalog === true ||
-                options.target === "catalog" ||
-                options.action === "catalog"));
-    const root = packageMode
-        ? "package-catalog"
-        : normalizedCommand === "package manage" ||
-            normalizedCommand === "package-manage"
-            ? "package-manage"
-            : normalizedCommand.split(" ")[0];
-    const normalized = root.startsWith("list-")
-        ? "list"
-        : root === "ctx"
-            ? "context"
-            : root;
-    return PM_READ_OUTPUT_SURFACES.includes(normalized)
-        ? normalized
-        : undefined;
-}
-const CANONICAL_OPTION_KEYS = [
-    "outputInclude",
-    "output_include",
-    "outputLimit",
-    "output_limit",
-    "outputBudget",
-    "output_budget",
-    "outputFormat",
-    "output_format",
-    "outputSession",
-    "output_session",
-    "outputCursor",
-    "output_cursor",
-    "outputRowContract",
-    "output_row_contract",
-];
-const HYBRID_READ_MUTATION_KEYS = {
-    comments: ["add", "body", "stdin", "file", "edit", "delete"],
-    notes: ["add", "addJson", "stdin", "file", "edit", "delete"],
-    files: ["add", "addGlob", "remove", "migrate", "apply", "note"],
-    docs: ["add", "addGlob", "remove", "migrate", "note"],
-    "package-catalog": [
-        "activate",
-        "adopt",
-        "adoptAll",
-        "deactivate",
-        "doctor",
-        "init",
-        "install",
-        "manage",
-        "migrate",
-        "reload",
-        "scaffold",
-        "uninstall",
-    ],
-};
-function hasCanonicalReadOutputOptions(options) {
-    return CANONICAL_OPTION_KEYS.some((key) => options[key] !== undefined);
-}
-const READ_OUTPUT_VALUE_VALIDATORS = [
-    {
-        keys: ["outputInclude", "output_include"],
-        valid: (value) => stringList(value) !== undefined,
-        message: "--output-include requires at least one comma-separated field or section.",
-    },
-    {
-        keys: ["outputLimit", "output_limit"],
-        valid: (value) => value === "unbounded" || positiveInteger(value) !== undefined,
-        message: "--output-limit must be a positive integer or unbounded.",
-    },
-    {
-        keys: ["outputBudget", "output_budget"],
-        valid: (value) => value === "unbounded" || positiveInteger(value) !== undefined,
-        message: "--output-budget must be a positive integer or unbounded.",
-    },
-    {
-        keys: ["outputFormat", "output_format"],
-        valid: (value) => value === "toon" || value === "json",
-        message: "--output-format must be toon or json.",
-    },
-    {
-        keys: ["outputSession", "output_session"],
-        valid: (value) => {
-            parseReadOutputSession(value);
-            return true;
-        },
-        message: "--output-session must be a valid session-state object.",
-    },
-    {
-        keys: ["outputCursor", "output_cursor"],
-        valid: (value) => typeof value === "string" && value.trim().length > 0,
-        message: "--output-cursor requires a non-empty continuation cursor.",
-    },
-];
-/** Reject malformed or mutation-scoped universal output controls before command execution. */
-export function validateReadOutputOptions(command, options) {
-    if (!hasCanonicalReadOutputOptions(options))
-        return;
-    const normalizedCommand = resolveReadOutputSurface(command, options);
-    if (!normalizedCommand) {
-        throw new PmCliError(`Universal output controls apply only to read commands; ${command || "this command"} is not a read surface.`, EXIT_CODE.USAGE);
-    }
-    if ((HYBRID_READ_MUTATION_KEYS[normalizedCommand] ?? []).some((key) => options[key] !== undefined && options[key] !== false)) {
-        throw new PmCliError(`Universal output controls cannot be combined with a ${normalizedCommand} mutation.`, EXIT_CODE.USAGE);
-    }
-    for (const validator of READ_OUTPUT_VALUE_VALIDATORS) {
-        const value = validator.keys
-            .map((key) => options[key])
-            .find((entry) => entry !== undefined);
-        if (value !== undefined && !validator.valid(value)) {
-            throw new PmCliError(validator.message, EXIT_CODE.USAGE);
-        }
-    }
-}
-/**
- * Map every canonical `--output-include` token that names a projection mode
- * rather than a row field onto the command-local option that mode already owns.
- *
- * The include dimension folds two kinds of legacy alias into one canonical
- * spelling: value-bearing selectors (`--fields`, `--section`) that name row
- * fields, and mode flags (`--brief`, `--full`, `--summary`, ...) that select a
- * whole declared projection. Only the first kind can be honoured by projecting
- * an already-computed result, so mode tokens have to reach the command itself.
- */
-export function readOutputIncludeModeOptions(command) {
-    const surface = resolveReadOutputSurface(command);
-    if (!surface)
-        return new Map();
-    return new Map((LEGACY_FLAGS_BY_COMMAND[surface].include ?? [])
-        .filter((flag) => !VALUE_BEARING_INCLUDE_ALIASES.has(flag) &&
-        BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag] === undefined)
-        .map((flag) => [flagSelector(flag), optionKey(flag)]));
-}
-/**
- * Translate canonical projection-mode tokens into the command-local options
- * they alias, so the spelling the migration hints recommend is behaviour
- * identical to the legacy flag it replaces, and return the field selectors that
- * remain for post-execution projection.
- */
-export function applyReadOutputIncludeModes(command, includeValue, commandOptions) {
-    const requested = stringList(includeValue) ?? [];
-    const modeOptions = readOutputIncludeModeOptions(command);
-    const selectors = [];
-    const modes = [];
-    const optionsWithProvenance = commandOptions;
-    const existingProvenance = optionsWithProvenance[READ_OUTPUT_INVOCATION_PROVENANCE];
-    const canonicalModes = new Set(existingProvenance?.canonical_include_modes ?? []);
-    const explicitLegacyAliases = new Set(existingProvenance?.explicit_legacy_aliases ?? []);
-    for (const token of requested) {
-        const option = modeOptions.get(token);
-        if (option === undefined) {
-            selectors.push(token);
-            continue;
-        }
-        const legacyFlag = `--${token.replaceAll("_", "-")}`;
-        if (isRequestedOption(readOption(commandOptions, legacyFlag))) {
-            explicitLegacyAliases.add(legacyFlag);
-        }
-        commandOptions[option] = true;
-        modes.push(token);
-        canonicalModes.add(token);
-    }
-    const forwardedGetFieldSelectors = resolveReadOutputSurface(command) === "get"
-        ? selectors.filter((selector) => selector !== "item")
-        : [];
-    const forwardedGetFields = forwardedGetFieldSelectors.length > 0;
-    if (forwardedGetFields) {
-        commandOptions.fields = [
-            ...new Set([
-                ...(stringList(commandOptions.fields) ?? []),
-                ...forwardedGetFieldSelectors,
-            ]),
-        ].join(",");
-        canonicalModes.add("fields");
-    }
-    if (modes.length > 0 || forwardedGetFields) {
-        optionsWithProvenance[READ_OUTPUT_INVOCATION_PROVENANCE] = {
-            canonical_include_modes: [...canonicalModes],
-            explicit_legacy_aliases: [...explicitLegacyAliases],
-            ...(existingProvenance?.cli_invocation_observed === true
-                ? { cli_invocation_observed: true }
-                : {}),
-        };
-    }
-    return { selectors, modes };
-}
-/**
- * Resolve canonical include modes against one combined options bag, rewriting
- * the include value in place to the selectors that remain.
- *
- * Used by dispatch paths that carry command options and universal output
- * controls in a single record, so an action honours a mode token exactly as the
- * CLI does.
- */
-export function normalizeReadOutputIncludeModeOptions(command, options) {
-    const include = options.outputInclude ?? options.output_include;
-    if (include === undefined)
-        return;
-    const { selectors, modes } = applyReadOutputIncludeModes(command, include, options);
-    if (modes.length === 0)
-        return;
-    const residual = selectors.length > 0 ? selectors.join(",") : undefined;
-    options.outputInclude = residual;
-    if (Object.hasOwn(options, "output_include")) {
-        options.output_include = residual;
-    }
-}
-function optionKey(flag) {
-    return flag
-        .slice(2)
-        .replace(/-([a-z])/gu, (_, character) => character.toUpperCase());
-}
-function readOption(options, flag) {
-    const key = optionKey(flag);
-    if (Object.hasOwn(options, key))
-        return options[key];
-    const snakeKey = flag.slice(2).replaceAll("-", "_");
-    if (Object.hasOwn(options, snakeKey))
-        return options[snakeKey];
-    if (flag === "--no-truncate" && options.truncate === false)
-        return true;
-    return undefined;
-}
-function isRequestedOption(value) {
-    return value !== undefined && value !== false && value !== null;
-}
-function stringList(value) {
-    const values = Array.isArray(value) ? value : [value];
-    const normalized = values
-        .flatMap((entry) => (typeof entry === "string" ? entry.split(",") : []))
-        .map((entry) => entry.trim())
-        .filter(Boolean);
-    return normalized.length > 0 ? [...new Set(normalized)] : undefined;
-}
-function positiveInteger(value) {
-    const parsed = typeof value === "number"
-        ? value
-        : typeof value === "string" && /^\d+$/u.test(value.trim())
-            ? Number(value)
-            : Number.NaN;
-    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
-}
-function resolveLegacyDimension(contract, options, usable, ignore) {
-    for (const alias of contract.legacy_aliases) {
-        if (ignore(alias.flag))
-            continue;
-        const value = readOption(options, alias.flag);
-        const candidate = { value, flag: alias.flag };
-        if (isRequestedOption(value) && usable(candidate))
-            return candidate;
-    }
-    return undefined;
-}
-function resolveIncludeValue(canonical, legacy) {
-    const canonicalList = stringList(canonical);
-    if (canonicalList)
-        return { source: "canonical", value: canonicalList };
-    if (!legacy)
-        return undefined;
-    return {
-        source: "legacy",
-        value: stringList(legacy.value) ?? [flagSelector(legacy.flag)],
-    };
-}
-function resolveAmountValue(canonical, legacy) {
-    if (canonical === "unbounded") {
-        return { source: "canonical", value: "unbounded" };
-    }
-    const canonicalLimit = positiveInteger(canonical);
-    if (canonicalLimit !== undefined) {
-        return { source: "canonical", value: canonicalLimit };
-    }
-    if (!legacy)
-        return undefined;
-    if (legacy.flag === "--no-truncate" || legacy.flag === "--unbounded") {
-        return { source: "legacy", value: "unbounded" };
-    }
-    const legacyLimit = positiveInteger(legacy.value);
-    return legacyLimit === undefined
-        ? undefined
-        : { source: "legacy", value: legacyLimit };
-}
-function resolveCostValue(canonical, legacy) {
-    if (canonical === "unbounded") {
-        return { source: "canonical", value: "unbounded" };
-    }
-    const canonicalBudget = positiveInteger(canonical);
-    if (canonicalBudget !== undefined) {
-        return { source: "canonical", value: canonicalBudget };
-    }
-    if (!legacy)
-        return undefined;
-    const legacyBudget = positiveInteger(legacy.value);
-    return legacyBudget === undefined
-        ? undefined
-        : { source: "legacy", value: legacyBudget };
-}
-function resolveEncodingValue(canonical, legacy) {
-    if (canonical === "json" || canonical === "toon") {
-        return { source: "canonical", value: canonical };
-    }
-    if (!legacy)
-        return undefined;
-    if (legacy.flag === "--stream" || legacy.flag === "--follow") {
-        return { source: "legacy", value: "stream" };
-    }
-    return legacy.value === "json" || legacy.value === "toon"
-        ? { source: "legacy", value: legacy.value }
-        : undefined;
-}
-function shouldIgnoreReadOutputLegacyAlias(provenance, dimension, flag) {
-    if (!provenance)
-        return false;
-    const explicitLegacyAliases = new Set(provenance.explicit_legacy_aliases);
-    if (provenance.cli_invocation_observed === true) {
-        return !explicitLegacyAliases.has(flag);
-    }
-    const forwardedIncludeAliases = new Set(provenance.canonical_include_modes.map((mode) => `--${mode.replaceAll("_", "-")}`));
-    return (dimension === "include" &&
-        forwardedIncludeAliases.has(flag) &&
-        !explicitLegacyAliases.has(flag));
-}
-function hasCompleteReadOutputIntent(command, legacyByDimension, provenance) {
-    const root = command
-        .trim()
-        .toLowerCase()
-        .replaceAll(/\s+/gu, " ")
-        .split(" ")[0];
-    return (root === "list-all" ||
-        legacyByDimension.amount?.flag === "--no-truncate" ||
-        legacyByDimension.include?.flag === "--full" ||
-        provenance?.canonical_include_modes.includes("full") === true);
-}
-function canonicalReadOutputOptionsUsed(resolvedByDimension, provenance) {
-    return PM_READ_OUTPUT_DIMENSIONS.flatMap((dimension) => resolvedByDimension[dimension]?.source === "canonical" ||
-        (dimension === "include" &&
-            (provenance?.canonical_include_modes.length ?? 0) > 0)
-        ? [CANONICAL_OPTIONS[dimension]]
-        : []);
-}
-/** Resolve canonical and compatibility controls into the universal dimension set. */
-export function resolveReadOutputDimensions(command, options) {
-    const normalizedCommand = resolveReadOutputSurface(command, options);
-    if (!normalizedCommand)
-        return undefined;
-    const contract = SURFACE_CONTRACT_BY_COMMAND.get(normalizedCommand);
-    const invocationProvenance = options[READ_OUTPUT_INVOCATION_PROVENANCE];
-    const legacyResolvers = {
-        include: (candidate) => resolveIncludeValue(undefined, candidate),
-        amount: (candidate) => resolveAmountValue(undefined, candidate),
-        cost: (candidate) => resolveCostValue(undefined, candidate),
-        encoding: (candidate) => resolveEncodingValue(undefined, candidate),
-    };
-    const legacyByDimension = Object.fromEntries(PM_READ_OUTPUT_DIMENSIONS.map((dimension) => [
-        dimension,
-        resolveLegacyDimension(contract.dimensions[dimension], options, (candidate) => legacyResolvers[dimension](candidate) !== undefined, (flag) => shouldIgnoreReadOutputLegacyAlias(invocationProvenance, dimension, flag)),
-    ]));
-    const legacyAliasesUsed = PM_READ_OUTPUT_DIMENSIONS.flatMap((dimension) => {
-        const resolved = legacyByDimension[dimension];
-        return resolved ? [resolved.flag] : [];
-    });
-    const migrationHints = PM_READ_OUTPUT_DIMENSIONS.flatMap((dimension) => {
-        const resolved = legacyByDimension[dimension];
-        if (!resolved)
-            return [];
-        const alias = contract.dimensions[dimension].legacy_aliases.find((entry) => entry.flag === resolved.flag);
-        return [alias.migration_hint];
-    });
-    const encoding = resolveEncodingValue(options.outputFormat ?? options.output_format, legacyByDimension.encoding);
-    const include = resolveIncludeValue(options.outputInclude ?? options.output_include, legacyByDimension.include);
-    const amount = resolveAmountValue(options.outputLimit ?? options.output_limit, legacyByDimension.amount);
-    const explicitCost = resolveCostValue(options.outputBudget ?? options.output_budget, legacyByDimension.cost);
-    const completeResultIntent = hasCompleteReadOutputIntent(command, legacyByDimension, invocationProvenance);
-    const budget = resolvePmCommandOutputBudget(command, {
-        generateFallback: true,
-    });
-    const resolvedOutputFormat = encoding?.value === "json" || options.resolvedOutputFormat === "json"
-        ? "json"
-        : "toon";
-    const cost = explicitCost ??
-        (completeResultIntent
-            ? { source: "intent", value: "unbounded" }
-            : {
-                source: "default",
-                value: budget.default_max_estimated_tokens_by_format[resolvedOutputFormat],
-            });
-    const resolvedByDimension = { include, amount, cost, encoding };
-    return {
-        command: normalizedCommand,
-        include,
-        amount,
-        cost,
-        encoding,
-        canonical_options_used: canonicalReadOutputOptionsUsed(resolvedByDimension, invocationProvenance),
-        legacy_aliases_used: legacyAliasesUsed,
-        migration_hints: migrationHints,
-        precedence: READ_OUTPUT_PRECEDENCE,
-    };
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-const ENVELOPE_KEYS = new Set([
-    "applied_bound",
-    "applied_limit",
-    "completeness",
-    "continuation_kind",
-    "continuation_path",
-    "continuation_contract",
-    "count",
-    "filters",
-    "has_more",
-    "next_cursor",
-    "now",
-    "omission_receipt",
-    "projection",
-    "budget_retention_policy",
-    "row_contract",
-    "sorting",
-    "total",
-    "truncated",
-]);
-const GET_STABLE_DERIVED_ITEM_SELECTORS = [
-    "collection_counts",
-    "notes_count",
-    "tests_count",
-];
-function projectRecordFields(value, selectors) {
-    const selected = new Set(selectors.map((selector) => selector.split(".")[0]));
-    return Object.fromEntries(Object.entries(value).filter(([key]) => selected.has(key)));
-}
-function getProjectionVocabulary(result) {
-    const item = isRecord(result.item) ? result.item : {};
-    const itemFields = [
-        ...new Set([
-            ...Object.keys(item),
-            ...GET_STABLE_DERIVED_ITEM_SELECTORS.filter((key) => Object.hasOwn(item, key)),
-        ]),
-    ].sort((left, right) => left.localeCompare(right));
-    const sections = Object.keys(result)
-        .filter((key) => key !== "item" && key !== "read_output" && !ENVELOPE_KEYS.has(key))
-        .sort((left, right) => left.localeCompare(right));
-    return {
-        item,
-        itemFields,
-        sections,
-        valid: [
-            ...itemFields,
-            "item",
-            ...itemFields.map((field) => `item.${field}`),
-            ...sections,
-        ],
-    };
-}
-function applyGetIncludeProjection(result, selectors) {
-    const vocabulary = getProjectionVocabulary(result);
-    const unknown = selectors.filter((selector) => !vocabulary.valid.includes(selector));
-    if (unknown.length > 0) {
-        throw new PmCliError(`Unknown --output-include selector(s) for get: ${unknown.join(", ")}. Valid selectors: ${vocabulary.valid.join(", ")}.`, EXIT_CODE.USAGE);
-    }
-    const fullItem = selectors.includes("item");
-    const itemSelectors = selectors
-        .flatMap((selector) => selector.startsWith("item.")
-        ? [selector.slice("item.".length)]
-        : vocabulary.itemFields.includes(selector)
-            ? [selector]
-            : [])
-        .filter((selector, index, values) => values.indexOf(selector) === index);
-    if (fullItem && itemSelectors.length > 0) {
-        throw new PmCliError("--output-include cannot mix a full item with projected item fields; use item or item.<field>, not both.", EXIT_CODE.USAGE);
-    }
-    const selectedSections = new Set(selectors.filter((selector) => vocabulary.sections.includes(selector)));
-    const projected = Object.fromEntries(Object.entries(result).filter(([key]) => ENVELOPE_KEYS.has(key) || selectedSections.has(key)));
-    if (fullItem) {
-        projected.item = vocabulary.item;
-    }
-    else if (itemSelectors.length > 0) {
-        projected.item = projectRecordFields(vocabulary.item, itemSelectors);
-    }
-    const omittedFieldGroups = [
-        ...(fullItem
-            ? []
-            : itemSelectors.length > 0
-                ? vocabulary.itemFields
-                    .filter((field) => !itemSelectors.includes(field))
-                    .map((field) => ({
-                    name: `item.${field}`,
-                    restore_with: `--output-include item.${field}`,
-                }))
-                : [{ name: "item", restore_with: "--output-include item" }]),
-        ...vocabulary.sections
-            .filter((section) => !selectedSections.has(section))
-            .map((section) => ({
-            name: section,
-            restore_with: `--output-include ${section}`,
-        })),
-    ];
-    const inheritedOmittedFieldGroups = isRecord(projected.omission_receipt) &&
-        Array.isArray(projected.omission_receipt.omitted_field_groups)
-        ? projected.omission_receipt.omitted_field_groups
-        : [];
-    const combinedOmittedFieldGroups = [
-        ...inheritedOmittedFieldGroups,
-        ...omittedFieldGroups,
-    ];
-    projected.omission_receipt = {
-        has_omissions: combinedOmittedFieldGroups.length > 0,
-        omitted_field_group_count: combinedOmittedFieldGroups.length,
-        omitted_field_groups: combinedOmittedFieldGroups,
-    };
-    return projected;
-}
-/** Count row objects that still carry at least one field. */
-function countPopulatedRows(result) {
-    let populated = 0;
-    mapReadOutputRows({ ...result }, (entry) => {
-        if (isRecord(entry) && Object.keys(entry).length > 0)
-            populated += 1;
-        return entry;
-    });
-    return populated;
-}
-/**
- * Refuse an include projection that strips every field from every row.
- *
- * Selectors that match no field are not a narrower answer, they are no answer:
- * without this the surface returns the requested row count as empty objects and
- * exits 0, so a mistyped or mode-shaped selector is indistinguishable from a
- * workspace that genuinely holds nothing.
- */
-function rejectEmptyIncludeProjection(command, original, shaped, selectors) {
-    if (countPopulatedRows(original) === 0 || countPopulatedRows(shaped) > 0) {
-        return;
-    }
-    const modes = [...readOutputIncludeModeOptions(command).keys()];
-    const domain = modes.length > 0
-        ? ` Declared ${command} projection modes: ${modes.join(", ")}.`
-        : ` The ${command} surface declares no projection modes; name row fields instead.`;
-    throw new PmCliError(`Unknown --output-include selector(s) for ${command}: ${selectors.join(", ")}. No selector matched any returned row field.${domain}`, EXIT_CODE.USAGE);
-}
-function applyIncludeProjection(command, result, selectors) {
-    if (command === "get") {
-        return applyGetIncludeProjection(result, selectors);
-    }
-    const rows = readOutputRowPaths(result);
-    const qualifiedRowSelectors = selectors.flatMap((selector) => rows.flatMap((rowPath) => selector.startsWith(`${rowPath}.`)
-        ? [selector.slice(rowPath.length + 1)]
-        : []));
-    const selectedRoot = selectors.some((selector) => Object.hasOwn(result, selector.split(".")[0]) &&
-        !rows.some((rowPath) => selector.startsWith(`${rowPath}.`)));
-    if (rows.length > 0 && (!selectedRoot || qualifiedRowSelectors.length > 0)) {
-        const projected = { ...result };
-        const rowSelectors = qualifiedRowSelectors.length > 0 ? qualifiedRowSelectors : selectors;
-        const shaped = mapReadOutputRows(projected, (entry) => isRecord(entry) ? projectRecordFields(entry, rowSelectors) : entry);
-        rejectEmptyIncludeProjection(command, result, shaped, rowSelectors);
-        return shaped;
-    }
-    return Object.fromEntries(Object.entries(result).filter(([key]) => selectors.some((selector) => selector.split(".")[0] === key) ||
-        ENVELOPE_KEYS.has(key)));
-}
-function applyAmountBound(result, amount) {
-    if (amount === "unbounded")
-        return result;
-    const { result: bounded, truncated } = boundReadOutputRows(result, amount);
-    if (!truncated)
-        return bounded;
-    bounded.has_more = true;
-    bounded.truncated = true;
-    if (typeof bounded.count === "number") {
-        bounded.count = countReadOutputRows(bounded);
-    }
-    bounded.applied_bound = {
-        kind: "output_limit",
-        source: "explicit",
-        value: amount,
-    };
-    return bounded;
-}
-function requestedDimensions(resolved) {
-    return PM_READ_OUTPUT_DIMENSIONS.filter((dimension) => (resolved[dimension] !== undefined &&
-        resolved[dimension]?.source !== "default") ||
-        resolved.canonical_options_used.includes(CANONICAL_OPTIONS[dimension]));
-}
-/** Stabilize the per-call and cross-call receipts in one complete envelope. */
-function attachReadOutputSessionContracts(result, state, receipt) {
-    let withSession = attachReadOutputSessionReceipt(result, state);
-    for (let iteration = 0; iteration < 8; iteration += 1) {
-        const previousReadEstimate = receipt.estimated_tokens;
-        const previousSessionEstimate = withSession.read_session.spent_this_call_tokens;
-        updateReadOutputReceiptEstimate(withSession, receipt);
-        withSession = attachReadOutputSessionReceipt(withSession, state);
-        const sessionEstimate = withSession.read_session.spent_this_call_tokens;
-        if (receipt.estimated_tokens === previousReadEstimate &&
-            sessionEstimate === previousSessionEstimate) {
-            return withSession;
-        }
-    }
-    return withSession;
-}
-/** Recompute read and optional session receipts after a final envelope projection. */
-export function stabilizeReadOutputReceiptEstimates(result, options) {
-    if (!isRecord(result.read_output))
-        return result;
-    const receipt = result.read_output;
-    const session = parseReadOutputSession(options.outputSession ?? options.output_session);
-    if (session === undefined) {
-        updateReadOutputReceiptEstimate(result, receipt);
-        return result;
-    }
-    return attachReadOutputSessionContracts(result, session, receipt);
-}
-/** Declare independently resumable validate diagnostic arrays on rich results. */
-function attachValidateDiagnosticRowContract(command, result) {
-    if (command !== "validate")
-        return result;
-    const projection = isRecord(result.projection)
-        ? result.projection
-        : undefined;
-    const declaredFieldGroups = Array.isArray(projection?.declared_field_groups)
-        ? projection.declared_field_groups
-        : [];
-    if (!declaredFieldGroups.some((group) => isRecord(group) && group.name === "diagnostic_rows")) {
-        return result;
-    }
-    const diagnosticCollectionPaths = [
-        ...new Set(readOutputBudgetCollections(result)
-            .map(({ path }) => path)
-            .filter((path) => /^checks\.\d+\.details\./u.test(path))),
-    ];
-    const diagnosticRowKeys = diagnosticCollectionPaths.filter((path) => !diagnosticCollectionPaths.some((candidate) => candidate !== path && path.startsWith(`${candidate}.`)));
-    if (diagnosticRowKeys.length === 0)
-        return result;
-    const existingContract = isRecord(result.row_contract)
-        ? result.row_contract
-        : {};
-    const existingRowKeys = Array.isArray(existingContract.row_keys)
-        ? existingContract.row_keys.filter((entry) => typeof entry === "string")
-        : [];
-    const existingContinuationRowKeys = Array.isArray(existingContract.continuation_row_keys)
-        ? existingContract.continuation_row_keys.filter((entry) => typeof entry === "string")
-        : [];
-    const rowKeys = existingRowKeys.length > 0 ? existingRowKeys : diagnosticRowKeys;
-    const continuationRowKeys = [...new Set(diagnosticRowKeys)];
-    return JSON.stringify(rowKeys) === JSON.stringify(existingRowKeys) &&
-        JSON.stringify(continuationRowKeys) ===
-            JSON.stringify(existingContinuationRowKeys)
-        ? result
-        : {
-            ...result,
-            row_contract: {
-                ...existingContract,
-                row_keys: rowKeys,
-                continuation_row_keys: continuationRowKeys,
-                jq_selector: typeof existingContract.jq_selector === "string"
-                    ? existingContract.jq_selector
-                    : ".checks[].details",
-            },
-        };
-}
-/** Apply field, amount, and repeat projections to every declared row path. */
-function projectReadOutputRows(result, resolved, session, cursor) {
-    let projected = { ...result };
-    if (resolved.include?.source === "canonical") {
-        projected = applyIncludeProjection(resolved.command, projected, resolved.include.value);
-    }
-    if (resolved.command === "assurance") {
-        projected = prioritizeAssuranceAssertions(projected);
-    }
-    projected = applyReadOutputContinuation(projected, resolved.command, cursor);
-    if (resolved.amount?.source === "canonical") {
-        projected = applyAmountBound(projected, resolved.amount.value);
-    }
-    return session === undefined
-        ? projected
-        : applyReadOutputSessionReferences(projected, session);
-}
-/** Resolve the smallest binding per-call or remaining cross-call ceiling. */
-function resolveBindingReadOutputBudget(resolved, session) {
-    const budgets = [
-        ...(resolved.cost !== undefined &&
-            resolved.cost.value !== "unbounded" &&
-            (resolved.cost.source === "canonical" || resolved.cost.source === "default")
-            ? [{ source: resolved.cost.source, tokens: resolved.cost.value }]
-            : []),
-        ...(session === undefined
-            ? []
-            : [
-                {
-                    source: "session",
-                    tokens: readOutputSessionRemainingTokens(session),
-                },
-            ]),
-    ];
-    return budgets.sort((left, right) => left.tokens - right.tokens)[0];
-}
-function canonicalReadOutputReceiptFields(resolved) {
-    const canonicalOptions = resolved.canonical_options_used;
-    return canonicalOptions && canonicalOptions.length > 0
-        ? { canonical_options_used: canonicalOptions }
-        : {};
-}
-/** Build the smallest truthful omission envelope or reject an exhausted session. */
-function omitReadOutputForBudget(resolved, requested, session, bindingBudget, omittedResultEstimatedTokens) {
-    const minimalReceipt = {
-        contract_version: 1,
-        command: resolved.command,
-        requested_dimensions: requested,
-        ...(bindingBudget.source === "default"
-            ? {
-                budget_source: bindingBudget.source,
-                budget_tokens: bindingBudget.tokens,
-            }
-            : {}),
-        precedence: resolved.precedence,
-        ...canonicalReadOutputReceiptFields(resolved),
-        legacy_aliases_used: [],
-        migration_hints: [],
-        estimated_tokens: 0,
-        within_budget: false,
-        strings_compacted: false,
-        rows_compacted: false,
-        result_omitted: true,
-        ...(session === undefined
-            ? { omitted_result_estimated_tokens: omittedResultEstimatedTokens }
-            : {}),
-    };
-    const omitted = {
-        output_budget_exceeded: {
-            omitted_result: true,
-            reason: "requested_budget_infeasible",
-            restore_with: "Unbounded",
-            recovery: { outputBudget: "unbounded" },
-        },
-        read_output: minimalReceipt,
-    };
-    const boundedOmission = session === undefined
-        ? omitted
-        : attachReadOutputSessionContracts(omitted, session, minimalReceipt);
-    if (session === undefined) {
-        updateReadOutputReceiptEstimate(boundedOmission, minimalReceipt);
-    }
-    if (session !== undefined &&
-        minimalReceipt.estimated_tokens > bindingBudget.tokens) {
-        throw new PmCliError("The remaining output-session budget cannot fit its mandatory receipts; start a new session with a larger token_budget.", EXIT_CODE.USAGE);
-    }
-    return boundedOmission;
-}
-/** Decide whether shaping would add no value to an already-bounded result. */
-function canReturnReadOutputUnchanged(resolved, session, result) {
-    if (session !== undefined)
-        return false;
-    const canonicalRequestedCount = resolved.canonical_options_used.length;
-    if (resolved.cost?.value === "unbounded") {
-        return (canonicalRequestedCount === (resolved.cost.source === "canonical" ? 1 : 0));
-    }
-    if (resolved.cost?.source === "legacy" && canonicalRequestedCount === 0) {
-        return true;
-    }
-    return (canonicalRequestedCount === 0 &&
-        (resolved.cost === undefined ||
-            estimateReadOutputTokens(result) <= resolved.cost.value));
-}
-/**
- * Disclose a budget-driven row drop in the envelope that carries it.
- *
- * `has_more` and `truncated` say that rows were withheld but not why, by what,
- * or how to get them: the row-compaction path emits no continuation cursor, so
- * without this an explicitly requested unbounded read is silently downgraded and
- * the only working recovery is never named.
- */
-function attachReadOutputTruncationDisclosure(projected, resolved, receipt, bindingBudget, continuationCursorRebased, measuredResultTokens, collectionsBeforeBudget) {
-    if (!receipt.rows_compacted)
-        return;
-    const overridden = resolved.amount?.value === "unbounded" ? ["amount"] : [];
-    const afterByPath = new Map(readOutputContinuationRowCollections(projected).map((collection) => [
-        collection.path,
-        Array.isArray(collection.value)
-            ? collection.value.length
-            : Object.keys(collection.value).length,
-    ]));
-    const continuations = [...collectionsBeforeBudget.entries()].flatMap(([path, before]) => {
-        // Budget compaction preserves every declared collection and shortens its
-        // contents, so each pre-budget path has a post-budget cardinality.
-        const retainedRows = afterByPath.get(path);
-        if (retainedRows >= before.rows)
-            return [];
-        const offset = before.baseOffset + retainedRows;
-        return [
-            {
-                path,
-                cursor: encodeReadOutputContinuationCursor({
-                    command: resolved.command,
-                    path,
-                    offset,
-                    total_rows: before.totalRows,
-                    fingerprint: before.fingerprint,
-                }),
-                retained_rows: retainedRows,
-                remaining_rows: before.totalRows - offset,
-                total_rows: before.totalRows,
-            },
-        ];
-    });
-    const primary = continuations[0];
-    const recoveryBudget = resolveReadOutputRecoveryBudget({
-        effective_budget_tokens: bindingBudget.tokens,
-        measured_result_tokens: measuredResultTokens,
-    });
-    if (primary && typeof projected.next_cursor !== "string") {
-        projected.next_cursor = primary.cursor;
-    }
-    projected.continuation_kind = continuationCursorRebased
-        ? "producer_cursor"
-        : primary
-            ? "output_cursor"
-            : "none";
-    projected.output_budget_truncation = {
-        reason: "output_budget_reached",
-        budget_source: bindingBudget.source,
-        budget_tokens: bindingBudget.tokens,
-        overridden_dimensions: overridden,
-        compacted_row_paths: receipt.compacted_row_paths,
-        continuation_cursor_rebased: continuationCursorRebased,
-        continuation_available: continuations.length > 0,
-        recovery_budget_multiplier: primary
-            ? 1
-            : recoveryBudget.recovery_budget_multiplier,
-        continuations,
-        restore_with: primary
-            ? "Use recovery binding."
-            : `Retry with --output-budget ${recoveryBudget.output_budget} because no declared row collection can be continued.`,
-        recovery: primary
-            ? {
-                cursor: primary.cursor,
-                cli: "--output-cursor",
-                sdk: "outputCursor",
-                mcp: "outputCursor",
-            }
-            : {
-                cli: `--output-budget ${recoveryBudget.output_budget}`,
-                sdk: { outputBudget: recoveryBudget.output_budget },
-                mcp: { outputBudget: recoveryBudget.output_budget },
-            },
-    };
-}
-/** Rebase a producer cursor when budget compaction removes rows from its page. */
-function rebaseBudgetCompactedCursor(projected, originalItemCount, cursorSource, cursorContinuesExistingPage) {
-    if (typeof cursorSource !== "string" || !Array.isArray(projected.items)) {
-        return false;
-    }
-    const retainedCount = projected.items.length;
-    if (retainedCount === 0 || retainedCount >= originalItemCount) {
-        return false;
-    }
-    let cursor;
-    try {
-        cursor = decodeQueryCursorEnvelope(cursorSource);
-    }
-    catch {
-        return false;
-    }
-    const sourceIndex = cursor.after_index;
-    if (sourceIndex === undefined)
-        return false;
-    const last = projected.items.at(-1);
-    if (Object.prototype.toString.call(last) !== "[object Object]") {
-        return false;
-    }
-    const lastId = Reflect.get(last, "id");
-    if (typeof lastId !== "string" || lastId.length === 0)
-        return false;
-    const afterIndex = cursorContinuesExistingPage
-        ? sourceIndex - (originalItemCount - retainedCount)
-        : sourceIndex + retainedCount;
-    if (afterIndex < 0)
-        return false;
-    projected.next_cursor = encodeQueryCursor(cursor.fingerprint, lastId, afterIndex, cursor.snapshot);
-    if (typeof projected.applied_limit === "number") {
-        projected.applied_limit = retainedCount;
-    }
-    return true;
-}
-function captureReadOutputContinuationState(projected, command, cursor, options) {
-    const collectionsBeforeBudget = new Map(readOutputContinuationRowCollections(projected).map((collection) => {
-        const rows = Array.isArray(collection.value)
-            ? collection.value.length
-            : Object.keys(collection.value).length;
-        const continued = cursor?.path === collection.path;
-        return [
-            collection.path,
-            {
-                rows,
-                totalRows: continued ? cursor.total_rows : rows,
-                baseOffset: continued ? cursor.offset : 0,
-                fingerprint: continued
-                    ? cursor.fingerprint
-                    : readOutputCollectionFingerprint(collection.path, collection.value, command),
-            },
-        ];
-    }));
-    const cursorContinuesExistingPage = typeof projected.next_cursor === "string";
-    return {
-        collectionsBeforeBudget,
-        originalItemCount: Array.isArray(projected.items)
-            ? projected.items.length
-            : 0,
-        cursorContinuesExistingPage,
-        cursorSource: cursorContinuesExistingPage
-            ? projected.next_cursor
-            : options.after,
-    };
-}
-function compactReadOutputProjection(projected, resolved, receipt, bindingBudget, session, continuationState, measuredResultTokens) {
-    const assuranceMinimumRows = resolved.command === "assurance" && Array.isArray(projected.assertions)
-        ? projected.assertions.filter((row) => isRecord(row) && row.verdict !== "pass").length
-        : 0;
-    let compacted = compactReadOutputToBudget(projected, receipt, bindingBudget.tokens, assuranceMinimumRows > 0
-        ? new Map([["assertions", assuranceMinimumRows]])
-        : new Map());
-    const continuationCursorRebased = rebaseBudgetCompactedCursor(compacted, continuationState.originalItemCount, continuationState.cursorSource, continuationState.cursorContinuesExistingPage);
-    attachReadOutputTruncationDisclosure(compacted, resolved, receipt, bindingBudget, continuationCursorRebased, measuredResultTokens, continuationState.collectionsBeforeBudget);
-    if (session !== undefined) {
-        compacted = attachReadOutputSessionContracts(compacted, session, receipt);
-    }
-    return compacted;
-}
-/** Apply universal field, row, and token bounds and attach an exact receipt. */
-export function applyReadOutputDimensions(command, options, result) {
-    const resolved = resolveReadOutputDimensions(command, options);
-    if (!resolved)
-        return result;
-    const session = parseReadOutputSession(options.outputSession ?? options.output_session);
-    const rawCursor = options.outputCursor ?? options.output_cursor;
-    const cursor = typeof rawCursor === "string"
-        ? decodeReadOutputContinuationCursor(rawCursor)
-        : undefined;
-    const requested = requestedDimensions(resolved);
-    if (cursor === undefined &&
-        canReturnReadOutputUnchanged(resolved, session, result)) {
-        return result;
-    }
-    const continuationReadyResult = attachValidateDiagnosticRowContract(resolved.command, result);
-    const bindingBudget = resolveBindingReadOutputBudget(resolved, session);
-    let projected = projectReadOutputRows(continuationReadyResult, resolved, session, cursor);
-    const continuationState = captureReadOutputContinuationState(projected, resolved.command, cursor, options);
-    const receipt = {
-        contract_version: 1,
-        command: resolved.command,
-        requested_dimensions: requested,
-        ...(bindingBudget?.source === "default"
-            ? {
-                budget_source: bindingBudget.source,
-                budget_tokens: bindingBudget.tokens,
-            }
-            : {}),
-        precedence: resolved.precedence,
-        ...canonicalReadOutputReceiptFields(resolved),
-        legacy_aliases_used: resolved.legacy_aliases_used,
-        migration_hints: resolved.migration_hints,
-        estimated_tokens: 0,
-        within_budget: true,
-        strings_compacted: false,
-        rows_compacted: false,
-        result_omitted: false,
-    };
-    projected.read_output = receipt;
-    projected =
-        session === undefined
-            ? projected
-            : attachReadOutputSessionContracts(projected, session, receipt);
-    updateReadOutputReceiptEstimate(projected, receipt);
-    if (bindingBudget !== undefined &&
-        receipt.estimated_tokens > bindingBudget.tokens) {
-        const measuredResultTokens = receipt.estimated_tokens;
-        projected = compactReadOutputProjection(projected, resolved, receipt, bindingBudget, session, continuationState, measuredResultTokens);
-    }
-    if (bindingBudget !== undefined &&
-        receipt.estimated_tokens > bindingBudget.tokens) {
-        return omitReadOutputForBudget(resolved, requested, session, bindingBudget, receipt.estimated_tokens);
-    }
-    return projected;
-}
-/** Narrow a universal read result to its budget-omission branch. */
-export function isReadOutputBudgetExceeded(result) {
-    return (isRecord(result) &&
-        isRecord(result.output_budget_exceeded) &&
-        result.output_budget_exceeded.omitted_result === true &&
-        result.output_budget_exceeded.reason === "requested_budget_infeasible");
-}
-/** Resolve only the canonical renderer override for shared CLI output code. */
-export function resolveReadOutputEncoding(command, options) {
-    const encoding = resolveReadOutputDimensions(command, options)?.encoding;
-    return encoding?.value === "json" || encoding?.value === "toon"
-        ? encoding.value
-        : undefined;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="93f20465-cf27-56cd-8569-ac939d140dad")}catch(e2){}})();import{resolvePmHistoryOperation}from"./cli-contracts/command-aliases.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{compactReadOutputToBudget,estimateReadOutputTokens,resolveReadOutputRecoveryBudget,updateReadOutputReceiptEstimate}from"./read-output-budget.js";import{resolveReadOutputRecoveryBudget as resolveReadOutputRecoveryBudget2}from"./read-output-budget.js";import{resolvePmCommandOutputBudget}from"./cli-contracts/agent-output-contracts.js";import{boundReadOutputRows,countReadOutputRows,mapReadOutputRows,readOutputBudgetCollections,readOutputContinuationRowCollections,readOutputRowPaths}from"./read-output-rows.js";import{applyReadOutputContinuation,decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,prioritizeAssuranceAssertions,readOutputCollectionFingerprint}from"./read-output/continuation.js";import{decodeReadOutputContinuationCursor as decodeReadOutputContinuationCursor2,encodeReadOutputContinuationCursor as encodeReadOutputContinuationCursor2,PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES,readOutputCollectionFingerprint as readOutputCollectionFingerprint2}from"./read-output/continuation.js";import{applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens}from"./read-output-session.js";import{decodeQueryCursorEnvelope,encodeQueryCursor}from"./pagination.js";const PM_READ_OUTPUT_DIMENSIONS=["include","amount","cost","encoding"];const PM_READ_OUTPUT_SURFACES=["list","context","search","get","next","health","deps","graph","history","activity","validate","events","contracts","comments","notes","files","docs","stats","aggregate","duplicates","package-catalog","package-manage","comments-audit","assurance"];const READ_OUTPUT_PRECEDENCE=["canonical","legacy","intent","default"];const CANONICAL_OPTIONS={include:"--output-include",amount:"--output-limit",cost:"--output-budget",encoding:"--output-format"};const READ_OUTPUT_INVOCATION_PROVENANCE=Symbol.for("pm.readOutputInvocationProvenance");const PM_READ_OUTPUT_OPTION_FLAGS=Object.freeze(PM_READ_OUTPUT_DIMENSIONS.map(dimension=>CANONICAL_OPTIONS[dimension]));const PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS=Object.freeze(["--output-session","--output-cursor","--output-row-contract"]);const LEGACY_FLAGS_BY_COMMAND={list:{include:["--brief","--compact","--fields","--full"],amount:["--after","--limit","--no-truncate"],cost:["--token-budget"],encoding:["--format","--stream"]},context:{include:["--fields","--section"],amount:["--after","--depth","--limit"],cost:["--token-budget"],encoding:["--format"]},search:{include:["--compact","--fields","--full"],amount:["--after","--limit"],cost:["--token-budget"],encoding:["--format"]},get:{include:["--fields","--full"],amount:["--depth"],cost:["--token-budget"],encoding:["--format"]},next:{amount:["--blocked-limit","--limit"],cost:["--token-budget"],encoding:["--format"]},health:{include:["--brief","--check-only","--full","--summary"]},deps:{include:["--collapse","--full","--summary"],amount:["--edge-limit","--max-depth","--node-limit"],cost:["--token-budget"],encoding:["--format"]},graph:{include:["--full","--summary"],amount:["--after","--limit","--max-depth","--max-paths"]},history:{include:["--compact","--full"],amount:["--limit"],encoding:["--format"]},activity:{include:["--compact","--full"],amount:["--limit","--unbounded"],encoding:["--stream"]},validate:{include:["--counts","--full"]},events:{include:["--full"],amount:["--limit"],encoding:["--follow"]},contracts:{include:["--full","--summary"]},comments:{amount:["--limit"]},notes:{amount:["--limit"]},files:{amount:["--limit","--no-truncate","--offset"]},docs:{},stats:{},aggregate:{},duplicates:{amount:["--limit"]},"package-catalog":{},"package-manage":{},"comments-audit":{},assurance:{}};const VALUE_BEARING_INCLUDE_ALIASES=new Set(["--collapse","--fields","--section"]);const BEHAVIOR_PRESERVING_MIGRATION_HINTS=Object.freeze({"--after":"--after retains cursor-position semantics; use --output-limit <n> separately to bound returned rows.","--check-only":"--check-only retains health side-effect semantics; --output-include does not suppress vector refresh.","--collapse":"--collapse retains dependency grouping semantics; --output-include does not replace it.","--depth":"--depth retains traversal or detail-depth semantics; --output-limit does not replace it.","--follow":"--follow retains event-tail semantics; --output-format does not enable following.","--max-depth":"--max-depth retains graph traversal-depth semantics; --output-limit does not replace it.","--max-paths":"--max-paths retains graph path-search semantics; use --output-limit separately to bound returned rows.","--no-truncate":"--no-truncate is a compatibility alias; prefer --output-limit unbounded.","--offset":"--offset retains positional pagination semantics; use --output-limit separately to bound returned rows.","--stream":"--stream retains command streaming semantics; --output-format selects only static result encoding.","--unbounded":"--unbounded is a compatibility alias; prefer --output-limit unbounded."});function flagSelector(flag){return flag.slice(2).replaceAll("-","_")}function migrationHint(flag,dimension){const behaviorHint=BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag];if(behaviorHint!==void 0)return behaviorHint;const suffix=dimension==="include"?VALUE_BEARING_INCLUDE_ALIASES.has(flag)?"<csv>":flagSelector(flag):dimension==="amount"?"<n>":dimension==="cost"?"<tokens>":"<toon|json>";return`${flag} is a compatibility alias; prefer ${CANONICAL_OPTIONS[dimension]} ${suffix}.`}function buildSurfaceContract(command){const legacy=LEGACY_FLAGS_BY_COMMAND[command];const dimensions=Object.freeze(Object.fromEntries(PM_READ_OUTPUT_DIMENSIONS.map(dimension=>[dimension,Object.freeze({dimension,canonical_option:CANONICAL_OPTIONS[dimension],applicable:true,inapplicable_reason:null,legacy_aliases:Object.freeze((legacy[dimension]??[]).map(flag=>Object.freeze({flag,semantics:BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag]===void 0?"replacement":"behavior_preserving",migration_hint:migrationHint(flag,dimension),visibility:"hidden_alias"})))})])));return Object.freeze({command,dimensions,precedence:READ_OUTPUT_PRECEDENCE,budget_retention_policy:command==="assurance"?"verdict_priority":"ordered_prefix",projection_modes:Object.freeze([...readOutputIncludeModeOptions(command).keys()])})}const PM_READ_OUTPUT_SURFACE_CONTRACTS=Object.freeze(PM_READ_OUTPUT_SURFACES.map(buildSurfaceContract));const SURFACE_CONTRACT_BY_COMMAND=new Map(PM_READ_OUTPUT_SURFACE_CONTRACTS.map(contract=>[contract.command,contract]));function resolveReadOutputSurface(command,options={}){const normalizedCommand=resolvePmHistoryOperation(command.trim().toLowerCase());const packageMode=normalizedCommand==="package catalog"||normalizedCommand==="packages catalog"||normalizedCommand==="package-catalog"||(normalizedCommand==="package"||normalizedCommand==="packages"||normalizedCommand==="extension")&&(options.catalog===true||options.target==="catalog"||options.action==="catalog");const root=packageMode?"package-catalog":normalizedCommand==="package manage"||normalizedCommand==="package-manage"?"package-manage":normalizedCommand.split(" ")[0];const normalized=root.startsWith("list-")?"list":root==="ctx"?"context":root;return PM_READ_OUTPUT_SURFACES.includes(normalized)?normalized:void 0}const CANONICAL_OPTION_KEYS=["outputInclude","output_include","outputLimit","output_limit","outputBudget","output_budget","outputFormat","output_format","outputSession","output_session","outputCursor","output_cursor","outputRowContract","output_row_contract"];const HYBRID_READ_MUTATION_KEYS={comments:["add","body","stdin","file","edit","delete"],notes:["add","addJson","stdin","file","edit","delete"],files:["add","addGlob","remove","migrate","apply","note"],docs:["add","addGlob","remove","migrate","note"],"package-catalog":["activate","adopt","adoptAll","deactivate","doctor","init","install","manage","migrate","reload","scaffold","uninstall"]};function hasCanonicalReadOutputOptions(options){return CANONICAL_OPTION_KEYS.some(key=>options[key]!==void 0)}const READ_OUTPUT_VALUE_VALIDATORS=[{keys:["outputInclude","output_include"],valid:value=>stringList(value)!==void 0,message:"--output-include requires at least one comma-separated field or section."},{keys:["outputLimit","output_limit"],valid:value=>value==="unbounded"||positiveInteger(value)!==void 0,message:"--output-limit must be a positive integer or unbounded."},{keys:["outputBudget","output_budget"],valid:value=>value==="unbounded"||positiveInteger(value)!==void 0,message:"--output-budget must be a positive integer or unbounded."},{keys:["outputFormat","output_format"],valid:value=>value==="toon"||value==="json",message:"--output-format must be toon or json."},{keys:["outputSession","output_session"],valid:value=>{parseReadOutputSession(value);return true},message:"--output-session must be a valid session-state object."},{keys:["outputCursor","output_cursor"],valid:value=>typeof value==="string"&&value.trim().length>0,message:"--output-cursor requires a non-empty continuation cursor."}];function validateReadOutputOptions(command,options){if(!hasCanonicalReadOutputOptions(options))return;const normalizedCommand=resolveReadOutputSurface(command,options);if(!normalizedCommand){throw new PmCliError(`Universal output controls apply only to read commands; ${command||"this command"} is not a read surface.`,EXIT_CODE.USAGE)}if((HYBRID_READ_MUTATION_KEYS[normalizedCommand]??[]).some(key=>options[key]!==void 0&&options[key]!==false)){throw new PmCliError(`Universal output controls cannot be combined with a ${normalizedCommand} mutation.`,EXIT_CODE.USAGE)}for(const validator of READ_OUTPUT_VALUE_VALIDATORS){const value=validator.keys.map(key=>options[key]).find(entry=>entry!==void 0);if(value!==void 0&&!validator.valid(value)){throw new PmCliError(validator.message,EXIT_CODE.USAGE)}}}function readOutputIncludeModeOptions(command){const surface=resolveReadOutputSurface(command);if(!surface)return new Map;return new Map((LEGACY_FLAGS_BY_COMMAND[surface].include??[]).filter(flag=>!VALUE_BEARING_INCLUDE_ALIASES.has(flag)&&BEHAVIOR_PRESERVING_MIGRATION_HINTS[flag]===void 0).map(flag=>[flagSelector(flag),optionKey(flag)]))}function applyReadOutputIncludeModes(command,includeValue,commandOptions){const requested=stringList(includeValue)??[];const modeOptions=readOutputIncludeModeOptions(command);const selectors=[];const modes=[];const optionsWithProvenance=commandOptions;const existingProvenance=optionsWithProvenance[READ_OUTPUT_INVOCATION_PROVENANCE];const canonicalModes=new Set(existingProvenance?.canonical_include_modes??[]);const explicitLegacyAliases=new Set(existingProvenance?.explicit_legacy_aliases??[]);for(const token of requested){const option=modeOptions.get(token);if(option===void 0){selectors.push(token);continue}const legacyFlag=`--${token.replaceAll("_","-")}`;if(isRequestedOption(readOption(commandOptions,legacyFlag))){explicitLegacyAliases.add(legacyFlag)}commandOptions[option]=true;modes.push(token);canonicalModes.add(token)}const forwardedGetFieldSelectors=resolveReadOutputSurface(command)==="get"?selectors.filter(selector=>selector!=="item"):[];const forwardedGetFields=forwardedGetFieldSelectors.length>0;if(forwardedGetFields){commandOptions.fields=[...new Set([...stringList(commandOptions.fields)??[],...forwardedGetFieldSelectors])].join(",");canonicalModes.add("fields")}if(modes.length>0||forwardedGetFields){optionsWithProvenance[READ_OUTPUT_INVOCATION_PROVENANCE]={canonical_include_modes:[...canonicalModes],explicit_legacy_aliases:[...explicitLegacyAliases],...existingProvenance?.cli_invocation_observed===true?{cli_invocation_observed:true}:{}}}return{selectors,modes}}function normalizeReadOutputIncludeModeOptions(command,options){const include=options.outputInclude??options.output_include;if(include===void 0)return;const{selectors,modes}=applyReadOutputIncludeModes(command,include,options);if(modes.length===0)return;const residual=selectors.length>0?selectors.join(","):void 0;options.outputInclude=residual;if(Object.hasOwn(options,"output_include")){options.output_include=residual}}function optionKey(flag){return flag.slice(2).replace(/-([a-z])/gu,(_,character)=>character.toUpperCase())}function readOption(options,flag){const key=optionKey(flag);if(Object.hasOwn(options,key))return options[key];const snakeKey=flag.slice(2).replaceAll("-","_");if(Object.hasOwn(options,snakeKey))return options[snakeKey];if(flag==="--no-truncate"&&options.truncate===false)return true;return void 0}function isRequestedOption(value){return value!==void 0&&value!==false&&value!==null}function stringList(value){const values=Array.isArray(value)?value:[value];const normalized=values.flatMap(entry=>typeof entry==="string"?entry.split(","):[]).map(entry=>entry.trim()).filter(Boolean);return normalized.length>0?[...new Set(normalized)]:void 0}function positiveInteger(value){const parsed=typeof value==="number"?value:typeof value==="string"&&/^\d+$/u.test(value.trim())?Number(value):Number.NaN;return Number.isSafeInteger(parsed)&&parsed>0?parsed:void 0}function resolveLegacyDimension(contract,options,usable,ignore){for(const alias of contract.legacy_aliases){if(ignore(alias.flag))continue;const value=readOption(options,alias.flag);const candidate={value,flag:alias.flag};if(isRequestedOption(value)&&usable(candidate))return candidate}return void 0}function resolveIncludeValue(canonical,legacy){const canonicalList=stringList(canonical);if(canonicalList)return{source:"canonical",value:canonicalList};if(!legacy)return void 0;return{source:"legacy",value:stringList(legacy.value)??[flagSelector(legacy.flag)]}}function resolveAmountValue(canonical,legacy){if(canonical==="unbounded"){return{source:"canonical",value:"unbounded"}}const canonicalLimit=positiveInteger(canonical);if(canonicalLimit!==void 0){return{source:"canonical",value:canonicalLimit}}if(!legacy)return void 0;if(legacy.flag==="--no-truncate"||legacy.flag==="--unbounded"){return{source:"legacy",value:"unbounded"}}const legacyLimit=positiveInteger(legacy.value);return legacyLimit===void 0?void 0:{source:"legacy",value:legacyLimit}}function resolveCostValue(canonical,legacy){if(canonical==="unbounded"){return{source:"canonical",value:"unbounded"}}const canonicalBudget=positiveInteger(canonical);if(canonicalBudget!==void 0){return{source:"canonical",value:canonicalBudget}}if(!legacy)return void 0;const legacyBudget=positiveInteger(legacy.value);return legacyBudget===void 0?void 0:{source:"legacy",value:legacyBudget}}function resolveEncodingValue(canonical,legacy){if(canonical==="json"||canonical==="toon"){return{source:"canonical",value:canonical}}if(!legacy)return void 0;if(legacy.flag==="--stream"||legacy.flag==="--follow"){return{source:"legacy",value:"stream"}}return legacy.value==="json"||legacy.value==="toon"?{source:"legacy",value:legacy.value}:void 0}function shouldIgnoreReadOutputLegacyAlias(provenance,dimension,flag){if(!provenance)return false;const explicitLegacyAliases=new Set(provenance.explicit_legacy_aliases);if(provenance.cli_invocation_observed===true){return!explicitLegacyAliases.has(flag)}const forwardedIncludeAliases=new Set(provenance.canonical_include_modes.map(mode=>`--${mode.replaceAll("_","-")}`));return dimension==="include"&&forwardedIncludeAliases.has(flag)&&!explicitLegacyAliases.has(flag)}function hasCompleteReadOutputIntent(command,legacyByDimension,provenance){const root=command.trim().toLowerCase().replaceAll(/\s+/gu," ").split(" ")[0];return root==="list-all"||legacyByDimension.amount?.flag==="--no-truncate"||legacyByDimension.include?.flag==="--full"||provenance?.canonical_include_modes.includes("full")===true}function canonicalReadOutputOptionsUsed(resolvedByDimension,provenance){return PM_READ_OUTPUT_DIMENSIONS.flatMap(dimension=>resolvedByDimension[dimension]?.source==="canonical"||dimension==="include"&&(provenance?.canonical_include_modes.length??0)>0?[CANONICAL_OPTIONS[dimension]]:[])}function resolveReadOutputDimensions(command,options){const normalizedCommand=resolveReadOutputSurface(command,options);if(!normalizedCommand)return void 0;const contract=SURFACE_CONTRACT_BY_COMMAND.get(normalizedCommand);const invocationProvenance=options[READ_OUTPUT_INVOCATION_PROVENANCE];const legacyResolvers={include:candidate=>resolveIncludeValue(void 0,candidate),amount:candidate=>resolveAmountValue(void 0,candidate),cost:candidate=>resolveCostValue(void 0,candidate),encoding:candidate=>resolveEncodingValue(void 0,candidate)};const legacyByDimension=Object.fromEntries(PM_READ_OUTPUT_DIMENSIONS.map(dimension=>[dimension,resolveLegacyDimension(contract.dimensions[dimension],options,candidate=>legacyResolvers[dimension](candidate)!==void 0,flag=>shouldIgnoreReadOutputLegacyAlias(invocationProvenance,dimension,flag))]));const legacyAliasesUsed=PM_READ_OUTPUT_DIMENSIONS.flatMap(dimension=>{const resolved=legacyByDimension[dimension];return resolved?[resolved.flag]:[]});const migrationHints=PM_READ_OUTPUT_DIMENSIONS.flatMap(dimension=>{const resolved=legacyByDimension[dimension];if(!resolved)return[];const alias=contract.dimensions[dimension].legacy_aliases.find(entry=>entry.flag===resolved.flag);return[alias.migration_hint]});const encoding=resolveEncodingValue(options.outputFormat??options.output_format,legacyByDimension.encoding);const include=resolveIncludeValue(options.outputInclude??options.output_include,legacyByDimension.include);const amount=resolveAmountValue(options.outputLimit??options.output_limit,legacyByDimension.amount);const explicitCost=resolveCostValue(options.outputBudget??options.output_budget,legacyByDimension.cost);const completeResultIntent=hasCompleteReadOutputIntent(command,legacyByDimension,invocationProvenance);const budget=resolvePmCommandOutputBudget(command,{generateFallback:true});const resolvedOutputFormat=encoding?.value==="json"||options.resolvedOutputFormat==="json"?"json":"toon";const cost=explicitCost??(completeResultIntent?{source:"intent",value:"unbounded"}:{source:"default",value:budget.default_max_estimated_tokens_by_format[resolvedOutputFormat]});const resolvedByDimension={include,amount,cost,encoding};return{command:normalizedCommand,include,amount,cost,encoding,canonical_options_used:canonicalReadOutputOptionsUsed(resolvedByDimension,invocationProvenance),legacy_aliases_used:legacyAliasesUsed,migration_hints:migrationHints,precedence:READ_OUTPUT_PRECEDENCE}}function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}const ENVELOPE_KEYS=new Set(["applied_bound","applied_limit","completeness","continuation_kind","continuation_path","continuation_contract","count","filters","has_more","next_cursor","now","omission_receipt","projection","budget_retention_policy","row_contract","sorting","total","truncated"]);const GET_STABLE_DERIVED_ITEM_SELECTORS=["collection_counts","notes_count","tests_count"];function projectRecordFields(value,selectors){const selected=new Set(selectors.map(selector=>selector.split(".")[0]));return Object.fromEntries(Object.entries(value).filter(([key])=>selected.has(key)))}function getProjectionVocabulary(result){const item=isRecord(result.item)?result.item:{};const itemFields=[...new Set([...Object.keys(item),...GET_STABLE_DERIVED_ITEM_SELECTORS.filter(key=>Object.hasOwn(item,key))])].sort((left,right)=>left.localeCompare(right));const sections=Object.keys(result).filter(key=>key!=="item"&&key!=="read_output"&&!ENVELOPE_KEYS.has(key)).sort((left,right)=>left.localeCompare(right));return{item,itemFields,sections,valid:[...itemFields,"item",...itemFields.map(field=>`item.${field}`),...sections]}}function applyGetIncludeProjection(result,selectors){const vocabulary=getProjectionVocabulary(result);const unknown=selectors.filter(selector=>!vocabulary.valid.includes(selector));if(unknown.length>0){throw new PmCliError(`Unknown --output-include selector(s) for get: ${unknown.join(", ")}. Valid selectors: ${vocabulary.valid.join(", ")}.`,EXIT_CODE.USAGE)}const fullItem=selectors.includes("item");const itemSelectors=selectors.flatMap(selector=>selector.startsWith("item.")?[selector.slice("item.".length)]:vocabulary.itemFields.includes(selector)?[selector]:[]).filter((selector,index,values)=>values.indexOf(selector)===index);if(fullItem&&itemSelectors.length>0){throw new PmCliError("--output-include cannot mix a full item with projected item fields; use item or item.<field>, not both.",EXIT_CODE.USAGE)}const selectedSections=new Set(selectors.filter(selector=>vocabulary.sections.includes(selector)));const projected=Object.fromEntries(Object.entries(result).filter(([key])=>ENVELOPE_KEYS.has(key)||selectedSections.has(key)));if(fullItem){projected.item=vocabulary.item}else if(itemSelectors.length>0){projected.item=projectRecordFields(vocabulary.item,itemSelectors)}const omittedFieldGroups=[...fullItem?[]:itemSelectors.length>0?vocabulary.itemFields.filter(field=>!itemSelectors.includes(field)).map(field=>({name:`item.${field}`,restore_with:`--output-include item.${field}`})):[{name:"item",restore_with:"--output-include item"}],...vocabulary.sections.filter(section=>!selectedSections.has(section)).map(section=>({name:section,restore_with:`--output-include ${section}`}))];const inheritedOmittedFieldGroups=isRecord(projected.omission_receipt)&&Array.isArray(projected.omission_receipt.omitted_field_groups)?projected.omission_receipt.omitted_field_groups:[];const combinedOmittedFieldGroups=[...inheritedOmittedFieldGroups,...omittedFieldGroups];projected.omission_receipt={has_omissions:combinedOmittedFieldGroups.length>0,omitted_field_group_count:combinedOmittedFieldGroups.length,omitted_field_groups:combinedOmittedFieldGroups};return projected}function countPopulatedRows(result){let populated=0;mapReadOutputRows({...result},entry=>{if(isRecord(entry)&&Object.keys(entry).length>0)populated+=1;return entry});return populated}function rejectEmptyIncludeProjection(command,original,shaped,selectors){if(countPopulatedRows(original)===0||countPopulatedRows(shaped)>0){return}const modes=[...readOutputIncludeModeOptions(command).keys()];const domain=modes.length>0?` Declared ${command} projection modes: ${modes.join(", ")}.`:` The ${command} surface declares no projection modes; name row fields instead.`;throw new PmCliError(`Unknown --output-include selector(s) for ${command}: ${selectors.join(", ")}. No selector matched any returned row field.${domain}`,EXIT_CODE.USAGE)}function applyIncludeProjection(command,result,selectors){if(command==="get"){return applyGetIncludeProjection(result,selectors)}const rows=readOutputRowPaths(result);const qualifiedRowSelectors=selectors.flatMap(selector=>rows.flatMap(rowPath=>selector.startsWith(`${rowPath}.`)?[selector.slice(rowPath.length+1)]:[]));const selectedRoot=selectors.some(selector=>Object.hasOwn(result,selector.split(".")[0])&&!rows.some(rowPath=>selector.startsWith(`${rowPath}.`)));if(rows.length>0&&(!selectedRoot||qualifiedRowSelectors.length>0)){const projected={...result};const rowSelectors=qualifiedRowSelectors.length>0?qualifiedRowSelectors:selectors;const shaped=mapReadOutputRows(projected,entry=>isRecord(entry)?projectRecordFields(entry,rowSelectors):entry);rejectEmptyIncludeProjection(command,result,shaped,rowSelectors);return shaped}return Object.fromEntries(Object.entries(result).filter(([key])=>selectors.some(selector=>selector.split(".")[0]===key)||ENVELOPE_KEYS.has(key)))}function applyAmountBound(result,amount){if(amount==="unbounded")return result;const{result:bounded,truncated}=boundReadOutputRows(result,amount);if(!truncated)return bounded;bounded.has_more=true;bounded.truncated=true;if(typeof bounded.count==="number"){bounded.count=countReadOutputRows(bounded)}bounded.applied_bound={kind:"output_limit",source:"explicit",value:amount};return bounded}function requestedDimensions(resolved){return PM_READ_OUTPUT_DIMENSIONS.filter(dimension=>resolved[dimension]!==void 0&&resolved[dimension]?.source!=="default"||resolved.canonical_options_used.includes(CANONICAL_OPTIONS[dimension]))}function attachReadOutputSessionContracts(result,state,receipt){let withSession=attachReadOutputSessionReceipt(result,state);for(let iteration=0;iteration<8;iteration+=1){const previousReadEstimate=receipt.estimated_tokens;const previousSessionEstimate=withSession.read_session.spent_this_call_tokens;updateReadOutputReceiptEstimate(withSession,receipt);withSession=attachReadOutputSessionReceipt(withSession,state);const sessionEstimate=withSession.read_session.spent_this_call_tokens;if(receipt.estimated_tokens===previousReadEstimate&&sessionEstimate===previousSessionEstimate){return withSession}}return withSession}function stabilizeReadOutputReceiptEstimates(result,options){if(!isRecord(result.read_output))return result;const receipt=result.read_output;const session=parseReadOutputSession(options.outputSession??options.output_session);if(session===void 0){updateReadOutputReceiptEstimate(result,receipt);return result}return attachReadOutputSessionContracts(result,session,receipt)}function attachValidateDiagnosticRowContract(command,result){if(command!=="validate")return result;const projection=isRecord(result.projection)?result.projection:void 0;const declaredFieldGroups=Array.isArray(projection?.declared_field_groups)?projection.declared_field_groups:[];if(!declaredFieldGroups.some(group=>isRecord(group)&&group.name==="diagnostic_rows")){return result}const diagnosticCollectionPaths=[...new Set(readOutputBudgetCollections(result).map(({path})=>path).filter(path=>/^checks\.\d+\.details\./u.test(path)))];const diagnosticRowKeys=diagnosticCollectionPaths.filter(path=>!diagnosticCollectionPaths.some(candidate=>candidate!==path&&path.startsWith(`${candidate}.`)));if(diagnosticRowKeys.length===0)return result;const existingContract=isRecord(result.row_contract)?result.row_contract:{};const existingRowKeys=Array.isArray(existingContract.row_keys)?existingContract.row_keys.filter(entry=>typeof entry==="string"):[];const existingContinuationRowKeys=Array.isArray(existingContract.continuation_row_keys)?existingContract.continuation_row_keys.filter(entry=>typeof entry==="string"):[];const rowKeys=existingRowKeys.length>0?existingRowKeys:diagnosticRowKeys;const continuationRowKeys=[...new Set(diagnosticRowKeys)];return JSON.stringify(rowKeys)===JSON.stringify(existingRowKeys)&&JSON.stringify(continuationRowKeys)===JSON.stringify(existingContinuationRowKeys)?result:{...result,row_contract:{...existingContract,row_keys:rowKeys,continuation_row_keys:continuationRowKeys,jq_selector:typeof existingContract.jq_selector==="string"?existingContract.jq_selector:".checks[].details"}}}function projectReadOutputRows(result,resolved,session,cursor){let projected={...result};if(resolved.include?.source==="canonical"){projected=applyIncludeProjection(resolved.command,projected,resolved.include.value)}if(resolved.command==="assurance"){projected=prioritizeAssuranceAssertions(projected)}projected=applyReadOutputContinuation(projected,resolved.command,cursor);if(resolved.amount?.source==="canonical"){projected=applyAmountBound(projected,resolved.amount.value)}return session===void 0?projected:applyReadOutputSessionReferences(projected,session)}function resolveBindingReadOutputBudget(resolved,session){const budgets=[...resolved.cost!==void 0&&resolved.cost.value!=="unbounded"&&(resolved.cost.source==="canonical"||resolved.cost.source==="default")?[{source:resolved.cost.source,tokens:resolved.cost.value}]:[],...session===void 0?[]:[{source:"session",tokens:readOutputSessionRemainingTokens(session)}]];return budgets.sort((left,right)=>left.tokens-right.tokens)[0]}function canonicalReadOutputReceiptFields(resolved){const canonicalOptions=resolved.canonical_options_used;return canonicalOptions&&canonicalOptions.length>0?{canonical_options_used:canonicalOptions}:{}}function omitReadOutputForBudget(resolved,requested,session,bindingBudget,omittedResultEstimatedTokens){const minimalReceipt={contract_version:1,command:resolved.command,requested_dimensions:requested,...bindingBudget.source==="default"?{budget_source:bindingBudget.source,budget_tokens:bindingBudget.tokens}:{},precedence:resolved.precedence,...canonicalReadOutputReceiptFields(resolved),legacy_aliases_used:[],migration_hints:[],estimated_tokens:0,within_budget:false,strings_compacted:false,rows_compacted:false,result_omitted:true,...session===void 0?{omitted_result_estimated_tokens:omittedResultEstimatedTokens}:{}};const omitted={output_budget_exceeded:{omitted_result:true,reason:"requested_budget_infeasible",restore_with:"Unbounded",recovery:{outputBudget:"unbounded"}},read_output:minimalReceipt};const boundedOmission=session===void 0?omitted:attachReadOutputSessionContracts(omitted,session,minimalReceipt);if(session===void 0){updateReadOutputReceiptEstimate(boundedOmission,minimalReceipt)}if(session!==void 0&&minimalReceipt.estimated_tokens>bindingBudget.tokens){throw new PmCliError("The remaining output-session budget cannot fit its mandatory receipts; start a new session with a larger token_budget.",EXIT_CODE.USAGE)}return boundedOmission}function canReturnReadOutputUnchanged(resolved,session,result){if(session!==void 0)return false;const canonicalRequestedCount=resolved.canonical_options_used.length;if(resolved.cost?.value==="unbounded"){return canonicalRequestedCount===(resolved.cost.source==="canonical"?1:0)}if(resolved.cost?.source==="legacy"&&canonicalRequestedCount===0){return true}return canonicalRequestedCount===0&&(resolved.cost===void 0||estimateReadOutputTokens(result)<=resolved.cost.value)}function attachReadOutputTruncationDisclosure(projected,resolved,receipt,bindingBudget,continuationCursorRebased,measuredResultTokens,collectionsBeforeBudget){if(!receipt.rows_compacted)return;const overridden=resolved.amount?.value==="unbounded"?["amount"]:[];const afterByPath=new Map(readOutputContinuationRowCollections(projected).map(collection=>[collection.path,Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length]));const continuations=[...collectionsBeforeBudget.entries()].flatMap(([path,before])=>{const retainedRows=afterByPath.get(path);if(retainedRows>=before.rows)return[];const offset=before.baseOffset+retainedRows;return[{path,cursor:encodeReadOutputContinuationCursor({command:resolved.command,path,offset,total_rows:before.totalRows,fingerprint:before.fingerprint}),retained_rows:retainedRows,remaining_rows:before.totalRows-offset,total_rows:before.totalRows}]});const primary=continuations[0];const recoveryBudget=resolveReadOutputRecoveryBudget({effective_budget_tokens:bindingBudget.tokens,measured_result_tokens:measuredResultTokens});if(primary&&typeof projected.next_cursor!=="string"){projected.next_cursor=primary.cursor}projected.continuation_kind=continuationCursorRebased?"producer_cursor":primary?"output_cursor":"none";projected.output_budget_truncation={reason:"output_budget_reached",budget_source:bindingBudget.source,budget_tokens:bindingBudget.tokens,overridden_dimensions:overridden,compacted_row_paths:receipt.compacted_row_paths,continuation_cursor_rebased:continuationCursorRebased,continuation_available:continuations.length>0,recovery_budget_multiplier:primary?1:recoveryBudget.recovery_budget_multiplier,continuations,restore_with:primary?"Use recovery binding.":`Retry with --output-budget ${recoveryBudget.output_budget} because no declared row collection can be continued.`,recovery:primary?{cursor:primary.cursor,cli:"--output-cursor",sdk:"outputCursor",mcp:"outputCursor"}:{cli:`--output-budget ${recoveryBudget.output_budget}`,sdk:{outputBudget:recoveryBudget.output_budget},mcp:{outputBudget:recoveryBudget.output_budget}}}}function rebaseBudgetCompactedCursor(projected,originalItemCount,cursorSource,cursorContinuesExistingPage){if(typeof cursorSource!=="string"||!Array.isArray(projected.items)){return false}const retainedCount=projected.items.length;if(retainedCount===0||retainedCount>=originalItemCount){return false}let cursor;try{cursor=decodeQueryCursorEnvelope(cursorSource)}catch{return false}const sourceIndex=cursor.after_index;if(sourceIndex===void 0)return false;const last=projected.items.at(-1);if(Object.prototype.toString.call(last)!=="[object Object]"){return false}const lastId=Reflect.get(last,"id");if(typeof lastId!=="string"||lastId.length===0)return false;const afterIndex=cursorContinuesExistingPage?sourceIndex-(originalItemCount-retainedCount):sourceIndex+retainedCount;if(afterIndex<0)return false;projected.next_cursor=encodeQueryCursor(cursor.fingerprint,lastId,afterIndex,cursor.snapshot);if(typeof projected.applied_limit==="number"){projected.applied_limit=retainedCount}return true}function captureReadOutputContinuationState(projected,command,cursor,options){const collectionsBeforeBudget=new Map(readOutputContinuationRowCollections(projected).map(collection=>{const rows=Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length;const continued=cursor?.path===collection.path;return[collection.path,{rows,totalRows:continued?cursor.total_rows:rows,baseOffset:continued?cursor.offset:0,fingerprint:continued?cursor.fingerprint:readOutputCollectionFingerprint(collection.path,collection.value,command)}]}));const cursorContinuesExistingPage=typeof projected.next_cursor==="string";return{collectionsBeforeBudget,originalItemCount:Array.isArray(projected.items)?projected.items.length:0,cursorContinuesExistingPage,cursorSource:cursorContinuesExistingPage?projected.next_cursor:options.after}}function compactReadOutputProjection(projected,resolved,receipt,bindingBudget,session,continuationState,measuredResultTokens){const assuranceMinimumRows=resolved.command==="assurance"&&Array.isArray(projected.assertions)?projected.assertions.filter(row=>isRecord(row)&&row.verdict!=="pass").length:0;let compacted=compactReadOutputToBudget(projected,receipt,bindingBudget.tokens,assuranceMinimumRows>0?new Map([["assertions",assuranceMinimumRows]]):new Map);const continuationCursorRebased=rebaseBudgetCompactedCursor(compacted,continuationState.originalItemCount,continuationState.cursorSource,continuationState.cursorContinuesExistingPage);attachReadOutputTruncationDisclosure(compacted,resolved,receipt,bindingBudget,continuationCursorRebased,measuredResultTokens,continuationState.collectionsBeforeBudget);if(session!==void 0){compacted=attachReadOutputSessionContracts(compacted,session,receipt)}return compacted}function applyReadOutputDimensions(command,options,result){const resolved=resolveReadOutputDimensions(command,options);if(!resolved)return result;const session=parseReadOutputSession(options.outputSession??options.output_session);const rawCursor=options.outputCursor??options.output_cursor;const cursor=typeof rawCursor==="string"?decodeReadOutputContinuationCursor(rawCursor):void 0;const requested=requestedDimensions(resolved);if(cursor===void 0&&canReturnReadOutputUnchanged(resolved,session,result)){return result}const continuationReadyResult=attachValidateDiagnosticRowContract(resolved.command,result);const bindingBudget=resolveBindingReadOutputBudget(resolved,session);let projected=projectReadOutputRows(continuationReadyResult,resolved,session,cursor);const continuationState=captureReadOutputContinuationState(projected,resolved.command,cursor,options);const receipt={contract_version:1,command:resolved.command,requested_dimensions:requested,...bindingBudget?.source==="default"?{budget_source:bindingBudget.source,budget_tokens:bindingBudget.tokens}:{},precedence:resolved.precedence,...canonicalReadOutputReceiptFields(resolved),legacy_aliases_used:resolved.legacy_aliases_used,migration_hints:resolved.migration_hints,estimated_tokens:0,within_budget:true,strings_compacted:false,rows_compacted:false,result_omitted:false};projected.read_output=receipt;projected=session===void 0?projected:attachReadOutputSessionContracts(projected,session,receipt);updateReadOutputReceiptEstimate(projected,receipt);if(bindingBudget!==void 0&&receipt.estimated_tokens>bindingBudget.tokens){const measuredResultTokens=receipt.estimated_tokens;projected=compactReadOutputProjection(projected,resolved,receipt,bindingBudget,session,continuationState,measuredResultTokens)}if(bindingBudget!==void 0&&receipt.estimated_tokens>bindingBudget.tokens){return omitReadOutputForBudget(resolved,requested,session,bindingBudget,receipt.estimated_tokens)}return projected}function isReadOutputBudgetExceeded(result){return isRecord(result)&&isRecord(result.output_budget_exceeded)&&result.output_budget_exceeded.omitted_result===true&&result.output_budget_exceeded.reason==="requested_budget_infeasible"}function resolveReadOutputEncoding(command,options){const encoding=resolveReadOutputDimensions(command,options)?.encoding;return encoding?.value==="json"||encoding?.value==="toon"?encoding.value:void 0}export{PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES,PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_SURFACES,PM_READ_OUTPUT_SURFACE_CONTRACTS,applyReadOutputDimensions,applyReadOutputIncludeModes,decodeReadOutputContinuationCursor2 as decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor2 as encodeReadOutputContinuationCursor,isReadOutputBudgetExceeded,normalizeReadOutputIncludeModeOptions,readOutputCollectionFingerprint2 as readOutputCollectionFingerprint,readOutputIncludeModeOptions,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputRecoveryBudget2 as resolveReadOutputRecoveryBudget,resolveReadOutputSurface,stabilizeReadOutputReceiptEstimates,validateReadOutputOptions};
 //# sourceMappingURL=read-output-contracts.js.map
-//# debugId=2103a4dc-3037-5768-b2c7-5964de4ac86b