@unbrained/pm-cli 2026.8.21 → 2026.8.23

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1755,
+    "covered_symbols": 1793,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1756
+    "required_symbols": 1794
   },
   "breaking_acknowledgements": [
     {
@@ -967,6 +967,147 @@
       ],
       "package_version": "2026.8.20",
       "reason": "Expose exact prose-gap partitions on measurement and gate receipts while keeping fields optional for existing SDK consumers"
+    },
+    {
+      "changes": [
+        "signature ./sdk:GraphAnalyzeResult",
+        "signature ./sdk:PmCliErrorContext",
+        "signature ./sdk/graph:GraphAnalyzeResult"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Expose optional graph hierarchy analytics and exact dependency-removal provenance; the snapshot conservatively classifies additive interface fields as signature changes."
+    },
+    {
+      "changes": [
+        "signature ./sdk:GraphAuditResult",
+        "signature ./sdk/graph:GraphAuditResult"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Remove the duplicate audit finding census from summary profiles while preserving it in detailed output and the top-level summary census."
+    },
+    {
+      "changes": [
+        "signature ./sdk:_testOnlyHealthCommand",
+        "signature ./sdk/governance:_testOnlyHealthCommand"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Extend the existing test-only health diagnostics surface with hierarchy warning rendering coverage."
+    },
+    {
+      "changes": [
+        "signature ./sdk:GraphHierarchySummary",
+        "signature ./sdk/graph:GraphHierarchySummary"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Add optional active and terminal-only hierarchy defect counts without removing or narrowing existing GraphHierarchySummary fields"
+    },
+    {
+      "changes": [
+        "signature ./sdk:WorkspaceRelationshipAssembly",
+        "signature ./sdk/graph:WorkspaceRelationshipAssembly"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Additive optional hierarchyIntegrity field preserves analysis across spread-copied assemblies; existing consumers and constructors remain source-compatible."
+    },
+    {
+      "changes": [
+        "signature ./sdk:duplicates",
+        "signature ./sdk:ExtensionApi",
+        "signature ./sdk:PM_COMPLETE_LIST_FINDING_CODES",
+        "signature ./sdk:PM_READ_OUTPUT_SURFACES",
+        "signature ./sdk:PmClient",
+        "signature ./sdk:PmCompleteListResult",
+        "signature ./sdk:RegisteredExtensionServiceOverride",
+        "signature ./sdk/authoring:ExtensionApi",
+        "signature ./sdk/authoring:RegisteredExtensionServiceOverride",
+        "signature ./sdk/contracts:PM_READ_OUTPUT_SURFACES",
+        "signature ./sdk/core:PmClient",
+        "signature ./sdk/core:PmCompleteListResult",
+        "signature ./sdk/query:PM_COMPLETE_LIST_FINDING_CODES",
+        "signature ./sdk/query:PmCompleteListResult",
+        "signature ./sdk/runtime:duplicates",
+        "signature ./sdk/runtime:PmClient",
+        "signature ./sdk/runtime:PmCompleteListResult"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Fail closed complete-list certification and add typed duplicates/service pass-through contracts"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmReadOutputReceipt",
+        "signature ./sdk:PmResolvedReadOutputDimensions",
+        "signature ./sdk/contracts:PmReadOutputReceipt",
+        "signature ./sdk/contracts:PmResolvedReadOutputDimensions",
+        "signature ./sdk/core:PmReadOutputReceipt"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Add optional canonical read-output provenance to typed receipts while preserving all existing fields and behavior."
+    },
+    {
+      "changes": [
+        "signature ./sdk:ContractsResult",
+        "signature ./sdk/runtime:ContractsResult"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Add optional diagnostic_output_contracts discovery metadata and additive diagnostic projection exports"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmDiagnosticOutputReceipt",
+        "signature ./sdk:PmProjectedDiagnostic",
+        "signature ./sdk/contracts:PmDiagnosticOutputReceipt",
+        "signature ./sdk/contracts:PmProjectedDiagnostic"
+      ],
+      "package_version": "2026.8.21",
+      "reason": "Correct projected diagnostic types to model deterministic field omission and disclose bounded omission overflow."
+    },
+    {
+      "changes": [
+        "signature ./sdk:ConfigResult",
+        "signature ./sdk:PmReadOutputTruncationDisclosure",
+        "signature ./sdk/contracts:PmReadOutputTruncationDisclosure",
+        "signature ./sdk/runtime:ConfigResult"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "pm-c0lrdm pm-yds9dt pm-xam9bt: add adapter/config receipts and widen incorrect fixed recovery-budget literals to measured number or explicit null/unbounded"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTest",
+        "signature ./sdk:PmSettings",
+        "signature ./sdk:TestAllCommandOptions",
+        "signature ./sdk:TestCommandOptions",
+        "signature ./sdk:TestRunResult",
+        "signature ./sdk/core:PmSettings",
+        "signature ./sdk/runtime:LinkedTest",
+        "signature ./sdk/runtime:PmSettings"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Extend linked-test trust and workspace-context contracts across SDK entrypoints"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Extend linked-test trust and workspace-context contracts across SDK entrypoints"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTestFailureCategory",
+        "signature ./sdk:LinkedTestTrustDecision"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Add explicit trust-refusal and invalid-provenance classifications required by linked-test execution safety"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTest",
+        "signature ./sdk/runtime:LinkedTest"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Additive optional provenance_invalid marker preserves fail-closed storage state without widening the existing provenance source_kind union; two trust helpers are newly exported for CLI-consumer parity."
     }
   ],
   "entrypoints": {
@@ -1019,7 +1160,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "_testOnlyHealthCommand",
-          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildHealthFindings: typeof buildHealthFindings; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
+          "signature": "{ buildHierarchyIntegrityWarnings: typeof buildHierarchyIntegrityWarnings; buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildHealthFindings: typeof buildHealthFindings; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
         },
         {
           "classification": "advanced_export",
@@ -1081,6 +1222,12 @@
           "name": "acceptAssuranceProposals",
           "signature": "(pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "acknowledgeLinkedTests",
+          "signature": "(pmRoot: string, tests: LinkedTest[], acknowledgedAt: string) => Promise<{ acknowledged: number; fingerprints: string[]; }> | calls: (pmRoot: string, tests: LinkedTest[], acknowledgedAt: string) => Promise<{ acknowledged: number; fingerprints: string[]; }>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1249,6 +1396,42 @@
           "name": "AgentEpisodeIdentity",
           "signature": "export interface AgentEpisodeIdentity { id: string; label?: string; parent_id?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabulary",
+          "signature": "export interface AgentIdentityVocabulary { version: number; aliases: Record<string, string>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationInput",
+          "signature": "export interface AgentIdentityVocabularyMutationInput { operation: AgentIdentityVocabularyOperation; legacy_author?: string; canonical_harness?: string; observed_authors?: readonly string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationPlan",
+          "signature": "export interface AgentIdentityVocabularyMutationPlan { vocabulary: AgentIdentityVocabulary; preview: AgentIdentityVocabularyMutationPreview; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationPreview",
+          "signature": "export interface AgentIdentityVocabularyMutationPreview { operation: AgentIdentityVocabularyOperation; changed: boolean; version_before: number; version_after: number; alias_count: number; residual_author_count: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AgentIdentityVocabularyOperation",
+          "signature": "export type AgentIdentityVocabularyOperation = \"add\" | \"remove\" | \"clear\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularySummary",
+          "signature": "export interface AgentIdentityVocabularySummary { version: number; alias_count: number; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1273,6 +1456,12 @@
           "name": "AgentProvenanceAbsenceReason",
           "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceAdapter",
+          "signature": "export interface AgentProvenanceAdapter { contract_version: 1; adapter_version: string; priority: number; harness: string; descriptor: HarnessSignalDescriptor; supported_dimensions: readonly string[]; native_sources: readonly (\"environment\" | \"argv\" | \"mcp_client\" | \"session_file\")[]; probe_policy: { max_bytes: number; max_lines: number; network_access: false; subprocess_access: false; }; normalization: { model_family: \"v1\"; effort: \"v1\"; preserve_raw: true; }; confidence: \"high\" | \"medium\" | \"low\"; waivers?: Readonly<Record<string, string>>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1375,6 +1564,12 @@
           "name": "analyzeGraphImpact",
           "signature": "(graph: RelationshipGraph, root: string, options?: RelationshipImpactOptions) => RelationshipImpactAnalysis | calls: (graph: RelationshipGraph, root: string, options?: RelationshipImpactOptions) => RelationshipImpactAnalysis"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "analyzeHierarchyIntegrity",
+          "signature": "(items: readonly HierarchyIntegrityItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => HierarchyIntegrityAnalysis | calls: (items: readonly HierarchyIntegrityItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => HierarchyIntegrityAnalysis"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1693,6 +1888,12 @@
           "name": "assertExtensionPreflight",
           "signature": "(blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions) => ExtensionPreflightReport | calls: (blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions) => ExtensionPreflightReport"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "assertHierarchyMutationAllowed",
+          "signature": "(beforeItems: readonly HierarchyIntegrityItem[], afterItems: readonly HierarchyIntegrityItem[], changedItemId: string, isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => void | calls: (beforeItems: readonly HierarchyIntegrityItem[], afterItems: readonly HierarchyIntegrityItem[], changedItemId: string, isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => void"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2281,6 +2482,18 @@
           "name": "attachContextIntentReceipt",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; } | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "attachLinkedTestMutationProvenance",
+          "signature": "(tests: LinkedTest[] | undefined, author: string, createdAt: string) => Promise<LinkedTest[] | undefined> | calls: (tests: LinkedTest[] | undefined, author: string, createdAt: string) => Promise<LinkedTest[] | undefined>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "attachLinkedTestProvenance",
+          "signature": "(tests: LinkedTest[] | undefined, author: string, createdAt: string, sourceRef: string | undefined) => LinkedTest[] | undefined | calls: (tests: LinkedTest[] | undefined, author: string, createdAt: string, sourceRef: string | undefined) => LinkedTest[] | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2623,6 +2836,12 @@
           "name": "buildWorkspaceMemorySnapshot",
           "signature": "(items: readonly ItemMetadata[], options: { statusRegistry: RuntimeStatusRegistry; sourceCursor: string; now: string; }) => WorkspaceMemorySnapshot | calls: (items: readonly ItemMetadata[], options: { statusRegistry: RuntimeStatusRegistry; sourceCursor: string; now: string; }) => WorkspaceMemorySnapshot"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_AGENT_PROVENANCE_ADAPTERS",
+          "signature": "readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -3049,6 +3268,12 @@
           "name": "collectErrorCauseCodes",
           "signature": "(error: unknown) => string | calls: (error: unknown) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectHierarchyRelations",
+          "signature": "(items: readonly HierarchyIntegrityItem[], registry?: RelationshipKindRegistry) => HierarchyRelation[] | calls: (items: readonly HierarchyIntegrityItem[], registry?: RelationshipKindRegistry) => HierarchyRelation[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3431,7 +3656,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ConfigResult",
-          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
+          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; identity_vocabulary?: AgentIdentityVocabularySummary; vocabulary_mutation?: AgentIdentityVocabularyMutationPreview; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
         },
         {
           "classification": "advanced_export",
@@ -3803,7 +4028,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -4057,6 +4282,12 @@
           "name": "createRelationshipKindRegistry",
           "signature": "() => RelationshipKindRegistry | calls: () => RelationshipKindRegistry"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createReproducibleProcessRunner",
+          "signature": "(environment: ReproducibleProcessEnvironment) => ReproducibleProcessRunner | calls: (environment: ReproducibleProcessEnvironment) => ReproducibleProcessRunner"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -4853,7 +5084,7 @@
           "classification": "advanced_export",
           "kind": "function",
           "name": "duplicates",
-          "signature": "(options?: DuplicatesCommandOptions, clientOptions?: PmClientOptions) => Promise<DuplicatesResult> | calls: (options?: DuplicatesCommandOptions, clientOptions?: PmClientOptions) => Promise<DuplicatesResult>"
+          "signature": "<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<DuplicatesResult, Options> | calls: <Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<DuplicatesResult, Options>"
         },
         {
           "classification": "contract_data",
@@ -5381,7 +5612,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionApi",
-          "signature": "export interface ExtensionApi { readonly extension: ExtensionSelfIdentity; registerCommand(command: string, override: CommandOverride): void; registerCommand(definition: CommandDefinition): void; registerParser(command: string, override: ParserOverride): void; registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void; registerService(service: ExtensionServiceName, override: ServiceOverride): void; registerFlags(targetCommand: string, flags: FlagDefinition[]): void; registerItemFields(fields: SchemaFieldDefinition[]): void; registerItemTypes(types: SchemaItemTypeDefinition[]): void; registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void; registerMigration(definition: SchemaMigrationDefinition): void; registerProfile(profile: ProjectProfileRegistrationInput): void; registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void; registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void; registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void; registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void; hooks: { beforeCommand(hook: BeforeCommandHook): void; beforeMutation(hook: BeforeMutationHook): void; afterCommand(hook: AfterCommandHook): void; onWrite(hook: OnWriteHook): void; onRead(hook: OnReadHook): void; onIndex(hook: OnIndexHook): void; }; }"
+          "signature": "export interface ExtensionApi { readonly extension: ExtensionSelfIdentity; registerCommand(command: string, override: CommandOverride): void; registerCommand(definition: CommandDefinition): void; registerParser(command: string, override: ParserOverride): void; registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void; registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void; registerFlags(targetCommand: string, flags: FlagDefinition[]): void; registerItemFields(fields: SchemaFieldDefinition[]): void; registerItemTypes(types: SchemaItemTypeDefinition[]): void; registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void; registerMigration(definition: SchemaMigrationDefinition): void; registerProfile(profile: ProjectProfileRegistrationInput): void; registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void; registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void; registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void; registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void; hooks: { beforeCommand(hook: BeforeCommandHook): void; beforeMutation(hook: BeforeMutationHook): void; afterCommand(hook: AfterCommandHook): void; onWrite(hook: OnWriteHook): void; onRead(hook: OnReadHook): void; onIndex(hook: OnIndexHook): void; }; }"
         },
         {
           "classification": "supported",
@@ -6097,6 +6328,12 @@
           "name": "formatDuplicateEdgeGroup",
           "signature": "(group: DuplicateRelationshipEdgeGroup) => string | calls: (group: DuplicateRelationshipEdgeGroup) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "formatHierarchyRelation",
+          "signature": "(relation: HierarchyRelation) => string | calls: (relation: HierarchyRelation) => string"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -6377,7 +6614,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAnalyzeResult",
-          "signature": "export interface GraphAnalyzeResult { subcommand: \"analyze\"; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; sample_limit: number; execution: GraphExecutionSummary; knowledge: GraphKnowledgeSummary; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAnalyzeResult { subcommand: \"analyze\"; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; sample_limit: number; execution: GraphExecutionSummary; knowledge: GraphKnowledgeSummary; hierarchy?: GraphHierarchySummary; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -6395,7 +6632,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAuditResult",
-          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: Omit<RelationshipAuditReport[\"profile\"], \"finding_subjects_by_code\"> & Partial<Pick<RelationshipAuditReport[\"profile\"], \"finding_subjects_by_code\">>; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -6481,6 +6718,12 @@
           "name": "GraphExecutionSummary",
           "signature": "export interface GraphExecutionSummary { acyclic: boolean; ordered_node_count: number; layer_count: number; frontier_count: number; frontier?: string[]; critical_path_length: number; critical_path?: string[]; cycle_count: number; cycles?: string[][]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "GraphHierarchySummary",
+          "signature": "export interface GraphHierarchySummary { acyclic: boolean; relation_count: number; cycle_count: number; active_cycle_count?: number; legacy_cycle_count?: number; cardinality_violation_count: number; active_cardinality_violation_count?: number; legacy_cardinality_violation_count?: number; parent_divergence_count: number; active_parent_divergence_count?: number; legacy_parent_divergence_count?: number; cycles?: string[][]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -6721,24 +6964,72 @@
           "name": "hierarchyAncestors",
           "signature": "(graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]> | calls: (graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyCardinalityViolation",
+          "signature": "export interface HierarchyCardinalityViolation { child_id: string; parent_ids: string[]; legacy_terminal: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "HierarchyChild",
           "signature": "export interface HierarchyChild { id: string; title: string; type: string; status: ItemStatus; children_total: number; children_closed: number; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyCycle",
+          "signature": "export interface HierarchyCycle { item_ids: string[]; legacy_terminal: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "hierarchyDescendants",
           "signature": "(graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]> | calls: (graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyIntegrityAnalysis",
+          "signature": "export interface HierarchyIntegrityAnalysis { relations: HierarchyRelation[]; cycles: HierarchyCycle[]; cardinality_violations: HierarchyCardinalityViolation[]; divergences: HierarchyParentDivergence[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyIntegrityItem",
+          "signature": "export interface HierarchyIntegrityItem { id: string; status: ItemStatus; parent?: string; dependencies?: Dependency[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "HierarchyNode",
           "signature": "export interface HierarchyNode { id: string; title: string; type: string; status: ItemStatus; children_total: number; children_closed: number; children_open: number; children_in_progress: number; children_blocked: number; children: HierarchyChild[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyParentDivergence",
+          "signature": "export interface HierarchyParentDivergence { child_id: string; scalar_parent_id: string; dependency_parent_ids: string[]; legacy_terminal: boolean; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyRelation",
+          "signature": "export interface HierarchyRelation { parent_id: string; child_id: string; source: HierarchyRelationSource; kind: string; holder_id: string; target_id?: string; child_cardinality: \"one\" | \"many\"; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyRelationIndexes",
+          "signature": "export interface HierarchyRelationIndexes { parents_by_child: ReadonlyMap<string, readonly string[]>; children_by_parent: ReadonlyMap<string, readonly string[]>; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "HierarchyRelationSource",
+          "signature": "export type HierarchyRelationSource = \"scalar_parent\" | \"dependency\";"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -7093,6 +7384,12 @@
           "name": "IndexedLinkedFileMatch",
           "signature": "export interface IndexedLinkedFileMatch { item: ItemMetadata; files: LinkedFile[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "indexHierarchyRelations",
+          "signature": "(relations: readonly HierarchyRelation[]) => HierarchyRelationIndexes | calls: (relations: readonly HierarchyRelation[]) => HierarchyRelationIndexes"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7645,6 +7942,12 @@
           "name": "LINKED_TEST_PROTECTED_ENV_KEYS",
           "signature": "Set<string>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES",
+          "signature": "readonly [\"source\", \"isolated\", \"snapshot\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -7697,13 +8000,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "LinkedTest",
-          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
+          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; workspace_context_mode?: \"source\" | \"isolated\" | \"snapshot\"; provenance?: LinkedTestProvenance; provenance_invalid?: true; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
         },
         {
           "classification": "advanced_export",
           "kind": "type",
           "name": "LinkedTestFailureCategory",
-          "signature": "export type LinkedTestFailureCategory = \"infra_collision\" | \"assertion_failure\" | \"empty_run\" | \"timeout\" | \"max_buffer\" | \"spawn_error\" | \"signal\";"
+          "signature": "export type LinkedTestFailureCategory = \"infra_collision\" | \"trust_refusal\" | \"assertion_failure\" | \"empty_run\" | \"timeout\" | \"max_buffer\" | \"spawn_error\" | \"signal\";"
         },
         {
           "classification": "advanced_export",
@@ -7711,6 +8014,24 @@
           "name": "LinkedTestPmContextMode",
           "signature": "export type LinkedTestPmContextMode = (typeof LINKED_TEST_PM_CONTEXT_MODE_VALUES)[number];"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "LinkedTestTrustDecision",
+          "signature": "export interface LinkedTestTrustDecision { fingerprint: string; trusted: boolean; reason: \"legacy\" | \"local_mutation\" | \"local_source_ref\" | \"acknowledged\" | \"invalid_provenance\" | \"foreign_source_ref\"; source_ref?: string; current_source_ref?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "linkedTestTrustFingerprint",
+          "signature": "(test: LinkedTest) => string | calls: (test: LinkedTest) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "LinkedTestWorkspaceContextMode",
+          "signature": "export type LinkedTestWorkspaceContextMode = (typeof LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES)[number];"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -7771,6 +8092,12 @@
           "name": "LIST_SORT_ORDER_VALUES",
           "signature": "readonly [\"asc\", \"desc\"]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "listAgentProvenanceAdapters",
+          "signature": "() => readonly AgentProvenanceAdapter[] | calls: () => readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7933,6 +8260,18 @@
           "name": "listPmMcpToolsForProfile",
           "signature": "(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, \"custom\">) => string[] | calls: (availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, \"custom\">) => string[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listPmRequiredArgumentRefusalContracts",
+          "signature": "(contracts?: readonly PmCommandPositionalContract[]) => PmRequiredArgumentRefusalContract[] | calls: (contracts?: readonly PmCommandPositionalContract[]) => PmRequiredArgumentRefusalContract[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listPmSubcommandRefusalContracts",
+          "signature": "(contracts?: readonly PmCommandPositionalContract[]) => PmSubcommandRefusalContract[] | calls: (contracts?: readonly PmCommandPositionalContract[]) => PmSubcommandRefusalContract[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -8149,6 +8488,12 @@
           "name": "MERGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "MERGE_SUBCOMMAND_VALUES",
+          "signature": "readonly [\"install\", \"reconcile\", \"report\", \"driver\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8287,6 +8632,12 @@
           "name": "mergeSortedWarnings",
           "signature": "(...warningGroups: Array<string[] | undefined>) => string[] | calls: (...warningGroups: Array<string[] | undefined>) => string[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "MergeSubcommand",
+          "signature": "export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8437,6 +8788,12 @@
           "name": "NextResult",
           "signature": "export interface NextResult { output_default: \"toon\"; now: string; recommended: NextRecommendation | null; ready: NextActionableItem[]; decision_needed: NextActionableItem[]; blocked: NextActionableItem[]; held_by_others: Array<{ id: string; assignee: string; }>; summary: NextSummary; filters: { type: string | null; tag: string | null; priority: string | number | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; parent: string | null; limit: number; blocked_limit: number; ready_only: boolean; include_decisions: boolean; token_budget: number; }; suggestions?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; truncation?: { decision_needed_total?: number; held_by_others_total?: number; }; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "normalizeAgentProvenanceAdapterValue",
+          "signature": "(dimension: \"effort\" | \"model\", value: string) => NormalizedAgentProvenanceAdapterValue | calls: (dimension: \"model\" | \"effort\", value: string) => NormalizedAgentProvenanceAdapterValue"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8461,6 +8818,12 @@
           "name": "normalizeBootstrapInvocation",
           "signature": "(argv: string[]) => BootstrapInvocationNormalizationResult | calls: (argv: string[]) => BootstrapInvocationNormalizationResult"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "NormalizedAgentProvenanceAdapterValue",
+          "signature": "export interface NormalizedAgentProvenanceAdapterValue { raw: string; normalized: string; vocabulary: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9061,6 +9424,12 @@
           "name": "parseLinkedTestStringList",
           "signature": "(raw: string | undefined) => string[] | undefined | calls: (raw: string | undefined) => string[] | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "parseLinkedTestWorkspaceContextMode",
+          "signature": "(raw: string | undefined, optionName: string) => LinkedTest[\"workspace_context_mode\"] | undefined | calls: (raw: string | undefined, optionName: string) => LinkedTest[\"workspace_context_mode\"] | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9277,6 +9646,12 @@
           "name": "PLAN_TEMPLATE_NAMES",
           "signature": "readonly [\"bug-investigation\", \"feature-implementation\", \"refactoring-sprint\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "planAgentIdentityVocabularyMutation",
+          "signature": "(current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput) => AgentIdentityVocabularyMutationPlan | calls: (current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput) => AgentIdentityVocabularyMutationPlan"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -9467,7 +9842,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "PM_COMPLETE_LIST_FINDING_CODES",
-          "signature": "readonly [\"invalid_envelope\", \"source_incomplete\", \"source_unchecked\", \"filtered_corpus\", \"terminal_items_excluded\", \"strict_read_unproven\", \"page_incomplete\", \"count_mismatch\", \"projection_incomplete\", \"field_omission\", \"budget_compaction\", \"budget_omission\", \"session_projection\", \"invalid_item_id\", \"duplicate_item_id\"]"
+          "signature": "readonly [\"invalid_envelope\", \"source_incomplete\", \"source_unchecked\", \"filtered_corpus\", \"terminal_items_excluded\", \"strict_read_unproven\", \"page_incomplete\", \"count_mismatch\", \"projection_incomplete\", \"field_omission\", \"omission_receipt_missing\", \"omission_receipt_invalid\", \"read_output_missing\", \"read_output_invalid\", \"read_output_dimensions_incomplete\", \"budget_compaction\", \"budget_omission\", \"session_projection\", \"invalid_item_id\", \"duplicate_item_id\"]"
         },
         {
           "classification": "contract_data",
@@ -9499,6 +9874,24 @@
           "name": "PM_DEPRECATED_TOOL_ACTIONS",
           "signature": "readonly PmToolAction[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_DEGRADATION_STEPS",
+          "signature": "readonly [\"full\", \"omit_explanation\", \"limit_collections\", \"compact_recovery\", \"action_only\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS",
+          "signature": "PmDiagnosticOutputBudgetContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_CLASSES",
+          "signature": "readonly [\"error\", \"warning\", \"validation_summary\", \"recovery_bundle\"]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -9725,7 +10118,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_SURFACES",
-          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"package-catalog\", \"package-manage\", \"comments-audit\", \"assurance\"]"
+          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"duplicates\", \"package-catalog\", \"package-manage\", \"comments-audit\", \"assurance\"]"
         },
         {
           "classification": "advanced_export",
@@ -9751,6 +10144,12 @@
           "name": "PM_RECOVERY_REFERENCE_KINDS",
           "signature": "readonly [\"suggested_retry\", \"candidate_command\", \"example\", \"next_step\", \"migration_hint\", \"restore_with\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REPRODUCIBLE_PROCESS_ENV",
+          "signature": "Readonly<{ readonly clock: \"PM_CLOCK\"; readonly tickMs: \"PM_CLOCK_TICK_MS\"; readonly seed: \"PM_SEED\"; }>"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -9785,7 +10184,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -9851,7 +10250,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options): ReadPromise<DuplicatesResult, Options>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -9893,7 +10292,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "PmCliErrorContext",
-          "signature": "export interface PmCliErrorContext { code?: string; reason?: string; field?: string; gate_id?: string; assertion_id?: string; measurement_id?: string; source_kind?: string; source_id?: string; source_created_at?: string; target_id?: string; target_created_at?: string; temporal_order?: string; check?: string; format?: string; flag?: string; value?: string; format_version?: number; type?: string; required?: string; why?: string; resolved_path?: string; requested_path?: string; suggested_path?: string; examples?: string[]; nextSteps?: string[]; unmatched?: string[]; unmatched_selectors?: Array<{ id: string; kind?: string; source_kind?: string; }>; available_dependencies?: Array<{ id: string; kind: string; source_kind?: string; }>; verification_errors?: string[]; unresolved_targets?: string[]; valid_range?: { first_version: number | null; last_version: number | null; first_timestamp: string | null; last_timestamp: string | null; }; recovery?: PmCliErrorRecoveryPayload; }"
+          "signature": "export interface PmCliErrorContext { code?: string; reason?: string; field?: string; gate_id?: string; assertion_id?: string; measurement_id?: string; source_kind?: string; source_id?: string; source_created_at?: string; target_id?: string; target_created_at?: string; temporal_order?: string; check?: string; format?: string; flag?: string; value?: string; format_version?: number; type?: string; required?: string; why?: string; resolved_path?: string; requested_path?: string; suggested_path?: string; examples?: string[]; nextSteps?: string[]; unmatched?: string[]; unmatched_selectors?: Array<{ id: string; kind?: string; source_kind?: string; author?: string; created_at?: string; }>; available_dependencies?: Array<{ id: string; kind: string; source_kind?: string; author?: string; created_at?: string; }>; verification_errors?: string[]; unresolved_targets?: string[]; valid_range?: { first_version: number | null; last_version: number | null; first_timestamp: string | null; last_timestamp: string | null; }; recovery?: PmCliErrorRecoveryPayload; }"
         },
         {
           "classification": "advanced_export",
@@ -10133,7 +10532,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmCompleteListResult",
-          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output?: PmReadOutputReceipt; }"
+          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output: PmReadOutputReceipt; }"
         },
         {
           "classification": "supported",
@@ -10198,13 +10597,37 @@
         {
           "classification": "contract_data",
           "kind": "type",
-          "name": "PmErrorCodeClass",
-          "signature": "export type PmErrorCodeClass = \"generic_failure\" | \"usage\" | \"not_found\" | \"conflict\" | \"dependency_failed\";"
+          "name": "PmDiagnosticDegradationStep",
+          "signature": "export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];"
         },
         {
           "classification": "contract_data",
           "kind": "interface",
-          "name": "PmErrorCodeContract",
+          "name": "PmDiagnosticOutputBudgetContract",
+          "signature": "export interface PmDiagnosticOutputBudgetContract { diagnostic_class: PmDiagnosticOutputClass; default_max_estimated_tokens_by_format: Readonly<{ text: number; json: number; }>; minimum_max_estimated_tokens: number; degradation_ladder: readonly PmDiagnosticDegradationStep[]; corrective_action_paths: readonly string[]; token_estimate: \"ceil(utf8_bytes / 4)\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmDiagnosticOutputClass",
+          "signature": "export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmDiagnosticOutputReceipt",
+          "signature": "export interface PmDiagnosticOutputReceipt { diagnostic_class: PmDiagnosticOutputClass; format: \"json\" | \"text\"; budget: number; budget_source: \"default\" | \"explicit\"; original_estimated_tokens: number; estimated_tokens: number; truncated: boolean; degradation_steps: PmDiagnosticDegradationStep[]; omitted_fields: string[]; omitted_fields_overflow_count?: number; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmErrorCodeClass",
+          "signature": "export type PmErrorCodeClass = \"generic_failure\" | \"usage\" | \"not_found\" | \"conflict\" | \"dependency_failed\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmErrorCodeContract",
           "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; owned_states?: PmRefusalStateContract[]; }"
         },
         {
@@ -10285,6 +10708,36 @@
           "name": "PmFlagValueKind",
           "signature": "export type PmFlagValueKind = \"boolean\" | \"string\" | \"number\" | \"list\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalClosureReport",
+          "signature": "export interface PmGrammarRefusalClosureReport { ok: boolean; probe_count: number; closed_probe_count: number; findings: PmGrammarRefusalFinding[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalContract",
+          "signature": "export interface PmGrammarRefusalContract { probe_id: string; command: string; refusal_args: readonly string[]; recovery_args: readonly string[]; error_code: \"invalid_argument_value\" | \"missing_lifecycle_target\" | \"missing_required_argument\" | \"unknown_subcommand\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalFinding",
+          "signature": "export interface PmGrammarRefusalFinding { code: PmGrammarRefusalFindingCode; probe_id: string; detail: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmGrammarRefusalFindingCode",
+          "signature": "export type PmGrammarRefusalFindingCode = \"refusal_allowed_values_mismatch\" | \"refusal_error_code_mismatch\" | \"refusal_exit_code_mismatch\" | \"refusal_mutated_state\" | \"refusal_probe_missing\" | \"refusal_recovery_failed\" | \"unexpected_refusal_probe\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalObservation",
+          "signature": "export interface PmGrammarRefusalObservation { probe_id: string; error_code: string; exit_code: number; allowed_values: readonly string[]; recovery_succeeded: boolean; refusal_mutated_state: boolean; mutated_paths?: readonly string[]; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -10417,6 +10870,18 @@
           "name": "PmPositionalActionContract",
           "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmProjectedDiagnostic",
+          "signature": "export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic, Extract<keyof TDiagnostic, \"code\" | \"required\">> & { diagnostic_output?: PmDiagnosticOutputReceipt; };"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmProjectedTextDiagnostic",
+          "signature": "export interface PmProjectedTextDiagnostic { output: string; diagnostic_output: PmDiagnosticOutputReceipt; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -10469,7 +10934,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputReceipt",
-          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
+          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudget",
+          "signature": "export interface PmReadOutputRecoveryBudget { output_budget: number | \"unbounded\"; recovery_budget_multiplier: number | null; rule_version: \"v1\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudgetInput",
+          "signature": "export interface PmReadOutputRecoveryBudgetInput { effective_budget_tokens: number; measured_result_tokens: number; }"
         },
         {
           "classification": "supported",
@@ -10523,7 +11000,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputTruncationDisclosure",
-          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: 1; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number; }; mcp: { outputBudget: number; }; }; }"
+          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: number | null; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number | \"unbounded\"; }; mcp: { outputBudget: number | \"unbounded\"; }; }; }"
         },
         {
           "classification": "advanced_export",
@@ -10645,6 +11122,12 @@
           "name": "PmRefusalStateContract",
           "signature": "export interface PmRefusalStateContract { state: string; probe_id: string; entrypoints: string[]; expected_exit_class: PmErrorCodeClass; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRequiredArgumentRefusalContract",
+          "signature": "export interface PmRequiredArgumentRefusalContract extends PmGrammarRefusalContract { missing_argument: string; missing_argument_index: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -10655,13 +11138,19 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmResolvedReadOutputDimensions",
-          "signature": "export interface PmResolvedReadOutputDimensions { command: PmReadOutputSurface; include?: PmResolvedReadOutputDimension<string[]>; amount?: PmResolvedReadOutputDimension<number | \"unbounded\">; cost?: PmResolvedReadOutputDimension<number | \"unbounded\">; encoding?: PmResolvedReadOutputDimension<\"json\" | \"toon\" | \"stream\">; legacy_aliases_used: string[]; migration_hints: string[]; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
+          "signature": "export interface PmResolvedReadOutputDimensions { command: PmReadOutputSurface; include?: PmResolvedReadOutputDimension<string[]>; amount?: PmResolvedReadOutputDimension<number | \"unbounded\">; cost?: PmResolvedReadOutputDimension<number | \"unbounded\">; encoding?: PmResolvedReadOutputDimension<\"json\" | \"toon\" | \"stream\">; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmSubcommandRefusalContract",
+          "signature": "export interface PmSubcommandRefusalContract extends PmGrammarRefusalContract { rejected_value: string; allowed_values: readonly string[]; }"
         },
         {
           "classification": "contract_data",
@@ -11077,6 +11566,18 @@
           "name": "projectHistoryProvenance",
           "signature": "(entry: HistoryEntry, vocabulary?: AuthorIdentityVocabulary, coordinates?: { itemId?: string; version?: number; }) => HistoryProvenanceRow | calls: (entry: HistoryEntry, vocabulary?: AuthorIdentityVocabulary, coordinates?: { itemId?: string; version?: number; }) => HistoryProvenanceRow"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticOutput",
+          "signature": "<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic> | calls: <TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic>"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticText",
+          "signature": "(output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic | calls: (output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -11605,6 +12106,12 @@
           "name": "refreshSearchArtifactsForMutation",
           "signature": "(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult> | calls: (pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "registerAgentProvenanceAdapters",
+          "signature": "(adapters: readonly AgentProvenanceAdapter[]) => () => void | calls: (adapters: readonly AgentProvenanceAdapter[]) => () => void"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -11687,7 +12194,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RegisteredExtensionServiceOverride",
-          "signature": "export interface RegisteredExtensionServiceOverride { layer: ExtensionLayer; name: string; service: ExtensionServiceName; run: ServiceOverride; }"
+          "signature": "export interface RegisteredExtensionServiceOverride { layer: ExtensionLayer; name: string; service: ExtensionServiceName; run: ServiceOverride; passThrough?: boolean; }"
         },
         {
           "classification": "supported",
@@ -12547,6 +13054,24 @@
           "name": "replayToItemDocument",
           "signature": "(document: ReplayDocument) => ItemDocument | calls: (document: ReplayDocument) => ItemDocument"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ReproducibleExecutionSettings",
+          "signature": "export interface ReproducibleExecutionSettings { seed: string; clock: string; tickMs: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ReproducibleProcessEnvironment",
+          "signature": "export type ReproducibleProcessEnvironment = Readonly<Record<string, string | undefined>>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ReproducibleProcessRunner",
+          "signature": "export type ReproducibleProcessRunner = ReproducibleExecutionRunner;"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12853,6 +13378,30 @@
           "name": "resolveLinkedTestFailureExitCode",
           "signature": "(execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"maxBufferExceeded\" | \"timedOut\">) => number | calls: (execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"timedOut\" | \"maxBufferExceeded\">) => number"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestSourceRef",
+          "signature": "(cwd?: string) => Promise<string | undefined> | calls: (cwd?: string) => Promise<string | undefined>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestSourceWorkspaceRoot",
+          "signature": "(cwd?: string) => string | calls: (cwd?: string) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestTrust",
+          "signature": "(pmRoot: string, test: LinkedTest, currentSourceRef?: string) => Promise<LinkedTestTrustDecision> | calls: (pmRoot: string, test: LinkedTest, currentSourceRef?: string) => Promise<LinkedTestTrustDecision>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestTrustBatch",
+          "signature": "(pmRoot: string, tests: LinkedTest[], currentSourceRef?: string) => Promise<LinkedTestTrustDecision[]> | calls: (pmRoot: string, tests: LinkedTest[], currentSourceRef?: string) => Promise<LinkedTestTrustDecision[]>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -12937,6 +13486,12 @@
           "name": "resolvePmCommandVisibilityTier",
           "signature": "(command: string, extensionTier?: PmCommandVisibilityTier) => PmCommandVisibilityTier | calls: (command: string, extensionTier?: PmCommandVisibilityTier) => PmCommandVisibilityTier"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmDiagnosticOutputBudget",
+          "signature": "(diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract | calls: (diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -13015,6 +13570,12 @@
           "name": "resolveReadOutputEncoding",
           "signature": "(command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined | calls: (command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveReadOutputRecoveryBudget",
+          "signature": "(input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget | calls: (input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13045,6 +13606,12 @@
           "name": "resolveRegisteredVectorStoreAdapter",
           "signature": "(registrations: ExtensionRegistrationRegistry | null, configuredAdapter: string | undefined) => RegisteredExtensionVectorStoreAdapter | null | calls: (registrations: ExtensionRegistrationRegistry | null, configuredAdapter: string | undefined) => RegisteredExtensionVectorStoreAdapter | null"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveReproducibleProcessEnvironment",
+          "signature": "(environment: ReproducibleProcessEnvironment) => ReproducibleExecutionSettings | undefined | calls: (environment: ReproducibleProcessEnvironment) => ReproducibleExecutionSettings | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -14071,6 +14638,12 @@
           "name": "runWithHarnessDetectionSignals",
           "signature": "<T>(signals: HarnessDetectionSignals, callback: () => T) => T | calls: <T>(signals: HarnessDetectionSignals, callback: () => T) => T"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runWithReproducibleProcessEnvironment",
+          "signature": "<T>(environment: ReproducibleProcessEnvironment, operation: () => Promise<T>) => Promise<T> | calls: <T>(environment: ReproducibleProcessEnvironment, operation: () => Promise<T>) => Promise<T>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -14497,6 +15070,12 @@
           "name": "scoreItemSimilarity",
           "signature": "(leftTitle: string, rightTitle: string) => ItemSimilarityScore | calls: (leftTitle: string, rightTitle: string) => ItemSimilarityScore"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "scorePmGrammarRefusalClosure",
+          "signature": "(contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]) => PmGrammarRefusalClosureReport | calls: (contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]) => PmGrammarRefusalClosureReport"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -14809,6 +15388,12 @@
           "name": "ServiceOverrideDecision",
           "signature": "export type ServiceOverrideDecision = { handled: true; result: unknown; } | { handled: false; };"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ServiceOverrideOwnership",
+          "signature": "export interface ServiceOverrideOwnership { passThrough?: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -15205,6 +15790,12 @@
           "name": "SubscribeMutationEventsOptions",
           "signature": "export interface SubscribeMutationEventsOptions extends ListMutationEventsOptions { intervalMs?: number; signal?: AbortSignal; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "summarizeAgentIdentityVocabulary",
+          "signature": "(vocabulary: AgentIdentityVocabulary | undefined) => AgentIdentityVocabularySummary | calls: (vocabulary: AgentIdentityVocabulary | undefined) => AgentIdentityVocabularySummary"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -15449,7 +16040,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestAllCommandOptions",
-          "signature": "export interface TestAllCommandOptions { author?: string; status?: string; limit?: string; offset?: string; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; }"
+          "signature": "export interface TestAllCommandOptions { author?: string; status?: string; limit?: string; offset?: string; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; workspaceContext?: string; overrideLinkedWorkspaceContext?: boolean; allowUntrustedLinkedTests?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -15467,7 +16058,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestCommandOptions",
-          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; removeIndex?: Array<string | number>; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
+          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; removeIndex?: Array<string | number>; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; workspaceContext?: string; overrideLinkedWorkspaceContext?: boolean; allowUntrustedLinkedTests?: boolean; acknowledgeLinkedTests?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
         },
         {
           "classification": "supported",
@@ -15491,7 +16082,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestRunResult",
-          "signature": "export interface TestRunResult { command?: string; path?: string; status: \"passed\" | \"failed\" | \"skipped\"; exit_code?: number; failure_category?: LinkedTestFailureCategory; execution_context?: { requested_pm_context_mode: LinkedTestPmContextMode; pm_context_mode: LinkedTestPmContextMode; auto_pm_context_applied: boolean; is_pm_command: boolean; is_pm_tracker_read_command: boolean; source_project_pm_path: string; sandbox_project_pm_path: string; source_global_pm_path: string; sandbox_global_pm_path: string; source_project_item_count: number; sandbox_project_item_count: number; source_global_item_count: number; sandbox_global_item_count: number; mismatch_detected: boolean; project_extensions_seeded: boolean; global_extensions_seeded: boolean; }; stdout?: string; stderr?: string; error?: string; }"
+          "signature": "export interface TestRunResult { command?: string; path?: string; status: \"passed\" | \"failed\" | \"skipped\"; exit_code?: number; failure_category?: LinkedTestFailureCategory; execution_context?: { requested_pm_context_mode: LinkedTestPmContextMode; pm_context_mode: LinkedTestPmContextMode; auto_pm_context_applied: boolean; is_pm_command: boolean; is_pm_tracker_read_command: boolean; source_project_pm_path: string; sandbox_project_pm_path: string; source_global_pm_path: string; sandbox_global_pm_path: string; source_project_item_count: number; sandbox_project_item_count: number; source_global_item_count: number; sandbox_global_item_count: number; mismatch_detected: boolean; project_extensions_seeded: boolean; global_extensions_seeded: boolean; requested_workspace_context_mode: LinkedTestWorkspaceContextMode; workspace_context_mode: LinkedTestWorkspaceContextMode; working_directory: string; source_workspace_root: string; trust: LinkedTestTrustDecision; }; stdout?: string; stderr?: string; error?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -16433,7 +17024,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "WorkspaceRelationshipAssembly",
-          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; orderingContradictions?: OrderingStorageContradiction[]; legacyAliasCounts: Record<string, number>; }"
+          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; orderingContradictions?: OrderingStorageContradiction[]; legacyAliasCounts: Record<string, number>; hierarchyIntegrity?: HierarchyIntegrityAnalysis; }"
         },
         {
           "classification": "supported",
@@ -16991,7 +17582,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionApi",
-          "signature": "export interface ExtensionApi { readonly extension: ExtensionSelfIdentity; registerCommand(command: string, override: CommandOverride): void; registerCommand(definition: CommandDefinition): void; registerParser(command: string, override: ParserOverride): void; registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void; registerService(service: ExtensionServiceName, override: ServiceOverride): void; registerFlags(targetCommand: string, flags: FlagDefinition[]): void; registerItemFields(fields: SchemaFieldDefinition[]): void; registerItemTypes(types: SchemaItemTypeDefinition[]): void; registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void; registerMigration(definition: SchemaMigrationDefinition): void; registerProfile(profile: ProjectProfileRegistrationInput): void; registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void; registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void; registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void; registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void; hooks: { beforeCommand(hook: BeforeCommandHook): void; beforeMutation(hook: BeforeMutationHook): void; afterCommand(hook: AfterCommandHook): void; onWrite(hook: OnWriteHook): void; onRead(hook: OnReadHook): void; onIndex(hook: OnIndexHook): void; }; }"
+          "signature": "export interface ExtensionApi { readonly extension: ExtensionSelfIdentity; registerCommand(command: string, override: CommandOverride): void; registerCommand(definition: CommandDefinition): void; registerParser(command: string, override: ParserOverride): void; registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void; registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void; registerFlags(targetCommand: string, flags: FlagDefinition[]): void; registerItemFields(fields: SchemaFieldDefinition[]): void; registerItemTypes(types: SchemaItemTypeDefinition[]): void; registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void; registerMigration(definition: SchemaMigrationDefinition): void; registerProfile(profile: ProjectProfileRegistrationInput): void; registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void; registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void; registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void; registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void; hooks: { beforeCommand(hook: BeforeCommandHook): void; beforeMutation(hook: BeforeMutationHook): void; afterCommand(hook: AfterCommandHook): void; onWrite(hook: OnWriteHook): void; onRead(hook: OnReadHook): void; onIndex(hook: OnIndexHook): void; }; }"
         },
         {
           "classification": "supported",
@@ -17777,7 +18368,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RegisteredExtensionServiceOverride",
-          "signature": "export interface RegisteredExtensionServiceOverride { layer: ExtensionLayer; name: string; service: ExtensionServiceName; run: ServiceOverride; }"
+          "signature": "export interface RegisteredExtensionServiceOverride { layer: ExtensionLayer; name: string; service: ExtensionServiceName; run: ServiceOverride; passThrough?: boolean; }"
         },
         {
           "classification": "supported",
@@ -17917,6 +18508,12 @@
           "name": "ServiceOverrideDecision",
           "signature": "export type ServiceOverrideDecision = { handled: true; result: unknown; } | { handled: false; };"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ServiceOverrideOwnership",
+          "signature": "export interface ServiceOverrideOwnership { passThrough?: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -18703,6 +19300,18 @@
           "name": "MERGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "MERGE_SUBCOMMAND_VALUES",
+          "signature": "readonly [\"install\", \"reconcile\", \"report\", \"driver\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "MergeSubcommand",
+          "signature": "export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -18853,6 +19462,24 @@
           "name": "PM_DEPRECATED_TOOL_ACTIONS",
           "signature": "readonly PmToolAction[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_DEGRADATION_STEPS",
+          "signature": "readonly [\"full\", \"omit_explanation\", \"limit_collections\", \"compact_recovery\", \"action_only\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS",
+          "signature": "PmDiagnosticOutputBudgetContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_CLASSES",
+          "signature": "readonly [\"error\", \"warning\", \"validation_summary\", \"recovery_bundle\"]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -18983,7 +19610,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_SURFACES",
-          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"package-catalog\", \"package-manage\", \"comments-audit\", \"assurance\"]"
+          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"duplicates\", \"package-catalog\", \"package-manage\", \"comments-audit\", \"assurance\"]"
         },
         {
           "classification": "contract_data",
@@ -19019,7 +19646,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -19255,6 +19882,30 @@
           "name": "PmCreateActionOptions",
           "signature": "export type PmCreateActionOptions = DeclaredProperties<CreateCommandOptions>;"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmDiagnosticDegradationStep",
+          "signature": "export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmDiagnosticOutputBudgetContract",
+          "signature": "export interface PmDiagnosticOutputBudgetContract { diagnostic_class: PmDiagnosticOutputClass; default_max_estimated_tokens_by_format: Readonly<{ text: number; json: number; }>; minimum_max_estimated_tokens: number; degradation_ladder: readonly PmDiagnosticDegradationStep[]; corrective_action_paths: readonly string[]; token_estimate: \"ceil(utf8_bytes / 4)\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmDiagnosticOutputClass",
+          "signature": "export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmDiagnosticOutputReceipt",
+          "signature": "export interface PmDiagnosticOutputReceipt { diagnostic_class: PmDiagnosticOutputClass; format: \"json\" | \"text\"; budget: number; budget_source: \"default\" | \"explicit\"; original_estimated_tokens: number; estimated_tokens: number; truncated: boolean; degradation_steps: PmDiagnosticDegradationStep[]; omitted_fields: string[]; omitted_fields_overflow_count?: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -19399,6 +20050,18 @@
           "name": "PmPositionalActionContract",
           "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmProjectedDiagnostic",
+          "signature": "export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic, Extract<keyof TDiagnostic, \"code\" | \"required\">> & { diagnostic_output?: PmDiagnosticOutputReceipt; };"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmProjectedTextDiagnostic",
+          "signature": "export interface PmProjectedTextDiagnostic { output: string; diagnostic_output: PmDiagnosticOutputReceipt; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -19451,7 +20114,19 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputReceipt",
-          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
+          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudget",
+          "signature": "export interface PmReadOutputRecoveryBudget { output_budget: number | \"unbounded\"; recovery_budget_multiplier: number | null; rule_version: \"v1\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudgetInput",
+          "signature": "export interface PmReadOutputRecoveryBudgetInput { effective_budget_tokens: number; measured_result_tokens: number; }"
         },
         {
           "classification": "contract_data",
@@ -19493,7 +20168,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputTruncationDisclosure",
-          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: 1; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number; }; mcp: { outputBudget: number; }; }; }"
+          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: number | null; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number | \"unbounded\"; }; mcp: { outputBudget: number | \"unbounded\"; }; }; }"
         },
         {
           "classification": "contract_data",
@@ -19529,7 +20204,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmResolvedReadOutputDimensions",
-          "signature": "export interface PmResolvedReadOutputDimensions { command: PmReadOutputSurface; include?: PmResolvedReadOutputDimension<string[]>; amount?: PmResolvedReadOutputDimension<number | \"unbounded\">; cost?: PmResolvedReadOutputDimension<number | \"unbounded\">; encoding?: PmResolvedReadOutputDimension<\"json\" | \"toon\" | \"stream\">; legacy_aliases_used: string[]; migration_hints: string[]; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
+          "signature": "export interface PmResolvedReadOutputDimensions { command: PmReadOutputSurface; include?: PmResolvedReadOutputDimension<string[]>; amount?: PmResolvedReadOutputDimension<number | \"unbounded\">; cost?: PmResolvedReadOutputDimension<number | \"unbounded\">; encoding?: PmResolvedReadOutputDimension<\"json\" | \"toon\" | \"stream\">; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
         },
         {
           "classification": "contract_data",
@@ -19615,6 +20290,18 @@
           "name": "PROFILE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticOutput",
+          "signature": "<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic> | calls: <TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic>"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticText",
+          "signature": "(output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic | calls: (output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -19717,6 +20404,12 @@
           "name": "resolvePmCommandPositionalContract",
           "signature": "(command: string) => PmCommandPositionalContract | undefined | calls: (command: string) => PmCommandPositionalContract | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmDiagnosticOutputBudget",
+          "signature": "(diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract | calls: (diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -19759,6 +20452,12 @@
           "name": "resolveReadOutputEncoding",
           "signature": "(command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined | calls: (command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveReadOutputRecoveryBudget",
+          "signature": "(input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget | calls: (input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -20161,6 +20860,12 @@
           "name": "AgentProvenanceAbsenceReason",
           "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceAdapter",
+          "signature": "export interface AgentProvenanceAdapter { contract_version: 1; adapter_version: string; priority: number; harness: string; descriptor: HarnessSignalDescriptor; supported_dimensions: readonly string[]; native_sources: readonly (\"environment\" | \"argv\" | \"mcp_client\" | \"session_file\")[]; probe_policy: { max_bytes: number; max_lines: number; network_access: false; subprocess_access: false; }; normalization: { model_family: \"v1\"; effort: \"v1\"; preserve_raw: true; }; confidence: \"high\" | \"medium\" | \"low\"; waivers?: Readonly<Record<string, string>>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -20311,6 +21016,12 @@
           "name": "boundAgentEpisodeIdentity",
           "signature": "(value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined | calls: (value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_AGENT_PROVENANCE_ADAPTERS",
+          "signature": "readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -20767,6 +21478,12 @@
           "name": "list",
           "signature": "<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<ListResult, Options> | calls: <Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<ListResult, Options>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "listAgentProvenanceAdapters",
+          "signature": "() => readonly AgentProvenanceAdapter[] | calls: () => readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -20803,6 +21520,18 @@
           "name": "NextResult",
           "signature": "export interface NextResult { output_default: \"toon\"; now: string; recommended: NextRecommendation | null; ready: NextActionableItem[]; decision_needed: NextActionableItem[]; blocked: NextActionableItem[]; held_by_others: Array<{ id: string; assignee: string; }>; summary: NextSummary; filters: { type: string | null; tag: string | null; priority: string | number | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; parent: string | null; limit: number; blocked_limit: number; ready_only: boolean; include_decisions: boolean; token_budget: number; }; suggestions?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; truncation?: { decision_needed_total?: number; held_by_others_total?: number; }; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "normalizeAgentProvenanceAdapterValue",
+          "signature": "(dimension: \"effort\" | \"model\", value: string) => NormalizedAgentProvenanceAdapterValue | calls: (dimension: \"model\" | \"effort\", value: string) => NormalizedAgentProvenanceAdapterValue"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "NormalizedAgentProvenanceAdapterValue",
+          "signature": "export interface NormalizedAgentProvenanceAdapterValue { raw: string; normalized: string; vocabulary: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -20909,7 +21638,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options): ReadPromise<DuplicatesResult, Options>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "supported",
@@ -20933,7 +21662,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmCompleteListResult",
-          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output?: PmReadOutputReceipt; }"
+          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output: PmReadOutputReceipt; }"
         },
         {
           "classification": "supported",
@@ -20975,7 +21704,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputReceipt",
-          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
+          "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
         },
         {
           "classification": "supported",
@@ -21023,7 +21752,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
         },
         {
           "classification": "supported",
@@ -21067,6 +21796,12 @@
           "name": "RecurrenceReceipt",
           "signature": "export interface RecurrenceReceipt { reason: string; from_status: string; to_status: string; previous_terminal: PreviousTerminalEvidence; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "registerAgentProvenanceAdapters",
+          "signature": "(adapters: readonly AgentProvenanceAdapter[]) => () => void | calls: (adapters: readonly AgentProvenanceAdapter[]) => () => void"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -21341,7 +22076,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "_testOnlyHealthCommand",
-          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildHealthFindings: typeof buildHealthFindings; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
+          "signature": "{ buildHierarchyIntegrityWarnings: typeof buildHierarchyIntegrityWarnings; buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildHealthFindings: typeof buildHealthFindings; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
         },
         {
           "classification": "supported",
@@ -22759,6 +23494,12 @@
           "name": "analyzeGraphImpact",
           "signature": "(graph: RelationshipGraph, root: string, options?: RelationshipImpactOptions) => RelationshipImpactAnalysis | calls: (graph: RelationshipGraph, root: string, options?: RelationshipImpactOptions) => RelationshipImpactAnalysis"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "analyzeHierarchyIntegrity",
+          "signature": "(items: readonly HierarchyIntegrityItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => HierarchyIntegrityAnalysis | calls: (items: readonly HierarchyIntegrityItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => HierarchyIntegrityAnalysis"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -22783,6 +23524,12 @@
           "name": "assembleWorkspaceRelationshipGraph",
           "signature": "(items: readonly WorkspaceRelationshipItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => WorkspaceRelationshipAssembly | calls: (items: readonly WorkspaceRelationshipItem[], isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => WorkspaceRelationshipAssembly"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "assertHierarchyMutationAllowed",
+          "signature": "(beforeItems: readonly HierarchyIntegrityItem[], afterItems: readonly HierarchyIntegrityItem[], changedItemId: string, isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => void | calls: (beforeItems: readonly HierarchyIntegrityItem[], afterItems: readonly HierarchyIntegrityItem[], changedItemId: string, isTerminal?: (status: ItemStatus) => boolean, registry?: RelationshipKindRegistry) => void"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -22867,6 +23614,12 @@
           "name": "collectDuplicateRelationshipEdgeGroups",
           "signature": "(assembly: WorkspaceRelationshipAssembly) => DuplicateRelationshipEdgeGroup[] | calls: (assembly: WorkspaceRelationshipAssembly) => DuplicateRelationshipEdgeGroup[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectHierarchyRelations",
+          "signature": "(items: readonly HierarchyIntegrityItem[], registry?: RelationshipKindRegistry) => HierarchyRelation[] | calls: (items: readonly HierarchyIntegrityItem[], registry?: RelationshipKindRegistry) => HierarchyRelation[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -23059,6 +23812,12 @@
           "name": "formatDuplicateEdgeGroup",
           "signature": "(group: DuplicateRelationshipEdgeGroup) => string | calls: (group: DuplicateRelationshipEdgeGroup) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "formatHierarchyRelation",
+          "signature": "(relation: HierarchyRelation) => string | calls: (relation: HierarchyRelation) => string"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -23087,7 +23846,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAnalyzeResult",
-          "signature": "export interface GraphAnalyzeResult { subcommand: \"analyze\"; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; sample_limit: number; execution: GraphExecutionSummary; knowledge: GraphKnowledgeSummary; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAnalyzeResult { subcommand: \"analyze\"; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; sample_limit: number; execution: GraphExecutionSummary; knowledge: GraphKnowledgeSummary; hierarchy?: GraphHierarchySummary; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -23105,7 +23864,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAuditResult",
-          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: Omit<RelationshipAuditReport[\"profile\"], \"finding_subjects_by_code\"> & Partial<Pick<RelationshipAuditReport[\"profile\"], \"finding_subjects_by_code\">>; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -23191,6 +23950,12 @@
           "name": "GraphExecutionSummary",
           "signature": "export interface GraphExecutionSummary { acyclic: boolean; ordered_node_count: number; layer_count: number; frontier_count: number; frontier?: string[]; critical_path_length: number; critical_path?: string[]; cycle_count: number; cycles?: string[][]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "GraphHierarchySummary",
+          "signature": "export interface GraphHierarchySummary { acyclic: boolean; relation_count: number; cycle_count: number; active_cycle_count?: number; legacy_cycle_count?: number; cardinality_violation_count: number; active_cardinality_violation_count?: number; legacy_cardinality_violation_count?: number; parent_divergence_count: number; active_parent_divergence_count?: number; legacy_parent_divergence_count?: number; cycles?: string[][]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -23311,18 +24076,72 @@
           "name": "hierarchyAncestors",
           "signature": "(graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]> | calls: (graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyCardinalityViolation",
+          "signature": "export interface HierarchyCardinalityViolation { child_id: string; parent_ids: string[]; legacy_terminal: boolean; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyCycle",
+          "signature": "export interface HierarchyCycle { item_ids: string[]; legacy_terminal: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "hierarchyDescendants",
           "signature": "(graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]> | calls: (graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyIntegrityAnalysis",
+          "signature": "export interface HierarchyIntegrityAnalysis { relations: HierarchyRelation[]; cycles: HierarchyCycle[]; cardinality_violations: HierarchyCardinalityViolation[]; divergences: HierarchyParentDivergence[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyIntegrityItem",
+          "signature": "export interface HierarchyIntegrityItem { id: string; status: ItemStatus; parent?: string; dependencies?: Dependency[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyParentDivergence",
+          "signature": "export interface HierarchyParentDivergence { child_id: string; scalar_parent_id: string; dependency_parent_ids: string[]; legacy_terminal: boolean; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyRelation",
+          "signature": "export interface HierarchyRelation { parent_id: string; child_id: string; source: HierarchyRelationSource; kind: string; holder_id: string; target_id?: string; child_cardinality: \"one\" | \"many\"; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "HierarchyRelationIndexes",
+          "signature": "export interface HierarchyRelationIndexes { parents_by_child: ReadonlyMap<string, readonly string[]>; children_by_parent: ReadonlyMap<string, readonly string[]>; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "HierarchyRelationSource",
+          "signature": "export type HierarchyRelationSource = \"scalar_parent\" | \"dependency\";"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "indexBlockedByIds",
           "signature": "(corpus: readonly ItemMetadata[]) => Map<string, string[]> | calls: (corpus: readonly ItemMetadata[]) => Map<string, string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "indexHierarchyRelations",
+          "signature": "(relations: readonly HierarchyRelation[]) => HierarchyRelationIndexes | calls: (relations: readonly HierarchyRelation[]) => HierarchyRelationIndexes"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -24011,7 +24830,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "WorkspaceRelationshipAssembly",
-          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; orderingContradictions?: OrderingStorageContradiction[]; legacyAliasCounts: Record<string, number>; }"
+          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; orderingContradictions?: OrderingStorageContradiction[]; legacyAliasCounts: Record<string, number>; hierarchyIntegrity?: HierarchyIntegrityAnalysis; }"
         },
         {
           "classification": "supported",
@@ -25403,7 +26222,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "PM_COMPLETE_LIST_FINDING_CODES",
-          "signature": "readonly [\"invalid_envelope\", \"source_incomplete\", \"source_unchecked\", \"filtered_corpus\", \"terminal_items_excluded\", \"strict_read_unproven\", \"page_incomplete\", \"count_mismatch\", \"projection_incomplete\", \"field_omission\", \"budget_compaction\", \"budget_omission\", \"session_projection\", \"invalid_item_id\", \"duplicate_item_id\"]"
+          "signature": "readonly [\"invalid_envelope\", \"source_incomplete\", \"source_unchecked\", \"filtered_corpus\", \"terminal_items_excluded\", \"strict_read_unproven\", \"page_incomplete\", \"count_mismatch\", \"projection_incomplete\", \"field_omission\", \"omission_receipt_missing\", \"omission_receipt_invalid\", \"read_output_missing\", \"read_output_invalid\", \"read_output_dimensions_incomplete\", \"budget_compaction\", \"budget_omission\", \"session_projection\", \"invalid_item_id\", \"duplicate_item_id\"]"
         },
         {
           "classification": "supported",
@@ -25445,7 +26264,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmCompleteListResult",
-          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output?: PmReadOutputReceipt; }"
+          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output: PmReadOutputReceipt; }"
         },
         {
           "classification": "supported",
@@ -26267,7 +27086,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ConfigResult",
-          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
+          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; identity_vocabulary?: AgentIdentityVocabularySummary; vocabulary_mutation?: AgentIdentityVocabularyMutationPreview; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
         },
         {
           "classification": "supported",
@@ -26315,7 +27134,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -26365,6 +27184,12 @@
           "name": "CreatePmCliExpectedErrorOptions",
           "signature": "export interface CreatePmCliExpectedErrorOptions { exitCode?: number; context?: PmCliErrorContext; cause?: unknown; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "createPmCommandOutputBudget",
+          "signature": "(command: string, budgetClass?: PmOutputBudgetClass) => PmCommandOutputBudgetContract | calls: (command: string, budgetClass?: PmOutputBudgetClass) => PmCommandOutputBudgetContract"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -26389,6 +27214,12 @@
           "name": "DEFAULT_TERMINAL_TRANSITION_POLICY",
           "signature": "Readonly<TerminalTransitionPolicy>"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "definePmCommandOutputBudget",
+          "signature": "<TContract extends PmCommandOutputBudgetContract>(contract: TContract) => TContract | calls: <TContract extends PmCommandOutputBudgetContract>(contract: TContract) => TContract"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -26459,7 +27290,7 @@
           "classification": "advanced_export",
           "kind": "function",
           "name": "duplicates",
-          "signature": "(options?: DuplicatesCommandOptions, clientOptions?: PmClientOptions) => Promise<DuplicatesResult> | calls: (options?: DuplicatesCommandOptions, clientOptions?: PmClientOptions) => Promise<DuplicatesResult>"
+          "signature": "<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<DuplicatesResult, Options> | calls: <Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<DuplicatesResult, Options>"
         },
         {
           "classification": "supported",
@@ -26503,6 +27334,12 @@
           "name": "ensureTrackerInitialized",
           "signature": "(pmRoot: string) => Promise<void> | calls: (pmRoot: string) => Promise<void>"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "estimatePmOutputTokens",
+          "signature": "(utf8Bytes: number) => number | calls: (utf8Bytes: number) => number"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -26821,6 +27658,12 @@
           "name": "ImportPriorityValue",
           "signature": "export type ImportPriorityValue = 0 | 1 | 2 | 3 | 4;"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "inferPmOutputBudgetClass",
+          "signature": "(command: string) => PmOutputBudgetClass | calls: (command: string) => PmOutputBudgetClass"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -26963,7 +27806,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "LinkedTest",
-          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
+          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; workspace_context_mode?: \"source\" | \"isolated\" | \"snapshot\"; provenance?: LinkedTestProvenance; provenance_invalid?: true; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
         },
         {
           "classification": "supported",
@@ -27301,6 +28144,30 @@
           "name": "PM_CLI_EXPECTED_ERROR_NAME",
           "signature": "\"PmCliError\""
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_COMMAND_OUTPUT_BUDGET_CONTRACTS",
+          "signature": "PmCommandOutputBudgetContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_DEGRADATION_STEPS",
+          "signature": "readonly [\"full\", \"omit_explanation\", \"limit_collections\", \"compact_recovery\", \"action_only\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS",
+          "signature": "PmDiagnosticOutputBudgetContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_DIAGNOSTIC_OUTPUT_CLASSES",
+          "signature": "readonly [\"error\", \"warning\", \"validation_summary\", \"recovery_bundle\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -27313,6 +28180,18 @@
           "name": "PM_GITIGNORE_START",
           "signature": "\"# pm-cli:runtime-cache:start\""
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_OUTPUT_BUDGET_CLASSES",
+          "signature": "readonly [\"mutation\", \"read\", \"discovery\", \"governance\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_OUTPUT_DEGRADATION_STEPS",
+          "signature": "readonly [\"full\", \"compact\", \"brief\", \"summary\", \"counts\"]"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -27335,7 +28214,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options): ReadPromise<DuplicatesResult, Options>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -27379,6 +28258,12 @@
           "name": "PmCliExpectedError",
           "signature": "export interface PmCliExpectedError extends Error { name: typeof PM_CLI_EXPECTED_ERROR_NAME; exitCode: number; context: PmCliErrorContext; cause?: unknown; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandOutputBudgetContract",
+          "signature": "export interface PmCommandOutputBudgetContract { command: string; budget_class: PmOutputBudgetClass; default_max_estimated_tokens: number; default_max_estimated_tokens_by_format: Readonly<{ toon: number; json: number; }>; degradation_ladder: readonly PmOutputDegradationStep[]; allows_unbounded_opt_out: boolean; token_estimate: \"ceil(utf8_bytes / 4)\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -27419,7 +28304,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmCompleteListResult",
-          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output?: PmReadOutputReceipt; }"
+          "signature": "export interface PmCompleteListResult extends ListFullResult { complete_list: PmCompleteListCertificate; read_output: PmReadOutputReceipt; }"
         },
         {
           "classification": "supported",
@@ -27433,12 +28318,60 @@
           "name": "PmContextIntentContract",
           "signature": "export interface PmContextIntentContract { command: PmContextIntentCommand; intent: string; description: string; included_field_groups: string[]; token_budget: number; source?: PmContextIntentSource; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmDiagnosticDegradationStep",
+          "signature": "export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmDiagnosticOutputBudgetContract",
+          "signature": "export interface PmDiagnosticOutputBudgetContract { diagnostic_class: PmDiagnosticOutputClass; default_max_estimated_tokens_by_format: Readonly<{ text: number; json: number; }>; minimum_max_estimated_tokens: number; degradation_ladder: readonly PmDiagnosticDegradationStep[]; corrective_action_paths: readonly string[]; token_estimate: \"ceil(utf8_bytes / 4)\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmDiagnosticOutputClass",
+          "signature": "export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmDiagnosticOutputReceipt",
+          "signature": "export interface PmDiagnosticOutputReceipt { diagnostic_class: PmDiagnosticOutputClass; format: \"json\" | \"text\"; budget: number; budget_source: \"default\" | \"explicit\"; original_estimated_tokens: number; estimated_tokens: number; truncated: boolean; degradation_steps: PmDiagnosticDegradationStep[]; omitted_fields: string[]; omitted_fields_overflow_count?: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
           "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; owned_states?: PmRefusalStateContract[]; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmOutputBudgetClass",
+          "signature": "export type PmOutputBudgetClass = (typeof PM_OUTPUT_BUDGET_CLASSES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmOutputDegradationStep",
+          "signature": "export type PmOutputDegradationStep = (typeof PM_OUTPUT_DEGRADATION_STEPS)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmProjectedDiagnostic",
+          "signature": "export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic, Extract<keyof TDiagnostic, \"code\" | \"required\">> & { diagnostic_output?: PmDiagnosticOutputReceipt; };"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmProjectedTextDiagnostic",
+          "signature": "export interface PmProjectedTextDiagnostic { output: string; diagnostic_output: PmDiagnosticOutputReceipt; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -27485,7 +28418,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
         },
         {
           "classification": "supported",
@@ -27571,6 +28504,18 @@
           "name": "ProgressEntry",
           "signature": "export interface ProgressEntry { id: string; title: string; type: string; total: number; closed: number; open: number; in_progress: number; blocked: number; completion_pct: number; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticOutput",
+          "signature": "<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic> | calls: <TDiagnostic extends object>(diagnostic: TDiagnostic, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedDiagnostic<TDiagnostic>"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "projectPmDiagnosticText",
+          "signature": "(output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic | calls: (output: string, correctiveAction: string, options?: { diagnosticClass?: PmDiagnosticOutputClass; maxEstimatedTokens?: number; }) => PmProjectedTextDiagnostic"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -27721,6 +28666,18 @@
           "name": "resolveItemTypeRegistry",
           "signature": "(settings: PmSettings, extensionRegistrations?: ExtensionRegistrationRegistry | null | undefined) => ItemTypeRegistry | calls: (settings: PmSettings, extensionRegistrations?: ExtensionRegistrationRegistry | null | undefined) => ItemTypeRegistry"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmCommandOutputBudget",
+          "signature": "{ (command: string, options: { generateFallback: true; }): PmCommandOutputBudgetContract; (command: string, options?: { generateFallback?: false; }): PmCommandOutputBudgetContract | null; } | calls: (command: string, options: { generateFallback: true; }) => PmCommandOutputBudgetContract ; (command: string, options?: { generateFallback?: false; }) => PmCommandOutputBudgetContract | null"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmDiagnosticOutputBudget",
+          "signature": "(diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract | calls: (diagnosticClass: PmDiagnosticOutputClass) => PmDiagnosticOutputBudgetContract"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -29330,6 +30287,9 @@
     "field_invalid",
     "field_mcp_input_collision",
     "github_source_entry_unbuilt",
+    "hierarchy_cardinality_created",
+    "hierarchy_cycle_created",
+    "hierarchy_parent_divergence_created",
     "history_author_acknowledge_plan_conflict",
     "history_author_acknowledge_plan_fingerprint_required",
     "history_author_acknowledge_preview_limit_invalid",
@@ -29384,6 +30344,7 @@
     "invalid_provenance_predicate",
     "invalid_query_cursor",
     "invalid_read_output_session",
+    "invalid_reproducible_process_environment",
     "invalid_workspace_snapshot_target",
     "item_already_active",
     "item_document_invalid",
@@ -29454,6 +30415,12 @@
     "read_output_cursor_stale",
     "recovery_kind_mismatch",
     "redundant_edge",
+    "refusal_allowed_values_mismatch",
+    "refusal_error_code_mismatch",
+    "refusal_exit_code_mismatch",
+    "refusal_mutated_state",
+    "refusal_probe_missing",
+    "refusal_recovery_failed",
     "reindex_already_running",
     "removed_canonical_spelling",
     "removed_compatibility_spelling",
@@ -29500,6 +30467,7 @@
     "type_duplicate",
     "type_invalid",
     "undeclared_observation",
+    "unexpected_refusal_probe",
     "unknown_command",
     "unknown_context_intent",
     "unknown_error",