@unbrained/pm-cli 2026.8.21 → 2026.8.22

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]="b3f5a4bc-d853-530e-8f5e-d682d8b93c9d")}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,289 @@ 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] = 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=b3f5a4bc-d853-530e-8f5e-d682d8b93c9d

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/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[];

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

@@ -4,10 +4,10 @@
  * Implements the pm contracts command surface and its agent-facing runtime behavior.
  */
 
-!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]="b07d8f62-6c75-52fd-9956-52cec211303c")}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]="e8f1efca-4e83-570f-8c33-96f0405035b0")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
-import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
+import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
 import { PM_POSITIONAL_ACTION_FLAG_CONTRACTS } from "./flag-contracts.js";
 import { GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES, GOVERNANCE_CREATE_MODE_DEFAULT_VALUES, GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES, GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES, } from "../../types.js";
 import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, } from "../query/list.js";
@@ -2023,6 +2023,7 @@ export async function runContracts(options, global) {
         result.error_codes = PM_ERROR_CODE_CATALOG;
         result.command_output_contracts =
             buildCommandOutputContracts(outputCommands);
+        result.diagnostic_output_contracts = PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS;
         result.command_exit_contracts = {
             vocabulary: PM_COMMAND_EXIT_OUTCOME_CONTRACTS,
             command_sets: buildCommandExitContractGroups(outputCommands),
@@ -2064,4 +2065,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=b07d8f62-6c75-52fd-9956-52cec211303c
+//# debugId=e8f1efca-4e83-570f-8c33-96f0405035b0

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

@@ -25,4 +25,4 @@ export type { PmActionSchemaContract } from "./cli-contracts/tool-schema.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export type { PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, } from "./cli-contracts/tool-schema.js";
 export { analyzeSdkCliParameterCompleteness, type SdkCliActionParameterCoverage, type SdkCliCompletenessContractSource, type SdkCliParameterCoverageEntry, type SdkCliParameterDisposition, } from "./cli-contracts/completeness.js";
-export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, resolvePmCommandOutputBudget, type PmCommandOutputBudgetContract, type PmOutputBudgetClass, type PmOutputDegradationStep, } from "./cli-contracts/agent-output-contracts.js";
+export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, resolvePmDiagnosticOutputBudget, resolvePmCommandOutputBudget, type PmCommandOutputBudgetContract, type PmDiagnosticDegradationStep, type PmDiagnosticOutputBudgetContract, type PmDiagnosticOutputClass, type PmDiagnosticOutputReceipt, type PmOutputBudgetClass, type PmOutputDegradationStep, type PmProjectedDiagnostic, type PmProjectedTextDiagnostic, } from "./cli-contracts/agent-output-contracts.js";

package/dist/sdk/cli-contracts.js

@@ -1,5 +1,5 @@
 
-!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]="b6cdec8f-ca7d-58a2-9d67-cf6c1eb91324")}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]="8f665958-197a-5f20-8904-0a59a623f30f")}catch(e){}}();
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "./cli-contracts/command-aliases.js";
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
@@ -13,6 +13,6 @@ export { PM_POSITIONAL_ACTION_CONTRACTS, } from "./cli-contracts/grammar-contrac
 export { withFlagAliasMetadata, compactFlagAliasContracts, resolvePmPositionalActionFlagContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts/completeness.js";
-export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
+export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, resolvePmDiagnosticOutputBudget, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=b6cdec8f-ca7d-58a2-9d67-cf6c1eb91324
+//# debugId=8f665958-197a-5f20-8904-0a59a623f30f

package/dist/sdk/extension/install-sources.d.ts

@@ -91,7 +91,7 @@ export declare function runGitCommand(args: string[], execRunner?: typeof execFi
 export declare function resolveNpmCommandName(platform?: NodeJS.Platform): "npm" | "npm.cmd";
 /** Implements should run npm command in shell for the public runtime surface of this module. */
 export declare function shouldRunNpmCommandInShell(platform?: NodeJS.Platform): boolean;
-declare function runNpmCommand(args: string[], cwd?: string, execRunner?: typeof execFileAsync, platform?: NodeJS.Platform): Promise<string>;
+declare function runNpmCommand(args: string[], cwd?: string, execRunner?: typeof execFileAsync, platform?: NodeJS.Platform, environment?: NodeJS.ProcessEnv): Promise<string>;
 declare function npmPackageNameFromSpec(spec: string): string;
 /** Implements check whether npm not found error for the public runtime surface of this module. */
 export declare function isNpmNotFoundError(error: unknown): boolean;

package/dist/sdk/extension/install-sources.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Install Sources.
  */
 
-!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]="8994c8e2-8e3a-5e00-a3ca-7bd553c045d7")}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]="89b84412-aa15-5868-95b3-c8d898b1f480")}catch(e){}}();
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -200,12 +200,15 @@ export function resolveNpmCommandName(platform = process.platform) {
 export function shouldRunNpmCommandInShell(platform = process.platform) {
     return platform === "win32";
 }
-async function runNpmCommand(args, cwd, execRunner = execFileAsync, platform = process.platform) {
+async function runNpmCommand(args, cwd, execRunner = execFileAsync, platform = process.platform, environment = process.env) {
     const npmCommand = resolveNpmCommandName(platform);
+    const env = Object.fromEntries(Object.entries(environment).filter(([key]) => key.toLowerCase() !== "npm_config_allow_scripts"));
+    env.NPM_CONFIG_ALLOW_SCRIPTS = "";
     try {
         const result = await execRunner(npmCommand, args, {
             cwd,
             encoding: "utf8",
+            env,
             shell: shouldRunNpmCommandInShell(platform),
         });
         return (result.stdout ?? "").trim();
@@ -959,4 +962,4 @@ export const _testOnlyInstallSources = {
     runNpmCommand,
 };
 //# sourceMappingURL=install-sources.js.map
-//# debugId=8994c8e2-8e3a-5e00-a3ca-7bd553c045d7
+//# debugId=89b84412-aa15-5868-95b3-c8d898b1f480

package/dist/sdk/extension/output-ownership.d.ts

@@ -4,6 +4,7 @@ interface OutputActivationSummary {
             service: string;
             layer: string;
             name: string;
+            passThrough?: boolean;
         }>;
     };
     renderers: {

package/dist/sdk/extension/output-ownership.js

@@ -4,7 +4,7 @@
  * Classifies output overrides against manifest-declared command ownership.
  */
 
-!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]="0dc7b063-dc72-595f-8e40-8a06f9db69e1")}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]="e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998")}catch(e){}}();
 import { normalizeExtensionNameForMatch } from "./shared.js";
 /** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
 export function collectGlobalOutputOverrideDoctorWarnings(activationResult, loadResult) {
@@ -13,6 +13,7 @@ export function collectGlobalOutputOverrideDoctorWarnings(activationResult, load
         : []));
     const serviceWarnings = activationResult.services.overrides
         .filter((entry) => entry.service === "output_format")
+        .filter((entry) => entry.passThrough !== true)
         .filter((entry) => !commandScopedOwners.has(`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`))
         .map((entry) => `extension_output_service_override_global:${entry.service}:${entry.layer}:${entry.name}`);
     const rendererWarnings = activationResult.renderers.overrides
@@ -22,4 +23,4 @@ export function collectGlobalOutputOverrideDoctorWarnings(activationResult, load
     return [...new Set([...serviceWarnings, ...rendererWarnings])].sort((left, right) => left.localeCompare(right));
 }
 //# sourceMappingURL=output-ownership.js.map
-//# debugId=0dc7b063-dc72-595f-8e40-8a06f9db69e1
+//# debugId=e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -1,6 +1,6 @@
 /** Generated partition 1 of the exhaustive error-code catalog. */
 
-!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]="4959a1ef-29e6-50ae-aaf8-fe078001bff6")}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]="2903ebb9-541a-5636-ae3c-e996d3f0cec4")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -962,6 +962,42 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "github_source_entry_unbuilt",
         aliases: [],
     },
+    {
+        code: "hierarchy_cardinality_created",
+        meaning: "Hierarchy cardinality created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_cardinality_created",
+        aliases: [],
+    },
+    {
+        code: "hierarchy_cycle_created",
+        meaning: "Hierarchy cycle created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_cycle_created",
+        aliases: [],
+    },
+    {
+        code: "hierarchy_parent_divergence_created",
+        meaning: "Hierarchy parent divergence created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_parent_divergence_created",
+        aliases: [],
+    },
     {
         code: "history_author_acknowledge_plan_conflict",
         meaning: "History author acknowledge plan conflict condition.",
@@ -1932,18 +1968,6 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "missing_budget",
         aliases: [],
     },
-    {
-        code: "missing_cli_flag",
-        meaning: "Missing cli flag condition.",
-        stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
-        recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
-        emitting_commands: ["*"],
-        canonical_code: "missing_cli_flag",
-        aliases: [],
-    },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=4959a1ef-29e6-50ae-aaf8-fe078001bff6
+//# debugId=2903ebb9-541a-5636-ae3c-e996d3f0cec4

package/dist/sdk/generated/generated-error-code-catalog-part-2.js

@@ -1,7 +1,19 @@
 /** Generated partition 2 of the exhaustive error-code catalog. */
 
-!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]="d7f4f4f0-d044-5216-b2c4-d76b4d8854a9")}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]="4f1bb829-c6be-5a3e-90f2-4b0062aa2dac")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
+    {
+        code: "missing_cli_flag",
+        meaning: "Missing cli flag condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_cli_flag",
+        aliases: [],
+    },
     {
         code: "missing_destination",
         meaning: "Missing destination condition.",
@@ -1978,4 +1990,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=d7f4f4f0-d044-5216-b2c4-d76b4d8854a9
+//# debugId=4f1bb829-c6be-5a3e-90f2-4b0062aa2dac