@unbrained/pm-cli 2026.8.6 → 2026.8.8

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1433,
+    "covered_symbols": 1464,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,812 +8,92 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1434
+    "required_symbols": 1465
   },
   "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"
+      "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."
     },
     {
       "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:AnnotationCommandOptions",
+        "signature ./sdk:AnnotationCommandResult",
+        "signature ./sdk:CommentsCommandOptions",
+        "signature ./sdk:CommentsResult",
+        "signature ./sdk:LearningsCommandOptions",
+        "signature ./sdk:LearningsResult",
         "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:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/core:CommentsCommandOptions",
+        "signature ./sdk/core:CommentsResult",
+        "signature ./sdk/core:LearningsCommandOptions",
+        "signature ./sdk/core:LearningsResult",
         "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/governance:_testOnlyHealthCommand",
+        "signature ./sdk/runtime:CommentsCommandOptions",
+        "signature ./sdk/runtime:CommentsResult",
+        "signature ./sdk/runtime:LearningsCommandOptions",
+        "signature ./sdk/runtime:LearningsResult",
         "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"
+        "signature ./sdk/runtime:NotesResult"
       ],
-      "package_version": "2026.8.3",
-      "reason": "Intentional additive universal row-contract and profile diagnostic vocabulary expansion for pm-sb0tns and pm-yfdav2"
+      "package_version": "2026.8.7",
+      "reason": "pm-9stazf adds bounded annotation mutation receipts with explicit fullHistory opt-in; pm-tu71 makes vector refresh explicit"
     },
     {
       "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"
+        "signature ./sdk:AnnotationOmissionReceipt"
       ],
-      "package_version": "2026.8.3",
-      "reason": "Add optional static extension contribution inventory and context health contracts"
+      "package_version": "2026.8.7",
+      "reason": "pm-9stazf replaces CLI-only annotation restoration guidance with transport-neutral selectors"
     },
     {
       "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."
+      "package_version": "2026.8.7",
+      "reason": "Add optional error-code canonicalization metadata while preserving every emitted code and the existing resolver contract; consumers may adopt resolveCanonicalPmErrorCodeContract incrementally."
     },
     {
       "changes": [
-        "signature ./sdk:parseMutationReceipt",
-        "signature ./sdk/contracts:parseMutationReceipt"
+        "signature ./sdk:ContractsResult",
+        "signature ./sdk:EXIT_CODE",
+        "signature ./sdk/core:EXIT_CODE",
+        "signature ./sdk/runtime:ContractsResult",
+        "signature ./sdk/runtime:EXIT_CODE"
       ],
-      "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."
+      "package_version": "2026.8.7",
+      "reason": "Add stable successful effect exits 6 and 7 plus generated command exit contracts; existing 0-5 meanings remain unchanged and bulk mutation result receipts now carry required outcome and exit_code fields."
     },
     {
       "changes": [
-        "signature ./sdk:BulkItemMutation"
+        "signature ./sdk:PmCommandEffect",
+        "signature ./sdk:PmCommandEffectReceipt",
+        "signature ./sdk/contracts:PmCommandEffect",
+        "signature ./sdk/contracts:PmCommandEffectReceipt"
       ],
-      "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.7",
+      "reason": "Report collected all-row bulk failures as dependency_failed exit 5 instead of a successful no-effect receipt; full no-effect and partial-effect exits remain 6 and 7."
     },
     {
       "changes": [
-        "signature ./sdk:createExtensionContributionInventory",
-        "signature ./sdk:definePreflightOverride",
-        "signature ./sdk:ExtensionActivationSummary",
-        "signature ./sdk:ExtensionApi",
-        "signature ./sdk:ExtensionBlueprint",
-        "signature ./sdk:ExtensionCommandOptions",
-        "signature ./sdk:ExtensionContributionInventory",
-        "signature ./sdk:PmClient",
-        "signature ./sdk/authoring:createExtensionContributionInventory",
-        "signature ./sdk/authoring:definePreflightOverride",
-        "signature ./sdk/authoring:ExtensionApi",
-        "signature ./sdk/authoring:ExtensionBlueprint",
-        "signature ./sdk/authoring:ExtensionContributionInventory",
-        "signature ./sdk/core:PmClient",
-        "signature ./sdk/runtime:ExtensionCommandOptions",
-        "signature ./sdk/runtime:PmClient",
-        "signature ./sdk/testing:ExtensionActivationSummary",
-        "signature ./sdk/testing:ExtensionBlueprint"
+        "signature ./sdk:ProjectRuntimeCompatibilityResult"
       ],
-      "package_version": "2026.8.5",
-      "reason": "intentional extension lifecycle SDK contract expansion with source-compatible callback overloads"
+      "package_version": "2026.8.7",
+      "reason": "Extend project runtime inspection with optional stale-read diagnostics for pm-1eted6; existing result fields and behavior remain compatible."
     }
   ],
   "entrypoints": {
@@ -848,7 +128,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "_testOnlyHealthCommand",
-          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
+          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
         },
         {
           "classification": "advanced_export",
@@ -916,6 +196,12 @@
           "name": "acknowledgeUnknownAuthorHistoryEvents",
           "signature": "(pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions) => Promise<{ acknowledged: number; history_path: string; }> | calls: (pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions) => Promise<{ acknowledged: number; history_path: string; }>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "acknowledgeUnknownAuthorHistoryEventsFromTransport",
+          "signature": "(pmRoot: string, input: Record<string, unknown>) => Promise<{ acknowledged: number; history_path: string; }> | calls: (pmRoot: string, input: Record<string, unknown>) => Promise<{ acknowledged: number; history_path: string; }>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1156,6 +442,12 @@
           "name": "analyzeKnowledgeGraph",
           "signature": "(graph: RelationshipGraph) => RelationshipKnowledgeAnalysis | calls: (graph: RelationshipGraph) => RelationshipKnowledgeAnalysis"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "analyzePmCommandExitConformance",
+          "signature": "(observations: readonly PmCommandExitObservation[], expectedCommands?: readonly string[], contracts?: readonly PmCommandExitContract[]) => PmCommandExitConformanceReport | calls: (observations: readonly PmCommandExitObservation[], expectedCommands?: readonly string[], contracts?: readonly PmCommandExitContract[]) => PmCommandExitConformanceReport"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -1202,13 +494,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AnnotationCommandOptions",
-          "signature": "export interface AnnotationCommandOptions { limit?: string; author?: string; message?: string; force?: boolean; includeMeta?: boolean; }"
+          "signature": "export interface AnnotationCommandOptions { limit?: string; author?: string; message?: string; force?: boolean; includeMeta?: boolean; fullHistory?: boolean; }"
         },
         {
           "classification": "advanced_export",
           "kind": "type",
           "name": "AnnotationCommandResult",
-          "signature": "export type AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = { id: string; count: number; } & Record<TKey, TEntry[]> & { total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; };"
+          "signature": "export type AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = { id: string; count: number; } & Record<TKey, TEntry[]> & { total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; };"
         },
         {
           "classification": "advanced_export",
@@ -1216,12 +508,30 @@
           "name": "AnnotationEntry",
           "signature": "export interface AnnotationEntry { created_at: string; author: string; text: string; edited_at?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AnnotationHistoryRestoration",
+          "signature": "export interface AnnotationHistoryRestoration { selector: \"full_history\"; cli_flag: \"--full-history\"; sdk_option: \"fullHistory\"; mcp_option: \"full\"; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AnnotationInput",
           "signature": "export interface AnnotationInput { mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\"; value?: string; rawValue?: string; emptyFlag?: string; index?: number; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AnnotationMutationReceipt",
+          "signature": "export interface AnnotationMutationReceipt { action: \"add\" | \"edit\" | \"delete\"; entry_index: number; changed_count: 1; full_history_included: boolean; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AnnotationOmissionReceipt",
+          "signature": "export interface AnnotationOmissionReceipt { has_omissions: boolean; omitted_field_group_count: number; omitted_field_groups: Array<{ name: string; restore_with: AnnotationHistoryRestoration; }>; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -1330,6 +640,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",
@@ -1474,6 +790,12 @@
           "name": "AssertProjectProfileOptions",
           "signature": "export interface AssertProjectProfileOptions { strict?: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assertProjectRuntimeCompatibility",
+          "signature": "(options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult | calls: (options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1612,6 +934,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",
@@ -1688,7 +1016,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",
@@ -1714,6 +1042,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",
@@ -2050,6 +1384,12 @@
           "name": "classifyHistoryAuthorEvent",
           "signature": "(parsed: unknown) => \"actionable_unknown\" | \"attributed\" | \"legacy_unknown\" | calls: (parsed: unknown) => \"attributed\" | \"legacy_unknown\" | \"actionable_unknown\""
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "classifyHostEnvironmentFault",
+          "signature": "(error: unknown) => string | null | calls: (error: unknown) => string | null"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -2372,13 +1712,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "advanced_export",
@@ -2464,6 +1804,12 @@
           "name": "compareCriticalItems",
           "signature": "(left: ItemMetadata, right: ItemMetadata, statusRegistry: RuntimeStatusRegistry) => number | calls: (left: ItemMetadata, right: ItemMetadata, statusRegistry: RuntimeStatusRegistry) => number"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "comparePmDateVersions",
+          "signature": "(left: string, right: string) => number | null | calls: (left: string, right: string) => number | null"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -2960,7 +2306,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -3022,6 +2368,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",
@@ -3634,6 +2986,12 @@
           "name": "deriveExtensionCapabilities",
           "signature": "(blueprint: ExtensionBlueprint) => ExtensionCapability[] | calls: (blueprint: ExtensionBlueprint) => ExtensionCapability[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "derivePmBulkMutationEffect",
+          "signature": "(counts: PmBulkMutationEffectCounts) => PmCommandEffectReceipt | calls: (counts: PmBulkMutationEffectCounts) => PmCommandEffectReceipt"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -3742,6 +3100,12 @@
           "name": "discoverNearbyPmRoot",
           "signature": "(cwd: string, excludedRoot?: string) => string | undefined | calls: (cwd: string, excludedRoot?: string) => string | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "discoverProjectRuntimeVersionPins",
+          "signature": "(projectRoot: string) => ProjectRuntimeVersionPin[] | calls: (projectRoot: string) => ProjectRuntimeVersionPin[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -4012,6 +3376,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",
@@ -4076,7 +3446,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXIT_CODE",
-          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; }"
+          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; readonly NO_EFFECT: 6; readonly PARTIAL_EFFECT: 7; }"
         },
         {
           "classification": "advanced_export",
@@ -4906,6 +4276,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",
@@ -5162,7 +4550,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",
@@ -5590,6 +4978,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",
@@ -5782,6 +5194,18 @@
           "name": "HistoryVerificationResult",
           "signature": "export interface HistoryVerificationResult { ok: boolean; entries: number; errors: string[]; latest_after_hash?: string; current_item_hash?: string; current_matches_latest?: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HostEnvironmentBoundaryOptions",
+          "signature": "export interface HostEnvironmentBoundaryOptions { codes?: HostEnvironmentFaultCodeOverrides; why?: string; nextSteps?: readonly string[]; suggestedRetry?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HostEnvironmentFaultCodeOverrides",
+          "signature": "export interface HostEnvironmentFaultCodeOverrides { capacity?: string; permission?: string; resource?: string; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5818,6 +5242,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",
@@ -5920,6 +5374,12 @@
           "name": "inspectHistoryAuthorStream",
           "signature": "(itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, \"acknowledged_actionable_event_count\" | \"actionable_events\" | \"actionable_unknown_event_count\" | \"checked_events\" | \"legacy_unknown_event_count\" | \"samples_truncated\" | \"samples\" | \"unknown_event_count\"> | calls: (itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, \"checked_events\" | \"unknown_event_count\" | \"legacy_unknown_event_count\" | \"actionable_unknown_event_count\" | \"acknowledged_actionable_event_count\" | \"samples\" | \"samples_truncated\" | \"actionable_events\">"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "inspectProjectRuntimeCompatibility",
+          "signature": "(options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult | calls: (options: { executingVersion: string; projectRoot: string; argv: readonly string[]; allowStale?: boolean; }) => ProjectRuntimeCompatibilityResult"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -6034,18 +5494,36 @@
           "name": "isPmExtensionServiceNameContract",
           "signature": "(value: string) => value is PmExtensionServiceNameContract | calls: (value: string) => value is PmExtensionServiceNameContract"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "isPmKnownExitCode",
+          "signature": "(exitCode: number) => exitCode is PmCommandExitCode | calls: (exitCode: number) => exitCode is PmCommandExitCode"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
           "name": "isPmMutationReceipt",
           "signature": "(value: unknown) => value is PmCliMutationReceipt | calls: (value: unknown) => value is PmCliMutationReceipt"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "isPmSuccessfulExitCode",
+          "signature": "(exitCode: number) => boolean | calls: (exitCode: number) => boolean"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
           "name": "isPmToolAction",
           "signature": "(value: string) => value is PmToolAction | calls: (value: string) => value is PmToolAction"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "isProjectMutatingInvocation",
+          "signature": "(argv: readonly string[]) => boolean | calls: (argv: readonly string[]) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6284,13 +5762,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "advanced_export",
@@ -6688,6 +6166,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",
@@ -6814,6 +6298,12 @@
           "name": "mergeHistoryStreams",
           "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string) => HistoryMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string) => HistoryMergeResult"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeInstallContextResolution",
+          "signature": "export interface MergeInstallContextResolution { pm_root: string; workspace_start: string; source_coordinates_available: boolean; source_context_selected: boolean; source_policy: ReturnType<typeof resolveSourceContextWritePolicy>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -6904,6 +6394,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",
@@ -7012,6 +6508,12 @@
           "name": "NextResult",
           "signature": "export interface NextResult { output_default: \"toon\"; now: string; recommended: NextRecommendation | null; ready: NextActionableItem[]; decision_needed: NextActionableItem[]; blocked: NextActionableItem[]; held_by_others: Array<{ id: string; assignee: string; }>; summary: NextSummary; filters: { type: string | null; tag: string | null; priority: string | number | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; parent: string | null; limit: number; blocked_limit: number; ready_only: boolean; include_decisions: boolean; token_budget: number; }; suggestions?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; truncation?: { decision_needed_total?: number; held_by_others_total?: number; }; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "normalizeAnnotationTransportOptions",
+          "signature": "(options: Record<string, unknown>) => Record<string, unknown> | calls: (options: Record<string, unknown>) => Record<string, unknown>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7148,13 +6650,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "supported",
@@ -7624,6 +7126,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",
@@ -7696,6 +7204,12 @@
           "name": "parseTypeFilterSet",
           "signature": "(raw: string | undefined, typeRegistry: ItemTypeRegistry, label?: string) => Set<ItemType> | undefined | calls: (raw: string | undefined, typeRegistry: ItemTypeRegistry, label?: string) => Set<ItemType> | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseUnknownAuthorHistoryEventCoordinates",
+          "signature": "(values: readonly string[]) => UnknownAuthorHistoryEvent[] | calls: (values: readonly string[]) => UnknownAuthorHistoryEvent[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -7888,6 +7402,18 @@
           "name": "PM_CLI_ONLY_TOOL_ACTION_WAIVERS",
           "signature": "{ readonly help: \"Commander help rendering has no SDK operation result.\"; readonly item: \"The item namespace only groups lifecycle subcommands already exposed as actions.\"; readonly packages: \"The plural package alias only renders package-oriented help.\"; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_COMMAND_EXIT_CONTRACTS",
+          "signature": "readonly PmCommandExitContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_COMMAND_EXIT_OUTCOME_CONTRACTS",
+          "signature": "readonly [{ readonly exit_code: 0; readonly outcome: \"effect\"; readonly success: true; readonly meaning: \"The requested operation completed with its intended effect.\"; }, { readonly exit_code: 1; readonly outcome: \"internal_failure\"; readonly success: false; readonly meaning: \"An unexpected runtime or internal failure prevented completion.\"; }, { readonly exit_code: 2; readonly outcome: \"refused_input\"; readonly success: false; readonly meaning: \"The invocation was refused because its input or composition was invalid.\"; }, { readonly exit_code: 3; readonly outcome: \"refused_tracker_state\"; readonly success: false; readonly meaning: \"The requested tracker, item, or resource was not present.\"; }, { readonly exit_code: 4; readonly outcome: \"conflict\"; readonly success: false; readonly meaning: \"Current state or concurrency prevented the requested effect.\"; }, { readonly exit_code: 5; readonly outcome: \"dependency_failed\"; readonly success: false; readonly meaning: \"A required dependency operation failed.\"; }, { readonly exit_code: 6; readonly outcome: \"no_effect\"; readonly success: true; readonly meaning: \"The request was valid and completed, but matched nothing to change.\"; }, { readonly exit_code: 7; readonly outcome: \"partial_effect\"; readonly success: true; readonly meaning: \"The request completed and changed some, but not all, selected targets.\"; }]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -8080,6 +7606,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",
@@ -8092,6 +7624,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",
@@ -8116,6 +7660,12 @@
           "name": "PM_READ_ROW_JQ_SELECTOR",
           "signature": "\".row_contract.row_keys[] as $key | getpath($key | split(\\\".\\\")) | if type == \\\"array\\\" then .[] else if type == \\\"object\\\" then to_entries[] else empty end end\""
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_SUCCESS_EXIT_CODES",
+          "signature": "readonly [0, 6, 7]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -8144,7 +7694,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.0\""
+          "signature": "\"4.4.1\""
         },
         {
           "classification": "contract_data",
@@ -8194,6 +7744,12 @@
           "name": "PmBulkMutationControlOptions",
           "signature": "export type PmBulkMutationControlOptions = { dryRun?: boolean; rollback?: boolean; noCheckpoint?: boolean; };"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmBulkMutationEffectCounts",
+          "signature": "export interface PmBulkMutationEffectCounts { applied: number; skipped: number; failed: number; unmatched: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -8278,6 +7834,54 @@
           "name": "PmCloseManyActionOptions",
           "signature": "export type PmCloseManyActionOptions = Pick<PmCloseActionOptions, \"reason\" | \"completedAt\" | \"resolution\" | \"expectedResult\" | \"actualResult\" | \"validateClose\" | \"author\" | \"message\" | \"force\"> & PmBulkMutationFilterOptions & PmBulkMutationControlOptions;"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandEffect",
+          "signature": "export type PmCommandEffect = \"effect\" | \"no_effect\" | \"partial_effect\" | \"dependency_failed\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandEffectReceipt",
+          "signature": "export interface PmCommandEffectReceipt { outcome: PmCommandEffect; exit_code: 0 | 5 | 6 | 7; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandExitCode",
+          "signature": "export type PmCommandExitCode = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitConformanceReport",
+          "signature": "export interface PmCommandExitConformanceReport { ok: boolean; missing_commands: string[]; undeclared_observations: PmCommandExitObservation[]; unreachable_exit_codes: PmCommandExitCode[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitContract",
+          "signature": "export interface PmCommandExitContract { command: string; exit_codes: readonly PmCommandExitCode[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitObservation",
+          "signature": "export interface PmCommandExitObservation { command: string; exit_code: number; replay_id: string; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandExitOutcome",
+          "signature": "export type PmCommandExitOutcome = \"effect\" | \"internal_failure\" | \"refused_input\" | \"refused_tracker_state\" | \"conflict\" | \"dependency_failed\" | \"no_effect\" | \"partial_effect\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitOutcomeContract",
+          "signature": "export interface PmCommandExitOutcomeContract { exit_code: PmCommandExitCode; outcome: PmCommandExitOutcome; success: boolean; meaning: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -8360,7 +7964,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
         },
         {
           "classification": "contract_data",
@@ -8552,7 +8156,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",
@@ -8564,13 +8168,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",
@@ -8950,6 +8578,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",
@@ -8987,16 +8621,40 @@
           "signature": "export interface ProjectProfileLintReport { profile: string; ok: boolean; findings: ProjectProfileLintFinding[]; errorCount: number; warningCount: number; }"
         },
         {
-          "classification": "supported",
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProjectProfilePackageSummary",
+          "signature": "export interface ProjectProfilePackageSummary { spec: string; reason: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "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": "advanced_export",
+          "kind": "interface",
+          "name": "ProjectRuntimeCompatibilityResult",
+          "signature": "export interface ProjectRuntimeCompatibilityResult { compatible: boolean; executing_version: string; project_version?: string; source?: ProjectRuntimeVersionPin[\"source\"]; command?: string; mutating: boolean; stale?: boolean; warning?: ProjectRuntimeCompatibilityWarning; override_applied: boolean; }"
+        },
+        {
+          "classification": "advanced_export",
           "kind": "interface",
-          "name": "ProjectProfilePackageSummary",
-          "signature": "export interface ProjectProfilePackageSummary { spec: string; reason: string; }"
+          "name": "ProjectRuntimeCompatibilityWarning",
+          "signature": "export interface ProjectRuntimeCompatibilityWarning { code: \"project_runtime_stale_read\"; executing_version: string; project_version: string; source: ProjectRuntimeVersionPin[\"source\"]; message: string; next_steps: string[]; }"
         },
         {
-          "classification": "supported",
-          "kind": "type",
-          "name": "ProjectProfileRegistrationInput",
-          "signature": "export type ProjectProfileRegistrationInput = Pick<ProjectProfileDefinition, \"name\" | \"title\"> & Partial<Omit<ProjectProfileDefinition, \"name\" | \"title\">>;"
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ProjectRuntimeVersionPin",
+          "signature": "export interface ProjectRuntimeVersionPin { version: string; source: \"package.json\" | \"installed-package\" | \"package-lock.json\" | \"pnpm-lock.yaml\" | \"yarn.lock\"; }"
         },
         {
           "classification": "supported",
@@ -9004,6 +8662,12 @@
           "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",
@@ -9124,12 +8788,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",
@@ -9142,6 +8824,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",
@@ -9256,6 +8956,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",
@@ -10222,6 +9940,12 @@
           "name": "resolveCalendarOutputFormat",
           "signature": "(options: CalendarOptions, global: GlobalOptions) => CalendarOutputFormat | calls: (options: CalendarOptions, global: GlobalOptions) => CalendarOutputFormat"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveCanonicalPmErrorCodeContract",
+          "signature": "(code: string, catalog: readonly PmErrorCodeContract[]) => PmErrorCodeContract | calls: (code: string, catalog: readonly PmErrorCodeContract[]) => PmErrorCodeContract"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10432,6 +10156,12 @@
           "name": "resolveLinkedTestFailureExitCode",
           "signature": "(execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"maxBufferExceeded\" | \"timedOut\">) => number | calls: (execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"timedOut\" | \"maxBufferExceeded\">) => number"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveMergeInstallContext",
+          "signature": "(options: { cwd: string; explicitPath?: string; dryRun: boolean; environment: Readonly<Record<string, string | undefined>>; }) => MergeInstallContextResolution | calls: (options: { cwd: string; explicitPath?: string; dryRun: boolean; environment: Readonly<Record<string, string | undefined>>; }) => MergeInstallContextResolution"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -10462,6 +10192,12 @@
           "name": "resolvePmCliVersion",
           "signature": "(metaUrl: string, fallbackRelativeSegments?: string[]) => string | undefined | calls: (metaUrl: string, fallbackRelativeSegments?: string[]) => string | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmCommandExitContract",
+          "signature": "(commandPath: string) => PmCommandExitContract | undefined | calls: (commandPath: string) => PmCommandExitContract | undefined"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -10618,6 +10354,12 @@
           "name": "resolveSettingsWithSemanticRuntimeDefaults",
           "signature": "(settings: PmSettings) => SemanticRuntimeDefaultsResolution | calls: (settings: PmSettings) => SemanticRuntimeDefaultsResolution"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveSourceContextWritePolicy",
+          "signature": "(environment: Readonly<Record<string, string | undefined>>) => SourceContextWritePolicy | calls: (environment: Readonly<Record<string, string | undefined>>) => SourceContextWritePolicy"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10666,6 +10408,12 @@
           "name": "resolveTypeWorkflows",
           "signature": "(schema: Pick<RuntimeSchemaSettings, \"type_workflows\"> | undefined) => NormalizedTypeWorkflow[] | calls: (schema: Pick<RuntimeSchemaSettings, \"type_workflows\"> | undefined) => NormalizedTypeWorkflow[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveUnknownAuthorAcknowledgmentSelector",
+          "signature": "(rawEvents: readonly string[], allActionable: boolean) => { events: UnknownAuthorHistoryEvent[]; all_actionable: boolean; } | calls: (rawEvents: readonly string[], allActionable: boolean) => { events: UnknownAuthorHistoryEvent[]; all_actionable: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10990,6 +10738,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",
@@ -11188,6 +10942,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",
@@ -12364,6 +12124,30 @@
           "name": "sortLinkedArtifacts",
           "signature": "(artifacts: LinkedArtifact[]) => LinkedArtifact[] | calls: (artifacts: LinkedArtifact[]) => LinkedArtifact[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SOURCE_CONTEXT_ACCESS_ENV",
+          "signature": "\"PM_SOURCE_CONTEXT_ACCESS\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SOURCE_CONTEXT_WRITE_OVERRIDE_ENV",
+          "signature": "\"PM_ALLOW_SOURCE_CONTEXT_WRITES\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "SourceContextAccessMode",
+          "signature": "export type SourceContextAccessMode = \"read_only\" | \"write\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "SourceContextWritePolicy",
+          "signature": "export interface SourceContextWritePolicy { access: SourceContextAccessMode; write_override_applied: boolean; source_writes_allowed: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12464,13 +12248,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",
@@ -13096,6 +12880,12 @@
           "name": "toReplayDocument",
           "signature": "(document: ItemDocument) => ReplayDocument | calls: (document: ItemDocument) => ReplayDocument"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "translateHostEnvironmentFault",
+          "signature": "(error: unknown, operation: string, options?: HostEnvironmentBoundaryOptions) => PmCliError | null | calls: (error: unknown, operation: string, options?: HostEnvironmentBoundaryOptions) => PmCliError | null"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -13402,6 +13192,12 @@
           "name": "withFlagAliasMetadata",
           "signature": "(flagContracts: CliFlagContract[]) => CliFlagContract[] | calls: (flagContracts: CliFlagContract[]) => CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "withHostEnvironmentBoundary",
+          "signature": "<T>(operation: string, run: () => Promise<T>, options?: HostEnvironmentBoundaryOptions) => Promise<T> | calls: <T>(operation: string, run: () => Promise<T>, options?: HostEnvironmentBoundaryOptions) => Promise<T>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -13474,6 +13270,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",
@@ -15088,6 +14896,12 @@
           "name": "AGGREGATE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "analyzePmCommandExitConformance",
+          "signature": "(observations: readonly PmCommandExitObservation[], expectedCommands?: readonly string[], contracts?: readonly PmCommandExitContract[]) => PmCommandExitConformanceReport | calls: (observations: readonly PmCommandExitObservation[], expectedCommands?: readonly string[], contracts?: readonly PmCommandExitContract[]) => PmCommandExitConformanceReport"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -15340,6 +15154,12 @@
           "name": "DEPS_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "derivePmBulkMutationEffect",
+          "signature": "(counts: PmBulkMutationEffectCounts) => PmCommandEffectReceipt | calls: (counts: PmBulkMutationEffectCounts) => PmCommandEffectReceipt"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -15622,12 +15442,24 @@
           "name": "isPmExtensionServiceNameContract",
           "signature": "(value: string) => value is PmExtensionServiceNameContract | calls: (value: string) => value is PmExtensionServiceNameContract"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "isPmKnownExitCode",
+          "signature": "(exitCode: number) => exitCode is PmCommandExitCode | calls: (exitCode: number) => exitCode is PmCommandExitCode"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
           "name": "isPmMutationReceipt",
           "signature": "(value: unknown) => value is PmCliMutationReceipt | calls: (value: unknown) => value is PmCliMutationReceipt"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "isPmSuccessfulExitCode",
+          "signature": "(exitCode: number) => boolean | calls: (exitCode: number) => boolean"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -15748,6 +15580,18 @@
           "name": "PM_CLI_ONLY_TOOL_ACTION_WAIVERS",
           "signature": "{ readonly help: \"Commander help rendering has no SDK operation result.\"; readonly item: \"The item namespace only groups lifecycle subcommands already exposed as actions.\"; readonly packages: \"The plural package alias only renders package-oriented help.\"; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_COMMAND_EXIT_CONTRACTS",
+          "signature": "readonly PmCommandExitContract[]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_COMMAND_EXIT_OUTCOME_CONTRACTS",
+          "signature": "readonly [{ readonly exit_code: 0; readonly outcome: \"effect\"; readonly success: true; readonly meaning: \"The requested operation completed with its intended effect.\"; }, { readonly exit_code: 1; readonly outcome: \"internal_failure\"; readonly success: false; readonly meaning: \"An unexpected runtime or internal failure prevented completion.\"; }, { readonly exit_code: 2; readonly outcome: \"refused_input\"; readonly success: false; readonly meaning: \"The invocation was refused because its input or composition was invalid.\"; }, { readonly exit_code: 3; readonly outcome: \"refused_tracker_state\"; readonly success: false; readonly meaning: \"The requested tracker, item, or resource was not present.\"; }, { readonly exit_code: 4; readonly outcome: \"conflict\"; readonly success: false; readonly meaning: \"Current state or concurrency prevented the requested effect.\"; }, { readonly exit_code: 5; readonly outcome: \"dependency_failed\"; readonly success: false; readonly meaning: \"A required dependency operation failed.\"; }, { readonly exit_code: 6; readonly outcome: \"no_effect\"; readonly success: true; readonly meaning: \"The request was valid and completed, but matched nothing to change.\"; }, { readonly exit_code: 7; readonly outcome: \"partial_effect\"; readonly success: true; readonly meaning: \"The request completed and changed some, but not all, selected targets.\"; }]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -15856,6 +15700,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",
@@ -15880,6 +15730,12 @@
           "name": "PM_READ_OUTPUT_SURFACES",
           "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\"]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_SUCCESS_EXIT_CODES",
+          "signature": "readonly [0, 6, 7]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -15908,7 +15764,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.0\""
+          "signature": "\"4.4.1\""
         },
         {
           "classification": "contract_data",
@@ -15934,6 +15790,12 @@
           "name": "PmBulkMutationControlOptions",
           "signature": "export type PmBulkMutationControlOptions = { dryRun?: boolean; rollback?: boolean; noCheckpoint?: boolean; };"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmBulkMutationEffectCounts",
+          "signature": "export interface PmBulkMutationEffectCounts { applied: number; skipped: number; failed: number; unmatched: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -15958,6 +15820,54 @@
           "name": "PmCloseManyActionOptions",
           "signature": "export type PmCloseManyActionOptions = Pick<PmCloseActionOptions, \"reason\" | \"completedAt\" | \"resolution\" | \"expectedResult\" | \"actualResult\" | \"validateClose\" | \"author\" | \"message\" | \"force\"> & PmBulkMutationFilterOptions & PmBulkMutationControlOptions;"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandEffect",
+          "signature": "export type PmCommandEffect = \"effect\" | \"no_effect\" | \"partial_effect\" | \"dependency_failed\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandEffectReceipt",
+          "signature": "export interface PmCommandEffectReceipt { outcome: PmCommandEffect; exit_code: 0 | 5 | 6 | 7; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandExitCode",
+          "signature": "export type PmCommandExitCode = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitConformanceReport",
+          "signature": "export interface PmCommandExitConformanceReport { ok: boolean; missing_commands: string[]; undeclared_observations: PmCommandExitObservation[]; unreachable_exit_codes: PmCommandExitCode[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitContract",
+          "signature": "export interface PmCommandExitContract { command: string; exit_codes: readonly PmCommandExitCode[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitObservation",
+          "signature": "export interface PmCommandExitObservation { command: string; exit_code: number; replay_id: string; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmCommandExitOutcome",
+          "signature": "export type PmCommandExitOutcome = \"effect\" | \"internal_failure\" | \"refused_input\" | \"refused_tracker_state\" | \"conflict\" | \"dependency_failed\" | \"no_effect\" | \"partial_effect\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmCommandExitOutcomeContract",
+          "signature": "export interface PmCommandExitOutcomeContract { exit_code: PmCommandExitCode; outcome: PmCommandExitOutcome; success: boolean; meaning: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -16016,7 +15926,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
         },
         {
           "classification": "contract_data",
@@ -16148,7 +16058,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",
@@ -16160,13 +16070,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",
@@ -16264,12 +16186,24 @@
           "name": "REMIND_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveCanonicalPmErrorCodeContract",
+          "signature": "(code: string, catalog: readonly PmErrorCodeContract[]) => PmErrorCodeContract | calls: (code: string, catalog: readonly PmErrorCodeContract[]) => PmErrorCodeContract"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
           "name": "resolveContextIntentContract",
           "signature": "(command: string, intent: string, contracts?: readonly PmContextIntentContract[]) => PmContextIntentContract | undefined | calls: (command: string, intent: string, contracts?: readonly PmContextIntentContract[]) => PmContextIntentContract | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolvePmCommandExitContract",
+          "signature": "(commandPath: string) => PmCommandExitContract | undefined | calls: (commandPath: string) => PmCommandExitContract | undefined"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -16726,6 +16660,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",
@@ -16814,13 +16760,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "supported",
@@ -16976,7 +16922,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXIT_CODE",
-          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; }"
+          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; readonly NO_EFFECT: 6; readonly PARTIAL_EFFECT: 7; }"
         },
         {
           "classification": "supported",
@@ -17144,13 +17090,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "supported",
@@ -17216,13 +17162,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "supported",
@@ -17230,12 +17176,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",
@@ -17312,7 +17270,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",
@@ -17324,13 +17282,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",
@@ -17356,6 +17332,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",
@@ -17558,7 +17540,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "_testOnlyHealthCommand",
-          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
+          "signature": "{ buildExtensionHealthTriageSummary: typeof buildExtensionHealthTriageSummary; buildCapabilityContractMetadata: typeof buildCapabilityContractMetadata; buildStaleInProgressHealthSummary: typeof buildStaleInProgressHealthSummary; buildVectorizationProviderDetails: typeof buildVectorizationProviderDetails; collectUnknownCapabilityGuidance: typeof collectUnknownCapabilityGuidance; isAdvisoryHealthWarning: typeof isAdvisoryHealthWarning; isDirectory: typeof isDirectory; isExpectedUnmanagedExtension: typeof isExpectedUnmanagedExtension; listItemDocumentPaths: typeof listItemDocumentPaths; normalizeEndpointForDisplay: typeof normalizeEndpointForDisplay; normalizeExtensionNameForMatch: typeof normalizeExtensionNameForMatch; parseTelemetryQueue: typeof parseTelemetryQueue; probeTelemetryEndpointHealth: typeof probeTelemetryEndpointHealth; projectHealthResult: typeof projectHealthResult; resolveActionableUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveHealthSkipPolicy: typeof resolveHealthSkipPolicy; resolveUnknownAuthorEventCount: (authorAttribution: HistoryAuthorAttributionScan) => number; resolveVectorRefreshPolicy: typeof resolveVectorRefreshPolicy; selectStaleItemDetail: typeof selectStaleItemDetail; summarizeHealthCheckDetails: typeof summarizeHealthCheckDetails; summarizeExtensionList: typeof summarizeExtensionList; summarizeRecordList: typeof summarizeRecordList; summarizeStringList: typeof summarizeStringList; telemetryEnvFlagEnabled: typeof telemetryEnvFlagEnabled; warningCode: typeof warningCode; }"
         },
         {
           "classification": "supported",
@@ -17584,6 +17566,12 @@
           "name": "acknowledgeUnknownAuthorHistoryEvents",
           "signature": "(pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions) => Promise<{ acknowledged: number; history_path: string; }> | calls: (pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions) => Promise<{ acknowledged: number; history_path: string; }>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "acknowledgeUnknownAuthorHistoryEventsFromTransport",
+          "signature": "(pmRoot: string, input: Record<string, unknown>) => Promise<{ acknowledged: number; history_path: string; }> | calls: (pmRoot: string, input: Record<string, unknown>) => Promise<{ acknowledged: number; history_path: string; }>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -17794,6 +17782,12 @@
           "name": "normalizeSimilarityText",
           "signature": "(value: string) => string | calls: (value: string) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseUnknownAuthorHistoryEventCoordinates",
+          "signature": "(values: readonly string[]) => UnknownAuthorHistoryEvent[] | calls: (values: readonly string[]) => UnknownAuthorHistoryEvent[]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -17830,6 +17824,12 @@
           "name": "ReindexResult",
           "signature": "export interface ReindexResult { ok: boolean; mode: ReindexMode; total_items: number; semantic: { enabled: boolean; stale_items: number; unchanged_items: number; embedded_items: number; vector_upserted: number; batches_completed: number; }; artifacts: { manifest: string; embeddings: string; }; warnings: string[]; generated_at: string; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveUnknownAuthorAcknowledgmentSelector",
+          "signature": "(rawEvents: readonly string[], allActionable: boolean) => { events: UnknownAuthorHistoryEvent[]; all_actionable: boolean; } | calls: (rawEvents: readonly string[], allActionable: boolean) => { events: UnknownAuthorHistoryEvent[]; all_actionable: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -19450,6 +19450,12 @@
           "name": "mergeHistoryStreams",
           "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string) => HistoryMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string) => HistoryMergeResult"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeInstallContextResolution",
+          "signature": "export interface MergeInstallContextResolution { pm_root: string; workspace_start: string; source_coordinates_available: boolean; source_context_selected: boolean; source_policy: ReturnType<typeof resolveSourceContextWritePolicy>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -19528,6 +19534,12 @@
           "name": "RelationshipStreamMergeResult",
           "signature": "export interface RelationshipStreamMergeResult { merged: string; strategy: HistoryMergeStrategy; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveMergeInstallContext",
+          "signature": "(options: { cwd: string; explicitPath?: string; dryRun: boolean; environment: Readonly<Record<string, string | undefined>>; }) => MergeInstallContextResolution | calls: (options: { cwd: string; explicitPath?: string; dryRun: boolean; environment: Readonly<Record<string, string | undefined>>; }) => MergeInstallContextResolution"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -21302,13 +21314,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "advanced_export",
@@ -21410,7 +21422,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -21596,7 +21608,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "EXIT_CODE",
-          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; }"
+          "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; readonly NO_EFFECT: 6; readonly PARTIAL_EFFECT: 7; }"
         },
         {
           "classification": "advanced_export",
@@ -21806,7 +21818,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",
@@ -22022,13 +22034,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "advanced_export",
@@ -22250,13 +22262,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
         },
         {
           "classification": "supported",
@@ -22460,7 +22472,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
         },
         {
           "classification": "supported",
@@ -22472,19 +22484,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",
@@ -23324,13 +23348,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",
@@ -24282,7 +24306,11 @@
     "field_invalid",
     "field_mcp_input_collision",
     "github_source_entry_unbuilt",
+    "history_author_acknowledge_required_values_missing",
+    "history_author_acknowledge_selector_conflict",
     "history_author_acknowledge_selector_required",
+    "history_author_acknowledge_target_not_actionable",
+    "history_author_acknowledge_target_unreadable",
     "history_drift_chain_mismatch",
     "history_drift_hash_mismatch",
     "history_drift_missing_stream",
@@ -24291,6 +24319,12 @@
     "history_stream_over_compact_threshold",
     "history_target_out_of_range",
     "history_unknown_author_events",
+    "host_environment_capacity_fault",
+    "host_environment_operation_invalid",
+    "host_environment_permission_fault",
+    "host_environment_resource_fault",
+    "improvement_metric_contract_conflict",
+    "improvement_observation_conflict",
     "init_existing_settings_requires_force",
     "init_gitignore_unwritable",
     "init_id_prefix_conflict",
@@ -24309,8 +24343,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",
@@ -24351,6 +24394,8 @@
     "profile_name_not_normalized",
     "profile_summary_empty",
     "profile_title_empty",
+    "project_runtime_stale_mutation",
+    "project_runtime_stale_read",
     "redundant_edge",
     "reindex_already_running",
     "reserved_item_field",
@@ -24448,6 +24493,9 @@
     "workspace_snapshot_manifest_mismatch",
     "workspace_snapshot_name_reserved_fingerprint",
     "workspace_snapshot_not_found",
+    "workspace_snapshot_permission_denied",
+    "workspace_snapshot_resource_exhausted",
+    "workspace_snapshot_storage_exhausted",
     "wrong_item_type"
   ],
   "package": "@unbrained/pm-cli",