@unbrained/pm-cli 2026.8.5 → 2026.8.7

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1432,
+    "covered_symbols": 1441,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,788 +8,18 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1433
+    "required_symbols": 1442
   },
   "breaking_acknowledgements": [
     {
       "changes": [
-        "signature ./sdk:DeleteResult",
-        "signature ./sdk:PmCliError",
-        "signature ./sdk:PmCliErrorContext",
-        "signature ./sdk/core:DeleteResult",
-        "signature ./sdk/core:PmCliError",
-        "signature ./sdk/runtime:DeleteResult",
-        "signature ./sdk/runtime:PmCliError"
+        "signature ./sdk:PmReadOutputResult",
+        "signature ./sdk/contracts:PmReadOutputResult",
+        "signature ./sdk/core:PmReadOutputResult",
+        "signature ./sdk/runtime:PmReadOutputResult"
       ],
-      "package_version": "2026.7.25",
-      "reason": "Additive structured context, tombstone result, and context-integrity SDK contracts for the 2026.7.25 release"
-    },
-    {
-      "changes": [
-        "signature ./sdk/governance:_testOnlySimilarity"
-      ],
-      "package_version": "2026.7.25",
-      "reason": "Additive deterministic duplicate-cluster verification seams for the 2026.7.25 release"
-    },
-    {
-      "changes": [
-        "signature ./sdk:HarnessDetectionSignals",
-        "signature ./sdk:PmSettings",
-        "signature ./sdk:ResolvedAuthorIdentity",
-        "signature ./sdk/core:HarnessDetectionSignals",
-        "signature ./sdk/core:PmSettings",
-        "signature ./sdk/core:ResolvedAuthorIdentity",
-        "signature ./sdk/runtime:PmSettings"
-      ],
-      "package_version": "2026.7.25",
-      "reason": "Additive optional agent provenance and required default-backed settings registry contract tracked by pm-qwuber and pm-03pq3o"
-    },
-    {
-      "changes": [
-        "signature ./sdk:PmSettings",
-        "signature ./sdk/core:PmSettings",
-        "signature ./sdk/runtime:PmSettings"
-      ],
-      "package_version": "2026.7.25",
-      "reason": "Add optional structured agent provenance and workspace harness registry contracts tracked by pm-qwuber and pm-03pq3o"
-    },
-    {
-      "changes": [
-        "signature ./sdk:SecretGuardFinding",
-        "signature ./sdk/governance:SecretGuardFinding"
-      ],
-      "package_version": "2026.7.25",
-      "reason": "Expose npm_token and slack_token detector rules in the documented SecretGuardFinding union"
-    },
-    {
-      "changes": [
-        "signature ./sdk:DetectedAgentIdentity",
-        "signature ./sdk:ItemMetadata",
-        "signature ./sdk/core:DetectedAgentIdentity",
-        "signature ./sdk/core:ItemMetadata",
-        "signature ./sdk/runtime:ItemMetadata"
-      ],
-      "package_version": "2026.7.26",
-      "reason": "Add privacy-safe optional agent instance and claim principal metadata plus exhaustive action coverage APIs"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ImportExportContext",
-        "signature ./sdk:PM_TOOL_ACTION_PARAMETER_CONTRACTS",
-        "signature ./sdk:PM_TOOL_ACTIONS",
-        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk:PmClient",
-        "signature ./sdk:ServiceOverride",
-        "signature ./sdk/authoring:ImportExportContext",
-        "signature ./sdk/authoring:ServiceOverride",
-        "signature ./sdk/contracts:PM_TOOL_ACTION_PARAMETER_CONTRACTS",
-        "signature ./sdk/contracts:PM_TOOL_ACTIONS",
-        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/runtime:PmClient",
-        "symbol ./sdk:_testOnlyCliContracts removed"
-      ],
-      "package_version": "2026.7.26",
-      "reason": "Additive aggregate, duplicate discovery, isolated runtime, host SDK context, and explicit service decision contracts; legacy handlers remain supported"
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_CORE_COMMAND_NAMES",
-        "signature ./sdk/contracts:PM_CORE_COMMAND_NAMES"
-      ],
-      "package_version": "2026.7.26",
-      "reason": "Add the already-exposed duplicates CLI to the canonical core-command tuple so action availability and extension reservations are truthful."
-    },
-    {
-      "changes": [
-        "signature ./sdk:handleServiceOverride",
-        "signature ./sdk/authoring:handleServiceOverride"
-      ],
-      "package_version": "2026.7.26",
-      "reason": "Move the public surface to a first-class package artifact and correct aggregate exclusion accounting plus additive command contracts."
-    },
-    {
-      "changes": [
-        "signature ./sdk:HistoryRepairCommandOptions",
-        "signature ./sdk:ItemDocumentMergeResult",
-        "signature ./sdk:MergeDriverResult",
-        "signature ./sdk:MergeReconcileResult",
-        "signature ./sdk/merge:ItemDocumentMergeResult",
-        "signature ./sdk/merge:MergeDriverResult",
-        "signature ./sdk/merge:MergeReconcileResult"
-      ],
-      "package_version": "2026.7.26",
-      "reason": "Add audited merge receipt provenance and reconciliation result fields for durable branch-merge conformance"
-    },
-    {
-      "changes": [
-        "signature ./sdk:AgentClientInfo",
-        "signature ./sdk:AgentModelSource",
-        "signature ./sdk:DetectedAgentIdentity",
-        "signature ./sdk:HarnessDetectionSignals",
-        "signature ./sdk:HarnessSignalDescriptor",
-        "signature ./sdk:PmSettings",
-        "signature ./sdk:TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk:TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk/contracts:TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk/contracts:TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk/core:AgentClientInfo",
-        "signature ./sdk/core:AgentModelSource",
-        "signature ./sdk/core:DetectedAgentIdentity",
-        "signature ./sdk/core:HarnessDetectionSignals",
-        "signature ./sdk/core:HarnessSignalDescriptor",
-        "signature ./sdk/core:PmSettings",
-        "signature ./sdk/runtime:PmSettings"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "Extend optional agent provenance and strict action option contracts while preserving legacy model fields and runtime behavior"
-    },
-    {
-      "changes": [
-        "signature ./sdk:Dependency",
-        "signature ./sdk:ListOptions",
-        "signature ./sdk/core:Dependency",
-        "signature ./sdk/core:ListOptions",
-        "signature ./sdk/query:ListOptions",
-        "signature ./sdk/runtime:Dependency",
-        "signature ./sdk/runtime:ListOptions"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "Additive optional list strict-read and dependency provenance fields; result completeness is a required truthfulness contract in the new minor release"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ContractsResult",
-        "signature ./sdk:ListCompactResult",
-        "signature ./sdk:MergeFenceAuditResult",
-        "signature ./sdk:MergeInstallResult",
-        "signature ./sdk/merge:MergeFenceAuditResult",
-        "signature ./sdk/merge:MergeInstallResult",
-        "signature ./sdk/query:ListCompactResult",
-        "signature ./sdk/runtime:ContractsResult",
-        "signature ./sdk/runtime:ListCompactResult"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "List results now identify brief and compact projections explicitly, contracts expose per-command projection defaults, and merge-fence results declare project schema scope; consumers should accept the new metadata fields and brief mode."
-    },
-    {
-      "changes": [
-        "signature ./sdk:ContractsResult",
-        "signature ./sdk/runtime:ContractsResult"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "pm-gmdzaa makes unfiltered contracts summary-first and adds optional output policy metadata; full:true preserves the complete contract surface"
-    },
-    {
-      "changes": [
-        "signature ./sdk:WorkspaceContracts",
-        "signature ./sdk/runtime:WorkspaceContracts"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "WorkspaceContracts gains optional additive runtime field and extension command discovery metadata"
-    },
-    {
-      "changes": [
-        "signature ./sdk:CommandDefinition",
-        "signature ./sdk:RegisteredExtensionCommandDefinition",
-        "signature ./sdk:WorkspaceExtensionCommandContract",
-        "signature ./sdk/authoring:CommandDefinition",
-        "signature ./sdk/runtime:WorkspaceExtensionCommandContract"
-      ],
-      "package_version": "2026.7.27",
-      "reason": "Additive optional workspace capability metadata and extension command visibility tier"
-    },
-    {
-      "changes": [
-        "signature ./sdk:MergeInstallResult",
-        "signature ./sdk/merge:MergeInstallResult"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Add optional canonical pm_root metadata to merge-install results while preserving existing fields"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ExtensionBlueprintLintCode",
-        "signature ./sdk/authoring:ExtensionBlueprintLintCode",
-        "signature ./sdk/testing:ExtensionBlueprintLintCode"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Extension blueprint lint now rejects host-owned and malformed long flags before activation; exhaustive lint-code consumers should handle host_owned_flag_collision and malformed_long_flag."
-    },
-    {
-      "changes": [
-        "signature ./sdk:defineWorkspaceRecipe",
-        "signature ./sdk:WorkspaceRecipeOperation"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Export snapshot schema and strengthen workspace recipe JSON/exact-key contracts"
-    },
-    {
-      "changes": [
-        "signature ./sdk:CLOSE_ACTION_OPTION_KEYS",
-        "signature ./sdk:CloseCommandOptions",
-        "signature ./sdk:ContextFocusItem",
-        "signature ./sdk:ItemMetadata",
-        "signature ./sdk:NestedSettingResultValue",
-        "signature ./sdk:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk:UpdateCommandOptions",
-        "signature ./sdk:WorkspaceMemorySelection",
-        "signature ./sdk:WorkspaceMemorySnapshot",
-        "signature ./sdk/contracts:CLOSE_ACTION_OPTION_KEYS",
-        "signature ./sdk/contracts:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk/core:ItemMetadata",
-        "signature ./sdk/query:WorkspaceMemorySelection",
-        "signature ./sdk/query:WorkspaceMemorySnapshot",
-        "signature ./sdk/runtime:CloseCommandOptions",
-        "signature ./sdk/runtime:ContextFocusItem",
-        "signature ./sdk/runtime:ItemMetadata",
-        "signature ./sdk/runtime:UpdateCommandOptions"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Add optional completion timestamps, blocker provenance, and configuration metadata while preserving existing inputs and fallbacks (pm-bwnclq, pm-r2suqb, pm-5ecnar)."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PmUpdateManyActionOptions",
-        "signature ./sdk/contracts:PmUpdateManyActionOptions"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Add optional completion timestamps, blocker provenance, and configuration metadata while preserving existing inputs and fallbacks (pm-bwnclq, pm-r2suqb, pm-5ecnar)."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PmCloseManyActionOptions",
-        "signature ./sdk/contracts:PmCloseManyActionOptions"
-      ],
-      "package_version": "2026.7.28",
-      "reason": "Expose completedAt on close-many typed SDK inputs for lifecycle parity"
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_COMMAND_OUTPUT_BUDGET_CONTRACTS",
-        "signature ./sdk:PM_CORE_COMMAND_NAMES",
-        "signature ./sdk:TestCommandOptions",
-        "signature ./sdk:TestResult",
-        "signature ./sdk/contracts:PM_COMMAND_OUTPUT_BUDGET_CONTRACTS",
-        "signature ./sdk/contracts:PM_CORE_COMMAND_NAMES"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "Additive workspace command, eval contract, and typed test measurement SDK primitives for pm-1jrdri pm-wd61s2 pm-ygerpy"
-    },
-    {
-      "changes": [
-        "symbol ./sdk:EvalQuery removed",
-        "symbol ./sdk:EvalQuerySet removed",
-        "symbol ./sdk:EvalSearchMode removed"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "Keep EvalSearchMode package-owned while exposing versioned eval query values and parser from the aggregate SDK"
-    },
-    {
-      "changes": [
-        "signature ./sdk:resolveCompletionTimestamp",
-        "signature ./sdk:ResolvedCompletionTimestamp"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "GH-808 replaces an unsound always-resolved declaration with an explicit discriminated unresolved outcome"
-    },
-    {
-      "changes": [
-        "signature ./sdk:CorpusShape",
-        "signature ./sdk:CorpusShapeProfile",
-        "signature ./sdk:defineCorpusShape"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "Correct unpublished PR corpus-shape draft before merge"
-    },
-    {
-      "changes": [
-        "signature ./sdk:DepsCommandOptions",
-        "signature ./sdk:DepsResult",
-        "signature ./sdk:GraphCommandOptions",
-        "signature ./sdk:runGraph",
-        "signature ./sdk:RunHealthOptions",
-        "signature ./sdk:ValidateCommandOptions",
-        "signature ./sdk:ValidateResult",
-        "signature ./sdk/core:DepsCommandOptions",
-        "signature ./sdk/core:DepsResult",
-        "signature ./sdk/governance:RunHealthOptions",
-        "signature ./sdk/governance:ValidateCommandOptions",
-        "signature ./sdk/governance:ValidateResult",
-        "signature ./sdk/graph:GraphCommandOptions",
-        "signature ./sdk/graph:runGraph",
-        "signature ./sdk/runtime:DepsCommandOptions",
-        "signature ./sdk/runtime:DepsResult",
-        "signature ./sdk/runtime:RunHealthOptions",
-        "signature ./sdk/runtime:ValidateCommandOptions",
-        "signature ./sdk/runtime:ValidateResult"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "Additive bounded-read controls and guaranteed projection receipts; runtime defaults remain compatible"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ContractsResult",
-        "signature ./sdk/runtime:ContractsResult"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "ContractsResult gains additive optional context_intents and error_codes full-projection fields"
-    },
-    {
-      "changes": [
-        "error code context_intent_unsupported removed"
-      ],
-      "package_version": "2026.7.29",
-      "reason": "ContractsResult additive full-projection fields and context-intent schema parameters"
-    },
-    {
-      "changes": [
-        "signature ./sdk:_testOnlyHealthCommand",
-        "signature ./sdk:analyzeGraphImpact",
-        "signature ./sdk:GraphImpactResult",
-        "signature ./sdk:RelationshipImpactAnalysis",
-        "signature ./sdk/governance:_testOnlyHealthCommand",
-        "signature ./sdk/graph:analyzeGraphImpact",
-        "signature ./sdk/graph:GraphImpactResult",
-        "signature ./sdk/graph:RelationshipImpactAnalysis"
-      ],
-      "package_version": "2026.7.30",
-      "reason": "Additive optional cursor, row, intent, and health projection contracts; no existing callable behavior or required member was removed"
-    },
-    {
-      "changes": [
-        "signature ./sdk:acquireItemMetadataDerivedIndexLock",
-        "signature ./sdk:CommandHandlerResult",
-        "signature ./sdk:FlagDefinition",
-        "signature ./sdk:SchemaFieldDefinition",
-        "signature ./sdk:SchemaItemTypeCommandOptionPolicyDefinition",
-        "signature ./sdk:SchemaItemTypeOptionDefinition",
-        "signature ./sdk/authoring:CommandHandlerResult",
-        "signature ./sdk/authoring:FlagDefinition",
-        "signature ./sdk/authoring:SchemaFieldDefinition",
-        "signature ./sdk/authoring:SchemaItemTypeCommandOptionPolicyDefinition",
-        "signature ./sdk/authoring:SchemaItemTypeOptionDefinition",
-        "signature ./sdk/query:acquireItemMetadataDerivedIndexLock",
-        "signature ./sdk/runtime:FlagDefinition"
-      ],
-      "package_version": "2026.7.30",
-      "reason": "Close extension authoring metadata contracts to reject misspelled properties and add explicit structured failure and required-lock fields."
-    },
-    {
-      "changes": [
-        "signature ./sdk:DepsResult",
-        "signature ./sdk:GraphAnalyzeResult",
-        "signature ./sdk:GraphCentralityResult",
-        "signature ./sdk:PM_READ_ROW_CONTRACTS",
-        "signature ./sdk:PM_READ_ROW_JQ_SELECTOR",
-        "signature ./sdk:ReadRowContract",
-        "signature ./sdk:RelationshipCoverageProfile",
-        "signature ./sdk:RelationshipGraphScaleFixture",
-        "signature ./sdk/core:DepsResult",
-        "signature ./sdk/graph:GraphAnalyzeResult",
-        "signature ./sdk/graph:GraphCentralityResult",
-        "signature ./sdk/graph:RelationshipCoverageProfile",
-        "signature ./sdk/graph:RelationshipGraphScaleFixture",
-        "signature ./sdk/runtime:DepsResult"
-      ],
-      "package_version": "2026.7.31",
-      "reason": "Read-row selectors now distinguish scalar envelopes from iterable collections, and every edge count declares its counting basis."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_READ_ROW_CONTRACTS",
-        "signature ./sdk:PM_READ_ROW_JQ_SELECTOR"
-      ],
-      "package_version": "2026.7.31",
-      "reason": "Read-row selectors now distinguish scalar envelopes from iterable collections, resolve nested dependency paths, and every edge count declares its counting basis."
-    },
-    {
-      "changes": [
-        "signature ./sdk:AcknowledgeUnknownAuthorEventsOptions",
-        "signature ./sdk:AnnotationCommandConfig",
-        "signature ./sdk:HistoryAuthorAttributionScan",
-        "signature ./sdk:InitTargetResolution",
-        "signature ./sdk:inspectHistoryAuthorStream",
-        "signature ./sdk:LogNote",
-        "signature ./sdk:NotesCommandOptions",
-        "signature ./sdk:NotesResult",
-        "signature ./sdk:PmCliErrorContext",
-        "signature ./sdk:runAnnotationCommand",
-        "signature ./sdk:RunHealthOptions",
-        "signature ./sdk:scanHistoryAuthorAttribution",
-        "signature ./sdk:SchemaFieldDefinition",
-        "signature ./sdk:WorkspaceFieldContract",
-        "signature ./sdk/authoring:SchemaFieldDefinition",
-        "signature ./sdk/core:NotesCommandOptions",
-        "signature ./sdk/core:NotesResult",
-        "signature ./sdk/governance:AcknowledgeUnknownAuthorEventsOptions",
-        "signature ./sdk/governance:HistoryAuthorAttributionScan",
-        "signature ./sdk/governance:inspectHistoryAuthorStream",
-        "signature ./sdk/governance:RunHealthOptions",
-        "signature ./sdk/governance:scanHistoryAuthorAttribution",
-        "signature ./sdk/runtime:LogNote",
-        "signature ./sdk/runtime:NotesCommandOptions",
-        "signature ./sdk/runtime:NotesResult",
-        "signature ./sdk/runtime:RunHealthOptions",
-        "signature ./sdk/runtime:WorkspaceFieldContract"
-      ],
-      "package_version": "2026.7.31",
-      "reason": "Expand universal SDK context primitives with typed runtime containers, merge-safe structured events, init target provenance, and actionable author diagnostics."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk:PmContextIntentReceipt",
-        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk/contracts:PmContextIntentReceipt"
-      ],
-      "package_version": "2026.7.31",
-      "reason": "Intent receipts now require truthful feasibility and omission state; tool schema 4.3.0 adds tokenBudget to list get and search"
-    },
-    {
-      "changes": [
-        "signature ./sdk:AGENT_PROVENANCE_DIMENSIONS",
-        "signature ./sdk:AgentClientInfo",
-        "signature ./sdk:AgentModelSource",
-        "signature ./sdk:DetectedAgentIdentity",
-        "signature ./sdk:HarnessDetectionSignals",
-        "signature ./sdk:HarnessSignalDescriptor",
-        "signature ./sdk:PmSettings",
-        "signature ./sdk/core:AGENT_PROVENANCE_DIMENSIONS",
-        "signature ./sdk/core:AgentClientInfo",
-        "signature ./sdk/core:AgentModelSource",
-        "signature ./sdk/core:DetectedAgentIdentity",
-        "signature ./sdk/core:HarnessDetectionSignals",
-        "signature ./sdk/core:HarnessSignalDescriptor",
-        "signature ./sdk/core:PmSettings",
-        "signature ./sdk/runtime:PmSettings"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Additive optional session provenance and episode fields broaden identity contracts without removing or requiring existing consumer fields."
-    },
-    {
-      "changes": [
-        "signature ./sdk:AgentEpisodeGroup",
-        "signature ./sdk/core:AgentEpisodeGroup"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Strengthen AgentEpisodeGroup.entries from a possibly empty array to a truthful non-empty tuple; every produced group already contains at least one immutable history event."
-    },
-    {
-      "changes": [
-        "signature ./sdk:assertRegisteredHook",
-        "signature ./sdk:EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
-        "signature ./sdk:EXTENSION_POLICY_SURFACES",
-        "signature ./sdk:ExtensionActivationResult",
-        "signature ./sdk:ExtensionApi",
-        "signature ./sdk:ExtensionBlueprintHooks",
-        "signature ./sdk:ExtensionHookRegistry",
-        "signature ./sdk:ExtensionTestHarness",
-        "signature ./sdk:PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
-        "signature ./sdk:RegisteredHookKind",
-        "signature ./sdk:RunRegisteredCommandForTestOptions",
-        "signature ./sdk/authoring:EXTENSION_CAPABILITY_REGISTRATION_SURFACES",
-        "signature ./sdk/authoring:EXTENSION_POLICY_SURFACES",
-        "signature ./sdk/authoring:ExtensionActivationResult",
-        "signature ./sdk/authoring:ExtensionApi",
-        "signature ./sdk/authoring:ExtensionBlueprintHooks",
-        "signature ./sdk/authoring:ExtensionHookRegistry",
-        "signature ./sdk/contracts:PM_EXTENSION_POLICY_SURFACE_CONTRACTS",
-        "signature ./sdk/testing:assertRegisteredHook",
-        "signature ./sdk/testing:ExtensionTestHarness",
-        "signature ./sdk/testing:RegisteredHookKind",
-        "signature ./sdk/testing:RunRegisteredCommandForTestOptions"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Additive extension mutation guards and host-bound test SDK options extend object contracts while preserving existing calls."
-    },
-    {
-      "changes": [
-        "signature ./sdk:ExtensionHookRegistry",
-        "signature ./sdk/authoring:ExtensionHookRegistry"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Transactional beforeMutation is a required host registry member; package call sites remain source-compatible and receive the field from pm."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_TOOL_ACTION_PARAMETER_CONTRACTS",
-        "signature ./sdk:PM_TOOL_ACTIONS",
-        "signature ./sdk:PmContextIntentReceipt",
-        "signature ./sdk:PmToolAction",
-        "signature ./sdk/contracts:PM_TOOL_ACTION_PARAMETER_CONTRACTS",
-        "signature ./sdk/contracts:PM_TOOL_ACTIONS",
-        "signature ./sdk/contracts:PmContextIntentReceipt",
-        "signature ./sdk/contracts:PmToolAction"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Unify CLI SDK MCP action contracts, add optional budget diagnostics, and expose newly reachable native actions; existing action names and receipt fields remain compatible."
-    },
-    {
-      "changes": [
-        "error code missing_required_parameter removed"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Remove an unshipped generated error-code entry before review; runtime behavior continues to use the established usage-error envelope."
-    },
-    {
-      "changes": [
-        "signature ./sdk:BootstrapGlobalOptions",
-        "signature ./sdk:GlobalOptions",
-        "signature ./sdk/runtime:GlobalOptions"
-      ],
-      "package_version": "2026.8.1",
-      "reason": "Additive optional tokenAccounting output instrumentation flag shared by CLI SDK and MCP"
-    },
-    {
-      "changes": [
-        "signature ./sdk:HistoryRedactResult"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Remove secret-bearing matcher and replacement fields from history-redact results (GH-864)"
-    },
-    {
-      "changes": [
-        "signature ./sdk:PmClient",
-        "signature ./sdk:runTelemetry",
-        "signature ./sdk:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk:UpdateCommandOptions",
-        "signature ./sdk/contracts:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/runtime:PmClient",
-        "signature ./sdk/runtime:UpdateCommandOptions"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Additive SDK reverse-file lookup, atomic evidence replacement, and precise telemetry receipt contracts tracked by pm-f86lth, pm-cstuys, and pm-u5c27w"
-    },
-    {
-      "changes": [
-        "signature ./sdk:BootstrapGlobalOptions",
-        "signature ./sdk:ContractsResult",
-        "signature ./sdk:GlobalOptions",
-        "signature ./sdk:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk:PmClient",
-        "signature ./sdk/contracts:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/runtime:ContractsResult",
-        "signature ./sdk/runtime:GlobalOptions",
-        "signature ./sdk/runtime:PmClient"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Add optional universal read-output controls and request-scoped context-intent declarations while preserving existing SDK call shapes"
-    },
-    {
-      "changes": [
-        "signature ./sdk:applyReadOutputDimensions",
-        "signature ./sdk:PmReadOutputReceipt",
-        "signature ./sdk/contracts:applyReadOutputDimensions",
-        "signature ./sdk/contracts:PmReadOutputReceipt"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Unreleased read-output API now models budget omission as a discriminated union and reports string and row compaction explicitly"
-    },
-    {
-      "changes": [
-        "signature ./sdk:aggregate",
-        "signature ./sdk:comments",
-        "signature ./sdk:context",
-        "signature ./sdk:deps",
-        "signature ./sdk:docs",
-        "signature ./sdk:files",
-        "signature ./sdk:get",
-        "signature ./sdk:graph",
-        "signature ./sdk:health",
-        "signature ./sdk:list",
-        "signature ./sdk:next",
-        "signature ./sdk:notes",
-        "signature ./sdk:PmClient",
-        "signature ./sdk:search",
-        "signature ./sdk:stats",
-        "signature ./sdk:validate",
-        "signature ./sdk/core:aggregate",
-        "signature ./sdk/core:comments",
-        "signature ./sdk/core:context",
-        "signature ./sdk/core:deps",
-        "signature ./sdk/core:docs",
-        "signature ./sdk/core:files",
-        "signature ./sdk/core:get",
-        "signature ./sdk/core:graph",
-        "signature ./sdk/core:list",
-        "signature ./sdk/core:next",
-        "signature ./sdk/core:notes",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/core:search",
-        "signature ./sdk/runtime:aggregate",
-        "signature ./sdk/runtime:comments",
-        "signature ./sdk/runtime:context",
-        "signature ./sdk/runtime:deps",
-        "signature ./sdk/runtime:docs",
-        "signature ./sdk/runtime:files",
-        "signature ./sdk/runtime:get",
-        "signature ./sdk/runtime:graph",
-        "signature ./sdk/runtime:health",
-        "signature ./sdk/runtime:list",
-        "signature ./sdk/runtime:next",
-        "signature ./sdk/runtime:notes",
-        "signature ./sdk/runtime:PmClient",
-        "signature ./sdk/runtime:search",
-        "signature ./sdk/runtime:stats",
-        "signature ./sdk/runtime:validate"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Unreleased budgeted read methods now expose omission-aware conditional results while unbudgeted SDK calls retain their prior result types"
-    },
-    {
-      "changes": [
-        "signature ./sdk:aggregate",
-        "signature ./sdk:comments",
-        "signature ./sdk:context",
-        "signature ./sdk:deps",
-        "signature ./sdk:docs",
-        "signature ./sdk:files",
-        "signature ./sdk:get",
-        "signature ./sdk:graph",
-        "signature ./sdk:health",
-        "signature ./sdk:list",
-        "signature ./sdk:next",
-        "signature ./sdk:notes",
-        "signature ./sdk:PmClient",
-        "signature ./sdk:search",
-        "signature ./sdk:stats",
-        "signature ./sdk:validate",
-        "signature ./sdk/core:aggregate",
-        "signature ./sdk/core:comments",
-        "signature ./sdk/core:context",
-        "signature ./sdk/core:deps",
-        "signature ./sdk/core:docs",
-        "signature ./sdk/core:files",
-        "signature ./sdk/core:get",
-        "signature ./sdk/core:graph",
-        "signature ./sdk/core:list",
-        "signature ./sdk/core:next",
-        "signature ./sdk/core:notes",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/core:search",
-        "signature ./sdk/runtime:aggregate",
-        "signature ./sdk/runtime:comments",
-        "signature ./sdk/runtime:context",
-        "signature ./sdk/runtime:deps",
-        "signature ./sdk/runtime:docs",
-        "signature ./sdk/runtime:files",
-        "signature ./sdk/runtime:get",
-        "signature ./sdk/runtime:graph",
-        "signature ./sdk/runtime:health",
-        "signature ./sdk/runtime:list",
-        "signature ./sdk/runtime:next",
-        "signature ./sdk/runtime:notes",
-        "signature ./sdk/runtime:PmClient",
-        "signature ./sdk/runtime:search",
-        "signature ./sdk/runtime:stats",
-        "signature ./sdk/runtime:validate"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Preserve omission-aware conditional read signatures while extracting public runtime contracts below the implementation file limit"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ActivityCommandOptions",
-        "signature ./sdk:ActivityResult",
-        "signature ./sdk:AGENT_PROVENANCE_DIMENSIONS",
-        "signature ./sdk:AgentModelSource",
-        "signature ./sdk:HarnessDetectionSignals",
-        "signature ./sdk:HarnessSignalDescriptor",
-        "signature ./sdk:HistoryCommandOptions",
-        "signature ./sdk:HistoryResult",
-        "signature ./sdk:ListMutationEventsOptions",
-        "signature ./sdk:MutationEvent",
-        "signature ./sdk:MutationEventPage",
-        "signature ./sdk:PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS",
-        "signature ./sdk:PM_READ_ROW_CONTRACTS",
-        "signature ./sdk:PmSettings",
-        "signature ./sdk:runWithWorkspaceHarnessSignalDescriptors",
-        "signature ./sdk/core:AGENT_PROVENANCE_DIMENSIONS",
-        "signature ./sdk/core:AgentModelSource",
-        "signature ./sdk/core:HarnessDetectionSignals",
-        "signature ./sdk/core:HarnessSignalDescriptor",
-        "signature ./sdk/core:PmSettings",
-        "signature ./sdk/core:runWithWorkspaceHarnessSignalDescriptors",
-        "signature ./sdk/query:ActivityCommandOptions",
-        "signature ./sdk/query:ActivityResult",
-        "signature ./sdk/query:HistoryCommandOptions",
-        "signature ./sdk/query:HistoryResult",
-        "signature ./sdk/runtime:PmSettings"
-      ],
-      "package_version": "2026.8.2",
-      "reason": "Additive provenance projections, filters, version dimension, and optional probe controls intentionally expand public SDK contracts without removing existing behavior."
-    },
-    {
-      "changes": [
-        "signature ./sdk:PM_READ_ROW_CONTRACTS",
-        "signature ./sdk:PROFILE_LINT_CODES",
-        "signature ./sdk/authoring:PROFILE_LINT_CODES"
-      ],
-      "package_version": "2026.8.3",
-      "reason": "Intentional additive universal row-contract and profile diagnostic vocabulary expansion for pm-sb0tns and pm-yfdav2"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ContextOptions",
-        "signature ./sdk:ContextResult",
-        "signature ./sdk:ExtensionManifest",
-        "signature ./sdk/authoring:ExtensionManifest",
-        "signature ./sdk/core:ContextOptions",
-        "signature ./sdk/core:ContextResult",
-        "signature ./sdk/query:ContextOptions",
-        "signature ./sdk/query:ContextResult",
-        "signature ./sdk/runtime:ContextOptions",
-        "signature ./sdk/runtime:ContextResult"
-      ],
-      "package_version": "2026.8.3",
-      "reason": "Add optional static extension contribution inventory and context health contracts"
-    },
-    {
-      "changes": [
-        "signature ./sdk:AggregateResult",
-        "signature ./sdk/core:AggregateResult",
-        "signature ./sdk/query:AggregateResult",
-        "signature ./sdk/runtime:AggregateResult"
-      ],
-      "package_version": "2026.8.3",
-      "reason": "Aggregate filter metadata now discloses multi-status OR selections through optional status_values while preserving status compatibility"
-    },
-    {
-      "changes": [
-        "signature ./sdk:ContractsResult",
-        "signature ./sdk:PM_COMMAND_OUTPUT_BUDGET_CONTRACTS",
-        "signature ./sdk:PmCommandOutputBudgetContract",
-        "signature ./sdk:PmErrorCodeContract",
-        "signature ./sdk:resolvePmCommandOutputBudget",
-        "signature ./sdk/contracts:PM_COMMAND_OUTPUT_BUDGET_CONTRACTS",
-        "signature ./sdk/contracts:PmCommandOutputBudgetContract",
-        "signature ./sdk/contracts:PmErrorCodeContract",
-        "signature ./sdk/contracts:resolvePmCommandOutputBudget",
-        "signature ./sdk/runtime:ContractsResult",
-        "signature ./sdk/runtime:PmErrorCodeContract"
-      ],
-      "package_version": "2026.8.4",
-      "reason": "Output contracts now expose format-aware budgets, envelope families, and classified error metadata; existing call forms and runtime fields remain compatible."
-    },
-    {
-      "changes": [
-        "signature ./sdk:parseMutationReceipt",
-        "signature ./sdk/contracts:parseMutationReceipt"
-      ],
-      "package_version": "2026.8.4",
-      "reason": "PR 895 pre-merge correction: expose explicit string JSON and decoded unknown mutation-receipt overloads before the new API is released."
-    },
-    {
-      "changes": [
-        "signature ./sdk:BulkItemMutation"
-      ],
-      "package_version": "2026.8.4",
-      "reason": "Add the release mutation variant required for atomic evidence-close-release completion; exhaustive BulkItemMutation consumers must handle release"
+      "package_version": "2026.8.6",
+      "reason": "Type the existing runtime read_session receipt and re-export its state from contracts/runtime; no runtime behavior or existing member is removed."
     }
   ],
   "entrypoints": {
@@ -1306,6 +536,12 @@
           "name": "applyReadOutputDimensions",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result> | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "applyReadOutputSessionReferences",
+          "signature": "(result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown> | calls: (result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -1318,6 +554,12 @@
           "name": "applyStandaloneNote",
           "signature": "(adds: LinkedArtifact[], note: string | undefined, hasAddFlags: boolean) => LinkedArtifact[] | calls: (adds: LinkedArtifact[], note: string | undefined, hasAddFlags: boolean) => LinkedArtifact[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "applyStoredExtensionMigrationState",
+          "signature": "(pmRoot: string, migrations: RegisteredExtensionSchemaMigrationDefinition[]) => Promise<ExtensionMigrationState> | calls: (pmRoot: string, migrations: RegisteredExtensionSchemaMigrationDefinition[]) => Promise<ExtensionMigrationState>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -1582,6 +824,12 @@
           "name": "attachReadOutputContracts",
           "signature": "(command: string | undefined, options: Record<string, unknown>, result: unknown) => unknown | calls: (command: string | undefined, options: Record<string, unknown>, result: unknown) => unknown"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "attachReadOutputSessionReceipt",
+          "signature": "(result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown> | calls: (result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1658,7 +906,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\"; 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; author?: string; authorMissingValue?: true; }"
         },
         {
           "classification": "advanced_export",
@@ -1684,6 +932,12 @@
           "name": "boundAgentEpisodeIdentity",
           "signature": "(value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined | calls: (value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "boundReadOutputRows",
+          "signature": "(result: Record<string, unknown>, amount: number) => { result: Record<string, unknown>; truncated: boolean; } | calls: (result: Record<string, unknown>, amount: number) => { result: Record<string, unknown>; truncated: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -2992,6 +2246,12 @@
           "name": "countFailureCategories",
           "signature": "(runResults: TestRunResult[]) => Record<LinkedTestFailureCategory, number> | calls: (runResults: TestRunResult[]) => Record<LinkedTestFailureCategory, number>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "countReadOutputRows",
+          "signature": "(result: Record<string, unknown>) => number | calls: (result: Record<string, unknown>) => number"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3062,7 +2322,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; }) => 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; }) => 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[]; 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"
         },
         {
           "classification": "supported",
@@ -3440,7 +2700,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "definePreflightOverride",
-          "signature": "(override: PreflightOverride) => PreflightOverride | calls: (override: PreflightOverride) => PreflightOverride"
+          "signature": "{ (override: PreflightOverride): PreflightOverride; <TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>): TDefinition; } | calls: (override: PreflightOverride) => PreflightOverride ; <TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>) => TDefinition"
         },
         {
           "classification": "supported",
@@ -3982,6 +3242,12 @@
           "name": "EvaluateMutationGuardOptions",
           "signature": "export interface EvaluateMutationGuardOptions { author: string; payload: unknown; settings: MutationGuardSettings; force?: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "evaluateProvenanceCoverage",
+          "signature": "(entries: readonly HistoryEntry[], descriptors: readonly HarnessSignalDescriptor[], minimumSample: number) => Omit<ProvenanceCoverageAnalytics, \"window\"> | calls: (entries: readonly HistoryEntry[], descriptors: readonly HarnessSignalDescriptor[], minimumSample: number) => Omit<ProvenanceCoverageAnalytics, \"window\">"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -4168,6 +3434,12 @@
           "name": "EXTENSION_MANAGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "EXTENSION_MIGRATE_FLAG_CONTRACTS",
+          "signature": "CliFlagContract[]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -4226,19 +3498,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; }"
+          "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[]; }>; }"
         },
         {
           "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): 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; 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?: PreflightOverride[]; 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[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -4306,6 +3578,12 @@
           "name": "ExtensionCapabilityUsageReconciliation",
           "signature": "export interface ExtensionCapabilityUsageReconciliation { layer: ExtensionLayer; name: string; declared: ExtensionCapability[]; used: ExtensionCapability[]; unused: ExtensionCapability[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ExtensionCommandAction",
+          "signature": "export type ExtensionCommandAction = \"install\" | \"uninstall\" | \"explore\" | \"manage\" | \"describe\" | \"reload\" | \"doctor\" | \"catalog\" | \"adopt\" | \"adopt-all\" | \"activate\" | \"deactivate\" | \"migrate\" | \"init\";"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -4322,7 +3600,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ExtensionCommandOptions",
-          "signature": "export interface ExtensionCommandOptions { install?: boolean; uninstall?: boolean; explore?: boolean; manage?: boolean; describe?: boolean; markdown?: boolean; output?: string; reload?: boolean; doctor?: boolean; catalog?: boolean; init?: boolean; scaffold?: boolean; strictExit?: boolean; failOnWarn?: boolean; adopt?: boolean; adoptAll?: boolean; activate?: boolean; deactivate?: boolean; project?: boolean; local?: boolean; global?: boolean; gh?: string; github?: string; ref?: string; detail?: string; trace?: boolean; watch?: boolean; runtimeProbe?: boolean; fixManagedState?: boolean; isolated?: boolean; ignoreGlobal?: boolean; fields?: string; capability?: string; declarative?: boolean; vocabulary?: \"extension\" | \"package\"; }"
+          "signature": "export interface ExtensionCommandOptions { install?: boolean; uninstall?: boolean; explore?: boolean; manage?: boolean; describe?: boolean; markdown?: boolean; output?: string; reload?: boolean; doctor?: boolean; catalog?: boolean; init?: boolean; scaffold?: boolean; strictExit?: boolean; failOnWarn?: boolean; adopt?: boolean; adoptAll?: boolean; activate?: boolean; deactivate?: boolean; migrate?: boolean; project?: boolean; local?: boolean; global?: boolean; gh?: string; github?: string; ref?: string; detail?: string; trace?: boolean; watch?: boolean; runtimeProbe?: boolean; fixManagedState?: boolean; isolated?: boolean; ignoreGlobal?: boolean; fields?: string; capability?: string; declarative?: boolean; vocabulary?: \"extension\" | \"package\"; dryRun?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -4352,7 +3630,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; }"
+          "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[]; }>; }"
         },
         {
           "classification": "advanced_export",
@@ -4420,6 +3698,24 @@
           "name": "ExtensionHookRegistry",
           "signature": "export interface ExtensionHookRegistry { beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>; beforeMutation: Array<RegisteredExtensionHook<BeforeMutationHook>>; afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>; onWrite: Array<RegisteredExtensionHook<OnWriteHook>>; onRead: Array<RegisteredExtensionHook<OnReadHook>>; onIndex: Array<RegisteredExtensionHook<OnIndexHook>>; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionInstallSourceCandidate",
+          "signature": "export interface ExtensionInstallSourceCandidate extends ExtensionInstallSourceSelection { version?: string; directory?: string; command: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionInstallSourceResolution",
+          "signature": "export interface ExtensionInstallSourceResolution { requested: string; selected: ExtensionInstallSourceSelection; ambiguous: boolean; precedence: \"bundled_alias_before_installed_npm\"; candidates: ExtensionInstallSourceCandidate[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionInstallSourceSelection",
+          "signature": "export interface ExtensionInstallSourceSelection { kind: \"builtin\" | \"local\" | \"github\" | \"npm\"; input: string; package?: string; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -4480,6 +3776,48 @@
           "name": "ExtensionManifestEngines",
           "signature": "export interface ExtensionManifestEngines { pm?: string; node?: string; [engine: string]: string | undefined; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "extensionMigrate",
+          "signature": "(options?: ExtensionCommandOptions, clientOptions?: PmClientOptions) => Promise<ExtensionCommandResult> | calls: (options?: ExtensionCommandOptions, clientOptions?: PmClientOptions) => Promise<ExtensionCommandResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionMigrationActionContext",
+          "signature": "export interface ExtensionMigrationActionContext { scope: ExtensionScope; resolvedRoots: { pm_root: string; settings_root: string; }; warnings: string[]; options: { dryRun?: boolean; }; global: { noExtensions?: boolean; author?: string; }; withResult: (details: Record<string, unknown>, ok?: boolean) => ExtensionCommandResult; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ExtensionMigrationOutcomeStatus",
+          "signature": "export type ExtensionMigrationOutcomeStatus = \"applied\" | \"failed\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionMigrationReceipt",
+          "signature": "export interface ExtensionMigrationReceipt { key: string; layer: \"global\" | \"project\"; extension: string; id: string; before: \"pending\" | ExtensionMigrationOutcomeStatus; outcome: \"pending\" | \"applied\" | \"skipped\" | \"failed\"; error?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionMigrationRunResult",
+          "signature": "export interface ExtensionMigrationRunResult { ok: boolean; dry_run: boolean; state_path: string; total: number; pending_count: number; applied_count: number; skipped_count: number; failed_count: number; migrations: ExtensionMigrationReceipt[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionMigrationState",
+          "signature": "export interface ExtensionMigrationState { version: 1; updated_at: string; entries: ExtensionMigrationStateEntry[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExtensionMigrationStateEntry",
+          "signature": "export interface ExtensionMigrationStateEntry { key: string; layer: \"global\" | \"project\"; extension: string; id: string; status: ExtensionMigrationOutcomeStatus; attempted_at: string; error?: string; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -4750,6 +4088,12 @@
           "name": "findGitWorkspaceRoot",
           "signature": "(cwd: string) => Promise<string | null> | calls: (cwd: string) => Promise<string | null>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "findInstalledNpmPackageCandidate",
+          "signature": "(packageName: string, cwd?: string) => Promise<InstalledNpmPackageCandidate | null> | calls: (packageName: string, cwd?: string) => Promise<InstalledNpmPackageCandidate | null>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -4798,6 +4142,24 @@
           "name": "flattenFlagListValue",
           "signature": "(value: unknown) => unknown[] | calls: (value: unknown) => unknown[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "FleetAttributionAnalytics",
+          "signature": "export interface FleetAttributionAnalytics { dimensions: FleetAttributionDimension[]; minimum_sample: number; policy: \"observational_only_not_for_authorization_or_routing\"; window: HistoryAnalyticsWindowReceipt; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "FleetAttributionDimension",
+          "signature": "export interface FleetAttributionDimension { dimension: \"harness\" | \"model\" | \"author_source\"; status: \"available\" | \"unavailable\"; rows: FleetAttributionRow[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "FleetAttributionRow",
+          "signature": "export interface FleetAttributionRow { value: string; events: number; state_events: number; annotation_events: number; closes: number; reopens: number; defect_escapes: number; throughput_per_day: number | null; rework_rate: number | null; defect_escape_rate: number | null; sample_status: \"available\" | \"insufficient\"; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5038,6 +4400,12 @@
           "name": "getWorkspaceHistoryPath",
           "signature": "(pmRoot: string) => string | calls: (pmRoot: string) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "GithubInstallSource",
+          "signature": "export interface GithubInstallSource { kind: \"github\"; input: string; owner: string; repo: string; repository: string; ref?: string; subpath?: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -5048,7 +4416,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\"; 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; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -5476,6 +4844,30 @@
           "name": "HISTORY_REPAIR_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryAnalyticsEvent",
+          "signature": "export interface HistoryAnalyticsEvent { item_id: string; entry: HistoryEntry; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryAnalyticsWindow",
+          "signature": "export interface HistoryAnalyticsWindow { events: HistoryAnalyticsEvent[]; receipt: HistoryAnalyticsWindowReceipt; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryAnalyticsWindowOptions",
+          "signature": "export interface HistoryAnalyticsWindowOptions { since?: string; eventLimit?: number; minimumSample?: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryAnalyticsWindowReceipt",
+          "signature": "export interface HistoryAnalyticsWindowReceipt { since: string; events: number; truncated: boolean; next_cursor?: string; source: \"history_event_index\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5704,6 +5096,36 @@
           "name": "ImportPriorityValue",
           "signature": "export type ImportPriorityValue = 0 | 1 | 2 | 3 | 4;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ImprovementDirection",
+          "signature": "export type ImprovementDirection = \"higher\" | \"lower\" | \"target\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ImprovementLedgerDocument",
+          "signature": "export interface ImprovementLedgerDocument { format_version: 1; observations: ImprovementObservation[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ImprovementLedgerResult",
+          "signature": "export interface ImprovementLedgerResult { observations: ImprovementObservation[]; total: number; truncated: boolean; trends: ImprovementTrend[]; source: \"audited_workspace_singleton\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ImprovementObservation",
+          "signature": "export interface ImprovementObservation { id: string; metric: string; value: number; direction: ImprovementDirection; unit?: string; threshold?: number; observed_at: string; revision: string; revision_source: \"caller\" | \"git\" | \"unversioned\"; author: string; item_id?: string; source?: string; idempotency_key?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ImprovementTrend",
+          "signature": "export interface ImprovementTrend { metric: string; direction: ImprovementDirection; baseline: ImprovementObservation; latest: ImprovementObservation; delta: number; improved: boolean; sample_count: number; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5830,12 +5252,24 @@
           "name": "INSTALL_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "InstalledNpmPackageCandidate",
+          "signature": "export interface InstalledNpmPackageCandidate { package: string; version?: string; directory: string; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "installMergeFence",
           "signature": "(options: { pmRoot: string; workspaceRoot: string; dryRun?: boolean; }) => Promise<MergeInstallResult> | calls: (options: { pmRoot: string; workspaceRoot: string; dryRun?: boolean; }) => Promise<MergeInstallResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "InstallSource",
+          "signature": "export type InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6532,6 +5966,12 @@
           "name": "loadRelationshipGraphAdapter",
           "signature": "(adapter: RelationshipGraphAdapter, context: RelationshipGraphAdapterContext) => Promise<LoadedRelationshipGraphSnapshot | null> | calls: (adapter: RelationshipGraphAdapter, context: RelationshipGraphAdapterContext) => Promise<LoadedRelationshipGraphSnapshot | null>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "LocalInstallSource",
+          "signature": "export interface LocalInstallSource { kind: \"local\"; input: string; absolute_path: string; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -6556,6 +5996,12 @@
           "name": "looksLikeGenericKeyValueEntry",
           "signature": "(raw: string) => boolean | calls: (raw: string) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "mapReadOutputRows",
+          "signature": "(result: Record<string, unknown>, transform: (row: unknown, path: string, index: number) => unknown) => Record<string, unknown> | calls: (result: Record<string, unknown>, transform: (row: unknown, path: string, index: number) => unknown) => Record<string, unknown>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -6772,6 +6218,12 @@
           "name": "mutateItem",
           "signature": "(params: { pmRoot: string; settings: PmSettings; id: string; op: string; author: string; message?: string; force?: boolean; bypassAssigneeConflict?: boolean; skipNoop?: boolean; extensionFieldNames?: readonly string[]; typeToFolder?: Record<string, string>; mutate: (document: ItemDocument) => { changedFields: string[]; warnings?: string[]; } | Promise<{ changedFields: string[]; warnings?: string[]; }>; }) => Promise<{ item: ItemMetadata; body: string; changedFields: string[]; warnings: string[]; }> | calls: (params: { pmRoot: string; settings: PmSettings; id: string; op: string; author: string; message?: string; force?: boolean; bypassAssigneeConflict?: boolean; skipNoop?: boolean; extensionFieldNames?: readonly string[]; typeToFolder?: Record<string, string>; mutate: (document: ItemDocument) => { changedFields: string[]; warnings?: string[]; } | Promise<{ changedFields: string[]; warnings?: string[]; }>; }) => Promise<{ item: ItemMetadata; body: string; changedFields: string[]; warnings: string[]; }>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "mutateWorkspaceJsonWithHistory",
+          "signature": "<Result>(params: WorkspaceJsonMutationOptions<Result>) => Promise<{ changed: boolean; result: Result; }> | calls: <Result>(params: WorkspaceJsonMutationOptions<Result>) => Promise<{ changed: boolean; result: Result; }>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -7030,6 +6482,12 @@
           "name": "nowIso",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "NpmInstallSource",
+          "signature": "export interface NpmInstallSource { kind: \"npm\"; input: string; spec: string; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -7210,6 +6668,12 @@
           "name": "PackageManifestResourceExpectation",
           "signature": "export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "packageMigrate",
+          "signature": "(options?: PackageCommandOptions, clientOptions?: PmClientOptions) => Promise<PackageCommandResult> | calls: (options?: PackageCommandOptions, clientOptions?: PmClientOptions) => Promise<PackageCommandResult>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7480,6 +6944,12 @@
           "name": "parsePriorityFilterSet",
           "signature": "(raw: string | undefined, label?: string) => Set<number> | undefined | calls: (raw: string | undefined, label?: string) => Set<number> | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseReadOutputSession",
+          "signature": "(value: unknown) => PmReadOutputSessionState | undefined | calls: (value: unknown) => PmReadOutputSessionState | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7936,6 +7406,12 @@
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
           "signature": "\"1.1.0\""
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+          "signature": "readonly [\"--output-session\"]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -7948,6 +7424,18 @@
           "name": "PM_READ_OUTPUT_OPTION_FLAGS",
           "signature": "readonly string[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS",
+          "signature": "10000"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_SESSION_MIN_TOKENS",
+          "signature": "256"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -8060,7 +7548,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -8408,7 +7896,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -8420,13 +7908,37 @@
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResult",
-          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; }) | PmReadOutputBudgetExceeded;"
+          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; read_session?: PmReadOutputSessionReceipt; }) | (PmReadOutputBudgetExceeded & { read_session?: PmReadOutputSessionReceipt; });"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResultFor",
-          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : \"outputSession\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmReadOutputRowCollection",
+          "signature": "export interface PmReadOutputRowCollection { path: string; value: unknown[] | Record<string, unknown>; }"
+        },
+        {
+          "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; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "PmReadOutputSessionReference",
+          "signature": "export interface PmReadOutputSessionReference { id: string; context_ref: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "PmReadOutputSessionState",
+          "signature": "export interface PmReadOutputSessionState { version: 1; id: string; token_budget: number; spent_tokens: number; seen_item_ids: string[]; }"
         },
         {
           "classification": "supported",
@@ -8806,6 +8318,12 @@
           "name": "projectContextFocusRows",
           "signature": "<T extends ContextFocusItem>(rows: T[], fields: string[]) => ContextFocusItem[] | calls: <T extends ContextFocusItem>(rows: T[], fields: string[]) => ContextFocusItem[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "projectFleetAttributionAnalytics",
+          "signature": "(window: HistoryAnalyticsWindow, items: readonly Pick<ItemMetadata, \"dependencies\" | \"id\" | \"type\">[], terminalStatuses: ReadonlySet<string>, options?: Pick<HistoryAnalyticsWindowOptions, \"minimumSample\">) => FleetAttributionAnalytics | calls: (window: HistoryAnalyticsWindow, items: readonly Pick<ItemMetadata, \"id\" | \"type\" | \"dependencies\">[], terminalStatuses: ReadonlySet<string>, options?: Pick<HistoryAnalyticsWindowOptions, \"minimumSample\">) => FleetAttributionAnalytics"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8854,12 +8372,24 @@
           "name": "ProjectProfileRegistrationInput",
           "signature": "export type ProjectProfileRegistrationInput = Pick<ProjectProfileDefinition, \"name\" | \"title\"> & Partial<Omit<ProjectProfileDefinition, \"name\" | \"title\">>;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "projectProvenanceCoverageAnalytics",
+          "signature": "(window: HistoryAnalyticsWindow, descriptors?: readonly HarnessSignalDescriptor[], options?: Pick<HistoryAnalyticsWindowOptions, \"minimumSample\">) => ProvenanceCoverageAnalytics | calls: (window: HistoryAnalyticsWindow, descriptors?: readonly HarnessSignalDescriptor[], options?: Pick<HistoryAnalyticsWindowOptions, \"minimumSample\">) => ProvenanceCoverageAnalytics"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "projectValidateCounts",
           "signature": "(result: ValidateResult) => ValidateCountsResult | calls: (result: ValidateResult) => ValidateCountsResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ProvenanceCoverageAnalytics",
+          "signature": "export interface ProvenanceCoverageAnalytics { descriptors: AgentProvenanceDescriptorCoverage[]; observations: AgentProvenanceDimensionCoverage[]; inert: Array<{ harness: string; dimension: string; explicit_samples: number; }>; undeclared: string[]; warnings: string[]; window: HistoryAnalyticsWindowReceipt; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8956,6 +8486,12 @@
           "name": "readCsvListOption",
           "signature": "(options: Record<string, unknown>, key: string, aliases?: string[]) => string[] | calls: (options: Record<string, unknown>, key: string, aliases?: string[]) => string[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "readExtensionMigrationState",
+          "signature": "(pmRoot: string) => Promise<ExtensionMigrationState> | calls: (pmRoot: string) => Promise<ExtensionMigrationState>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8974,12 +8510,30 @@
           "name": "readFirstValueFromCommanderOptions",
           "signature": "(options: Record<string, unknown>, contract: CommanderOptionAliasContract) => unknown | calls: (options: Record<string, unknown>, contract: CommanderOptionAliasContract) => unknown"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "readHistoryAnalyticsWindow",
+          "signature": "(pmRoot: string, options: HistoryAnalyticsWindowOptions) => Promise<HistoryAnalyticsWindow> | calls: (pmRoot: string, options: HistoryAnalyticsWindowOptions) => Promise<HistoryAnalyticsWindow>"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "readHistoryEntries",
           "signature": "(historyPath: string, itemId: string) => Promise<HistoryEntry[]> | calls: (historyPath: string, itemId: string) => Promise<HistoryEntry[]>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "readImprovementLedger",
+          "signature": "(options?: ReadImprovementLedgerOptions) => Promise<ImprovementLedgerResult> | calls: (options?: ReadImprovementLedgerOptions) => Promise<ImprovementLedgerResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ReadImprovementLedgerOptions",
+          "signature": "export interface ReadImprovementLedgerOptions { pmRoot?: string; cwd?: string; metric?: string; itemId?: string; since?: string; limit?: number; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -8992,6 +8546,24 @@
           "name": "readLocatedItem",
           "signature": "(item: LocatedItem, options?: { schema?: RuntimeSchemaSettings; extensionFieldNames?: readonly string[]; warnings?: string[]; }) => Promise<{ raw: string; document: ItemDocument; }> | calls: (item: LocatedItem, options?: { schema?: RuntimeSchemaSettings; extensionFieldNames?: readonly string[]; warnings?: string[]; }) => Promise<{ raw: string; document: ItemDocument; }>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "readOutputRowCollections",
+          "signature": "(result: Record<string, unknown>) => PmReadOutputRowCollection[] | calls: (result: Record<string, unknown>) => PmReadOutputRowCollection[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "readOutputRowPaths",
+          "signature": "(result: Record<string, unknown>) => string[] | calls: (result: Record<string, unknown>) => string[]"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "readOutputSessionRemainingTokens",
+          "signature": "(state: PmReadOutputSessionState) => number | calls: (state: PmReadOutputSessionState) => number"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9106,6 +8678,24 @@
           "name": "recordContextUsageTouches",
           "signature": "(options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "recordImprovementObservation",
+          "signature": "(options: RecordImprovementObservationOptions, global?: { path?: string; }) => Promise<RecordImprovementObservationResult> | calls: (options: RecordImprovementObservationOptions, global?: { path?: string; }) => Promise<RecordImprovementObservationResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "RecordImprovementObservationOptions",
+          "signature": "export interface RecordImprovementObservationOptions { metric: string; value: number; direction?: ImprovementDirection; unit?: string; threshold?: number; source?: string; itemId?: string; revision?: string; observedAt?: string; idempotencyKey?: string; author?: string; message?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "RecordImprovementObservationResult",
+          "signature": "export interface RecordImprovementObservationResult { changed: boolean; observation: ImprovementObservation; ledger_path: \"improvement-ledger.json\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -10144,6 +9734,18 @@
           "name": "ResolvedCompletionTimestamp",
           "signature": "export interface ResolvedCompletionTimestamp { resolved: true; timestamp: string; source: CompletionTimestampSource; fallback: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ResolvedExtensionInstallSource",
+          "signature": "export interface ResolvedExtensionInstallSource { bundledAliasName: string | null; bundledPackageName: string | null; installSource: InstallSource; sourceResolution: ExtensionInstallSourceResolution; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ResolvedInstallSource",
+          "signature": "export interface ResolvedInstallSource { source: InstallSource; directory: string; source_root?: string; resolved_subpath?: string; commit?: string; npm_package?: string; npm_version?: string; cleanup?: () => Promise<void>; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -10162,6 +9764,18 @@
           "name": "resolveEmbeddingProviders",
           "signature": "(settings: PmSettings | ProviderSettingsInput) => EmbeddingProviderResolution | calls: (settings: PmSettings | ProviderSettingsInput) => EmbeddingProviderResolution"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveExtensionInstallSourceIdentity",
+          "signature": "(explicitSourceInput: string, githubOption: string | undefined, ref: string | undefined) => Promise<ResolvedExtensionInstallSource> | calls: (explicitSourceInput: string, githubOption: string | undefined, ref: string | undefined) => Promise<ResolvedExtensionInstallSource>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveExtensionMigrationStatePath",
+          "signature": "(pmRoot: string) => string | calls: (pmRoot: string) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10780,6 +10394,24 @@
           "name": "runExtension",
           "signature": "(target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions) => Promise<ExtensionCommandResult> | calls: (target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions) => Promise<ExtensionCommandResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runExtensionMigrateAction",
+          "signature": "(context: ExtensionMigrationActionContext) => Promise<ExtensionCommandResult> | calls: (context: ExtensionMigrationActionContext) => Promise<ExtensionCommandResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runExtensionMigrations",
+          "signature": "(options: RunExtensionMigrationsOptions) => Promise<ExtensionMigrationRunResult> | calls: (options: RunExtensionMigrationsOptions) => Promise<ExtensionMigrationRunResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "RunExtensionMigrationsOptions",
+          "signature": "export interface RunExtensionMigrationsOptions { pmRoot: string; migrations: RegisteredExtensionSchemaMigrationDefinition[]; author: string; dryRun?: boolean; scope?: \"global\" | \"project\"; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10798,6 +10430,12 @@
           "name": "runFilesLookup",
           "signature": "(options: FilesLookupOptions, global: GlobalOptions) => Promise<FilesLookupResult> | calls: (options: FilesLookupOptions, global: GlobalOptions) => Promise<FilesLookupResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runFleetAttributionAnalytics",
+          "signature": "(pmRoot: string, items: readonly Pick<ItemMetadata, \"dependencies\" | \"id\" | \"type\">[], terminalStatuses: ReadonlySet<string>, options?: HistoryAnalyticsWindowOptions) => Promise<FleetAttributionAnalytics> | calls: (pmRoot: string, items: readonly Pick<ItemMetadata, \"id\" | \"type\" | \"dependencies\">[], terminalStatuses: ReadonlySet<string>, options?: HistoryAnalyticsWindowOptions) => Promise<FleetAttributionAnalytics>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10996,6 +10634,12 @@
           "name": "runProfileShow",
           "signature": "(name: string | undefined) => ProfileShowResult | calls: (name: string | undefined) => ProfileShowResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runProvenanceCoverageAnalytics",
+          "signature": "(pmRoot: string, descriptors?: readonly HarnessSignalDescriptor[], options?: HistoryAnalyticsWindowOptions) => Promise<ProvenanceCoverageAnalytics> | calls: (pmRoot: string, descriptors?: readonly HarnessSignalDescriptor[], options?: HistoryAnalyticsWindowOptions) => Promise<ProvenanceCoverageAnalytics>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -12272,13 +11916,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; }"
+          "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; }"
         },
         {
           "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; generated_at: string; }"
+          "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; }"
         },
         {
           "classification": "supported",
@@ -13282,6 +12926,18 @@
           "name": "WorkspaceHistoryChange",
           "signature": "export interface WorkspaceHistoryChange { pmRoot: string; documentPath: string; before: unknown; after: unknown; op: string; idempotencyKey?: string; author: string; message?: string; lockTtlSeconds: number; lockWaitMs: number; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "WorkspaceJsonMutation",
+          "signature": "export interface WorkspaceJsonMutation<Result> { raw: string; result: Result; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "WorkspaceJsonMutationOptions",
+          "signature": "export interface WorkspaceJsonMutationOptions<Result> extends Omit<WorkspaceJsonWriteOptions, \"raw\"> { mutate: (beforeRaw: string | null) => WorkspaceJsonMutation<Result> | Promise<WorkspaceJsonMutation<Result>>; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -13646,7 +13302,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; }) => 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; }) => 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[]; 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"
         },
         {
           "classification": "supported",
@@ -13766,7 +13422,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "definePreflightOverride",
-          "signature": "(override: PreflightOverride) => PreflightOverride | calls: (override: PreflightOverride) => PreflightOverride"
+          "signature": "{ (override: PreflightOverride): PreflightOverride; <TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>): TDefinition; } | calls: (override: PreflightOverride) => PreflightOverride ; <TDefinition extends ScopedPreflightOverrideDefinition>(override: ExactDefinition<TDefinition, ScopedPreflightOverrideDefinition>) => TDefinition"
         },
         {
           "classification": "supported",
@@ -13892,13 +13548,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): 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; 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?: PreflightOverride[]; 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[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -13976,7 +13632,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; }"
+          "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[]; }>; }"
         },
         {
           "classification": "supported",
@@ -15274,6 +14930,12 @@
           "name": "EXTENSION_MANAGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "EXTENSION_MIGRATE_FLAG_CONTRACTS",
+          "signature": "CliFlagContract[]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -15658,6 +15320,12 @@
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
           "signature": "\"1.1.0\""
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+          "signature": "readonly [\"--output-session\"]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -15950,7 +15618,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\"; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
         },
         {
           "classification": "contract_data",
@@ -15962,13 +15630,25 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmReadOutputResult",
-          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; }) | PmReadOutputBudgetExceeded;"
+          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; read_session?: PmReadOutputSessionReceipt; }) | (PmReadOutputBudgetExceeded & { read_session?: PmReadOutputSessionReceipt; });"
         },
         {
           "classification": "contract_data",
           "kind": "type",
           "name": "PmReadOutputResultFor",
-          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : \"outputSession\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+        },
+        {
+          "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; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputSessionState",
+          "signature": "export interface PmReadOutputSessionState { version: 1; id: string; token_budget: number; spent_tokens: number; seen_item_ids: string[]; }"
         },
         {
           "classification": "contract_data",
@@ -16528,6 +16208,18 @@
           "name": "applyReadOutputDimensions",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result> | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "applyReadOutputSessionReferences",
+          "signature": "(result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown> | calls: (result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown>"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "attachReadOutputSessionReceipt",
+          "signature": "(result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown> | calls: (result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown>"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -17032,12 +16724,24 @@
           "name": "nowIso",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseReadOutputSession",
+          "signature": "(value: unknown) => PmReadOutputSessionState | undefined | calls: (value: unknown) => PmReadOutputSessionState | undefined"
+        },
         {
           "classification": "supported",
           "kind": "value",
           "name": "PM_CLI_EXPECTED_ERROR_NAME",
           "signature": "\"PmCliError\""
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+          "signature": "readonly [\"--output-session\"]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -17078,7 +16782,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "supported",
@@ -17114,7 +16818,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -17126,13 +16830,31 @@
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResult",
-          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; }) | PmReadOutputBudgetExceeded;"
+          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; read_session?: PmReadOutputSessionReceipt; }) | (PmReadOutputBudgetExceeded & { read_session?: PmReadOutputSessionReceipt; });"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResultFor",
-          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : \"outputSession\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+        },
+        {
+          "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; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "PmReadOutputSessionReference",
+          "signature": "export interface PmReadOutputSessionReference { id: string; context_ref: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "PmReadOutputSessionState",
+          "signature": "export interface PmReadOutputSessionState { version: 1; id: string; token_budget: number; spent_tokens: number; seen_item_ids: string[]; }"
         },
         {
           "classification": "supported",
@@ -17158,6 +16880,12 @@
           "name": "readAuthorEnvironment",
           "signature": "() => string | undefined | calls: () => string | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "readOutputSessionRemainingTokens",
+          "signature": "(state: PmReadOutputSessionState) => number | calls: (state: PmReadOutputSessionState) => number"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -21416,7 +21144,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ExtensionCommandOptions",
-          "signature": "export interface ExtensionCommandOptions { install?: boolean; uninstall?: boolean; explore?: boolean; manage?: boolean; describe?: boolean; markdown?: boolean; output?: string; reload?: boolean; doctor?: boolean; catalog?: boolean; init?: boolean; scaffold?: boolean; strictExit?: boolean; failOnWarn?: boolean; adopt?: boolean; adoptAll?: boolean; activate?: boolean; deactivate?: boolean; project?: boolean; local?: boolean; global?: boolean; gh?: string; github?: string; ref?: string; detail?: string; trace?: boolean; watch?: boolean; runtimeProbe?: boolean; fixManagedState?: boolean; isolated?: boolean; ignoreGlobal?: boolean; fields?: string; capability?: string; declarative?: boolean; vocabulary?: \"extension\" | \"package\"; }"
+          "signature": "export interface ExtensionCommandOptions { install?: boolean; uninstall?: boolean; explore?: boolean; manage?: boolean; describe?: boolean; markdown?: boolean; output?: string; reload?: boolean; doctor?: boolean; catalog?: boolean; init?: boolean; scaffold?: boolean; strictExit?: boolean; failOnWarn?: boolean; adopt?: boolean; adoptAll?: boolean; activate?: boolean; deactivate?: boolean; migrate?: boolean; project?: boolean; local?: boolean; global?: boolean; gh?: string; github?: string; ref?: string; detail?: string; trace?: boolean; watch?: boolean; runtimeProbe?: boolean; fixManagedState?: boolean; isolated?: boolean; ignoreGlobal?: boolean; fields?: string; capability?: string; declarative?: boolean; vocabulary?: \"extension\" | \"package\"; dryRun?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -21608,7 +21336,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\"; 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; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -22208,7 +21936,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -22274,19 +22002,31 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResult",
-          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; }) | PmReadOutputBudgetExceeded;"
+          "signature": "export type PmReadOutputResult<Result> = (Result & { read_output?: PmReadOutputReceipt; read_session?: PmReadOutputSessionReceipt; }) | (PmReadOutputBudgetExceeded & { read_session?: PmReadOutputSessionReceipt; });"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "PmReadOutputResultFor",
-          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+          "signature": "export type PmReadOutputResultFor<Result, Options> = \"outputBudget\" extends keyof Options ? PmReadOutputResult<Result> : \"outputSession\" extends keyof Options ? PmReadOutputResult<Result> : Result;"
+        },
+        {
+          "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; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "PmReadOutputSessionState",
+          "signature": "export interface PmReadOutputSessionState { version: 1; id: string; token_budget: number; spent_tokens: number; seen_item_ids: string[]; }"
         },
         {
           "classification": "supported",
@@ -23126,13 +22866,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; }"
+          "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; }"
         },
         {
           "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; generated_at: string; }"
+          "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; }"
         },
         {
           "classification": "supported",
@@ -23642,13 +23382,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; }"
+          "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[]; }>; }"
         },
         {
           "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?: PreflightOverride[]; 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[]; importers?: ExtensionBlueprintImporter[]; exporters?: ExtensionBlueprintExporter[]; hooks?: ExtensionBlueprintHooks; activate?: (api: ExtensionApi) => void | Promise<void>; deactivate?: () => void | Promise<void>; }"
         },
         {
           "classification": "supported",
@@ -24093,6 +23833,8 @@
     "history_stream_over_compact_threshold",
     "history_target_out_of_range",
     "history_unknown_author_events",
+    "improvement_metric_contract_conflict",
+    "improvement_observation_conflict",
     "init_existing_settings_requires_force",
     "init_gitignore_unwritable",
     "init_id_prefix_conflict",
@@ -24111,8 +23853,17 @@
     "invalid_event_follow_interval",
     "invalid_event_limit",
     "invalid_event_since",
+    "invalid_history_analytics_limit",
+    "invalid_history_analytics_minimum_sample",
+    "invalid_history_analytics_since",
+    "invalid_improvement_ledger",
+    "invalid_improvement_metric",
+    "invalid_improvement_observation",
+    "invalid_improvement_observation_limit",
+    "invalid_improvement_observation_timestamp",
     "invalid_provenance_predicate",
     "invalid_query_cursor",
+    "invalid_read_output_session",
     "invalid_workspace_snapshot_target",
     "item_document_invalid",
     "item_document_roundtrip_failed",