@unbrained/pm-cli 2026.8.21 → 2026.8.23

package/dist/sdk/cli-contracts/agent-output-contracts.d.ts

@@ -6,6 +6,59 @@ export type PmOutputDegradationStep = (typeof PM_OUTPUT_DEGRADATION_STEPS)[numbe
 export declare const PM_OUTPUT_BUDGET_CLASSES: readonly ["mutation", "read", "discovery", "governance"];
 /** Restricts command-output budget classes. */
 export type PmOutputBudgetClass = (typeof PM_OUTPUT_BUDGET_CLASSES)[number];
+/** Stable diagnostic families that require independent output ceilings. */
+export declare const PM_DIAGNOSTIC_OUTPUT_CLASSES: readonly ["error", "warning", "validation_summary", "recovery_bundle"];
+/** Restricts diagnostic budget selection to declared families. */
+export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];
+/** Deterministic diagnostic degradation stages, from richest to smallest. */
+export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS: readonly ["full", "omit_explanation", "limit_collections", "compact_recovery", "action_only"];
+/** Restricts diagnostic degradation receipts to declared stages. */
+export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];
+/** Declares one diagnostic family's text and JSON token ceilings. */
+export interface PmDiagnosticOutputBudgetContract {
+    /** Diagnostic family governed by this contract. */
+    diagnostic_class: PmDiagnosticOutputClass;
+    /** Default ceiling by rendered transport. */
+    default_max_estimated_tokens_by_format: Readonly<{
+        text: number;
+        json: number;
+    }>;
+    /** Smallest explicit ceiling accepted by the projector. */
+    minimum_max_estimated_tokens: number;
+    /** Ordered degradation policy applied when the ceiling binds. */
+    degradation_ladder: readonly PmDiagnosticDegradationStep[];
+    /** Paths whose first actionable value must survive degradation. */
+    corrective_action_paths: readonly string[];
+    /** Stable estimate used by gates and SDK consumers. */
+    token_estimate: "ceil(utf8_bytes / 4)";
+}
+/** Machine-readable disclosure attached to a projected diagnostic. */
+export interface PmDiagnosticOutputReceipt {
+    /** Diagnostic family whose contract bound the output. */
+    diagnostic_class: PmDiagnosticOutputClass;
+    /** Rendered transport measured by the projector. */
+    format: "json" | "text";
+    /** Effective estimated-token ceiling. */
+    budget: number;
+    /** Whether the caller supplied the ceiling or used the declaration. */
+    budget_source: "default" | "explicit";
+    /** Estimate before diagnostic degradation. */
+    original_estimated_tokens: number;
+    /** Exact estimate of the returned projection. */
+    estimated_tokens: number;
+    /** Whether one or more fields were removed or compacted. */
+    truncated: boolean;
+    /** Applied stages in contract order. */
+    degradation_steps: PmDiagnosticDegradationStep[];
+    /** Top-level fields removed from the original diagnostic. */
+    omitted_fields: string[];
+    /** Additional omitted fields not named individually in a bounded receipt. */
+    omitted_fields_overflow_count?: number;
+}
+/** JSON diagnostic after binding it to a declared output contract. */
+export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic, Extract<keyof TDiagnostic, "code" | "required">> & {
+    diagnostic_output?: PmDiagnosticOutputReceipt;
+};
 /** Describes one command's default agent-output budget and degradation policy. */
 export interface PmCommandOutputBudgetContract {
     /** Canonical or compatibility command name. */
@@ -26,6 +79,8 @@ export interface PmCommandOutputBudgetContract {
     /** Stable estimate used by gates and SDK consumers. */
     token_estimate: "ceil(utf8_bytes / 4)";
 }
+/** Public default contract for every diagnostic family. */
+export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS: PmDiagnosticOutputBudgetContract[];
 /** Infer the conservative workload class for a core or package command. */
 export declare function inferPmOutputBudgetClass(command: string): PmOutputBudgetClass;
 /** Build the generated default budget for a core or package command. */
@@ -48,3 +103,25 @@ export declare function resolvePmCommandOutputBudget(command: string, options?:
 }): PmCommandOutputBudgetContract | null;
 /** Estimate conservative token usage from UTF-8 output bytes. */
 export declare function estimatePmOutputTokens(utf8Bytes: number): number;
+/** Resolve the binding output contract for one diagnostic family. */
+export declare function resolvePmDiagnosticOutputBudget(diagnosticClass: PmDiagnosticOutputClass): PmDiagnosticOutputBudgetContract;
+/**
+ * Bind a JSON diagnostic to its declared ceiling while preserving the first
+ * corrective action and reporting every top-level omission.
+ */
+export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: {
+    diagnosticClass?: PmDiagnosticOutputClass;
+    maxEstimatedTokens?: number;
+}): PmProjectedDiagnostic<TDiagnostic>;
+/** Text diagnostic together with the same measured receipt used by JSON. */
+export interface PmProjectedTextDiagnostic {
+    /** Rendered action-first diagnostic. */
+    output: string;
+    /** Binding diagnostic budget receipt. */
+    diagnostic_output: PmDiagnosticOutputReceipt;
+}
+/** Bind human-readable diagnostics without ever truncating the corrective action away. */
+export declare function projectPmDiagnosticText(output: string, correctiveAction: string, options?: {
+    diagnosticClass?: PmDiagnosticOutputClass;
+    maxEstimatedTokens?: number;
+}): PmProjectedTextDiagnostic;

package/dist/sdk/cli-contracts/agent-output-contracts.js

@@ -6,7 +6,7 @@
  * output policy without coupling package authors to pm's renderer.
  */
 
-!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]="23b3a820-f205-506b-9507-dbd60087f62e")}catch(e){}}();
+!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]="1d338971-5a60-5b4e-b4c8-0705c8e8c98c")}catch(e){}}();
 import { PM_CORE_COMMAND_NAMES } from "./enum-contracts.js";
 /** Stable degradation stages applied when an output exceeds its token budget. */
 export const PM_OUTPUT_DEGRADATION_STEPS = [
@@ -23,6 +23,21 @@ export const PM_OUTPUT_BUDGET_CLASSES = [
     "discovery",
     "governance",
 ];
+/** Stable diagnostic families that require independent output ceilings. */
+export const PM_DIAGNOSTIC_OUTPUT_CLASSES = [
+    "error",
+    "warning",
+    "validation_summary",
+    "recovery_bundle",
+];
+/** Deterministic diagnostic degradation stages, from richest to smallest. */
+export const PM_DIAGNOSTIC_DEGRADATION_STEPS = [
+    "full",
+    "omit_explanation",
+    "limit_collections",
+    "compact_recovery",
+    "action_only",
+];
 const MUTATION_COMMANDS = new Set([
     "append",
     "claim",
@@ -84,6 +99,29 @@ const DEFAULT_MAX_ESTIMATED_TOKENS = {
 };
 const JSON_BUDGET_NUMERATOR = 3;
 const JSON_BUDGET_DENOMINATOR = 2;
+const MINIMUM_DIAGNOSTIC_BUDGET = 192;
+const DIAGNOSTIC_DEFAULT_BUDGETS = {
+    error: { text: 768, json: 2_000 },
+    warning: { text: 768, json: 2_000 },
+    validation_summary: { text: 1_500, json: 3_000 },
+    recovery_bundle: { text: 768, json: 2_000 },
+};
+/** Public default contract for every diagnostic family. */
+export const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS = PM_DIAGNOSTIC_OUTPUT_CLASSES.map((diagnosticClass) => ({
+    diagnostic_class: diagnosticClass,
+    default_max_estimated_tokens_by_format: DIAGNOSTIC_DEFAULT_BUDGETS[diagnosticClass],
+    minimum_max_estimated_tokens: MINIMUM_DIAGNOSTIC_BUDGET,
+    degradation_ladder: PM_DIAGNOSTIC_DEGRADATION_STEPS,
+    corrective_action_paths: [
+        "required",
+        "recovery.suggested_retry",
+        "recovery.suggested_retry_args",
+        "recovery.next_best_command",
+        "next_steps[0]",
+    ],
+    token_estimate: "ceil(utf8_bytes / 4)",
+}));
+const DIAGNOSTIC_BUDGET_BY_CLASS = new Map(PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS.map((contract) => [contract.diagnostic_class, contract]));
 /** Infer the conservative workload class for a core or package command. */
 export function inferPmOutputBudgetClass(command) {
     const [rootCommand = ""] = command.trim().split(/\s+/u);
@@ -150,5 +188,291 @@ export function resolvePmCommandOutputBudget(command, options = {}) {
 export function estimatePmOutputTokens(utf8Bytes) {
     return Math.ceil(Math.max(0, utf8Bytes) / 4);
 }
+/** Resolve the binding output contract for one diagnostic family. */
+export function resolvePmDiagnosticOutputBudget(diagnosticClass) {
+    const contract = DIAGNOSTIC_BUDGET_BY_CLASS.get(diagnosticClass);
+    if (contract === undefined) {
+        throw new TypeError(`diagnosticClass must be one of: ${PM_DIAGNOSTIC_OUTPUT_CLASSES.join(", ")}`);
+    }
+    return contract;
+}
+function estimateJsonDiagnosticTokens(value) {
+    return estimatePmOutputTokens(Buffer.byteLength(JSON.stringify(value, null, 2), "utf8"));
+}
+function isDiagnosticRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function compactDiagnosticRecovery(value) {
+    if (!isDiagnosticRecord(value))
+        return undefined;
+    const compact = {};
+    for (const key of [
+        "suggested_retry",
+        "suggested_retry_args",
+        "next_best_command",
+        "allowed_values",
+        "candidate_commands",
+        "missing",
+        "missing_required_fields",
+        "option_scope",
+        "retry_after_ms",
+    ]) {
+        const candidate = value[key];
+        if (Array.isArray(candidate)) {
+            compact[key] =
+                key === "suggested_retry_args" ? candidate : candidate.slice(0, 3);
+        }
+        else if (candidate !== undefined)
+            compact[key] = candidate;
+    }
+    return Object.keys(compact).length > 0 ? compact : undefined;
+}
+function truncateDiagnosticString(value, maximum) {
+    if (typeof value !== "string" || value.length <= maximum)
+        return value;
+    return `${value.slice(0, Math.max(1, maximum - 3))}...`;
+}
+function truncateDiagnosticUtf8Text(value, maximumBytes) {
+    if (Buffer.byteLength(value, "utf8") <= maximumBytes)
+        return value;
+    const suffix = "...";
+    const codePoints = Array.from(value);
+    let lower = 0;
+    let upper = codePoints.length;
+    while (lower < upper) {
+        const middle = Math.ceil((lower + upper) / 2);
+        const candidate = `${codePoints.slice(0, middle).join("")}${suffix}`;
+        if (Buffer.byteLength(candidate, "utf8") <= maximumBytes)
+            lower = middle;
+        else
+            upper = middle - 1;
+    }
+    return `${codePoints.slice(0, lower).join("")}${suffix}`;
+}
+function prioritizeDiagnosticFields(diagnostic) {
+    const prioritized = {};
+    for (const key of [
+        "code",
+        "required",
+        "recovery",
+        "next_steps",
+        "exit_code",
+        "type",
+        "title",
+        "detail",
+        "why",
+        "examples",
+    ]) {
+        if (Object.hasOwn(diagnostic, key) && diagnostic[key] !== undefined) {
+            prioritized[key] = diagnostic[key];
+        }
+    }
+    for (const [key, value] of Object.entries(diagnostic)) {
+        if (key !== "__proto__" && !Object.hasOwn(prioritized, key)) {
+            prioritized[key] = value;
+        }
+    }
+    return prioritized;
+}
+const DIAGNOSTIC_COLLECTION_LIMIT_STAGES = new Set(["limit_collections", "compact_recovery", "action_only"]);
+const DIAGNOSTIC_RECOVERY_COMPACTION_STAGES = new Set(["compact_recovery", "action_only"]);
+function actionOnlyDiagnostic(candidate) {
+    const actionOnly = {
+        code: typeof candidate.code === "string" ? candidate.code : "diagnostic",
+        required: truncateDiagnosticString(candidate.required, 160) ??
+            "Inspect the diagnostic code and retry with corrected input.",
+    };
+    const recovery = compactDiagnosticRecovery(candidate.recovery);
+    if (recovery !== undefined) {
+        actionOnly.recovery = recovery;
+    }
+    else if (Array.isArray(candidate.next_steps)) {
+        actionOnly.next_steps = candidate.next_steps.slice(0, 1);
+    }
+    if (candidate.exit_code !== undefined)
+        actionOnly.exit_code = candidate.exit_code;
+    if (candidate.type !== undefined)
+        actionOnly.type = candidate.type;
+    return actionOnly;
+}
+function diagnosticCandidate(diagnostic, stage) {
+    const candidate = structuredClone(diagnostic);
+    if (stage !== "full") {
+        delete candidate.why;
+        delete candidate.examples;
+    }
+    if (DIAGNOSTIC_COLLECTION_LIMIT_STAGES.has(stage)) {
+        for (const [key, value] of Object.entries(candidate)) {
+            if (Array.isArray(value))
+                candidate[key] = value.slice(0, 3);
+        }
+    }
+    if (DIAGNOSTIC_RECOVERY_COMPACTION_STAGES.has(stage)) {
+        const recovery = compactDiagnosticRecovery(candidate.recovery);
+        if (recovery)
+            candidate.recovery = recovery;
+        else
+            delete candidate.recovery;
+    }
+    if (stage !== "action_only")
+        return prioritizeDiagnosticFields(candidate);
+    return actionOnlyDiagnostic(candidate);
+}
+function attachDiagnosticReceipt(candidate, receipt) {
+    const projected = {
+        ...candidate,
+        diagnostic_output: { ...receipt, estimated_tokens: 0 },
+    };
+    for (let attempt = 0; attempt < 4; attempt += 1) {
+        const estimatedTokens = estimateJsonDiagnosticTokens(projected);
+        const outputReceipt = projected.diagnostic_output;
+        if (outputReceipt.estimated_tokens === estimatedTokens)
+            break;
+        outputReceipt.estimated_tokens = estimatedTokens;
+    }
+    return projected;
+}
+function shrinkMinimalDiagnosticCandidate(candidate, receipt, budget) {
+    let fallback = attachDiagnosticReceipt(candidate, receipt);
+    for (const optionalField of ["recovery", "exit_code"]) {
+        if (estimateJsonDiagnosticTokens(fallback) <= budget ||
+            candidate[optionalField] === undefined) {
+            continue;
+        }
+        delete candidate[optionalField];
+        fallback = attachDiagnosticReceipt(candidate, receipt);
+    }
+    let maximumActionBytes = 40;
+    while (estimateJsonDiagnosticTokens(fallback) > budget &&
+        maximumActionBytes > 4) {
+        maximumActionBytes -= 4;
+        candidate.code = truncateDiagnosticUtf8Text(String(candidate.code), maximumActionBytes);
+        candidate.required = truncateDiagnosticUtf8Text(String(candidate.required), maximumActionBytes);
+        fallback = attachDiagnosticReceipt(candidate, receipt);
+    }
+    return fallback;
+}
+function createMinimalDiagnosticFallback(projected, budget) {
+    const receipt = projected.diagnostic_output;
+    const { estimated_tokens: _estimatedTokens, ...receiptWithoutEstimate } = receipt;
+    const boundedOmittedFields = receiptWithoutEstimate.omitted_fields
+        .slice(0, 8)
+        .map((field) => truncateDiagnosticUtf8Text(field, 32));
+    const boundedReceipt = {
+        ...receiptWithoutEstimate,
+        omitted_fields: boundedOmittedFields,
+        ...(receiptWithoutEstimate.omitted_fields.length >
+            boundedOmittedFields.length
+            ? {
+                omitted_fields_overflow_count: receiptWithoutEstimate.omitted_fields.length -
+                    boundedOmittedFields.length,
+            }
+            : {}),
+    };
+    const recoveryCandidate = compactDiagnosticRecovery(projected.recovery);
+    const recovery = recoveryCandidate && estimateJsonDiagnosticTokens(recoveryCandidate) <= 48
+        ? recoveryCandidate
+        : undefined;
+    const candidate = {
+        code: truncateDiagnosticUtf8Text(String(projected.code), 320),
+        required: truncateDiagnosticUtf8Text(String(projected.required), 320),
+        ...(recovery ? { recovery } : {}),
+        ...(projected.exit_code !== undefined
+            ? { exit_code: projected.exit_code }
+            : {}),
+    };
+    let fallback = attachDiagnosticReceipt(candidate, boundedReceipt);
+    while (estimateJsonDiagnosticTokens(fallback) > budget &&
+        boundedReceipt.omitted_fields.length > 0) {
+        boundedReceipt.omitted_fields.pop();
+        boundedReceipt.omitted_fields_overflow_count =
+            receiptWithoutEstimate.omitted_fields.length -
+                boundedReceipt.omitted_fields.length;
+        fallback = attachDiagnosticReceipt(candidate, boundedReceipt);
+    }
+    fallback = shrinkMinimalDiagnosticCandidate(candidate, boundedReceipt, budget);
+    return fallback;
+}
+/**
+ * Bind a JSON diagnostic to its declared ceiling while preserving the first
+ * corrective action and reporting every top-level omission.
+ */
+export function projectPmDiagnosticOutput(diagnostic, options = {}) {
+    const diagnosticRecord = diagnostic;
+    const diagnosticClass = options.diagnosticClass ?? "error";
+    const contract = resolvePmDiagnosticOutputBudget(diagnosticClass);
+    const explicitBudget = options.maxEstimatedTokens;
+    if (explicitBudget !== undefined &&
+        (!Number.isSafeInteger(explicitBudget) ||
+            explicitBudget < contract.minimum_max_estimated_tokens)) {
+        throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);
+    }
+    const budget = explicitBudget ?? contract.default_max_estimated_tokens_by_format.json;
+    const originalEstimatedTokens = estimateJsonDiagnosticTokens(diagnosticRecord);
+    const originalFields = Object.keys(diagnosticRecord);
+    if (originalEstimatedTokens <= budget) {
+        return prioritizeDiagnosticFields(structuredClone(diagnosticRecord));
+    }
+    let projected;
+    for (const [index, stage] of contract.degradation_ladder.entries()) {
+        const candidate = diagnosticCandidate(diagnosticRecord, stage);
+        const omittedFields = originalFields.filter((field) => !Object.hasOwn(candidate, field));
+        const withReceipt = attachDiagnosticReceipt(candidate, {
+            diagnostic_class: diagnosticClass,
+            format: "json",
+            budget,
+            budget_source: explicitBudget === undefined ? "default" : "explicit",
+            original_estimated_tokens: originalEstimatedTokens,
+            truncated: index > 0,
+            degradation_steps: contract.degradation_ladder.slice(0, index + 1),
+            omitted_fields: omittedFields,
+        });
+        projected = withReceipt;
+        if (estimateJsonDiagnosticTokens(withReceipt) <= budget)
+            break;
+    }
+    if (estimateJsonDiagnosticTokens(projected) > budget) {
+        projected = createMinimalDiagnosticFallback(projected, budget);
+    }
+    return projected;
+}
+/** Bind human-readable diagnostics without ever truncating the corrective action away. */
+export function projectPmDiagnosticText(output, correctiveAction, options = {}) {
+    const diagnosticClass = options.diagnosticClass ?? "error";
+    const contract = resolvePmDiagnosticOutputBudget(diagnosticClass);
+    const explicitBudget = options.maxEstimatedTokens;
+    if (explicitBudget !== undefined &&
+        (!Number.isSafeInteger(explicitBudget) ||
+            explicitBudget < contract.minimum_max_estimated_tokens)) {
+        throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);
+    }
+    const budget = explicitBudget ?? contract.default_max_estimated_tokens_by_format.text;
+    const originalEstimatedTokens = estimatePmOutputTokens(Buffer.byteLength(output, "utf8"));
+    const truncated = originalEstimatedTokens > budget;
+    const actionPrefix = "What is required:\n  ";
+    const actionSuffix = `\n\nDiagnostic output exceeded its declared ${budget}-token ceiling; rerun with structured JSON for the bounded recovery envelope.`;
+    const correctiveActionText = correctiveAction.trim() ||
+        "Inspect the diagnostic code and retry with corrected input.";
+    const availableActionBytes = Math.max(1, budget * 4 - Buffer.byteLength(`${actionPrefix}${actionSuffix}`, "utf8"));
+    const projectedOutput = truncated
+        ? `${actionPrefix}${truncateDiagnosticUtf8Text(correctiveActionText, availableActionBytes)}${actionSuffix}`
+        : output;
+    return {
+        output: projectedOutput,
+        diagnostic_output: {
+            diagnostic_class: diagnosticClass,
+            format: "text",
+            budget,
+            budget_source: explicitBudget === undefined ? "default" : "explicit",
+            original_estimated_tokens: originalEstimatedTokens,
+            estimated_tokens: estimatePmOutputTokens(Buffer.byteLength(projectedOutput, "utf8")),
+            truncated,
+            degradation_steps: truncated
+                ? [...contract.degradation_ladder]
+                : ["full"],
+            omitted_fields: truncated ? ["explanation", "collections"] : [],
+        },
+    };
+}
 //# sourceMappingURL=agent-output-contracts.js.map
-//# debugId=23b3a820-f205-506b-9507-dbd60087f62e
+//# debugId=1d338971-5a60-5b4e-b4c8-0705c8e8c98c

package/dist/sdk/cli-contracts/commander-mutation-options.js

@@ -1,6 +1,6 @@
 /** Creates commander option registration contracts using the validated operation inputs. */
 
-!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]="93ce68bd-3140-5361-a6d0-bc60c7304a29")}catch(e){}}();
+!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]="be7e506f-c48f-5dfb-9fed-ba1e74fa60ff")}catch(e){}}();
 export const CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     {
         target: "title",
@@ -969,7 +969,7 @@ export const UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
         target: "depRemove",
         keys: ["depRemove", "dep_remove"],
         option: "--dep-remove <value>",
-        description: "Remove dependencies by id or id=<id>,kind=<value>,source_kind=<value> selectors (repeatable)",
+        description: "Remove by dependency id or exact row signature (repeatable)",
         repeatable: true,
         aliasOptions: [
             {
@@ -1079,4 +1079,4 @@ export const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_
 /** Public contract for update commander repeatable option contracts, shared by SDK and presentation-layer consumers. */
 export const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter((entry) => entry.repeatable === true).map((entry) => ({ target: entry.target, keys: entry.keys }));
 //# sourceMappingURL=commander-mutation-options.js.map
-//# debugId=93ce68bd-3140-5361-a6d0-bc60c7304a29
+//# debugId=be7e506f-c48f-5dfb-9fed-ba1e74fa60ff

package/dist/sdk/cli-contracts/enum-contracts.d.ts

@@ -28,6 +28,10 @@ export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extensi
 export declare const GRAPH_SUBCOMMAND_VALUES: readonly ["ancestors", "descendants", "predecessors", "successors", "paths", "impact", "analyze", "audit", "communities", "redundancy", "dominators", "slack", "centrality", "articulation", "plan", "index"];
 /** Restricts graph subcommand values accepted by command, SDK, and MCP contracts. */
 export type GraphSubcommand = (typeof GRAPH_SUBCOMMAND_VALUES)[number];
+/** Supported values accepted by the merge subcommand contract across CLI and SDK surfaces. */
+export declare const MERGE_SUBCOMMAND_VALUES: readonly ["install", "reconcile", "report", "driver"];
+/** Restricts merge subcommand values accepted by command and SDK contracts. */
+export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];
 /** Nested lifecycle verbs flattened by SDK and MCP package actions. */
 export declare const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS: readonly ["init", "install", "uninstall", "explore", "manage", "describe", "reload", "doctor", "catalog", "adopt", "adopt-all", "activate", "deactivate"];
 /** Noun-first item lifecycle verbs flattened for SDK and MCP dispatch. */

package/dist/sdk/cli-contracts/enum-contracts.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Enum Contracts.
  */
 
-!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]="8b8b6b8e-5061-5da4-a369-eca379c0090b")}catch(e){}}();
+!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]="3935bae8-0a40-59ea-aca6-64e238d1f318")}catch(e){}}();
 import { KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_SERVICE_NAMES, KNOWN_EXTENSION_TRUST_MODES, } from "../../core/extensions/extension-types.js";
 import { PM_COMMAND_ALIAS_CONTRACTS } from "./command-aliases.js";
 /** Public contract for pm extension capability contracts, shared by SDK and presentation-layer consumers. */
@@ -124,6 +124,13 @@ export const GRAPH_SUBCOMMAND_VALUES = [
     "plan",
     "index",
 ];
+/** Supported values accepted by the merge subcommand contract across CLI and SDK surfaces. */
+export const MERGE_SUBCOMMAND_VALUES = [
+    "install",
+    "reconcile",
+    "report",
+    "driver",
+];
 /** Nested lifecycle verbs flattened by SDK and MCP package actions. */
 export const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS = [
     "init",
@@ -208,4 +215,4 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 //# sourceMappingURL=enum-contracts.js.map
-//# debugId=8b8b6b8e-5061-5da4-a369-eca379c0090b
+//# debugId=3935bae8-0a40-59ea-aca6-64e238d1f318

package/dist/sdk/cli-contracts/flag-contracts.js

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="e302f519-aa51-503b-bd1a-f3155338f133")}catch(e){}}();
+!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]="6664bc8f-e5da-5593-a2df-ac45f1cef09e")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 import { PM_POSITIONAL_ACTION_CONTRACTS, } from "./grammar-contracts.js";
@@ -894,6 +894,10 @@ export const TEST_FLAG_CONTRACTS = [
     { flag: "--shared-host-safe" },
     { flag: "--pm-context" },
     { flag: "--override-linked-pm-context" },
+    { flag: "--workspace-context" },
+    { flag: "--override-linked-workspace-context" },
+    { flag: "--allow-untrusted-linked-tests" },
+    { flag: "--acknowledge-linked-tests" },
     { flag: "--fail-on-context-mismatch" },
     { flag: "--fail-on-skipped" },
     { flag: "--fail-on-empty-test-run" },
@@ -920,6 +924,9 @@ export const TEST_ALL_FLAG_CONTRACTS = [
     { flag: "--shared-host-safe" },
     { flag: "--pm-context" },
     { flag: "--override-linked-pm-context" },
+    { flag: "--workspace-context" },
+    { flag: "--override-linked-workspace-context" },
+    { flag: "--allow-untrusted-linked-tests" },
     { flag: "--fail-on-context-mismatch" },
     { flag: "--fail-on-skipped" },
     { flag: "--fail-on-empty-test-run" },
@@ -1901,4 +1908,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=e302f519-aa51-503b-bd1a-f3155338f133
+//# debugId=6664bc8f-e5da-5593-a2df-ac45f1cef09e

package/dist/sdk/cli-contracts/flag-lexicon-contracts.js

@@ -5,7 +5,7 @@
  * per-command growth budgets.
  */
 
-!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]="6ba3d756-dcd6-59b7-92fe-ec33d294d72b")}catch(e){}}();
+!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]="8320177c-e95d-5d14-a914-4ac37230c0b9")}catch(e){}}();
 import { hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
 import { PM_COMMAND_CAPABILITY_CONTRACTS, } from "../agent-capability-contracts.js";
 import { enrichCliFlagInvocationContracts } from "../flag-invocation-contracts.js";
@@ -153,8 +153,8 @@ const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
     docs: 30,
     deps: 32,
     plan: 109,
-    test: 48,
-    "test-all": 37,
+    test: 52,
+    "test-all": 40,
     telemetry: 21,
     stats: 29,
     health: 36,
@@ -337,4 +337,4 @@ export function renderPmFlagLexiconMarkdown() {
     ].join("\n");
 }
 //# sourceMappingURL=flag-lexicon-contracts.js.map
-//# debugId=6ba3d756-dcd6-59b7-92fe-ec33d294d72b
+//# debugId=8320177c-e95d-5d14-a914-4ac37230c0b9

package/dist/sdk/cli-contracts/registration-helpers.js

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Registration Helpers.
  */
 
-!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]="8d60b13c-c58a-506f-adc9-2414dd69edef")}catch(e){}}();
+!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]="01742f33-d1e8-5684-a585-2add88ddb73c")}catch(e){}}();
 import { Option } from "commander";
 import { pathExists, refreshSearchArtifactsForMutation, shouldRunSearchRefreshInForeground, EXIT_CODE, PmCliError, printError, printResult, writeStdout, getSettingsPath, resolvePmRoot, readSettings, runActiveServiceOverride, setActiveCommandResult, } from "../runtime-primitives.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../cli-contracts.js";
@@ -259,6 +259,9 @@ function pushSharedBackgroundTestCommandArgs(args, options) {
     pushOptionalBooleanFlag(args, "--shared-host-safe", options.sharedHostSafe);
     pushOptionalValueFlag(args, "--pm-context", options.pmContext);
     pushOptionalBooleanFlag(args, "--override-linked-pm-context", options.overrideLinkedPmContext);
+    pushOptionalValueFlag(args, "--workspace-context", options.workspaceContext);
+    pushOptionalBooleanFlag(args, "--override-linked-workspace-context", options.overrideLinkedWorkspaceContext);
+    pushOptionalBooleanFlag(args, "--allow-untrusted-linked-tests", options.allowUntrustedLinkedTests);
     pushOptionalBooleanFlag(args, "--fail-on-context-mismatch", options.failOnContextMismatch);
     pushOptionalBooleanFlag(args, "--fail-on-skipped", options.failOnSkipped);
     pushOptionalBooleanFlag(args, "--fail-on-empty-test-run", options.failOnEmptyTestRun);
@@ -985,4 +988,4 @@ export const _testOnly = {
     collectMutationItemIds,
 };
 //# sourceMappingURL=registration-helpers.js.map
-//# debugId=8d60b13c-c58a-506f-adc9-2414dd69edef
+//# debugId=01742f33-d1e8-5684-a585-2add88ddb73c

package/dist/sdk/cli-contracts/runtime-contracts.d.ts

@@ -5,7 +5,7 @@
  */
 import { type GlobalOptions, type ExtensionRegistrationRegistry, type RegisteredExtensionCommandDefinition, type RegisteredExtensionFlagDefinitions, type RuntimeFieldRegistry, readSettings } from "../runtime-primitives.js";
 import { type McpToolContract } from "../../mcp/tool-definitions.js";
-import { PM_TOOL_ACTIONS, type CliFlagContract, type CommanderOptionAliasContract, type PmCommandOutputBudgetContract, type PmCommandAliasContract } from "../cli-contracts.js";
+import { PM_TOOL_ACTIONS, type CliFlagContract, type CommanderOptionAliasContract, type PmCommandOutputBudgetContract, type PmDiagnosticOutputBudgetContract, type PmCommandAliasContract } from "../cli-contracts.js";
 import { type ListCommandName, type ListProjectionMode } from "../query/list.js";
 import { type PmContextIntentContract } from "../context-intent-contracts.js";
 import { type PmReadOutputSurfaceContract } from "../read-output-contracts.js";
@@ -187,6 +187,8 @@ export interface ContractsResult {
         budget: PmCommandOutputBudgetContract;
         envelope: PmCommandOutputEnvelopeContract;
     }>;
+    /** Binding ceilings and action-preserving degradation for diagnostic families. */
+    diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[];
     /** Stable outcome vocabulary and exhaustive per-command process exit sets. */
     command_exit_contracts?: {
         vocabulary: readonly PmCommandExitOutcomeContract[];