@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1504,
+    "covered_symbols": 1506,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1505
+    "required_symbols": 1507
   },
   "breaking_acknowledgements": [
     {
@@ -302,6 +302,152 @@
       ],
       "package_version": "2026.8.10",
       "reason": "Expose public assurance action transport types while preserving the PmClient method contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ActivityCommandOptions",
+        "signature ./sdk:ActivityResult",
+        "signature ./sdk:BootstrapGlobalOptions",
+        "signature ./sdk:GlobalOptions",
+        "signature ./sdk:PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS",
+        "signature ./sdk:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk:PM_READ_ROW_CONTRACTS",
+        "signature ./sdk:PmReadOutputOptions",
+        "signature ./sdk:ReadRowContract",
+        "signature ./sdk:StatsCommandOptions",
+        "signature ./sdk:StatsResult",
+        "signature ./sdk/contracts:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk/contracts:PmReadOutputOptions",
+        "signature ./sdk/core:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk/core:PmReadOutputOptions",
+        "signature ./sdk/query:ActivityCommandOptions",
+        "signature ./sdk/query:ActivityResult",
+        "signature ./sdk/runtime:GlobalOptions",
+        "signature ./sdk/runtime:PmReadOutputOptions",
+        "signature ./sdk/runtime:StatsCommandOptions",
+        "signature ./sdk/runtime:StatsResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "stats now returns compact lifecycle rows by default; activity defaults to item digests; row contracts are explicit opt-in"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ItemDocumentMergeResult",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk:MergeDecisionReceiptSummary",
+        "signature ./sdk:MergeDriverResult",
+        "signature ./sdk/merge:ItemDocumentMergeResult",
+        "signature ./sdk/merge:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceiptSummary",
+        "signature ./sdk/merge:MergeDriverResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "GH-974 corrects misleading merge preferred fields to requested_preference; retained decision evidence is authoritative and legacy stored receipts remain readable"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AssuranceAssertionVerdict",
+        "signature ./sdk:AssuranceItemRecord",
+        "signature ./sdk:AssuranceItemsSource",
+        "signature ./sdk:AssuranceMeasurementResult",
+        "signature ./sdk:HealthCheck",
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PmCliErrorRecoveryPayload",
+        "signature ./sdk:RelationshipAuditDelta",
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk:TestCommandOptions",
+        "signature ./sdk:TestResult",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/governance:HealthCheck",
+        "signature ./sdk/graph:RelationshipAuditDelta",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "pm-py7qv2 pm-33mjrw pm-q6n8sj pm-h97qxd pm-rncuf7 pm-m0b7h8: explicit truthful context and evidence contract tranche"
+    },
+    {
+      "changes": [
+        "signature ./sdk:TestResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "pm-m0b7h8: removed count is present only for successful linked-test removals"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ValidateCheck",
+        "signature ./sdk/governance:ValidateCheck"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "ValidateCheck now exposes the same required machine-readable ok predicate as HealthCheck, preventing consumers from re-deriving status semantics; review-hardened before release."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmReadOutputSessionReceipt",
+        "signature ./sdk/contracts:PmReadOutputSessionReceipt",
+        "signature ./sdk/core:PmReadOutputSessionReceipt",
+        "signature ./sdk/runtime:PmReadOutputSessionReceipt"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "Add optional seen_item_overflow_count receipt while preserving every existing SDK input and below-capacity output"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ASSURANCE_ACTIONS",
+        "signature ./sdk:AssuranceActionInput",
+        "signature ./sdk:AssuranceActionResult",
+        "signature ./sdk:AssuranceEvaluationContext",
+        "signature ./sdk:AssuranceGateDefinition",
+        "signature ./sdk:CreateAssuranceWorkspaceContextOptions",
+        "signature ./sdk:createExtensionContributionInventory",
+        "signature ./sdk:EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
+        "signature ./sdk:EXTENSION_POLICY_SURFACES",
+        "signature ./sdk:ExtensionActivationSummary",
+        "signature ./sdk:ExtensionApi",
+        "signature ./sdk:ExtensionBlueprint",
+        "signature ./sdk:ExtensionContributionInventory",
+        "signature ./sdk:ExtensionRegistrationRegistry",
+        "signature ./sdk:PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
+        "signature ./sdk/authoring:createExtensionContributionInventory",
+        "signature ./sdk/authoring:EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
+        "signature ./sdk/authoring:EXTENSION_POLICY_SURFACES",
+        "signature ./sdk/authoring:ExtensionApi",
+        "signature ./sdk/authoring:ExtensionBlueprint",
+        "signature ./sdk/authoring:ExtensionContributionInventory",
+        "signature ./sdk/authoring:ExtensionRegistrationRegistry",
+        "signature ./sdk/contracts:PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
+        "signature ./sdk/core:AssuranceActionInput",
+        "signature ./sdk/core:AssuranceActionResult",
+        "signature ./sdk/runtime:AssuranceActionInput",
+        "signature ./sdk/runtime:AssuranceActionResult",
+        "signature ./sdk/testing:ExtensionActivationSummary",
+        "signature ./sdk/testing:ExtensionBlueprint"
+      ],
+      "package_version": "2026.8.12",
+      "reason": "Additive assurance provider, preset, trigger-policy, and inventory fields change structural signatures while preserving existing actions and registrations"
+    },
+    {
+      "changes": [
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.12",
+      "reason": "RelationshipCoverageProfile intentionally adds always-present structural and typed outcome governance fields under pm-4vz6mz; existing fields and semantics remain unchanged."
+    },
+    {
+      "changes": [
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.12",
+      "reason": "RelationshipCoverageProfile intentionally adds always-present structural and lifecycle-stable typed outcome governance fields under pm-4vz6mz, pm-g4k74y, and pm-bzmeaa; existing fields and semantics remain unchanged."
+    },
+    {
+      "changes": [
+        "signature ./sdk:RelationshipAuditFindingCode",
+        "signature ./sdk/graph:RelationshipAuditFindingCode"
+      ],
+      "package_version": "2026.8.12",
+      "reason": "Source-derived finding-code type replaces an identical handwritten union; the accepted values and runtime behavior are unchanged."
     }
   ],
   "entrypoints": {
@@ -392,6 +538,12 @@
           "name": "_testOnlyValidateCommand",
           "signature": "{ applyValidateFix: typeof applyValidateFix; applyValidateFixes: typeof applyValidateFixes; attachValidateFixHints: typeof attachValidateFixHints; buildCommandReferencesCheck: typeof buildCommandReferencesCheck; buildDependencyReferencesCheck: typeof buildDependencyReferencesCheck; buildCloseReasonBackfillRows: typeof buildCloseReasonBackfillRows; buildFilesCheck: typeof buildFilesCheck; buildLifecycleCheck: typeof buildLifecycleCheck; buildLifecycleDependencyGraph: typeof buildLifecycleDependencyGraph; buildLifecycleParentGraph: typeof buildLifecycleParentGraph; buildEstimateBackfillRows: typeof buildEstimateBackfillRows; buildMetadataCounts: typeof buildMetadataCounts; buildMissingFieldOccurrences: typeof buildMissingFieldOccurrences; buildOrphanedPathRows: typeof buildOrphanedPathRows; classifyOrphanedPath: typeof classifyOrphanedPath; collectDefaultProjectFileCandidates: typeof collectDefaultProjectFileCandidates; collectTrackedGitFileCandidates: typeof collectTrackedGitFileCandidates; detectLifecycleDependencyCycles: typeof detectLifecycleDependencyCycles; detectLifecycleParentCycles: typeof detectLifecycleParentCycles; escapeRegExp: typeof escapeRegExp; extractItemIds: typeof extractItemIds; findLifecycleDependencyCycleComponents: typeof findLifecycleDependencyCycleComponents; isMetadataFieldMissing: typeof isMetadataFieldMissing; linkedArtifactPathExceedsFilesystemLimits: typeof linkedArtifactPathExceedsFilesystemLimits; listFilesRecursive: typeof listFilesRecursive; resolveDependencyCycleSeverity: typeof resolveDependencyCycleSeverity; resolveParentCycleSeverity: typeof resolveParentCycleSeverity; resolveFileScanMode: typeof resolveFileScanMode; resolveLifecycleDependencyCycleSamplePath: typeof resolveLifecycleDependencyCycleSamplePath; resolveRequestedChecks: typeof resolveRequestedChecks; resolveValidateMetadataProfile: typeof resolveValidateMetadataProfile; resolveWorkspaceRoot: typeof resolveWorkspaceRoot; sharedDirectoryPrefixLength: typeof sharedDirectoryPrefixLength; summarizeOrphanedPathRows: typeof summarizeOrphanedPathRows; summarizeDuplicateIssueCodes: typeof summarizeDuplicateIssueCodes; toMeaningfulString: typeof toMeaningfulString; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "acceptAssuranceProposals",
+          "signature": "(pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -498,7 +650,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityCommandOptions",
-          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
+          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; raw?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -510,7 +662,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityResult",
-          "signature": "export interface ActivityResult { activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"compact\" | \"provenance\" | \"full\"; row_key: \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; provenance_summary?: HistoryProvenanceSummary; }"
+          "signature": "export interface ActivityResult { activity_digest?: ActivityDigestEntry[]; activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"digest\" | \"compact\" | \"provenance\" | \"full\"; row_key: \"activity_digest\" | \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; activity_summary?: { window: { from: string | null; to: string | null; }; event_count: number; item_count: number; author_count: number; operation_counts: Record<string, number>; }; provenance_summary?: HistoryProvenanceSummary; }"
         },
         {
           "classification": "advanced_export",
@@ -830,6 +982,12 @@
           "name": "applyAcceptanceCriteriaMutations",
           "signature": "(baseCriteria: readonly string[], add: readonly string[] | undefined, remove: readonly string[] | undefined) => { criteria: string[]; unmatchedRemovals: string[]; } | calls: (baseCriteria: readonly string[], add: readonly string[] | undefined, remove: readonly string[] | undefined) => { criteria: string[]; unmatchedRemovals: string[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "applyAssurancePreset",
+          "signature": "(pmRoot: string, id: AssurancePresetId, ownerItemId: string, options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, id: AssurancePresetId, ownerItemId: string, options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -986,6 +1144,12 @@
           "name": "assertHistoryRepairTarget",
           "signature": "(id: string | undefined, all: boolean) => void | calls: (id: string | undefined, all: boolean) => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assertLinkedArtifactMutationIsUnambiguous",
+          "signature": "(adds: LinkedArtifact[], removes: string[], migrations?: PathMigration[]) => void | calls: (adds: LinkedArtifact[], removes: string[], migrations?: PathMigration[]) => void"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1146,7 +1310,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "ASSURANCE_ACTIONS",
-          "signature": "readonly [\"list\", \"show\", \"put\", \"remove\", \"run\", \"verdicts\"]"
+          "signature": "readonly [\"list\", \"show\", \"put\", \"remove\", \"run\", \"verdicts\", \"presets\", \"apply\", \"derive\", \"promote\"]"
         },
         {
           "classification": "advanced_export",
@@ -1172,6 +1336,12 @@
           "name": "ASSURANCE_GATE_TRIGGERS",
           "signature": "readonly [\"pre-commit\", \"pre-push\", \"pre-merge\", \"ci\", \"pre-release\", \"post-release\", \"scheduled\", \"on-claim\", \"on-close\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "ASSURANCE_PRESET_IDS",
+          "signature": "readonly [\"software-delivery\", \"research\", \"agent-evaluation\", \"operations\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -1182,13 +1352,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceActionInput",
-          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; preset?: string; owner?: string; apply?: boolean; enforcement?: string; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "AssuranceActionResult",
-          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | AssuranceBundleMutationReceipt | AssurancePreset | { items: AssuranceDerivedProposal[]; count: number; applied?: AssuranceBundleMutationReceipt; } | { items: Array<{ id: AssurancePresetId; title: string; description: string; }>; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
         },
         {
           "classification": "advanced_export",
@@ -1212,7 +1382,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceAssertionVerdict",
-          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: 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[]; }"
         },
         {
           "classification": "advanced_export",
@@ -1220,12 +1390,24 @@
           "name": "AssuranceBound",
           "signature": "export interface AssuranceBound { polarity: \"ceiling\" | \"floor\" | \"equals\" | \"zero\" | \"monotone_nondecreasing\" | \"monotone_nonincreasing\" | \"subset_of\"; value: AssuranceValue; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceBundleMutationReceipt",
+          "signature": "export interface AssuranceBundleMutationReceipt { changed: boolean; created_ids: string[]; unchanged_ids: string[]; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
           "name": "AssuranceDeclaration",
           "signature": "export type AssuranceDeclaration = AssuranceMeasurementDefinition | AssuranceAssertionDefinition | AssuranceGateDefinition;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDeclarationBundle",
+          "signature": "export interface AssuranceDeclarationBundle { measurements: AssuranceMeasurementDefinition[]; assertions: AssuranceAssertionDefinition[]; gates: AssuranceGateDefinition[]; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -1250,6 +1432,12 @@
           "name": "AssuranceDerivedExpression",
           "signature": "export type AssuranceDerivedExpression = AssuranceMeasurementReference | AssuranceLiteralExpression | AssuranceArithmeticExpression;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDerivedProposal",
+          "signature": "export interface AssuranceDerivedProposal { id: string; population_size: number; scope: AssuranceScope; observed: number; declarations: AssuranceDeclarationBundle; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -1272,7 +1460,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceEvaluationContext",
-          "signature": "export interface AssuranceEvaluationContext { tree_id: string; items: AssuranceItemRecord[]; history: AssuranceHistoryRecord[]; terminal_statuses?: string[]; external: (source: AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceProviderSource) => Promise<AssuranceExternalMeasurementResult>; }"
+          "signature": "export interface AssuranceEvaluationContext { tree_id: string; items: AssuranceItemRecord[]; history: AssuranceHistoryRecord[]; terminal_statuses?: string[]; provider_capabilities?: Readonly<Record<string, { cost_class: AssuranceProviderCostClass; network: boolean; }>>; external: (source: AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceProviderSource) => Promise<AssuranceExternalMeasurementResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -1284,7 +1472,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceGateDefinition",
-          "signature": "export interface AssuranceGateDefinition { id: string; assertion_ids: string[]; triggers: AssuranceGateTrigger[]; description?: string; }"
+          "signature": "export interface AssuranceGateDefinition { id: string; assertion_ids: string[]; triggers: AssuranceGateTrigger[]; description?: string; provider_policy?: { allowed_providers: string[]; triggers: Partial<Record<AssuranceGateTrigger, { max_cost_class: AssuranceProviderCostClass; allow_network: boolean; }>>; }; }"
         },
         {
           "classification": "advanced_export",
@@ -1326,13 +1514,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceItemRecord",
-          "signature": "export interface AssuranceItemRecord { id: string; status: string; type: string; tags?: string[]; priority?: string | number; dependencies?: AssuranceDependencyRecord[]; files?: Array<Record<string, unknown>>; tests?: Array<Record<string, unknown>>; docs?: Array<Record<string, unknown>>; [key: string]: unknown; }"
+          "signature": "export interface AssuranceItemRecord { id: string; status: string; type: string; tags?: string[]; priority?: string | number; dependencies?: AssuranceDependencyRecord[]; files?: object[]; tests?: object[]; docs?: object[]; [key: string]: unknown; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceItemsSource",
-          "signature": "export interface AssuranceItemsSource { kind: \"items\"; statuses?: string[]; types?: string[]; tags?: string[]; field?: string; equals?: string | number | boolean | null; }"
+          "signature": "export interface AssuranceItemsSource { kind: \"items\"; statuses?: string[]; types?: string[]; tags?: string[]; field?: string; equals?: string | number | boolean | null; state?: \"present\" | \"missing\"; }"
         },
         {
           "classification": "advanced_export",
@@ -1374,7 +1562,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AssuranceMeasurementResult",
-          "signature": "export interface AssuranceMeasurementResult { id: 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[]; }"
         },
         {
           "classification": "advanced_export",
@@ -1406,6 +1594,24 @@
           "name": "AssuranceNegativeControlCase",
           "signature": "export interface AssuranceNegativeControlCase { observed: AssuranceValue; expected: \"pass\" | \"fail\"; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssurancePreset",
+          "signature": "export interface AssurancePreset { id: AssurancePresetId; title: string; description: string; declarations: AssuranceDeclarationBundle; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssurancePresetId",
+          "signature": "export type AssurancePresetId = (typeof ASSURANCE_PRESET_IDS)[number];"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceProviderCostClass",
+          "signature": "export type AssuranceProviderCostClass = \"low\" | \"medium\" | \"high\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -1548,7 +1754,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "BootstrapGlobalOptions",
-          "signature": "export interface BootstrapGlobalOptions { path?: string; noExtensions: boolean; noPager: boolean; json: boolean; quiet: boolean; lean: boolean; tokenAccounting: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; author?: string; authorMissingValue?: true; }"
+          "signature": "export interface BootstrapGlobalOptions { path?: string; noExtensions: boolean; noPager: boolean; json: boolean; quiet: boolean; lean: boolean; tokenAccounting: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; author?: string; authorMissingValue?: true; }"
         },
         {
           "classification": "advanced_export",
@@ -2972,6 +3178,12 @@
           "name": "CREATE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createAssurancePreset",
+          "signature": "(id: AssurancePresetId, ownerItemId: string) => AssurancePreset | calls: (id: AssurancePresetId, ownerItemId: string) => AssurancePreset"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2982,7 +3194,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "CreateAssuranceWorkspaceContextOptions",
-          "signature": "export interface CreateAssuranceWorkspaceContextOptions { tree_id?: string; include_history?: boolean; resolve_tree?: boolean; providers?: Readonly<Record<string, AssuranceProviderResolver>>; }"
+          "signature": "export interface CreateAssuranceWorkspaceContextOptions { tree_id?: string; include_history?: boolean; resolve_tree?: boolean; providers?: Readonly<Record<string, AssuranceProviderResolver>>; provider_capabilities?: AssuranceEvaluationContext[\"provider_capabilities\"]; trigger?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -3024,7 +3236,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "createExtensionContributionInventory",
-          "signature": "(summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory | calls: (summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory"
+          "signature": "(summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory | calls: (summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory"
         },
         {
           "classification": "supported",
@@ -3158,6 +3370,12 @@
           "name": "CreateWorkspaceSnapshotResult",
           "signature": "export interface CreateWorkspaceSnapshotResult { manifest: WorkspaceSnapshotManifest; name?: string; deduplicated: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "CURRENT_HISTORY_ITEM_HASH_VERSION",
+          "signature": "2"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -3566,6 +3784,12 @@
           "name": "DepsTreeNode",
           "signature": "export interface DepsTreeNode { id: string; title?: string; type?: ItemType; status?: ItemStatus; via?: string; missing: boolean; cycle: boolean; truncated?: boolean; collapsed?: boolean; dependencies: DepsTreeNode[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "deriveAssuranceProposals",
+          "signature": "(context: AssuranceEvaluationContext, ownerItemId: string) => Promise<AssuranceDerivedProposal[]> | calls: (context: AssuranceEvaluationContext, ownerItemId: string) => Promise<AssuranceDerivedProposal[]>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -4140,7 +4364,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
-          "signature": "{ readonly commands: readonly [\"registerCommand\", \"command override\", \"command handler\"]; readonly renderers: readonly [\"registerRenderer\"]; readonly hooks: readonly [\"hooks.beforeCommand\", \"hooks.beforeMutation\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"]; readonly schema: readonly [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerRelationshipKinds\", \"registerMigration\", \"registerProfile\"]; readonly importers: readonly [\"registerImporter\", \"registerExporter\"]; readonly search: readonly [\"registerSearchProvider\", \"registerVectorStoreAdapter\"]; readonly parser: readonly [\"registerParser\"]; readonly preflight: readonly [\"registerPreflight\"]; readonly services: readonly [\"registerService\"]; }"
+          "signature": "{ readonly commands: readonly [\"registerCommand\", \"command override\", \"command handler\"]; readonly renderers: readonly [\"registerRenderer\"]; readonly hooks: readonly [\"hooks.beforeCommand\", \"hooks.beforeMutation\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"]; readonly schema: readonly [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerRelationshipKinds\", \"registerMigration\", \"registerProfile\"]; readonly importers: readonly [\"registerImporter\", \"registerExporter\"]; readonly search: readonly [\"registerSearchProvider\", \"registerVectorStoreAdapter\"]; readonly parser: readonly [\"registerParser\"]; readonly preflight: readonly [\"registerPreflight\"]; readonly services: readonly [\"registerService\", \"registerAssuranceMeasurementProvider\"]; }"
         },
         {
           "classification": "contract_data",
@@ -4212,7 +4436,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXTENSION_POLICY_SURFACES",
-          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\"]"
+          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\", \"services.assuranceprovider\"]"
         },
         {
           "classification": "contract_data",
@@ -4260,19 +4484,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionActivationSummary",
-          "signature": "export interface ExtensionActivationSummary { capabilities: ExtensionCapability[]; commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: ExtensionServiceName[]; renderer_overrides: OutputRendererFormat[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides: number; preflight_ownership: Array<{ commands: string[]; }>; }"
+          "signature": "export interface ExtensionActivationSummary { capabilities: ExtensionCapability[]; commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: ExtensionServiceName[]; renderer_overrides: OutputRendererFormat[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides: number; preflight_ownership: Array<{ commands: string[]; }>; }"
         },
         {
           "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?: ImportExportRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): 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): 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?: ImportExportRegistrationOptions): 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",
           "kind": "interface",
           "name": "ExtensionBlueprint",
-          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
+          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; assuranceProviders?: AssuranceMeasurementProviderDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -4392,7 +4616,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionContributionInventory",
-          "signature": "export interface ExtensionContributionInventory { schema_version: 1; commands?: string[]; command_overrides?: string[]; command_handlers?: string[]; hooks?: string[]; flag_commands?: string[]; item_types?: string[]; item_fields?: string[]; relationship_kinds?: string[]; migrations?: string[]; profiles?: string[]; importers?: string[]; exporters?: string[]; search_providers?: string[]; vector_store_adapters?: string[]; parser_overrides?: string[]; service_overrides?: string[]; renderer_overrides?: string[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides?: number; preflight_ownership?: Array<{ commands: string[]; }>; }"
+          "signature": "export interface ExtensionContributionInventory { schema_version: 1; commands?: string[]; command_overrides?: string[]; command_handlers?: string[]; hooks?: string[]; flag_commands?: string[]; item_types?: string[]; item_fields?: string[]; relationship_kinds?: string[]; migrations?: string[]; profiles?: string[]; importers?: string[]; exporters?: string[]; search_providers?: string[]; vector_store_adapters?: string[]; assurance_providers?: string[]; parser_overrides?: string[]; service_overrides?: string[]; renderer_overrides?: string[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides?: number; preflight_ownership?: Array<{ commands: string[]; }>; }"
         },
         {
           "classification": "advanced_export",
@@ -4656,7 +4880,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionRegistrationRegistry",
-          "signature": "export interface ExtensionRegistrationRegistry { commands: RegisteredExtensionCommandDefinition[]; flags: RegisteredExtensionFlagDefinitions[]; item_fields: RegisteredExtensionSchemaFieldDefinitions[]; item_types: RegisteredExtensionSchemaItemTypeDefinitions[]; relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[]; migrations: RegisteredExtensionSchemaMigrationDefinition[]; profiles: RegisteredExtensionProjectProfile[]; importers: RegisteredExtensionImporter[]; exporters: RegisteredExtensionExporter[]; search_providers: RegisteredExtensionSearchProvider[]; vector_store_adapters: RegisteredExtensionVectorStoreAdapter[]; }"
+          "signature": "export interface ExtensionRegistrationRegistry { commands: RegisteredExtensionCommandDefinition[]; flags: RegisteredExtensionFlagDefinitions[]; item_fields: RegisteredExtensionSchemaFieldDefinitions[]; item_types: RegisteredExtensionSchemaItemTypeDefinitions[]; relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[]; migrations: RegisteredExtensionSchemaMigrationDefinition[]; profiles: RegisteredExtensionProjectProfile[]; importers: RegisteredExtensionImporter[]; exporters: RegisteredExtensionExporter[]; search_providers: RegisteredExtensionSearchProvider[]; vector_store_adapters: RegisteredExtensionVectorStoreAdapter[]; assurance_providers: RegisteredExtensionAssuranceMeasurementProvider[]; }"
         },
         {
           "classification": "supported",
@@ -5184,7 +5408,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "GlobalOptions",
-          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
+          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -5498,6 +5722,12 @@
           "name": "hashDocument",
           "signature": "(document: ItemDocument) => string | calls: (document: ItemDocument) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hashDocumentForVersion",
+          "signature": "(document: ItemDocument, version: HistoryItemHashVersion) => string | calls: (document: ItemDocument, version: HistoryItemHashVersion) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5538,7 +5768,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HealthCheck",
-          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; details: Record<string, unknown>; }"
+          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -5708,6 +5938,12 @@
           "name": "historyEntryMatchesProvenance",
           "signature": "(entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean | calls: (entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "HistoryItemHashVersion",
+          "signature": "export type HistoryItemHashVersion = (typeof SUPPORTED_HISTORY_ITEM_HASH_VERSIONS)[number];"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -6062,6 +6298,12 @@
           "name": "InstallSource",
           "signature": "export type InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isAlreadyClaimedError",
+          "signature": "(error: unknown) => boolean | calls: (error: unknown) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6270,7 +6512,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "advanced_export",
@@ -6900,13 +7142,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -6930,7 +7172,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -8160,7 +8402,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
-          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\"]"
+          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\", \"services.assuranceprovider\"]"
         },
         {
           "classification": "contract_data",
@@ -8238,7 +8480,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS",
-          "signature": "readonly [{ readonly command: \"activity\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"provenance\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }, { readonly command: \"history\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"raw_history\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }]"
+          "signature": "readonly [{ readonly command: \"activity\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly digest: readonly [{ readonly name: \"event_rows\"; readonly restore_with: \"--raw\"; }]; readonly compact: readonly [{ readonly name: \"provenance\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }, { readonly command: \"history\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"raw_history\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }]"
         },
         {
           "classification": "supported",
@@ -8292,7 +8534,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "supported",
@@ -8334,7 +8576,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "PM_READ_ROW_CONTRACTS",
-          "signature": "{ readonly context: { readonly row_keys: readonly [\"high_level\", \"low_level\"]; readonly fields: \"supported\"; }; readonly get: { readonly row_keys: readonly [\"children\"]; readonly fields: \"supported\"; }; readonly list: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly next: { readonly row_keys: readonly [\"recommended\", \"ready\", \"decision_needed\", \"blocked\", \"held_by_others\"]; readonly fields: \"unsupported\"; }; readonly search: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly activity: { readonly row_keys: readonly [\"compact_activity\", \"provenance_activity\", \"activity\"]; readonly fields: \"unsupported\"; }; readonly history: { readonly row_keys: readonly [\"compact_history\", \"provenance_history\", \"history\"]; readonly fields: \"unsupported\"; }; readonly deps: { readonly row_keys: readonly [\"graph.nodes\", \"graph.edges\", \"context.nodes\", \"context.edges\"]; readonly fields: \"unsupported\"; }; readonly health: { readonly row_keys: readonly [\"checks\"]; readonly fields: \"unsupported\"; }; readonly aggregate: { readonly row_keys: readonly [\"groups\"]; readonly fields: \"unsupported\"; }; readonly duplicates: { readonly row_keys: readonly [\"clusters\"]; readonly fields: \"unsupported\"; }; readonly stats: { readonly row_keys: readonly [\"by_type\", \"by_status\"]; readonly fields: \"unsupported\"; }; readonly comments: { readonly row_keys: readonly [\"comments\"]; readonly fields: \"unsupported\"; }; readonly notes: { readonly row_keys: readonly [\"notes\"]; readonly fields: \"unsupported\"; }; readonly learnings: { readonly row_keys: readonly [\"learnings\"]; readonly fields: \"unsupported\"; }; readonly files: { readonly row_keys: readonly [\"files\"]; readonly fields: \"unsupported\"; }; readonly docs: { readonly row_keys: readonly [\"docs\"]; readonly fields: \"unsupported\"; }; readonly validate: { readonly row_keys: readonly [\"checks\", \"warnings\"]; readonly fields: \"unsupported\"; }; readonly contracts: { readonly row_keys: readonly [\"command_summaries\", \"commands\"]; readonly fields: \"unsupported\"; }; }"
+          "signature": "{ readonly context: { readonly row_keys: readonly [\"high_level\", \"low_level\"]; readonly fields: \"supported\"; }; readonly get: { readonly row_keys: readonly [\"children\"]; readonly fields: \"supported\"; }; readonly list: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly next: { readonly row_keys: readonly [\"recommended\", \"ready\", \"decision_needed\", \"blocked\", \"held_by_others\"]; readonly fields: \"unsupported\"; }; readonly search: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly activity: { readonly row_keys: readonly [\"activity_digest\", \"compact_activity\", \"provenance_activity\", \"activity\"]; readonly fields: \"unsupported\"; }; readonly history: { readonly row_keys: readonly [\"compact_history\", \"provenance_history\", \"history\"]; readonly fields: \"unsupported\"; }; readonly deps: { readonly row_keys: readonly [\"graph.nodes\", \"graph.edges\", \"context.nodes\", \"context.edges\"]; readonly fields: \"unsupported\"; }; readonly health: { readonly row_keys: readonly [\"checks\"]; readonly fields: \"unsupported\"; }; readonly aggregate: { readonly row_keys: readonly [\"groups\"]; readonly fields: \"unsupported\"; }; readonly duplicates: { readonly row_keys: readonly [\"clusters\"]; readonly fields: \"unsupported\"; }; readonly stats: { readonly row_keys: readonly [\"by_type\", \"by_status\"]; readonly fields: \"unsupported\"; }; readonly comments: { readonly row_keys: readonly [\"comments\"]; readonly fields: \"unsupported\"; }; readonly notes: { readonly row_keys: readonly [\"notes\"]; readonly fields: \"unsupported\"; }; readonly learnings: { readonly row_keys: readonly [\"learnings\"]; readonly fields: \"unsupported\"; }; readonly files: { readonly row_keys: readonly [\"files\"]; readonly fields: \"unsupported\"; }; readonly docs: { readonly row_keys: readonly [\"docs\"]; readonly fields: \"unsupported\"; }; readonly validate: { readonly row_keys: readonly [\"checks\", \"warnings\"]; readonly fields: \"unsupported\"; }; readonly contracts: { readonly row_keys: readonly [\"command_summaries\", \"commands\"]; readonly fields: \"unsupported\"; }; }"
         },
         {
           "classification": "advanced_export",
@@ -8376,7 +8618,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.6.0\""
+          "signature": "\"4.7.0\""
         },
         {
           "classification": "contract_data",
@@ -8490,7 +8732,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "PmCliErrorRecoveryPayload",
-          "signature": "export interface PmCliErrorRecoveryPayload { recovery_mode?: \"compact\"; attempted_command?: string; normalized_args?: string[]; provided_fields?: string[]; missing?: string[]; missing_required_fields?: string[]; suggested_flags?: string[]; allowed_values?: string[]; candidate_commands?: string[]; candidate_commands_total?: number; candidate_commands_truncated?: boolean; suggested_retry?: string; retry_after_ms?: number; fallback_candidates?: Array<{ source: string; command: string; reason: string; }>; next_best_command?: string; }"
+          "signature": "export interface PmCliErrorRecoveryPayload { recovery_mode?: \"compact\"; attempted_command?: string; normalized_args?: string[]; parsed_positionals?: Array<{ role: string; value: string; }>; provided_fields?: string[]; missing?: string[]; missing_required_fields?: string[]; suggested_flags?: string[]; allowed_values?: string[]; candidate_commands?: string[]; candidate_commands_total?: number; candidate_commands_truncated?: boolean; suggested_retry?: string; retry_after_ms?: number; fallback_candidates?: Array<{ source: string; command: string; reason: string; }>; next_best_command?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -8838,7 +9080,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -8868,7 +9110,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -9368,6 +9610,12 @@
           "name": "projectValidateCounts",
           "signature": "(result: ValidateResult) => ValidateCountsResult | calls: (result: ValidateResult) => ValidateCountsResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "promoteAssuranceAssertion",
+          "signature": "(pmRoot: string, definition: AssuranceAssertionDefinition, enforcement: Exclude<AssuranceEnforcement, \"observe\">, options?: { author?: string; message?: string; }) => Promise<Awaited<ReturnType<typeof putAssuranceDeclaration>>> | calls: (pmRoot: string, definition: AssuranceAssertionDefinition, enforcement: Exclude<AssuranceEnforcement, \"observe\">, options?: { author?: string; message?: string; }) => Promise<Awaited<ReturnType<typeof putAssuranceDeclaration>>>"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -9404,6 +9652,12 @@
           "name": "putAssuranceDeclaration",
           "signature": "(pmRoot: string, kind: AssuranceDeclarationKind, definition: AssuranceDeclaration, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt> | calls: (pmRoot: string, kind: AssuranceDeclarationKind, definition: AssuranceDeclaration, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "putAssuranceDeclarationBundle",
+          "signature": "(pmRoot: string, bundle: AssuranceDeclarationBundle, options?: AssuranceMutationOptions) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, bundle: AssuranceDeclarationBundle, options?: AssuranceMutationOptions) => Promise<AssuranceBundleMutationReceipt>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -9594,7 +9848,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ReadRowContract",
-          "signature": "export interface ReadRowContract { command: string; row_kind: \"collection\" | \"none\"; row_keys: string[]; fields: \"supported\" | \"unsupported\"; jq_selector?: string; }"
+          "signature": "export interface ReadRowContract { command: string; row_kind: \"collection\" | \"none\"; row_keys: string[]; fields: \"supported\" | \"unsupported\"; jq_selector?: string; toon_encoding?: \"tabular_when_uniform\"; }"
         },
         {
           "classification": "advanced_export",
@@ -9950,6 +10204,12 @@
           "name": "registerHarnessSignalDescriptors",
           "signature": "(descriptors: readonly HarnessSignalDescriptor[]) => () => void | calls: (descriptors: readonly HarnessSignalDescriptor[]) => () => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "registerOutputMaterialFieldGroups",
+          "signature": "(result: object, fieldGroups: readonly string[]) => void | calls: (result: object, fieldGroups: readonly string[]) => void"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -9990,7 +10250,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipAuditDelta",
-          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
+          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
         },
         {
           "classification": "supported",
@@ -10002,7 +10262,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "RelationshipAuditFindingCode",
-          "signature": "export type RelationshipAuditFindingCode = \"missing_reference_active\" | \"missing_reference_terminal\" | \"legacy_no_blocker_sentinel\" | \"ordering_cycle\" | \"legacy_ordering_cycle\" | \"duplicate_edge\" | \"legacy_duplicate_edge\" | \"duplicate_dependency_row\" | \"legacy_duplicate_dependency_row\" | \"stale_lifecycle_block\" | \"isolated_active_node\" | \"sparse_active_node\";"
+          "signature": "export type RelationshipAuditFindingCode = (typeof RELATIONSHIP_AUDIT_FINDING_CODES)[number];"
         },
         {
           "classification": "supported",
@@ -10110,7 +10370,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; 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>; }"
         },
         {
           "classification": "supported",
@@ -11078,6 +11338,12 @@
           "name": "resolveReadRowContract",
           "signature": "(command: string, result: Record<string, unknown>) => ReadRowContract | undefined | calls: (command: string, result: Record<string, unknown>) => ReadRowContract | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveRecoveryCommandName",
+          "signature": "(invocationArgv: string[] | undefined) => string | undefined | calls: (invocationArgv: string[] | undefined) => string | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13034,6 +13300,12 @@
           "name": "splitFrontMatter",
           "signature": "(content: string) => { frontMatter: string; body: string; } | calls: (content: string) => { frontMatter: string; body: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "stabilizeReadOutputReceiptEstimates",
+          "signature": "(result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown> | calls: (result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13116,13 +13388,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsCommandOptions",
-          "signature": "export interface StatsCommandOptions { storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
+          "signature": "export interface StatsCommandOptions { includeEmpty?: boolean; storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsResult",
-          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: Record<ItemType, number>; by_status: Record<ItemStatus, number>; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
+          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: StatsTypeBreakdown; by_status: Partial<Record<ItemStatus, number>>; omitted_zero_buckets: number; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -13214,6 +13486,12 @@
           "name": "summarizeMergeReceipt",
           "signature": "(receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary | calls: (receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SUPPORTED_HISTORY_ITEM_HASH_VERSIONS",
+          "signature": "readonly [1, 2]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13428,7 +13706,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestCommandOptions",
-          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
+          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; removeIndex?: Array<string | number>; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
         },
         {
           "classification": "supported",
@@ -13440,7 +13718,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestResult",
-          "signature": "export interface TestResult { ok: boolean; id: string; tests: LinkedTest[]; run_results: TestRunResult[]; failure_categories: Record<LinkedTestFailureCategory, number>; selection?: Omit<LinkedTestRunSelection, \"selected\">; fail_on_skipped_triggered?: boolean; warnings?: string[]; changed: boolean; count: number; measurements?: TestRunMeasurement[]; metric_below?: Array<TestRunMeasurement & { run_id: string; }>; metric_diff?: TestRunMeasurementDiff; }"
+          "signature": "export interface TestResult { ok: boolean; id: string; tests: LinkedTest[]; run_results: TestRunResult[]; failure_categories: Record<LinkedTestFailureCategory, number>; selection?: Omit<LinkedTestRunSelection, \"selected\">; fail_on_skipped_triggered?: boolean; warnings?: string[]; changed: boolean; count: number; removed?: number; measurements?: TestRunMeasurement[]; metric_below?: Array<TestRunMeasurement & { run_id: string; }>; metric_diff?: TestRunMeasurementDiff; }"
         },
         {
           "classification": "advanced_export",
@@ -13944,7 +14222,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ValidateCheck",
-          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; details: Record<string, unknown>; }"
+          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -14096,6 +14374,12 @@
           "name": "verifyHistoryChain",
           "signature": "(entries: HistoryEntry[]) => { ok: boolean; errors: string[]; } | calls: (entries: HistoryEntry[]) => { ok: boolean; errors: string[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyHistoryChainWithVersion",
+          "signature": "(entries: HistoryEntry[]) => { ok: boolean; errors: string[]; item_hash_version?: HistoryItemHashVersion; } | calls: (entries: HistoryEntry[]) => { ok: boolean; errors: string[]; item_hash_version?: HistoryItemHashVersion; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -14568,7 +14852,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "createExtensionContributionInventory",
-          "signature": "(summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory | calls: (summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory"
+          "signature": "(summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory | calls: (summary: { commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: string[]; renderer_overrides: string[]; renderer_ownership?: ExtensionContributionInventory[\"renderer_ownership\"]; preflight_overrides: number; preflight_ownership?: ExtensionContributionInventory[\"preflight_ownership\"]; }) => ExtensionContributionInventory"
         },
         {
           "classification": "supported",
@@ -14778,7 +15062,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
-          "signature": "{ readonly commands: readonly [\"registerCommand\", \"command override\", \"command handler\"]; readonly renderers: readonly [\"registerRenderer\"]; readonly hooks: readonly [\"hooks.beforeCommand\", \"hooks.beforeMutation\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"]; readonly schema: readonly [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerRelationshipKinds\", \"registerMigration\", \"registerProfile\"]; readonly importers: readonly [\"registerImporter\", \"registerExporter\"]; readonly search: readonly [\"registerSearchProvider\", \"registerVectorStoreAdapter\"]; readonly parser: readonly [\"registerParser\"]; readonly preflight: readonly [\"registerPreflight\"]; readonly services: readonly [\"registerService\"]; }"
+          "signature": "{ readonly commands: readonly [\"registerCommand\", \"command override\", \"command handler\"]; readonly renderers: readonly [\"registerRenderer\"]; readonly hooks: readonly [\"hooks.beforeCommand\", \"hooks.beforeMutation\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"]; readonly schema: readonly [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerRelationshipKinds\", \"registerMigration\", \"registerProfile\"]; readonly importers: readonly [\"registerImporter\", \"registerExporter\"]; readonly search: readonly [\"registerSearchProvider\", \"registerVectorStoreAdapter\"]; readonly parser: readonly [\"registerParser\"]; readonly preflight: readonly [\"registerPreflight\"]; readonly services: readonly [\"registerService\", \"registerAssuranceMeasurementProvider\"]; }"
         },
         {
           "classification": "supported",
@@ -14790,7 +15074,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXTENSION_POLICY_SURFACES",
-          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\"]"
+          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\", \"services.assuranceprovider\"]"
         },
         {
           "classification": "supported",
@@ -14814,13 +15098,13 @@
           "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?: ImportExportRegistrationOptions): void; registerSearchProvider(provider: SearchProviderDefinition): void; registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): 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): 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?: ImportExportRegistrationOptions): 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",
           "kind": "interface",
           "name": "ExtensionBlueprint",
-          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
+          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; assuranceProviders?: AssuranceMeasurementProviderDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -14898,7 +15182,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionContributionInventory",
-          "signature": "export interface ExtensionContributionInventory { schema_version: 1; commands?: string[]; command_overrides?: string[]; command_handlers?: string[]; hooks?: string[]; flag_commands?: string[]; item_types?: string[]; item_fields?: string[]; relationship_kinds?: string[]; migrations?: string[]; profiles?: string[]; importers?: string[]; exporters?: string[]; search_providers?: string[]; vector_store_adapters?: string[]; parser_overrides?: string[]; service_overrides?: string[]; renderer_overrides?: string[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides?: number; preflight_ownership?: Array<{ commands: string[]; }>; }"
+          "signature": "export interface ExtensionContributionInventory { schema_version: 1; commands?: string[]; command_overrides?: string[]; command_handlers?: string[]; hooks?: string[]; flag_commands?: string[]; item_types?: string[]; item_fields?: string[]; relationship_kinds?: string[]; migrations?: string[]; profiles?: string[]; importers?: string[]; exporters?: string[]; search_providers?: string[]; vector_store_adapters?: string[]; assurance_providers?: string[]; parser_overrides?: string[]; service_overrides?: string[]; renderer_overrides?: string[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides?: number; preflight_ownership?: Array<{ commands: string[]; }>; }"
         },
         {
           "classification": "supported",
@@ -15066,7 +15350,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionRegistrationRegistry",
-          "signature": "export interface ExtensionRegistrationRegistry { commands: RegisteredExtensionCommandDefinition[]; flags: RegisteredExtensionFlagDefinitions[]; item_fields: RegisteredExtensionSchemaFieldDefinitions[]; item_types: RegisteredExtensionSchemaItemTypeDefinitions[]; relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[]; migrations: RegisteredExtensionSchemaMigrationDefinition[]; profiles: RegisteredExtensionProjectProfile[]; importers: RegisteredExtensionImporter[]; exporters: RegisteredExtensionExporter[]; search_providers: RegisteredExtensionSearchProvider[]; vector_store_adapters: RegisteredExtensionVectorStoreAdapter[]; }"
+          "signature": "export interface ExtensionRegistrationRegistry { commands: RegisteredExtensionCommandDefinition[]; flags: RegisteredExtensionFlagDefinitions[]; item_fields: RegisteredExtensionSchemaFieldDefinitions[]; item_types: RegisteredExtensionSchemaItemTypeDefinitions[]; relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[]; migrations: RegisteredExtensionSchemaMigrationDefinition[]; profiles: RegisteredExtensionProjectProfile[]; importers: RegisteredExtensionImporter[]; exporters: RegisteredExtensionExporter[]; search_providers: RegisteredExtensionSearchProvider[]; vector_store_adapters: RegisteredExtensionVectorStoreAdapter[]; assurance_providers: RegisteredExtensionAssuranceMeasurementProvider[]; }"
         },
         {
           "classification": "supported",
@@ -16578,7 +16862,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
-          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\"]"
+          "signature": "readonly [\"commands.override\", \"commands.handler\", \"hooks.beforecommand\", \"hooks.beforemutation\", \"hooks.aftercommand\", \"hooks.onwrite\", \"hooks.onread\", \"hooks.onindex\", \"schema.flags\", \"schema.itemfields\", \"schema.itemtypes\", \"schema.relationshipkinds\", \"schema.migrations\", \"schema.profiles\", \"parser.override\", \"preflight.override\", \"services.override\", \"renderers.override\", \"importers.importer\", \"importers.exporter\", \"search.provider\", \"search.vectorstore\", \"services.assuranceprovider\"]"
         },
         {
           "classification": "contract_data",
@@ -16632,7 +16916,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "contract_data",
@@ -16692,7 +16976,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.6.0\""
+          "signature": "\"4.7.0\""
         },
         {
           "classification": "contract_data",
@@ -16986,7 +17270,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "contract_data",
@@ -17010,7 +17294,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "contract_data",
@@ -17240,6 +17524,12 @@
           "name": "SEARCH_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "stabilizeReadOutputReceiptEstimates",
+          "signature": "(result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown> | calls: (result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown>"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -17628,13 +17918,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceActionInput",
-          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; preset?: string; owner?: string; apply?: boolean; enforcement?: string; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "AssuranceActionResult",
-          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | AssuranceBundleMutationReceipt | AssurancePreset | { items: AssuranceDerivedProposal[]; count: number; applied?: AssuranceBundleMutationReceipt; } | { items: Array<{ id: AssurancePresetId; title: string; description: string; }>; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
         },
         {
           "classification": "supported",
@@ -18008,6 +18298,12 @@
           "name": "HarnessSignalDescriptor",
           "signature": "export interface HarnessSignalDescriptor { harness: string; environment_keys?: readonly string[]; model_environment_keys?: readonly string[]; session_environment_keys?: readonly string[]; provenance_environment_keys?: Readonly<Record<string, readonly string[] | undefined>>; provenance_resolvers?: Readonly<Record<string, AgentProvenanceResolver | undefined>>; provenance_unavailable_dimensions?: readonly string[]; argv_markers?: readonly string[]; client_names?: readonly string[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isAlreadyClaimedError",
+          "signature": "(error: unknown) => boolean | calls: (error: unknown) => boolean"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -18192,7 +18488,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "supported",
@@ -18270,7 +18566,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -18294,7 +18590,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -18756,7 +19052,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HealthCheck",
-          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; details: Record<string, unknown>; }"
+          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -19134,7 +19430,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ValidateCheck",
-          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; details: Record<string, unknown>; }"
+          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -19860,7 +20156,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipAuditDelta",
-          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
+          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
         },
         {
           "classification": "supported",
@@ -19872,7 +20168,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "RelationshipAuditFindingCode",
-          "signature": "export type RelationshipAuditFindingCode = \"missing_reference_active\" | \"missing_reference_terminal\" | \"legacy_no_blocker_sentinel\" | \"ordering_cycle\" | \"legacy_ordering_cycle\" | \"duplicate_edge\" | \"legacy_duplicate_edge\" | \"duplicate_dependency_row\" | \"legacy_duplicate_dependency_row\" | \"stale_lifecycle_block\" | \"isolated_active_node\" | \"sparse_active_node\";"
+          "signature": "export type RelationshipAuditFindingCode = (typeof RELATIONSHIP_AUDIT_FINDING_CODES)[number];"
         },
         {
           "classification": "supported",
@@ -19980,7 +20276,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; 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>; }"
         },
         {
           "classification": "supported",
@@ -20496,7 +20792,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "supported",
@@ -20532,13 +20828,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -20562,7 +20858,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -20772,7 +21068,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityCommandOptions",
-          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
+          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; raw?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -20784,7 +21080,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityResult",
-          "signature": "export interface ActivityResult { activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"compact\" | \"provenance\" | \"full\"; row_key: \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; provenance_summary?: HistoryProvenanceSummary; }"
+          "signature": "export interface ActivityResult { activity_digest?: ActivityDigestEntry[]; activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"digest\" | \"compact\" | \"provenance\" | \"full\"; row_key: \"activity_digest\" | \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; activity_summary?: { window: { from: string | null; to: string | null; }; event_count: number; item_count: number; author_count: number; operation_counts: Record<string, number>; }; provenance_summary?: HistoryProvenanceSummary; }"
         },
         {
           "classification": "supported",
@@ -22344,13 +22640,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AssuranceActionInput",
-          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; preset?: string; owner?: string; apply?: boolean; enforcement?: string; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "AssuranceActionResult",
-          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | AssuranceBundleMutationReceipt | AssurancePreset | { items: AssuranceDerivedProposal[]; count: number; applied?: AssuranceBundleMutationReceipt; } | { items: Array<{ id: AssurancePresetId; title: string; description: string; }>; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
         },
         {
           "classification": "supported",
@@ -22986,7 +23282,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "GlobalOptions",
-          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
+          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -23658,7 +23954,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -23676,7 +23972,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -24522,13 +24818,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsCommandOptions",
-          "signature": "export interface StatsCommandOptions { storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
+          "signature": "export interface StatsCommandOptions { includeEmpty?: boolean; storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsResult",
-          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: Record<ItemType, number>; by_status: Record<ItemStatus, number>; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
+          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: StatsTypeBreakdown; by_status: Partial<Record<ItemStatus, number>>; omitted_zero_buckets: number; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -25038,13 +25334,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionActivationSummary",
-          "signature": "export interface ExtensionActivationSummary { capabilities: ExtensionCapability[]; commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; parser_overrides: string[]; service_overrides: ExtensionServiceName[]; renderer_overrides: OutputRendererFormat[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides: number; preflight_ownership: Array<{ commands: string[]; }>; }"
+          "signature": "export interface ExtensionActivationSummary { capabilities: ExtensionCapability[]; commands: string[]; command_overrides: string[]; command_handlers: string[]; hooks: string[]; flag_commands: string[]; item_types: string[]; item_fields: string[]; relationship_kinds?: string[]; migrations: string[]; profiles: string[]; importers: string[]; exporters: string[]; search_providers: string[]; vector_store_adapters: string[]; assurance_providers?: string[]; parser_overrides: string[]; service_overrides: ExtensionServiceName[]; renderer_overrides: OutputRendererFormat[]; renderer_ownership?: Array<{ format: OutputRendererFormat; commands: string[]; result_discriminator: boolean; }>; preflight_overrides: number; preflight_ownership: Array<{ commands: string[]; }>; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ExtensionBlueprint",
-          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
+          "signature": "export interface ExtensionBlueprint { manifest?: ExtensionManifest; commands?: CommandDefinition[]; commandOverrides?: Record<string, CommandOverride>; flags?: Record<string, FlagDefinition[]>; parsers?: Record<string, ParserOverride>; renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>; services?: Partial<Record<ExtensionServiceName, ServiceOverride>>; preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>; itemTypes?: SchemaItemTypeDefinition[]; itemFields?: SchemaFieldDefinition[]; relationshipKinds?: RelationshipKindDefinition[]; migrations?: SchemaMigrationDefinition[]; profiles?: ProjectProfileRegistrationInput[]; searchProviders?: SearchProviderDefinition[]; vectorStoreAdapters?: VectorStoreAdapterDefinition[]; assuranceProviders?: AssuranceMeasurementProviderDefinition[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -25429,8 +25725,10 @@
     "already_claimed_by",
     "ambiguous_list_all",
     "ambiguous_option_combination",
+    "annotation_alias_conflict",
     "annotation_flag_like_value",
     "annotation_message_without_text",
+    "annotation_transposed_subcommand",
     "append_empty_body",
     "assurance_registry_invalid",
     "body_file_conflicts_with_body",
@@ -25444,6 +25742,7 @@
     "close_through_update",
     "close_validation_missing_fields",
     "collected_zero_items",
+    "collection_transposed_subcommand",
     "command_failed",
     "command_namespace",
     "command_override_conflict",
@@ -25541,6 +25840,8 @@
     "item_id_collision",
     "item_not_found",
     "likely_duplicate",
+    "linked_artifact_mutation_conflict",
+    "linked_test_remove_no_match",
     "linked_test_value_not_quoted",
     "list_source_incomplete",
     "local_package_archive_unsafe",