@unbrained/pm-cli 2026.8.7 → 2026.8.9

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1441,
+    "covered_symbols": 1477,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1442
+    "required_symbols": 1478
   },
   "breaking_acknowledgements": [
     {
@@ -20,6 +20,125 @@
       ],
       "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."
+    },
+    {
+      "changes": [
+        "signature ./sdk:DuplicateClustersResult",
+        "signature ./sdk:ItemDocumentMergeResult",
+        "signature ./sdk:listMergeReceipts",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk:MergeDecisionReceiptSummary",
+        "signature ./sdk:MergeDriverResult",
+        "signature ./sdk:mergeItemDocuments",
+        "signature ./sdk:PM_READ_OUTPUT_SURFACES",
+        "signature ./sdk/contracts:PM_READ_OUTPUT_SURFACES",
+        "signature ./sdk/governance:DuplicateClustersResult",
+        "signature ./sdk/merge:ItemDocumentMergeResult",
+        "signature ./sdk/merge:listMergeReceipts",
+        "signature ./sdk/merge:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceiptSummary",
+        "signature ./sdk/merge:MergeDriverResult",
+        "signature ./sdk/merge:mergeItemDocuments"
+      ],
+      "package_version": "2026.8.8",
+      "reason": "Truthful merge receipts, duplicate filters, and package read-output contracts"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ContractsResult",
+        "signature ./sdk:DepsResult",
+        "signature ./sdk:GraphAuditResult",
+        "signature ./sdk:WorkspaceRelationshipAssembly",
+        "signature ./sdk/core:DepsResult",
+        "signature ./sdk/graph:GraphAuditResult",
+        "signature ./sdk/graph:WorkspaceRelationshipAssembly",
+        "signature ./sdk/runtime:ContractsResult",
+        "signature ./sdk/runtime:DepsResult"
+      ],
+      "package_version": "2026.8.8",
+      "reason": "Additive optional SDK result diagnostics and relationship ontology projections; established fields and function inputs remain compatible"
+    },
+    {
+      "changes": [
+        "signature ./sdk:WorkspaceRelationshipAssembly",
+        "signature ./sdk/graph:WorkspaceRelationshipAssembly"
+      ],
+      "package_version": "2026.8.8",
+      "reason": "Make the newly introduced legacyAliasCounts assembly field total so all public consumers receive a stable empty object instead of an impossible undefined state"
     }
   ],
   "entrypoints": {
@@ -54,7 +173,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 +241,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",
@@ -134,6 +259,12 @@
           "name": "acquireLock",
           "signature": "(pmRoot: string, id: string, ttlSeconds: number, owner: string, force?: boolean, forceRequiredForStaleLock?: boolean, waitMs?: number) => Promise<() => Promise<void>> | calls: (pmRoot: string, id: string, ttlSeconds: number, owner: string, force?: boolean, forceRequiredForStaleLock?: boolean, waitMs?: number) => Promise<() => Promise<void>>"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "ACTIONABILITY_ORDERING_KINDS",
+          "signature": "readonly string[]"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -284,6 +415,12 @@
           "name": "AgentProvenance",
           "signature": "export type AgentProvenance = Readonly<Record<string, AgentProvenanceObservation | null>>;"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "AgentProvenanceAbsenceReason",
+          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -302,6 +439,12 @@
           "name": "AgentProvenanceObservation",
           "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceOutcome",
+          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -362,6 +505,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 +557,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 +571,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 +853,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",
@@ -1112,6 +1285,12 @@
           "name": "BUILTIN_PROFILES",
           "signature": "Record<\"agile\" | \"ops\" | \"research\", ProjectProfileDefinition>"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_RELATIONSHIP_KINDS",
+          "signature": "readonly RelationshipKindDefinition[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -1220,6 +1399,12 @@
           "name": "canonicalizeCommandOptionKey",
           "signature": "(command: CommandOptionPolicyCommand, rawOption: string) => string | undefined | calls: (command: CommandOptionPolicyCommand, rawOption: string) => string | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "canonicalizeRelationshipKind",
+          "signature": "(kind: string) => string | calls: (kind: string) => string"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1274,6 +1459,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",
@@ -1424,6 +1615,12 @@
           "name": "collectBlockedByIds",
           "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">) => string[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">) => string[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectBlockedByIdsFromCorpus",
+          "signature": "(item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[] | calls: (item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -1596,13 +1793,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 +1885,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 +2387,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[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; 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",
@@ -2850,7 +3053,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "DepsResult",
-          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
+          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; legacy_alias_counts?: Record<string, number>; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
         },
         {
           "classification": "advanced_export",
@@ -2864,6 +3067,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",
@@ -2948,6 +3157,18 @@
           "name": "detectRelationshipCommunities",
           "signature": "(graph: RelationshipGraph, options?: GraphCommunityOptions) => RelationshipQueryResult<RelationshipCommunityAnalysis> | calls: (graph: RelationshipGraph, options?: GraphCommunityOptions) => RelationshipQueryResult<RelationshipCommunityAnalysis>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "diagnoseAgentIdentity",
+          "signature": "(signals?: HarnessDetectionSignals) => DiagnosedAgentIdentity | calls: (signals?: HarnessDetectionSignals) => DiagnosedAgentIdentity"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "DiagnosedAgentIdentity",
+          "signature": "export interface DiagnosedAgentIdentity extends DetectedAgentIdentity { provenance_outcomes: Readonly<Record<string, AgentProvenanceOutcome>>; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -2972,6 +3193,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",
@@ -3012,7 +3239,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "DuplicateClustersResult",
-          "signature": "export interface DuplicateClustersResult { clusters: DuplicateCluster[]; count: number; threshold: number; source: \"metadata_scan\"; cost: { item_count: number; candidate_pairs: number; scored_pairs: number; }; }"
+          "signature": "export interface DuplicateClustersResult { clusters: DuplicateCluster[]; count: number; threshold: number; source: \"metadata_scan\"; filters: { statuses: string[] | null; since: string | null; }; cost: { item_count: number; candidate_pairs: number; scored_pairs: number; }; }"
         },
         {
           "classification": "supported",
@@ -3312,7 +3539,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",
@@ -4470,7 +4697,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAuditResult",
-          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -5060,6 +5287,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",
@@ -5126,6 +5365,12 @@
           "name": "ImprovementTrend",
           "signature": "export interface ImprovementTrend { metric: string; direction: ImprovementDirection; baseline: ImprovementObservation; latest: ImprovementObservation; delta: number; improved: boolean; sample_count: number; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "indexBlockedByIds",
+          "signature": "(corpus: readonly ItemMetadata[]) => Map<string, string[]> | calls: (corpus: readonly ItemMetadata[]) => Map<string, string[]>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5228,6 +5473,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 +5593,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",
@@ -5454,7 +5723,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "advanced_export",
@@ -5592,13 +5861,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",
@@ -5814,7 +6083,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "listMergeReceipts",
-          "signature": "(cwd: string, options?: { includeReconciled?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; }) => Promise<MergeDecisionReceipt[]>"
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]>"
         },
         {
           "classification": "supported",
@@ -6072,13 +6341,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -6102,7 +6371,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -6128,6 +6397,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",
@@ -6144,7 +6419,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "mergeItemDocuments",
-          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; }) => ItemDocumentMergeResult"
+          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: \"preferred_side\" | \"stable_value_order\"; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: \"preferred_side\" | \"stable_value_order\"; }) => ItemDocumentMergeResult"
         },
         {
           "classification": "supported",
@@ -6332,6 +6607,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 +6749,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 +7303,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 +7501,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",
@@ -7446,7 +7745,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_SURFACES",
-          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\"]"
+          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"package-manage\"]"
         },
         {
           "classification": "advanced_export",
@@ -7460,6 +7759,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 +7793,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 +7843,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 +7933,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 +8063,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 +8737,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",
@@ -8390,6 +8767,18 @@
           "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": "supported",
+          "kind": "interface",
+          "name": "ProvenanceResolverHealthOutcome",
+          "signature": "export interface ProvenanceResolverHealthOutcome { harness: string; dimension: string; resolver: string; attempts: number; successes: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProvenanceResolverHealthScan",
+          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; warnings: string[]; events_read: number; truncated: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9662,6 +10051,18 @@
           "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": "supported",
+          "kind": "function",
+          "name": "resolveCanonicalRelationshipKind",
+          "signature": "(kind: unknown) => string | undefined | calls: (kind: unknown) => string | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9872,6 +10273,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 +10309,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 +10471,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 +10525,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",
@@ -11012,6 +11437,12 @@
           "name": "scanMutationSecrets",
           "signature": "(payload: unknown) => SecretGuardFinding[] | calls: (payload: unknown) => SecretGuardFinding[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "scanProvenanceResolverHealth",
+          "signature": "(pmRoot: string, eventLimit?: number) => Promise<ProvenanceResolverHealthScan> | calls: (pmRoot: string, eventLimit?: number) => Promise<ProvenanceResolverHealthScan>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -11816,6 +12247,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 +13003,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 +13315,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",
@@ -13002,7 +13469,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "WorkspaceRelationshipAssembly",
-          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; }"
+          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; legacyAliasCounts: Record<string, number>; }"
         },
         {
           "classification": "supported",
@@ -14552,6 +15019,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 +15277,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 +15565,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 +15703,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",
@@ -15348,7 +15851,13 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_SURFACES",
-          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\"]"
+          "signature": "readonly [\"list\", \"context\", \"search\", \"get\", \"next\", \"health\", \"deps\", \"graph\", \"history\", \"activity\", \"validate\", \"events\", \"contracts\", \"comments\", \"notes\", \"files\", \"docs\", \"stats\", \"aggregate\", \"package-manage\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_SUCCESS_EXIT_CODES",
+          "signature": "readonly [0, 6, 7]"
         },
         {
           "classification": "contract_data",
@@ -15378,7 +15887,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 +15913,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 +15943,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 +16049,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 +16309,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",
@@ -16118,6 +16693,12 @@
           "name": "AgentProvenance",
           "signature": "export type AgentProvenance = Readonly<Record<string, AgentProvenanceObservation | null>>;"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "AgentProvenanceAbsenceReason",
+          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -16136,6 +16717,12 @@
           "name": "AgentProvenanceObservation",
           "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceOutcome",
+          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -16308,13 +16895,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",
@@ -16416,7 +17003,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "DepsResult",
-          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
+          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; legacy_alias_counts?: Record<string, number>; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
         },
         {
           "classification": "supported",
@@ -16436,6 +17023,18 @@
           "name": "detectHarnessIdentity",
           "signature": "(signals?: HarnessDetectionSignals) => string | undefined | calls: (signals?: HarnessDetectionSignals) => string | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "diagnoseAgentIdentity",
+          "signature": "(signals?: HarnessDetectionSignals) => DiagnosedAgentIdentity | calls: (signals?: HarnessDetectionSignals) => DiagnosedAgentIdentity"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "DiagnosedAgentIdentity",
+          "signature": "export interface DiagnosedAgentIdentity extends DetectedAgentIdentity { provenance_outcomes: Readonly<Record<string, AgentProvenanceOutcome>>; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -16470,7 +17069,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 +17237,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 +17309,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 +17687,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 +17713,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",
@@ -17136,7 +17741,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "DuplicateClustersResult",
-          "signature": "export interface DuplicateClustersResult { clusters: DuplicateCluster[]; count: number; threshold: number; source: \"metadata_scan\"; cost: { item_count: number; candidate_pairs: number; scored_pairs: number; }; }"
+          "signature": "export interface DuplicateClustersResult { clusters: DuplicateCluster[]; count: number; threshold: number; source: \"metadata_scan\"; filters: { statuses: string[] | null; since: string | null; }; cost: { item_count: number; candidate_pairs: number; scored_pairs: number; }; }"
         },
         {
           "classification": "supported",
@@ -17324,6 +17929,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",
@@ -17348,6 +17959,18 @@
           "name": "projectValidateCounts",
           "signature": "(result: ValidateResult) => ValidateCountsResult | calls: (result: ValidateResult) => ValidateCountsResult"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProvenanceResolverHealthOutcome",
+          "signature": "export interface ProvenanceResolverHealthOutcome { harness: string; dimension: string; resolver: string; attempts: number; successes: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProvenanceResolverHealthScan",
+          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; warnings: string[]; events_read: number; truncated: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -17360,6 +17983,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",
@@ -17414,6 +18043,12 @@
           "name": "scanMutationSecrets",
           "signature": "(payload: unknown) => SecretGuardFinding[] | calls: (payload: unknown) => SecretGuardFinding[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "scanProvenanceResolverHealth",
+          "signature": "(pmRoot: string, eventLimit?: number) => Promise<ProvenanceResolverHealthScan> | calls: (pmRoot: string, eventLimit?: number) => Promise<ProvenanceResolverHealthScan>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17612,6 +18247,12 @@
     "./sdk/graph": {
       "classification": "supported",
       "symbols": [
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "ACTIONABILITY_ORDERING_KINDS",
+          "signature": "readonly string[]"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -17684,6 +18325,18 @@
           "name": "buildRelationshipContext",
           "signature": "(graph: RelationshipGraph, rootId: string, details: readonly RelationshipContextNodeDetails[], options?: RelationshipContextOptions) => RelationshipContextResult | calls: (graph: RelationshipGraph, rootId: string, details: readonly RelationshipContextNodeDetails[], options?: RelationshipContextOptions) => RelationshipContextResult"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_RELATIONSHIP_KINDS",
+          "signature": "readonly RelationshipKindDefinition[]"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "canonicalizeRelationshipKind",
+          "signature": "(kind: string) => string | calls: (kind: string) => string"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17696,6 +18349,12 @@
           "name": "collectBlockedByIds",
           "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">) => string[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">) => string[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectBlockedByIdsFromCorpus",
+          "signature": "(item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[] | calls: (item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17946,7 +18605,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "GraphAuditResult",
-          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
+          "signature": "export interface GraphAuditResult { subcommand: \"audit\"; finding_count: number; findings_by_severity: Record<string, number>; findings_by_code: Record<string, number>; affected_subjects_by_severity: Record<string, number>; affected_subjects_by_code: Record<string, number>; profile: RelationshipAuditReport[\"profile\"]; legacy_alias_counts?: Record<string, number>; findings?: RelationshipAuditReport[\"findings\"]; baseline?: RelationshipAuditDelta; cache?: GraphCacheMetadata; }"
         },
         {
           "classification": "supported",
@@ -18158,6 +18817,12 @@
           "name": "hierarchyDescendants",
           "signature": "(graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]> | calls: (graph: RelationshipGraph, id: string, options?: GraphTraversalOptions) => RelationshipQueryResult<string[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "indexBlockedByIds",
+          "signature": "(corpus: readonly ItemMetadata[]) => Map<string, string[]> | calls: (corpus: readonly ItemMetadata[]) => Map<string, string[]>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -18752,6 +19417,12 @@
           "name": "resetWorkspaceGraphCache",
           "signature": "() => void | calls: () => void"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveCanonicalRelationshipKind",
+          "signature": "(kind: unknown) => string | undefined | calls: (kind: unknown) => string | undefined"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -18816,7 +19487,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "WorkspaceRelationshipAssembly",
-          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; }"
+          "signature": "export interface WorkspaceRelationshipAssembly { graph: RelationshipGraph; details: WorkspaceRelationshipNodeDetails[]; missingIdSet: Set<string>; dangling: DanglingDependencyReferenceSummary; duplicateRows: DuplicateDependencyRow[]; legacyAliasCounts: Record<string, number>; }"
         },
         {
           "classification": "supported",
@@ -18894,7 +19565,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "supported",
@@ -18912,7 +19583,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "listMergeReceipts",
-          "signature": "(cwd: string, options?: { includeReconciled?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; }) => Promise<MergeDecisionReceipt[]>"
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]>"
         },
         {
           "classification": "supported",
@@ -18930,13 +19601,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -18960,7 +19631,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -18980,6 +19651,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",
@@ -18996,7 +19673,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "mergeItemDocuments",
-          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; }) => ItemDocumentMergeResult"
+          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: \"preferred_side\" | \"stable_value_order\"; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: \"preferred_side\" | \"stable_value_order\"; }) => ItemDocumentMergeResult"
         },
         {
           "classification": "supported",
@@ -19058,6 +19735,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 +21515,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 +21623,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[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; 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",
@@ -21054,7 +21737,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "DepsResult",
-          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
+          "signature": "export interface DepsResult { id: string; format: DepsFormat; node_count: number; edge_count: number; edge_basis: \"deduplicated_directed\"; legacy_alias_counts?: Record<string, number>; missing_count: number; missing_scope?: \"traversal\"; missing_reference_count?: number; missing_references?: DanglingDependencyReference[]; truncation?: { reasons: Array<\"max_depth\" | \"node_limit\" | \"edge_limit\" | \"token_budget\">; limits: { max_depth: number; node_limit: number; edge_limit: number; token_budget: number; }; estimated_tokens: number; total_node_count: number; total_edge_count: number; omitted_node_count: number; omitted_edge_count: number; }; tree?: DepsTreeNode; graph?: DepsGraphResult; context?: RelationshipContextResult; projection: OutputProjectionDeclaration; }"
         },
         {
           "classification": "supported",
@@ -21126,7 +21809,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 +22235,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 +22463,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 +22673,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 +24507,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 +24520,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",
@@ -23880,7 +24571,9 @@
     "malformed_plan_step_evidence",
     "manifest_capabilities_absent",
     "merge_conflict_markers_detected",
+    "merge_decisions_unreviewed",
     "merge_git_config_unwritable",
+    "merge_reconcile_discards_require_acceptance",
     "merge_root_not_found",
     "missing_directory",
     "missing_lifecycle_target",
@@ -23904,6 +24597,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",
@@ -23969,6 +24664,7 @@
     "validate_lifecycle_dependency_cycles",
     "validate_lifecycle_dependency_cycles_error",
     "validate_lifecycle_stale_blockers",
+    "validate_merge_decisions_unreviewed",
     "validate_merge_fence_drift",
     "validate_metadata_custom_profile_missing_required_fields",
     "validate_metadata_duplicate_issue_codes",
@@ -24001,6 +24697,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",