@unbrained/pm-cli 2026.8.7 → 2026.8.8

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1441,
+    "covered_symbols": 1464,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1442
+    "required_symbols": 1465
   },
   "breaking_acknowledgements": [
     {
@@ -20,6 +20,80 @@
       ],
       "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:AnnotationCommandOptions",
+        "signature ./sdk:AnnotationCommandResult",
+        "signature ./sdk:CommentsCommandOptions",
+        "signature ./sdk:CommentsResult",
+        "signature ./sdk:LearningsCommandOptions",
+        "signature ./sdk:LearningsResult",
+        "signature ./sdk:NotesCommandOptions",
+        "signature ./sdk:NotesResult",
+        "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:_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"
+      ],
+      "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:AnnotationOmissionReceipt"
+      ],
+      "package_version": "2026.8.7",
+      "reason": "pm-9stazf replaces CLI-only annotation restoration guidance with transport-neutral selectors"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmErrorCodeContract",
+        "signature ./sdk/contracts:PmErrorCodeContract",
+        "signature ./sdk/runtime:PmErrorCodeContract"
+      ],
+      "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:ContractsResult",
+        "signature ./sdk:EXIT_CODE",
+        "signature ./sdk/core:EXIT_CODE",
+        "signature ./sdk/runtime:ContractsResult",
+        "signature ./sdk/runtime:EXIT_CODE"
+      ],
+      "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:PmCommandEffect",
+        "signature ./sdk:PmCommandEffectReceipt",
+        "signature ./sdk/contracts:PmCommandEffect",
+        "signature ./sdk/contracts:PmCommandEffectReceipt"
+      ],
+      "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:ProjectRuntimeCompatibilityResult"
+      ],
+      "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": {
@@ -54,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",
@@ -122,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",
@@ -362,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",
@@ -408,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",
@@ -422,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",
@@ -686,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",
@@ -1274,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",
@@ -1596,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",
@@ -1688,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",
@@ -2184,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",
@@ -2864,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",
@@ -2972,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",
@@ -3312,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",
@@ -5060,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",
@@ -5228,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",
@@ -5342,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",
@@ -5592,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",
@@ -6128,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",
@@ -6332,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",
@@ -6468,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",
@@ -7022,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",
@@ -7214,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",
@@ -7460,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",
@@ -7488,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",
@@ -7538,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",
@@ -7622,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",
@@ -7704,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",
@@ -8378,6 +8638,24 @@
           "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": "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": "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",
           "kind": "function",
@@ -9662,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",
@@ -9872,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",
@@ -9902,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",
@@ -10058,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",
@@ -10106,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",
@@ -11816,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",
@@ -12548,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",
@@ -12854,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",
@@ -14552,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",
@@ -14804,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",
@@ -15086,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",
@@ -15212,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",
@@ -15350,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",
@@ -15378,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",
@@ -15404,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",
@@ -15428,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",
@@ -15486,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",
@@ -15746,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",
@@ -16308,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",
@@ -16470,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",
@@ -16638,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",
@@ -16710,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",
@@ -17088,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",
@@ -17114,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",
@@ -17324,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",
@@ -17360,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",
@@ -18980,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",
@@ -19058,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",
@@ -20832,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",
@@ -20940,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",
@@ -21126,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",
@@ -21552,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",
@@ -21780,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",
@@ -21990,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",
@@ -23824,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",
@@ -23833,6 +24319,10 @@
     "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",
@@ -23904,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",
@@ -24001,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",