@unbrained/pm-cli 2026.8.20 → 2026.8.22

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1743,
+    "covered_symbols": 1782,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1744
+    "required_symbols": 1783
   },
   "breaking_acknowledgements": [
     {
@@ -902,6 +902,164 @@
       ],
       "package_version": "2026.8.19",
       "reason": "Replace non-executable item action with the executable item-reopen action in the typed transport contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmTrackerPreflightFailureKind",
+        "signature ./sdk:PmTrackerPreflightRecoveryContract",
+        "signature ./sdk:PmTrackerPreflightRecoveryKind",
+        "signature ./sdk/contracts:PmTrackerPreflightFailureKind",
+        "signature ./sdk/contracts:PmTrackerPreflightRecoveryContract",
+        "signature ./sdk/contracts:PmTrackerPreflightRecoveryKind"
+      ],
+      "package_version": "2026.8.20",
+      "reason": "Expand tracker preflight failure and recovery unions with executable unreadable-root repair contracts"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmCliErrorContext",
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk:RelationshipKindDefinition",
+        "signature ./sdk/graph:RelationshipCoverageProfile",
+        "signature ./sdk/graph:RelationshipKindDefinition"
+      ],
+      "package_version": "2026.8.20",
+      "reason": "Add declarative traversal and typed outcome fields plus structured dependency-refusal context; existing runtime behavior remains backward compatible and new fields are additive."
+    },
+    {
+      "changes": [
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.20",
+      "reason": "Add declarative traversal and typed outcome fields plus structured dependency-refusal context; existing runtime behavior remains backward compatible and new fields are additive."
+    },
+    {
+      "changes": [
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.20",
+      "reason": "Add declarative traversal and typed outcome fields plus structured dependency-refusal context; existing runtime behavior remains backward compatible and new fields are additive."
+    },
+    {
+      "changes": [
+        "signature ./sdk:ASSURANCE_MEASUREMENT_SOURCE_KINDS",
+        "signature ./sdk:AssuranceDependencyKindSource",
+        "signature ./sdk:AssuranceDependencyRecord",
+        "signature ./sdk:AssuranceMeasurementSource",
+        "signature ./sdk/governance:ASSURANCE_MEASUREMENT_SOURCE_KINDS",
+        "signature ./sdk/governance:AssuranceDependencyKindSource",
+        "signature ./sdk/governance:AssuranceDependencyRecord",
+        "signature ./sdk/governance:AssuranceMeasurementSource"
+      ],
+      "package_version": "2026.8.20",
+      "reason": "Add provenance filters and prose-edge-gap assurance source while preserving existing source contracts"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AssuranceAssertionVerdict",
+        "signature ./sdk:AssuranceExternalMeasurementResult",
+        "signature ./sdk:AssuranceMeasurementResult",
+        "signature ./sdk/governance:AssuranceAssertionVerdict",
+        "signature ./sdk/governance:AssuranceExternalMeasurementResult",
+        "signature ./sdk/governance:AssuranceMeasurementResult"
+      ],
+      "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."
     }
   ],
   "entrypoints": {
@@ -954,7 +1112,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",
@@ -1310,6 +1468,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",
@@ -1628,6 +1792,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",
@@ -1640,6 +1810,12 @@
           "name": "assertHistoryRepairTarget",
           "signature": "(id: string | undefined, all: boolean) => void | calls: (id: string | undefined, all: boolean) => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assertInitializedTracker",
+          "signature": "(pmRoot: string) => Promise<void> | calls: (pmRoot: string) => Promise<void>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -1694,6 +1870,12 @@
           "name": "assertProjectRuntimeCompatibility",
           "signature": "(options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult | calls: (options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assertReadableTrackerRoot",
+          "signature": "(pmRoot: string) => Promise<void> | calls: (pmRoot: string) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1836,7 +2018,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "ASSURANCE_MEASUREMENT_SOURCE_KINDS",
-          "signature": "readonly [\"items\", \"dependency_kind\", \"graph\", \"validate\", \"health\", \"history\", \"links\", \"provider\", \"derived\"]"
+          "signature": "readonly [\"items\", \"dependency_kind\", \"prose_edge_gap\", \"graph\", \"validate\", \"health\", \"history\", \"links\", \"provider\", \"derived\"]"
         },
         {
           "classification": "supported",
@@ -1890,7 +2072,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceAssertionVerdict",
-          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: string; measurement_definition_fingerprint: string; scope: AssuranceScope; population_size: number; observed: AssuranceValue; bound: AssuranceBound; distance: number | null; verdict: \"pass\" | \"fail\" | \"retired\"; enforcement: AssuranceEnforcement; negative_control_proven: boolean; cost: AssuranceMeasurementCost; contributors: string[]; }"
+          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: string; measurement_definition_fingerprint: string; scope: AssuranceScope; population_size: number; observed: AssuranceValue; bound: AssuranceBound; distance: number | null; verdict: \"pass\" | \"fail\" | \"retired\"; enforcement: AssuranceEnforcement; negative_control_proven: boolean; cost: AssuranceMeasurementCost; contributors: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
@@ -1926,13 +2108,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceDependencyKindSource",
-          "signature": "export interface AssuranceDependencyKindSource { kind: \"dependency_kind\"; dependency_kind: string; }"
+          "signature": "export interface AssuranceDependencyKindSource { kind: \"dependency_kind\"; dependency_kind: string; source_kind?: string; source_kind_prefix?: string; source_kind_state?: \"present\" | \"missing\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceDependencyRecord",
-          "signature": "export interface AssuranceDependencyRecord { id: string; kind: string; }"
+          "signature": "export interface AssuranceDependencyRecord { id: string; kind: string; source_kind?: string; }"
         },
         {
           "classification": "supported",
@@ -1986,7 +2168,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceExternalMeasurementResult",
-          "signature": "export interface AssuranceExternalMeasurementResult { value: AssuranceValue; population_size: number; cost: number; contributors?: string[]; }"
+          "signature": "export interface AssuranceExternalMeasurementResult { value: AssuranceValue; population_size: number; cost: number; contributors?: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
@@ -2082,13 +2264,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceMeasurementResult",
-          "signature": "export interface AssuranceMeasurementResult { id: string; definition_fingerprint: string; value: AssuranceValue; population_size: number; cost: AssuranceMeasurementCost; contributors: string[]; }"
+          "signature": "export interface AssuranceMeasurementResult { id: string; definition_fingerprint: string; value: AssuranceValue; population_size: number; cost: AssuranceMeasurementCost; contributors: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "AssuranceMeasurementSource",
-          "signature": "export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;"
+          "signature": "export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceProseEdgeGapSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;"
         },
         {
           "classification": "supported",
@@ -2132,6 +2314,18 @@
           "name": "AssurancePresetId",
           "signature": "export type AssurancePresetId = (typeof ASSURANCE_PRESET_IDS)[number];"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceProseEdgeExemption",
+          "signature": "export interface AssuranceProseEdgeExemption { holder_id: string; target_id?: string; text_contains?: string; reason: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceProseEdgeGapSource",
+          "signature": "export interface AssuranceProseEdgeGapSource { kind: \"prose_edge_gap\"; exemptions?: AssuranceProseEdgeExemption[]; sample_limit?: number; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -2504,6 +2698,12 @@
           "name": "buildSemanticCorpusInput",
           "signature": "(document: ItemDocument, options?: SemanticCorpusInputOptions) => string | calls: (document: ItemDocument, options?: SemanticCorpusInputOptions) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "buildTrackerInitializationRecovery",
+          "signature": "(pmRoot: string) => PmCliErrorRecoveryPayload | calls: (pmRoot: string) => PmCliErrorRecoveryPayload"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2954,6 +3154,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",
@@ -3708,7 +3914,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",
@@ -4758,7 +4964,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",
@@ -5286,7 +5492,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",
@@ -6002,6 +6208,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",
@@ -6282,7 +6494,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",
@@ -6300,7 +6512,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",
@@ -6386,6 +6598,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",
@@ -6626,24 +6844,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",
@@ -6998,6 +7264,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",
@@ -7886,6 +8158,12 @@
           "name": "ListSortOrder",
           "signature": "export type ListSortOrder = (typeof LIST_SORT_ORDER_VALUES)[number];"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "listTrackerPreflightRecoveryContracts",
+          "signature": "() => PmTrackerPreflightRecoveryContract[] | calls: () => PmTrackerPreflightRecoveryContract[]"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -9366,7 +9644,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",
@@ -9398,6 +9676,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",
@@ -9624,7 +9920,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",
@@ -9750,7 +10046,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",
@@ -9792,7 +10088,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; format_version?: number; type?: string; required?: string; why?: string; resolved_path?: string; requested_path?: string; suggested_path?: string; examples?: string[]; nextSteps?: string[]; unmatched?: 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",
@@ -10032,7 +10328,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",
@@ -10094,6 +10390,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",
@@ -10316,6 +10636,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",
@@ -10368,7 +10700,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",
@@ -10554,7 +10886,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": "supported",
@@ -10580,6 +10912,42 @@
           "name": "PmToolCustomFieldCollision",
           "signature": "export interface PmToolCustomFieldCollision { field: string; property: string; owner: \"mcp_tool_input\"; nested_path: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmTrackerPreflightFailureKind",
+          "signature": "export type PmTrackerPreflightFailureKind = \"missing_root\" | \"settings_missing\" | \"not_directory\" | \"unreadable_root\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryContract",
+          "signature": "export interface PmTrackerPreflightRecoveryContract { probe_id: string; failure_kind: PmTrackerPreflightFailureKind; expected_error_code: string; expected_exit_code: 1 | 2 | 3; recovery_kind: PmTrackerPreflightRecoveryKind; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryFinding",
+          "signature": "export interface PmTrackerPreflightRecoveryFinding { code: \"missing_probe\" | \"error_code_mismatch\" | \"exit_code_mismatch\" | \"recovery_kind_mismatch\" | \"missing_init_recovery\" | \"unsafe_init_recovery\" | \"retry_failed\"; probe_id: string; detail: string; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmTrackerPreflightRecoveryKind",
+          "signature": "export type PmTrackerPreflightRecoveryKind = \"initialize\" | \"select_directory\" | \"repair_permissions\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryObservation",
+          "signature": "export interface PmTrackerPreflightRecoveryObservation { probe_id: string; error_code: string; exit_code: number; recovery_kind: PmTrackerPreflightRecoveryKind; suggested_retry_args: string[]; retry_succeeded: boolean; unsafe_init_recommended: boolean; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryReport",
+          "signature": "export interface PmTrackerPreflightRecoveryReport { ok: boolean; probe_count: number; closed_probe_count: number; findings: PmTrackerPreflightRecoveryFinding[]; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -10940,6 +11308,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",
@@ -11550,7 +11930,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",
@@ -11832,7 +12212,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; recorded_nodes?: number; edges: number; informative_edges?: number; redundant_edges?: number; ordering_contradiction_edges?: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; articulation_points: number; bridge_edges: number; outcome_nodes: number; active_outcome_reachable_nodes: number; active_outcome_unreachable_nodes: number; active_outcome_reachability_basis_points: number; terminal_nodes: number; terminal_outcome_reachable_nodes: number; terminal_outcome_unreachable_nodes: number; terminal_outcome_reachability_basis_points: number; outcome_reachable_nodes: number; outcome_unreachable_nodes: number; outcome_reachability_basis_points: number; finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; recorded_nodes?: number; edges: number; informative_edges?: number; redundant_edges?: number; ordering_contradiction_edges?: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; articulation_points: number; bridge_edges: number; outcome_nodes: number; outcome_reachability_basis: Record<RelationshipOutcomeTraversal, string>; active_outcome_reachable_nodes: number; active_outcome_unreachable_nodes: number; active_outcome_reachability_basis_points: number; terminal_nodes: number; terminal_outcome_reachable_nodes: number; terminal_outcome_unreachable_nodes: number; terminal_outcome_reachability_basis_points: number; outcome_reachable_nodes: number; outcome_unreachable_nodes: number; outcome_reachability_basis_points: number; finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>; }"
         },
         {
           "classification": "supported",
@@ -12066,7 +12446,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipKindDefinition",
-          "signature": "export interface RelationshipKindDefinition { kind: string; direction: RelationshipDirection; inverse?: string; ordering: boolean; temporalOrder?: RelationshipTemporalOrder; precedence?: RelationshipPrecedence; hierarchy: boolean; hierarchyDirection?: RelationshipHierarchyDirection; outgoing: RelationshipCardinality; incoming: RelationshipCardinality; lifecycle: RelationshipLifecycle; payloadSchema?: Readonly<Record<string, unknown>>; aliases?: readonly string[]; compatibilityVersion: number; allowSelf: boolean; }"
+          "signature": "export interface RelationshipKindDefinition { kind: string; direction: RelationshipDirection; traversal?: RelationshipTraversalFamily; outcomeTraversal?: RelationshipOutcomeTraversal; inverse?: string; ordering: boolean; temporalOrder?: RelationshipTemporalOrder; precedence?: RelationshipPrecedence; hierarchy: boolean; hierarchyDirection?: RelationshipHierarchyDirection; outgoing: RelationshipCardinality; incoming: RelationshipCardinality; lifecycle: RelationshipLifecycle; payloadSchema?: Readonly<Record<string, unknown>>; aliases?: readonly string[]; compatibilityVersion: number; allowSelf: boolean; }"
         },
         {
           "classification": "supported",
@@ -12092,6 +12472,12 @@
           "name": "RelationshipNeighborEdge",
           "signature": "export interface RelationshipNeighborEdge { id: string; edge: RelationshipEdge; }"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "RelationshipOutcomeTraversal",
+          "signature": "export type RelationshipOutcomeTraversal = \"source_to_target\" | \"target_to_source\" | \"both\";"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -12206,6 +12592,12 @@
           "name": "RelationshipTraversalDirection",
           "signature": "export type RelationshipTraversalDirection = \"outgoing\" | \"incoming\" | \"both\";"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "RelationshipTraversalFamily",
+          "signature": "export type RelationshipTraversalFamily = \"hierarchy\" | \"ordering\" | \"semantic\" | \"association\";"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -12788,6 +13180,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",
@@ -14360,6 +14758,12 @@
           "name": "scorePreparedItemSimilarity",
           "signature": "(left: PreparedSimilarityText, right: PreparedSimilarityText) => ItemSimilarityScore | calls: (left: PreparedSimilarityText, right: PreparedSimilarityText) => ItemSimilarityScore"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "scoreTrackerPreflightRecoveryClosure",
+          "signature": "(observations: readonly PmTrackerPreflightRecoveryObservation[]) => PmTrackerPreflightRecoveryReport | calls: (observations: readonly PmTrackerPreflightRecoveryObservation[]) => PmTrackerPreflightRecoveryReport"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -14655,9 +15059,15 @@
           "signature": "export type ServiceOverrideDecision = { handled: true; result: unknown; } | { handled: false; };"
         },
         {
-          "classification": "advanced_export",
-          "kind": "function",
-          "name": "setActiveCommandContext",
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ServiceOverrideOwnership",
+          "signature": "export interface ServiceOverrideOwnership { passThrough?: boolean; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "setActiveCommandContext",
           "signature": "(context: Omit<CommandOverrideContext, \"result\"> | null) => void | calls: (context: Omit<CommandOverrideContext, \"result\"> | null) => void"
         },
         {
@@ -16278,7 +16688,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",
@@ -16836,7 +17246,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",
@@ -17622,7 +18032,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",
@@ -17762,6 +18172,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",
@@ -18530,6 +18946,12 @@
           "name": "listPmFlagSpellingInventory",
           "signature": "() => readonly PmFlagSpellingInventoryEntry[] | calls: () => readonly PmFlagSpellingInventoryEntry[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "listTrackerPreflightRecoveryContracts",
+          "signature": "() => PmTrackerPreflightRecoveryContract[] | calls: () => PmTrackerPreflightRecoveryContract[]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -18692,6 +19114,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",
@@ -18822,7 +19262,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",
@@ -19094,6 +19534,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",
@@ -19238,6 +19702,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",
@@ -19290,7 +19766,7 @@
           "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",
@@ -19368,7 +19844,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",
@@ -19388,6 +19864,42 @@
           "name": "PmToolCustomFieldCollision",
           "signature": "export interface PmToolCustomFieldCollision { field: string; property: string; owner: \"mcp_tool_input\"; nested_path: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmTrackerPreflightFailureKind",
+          "signature": "export type PmTrackerPreflightFailureKind = \"missing_root\" | \"settings_missing\" | \"not_directory\" | \"unreadable_root\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryContract",
+          "signature": "export interface PmTrackerPreflightRecoveryContract { probe_id: string; failure_kind: PmTrackerPreflightFailureKind; expected_error_code: string; expected_exit_code: 1 | 2 | 3; recovery_kind: PmTrackerPreflightRecoveryKind; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryFinding",
+          "signature": "export interface PmTrackerPreflightRecoveryFinding { code: \"missing_probe\" | \"error_code_mismatch\" | \"exit_code_mismatch\" | \"recovery_kind_mismatch\" | \"missing_init_recovery\" | \"unsafe_init_recovery\" | \"retry_failed\"; probe_id: string; detail: string; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmTrackerPreflightRecoveryKind",
+          "signature": "export type PmTrackerPreflightRecoveryKind = \"initialize\" | \"select_directory\" | \"repair_permissions\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryObservation",
+          "signature": "export interface PmTrackerPreflightRecoveryObservation { probe_id: string; error_code: string; exit_code: number; recovery_kind: PmTrackerPreflightRecoveryKind; suggested_retry_args: string[]; retry_succeeded: boolean; unsafe_init_recommended: boolean; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmTrackerPreflightRecoveryReport",
+          "signature": "export interface PmTrackerPreflightRecoveryReport { ok: boolean; probe_count: number; closed_probe_count: number; findings: PmTrackerPreflightRecoveryFinding[]; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -19418,6 +19930,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",
@@ -19520,6 +20044,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",
@@ -19598,6 +20128,12 @@
           "name": "scorePmRefusalClosure",
           "signature": "(observations: readonly PmRefusalClosureObservation[]) => PmRefusalClosureReport | calls: (observations: readonly PmRefusalClosureObservation[]) => PmRefusalClosureReport"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "scoreTrackerPreflightRecoveryClosure",
+          "signature": "(observations: readonly PmTrackerPreflightRecoveryObservation[]) => PmTrackerPreflightRecoveryReport | calls: (observations: readonly PmTrackerPreflightRecoveryObservation[]) => PmTrackerPreflightRecoveryReport"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -20706,7 +21242,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",
@@ -20730,7 +21266,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",
@@ -20772,7 +21308,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",
@@ -21138,7 +21674,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",
@@ -21222,7 +21758,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "ASSURANCE_MEASUREMENT_SOURCE_KINDS",
-          "signature": "readonly [\"items\", \"dependency_kind\", \"graph\", \"validate\", \"health\", \"history\", \"links\", \"provider\", \"derived\"]"
+          "signature": "readonly [\"items\", \"dependency_kind\", \"prose_edge_gap\", \"graph\", \"validate\", \"health\", \"history\", \"links\", \"provider\", \"derived\"]"
         },
         {
           "classification": "supported",
@@ -21276,7 +21812,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceAssertionVerdict",
-          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: string; measurement_definition_fingerprint: string; scope: AssuranceScope; population_size: number; observed: AssuranceValue; bound: AssuranceBound; distance: number | null; verdict: \"pass\" | \"fail\" | \"retired\"; enforcement: AssuranceEnforcement; negative_control_proven: boolean; cost: AssuranceMeasurementCost; contributors: string[]; }"
+          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: string; measurement_definition_fingerprint: string; scope: AssuranceScope; population_size: number; observed: AssuranceValue; bound: AssuranceBound; distance: number | null; verdict: \"pass\" | \"fail\" | \"retired\"; enforcement: AssuranceEnforcement; negative_control_proven: boolean; cost: AssuranceMeasurementCost; contributors: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
@@ -21312,13 +21848,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceDependencyKindSource",
-          "signature": "export interface AssuranceDependencyKindSource { kind: \"dependency_kind\"; dependency_kind: string; }"
+          "signature": "export interface AssuranceDependencyKindSource { kind: \"dependency_kind\"; dependency_kind: string; source_kind?: string; source_kind_prefix?: string; source_kind_state?: \"present\" | \"missing\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceDependencyRecord",
-          "signature": "export interface AssuranceDependencyRecord { id: string; kind: string; }"
+          "signature": "export interface AssuranceDependencyRecord { id: string; kind: string; source_kind?: string; }"
         },
         {
           "classification": "supported",
@@ -21372,7 +21908,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceExternalMeasurementResult",
-          "signature": "export interface AssuranceExternalMeasurementResult { value: AssuranceValue; population_size: number; cost: number; contributors?: string[]; }"
+          "signature": "export interface AssuranceExternalMeasurementResult { value: AssuranceValue; population_size: number; cost: number; contributors?: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
@@ -21468,13 +22004,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceMeasurementResult",
-          "signature": "export interface AssuranceMeasurementResult { id: string; definition_fingerprint: string; value: AssuranceValue; population_size: number; cost: AssuranceMeasurementCost; contributors: string[]; }"
+          "signature": "export interface AssuranceMeasurementResult { id: string; definition_fingerprint: string; value: AssuranceValue; population_size: number; cost: AssuranceMeasurementCost; contributors: string[]; partitions?: Readonly<Record<string, number>>; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "AssuranceMeasurementSource",
-          "signature": "export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;"
+          "signature": "export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceProseEdgeGapSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;"
         },
         {
           "classification": "supported",
@@ -21518,6 +22054,18 @@
           "name": "AssurancePresetId",
           "signature": "export type AssurancePresetId = (typeof ASSURANCE_PRESET_IDS)[number];"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceProseEdgeExemption",
+          "signature": "export interface AssuranceProseEdgeExemption { holder_id: string; target_id?: string; text_contains?: string; reason: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceProseEdgeGapSource",
+          "signature": "export interface AssuranceProseEdgeGapSource { kind: \"prose_edge_gap\"; exemptions?: AssuranceProseEdgeExemption[]; sample_limit?: number; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -22544,6 +23092,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",
@@ -22568,6 +23122,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",
@@ -22652,6 +23212,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",
@@ -22844,6 +23410,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",
@@ -22872,7 +23444,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",
@@ -22890,7 +23462,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",
@@ -22976,6 +23548,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",
@@ -23096,18 +23674,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",
@@ -23340,7 +23972,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; recorded_nodes?: number; edges: number; informative_edges?: number; redundant_edges?: number; ordering_contradiction_edges?: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; articulation_points: number; bridge_edges: number; outcome_nodes: number; active_outcome_reachable_nodes: number; active_outcome_unreachable_nodes: number; active_outcome_reachability_basis_points: number; terminal_nodes: number; terminal_outcome_reachable_nodes: number; terminal_outcome_unreachable_nodes: number; terminal_outcome_reachability_basis_points: number; outcome_reachable_nodes: number; outcome_unreachable_nodes: number; outcome_reachability_basis_points: number; finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; recorded_nodes?: number; edges: number; informative_edges?: number; redundant_edges?: number; ordering_contradiction_edges?: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; articulation_points: number; bridge_edges: number; outcome_nodes: number; outcome_reachability_basis: Record<RelationshipOutcomeTraversal, string>; active_outcome_reachable_nodes: number; active_outcome_unreachable_nodes: number; active_outcome_reachability_basis_points: number; terminal_nodes: number; terminal_outcome_reachable_nodes: number; terminal_outcome_unreachable_nodes: number; terminal_outcome_reachability_basis_points: number; outcome_reachable_nodes: number; outcome_unreachable_nodes: number; outcome_reachability_basis_points: number; finding_subjects_by_code: Record<RelationshipAuditFindingCode, number>; }"
         },
         {
           "classification": "supported",
@@ -23574,7 +24206,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipKindDefinition",
-          "signature": "export interface RelationshipKindDefinition { kind: string; direction: RelationshipDirection; inverse?: string; ordering: boolean; temporalOrder?: RelationshipTemporalOrder; precedence?: RelationshipPrecedence; hierarchy: boolean; hierarchyDirection?: RelationshipHierarchyDirection; outgoing: RelationshipCardinality; incoming: RelationshipCardinality; lifecycle: RelationshipLifecycle; payloadSchema?: Readonly<Record<string, unknown>>; aliases?: readonly string[]; compatibilityVersion: number; allowSelf: boolean; }"
+          "signature": "export interface RelationshipKindDefinition { kind: string; direction: RelationshipDirection; traversal?: RelationshipTraversalFamily; outcomeTraversal?: RelationshipOutcomeTraversal; inverse?: string; ordering: boolean; temporalOrder?: RelationshipTemporalOrder; precedence?: RelationshipPrecedence; hierarchy: boolean; hierarchyDirection?: RelationshipHierarchyDirection; outgoing: RelationshipCardinality; incoming: RelationshipCardinality; lifecycle: RelationshipLifecycle; payloadSchema?: Readonly<Record<string, unknown>>; aliases?: readonly string[]; compatibilityVersion: number; allowSelf: boolean; }"
         },
         {
           "classification": "supported",
@@ -23600,6 +24232,12 @@
           "name": "RelationshipNeighborEdge",
           "signature": "export interface RelationshipNeighborEdge { id: string; edge: RelationshipEdge; }"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "RelationshipOutcomeTraversal",
+          "signature": "export type RelationshipOutcomeTraversal = \"source_to_target\" | \"target_to_source\" | \"both\";"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -23708,6 +24346,12 @@
           "name": "RelationshipTraversalDirection",
           "signature": "export type RelationshipTraversalDirection = \"outgoing\" | \"incoming\" | \"both\";"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "RelationshipTraversalFamily",
+          "signature": "export type RelationshipTraversalFamily = \"hierarchy\" | \"ordering\" | \"semantic\" | \"association\";"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -23784,7 +24428,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",
@@ -25176,7 +25820,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",
@@ -25218,7 +25862,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",
@@ -26088,7 +26732,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",
@@ -26138,6 +26782,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",
@@ -26162,6 +26812,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",
@@ -26232,7 +26888,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",
@@ -26276,6 +26932,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",
@@ -26594,6 +27256,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",
@@ -27074,6 +27742,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",
@@ -27086,6 +27778,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",
@@ -27108,7 +27812,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",
@@ -27152,6 +27856,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",
@@ -27192,7 +27902,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",
@@ -27206,12 +27916,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",
@@ -27344,6 +28102,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",
@@ -27494,6 +28264,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",
@@ -29064,6 +29846,8 @@
     "core_item_field_requires_dedicated_flag",
     "create_positional_type_without_title",
     "dependency_edge_not_allowed",
+    "dependency_flag_value_invalid",
+    "dependency_remove_no_match",
     "dependency_target_not_found",
     "dependency_temporal_order_invalid",
     "duplicate_canonical_flag",
@@ -29082,6 +29866,7 @@
     "error_code_mismatch",
     "event_cursor_query_mismatch",
     "event_index_unavailable",
+    "exit_code_mismatch",
     "extension_command_activation_failed",
     "extension_dependency_name_unsafe",
     "extension_dependency_spec_invalid",
@@ -29100,6 +29885,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",
@@ -29183,10 +29971,12 @@
     "missing_cli_flag",
     "missing_destination",
     "missing_directory",
+    "missing_init_recovery",
     "missing_lifecycle_target",
     "missing_observation",
     "missing_observed_signature",
     "missing_parameter_alias",
+    "missing_probe",
     "missing_required_argument",
     "missing_required_option",
     "missing_suggested_retry",
@@ -29220,6 +30010,7 @@
     "read_output_cursor_command_mismatch",
     "read_output_cursor_invalid",
     "read_output_cursor_stale",
+    "recovery_kind_mismatch",
     "redundant_edge",
     "reindex_already_running",
     "removed_canonical_spelling",
@@ -29280,6 +30071,7 @@
     "unknown_provenance_dimension",
     "unknown_status",
     "unknown_subcommand",
+    "unsafe_init_recovery",
     "unsupported_update_option",
     "validate_command_references_stale_pm_ids",
     "validate_files_missing_linked_paths",