@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/context-intent-contracts.js

@@ -1,710 +1,2 @@
-/**
- * @module sdk/context-intent-contracts
- *
- * Declares composable, intent-scoped read projections for core commands,
- * workspace configuration, and packages.
- */
-
-!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]="d6fc4c70-c955-5fb5-ab4b-5dfa1200d58d")}catch(e){}}();
-import { AsyncLocalStorage } from "node:async_hooks";
-import { renderPmCommand } from "./command-line.js";
-import { attachOutputOmissionReceipt } from "./output-projection.js";
-import { encodeQueryCursor } from "./pagination.js";
-import { applyReadOutputDimensions, stabilizeReadOutputReceiptEstimates, } from "./read-output-contracts.js";
-import { propagateContextUsageServingReceipt } from "./context-usage.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-/** Built-in intent projections shared by CLI, SDK, MCP, and package authors. */
-export const PM_CONTEXT_INTENT_CONTRACTS = Object.freeze([
-    {
-        command: "context",
-        intent: "orient",
-        description: "Bounded active hierarchy, ownership, blockers, and recent progress.",
-        included_field_groups: [
-            "summary",
-            "focus",
-            "hierarchy",
-            "blockers",
-            "activity",
-        ],
-        token_budget: 3000,
-        source: "core",
-    },
-    {
-        command: "context",
-        intent: "handoff",
-        description: "Active ownership, evidence, decisions, and immediate continuation context.",
-        included_field_groups: [
-            "summary",
-            "focus",
-            "in_progress",
-            "decisions",
-            "activity",
-        ],
-        token_budget: 2200,
-        source: "core",
-    },
-    {
-        command: "get",
-        intent: "inspect",
-        description: "Standard-depth item metadata, relationships, evidence, and lifecycle state.",
-        included_field_groups: ["item", "children", "claim_state", "linked"],
-        token_budget: 3200,
-        source: "core",
-    },
-    {
-        command: "list",
-        intent: "triage",
-        description: "A budget-derived page of compact governance, ownership, priority, and blocker rows for triage.",
-        included_field_groups: [
-            "identity",
-            "governance",
-            "ownership",
-            "dependencies",
-        ],
-        token_budget: 3200,
-        source: "core",
-    },
-    {
-        command: "next",
-        intent: "execute",
-        description: "The highest-ranked actionable work with concise ranking evidence.",
-        included_field_groups: ["recommended"],
-        token_budget: 1200,
-        source: "core",
-    },
-    {
-        command: "search",
-        intent: "discover",
-        description: "A budget-derived page of ranked canonical lineage candidates with compact match evidence.",
-        included_field_groups: ["identity", "status", "lineage", "match"],
-        token_budget: 1800,
-        source: "core",
-    },
-]);
-const activeContextIntentContracts = new AsyncLocalStorage();
-/** Return the request-scoped intent registry, or the immutable built-in registry outside a configured scope. */
-export function getActiveContextIntentContracts() {
-    return activeContextIntentContracts.getStore() ?? PM_CONTEXT_INTENT_CONTRACTS;
-}
-/** Execute asynchronous work with isolated workspace and package intent declarations. */
-export function runWithContextIntentContracts(layers, run) {
-    return activeContextIntentContracts.run(composeContextIntentContracts(layers.workspaceContracts, layers.packageContracts), run);
-}
-function normalizeContextIntentDeclaration(declaration, source) {
-    const command = declaration.command.trim().toLowerCase();
-    const intent = declaration.intent.trim().toLowerCase();
-    const key = `${command}:${intent}`;
-    if (!/^[a-z0-9][a-z0-9-]*$/.test(command) ||
-        !/^[a-z0-9][a-z0-9-]*$/.test(intent)) {
-        throw new TypeError(`Invalid context intent command or name: ${key}`);
-    }
-    if (declaration.description.trim().length === 0) {
-        throw new TypeError(`Context intent ${key} requires a non-empty description`);
-    }
-    if (!Number.isSafeInteger(declaration.token_budget) ||
-        declaration.token_budget <= 0) {
-        throw new TypeError(`Context intent ${key} requires a positive integer token_budget`);
-    }
-    const includedFieldGroups = [
-        ...new Set(declaration.included_field_groups
-            .map((field) => field.trim())
-            .filter(Boolean)),
-    ];
-    if (includedFieldGroups.length === 0) {
-        throw new TypeError(`Context intent ${key} requires included_field_groups`);
-    }
-    return {
-        command,
-        intent,
-        description: declaration.description.trim(),
-        included_field_groups: includedFieldGroups,
-        token_budget: declaration.token_budget,
-        source,
-    };
-}
-/** Validate and compose core, package, and workspace intent declarations. Later layers override earlier layers by command and intent. */
-export function composeContextIntentContracts(workspaceContracts = [], packageContracts = []) {
-    const layers = [
-        {
-            source: "core",
-            contracts: PM_CONTEXT_INTENT_CONTRACTS,
-            allowOverride: false,
-        },
-        { source: "package", contracts: packageContracts, allowOverride: false },
-        { source: "workspace", contracts: workspaceContracts, allowOverride: true },
-    ];
-    const composed = new Map();
-    const keysSeenWithinLayer = new Set();
-    for (const layer of layers) {
-        keysSeenWithinLayer.clear();
-        for (const declaration of layer.contracts) {
-            const normalized = normalizeContextIntentDeclaration(declaration, layer.source);
-            const key = `${normalized.command}:${normalized.intent}`;
-            if (keysSeenWithinLayer.has(key)) {
-                throw new TypeError(`Duplicate context intent declaration: ${key}`);
-            }
-            keysSeenWithinLayer.add(key);
-            if (!layer.allowOverride && composed.has(key)) {
-                throw new TypeError(`Duplicate context intent declaration: ${key}`);
-            }
-            composed.set(key, normalized);
-        }
-    }
-    return [...composed.values()].sort((left, right) => left.command.localeCompare(right.command) ||
-        left.intent.localeCompare(right.intent));
-}
-/** Resolve one intent declaration or fail with the nearest command-local intent. */
-export function resolveContextIntentContract(command, intent, contracts = getActiveContextIntentContracts(), positionalArguments = []) {
-    const normalizedCommand = command.trim().toLowerCase();
-    const normalizedIntent = intent.trim().toLowerCase();
-    const exact = contracts.find((entry) => entry.command === normalizedCommand && entry.intent === normalizedIntent);
-    if (exact)
-        return { ...exact, source: exact.source ?? "core" };
-    const candidates = contracts
-        .filter((entry) => entry.command === normalizedCommand)
-        .map((entry) => entry.intent);
-    if (candidates.length === 0)
-        return undefined;
-    const suggestion = candidates
-        .map((candidate) => {
-        const rows = Array.from({ length: normalizedIntent.length + 1 }, (_, index) => index);
-        for (let candidateIndex = 1; candidateIndex <= candidate.length; candidateIndex += 1) {
-            let previous = rows[0];
-            rows[0] = candidateIndex;
-            for (let intentIndex = 1; intentIndex <= normalizedIntent.length; intentIndex += 1) {
-                const prior = rows[intentIndex];
-                rows[intentIndex] = Math.min(rows[intentIndex] + 1, rows[intentIndex - 1] + 1, previous +
-                    (candidate[candidateIndex - 1] ===
-                        normalizedIntent[intentIndex - 1]
-                        ? 0
-                        : 1));
-                previous = prior;
-            }
-        }
-        return { candidate, distance: rows[normalizedIntent.length] };
-    })
-        .sort((left, right) => left.distance - right.distance ||
-        left.candidate.localeCompare(right.candidate))[0].candidate;
-    const attemptedArguments = [
-        normalizedCommand,
-        ...positionalArguments,
-        "--for",
-        normalizedIntent,
-    ];
-    const suggestedRetryArguments = [
-        normalizedCommand,
-        ...positionalArguments,
-        "--for",
-        suggestion,
-    ];
-    const suggestedCommand = renderPmCommand(suggestedRetryArguments);
-    throw new PmCliError(`Unknown context intent "${normalizedIntent}" for ${normalizedCommand}. Did you mean "${suggestion}"?`, EXIT_CODE.USAGE, {
-        code: "unknown_context_intent",
-        reason: "unknown_intent",
-        field: "for",
-        flag: "--for",
-        value: normalizedIntent,
-        required: `Use a declared ${normalizedCommand} intent.`,
-        why: "Intent names are command-local contracts and cannot be inferred from output section names.",
-        nextSteps: [suggestedCommand],
-        recovery: {
-            recovery_mode: "compact",
-            attempted_command: renderPmCommand(attemptedArguments),
-            allowed_values: [...candidates].sort(),
-            suggested_retry: suggestedCommand,
-            suggested_retry_args: suggestedRetryArguments,
-        },
-    });
-}
-const CONTEXT_INTENT_DEFAULT_APPLIERS = {
-    context: (projected, contract, explicitTokenBudget) => {
-        if (projected.depth === undefined) {
-            projected.depth = contract.intent === "handoff" ? "deep" : "standard";
-        }
-        if (projected.section === undefined) {
-            projected.section =
-                contract.intent === "handoff"
-                    ? ["activity", "progress", "blockers"]
-                    : ["hierarchy", "blockers", "activity"];
-        }
-        const tokenBudget = resolveIntentTokenBudget(projected.tokenBudget, contract.token_budget);
-        const budgetDerivedLimit = resolveIntentRowBudget("context", contract.intent, tokenBudget, explicitTokenBudget);
-        const requestedLimit = parsePositiveIntentTokenBudget(projected.limit);
-        const derivedLimit = String(requestedLimit === undefined
-            ? budgetDerivedLimit
-            : Math.min(requestedLimit, budgetDerivedLimit));
-        if (projected.limit === undefined || requestedLimit !== undefined) {
-            projected.limit = derivedLimit;
-        }
-        if (projected.activityLimit === undefined) {
-            projected.activityLimit = derivedLimit;
-        }
-    },
-    get: (projected) => {
-        if (projected.depth === undefined && projected.fields === undefined) {
-            projected.depth = "standard";
-        }
-    },
-    list: (projected, contract, explicitTokenBudget) => {
-        if (projected.brief === undefined &&
-            projected.compact === undefined &&
-            projected.full === undefined &&
-            projected.fields === undefined) {
-            projected.fields =
-                "id,title,status,type,priority,parent,assignee,risk,blocked_by";
-        }
-        const tokenBudget = resolveIntentTokenBudget(projected.tokenBudget, contract.token_budget);
-        const budgetDerivedLimit = resolveIntentRowBudget("list", contract.intent, tokenBudget, explicitTokenBudget);
-        const requestedLimit = parsePositiveIntentTokenBudget(projected.limit);
-        if (projected.limit === undefined || requestedLimit !== undefined) {
-            projected.limit = String(requestedLimit === undefined
-                ? budgetDerivedLimit
-                : Math.min(requestedLimit, budgetDerivedLimit));
-        }
-    },
-    next: (projected) => {
-        if (projected.readyOnly === undefined)
-            projected.readyOnly = true;
-    },
-    search: (projected, contract, explicitTokenBudget) => {
-        if (projected.compact === undefined &&
-            projected.full === undefined &&
-            projected.fields === undefined) {
-            projected.compact = true;
-        }
-        const tokenBudget = resolveIntentTokenBudget(projected.tokenBudget, contract.token_budget);
-        const budgetDerivedLimit = resolveIntentRowBudget("search", contract.intent, tokenBudget, explicitTokenBudget);
-        const requestedLimit = parsePositiveIntentTokenBudget(projected.limit);
-        if (projected.limit === undefined || requestedLimit !== undefined) {
-            projected.limit = String(requestedLimit === undefined
-                ? budgetDerivedLimit
-                : Math.min(requestedLimit, budgetDerivedLimit));
-        }
-    },
-};
-/** Apply one declared read intent's defaults while preserving explicit caller options. */
-export function applyContextIntentProjection(command, options, positionalArguments = []) {
-    const tokenBudget = options.tokenBudget ?? options.token_budget;
-    if (typeof options.for !== "string") {
-        if (tokenBudget !== undefined &&
-            (command === "get" || command === "list" || command === "search")) {
-            throw new PmCliError("--token-budget requires a declared context intent selected with --for", EXIT_CODE.USAGE, {
-                code: "missing_required_option",
-                field: "for",
-                required: "Select a context intent with --for when setting --token-budget.",
-                why: "A token-budget override has no projection contract to constrain without a selected intent.",
-                nextSteps: [
-                    "Retry with --for <intent> --token-budget <n>, or omit --token-budget.",
-                ],
-            });
-        }
-        if (options.tokenBudget !== undefined ||
-            options.token_budget === undefined) {
-            return options;
-        }
-        const projected = { ...options, tokenBudget };
-        delete projected.token_budget;
-        return projected;
-    }
-    const contract = resolveContextIntentContract(command, options.for, undefined, positionalArguments);
-    const explicitTokenBudget = parsePositiveIntentTokenBudget(tokenBudget) !== undefined;
-    const projected = { ...options };
-    if (projected.tokenBudget === undefined && tokenBudget !== undefined) {
-        projected.tokenBudget = tokenBudget;
-    }
-    delete projected.token_budget;
-    if (projected.tokenBudget === undefined) {
-        projected.tokenBudget = String(contract.token_budget);
-    }
-    CONTEXT_INTENT_DEFAULT_APPLIERS[command](projected, contract, explicitTokenBudget);
-    return projected;
-}
-const CONTEXT_INTENT_DEGRADATIONS = {
-    context: "bounded_sections",
-    get: "standard_item",
-    list: "bounded_fields_and_rows",
-    next: "bounded_ranked_rows",
-    search: "bounded_ranked_rows",
-};
-const MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET = 256;
-/** Bound explanatory strings without dropping rows or invalidating pagination metadata. */
-function compactContextIntentValue(value) {
-    if (Array.isArray(value)) {
-        return value.map(compactContextIntentValue);
-    }
-    if (value !== null && typeof value === "object") {
-        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
-            key,
-            compactContextIntentValue(entry),
-        ]));
-    }
-    return typeof value === "string" && value.length > 240
-        ? `${value.slice(0, 240)}…`
-        : value;
-}
-function parsePositiveIntentTokenBudget(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 resolveIntentTokenBudget(value, declaredBudget) {
-    const parsed = parsePositiveIntentTokenBudget(value);
-    if (parsed === undefined)
-        return declaredBudget;
-    if (parsed < MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET) {
-        throw new PmCliError(`Context intent token budget must be at least ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET}`, EXIT_CODE.USAGE, {
-            code: "invalid_argument_value",
-            reason: "below_minimum",
-            field: "tokenBudget",
-            required: `Use an integer token budget of at least ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET}.`,
-            why: "Smaller ceilings cannot contain the minimum machine-readable intent receipt.",
-            nextSteps: [
-                `Retry with --token-budget ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET} or omit the override.`,
-            ],
-        });
-    }
-    return parsed;
-}
-function resolveIntentRowBudget(command, intent, tokenBudget, explicitTokenBudget) {
-    if (command === "get" || command === "next")
-        return undefined;
-    const contextOrient = command === "context" && intent === "orient";
-    const overhead = command === "context"
-        ? contextOrient
-            ? 1200
-            : 800
-        : command === "list"
-            ? 520
-            : 480;
-    const rowCost = command === "context" ? (contextOrient ? 600 : 500) : 16;
-    const calculatedLimit = Math.max(command === "context" ? 1 : 2, Math.floor((tokenBudget - overhead) / rowCost));
-    return explicitTokenBudget
-        ? calculatedLimit
-        : Math.min(command === "context" ? 20 : 100, calculatedLimit);
-}
-/** Update a receipt until its estimate matches the serialized projection that contains it. */
-function updateContextIntentEstimate(projected, receipt) {
-    let measuredTokens = receipt.estimated_tokens;
-    for (;;) {
-        receipt.estimated_tokens = measuredTokens;
-        const nextMeasurement = Math.ceil(Buffer.byteLength(JSON.stringify(projected), "utf8") / 4);
-        if (nextMeasurement === measuredTokens)
-            return;
-        measuredTokens = nextMeasurement;
-    }
-}
-const CONTEXT_INTENT_ROW_KEYS = {
-    context: [
-        "high_level",
-        "low_level",
-        "blocked_fallback",
-        "recently_created",
-        "unparented",
-        "hierarchy",
-        "activity",
-        "blockers",
-    ],
-    get: ["children"],
-    list: ["items"],
-    next: ["ready", "decision_needed", "gate_needed", "containers", "blocked", "held_by_others"],
-    search: ["items"],
-};
-/** Decode the cursor fields required to preserve a row-compacted continuation. */
-export function decodeContextIntentCursor(cursor) {
-    try {
-        const parsed = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
-        if (typeof parsed.fingerprint !== "string" ||
-            !Number.isSafeInteger(parsed.after_index)) {
-            return undefined;
-        }
-        return {
-            fingerprint: parsed.fingerprint,
-            after_index: parsed.after_index,
-            ...(typeof parsed.snapshot === "string"
-                ? { snapshot: parsed.snapshot }
-                : {}),
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
-/** Resolve the stable item id carried by list rows and nested search hits. */
-export function contextIntentRowId(row) {
-    if (row === null || typeof row !== "object")
-        return undefined;
-    if (typeof row.id === "string") {
-        return row.id;
-    }
-    const nestedId = row.item?.id;
-    return typeof nestedId === "string" ? nestedId : undefined;
-}
-function shrinkContextIntentRowsToBudget(projected, receipt, rows) {
-    let compacted = false;
-    for (;;) {
-        updateContextIntentEstimate(projected, receipt);
-        if (receipt.estimated_tokens <= receipt.token_budget || rows.length <= 1) {
-            return compacted;
-        }
-        const rowBytes = Buffer.byteLength(JSON.stringify(rows), "utf8");
-        const excessBytes = (receipt.estimated_tokens - receipt.token_budget) * 4;
-        rows.splice(-Math.min(rows.length - 1, Math.max(1, Math.ceil(excessBytes / Math.max(1, Math.ceil(rowBytes / rows.length))))));
-        compacted = true;
-    }
-}
-function compactPaginatedContextIntentRows(projected, receipt, options) {
-    const rows = projected.items;
-    const cursorContinuesExistingPage = typeof projected.next_cursor === "string";
-    const cursorSource = cursorContinuesExistingPage
-        ? projected.next_cursor
-        : options.after;
-    if (!Array.isArray(rows) || typeof cursorSource !== "string")
-        return false;
-    const cursorEnvelope = decodeContextIntentCursor(cursorSource);
-    if (cursorEnvelope === undefined)
-        return false;
-    const originalRowCount = rows.length;
-    const originalRows = [...rows];
-    let compacted = false;
-    for (;;) {
-        compacted =
-            shrinkContextIntentRowsToBudget(projected, receipt, rows) || compacted;
-        if (!compacted)
-            return false;
-        const lastId = contextIntentRowId(rows.at(-1));
-        if (lastId === undefined) {
-            rows.splice(0, rows.length, ...originalRows);
-            updateContextIntentEstimate(projected, receipt);
-            return false;
-        }
-        projected.next_cursor = encodeQueryCursor(cursorEnvelope.fingerprint, lastId, cursorContinuesExistingPage
-            ? cursorEnvelope.after_index - (originalRowCount - rows.length)
-            : cursorEnvelope.after_index + rows.length, cursorEnvelope.snapshot);
-        updateContextIntentEstimate(projected, receipt);
-        if (receipt.estimated_tokens <= receipt.token_budget || rows.length <= 1) {
-            break;
-        }
-    }
-    if (typeof projected.count === "number")
-        projected.count = rows.length;
-    if (typeof projected.applied_limit === "number") {
-        projected.applied_limit = rows.length;
-    }
-    return true;
-}
-/** Reduce root row collections deterministically while retaining at least one useful row. */
-function compactContextIntentRows(command, projected, receipt, options) {
-    if (command === "list" || command === "search") {
-        return compactPaginatedContextIntentRows(projected, receipt, options);
-    }
-    if (command !== "next" || typeof projected.next_cursor === "string") {
-        return false;
-    }
-    let compacted = false;
-    for (;;) {
-        updateContextIntentEstimate(projected, receipt);
-        if (receipt.estimated_tokens <= receipt.token_budget)
-            return compacted;
-        const candidate = CONTEXT_INTENT_ROW_KEYS[command]
-            .map((key) => ({
-            key,
-            rows: Array.isArray(projected[key]) ? projected[key] : [],
-        }))
-            .filter(({ rows }) => rows.length > 0)
-            .sort((left, right) => right.rows.length - left.rows.length ||
-            left.key.localeCompare(right.key))[0];
-        if (candidate === undefined)
-            return compacted;
-        const retainedTotal = CONTEXT_INTENT_ROW_KEYS[command].reduce((total, key) => total + (Array.isArray(projected[key]) ? projected[key].length : 0), 0);
-        if (retainedTotal <= 1)
-            return compacted;
-        const removableRows = Math.min(candidate.rows.length, retainedTotal - 1);
-        const candidateBytes = Buffer.byteLength(JSON.stringify(candidate.rows), "utf8");
-        const estimatedBytesPerRow = Math.max(1, Math.ceil(candidateBytes / candidate.rows.length));
-        const excessBytes = (receipt.estimated_tokens - receipt.token_budget) * 4;
-        const removalCount = Math.min(removableRows, Math.max(1, Math.ceil(excessBytes / estimatedBytesPerRow)));
-        candidate.rows.splice(-removalCount, removalCount);
-        compacted = true;
-    }
-}
-/** Attach budget and degradation evidence for a selected built-in read intent. */
-export function attachContextIntentReceipt(command, options, result) {
-    if (typeof options.for !== "string")
-        return result;
-    const normalizedCommand = command.startsWith("list-") ? "list" : command;
-    if (!(normalizedCommand in CONTEXT_INTENT_DEFAULT_APPLIERS))
-        return result;
-    const builtInCommand = normalizedCommand;
-    const contract = resolveContextIntentContract(builtInCommand, options.for);
-    const effectiveTokenBudget = resolveIntentTokenBudget(options.tokenBudget ?? options.token_budget, contract.token_budget);
-    const receipt = {
-        command: builtInCommand,
-        intent: contract.intent,
-        source: contract.source,
-        included_field_groups: [...contract.included_field_groups],
-        token_budget: effectiveTokenBudget,
-        declared_token_budget: contract.token_budget,
-        token_budget_override: effectiveTokenBudget - contract.token_budget,
-        estimated_tokens: 0,
-        within_budget: true,
-        degradation: CONTEXT_INTENT_DEGRADATIONS[builtInCommand],
-        declaration_feasible: true,
-        result_omitted: false,
-    };
-    const resultWithDiagnostics = { ...result };
-    const budgetDerivedLimit = resolveIntentRowBudget(builtInCommand, contract.intent, receipt.token_budget, parsePositiveIntentTokenBudget(options.tokenBudget ?? options.token_budget) !== undefined);
-    if (budgetDerivedLimit !== undefined) {
-        const effectiveLimit = parsePositiveIntentTokenBudget(options.limit);
-        const explicitLimitBinds = effectiveLimit !== undefined && effectiveLimit < budgetDerivedLimit;
-        receipt.budget_derived_limit = budgetDerivedLimit;
-        receipt.binding_constraint = explicitLimitBinds
-            ? "explicit_limit"
-            : "token_budget";
-        receipt.limit_reason = explicitLimitBinds
-            ? "The caller supplied a smaller row limit than the budget-derived ceiling."
-            : "The selected intent token budget constrains the effective row ceiling.";
-        resultWithDiagnostics.budget_derived_limit = budgetDerivedLimit;
-    }
-    let projected = {
-        ...resultWithDiagnostics,
-        context_intent: receipt,
-    };
-    updateContextIntentEstimate(projected, receipt);
-    if (receipt.estimated_tokens > receipt.token_budget) {
-        receipt.degradation = "recursive_budget_compaction";
-        projected = {
-            ...compactContextIntentValue(resultWithDiagnostics),
-            context_intent: receipt,
-        };
-        updateContextIntentEstimate(projected, receipt);
-    }
-    if (receipt.estimated_tokens > receipt.token_budget &&
-        compactContextIntentRows(builtInCommand, projected, receipt, options)) {
-        receipt.degradation = "budget_row_compaction";
-        updateContextIntentEstimate(projected, receipt);
-    }
-    receipt.declaration_feasible =
-        receipt.estimated_tokens <= receipt.declared_token_budget;
-    if (receipt.estimated_tokens > receipt.token_budget) {
-        receipt.degradation = "budget_receipt_only";
-        receipt.result_omitted = true;
-        receipt.within_budget = false;
-        projected = {
-            budget_exceeded: {
-                omitted_result: true,
-                reason: receipt.token_budget_override === 0
-                    ? "declared_budget_infeasible"
-                    : "effective_budget_infeasible",
-                restore_with: buildContextIntentRecoveryCommand(command, builtInCommand, contract.intent, receipt, resultWithDiagnostics),
-            },
-            context_intent: receipt,
-        };
-    }
-    return projected;
-}
-function collapseContinuationMetadata(options, result) {
-    if (typeof options.after !== "string" || options.after.length === 0) {
-        return result;
-    }
-    const fingerprint = decodeContextIntentCursor(options.after)?.fingerprint ?? "opaque_cursor";
-    const projected = { ...result };
-    for (const key of [
-        "applied_limit",
-        "completeness",
-        "context_intent",
-        "count",
-        "filters",
-        "has_more",
-        "now",
-        "omission_receipt",
-        "projection",
-        "row_contract",
-        "sorting",
-        "total",
-        "truncated",
-    ]) {
-        delete projected[key];
-    }
-    projected.continuation_contract = {
-        fingerprint,
-        metadata: "reference",
-        restore_with: "omit --after",
-    };
-    return projected;
-}
-/** Return whether one projected value is a mutable output record. */
-function isOutputRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/** Build a shell-safe bounded retry while retaining required read positionals. */
-function buildContextIntentRecoveryCommand(command, builtInCommand, intent, receipt, result) {
-    const recoveryTarget = builtInCommand === "get" &&
-        isOutputRecord(result.item) &&
-        typeof result.item.id === "string"
-        ? result.item.id
-        : builtInCommand === "search" && typeof result.query === "string"
-            ? result.query
-            : undefined;
-    const recoveryPositional = recoveryTarget === undefined
-        ? ""
-        : ` '${recoveryTarget.replaceAll("'", `'"'"'`)}'`;
-    const boundedRowLimit = builtInCommand === "get"
-        ? ""
-        : ` --limit ${receipt.budget_derived_limit ?? 1}`;
-    return `pm ${command}${recoveryPositional} --for ${intent} --token-budget ${Math.ceil(receipt.estimated_tokens / 100) * 100}${boundedRowLimit}`;
-}
-/** Read one numeric fixed-point estimate from an optional receipt. */
-function receiptEstimate(value, field) {
-    if (!isOutputRecord(value))
-        return undefined;
-    return typeof value[field] === "number" ? value[field] : undefined;
-}
-/** Stabilize every token receipt after suppressing discovery-only metadata. */
-function stabilizeSuppressedRowContractReceipts(result, options) {
-    let finalized = result;
-    for (let iteration = 0; iteration < 8; iteration += 1) {
-        const previousContextEstimate = receiptEstimate(finalized.context_intent, "estimated_tokens");
-        const previousReadEstimate = receiptEstimate(finalized.read_output, "estimated_tokens");
-        const previousSessionEstimate = receiptEstimate(finalized.read_session, "spent_this_call_tokens");
-        if (isOutputRecord(finalized.context_intent)) {
-            updateContextIntentEstimate(finalized, finalized.context_intent);
-        }
-        finalized = stabilizeReadOutputReceiptEstimates(finalized, options);
-        if (receiptEstimate(finalized.context_intent, "estimated_tokens") ===
-            previousContextEstimate &&
-            receiptEstimate(finalized.read_output, "estimated_tokens") ===
-                previousReadEstimate &&
-            receiptEstimate(finalized.read_session, "spent_this_call_tokens") ===
-                previousSessionEstimate) {
-            break;
-        }
-    }
-    return finalized;
-}
-/** Attach universal row, omission, and optional intent-budget contracts in rendering order. */
-export function attachReadOutputContracts(command, options, result) {
-    const disclosedResult = attachOutputOmissionReceipt(command, result);
-    const projected = typeof disclosedResult === "object" &&
-        disclosedResult !== null &&
-        !Array.isArray(disclosedResult)
-        ? applyReadOutputDimensions(command ?? "", options, collapseContinuationMetadata(options, attachContextIntentReceipt(command ?? "", options, disclosedResult)))
-        : disclosedResult;
-    propagateContextUsageServingReceipt(result, projected);
-    if (options.outputRowContract === true ||
-        options.output_row_contract === true ||
-        typeof projected !== "object" ||
-        projected === null ||
-        Array.isArray(projected) ||
-        !Object.hasOwn(projected, "row_contract")) {
-        return projected;
-    }
-    const suppressed = stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key]) => key !== "row_contract")), options);
-    propagateContextUsageServingReceipt(projected, suppressed);
-    return suppressed;
-}
+!(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]="6436107d-eedc-5c97-9d8f-6f119c9bbe29")}catch(e2){}})();import{AsyncLocalStorage}from"node:async_hooks";import{renderPmCommand}from"./command-line.js";import{attachOutputOmissionReceipt}from"./output-projection.js";import{encodeQueryCursor}from"./pagination.js";import{applyReadOutputDimensions,stabilizeReadOutputReceiptEstimates}from"./read-output-contracts.js";import{propagateContextUsageServingReceipt}from"./context-usage.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const PM_CONTEXT_INTENT_CONTRACTS=Object.freeze([{command:"context",intent:"orient",description:"Bounded active hierarchy, ownership, blockers, and recent progress.",included_field_groups:["summary","focus","hierarchy","blockers","activity"],token_budget:3e3,source:"core"},{command:"context",intent:"handoff",description:"Active ownership, evidence, decisions, and immediate continuation context.",included_field_groups:["summary","focus","in_progress","decisions","activity"],token_budget:2200,source:"core"},{command:"get",intent:"inspect",description:"Standard-depth item metadata, relationships, evidence, and lifecycle state.",included_field_groups:["item","children","claim_state","linked"],token_budget:3200,source:"core"},{command:"list",intent:"triage",description:"A budget-derived page of compact governance, ownership, priority, and blocker rows for triage.",included_field_groups:["identity","governance","ownership","dependencies"],token_budget:3200,source:"core"},{command:"next",intent:"execute",description:"The highest-ranked actionable work with concise ranking evidence.",included_field_groups:["recommended"],token_budget:1200,source:"core"},{command:"search",intent:"discover",description:"A budget-derived page of ranked canonical lineage candidates with compact match evidence.",included_field_groups:["identity","status","lineage","match"],token_budget:1800,source:"core"}]);const activeContextIntentContracts=new AsyncLocalStorage;function getActiveContextIntentContracts(){return activeContextIntentContracts.getStore()??PM_CONTEXT_INTENT_CONTRACTS}function runWithContextIntentContracts(layers,run){return activeContextIntentContracts.run(composeContextIntentContracts(layers.workspaceContracts,layers.packageContracts),run)}function normalizeContextIntentDeclaration(declaration,source){const command=declaration.command.trim().toLowerCase();const intent=declaration.intent.trim().toLowerCase();const key=`${command}:${intent}`;if(!/^[a-z0-9][a-z0-9-]*$/.test(command)||!/^[a-z0-9][a-z0-9-]*$/.test(intent)){throw new TypeError(`Invalid context intent command or name: ${key}`)}if(declaration.description.trim().length===0){throw new TypeError(`Context intent ${key} requires a non-empty description`)}if(!Number.isSafeInteger(declaration.token_budget)||declaration.token_budget<=0){throw new TypeError(`Context intent ${key} requires a positive integer token_budget`)}const includedFieldGroups=[...new Set(declaration.included_field_groups.map(field=>field.trim()).filter(Boolean))];if(includedFieldGroups.length===0){throw new TypeError(`Context intent ${key} requires included_field_groups`)}return{command,intent,description:declaration.description.trim(),included_field_groups:includedFieldGroups,token_budget:declaration.token_budget,source}}function composeContextIntentContracts(workspaceContracts=[],packageContracts=[]){const layers=[{source:"core",contracts:PM_CONTEXT_INTENT_CONTRACTS,allowOverride:false},{source:"package",contracts:packageContracts,allowOverride:false},{source:"workspace",contracts:workspaceContracts,allowOverride:true}];const composed=new Map;const keysSeenWithinLayer=new Set;for(const layer of layers){keysSeenWithinLayer.clear();for(const declaration of layer.contracts){const normalized=normalizeContextIntentDeclaration(declaration,layer.source);const key=`${normalized.command}:${normalized.intent}`;if(keysSeenWithinLayer.has(key)){throw new TypeError(`Duplicate context intent declaration: ${key}`)}keysSeenWithinLayer.add(key);if(!layer.allowOverride&&composed.has(key)){throw new TypeError(`Duplicate context intent declaration: ${key}`)}composed.set(key,normalized)}}return[...composed.values()].sort((left,right)=>left.command.localeCompare(right.command)||left.intent.localeCompare(right.intent))}function resolveContextIntentContract(command,intent,contracts=getActiveContextIntentContracts(),positionalArguments=[]){const normalizedCommand=command.trim().toLowerCase();const normalizedIntent=intent.trim().toLowerCase();const exact=contracts.find(entry=>entry.command===normalizedCommand&&entry.intent===normalizedIntent);if(exact)return{...exact,source:exact.source??"core"};const candidates=contracts.filter(entry=>entry.command===normalizedCommand).map(entry=>entry.intent);if(candidates.length===0)return void 0;const suggestion=candidates.map(candidate=>{const rows=Array.from({length:normalizedIntent.length+1},(_,index)=>index);for(let candidateIndex=1;candidateIndex<=candidate.length;candidateIndex+=1){let previous=rows[0];rows[0]=candidateIndex;for(let intentIndex=1;intentIndex<=normalizedIntent.length;intentIndex+=1){const prior=rows[intentIndex];rows[intentIndex]=Math.min(rows[intentIndex]+1,rows[intentIndex-1]+1,previous+(candidate[candidateIndex-1]===normalizedIntent[intentIndex-1]?0:1));previous=prior}}return{candidate,distance:rows[normalizedIntent.length]}}).sort((left,right)=>left.distance-right.distance||left.candidate.localeCompare(right.candidate))[0].candidate;const attemptedArguments=[normalizedCommand,...positionalArguments,"--for",normalizedIntent];const suggestedRetryArguments=[normalizedCommand,...positionalArguments,"--for",suggestion];const suggestedCommand=renderPmCommand(suggestedRetryArguments);throw new PmCliError(`Unknown context intent "${normalizedIntent}" for ${normalizedCommand}. Did you mean "${suggestion}"?`,EXIT_CODE.USAGE,{code:"unknown_context_intent",reason:"unknown_intent",field:"for",flag:"--for",value:normalizedIntent,required:`Use a declared ${normalizedCommand} intent.`,why:"Intent names are command-local contracts and cannot be inferred from output section names.",nextSteps:[suggestedCommand],recovery:{recovery_mode:"compact",attempted_command:renderPmCommand(attemptedArguments),allowed_values:[...candidates].sort(),suggested_retry:suggestedCommand,suggested_retry_args:suggestedRetryArguments}})}const CONTEXT_INTENT_DEFAULT_APPLIERS={context:(projected,contract,explicitTokenBudget)=>{if(projected.depth===void 0){projected.depth=contract.intent==="handoff"?"deep":"standard"}if(projected.section===void 0){projected.section=contract.intent==="handoff"?["activity","progress","blockers"]:["hierarchy","blockers","activity"]}const tokenBudget=resolveIntentTokenBudget(projected.tokenBudget,contract.token_budget);const budgetDerivedLimit=resolveIntentRowBudget("context",contract.intent,tokenBudget,explicitTokenBudget);const requestedLimit=parsePositiveIntentTokenBudget(projected.limit);const derivedLimit=String(requestedLimit===void 0?budgetDerivedLimit:Math.min(requestedLimit,budgetDerivedLimit));if(projected.limit===void 0||requestedLimit!==void 0){projected.limit=derivedLimit}if(projected.activityLimit===void 0){projected.activityLimit=derivedLimit}},get:projected=>{if(projected.depth===void 0&&projected.fields===void 0){projected.depth="standard"}},list:(projected,contract,explicitTokenBudget)=>{if(projected.brief===void 0&&projected.compact===void 0&&projected.full===void 0&&projected.fields===void 0){projected.fields="id,title,status,type,priority,parent,assignee,risk,blocked_by"}const tokenBudget=resolveIntentTokenBudget(projected.tokenBudget,contract.token_budget);const budgetDerivedLimit=resolveIntentRowBudget("list",contract.intent,tokenBudget,explicitTokenBudget);const requestedLimit=parsePositiveIntentTokenBudget(projected.limit);if(projected.limit===void 0||requestedLimit!==void 0){projected.limit=String(requestedLimit===void 0?budgetDerivedLimit:Math.min(requestedLimit,budgetDerivedLimit))}},next:projected=>{if(projected.readyOnly===void 0)projected.readyOnly=true},search:(projected,contract,explicitTokenBudget)=>{if(projected.compact===void 0&&projected.full===void 0&&projected.fields===void 0){projected.compact=true}const tokenBudget=resolveIntentTokenBudget(projected.tokenBudget,contract.token_budget);const budgetDerivedLimit=resolveIntentRowBudget("search",contract.intent,tokenBudget,explicitTokenBudget);const requestedLimit=parsePositiveIntentTokenBudget(projected.limit);if(projected.limit===void 0||requestedLimit!==void 0){projected.limit=String(requestedLimit===void 0?budgetDerivedLimit:Math.min(requestedLimit,budgetDerivedLimit))}}};function applyContextIntentProjection(command,options,positionalArguments=[]){const tokenBudget=options.tokenBudget??options.token_budget;if(typeof options.for!=="string"){if(tokenBudget!==void 0&&(command==="get"||command==="list"||command==="search")){throw new PmCliError("--token-budget requires a declared context intent selected with --for",EXIT_CODE.USAGE,{code:"missing_required_option",field:"for",required:"Select a context intent with --for when setting --token-budget.",why:"A token-budget override has no projection contract to constrain without a selected intent.",nextSteps:["Retry with --for <intent> --token-budget <n>, or omit --token-budget."]})}if(options.tokenBudget!==void 0||options.token_budget===void 0){return options}const projected2={...options,tokenBudget};delete projected2.token_budget;return projected2}const contract=resolveContextIntentContract(command,options.for,void 0,positionalArguments);const explicitTokenBudget=parsePositiveIntentTokenBudget(tokenBudget)!==void 0;const projected={...options};if(projected.tokenBudget===void 0&&tokenBudget!==void 0){projected.tokenBudget=tokenBudget}delete projected.token_budget;if(projected.tokenBudget===void 0){projected.tokenBudget=String(contract.token_budget)}CONTEXT_INTENT_DEFAULT_APPLIERS[command](projected,contract,explicitTokenBudget);return projected}const CONTEXT_INTENT_DEGRADATIONS={context:"bounded_sections",get:"standard_item",list:"bounded_fields_and_rows",next:"bounded_ranked_rows",search:"bounded_ranked_rows"};const MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET=256;function compactContextIntentValue(value){if(Array.isArray(value)){return value.map(compactContextIntentValue)}if(value!==null&&typeof value==="object"){return Object.fromEntries(Object.entries(value).map(([key,entry])=>[key,compactContextIntentValue(entry)]))}return typeof value==="string"&&value.length>240?`${value.slice(0,240)}\u2026`:value}function parsePositiveIntentTokenBudget(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 resolveIntentTokenBudget(value,declaredBudget){const parsed=parsePositiveIntentTokenBudget(value);if(parsed===void 0)return declaredBudget;if(parsed<MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET){throw new PmCliError(`Context intent token budget must be at least ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET}`,EXIT_CODE.USAGE,{code:"invalid_argument_value",reason:"below_minimum",field:"tokenBudget",required:`Use an integer token budget of at least ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET}.`,why:"Smaller ceilings cannot contain the minimum machine-readable intent receipt.",nextSteps:[`Retry with --token-budget ${MINIMUM_CONTEXT_INTENT_TOKEN_BUDGET} or omit the override.`]})}return parsed}function resolveIntentRowBudget(command,intent,tokenBudget,explicitTokenBudget){if(command==="get"||command==="next")return void 0;const contextOrient=command==="context"&&intent==="orient";const overhead=command==="context"?contextOrient?1200:800:command==="list"?520:480;const rowCost=command==="context"?contextOrient?600:500:16;const calculatedLimit=Math.max(command==="context"?1:2,Math.floor((tokenBudget-overhead)/rowCost));return explicitTokenBudget?calculatedLimit:Math.min(command==="context"?20:100,calculatedLimit)}function updateContextIntentEstimate(projected,receipt){let measuredTokens=receipt.estimated_tokens;for(;;){receipt.estimated_tokens=measuredTokens;const nextMeasurement=Math.ceil(Buffer.byteLength(JSON.stringify(projected),"utf8")/4);if(nextMeasurement===measuredTokens)return;measuredTokens=nextMeasurement}}const CONTEXT_INTENT_ROW_KEYS={context:["high_level","low_level","blocked_fallback","recently_created","unparented","hierarchy","activity","blockers"],get:["children"],list:["items"],next:["ready","decision_needed","gate_needed","containers","blocked","held_by_others"],search:["items"]};function decodeContextIntentCursor(cursor){try{const parsed=JSON.parse(Buffer.from(cursor,"base64url").toString("utf8"));if(typeof parsed.fingerprint!=="string"||!Number.isSafeInteger(parsed.after_index)){return void 0}return{fingerprint:parsed.fingerprint,after_index:parsed.after_index,...typeof parsed.snapshot==="string"?{snapshot:parsed.snapshot}:{}}}catch{return void 0}}function contextIntentRowId(row){if(row===null||typeof row!=="object")return void 0;if(typeof row.id==="string"){return row.id}const nestedId=row.item?.id;return typeof nestedId==="string"?nestedId:void 0}function shrinkContextIntentRowsToBudget(projected,receipt,rows){let compacted=false;for(;;){updateContextIntentEstimate(projected,receipt);if(receipt.estimated_tokens<=receipt.token_budget||rows.length<=1){return compacted}const rowBytes=Buffer.byteLength(JSON.stringify(rows),"utf8");const excessBytes=(receipt.estimated_tokens-receipt.token_budget)*4;rows.splice(-Math.min(rows.length-1,Math.max(1,Math.ceil(excessBytes/Math.max(1,Math.ceil(rowBytes/rows.length))))));compacted=true}}function compactPaginatedContextIntentRows(projected,receipt,options){const rows=projected.items;const cursorContinuesExistingPage=typeof projected.next_cursor==="string";const cursorSource=cursorContinuesExistingPage?projected.next_cursor:options.after;if(!Array.isArray(rows)||typeof cursorSource!=="string")return false;const cursorEnvelope=decodeContextIntentCursor(cursorSource);if(cursorEnvelope===void 0)return false;const originalRowCount=rows.length;const originalRows=[...rows];let compacted=false;for(;;){compacted=shrinkContextIntentRowsToBudget(projected,receipt,rows)||compacted;if(!compacted)return false;const lastId=contextIntentRowId(rows.at(-1));if(lastId===void 0){rows.splice(0,rows.length,...originalRows);updateContextIntentEstimate(projected,receipt);return false}projected.next_cursor=encodeQueryCursor(cursorEnvelope.fingerprint,lastId,cursorContinuesExistingPage?cursorEnvelope.after_index-(originalRowCount-rows.length):cursorEnvelope.after_index+rows.length,cursorEnvelope.snapshot);updateContextIntentEstimate(projected,receipt);if(receipt.estimated_tokens<=receipt.token_budget||rows.length<=1){break}}if(typeof projected.count==="number")projected.count=rows.length;if(typeof projected.applied_limit==="number"){projected.applied_limit=rows.length}return true}function compactContextIntentRows(command,projected,receipt,options){if(command==="list"||command==="search"){return compactPaginatedContextIntentRows(projected,receipt,options)}if(command!=="next"||typeof projected.next_cursor==="string"){return false}let compacted=false;for(;;){updateContextIntentEstimate(projected,receipt);if(receipt.estimated_tokens<=receipt.token_budget)return compacted;const candidate=CONTEXT_INTENT_ROW_KEYS[command].map(key=>({key,rows:Array.isArray(projected[key])?projected[key]:[]})).filter(({rows})=>rows.length>0).sort((left,right)=>right.rows.length-left.rows.length||left.key.localeCompare(right.key))[0];if(candidate===void 0)return compacted;const retainedTotal=CONTEXT_INTENT_ROW_KEYS[command].reduce((total,key)=>total+(Array.isArray(projected[key])?projected[key].length:0),0);if(retainedTotal<=1)return compacted;const removableRows=Math.min(candidate.rows.length,retainedTotal-1);const candidateBytes=Buffer.byteLength(JSON.stringify(candidate.rows),"utf8");const estimatedBytesPerRow=Math.max(1,Math.ceil(candidateBytes/candidate.rows.length));const excessBytes=(receipt.estimated_tokens-receipt.token_budget)*4;const removalCount=Math.min(removableRows,Math.max(1,Math.ceil(excessBytes/estimatedBytesPerRow)));candidate.rows.splice(-removalCount,removalCount);compacted=true}}function attachContextIntentReceipt(command,options,result){if(typeof options.for!=="string")return result;const normalizedCommand=command.startsWith("list-")?"list":command;if(!(normalizedCommand in CONTEXT_INTENT_DEFAULT_APPLIERS))return result;const builtInCommand=normalizedCommand;const contract=resolveContextIntentContract(builtInCommand,options.for);const effectiveTokenBudget=resolveIntentTokenBudget(options.tokenBudget??options.token_budget,contract.token_budget);const receipt={command:builtInCommand,intent:contract.intent,source:contract.source,included_field_groups:[...contract.included_field_groups],token_budget:effectiveTokenBudget,declared_token_budget:contract.token_budget,token_budget_override:effectiveTokenBudget-contract.token_budget,estimated_tokens:0,within_budget:true,degradation:CONTEXT_INTENT_DEGRADATIONS[builtInCommand],declaration_feasible:true,result_omitted:false};const resultWithDiagnostics={...result};const budgetDerivedLimit=resolveIntentRowBudget(builtInCommand,contract.intent,receipt.token_budget,parsePositiveIntentTokenBudget(options.tokenBudget??options.token_budget)!==void 0);if(budgetDerivedLimit!==void 0){const effectiveLimit=parsePositiveIntentTokenBudget(options.limit);const explicitLimitBinds=effectiveLimit!==void 0&&effectiveLimit<budgetDerivedLimit;receipt.budget_derived_limit=budgetDerivedLimit;receipt.binding_constraint=explicitLimitBinds?"explicit_limit":"token_budget";receipt.limit_reason=explicitLimitBinds?"The caller supplied a smaller row limit than the budget-derived ceiling.":"The selected intent token budget constrains the effective row ceiling.";resultWithDiagnostics.budget_derived_limit=budgetDerivedLimit}let projected={...resultWithDiagnostics,context_intent:receipt};updateContextIntentEstimate(projected,receipt);if(receipt.estimated_tokens>receipt.token_budget){receipt.degradation="recursive_budget_compaction";projected={...compactContextIntentValue(resultWithDiagnostics),context_intent:receipt};updateContextIntentEstimate(projected,receipt)}if(receipt.estimated_tokens>receipt.token_budget&&compactContextIntentRows(builtInCommand,projected,receipt,options)){receipt.degradation="budget_row_compaction";updateContextIntentEstimate(projected,receipt)}receipt.declaration_feasible=receipt.estimated_tokens<=receipt.declared_token_budget;if(receipt.estimated_tokens>receipt.token_budget){receipt.degradation="budget_receipt_only";receipt.result_omitted=true;receipt.within_budget=false;projected={budget_exceeded:{omitted_result:true,reason:receipt.token_budget_override===0?"declared_budget_infeasible":"effective_budget_infeasible",restore_with:buildContextIntentRecoveryCommand(command,builtInCommand,contract.intent,receipt,resultWithDiagnostics)},context_intent:receipt}}return projected}function collapseContinuationMetadata(options,result){if(typeof options.after!=="string"||options.after.length===0){return result}const fingerprint=decodeContextIntentCursor(options.after)?.fingerprint??"opaque_cursor";const projected={...result};for(const key of["applied_limit","completeness","context_intent","count","filters","has_more","now","omission_receipt","projection","row_contract","sorting","total","truncated"]){delete projected[key]}projected.continuation_contract={fingerprint,metadata:"reference",restore_with:"omit --after"};return projected}function isOutputRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function buildContextIntentRecoveryCommand(command,builtInCommand,intent,receipt,result){const recoveryTarget=builtInCommand==="get"&&isOutputRecord(result.item)&&typeof result.item.id==="string"?result.item.id:builtInCommand==="search"&&typeof result.query==="string"?result.query:void 0;const recoveryPositional=recoveryTarget===void 0?"":` '${recoveryTarget.replaceAll("'",`'"'"'`)}'`;const boundedRowLimit=builtInCommand==="get"?"":` --limit ${receipt.budget_derived_limit??1}`;return`pm ${command}${recoveryPositional} --for ${intent} --token-budget ${Math.ceil(receipt.estimated_tokens/100)*100}${boundedRowLimit}`}function receiptEstimate(value,field){if(!isOutputRecord(value))return void 0;return typeof value[field]==="number"?value[field]:void 0}function stabilizeSuppressedRowContractReceipts(result,options){let finalized=result;for(let iteration=0;iteration<8;iteration+=1){const previousContextEstimate=receiptEstimate(finalized.context_intent,"estimated_tokens");const previousReadEstimate=receiptEstimate(finalized.read_output,"estimated_tokens");const previousSessionEstimate=receiptEstimate(finalized.read_session,"spent_this_call_tokens");if(isOutputRecord(finalized.context_intent)){updateContextIntentEstimate(finalized,finalized.context_intent)}finalized=stabilizeReadOutputReceiptEstimates(finalized,options);if(receiptEstimate(finalized.context_intent,"estimated_tokens")===previousContextEstimate&&receiptEstimate(finalized.read_output,"estimated_tokens")===previousReadEstimate&&receiptEstimate(finalized.read_session,"spent_this_call_tokens")===previousSessionEstimate){break}}return finalized}function attachReadOutputContracts(command,options,result){const disclosedResult=attachOutputOmissionReceipt(command,result);const projected=typeof disclosedResult==="object"&&disclosedResult!==null&&!Array.isArray(disclosedResult)?applyReadOutputDimensions(command??"",options,collapseContinuationMetadata(options,attachContextIntentReceipt(command??"",options,disclosedResult))):disclosedResult;propagateContextUsageServingReceipt(result,projected);if(options.outputRowContract===true||options.output_row_contract===true||typeof projected!=="object"||projected===null||Array.isArray(projected)||!Object.hasOwn(projected,"row_contract")){return projected}const suppressed=stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key])=>key!=="row_contract")),options);propagateContextUsageServingReceipt(projected,suppressed);return suppressed}export{PM_CONTEXT_INTENT_CONTRACTS,applyContextIntentProjection,attachContextIntentReceipt,attachReadOutputContracts,composeContextIntentContracts,contextIntentRowId,decodeContextIntentCursor,getActiveContextIntentContracts,resolveContextIntentContract,runWithContextIntentContracts};
 //# sourceMappingURL=context-intent-contracts.js.map
-//# debugId=d6fc4c70-c955-5fb5-ab4b-5dfa1200d58d