@unbrained/pm-cli 2026.8.21 → 2026.8.22

package/dist/core/extensions/extension-hook-runtime.js

@@ -4,7 +4,7 @@
  * Implements extension runtime contracts and governance for Extension Hook Runtime.
  */
 
-!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]="ac377139-8ce2-58ad-8005-0ac907a9baed")}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]="d1dd5d4f-5f08-5e52-b109-d066f92ae3b3")}catch(e){}}();
 import { cloneCommandOptionsSnapshot, cloneContextSnapshot, cloneGlobalOptionsSnapshot, normalizeCommandName, } from "./extension-runtime-helpers.js";
 import { stableValueEquals } from "../shared/serialization.js";
 import { EXIT_CODE } from "../shared/constants.js";
@@ -480,6 +480,20 @@ function isLegacyOutputPayloadEcho(result, context, serviceContext) {
         result !== null &&
         stableValueEquals(result, serviceContext.payload));
 }
+function resolveMatchedServiceDecision(matched, decision, warnings) {
+    if (!decision.handled) {
+        return undefined;
+    }
+    if (matched.passThrough === true) {
+        warnings.push(`extension_service_pass_through_contract_violated:${matched.layer}:${matched.name}:${matched.service}`);
+        return undefined;
+    }
+    return {
+        handled: true,
+        result: decision.result,
+        warnings,
+    };
+}
 /** Implements run service override sync for the public runtime surface of this module. */
 export function runServiceOverrideSync(services, context) {
     const matches = matchingServiceOverrides(services, context.service);
@@ -499,15 +513,9 @@ export function runServiceOverrideSync(services, context) {
                 warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);
                 continue;
             }
-            const decision = resolveServiceOverrideValue(result, context);
-            if (!decision.handled) {
-                continue;
-            }
-            return {
-                handled: true,
-                result: decision.result,
-                warnings,
-            };
+            const resolved = resolveMatchedServiceDecision(matched, resolveServiceOverrideValue(result, context), warnings);
+            if (resolved)
+                return resolved;
         }
         catch {
             warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
@@ -534,15 +542,9 @@ export async function runServiceOverride(services, context) {
                 warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);
                 continue;
             }
-            const decision = resolveServiceOverrideValue(result, context);
-            if (!decision.handled) {
-                continue;
-            }
-            return {
-                handled: true,
-                result: decision.result,
-                warnings,
-            };
+            const resolved = resolveMatchedServiceDecision(matched, resolveServiceOverrideValue(result, context), warnings);
+            if (resolved)
+                return resolved;
         }
         catch {
             warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
@@ -695,4 +697,4 @@ export function runRendererOverride(renderers, context) {
     }
 }
 //# sourceMappingURL=extension-hook-runtime.js.map
-//# debugId=ac377139-8ce2-58ad-8005-0ac907a9baed
+//# debugId=d1dd5d4f-5f08-5e52-b109-d066f92ae3b3

package/dist/core/extensions/extension-types.d.ts

@@ -483,6 +483,11 @@ export type ServiceOverrideDecision = {
 };
 /** Restricts service override values accepted by command, SDK, and storage contracts. */
 export type ServiceOverride = (context: ServiceOverrideContext) => unknown | ServiceOverrideDecision;
+/** Host-enforced ownership metadata for a service override. */
+export interface ServiceOverrideOwnership {
+    /** Declare that the callback may only decline. Any handled result is ignored and diagnosed by the host. */
+    passThrough?: boolean;
+}
 /** Documents the registered extension hook payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionHook<THook> {
     /** Value that configures or reports layer for this contract. */
@@ -1187,6 +1192,8 @@ export interface RegisteredExtensionServiceOverride {
     service: ExtensionServiceName;
     /** Value that configures or reports run for this contract. */
     run: ServiceOverride;
+    /** Whether the host forbids this callback from handling the service payload. */
+    passThrough?: boolean;
 }
 /** Documents the registered extension renderer override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionRendererOverride {
@@ -1464,7 +1471,7 @@ export interface ExtensionApi {
     /** Value that configures or reports register preflight for this contract. */
     registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void;
     /** Value that configures or reports register service for this contract. */
-    registerService(service: ExtensionServiceName, override: ServiceOverride): void;
+    registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void;
     /** Value that configures or reports register flags for this contract. */
     registerFlags(targetCommand: string, flags: FlagDefinition[]): void;
     /** Value that configures or reports register item fields for this contract. */

package/dist/core/extensions/extension-types.js

@@ -1,6 +1,6 @@
 /** Public contract for known extension capabilities, shared by SDK and presentation-layer consumers. */
 
-!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]="a54549aa-2f6c-5092-a3eb-5b36ee698ea4")}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]="87454a57-b62e-560a-b66f-3c15d4a95cc2")}catch(e){}}();
 export const KNOWN_EXTENSION_CAPABILITIES = [
     "commands",
     "renderers",
@@ -100,4 +100,4 @@ export function createDefaultExtensionGovernancePolicy() {
     };
 }
 //# sourceMappingURL=extension-types.js.map
-//# debugId=a54549aa-2f6c-5092-a3eb-5b36ee698ea4
+//# debugId=87454a57-b62e-560a-b66f-3c15d4a95cc2

package/dist/core/extensions/loader.js

@@ -4,7 +4,7 @@
  * Implements extension runtime contracts and governance for Loader.
  */
 
-!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]="cccce7c1-dd08-5c9f-a74e-e639536b9a6a")}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]="10311c96-5cba-5021-a8c5-82abd6eeb6f5")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -19,6 +19,7 @@ import { KNOWN_ITEM_FIELD_TYPES, normalizeItemFieldType, suggestKnownItemFieldTy
 import { snapshotExtensionModuleGraph } from "./module-graph-snapshot.js";
 import { captureExtensionActivationRollback } from "./activation-transaction.js";
 import { collectPreflightCollisionWarnings, normalizePreflightOverride, } from "./preflight-ownership.js";
+import { normalizeServiceOverrideOwnership } from "./service-ownership.js";
 import { assertCommandDefinitionMetadataStrings } from "./command-visibility-tier.js";
 import { buildImportExportContext, resolveImportExportArtifactOutput, } from "./exporter-output-contract.js";
 import { asRegistrationRecord, assertOptionalBooleanField, assertOptionalFlagDefaultField, assertOptionalStringArrayField, assertOptionalStringField, normalizeOptionalStringArrayField, } from "./registration-validation.js";
@@ -1569,7 +1570,7 @@ class ExtensionApiRegistrar {
             ...normalized,
         });
     }
-    registerService(service, override) {
+    registerService(service, override, ownership = {}) {
         assertExtensionCapability(this.#loadedExtension, "services", "registerService");
         const normalizedService = String(service).trim().toLowerCase();
         if (!isExtensionServiceName(normalizedService)) {
@@ -1584,6 +1585,9 @@ class ExtensionApiRegistrar {
             name: this.#loadedExtension.name,
             service: normalizedService,
             run: override,
+            ...(normalizeServiceOverrideOwnership(ownership)
+                ? { passThrough: true }
+                : {}),
         });
     }
     registerRenderer(format, renderer, ownership = {}) {
@@ -2216,4 +2220,4 @@ export const _testOnlyLoader = {
     },
 };
 //# sourceMappingURL=loader.js.map
-//# debugId=cccce7c1-dd08-5c9f-a74e-e639536b9a6a
+//# debugId=10311c96-5cba-5021-a8c5-82abd6eeb6f5

package/dist/core/extensions/service-ownership.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module core/extensions/service-ownership
+ *
+ * Validates host-enforced ownership metadata for extension service overrides.
+ */
+import type { ServiceOverrideOwnership } from "./extension-types.js";
+/** Validate one service ownership declaration and return its normalized pass-through flag. */
+export declare function normalizeServiceOverrideOwnership(ownership: ServiceOverrideOwnership): boolean;

package/dist/core/extensions/service-ownership.js

@@ -0,0 +1,20 @@
+/** Validate one service ownership declaration and return its normalized pass-through flag. */
+
+!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]="a30142c8-b04d-5878-8497-c902ff299e94")}catch(e){}}();
+export function normalizeServiceOverrideOwnership(ownership) {
+    if (ownership === null ||
+        typeof ownership !== "object" ||
+        Array.isArray(ownership)) {
+        throw new TypeError("registerService ownership must be an object");
+    }
+    if (Reflect.ownKeys(ownership).some((key) => key !== "passThrough")) {
+        throw new TypeError("registerService ownership supports only passThrough");
+    }
+    if (ownership.passThrough !== undefined &&
+        typeof ownership.passThrough !== "boolean") {
+        throw new TypeError("registerService ownership.passThrough must be a boolean when provided");
+    }
+    return ownership.passThrough === true;
+}
+//# sourceMappingURL=service-ownership.js.map
+//# debugId=a30142c8-b04d-5878-8497-c902ff299e94

package/dist/core/item/id.js

@@ -4,7 +4,7 @@
  * Defines item parsing, formatting, and lifecycle helpers for Id.
  */
 
-!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]="50a277b9-d530-5aa0-8bd0-8eb0d36911e5")}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]="6b3f1585-ab12-57ca-80eb-d3cebc384c52")}catch(e){}}();
 import crypto from "node:crypto";
 import path from "node:path";
 import { TYPE_TO_FOLDER } from "../shared/constants.js";
@@ -12,10 +12,25 @@ import { pathExists } from "../fs/fs-utils.js";
 import { nextReproducibleToken } from "../reproducibility/context.js";
 /** Implements normalize prefix for the public runtime surface of this module. */
 export function normalizePrefix(input) {
-    const normalized = (input ?? "").trim().toLowerCase();
-    if (!normalized)
+    const normalized = [];
+    let separatorPending = false;
+    for (const character of (input ?? "").toLowerCase()) {
+        const codePoint = character.charCodeAt(0);
+        const isAsciiDigit = codePoint >= 48 && codePoint <= 57;
+        const isAsciiLetter = codePoint >= 97 && codePoint <= 122;
+        if (!isAsciiDigit && !isAsciiLetter) {
+            separatorPending = normalized.length > 0;
+            continue;
+        }
+        if (separatorPending) {
+            normalized.push("-");
+            separatorPending = false;
+        }
+        normalized.push(character);
+    }
+    if (normalized.length === 0)
         return "pm-";
-    return normalized.endsWith("-") ? normalized : `${normalized}-`;
+    return `${normalized.join("")}-`;
 }
 /** Implements normalize raw item id for the public runtime surface of this module. */
 export function normalizeRawItemId(input) {
@@ -91,4 +106,4 @@ export async function generateItemId(pmRoot, prefix, options = {}) {
     throw new Error(`Unable to generate unique id after ${attempts} attempts`);
 }
 //# sourceMappingURL=id.js.map
-//# debugId=50a277b9-d530-5aa0-8bd0-8eb0d36911e5
+//# debugId=6b3f1585-ab12-57ca-80eb-d3cebc384c52

package/dist/core/item/item-format.js

@@ -4,7 +4,7 @@
  * Defines item parsing, formatting, and lifecycle helpers for Item Format.
  */
 
-!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]="eaf0e260-a864-57cf-b23b-aac4f9151d8e")}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]="5eac19ec-235e-5e6f-8ae7-4725f99c9d7f")}catch(e){}}();
 import { encode as encodeToon } from "@toon-format/toon";
 import { isDeepStrictEqual } from "node:util";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, PLAN_STEP_STATUS_VALUES, RECURRENCE_FREQUENCY_VALUES, RECURRENCE_WEEKDAY_VALUES, STATUS_VALUES, weekdayOrderIndex, } from "../../types/index.js";
@@ -601,6 +601,30 @@ function normalizeTestRunMeasurements(value) {
         .slice(0, 32);
     return deduplicated.length > 0 ? deduplicated : undefined;
 }
+/** Normalize and bound command/context provenance retained for a test run. */
+function normalizeTestRunExecutions(values) {
+    if (!Array.isArray(values))
+        return undefined;
+    const executions = values
+        .filter((execution) => execution &&
+        typeof execution.command === "string" &&
+        execution.command.trim().length > 0)
+        .slice(0, 32)
+        .map((execution) => ({
+        command: execution.command.trim(),
+        requested_pm_context_mode: execution.requested_pm_context_mode === "schema" ||
+            execution.requested_pm_context_mode === "tracker" ||
+            execution.requested_pm_context_mode === "auto"
+            ? execution.requested_pm_context_mode
+            : undefined,
+        pm_context_mode: execution.pm_context_mode === "schema" ||
+            execution.pm_context_mode === "tracker" ||
+            execution.pm_context_mode === "auto"
+            ? execution.pm_context_mode
+            : undefined,
+    }));
+    return executions.length > 0 ? executions : undefined;
+}
 function normalizeTestRunSummary(value) {
     const runId = typeof value.run_id === "string" ? value.run_id.trim() : "";
     const kind = value.kind === "test" || value.kind === "test-all" ? value.kind : "test";
@@ -623,6 +647,7 @@ function normalizeTestRunSummary(value) {
         linked_tests: normalizeNonNegativeInteger(value.linked_tests),
         fail_on_skipped_triggered: value.fail_on_skipped_triggered === true ? true : undefined,
         measurements: normalizeTestRunMeasurements(value.measurements),
+        executions: normalizeTestRunExecutions(value.executions),
     };
     deleteUndefinedFields(summary);
     return summary;
@@ -1393,4 +1418,4 @@ export const _testOnlyItemFormat = {
     sortTests,
 };
 //# sourceMappingURL=item-format.js.map
-//# debugId=eaf0e260-a864-57cf-b23b-aac4f9151d8e
+//# debugId=5eac19ec-235e-5e6f-8ae7-4725f99c9d7f

package/dist/core/shared/errors.d.ts

@@ -108,12 +108,16 @@ export interface PmCliErrorContext {
         id: string;
         kind?: string;
         source_kind?: string;
+        author?: string;
+        created_at?: string;
     }>;
     /** Compact stored dependency identities available when a removal failed. */
     available_dependencies?: Array<{
         id: string;
         kind: string;
         source_kind?: string;
+        author?: string;
+        created_at?: string;
     }>;
     /** Exact verifier findings that caused an integrity-sensitive operation to refuse. */
     verification_errors?: string[];

package/dist/core/shared/errors.js

@@ -1,6 +1,6 @@
 /** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */
 
-!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]="e8873345-5824-5832-9fa3-79719ddc6b58")}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]="922e2e27-1499-5466-98e4-322d0d742e40")}catch(e){}}();
 export class PmCliError extends Error {
     /** Value that configures or reports exit code for this contract. */
     exitCode;
@@ -18,4 +18,4 @@ export class PmCliError extends Error {
     }
 }
 //# sourceMappingURL=errors.js.map
-//# debugId=e8873345-5824-5832-9fa3-79719ddc6b58
+//# debugId=922e2e27-1499-5466-98e4-322d0d742e40

package/dist/sdk/agent/refusal-reachability.d.ts

@@ -37,7 +37,7 @@ export type PmRecoveryReferenceKind = (typeof PM_RECOVERY_REFERENCE_KINDS)[numbe
 /** Behavioral promise attached to a recovery reference. */
 export type PmRecoveryReferenceSemantics = "recovery" | "replacement" | "behavior_preserving";
 /** Literal envelope fields recognized as recovery-reference producers. */
-export declare const PM_RECOVERY_REFERENCE_FIELDS: readonly ("restore_with" | "migration_hint" | "migration_hints" | "suggested_retry" | "next_best_command" | "fallback_candidates" | "examples" | "next_steps" | "suggested_next_steps" | "candidate_commands" | "example" | "candidate_command" | "next_step" | "retry_command")[];
+export declare const PM_RECOVERY_REFERENCE_FIELDS: readonly ("suggested_retry" | "next_best_command" | "candidate_commands" | "next_steps" | "examples" | "restore_with" | "migration_hint" | "migration_hints" | "fallback_candidates" | "suggested_next_steps" | "example" | "candidate_command" | "next_step" | "retry_command")[];
 /** One source file supplied to the producer-census analyzer. */
 export interface PmRecoveryProducerSource {
     /** Repository-relative source path. */

package/dist/sdk/authoring.d.ts

@@ -15,4 +15,4 @@ export { planProfileApplication, type ProfileApplicationPlan, type ProfileChange
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "../core/extensions/capability-usage.js";
 export { renderExtensionSurfaceMarkdown, type ExtensionSurfaceMarkdownOptions, } from "../core/extensions/activation-summary-markdown.js";
 export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, ServiceOverrideOwnership, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";

package/dist/sdk/authoring.js

@@ -4,7 +4,7 @@
  * Provides the focused extension and package authoring surface.
  */
 
-!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]="6260572c-1496-58ef-9377-0825f4183bc6")}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]="bca95ba2-258c-5be2-8428-dcb8dbc87ef0")}catch(e){}}();
 export * from "./compose.js";
 export * from "./define.js";
 export * from "./extension-contracts.js";
@@ -18,4 +18,4 @@ export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabil
 export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
 export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
 //# sourceMappingURL=authoring.js.map
-//# debugId=6260572c-1496-58ef-9377-0825f4183bc6
+//# debugId=bca95ba2-258c-5be2-8428-dcb8dbc87ef0

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;