@unbrained/pm-cli 2026.9.3 → 2026.9.4

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1838,
+    "covered_symbols": 1844,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1839
+    "required_symbols": 1845
   },
   "breaking_acknowledgements": [
     {
@@ -1521,6 +1521,83 @@
       ],
       "package_version": "2026.9.1",
       "reason": "Align ContextSignalSnapshotItem signal provenance with the parser-enforced required persisted contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AgentProvenanceAbsenceReason",
+        "signature ./sdk:HarnessDetectionSignals",
+        "signature ./sdk:ProjectRuntimeCompatibilityResult",
+        "signature ./sdk:ProjectRuntimeVersionPin",
+        "signature ./sdk/core:AgentProvenanceAbsenceReason",
+        "signature ./sdk/core:HarnessDetectionSignals"
+      ],
+      "package_version": "2026.9.2",
+      "reason": "Extend provenance absence, session discovery, runtime pin, and compatibility result contracts for fail-closed history integrity"
+    },
+    {
+      "changes": [
+        "signature ./sdk:reanchorHistoryEntries",
+        "signature ./sdk:resealHistoryRewrite"
+      ],
+      "package_version": "2026.9.2",
+      "reason": "Extend history rewrite provenance to preserve independently verifiable record ancestry"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ProjectRuntimeVersionPin",
+        "signature ./sdk:reanchorHistoryEntries",
+        "signature ./sdk:verifyHistoryRecordHash",
+        "signature ./sdk:verifyHistoryRewriteEvidence"
+      ],
+      "package_version": "2026.9.2",
+      "reason": "Whole-record rewrite evidence and range-aware history compatibility intentionally strengthen fail-closed SDK result unions"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ProjectRuntimeVersionPin"
+      ],
+      "package_version": "2026.9.2",
+      "reason": "Whole-record rewrite evidence and range-aware history compatibility intentionally strengthen fail-closed SDK result unions"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ProjectRuntimeVersionPin"
+      ],
+      "package_version": "2026.9.2",
+      "reason": "Range diagnostics retain their complete declaration and rewrite verification rejects malformed evidence"
+    },
+    {
+      "changes": [
+        "signature ./sdk:classifyHistoryMergeReceiptReferences",
+        "signature ./sdk:HistoryMergeReceiptReference",
+        "signature ./sdk:HistoryMergeReceiptReferenceClassification",
+        "signature ./sdk:ItemDocumentMergeResult",
+        "signature ./sdk:ItemMergeConflictDecision",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk:MergeDecisionReceiptSummary",
+        "signature ./sdk:MergeDriverResult",
+        "signature ./sdk:mergeItemDocuments",
+        "signature ./sdk:MergeReceiptInvalidEvidence",
+        "signature ./sdk:MergeReconcileResult",
+        "signature ./sdk/merge:ItemDocumentMergeResult",
+        "signature ./sdk/merge:ItemMergeConflictDecision",
+        "signature ./sdk/merge:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceiptSummary",
+        "signature ./sdk/merge:MergeDriverResult",
+        "signature ./sdk/merge:mergeItemDocuments",
+        "signature ./sdk/merge:MergeReceiptInvalidEvidence",
+        "signature ./sdk/merge:MergeReconcileResult"
+      ],
+      "package_version": "2026.9.3",
+      "reason": "2026-09-04 merge integrity evolution: item scalar results and receipts expose recency resolution, bounded durable previews, precise validation, and audited legacy disposition outcomes; legacy receipt shapes remain readable."
+    },
+    {
+      "changes": [
+        "signature ./sdk:extractHistoryMergeReceiptDispositions",
+        "signature ./sdk:HistoryMergeReceiptDisposition"
+      ],
+      "package_version": "2026.9.3",
+      "reason": "2026-09-04 merge disposition hardening: the public extractor requires the audit history coordinate so classification proves dispositions are append-after-reference."
     }
   ],
   "entrypoints": {
@@ -1873,7 +1950,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "AgentProvenanceAbsenceReason",
-          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
+          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_input_missing\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
         {
           "classification": "supported",
@@ -3603,6 +3680,12 @@
           "name": "classifyHistoryEvent",
           "signature": "(entry: Pick<HistoryEntry, \"event_class\" | \"op\" | \"patch\">) => HistoryEventClass | calls: (entry: Pick<HistoryEntry, \"op\" | \"patch\" | \"event_class\">) => HistoryEventClass"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "classifyHistoryMergeReceiptReferences",
+          "signature": "(references: readonly HistoryMergeReceiptReference[], availableReceiptIds: ReadonlySet<string>, dispositions?: readonly HistoryMergeReceiptDisposition[]) => HistoryMergeReceiptReferenceClassification | calls: (references: readonly HistoryMergeReceiptReference[], availableReceiptIds: ReadonlySet<string>, dispositions?: readonly HistoryMergeReceiptDisposition[]) => HistoryMergeReceiptReferenceClassification"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -3729,6 +3812,12 @@
           "name": "CloseCommandOptions",
           "signature": "export interface CloseCommandOptions { author?: string; message?: string; validateClose?: string; force?: boolean; resolution?: string; expectedResult?: string; actualResult?: string; duplicateOf?: string; completedAt?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ClosedEpisode",
+          "signature": "export interface ClosedEpisode { verdict: VerdictResult; trajectory: readonly EpisodeTrajectoryEntry[]; reward?: never; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -4941,6 +5030,12 @@
           "name": "CURRENT_HISTORY_ITEM_HASH_VERSION",
           "signature": "3"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "CURRENT_HISTORY_RECORD_HASH_VERSION",
+          "signature": "1"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -5223,6 +5318,12 @@
           "name": "defineCorpusShape",
           "signature": "<const Shape extends CorpusShape>(shape: ExactCorpusShape<Shape>) => Readonly<Shape> | calls: <const Shape extends CorpusShape>(shape: ExactCorpusShape<Shape>) => Readonly<Shape>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "defineEpisodeSpecification",
+          "signature": "(declaration: EpisodeSpecification) => EpisodeSpecification | calls: (declaration: EpisodeSpecification) => EpisodeSpecification"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -5277,6 +5378,12 @@
           "name": "defineMigration",
           "signature": "<TMigration extends MigrationAuthoringDefinition>(migration: ExactDefinition<TMigration, MigrationAuthoringDefinition>) => TMigration | calls: <TMigration extends MigrationAuthoringDefinition>(migration: ExactDefinition<TMigration, MigrationAuthoringDefinition>) => TMigration"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "defineObservationContract",
+          "signature": "(declaration: ObservationContract) => ObservationContract | calls: (declaration: ObservationContract) => ObservationContract"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -5355,6 +5462,12 @@
           "name": "defineVectorStoreAdapter",
           "signature": "<TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter: ExactDefinition<TAdapter, VectorStoreAdapterAuthoringDefinition>) => TAdapter | calls: <TAdapter extends VectorStoreAdapterAuthoringDefinition>(adapter: ExactDefinition<TAdapter, VectorStoreAdapterAuthoringDefinition>) => TAdapter"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "defineVerdictContract",
+          "signature": "(declaration: VerdictContract) => VerdictContract | calls: (declaration: VerdictContract) => VerdictContract"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5547,6 +5660,12 @@
           "name": "describeItemOwnershipConflict",
           "signature": "(pmRoot: string, itemId: string, assignee: string) => Promise<string> | calls: (pmRoot: string, itemId: string, assignee: string) => Promise<string>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "describeObservationCost",
+          "signature": "(contract: ObservationContract) => ObservationCostDescription | calls: (contract: ObservationContract) => ObservationCostDescription"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -5727,6 +5846,12 @@
           "name": "DuplicatesResult",
           "signature": "export interface DuplicatesResult extends Omit<DuplicateClustersResult, \"clusters\"> { clusters: ActionableDuplicateCluster[]; guidance: { strategy: \"review_then_close_duplicate\"; command: \"pm close <duplicate-id> --duplicate-of <canonical-id>\"; }; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "DURABLE_MERGE_RECEIPT_INTRODUCED_AT",
+          "signature": "\"2026-08-09T16:15:18.000Z\""
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5775,6 +5900,12 @@
           "name": "emptyImportedDocument",
           "signature": "() => ItemDocument | calls: () => ItemDocument"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "encodeItemScalarDecisionValue",
+          "signature": "(value: unknown) => unknown | calls: (value: unknown) => unknown"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5859,6 +5990,42 @@
           "name": "enumerateRelationshipPaths",
           "signature": "(graph: RelationshipGraph, source: string, target: string, options?: GraphPathOptions) => RelationshipQueryResult<RelationshipPath[]> | calls: (graph: RelationshipGraph, source: string, target: string, options?: GraphPathOptions) => RelationshipQueryResult<RelationshipPath[]>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeActionReceipt",
+          "signature": "export interface EpisodeActionReceipt<TOutput> { state_id: string; output: TOutput; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeLimits",
+          "signature": "export interface EpisodeLimits { max_actions: number; max_observations: number; max_tokens_per_observation: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeResetReceipt",
+          "signature": "export interface EpisodeResetReceipt { workspace_id: string; state_id: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeRuntimeAdapter",
+          "signature": "export interface EpisodeRuntimeAdapter<TAction, TOutput = unknown> { reset(recipe: WorkspaceRecipe): Promise<EpisodeResetReceipt>; execute(action: TAction): Promise<EpisodeActionReceipt<TOutput>>; readRecordedState(): Promise<WorkspaceRecordedState>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeSpecification",
+          "signature": "export interface EpisodeSpecification { schema: typeof PM_EPISODE_SCHEMA; id: string; version: number; mode: \"benchmark\" | \"evaluation\" | \"training\" | \"scale_transfer\"; recipe: WorkspaceRecipe; task_item_ids: readonly string[]; observable_fields: readonly string[]; withheld_fields: readonly string[]; observation: ObservationContract; verdict: VerdictContract; limits: EpisodeLimits; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "EpisodeTrajectoryEntry",
+          "signature": "export interface EpisodeTrajectoryEntry { sequence: number; kind: \"reset\" | \"observation\" | \"action\" | \"verdict\" | \"close\"; state_id: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -5979,6 +6146,12 @@
           "name": "evaluateTransition",
           "signature": "(input: EvaluateTransitionInput) => EvaluateTransitionResult | calls: (input: EvaluateTransitionInput) => EvaluateTransitionResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "evaluateVerdictContract",
+          "signature": "(contract: VerdictContract, recorded: WorkspaceRecordedState) => VerdictResult | calls: (contract: VerdictContract, recorded: WorkspaceRecordedState) => VerdictResult"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -6777,6 +6950,18 @@
           "name": "ExternalDependencyResolverResult",
           "signature": "export interface ExternalDependencyResolverResult { status: ExternalDependencyResolutionStatus; title?: string; source?: string; checkedAt?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "extractHistoryMergeReceiptDispositions",
+          "signature": "(value: unknown, historyItemId: string, historyLine: number) => HistoryMergeReceiptDisposition[] | calls: (value: unknown, historyItemId: string, historyLine: number) => HistoryMergeReceiptDisposition[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "extractHistoryMergeReceiptReferences",
+          "signature": "(value: unknown, historyItemId: string) => Array<Omit<HistoryMergeReceiptReference, \"itemId\" | \"line\">> | calls: (value: unknown, historyItemId: string) => Array<Omit<HistoryMergeReceiptReference, \"itemId\" | \"line\">>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7597,7 +7782,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HarnessDetectionSignals",
-          "signature": "export interface HarnessDetectionSignals { env?: Readonly<Record<string, string | undefined>>; argv?: readonly string[]; process_labels?: readonly string[]; client_info?: AgentClientInfo; provenance?: Readonly<Record<string, string | undefined>>; session_context?: AgentSessionContext; descriptors?: readonly HarnessSignalDescriptor[]; probes_enabled?: boolean; cwd?: string; home_dir?: string; }"
+          "signature": "export interface HarnessDetectionSignals { env?: Readonly<Record<string, string | undefined>>; argv?: readonly string[]; process_labels?: readonly string[]; client_info?: AgentClientInfo; provenance?: Readonly<Record<string, string | undefined>>; session_context?: AgentSessionContext; descriptors?: readonly HarnessSignalDescriptor[]; probes_enabled?: boolean; cwd?: string; home_dir?: string; session_file?: string; }"
         },
         {
           "classification": "supported",
@@ -7623,6 +7808,30 @@
           "name": "hashEmptyDocument",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hashHistoryPatch",
+          "signature": "(patch: readonly HistoryPatchOp[]) => string | calls: (patch: readonly HistoryPatchOp[]) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hashHistoryRecord",
+          "signature": "(entry: Omit<HistoryEntry, \"record_hash\">) => string | calls: (entry: Omit<HistoryEntry, \"record_hash\">) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hashHistoryStream",
+          "signature": "(entries: readonly HistoryEntry[]) => string | calls: (entries: readonly HistoryEntry[]) => string"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "hashItemScalarDecisionValue",
+          "signature": "(value: unknown) => string | calls: (value: unknown) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7791,6 +8000,12 @@
           "name": "HISTORY_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN",
+          "signature": "\"2026.8.31\""
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -7911,6 +8126,30 @@
           "name": "HistoryItemHashVersion",
           "signature": "export type HistoryItemHashVersion = (typeof SUPPORTED_HISTORY_ITEM_HASH_VERSIONS)[number];"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "historyItemHashVersionForRuntime",
+          "signature": "(version: string) => 2 | 3 | calls: (version: string) => 2 | 3"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryMergeReceiptDisposition",
+          "signature": "export interface HistoryMergeReceiptDisposition { itemId: string; receiptId: string; originalHistoryLine: number; originalEventTimestamp: string; auditHistoryLine: number; reason: \"legacy_clone_local_only\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryMergeReceiptReference",
+          "signature": "export interface HistoryMergeReceiptReference { itemId: string; line: number; receiptId: string; legacySummaryAccepted: boolean; eventTimestamp?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "HistoryMergeReceiptReferenceClassification",
+          "signature": "export interface HistoryMergeReceiptReferenceClassification { missing: MissingHistoryMergeReceiptReference[]; acceptedLegacyCount: number; acceptedDispositionCount: number; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -7941,6 +8180,12 @@
           "name": "HistoryProvenanceSummary",
           "signature": "export interface HistoryProvenanceSummary { entries: number; vocabulary_version: number; harness: { resolved: number; unresolved: number; unresolved_authors: Array<{ author: string; entries: number; }>; }; dimensions: Array<{ dimension: string; observed: number; unavailable: number; legacy_missing: number; }>; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "HistoryRecordHashVersion",
+          "signature": "export type HistoryRecordHashVersion = (typeof SUPPORTED_HISTORY_RECORD_HASH_VERSIONS)[number];"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8349,6 +8594,18 @@
           "name": "isHostOutputSuppressed",
           "signature": "(value: unknown) => value is SuppressedHostOutput | calls: (value: unknown) => value is SuppressedHostOutput"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isItemScalarMissingValue",
+          "signature": "(value: unknown) => value is typeof ITEM_SCALAR_MISSING_VALUE | calls: (value: unknown) => value is typeof ITEM_SCALAR_MISSING_VALUE"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "isLegacyMergeReceiptSummary",
+          "signature": "(value: Record<string, unknown>, historyItemId: string) => boolean | calls: (value: Record<string, unknown>, historyItemId: string) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8427,6 +8684,18 @@
           "name": "isPmToolAction",
           "signature": "(value: string) => value is PmToolAction | calls: (value: string) => value is PmToolAction"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "isPreDurableCloneLocalReceiptSummary",
+          "signature": "(value: Record<string, unknown>, historyItemId: string) => boolean | calls: (value: Record<string, unknown>, historyItemId: string) => boolean"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "isPreDurableDispositionEligibleReference",
+          "signature": "(reference: Omit<HistoryMergeReceiptReference, \"itemId\" | \"line\">) => boolean | calls: (reference: Omit<HistoryMergeReceiptReference, \"itemId\" | \"line\">) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8511,6 +8780,12 @@
           "name": "ITEM_REOPEN_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "ITEM_SCALAR_MISSING_VALUE",
+          "signature": "Readonly<{ readonly pm_item_scalar_missing: true; }>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -8545,7 +8820,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[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; requested_preference_applied: boolean; conflict_resolution: ItemScalarConflictResolution; }"
         },
         {
           "classification": "advanced_export",
@@ -8581,7 +8856,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemMergeConflictDecision",
-          "signature": "export interface ItemMergeConflictDecision { field: string; base: unknown; ours: unknown; theirs: unknown; retained: unknown; discarded: unknown; }"
+          "signature": "export interface ItemMergeConflictDecision { field: string; base: unknown; ours: unknown; theirs: unknown; retained: unknown; discarded: unknown; retained_side?: MergePreferredSide; resolution_basis?: ItemScalarResolutionBasis; }"
         },
         {
           "classification": "supported",
@@ -8619,6 +8894,18 @@
           "name": "ItemMetadataIndexQueryResult",
           "signature": "export interface ItemMetadataIndexQueryResult { source_cursor: string; total: number; items: ItemMetadata[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "ItemScalarConflictResolution",
+          "signature": "export type ItemScalarConflictResolution = \"preferred_side\" | \"stable_value_order\" | \"latest_document_update\";"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "ItemScalarResolutionBasis",
+          "signature": "export type ItemScalarResolutionBasis = \"requested_preference\" | \"document_updated_at\" | \"stable_value_tiebreak\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -9319,13 +9606,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; evidence_source?: \"clone_local\" | \"durable\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; requested_preference_applied?: boolean; preferred?: MergePreferredSide; conflict_resolution: ItemScalarConflictResolution; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\" | \"bounded_inline\" | \"mixed\"; value_policy?: typeof DURABLE_VALUE_POLICY; evidence_source?: \"clone_local\" | \"durable\"; }"
         },
         {
           "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[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; requested_preference_applied: boolean; conflict_resolution: ItemScalarConflictResolution; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -9349,7 +9636,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"latest_document_update\"; requested_preference_applied: false; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -9397,7 +9684,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "mergeItemDocuments",
-          "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"
+          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: ItemScalarConflictResolution; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: ItemScalarConflictResolution; }) => ItemDocumentMergeResult"
         },
         {
           "classification": "supported",
@@ -9433,7 +9720,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptInvalidEvidence",
-          "signature": "export interface MergeReceiptInvalidEvidence { evidence_source: \"clone_local\" | \"durable\" | \"clone_local_and_durable\"; reason: \"directory_unreadable\" | \"candidate_not_bounded_regular_file\" | \"candidate_unreadable\" | \"candidate_invalid_json\" | \"schema_or_identity_invalid\" | \"copy_provenance_mismatch\"; receipt_id?: string; candidate_name_hash?: string; }"
+          "signature": "export interface MergeReceiptInvalidEvidence { evidence_source: \"clone_local\" | \"durable\" | \"clone_local_and_durable\"; reason: \"directory_unreadable\" | \"candidate_not_bounded_regular_file\" | \"candidate_unreadable\" | \"candidate_invalid_json\" | \"schema_or_identity_invalid\" | \"schema_invalid\" | \"identity_invalid\" | \"copy_provenance_mismatch\"; validation_error?: \"required_fields\" | \"receipt_id\" | \"item_id\" | \"item_path\" | \"filename\" | \"collections\" | \"enums\" | \"timestamps\" | \"durable_decisions\"; receipt_id?: string; candidate_name_hash?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -9457,7 +9744,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReconcileResult",
-          "signature": "export interface MergeReconcileResult { ok: boolean; dry_run: boolean; repair: HistoryRepairAllResult; receipts: { pending_before: number; reconciled: number; summaries: MergeDecisionReceiptSummary[]; }; validation: ValidateResult; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeReconcileResult { ok: boolean; dry_run: boolean; repair: HistoryRepairAllResult; receipts: { pending_before: number; reconciled: number; summaries: MergeDecisionReceiptSummary[]; missing_history_references_before: number; legacy_disposition_eligible: number; legacy_disposition_recorded: number; missing_history_references_after: number; }; validation: ValidateResult; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -9483,6 +9770,12 @@
           "name": "migrateItemFilesToFormat",
           "signature": "(pmRoot: string, targetFormat: ItemFormat, op?: string, typeToFolder?: Record<string, string>, schema?: RuntimeSchemaSettings) => Promise<ItemFormatMigrationResult> | calls: (pmRoot: string, targetFormat: ItemFormat, op?: string, typeToFolder?: Record<string, string>, schema?: RuntimeSchemaSettings) => Promise<ItemFormatMigrationResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "MissingHistoryMergeReceiptReference",
+          "signature": "export interface MissingHistoryMergeReceiptReference { item_id: string; history_line: number; receipt_id?: string; receipt_reference_hash?: string; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -9837,6 +10130,60 @@
           "name": "NpmInstallSource",
           "signature": "export interface NpmInstallSource { kind: \"npm\"; input: string; spec: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationCalibration",
+          "signature": "export interface ObservationCalibration { basis: \"emitted_bytes\"; samples: readonly number[]; expected_emitted_bytes: number; tolerance_bytes: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationContract",
+          "signature": "export interface ObservationContract { schema: typeof PM_OBSERVATION_SCHEMA; id: string; version: number; reads: readonly ObservationReadDeclaration[]; calibration: ObservationCalibration; corpus_dependence: ObservationCorpusDependence; tiers: readonly ObservationTier[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ObservationCorpusDependence",
+          "signature": "export type ObservationCorpusDependence = { readonly kind: \"independent\"; } | { readonly kind: \"bounded\"; readonly dimension: string; readonly maximum: number; };"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationCostDescription",
+          "signature": "export interface ObservationCostDescription { contract_id: string; contract_version: number; guaranteed_ceiling_tokens: number; expected_emitted_bytes: number; expected_tokens: number; tolerance_bytes: number; calibration_basis: \"emitted_bytes\"; corpus_dependence: ObservationCorpusDependence; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationReadDeclaration",
+          "signature": "export interface ObservationReadDeclaration { command: string; budget_tokens: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationReceipt",
+          "signature": "export interface ObservationReceipt { contract_id: string; contract_version: number; served_tier: string | null; degraded: boolean; attempted_tiers: readonly string[]; emitted_bytes: number | null; estimated_tokens: number | null; calibration_basis: \"emitted_bytes\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationRequest",
+          "signature": "export interface ObservationRequest { budget_tokens: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ObservationResult",
+          "signature": "export type ObservationResult<T> = ServedObservation<T> | RefusedObservation;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ObservationTier",
+          "signature": "export interface ObservationTier { id: string; max_tokens: number; fields: readonly string[]; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -9885,6 +10232,12 @@
           "name": "openMcpRequestState",
           "signature": "(value: string, secret: string | Uint8Array, expected: { method: string; parameterDigest: string; principal: string; nowMs?: number; }) => PmMcpRequestStatePayload | calls: (value: string, secret: string | Uint8Array, expected: { method: string; parameterDigest: string; principal: string; nowMs?: number; }) => PmMcpRequestStatePayload"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "openPmEpisode",
+          "signature": "<TAction, TOutput = unknown>(specification: EpisodeSpecification, adapter: EpisodeRuntimeAdapter<TAction, TOutput>) => Promise<PmEpisodeSession<TAction, TOutput>> | calls: <TAction, TOutput = unknown>(specification: EpisodeSpecification, adapter: EpisodeRuntimeAdapter<TAction, TOutput>) => Promise<PmEpisodeSession<TAction, TOutput>>"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -10809,6 +11162,12 @@
           "name": "PM_DISCOVERABLE_TOOL_ACTIONS",
           "signature": "readonly PmToolAction[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_EPISODE_SCHEMA",
+          "signature": "\"pm.agent-episode/v1\""
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -11073,6 +11432,12 @@
           "name": "PM_MUTATION_ACTION_CONTRACTS",
           "signature": "readonly [{ readonly action: \"append\"; readonly history_scope: \"item\"; }, { readonly action: \"claim\"; readonly history_scope: \"item\"; }, { readonly action: \"close\"; readonly history_scope: \"item\"; }, { readonly action: \"close-many\"; readonly history_scope: \"item\"; }, { readonly action: \"close-task\"; readonly history_scope: \"item\"; }, { readonly action: \"comments\"; readonly history_scope: \"conditional\"; }, { readonly action: \"config\"; readonly history_scope: \"conditional\"; }, { readonly action: \"copy\"; readonly history_scope: \"item\"; }, { readonly action: \"create\"; readonly history_scope: \"item\"; }, { readonly action: \"delete\"; readonly history_scope: \"item\"; }, { readonly action: \"deps\"; readonly history_scope: \"conditional\"; }, { readonly action: \"discover\"; readonly history_scope: \"item\"; }, { readonly action: \"docs\"; readonly history_scope: \"conditional\"; }, { readonly action: \"files\"; readonly history_scope: \"conditional\"; }, { readonly action: \"focus\"; readonly history_scope: \"conditional\"; }, { readonly action: \"gc\"; readonly history_scope: \"conditional\"; }, { readonly action: \"history-compact\"; readonly history_scope: \"history\"; }, { readonly action: \"history-author-acknowledge\"; readonly history_scope: \"workspace\"; }, { readonly action: \"history-redact\"; readonly history_scope: \"history\"; }, { readonly action: \"history-repair\"; readonly history_scope: \"history\"; }, { readonly action: \"init\"; readonly history_scope: \"workspace\"; }, { readonly action: \"install\"; readonly history_scope: \"conditional\"; }, { readonly action: \"learnings\"; readonly history_scope: \"conditional\"; }, { readonly action: \"notes\"; readonly history_scope: \"conditional\"; }, { readonly action: \"package\"; readonly history_scope: \"conditional\"; }, { readonly action: \"pause-task\"; readonly history_scope: \"item\"; }, { readonly action: \"plan\"; readonly history_scope: \"conditional\"; }, { readonly action: \"profile\"; readonly history_scope: \"conditional\"; }, { readonly action: \"release\"; readonly history_scope: \"item\"; }, { readonly action: \"restore\"; readonly history_scope: \"item\"; }, { readonly action: \"schema\"; readonly history_scope: \"conditional\"; }, { readonly action: \"start-task\"; readonly history_scope: \"item\"; }, { readonly action: \"templates\"; readonly history_scope: \"conditional\"; }, { readonly action: \"test\"; readonly history_scope: \"conditional\"; }, { readonly action: \"test-all\"; readonly history_scope: \"conditional\"; }, { readonly action: \"update\"; readonly history_scope: \"item\"; }, { readonly action: \"update-many\"; readonly history_scope: \"item\"; }, { readonly action: \"upgrade\"; readonly history_scope: \"conditional\"; }]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_OBSERVATION_SCHEMA",
+          "signature": "\"pm.agent-observation/v1\""
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -11271,6 +11636,12 @@
           "name": "PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES",
           "signature": "ReadonlySet<string>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_VERDICT_SCHEMA",
+          "signature": "\"pm.agent-verdict/v1\""
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -11733,6 +12104,12 @@
           "name": "PmDiagnosticOutputReceipt",
           "signature": "export interface PmDiagnosticOutputReceipt { diagnostic_class: PmDiagnosticOutputClass; format: \"json\" | \"text\"; budget: number; budget_source: \"default\" | \"explicit\"; original_estimated_tokens: number; estimated_tokens: number; truncated: boolean; degradation_steps: PmDiagnosticDegradationStep[]; omitted_fields: string[]; omitted_fields_overflow_count?: number; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmEpisodeSession",
+          "signature": "export interface PmEpisodeSession<TAction, TOutput> { observe(): Promise<ObservationResult<RecordedStateObject>>; step(action: TAction): Promise<EpisodeActionReceipt<TOutput>>; score(): Promise<VerdictResult>; close(): Promise<ClosedEpisode>; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -12693,6 +13070,12 @@
           "name": "positionalSignatureKey",
           "signature": "(slots: readonly PmCommandPositionalSlotContract[]) => string | calls: (slots: readonly PmCommandPositionalSlotContract[]) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PredicateVerdict",
+          "signature": "export interface PredicateVerdict { id: string; outcome: \"satisfied\" | \"violated\"; evidence_pointer: string; evidence_digest: string; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13105,7 +13488,7 @@
           "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; }"
+          "signature": "export interface ProjectRuntimeCompatibilityResult { compatible: boolean; executing_version: string; project_version?: string; source?: ProjectRuntimeVersionPin[\"source\"]; command?: string; mutating: boolean; stale?: boolean; history_epoch_incompatible?: boolean; writer_item_hash_version?: 2 | 3; incompatible_project_version?: string; incompatible_source?: ProjectRuntimeVersionPin[\"source\"]; warning?: ProjectRuntimeCompatibilityWarning; override_applied: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -13117,7 +13500,7 @@
           "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\"; }"
+          "signature": "export interface ProjectRuntimeVersionPin { version: string; source: \"package.json\" | \"installed-package\" | \"package-lock.json\" | \"pnpm-lock.yaml\" | \"yarn.lock\"; constraint: \"exact\" | \"minimum\" | \"range\"; declaration?: string; history_epoch_compatible?: boolean; }"
         },
         {
           "classification": "supported",
@@ -13497,6 +13880,12 @@
           "name": "readWorkspacePosition",
           "signature": "(global: GlobalOptions) => Promise<WorkspacePositionResult> | calls: (global: GlobalOptions) => Promise<WorkspacePositionResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "reanchorHistoryEntries",
+          "signature": "(entries: HistoryEntry[], itemHashVersion?: 1 | 2 | 3, options?: ReanchorHistoryOptions) => ReanchorResult | calls: (entries: HistoryEntry[], itemHashVersion?: 1 | 2 | 3, options?: ReanchorHistoryOptions) => ReanchorResult"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -13557,6 +13946,12 @@
           "name": "recordContextUsageTouches",
           "signature": "(options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "RecordedStateObject",
+          "signature": "export type RecordedStateObject = Readonly<Record<string, unknown>>;"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13617,6 +14012,12 @@
           "name": "refreshSearchArtifactsForMutation",
           "signature": "(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult> | calls: (pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "RefusedObservation",
+          "signature": "export interface RefusedObservation { status: \"refused\"; reason: \"no_declared_tier_fits_budget\"; receipt: ObservationReceipt; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -14613,6 +15014,12 @@
           "name": "requireTerminalReasonWithRecovery",
           "signature": "(input: TerminalReasonInput, required: boolean, recovery: TerminalReasonRecoveryContext) => TerminalReasonResolution | calls: (input: TerminalReasonInput, required: boolean, recovery: TerminalReasonRecoveryContext) => TerminalReasonResolution"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resealHistoryRewrite",
+          "signature": "(original: HistoryEntry, rewritten: HistoryEntry, options?: Readonly<{ retainOriginalPatch?: boolean; retainPriorRecord?: boolean; retainPriorRecordHash?: boolean; }>) => HistoryEntry | calls: (original: HistoryEntry, rewritten: HistoryEntry, options?: Readonly<{ retainOriginalPatch?: boolean; retainPriorRecord?: boolean; retainPriorRecordHash?: boolean; }>) => HistoryEntry"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -16695,6 +17102,12 @@
           "name": "SdkCliParameterDisposition",
           "signature": "export type SdkCliParameterDisposition = \"shared\" | \"compatibility_alias\" | \"cli_transport\" | \"cli_presentation\" | \"cli_adapter\" | \"cli_scope_selector\" | \"sdk_transport\" | \"cli_positional\" | \"sdk_native\" | \"unclassified\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "sealHistoryRecord",
+          "signature": "(entry: HistoryEntry) => HistoryEntry | calls: (entry: HistoryEntry) => HistoryEntry"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16953,6 +17366,18 @@
           "name": "serializeNdjsonStream",
           "signature": "(rows: readonly unknown[], trailer: PmNdjsonStreamTrailerInput) => string | calls: (rows: readonly unknown[], trailer: PmNdjsonStreamTrailerInput) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "serveDeclaredObservation",
+          "signature": "<T>(contract: ObservationContract, collect: (tier: ObservationTier) => Promise<T>, request: ObservationRequest) => Promise<ObservationResult<T>> | calls: <T>(contract: ObservationContract, collect: (tier: ObservationTier) => Promise<T>, request: ObservationRequest) => Promise<ObservationResult<T>>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ServedObservation",
+          "signature": "export interface ServedObservation<T> { status: \"served\"; payload: T; receipt: ObservationReceipt; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -17457,6 +17882,12 @@
           "name": "SUPPORTED_HISTORY_ITEM_HASH_VERSIONS",
           "signature": "readonly [1, 2, 3]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SUPPORTED_HISTORY_RECORD_HASH_VERSIONS",
+          "signature": "readonly [1]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -18399,6 +18830,30 @@
           "name": "VectorStoreUpsertPoint",
           "signature": "export interface VectorStoreUpsertPoint { id: string; vector: number[]; payload?: Record<string, unknown>; [key: string]: unknown; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "VerdictComposition",
+          "signature": "export interface VerdictComposition { operator: \"all\" | \"any\"; predicate_ids: readonly string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "VerdictContract",
+          "signature": "export interface VerdictContract { schema: typeof PM_VERDICT_SCHEMA; id: string; version: number; predicates: readonly VerdictPredicate[]; composition: VerdictComposition; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "VerdictPredicate",
+          "signature": "export type VerdictPredicate = { readonly id: string; readonly kind: \"field_equals\"; readonly path: string; readonly expected: unknown; } | { readonly id: string; readonly kind: \"field_present\"; readonly path: string; } | { readonly id: string; readonly kind: \"field_absent\"; readonly path: string; };"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "VerdictResult",
+          "signature": "export interface VerdictResult { contract_id: string; contract_version: number; snapshot_id: string; outcome: \"satisfied\" | \"violated\" | \"not_applicable\"; score: number | null; policy: \"verdict_only_no_reward\"; reason?: \"no_predicates_declared\"; predicates: readonly PredicateVerdict[]; }"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -18429,6 +18884,18 @@
           "name": "verifyHistoryEntries",
           "signature": "(history: HistoryEntry[], currentDocument?: ItemDocument) => HistoryVerificationResult | calls: (history: HistoryEntry[], currentDocument?: ItemDocument) => HistoryVerificationResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyHistoryRecordHash",
+          "signature": "(entry: HistoryEntry) => { ok: true; coverage: \"item_state_only\" | \"record_and_item_state\"; } | { ok: false; error: \"incomplete_record_hash_envelope\" | \"record_hash_mismatch\" | \"unsupported_record_hash_version\"; } | calls: (entry: HistoryEntry) => { ok: true; coverage: \"record_and_item_state\" | \"item_state_only\"; } | { ok: false; error: \"incomplete_record_hash_envelope\" | \"record_hash_mismatch\" | \"unsupported_record_hash_version\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyHistoryRewriteEvidence",
+          "signature": "(entry: HistoryEntry) => { ok: true; coverage: \"complete\" | \"digest_only\" | \"legacy_anchor_only\" | \"none\"; } | { ok: false; error: \"rewrite_evidence_invalid\" | \"rewrite_evidence_patch_hash_mismatch\" | \"rewrite_evidence_record_hash_mismatch\"; } | calls: (entry: HistoryEntry) => { ok: true; coverage: \"complete\" | \"digest_only\" | \"legacy_anchor_only\" | \"none\"; } | { ok: false; error: \"rewrite_evidence_invalid\" | \"rewrite_evidence_patch_hash_mismatch\" | \"rewrite_evidence_record_hash_mismatch\"; }"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -18705,6 +19172,12 @@
           "name": "WorkspaceRecipeOperation",
           "signature": "export interface WorkspaceRecipeOperation { action: string; input: Readonly<Record<string, WorkspaceRecipeJsonValue>>; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "WorkspaceRecordedState",
+          "signature": "export interface WorkspaceRecordedState { snapshot_id: string; state: RecordedStateObject; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -22651,7 +23124,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "AgentProvenanceAbsenceReason",
-          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
+          "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_input_missing\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
         {
           "classification": "supported",
@@ -23167,7 +23640,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HarnessDetectionSignals",
-          "signature": "export interface HarnessDetectionSignals { env?: Readonly<Record<string, string | undefined>>; argv?: readonly string[]; process_labels?: readonly string[]; client_info?: AgentClientInfo; provenance?: Readonly<Record<string, string | undefined>>; session_context?: AgentSessionContext; descriptors?: readonly HarnessSignalDescriptor[]; probes_enabled?: boolean; cwd?: string; home_dir?: string; }"
+          "signature": "export interface HarnessDetectionSignals { env?: Readonly<Record<string, string | undefined>>; argv?: readonly string[]; process_labels?: readonly string[]; client_info?: AgentClientInfo; provenance?: Readonly<Record<string, string | undefined>>; session_context?: AgentSessionContext; descriptors?: readonly HarnessSignalDescriptor[]; probes_enabled?: boolean; cwd?: string; home_dir?: string; session_file?: string; }"
         },
         {
           "classification": "supported",
@@ -26715,12 +27188,24 @@
           "name": "buildMergeAttributePatterns",
           "signature": "(trackerRelativeRoot: string, typeFolders: string[]) => string[] | calls: (trackerRelativeRoot: string, typeFolders: string[]) => string[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "encodeItemScalarDecisionValue",
+          "signature": "(value: unknown) => unknown | calls: (value: unknown) => unknown"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "findGitWorkspaceRoot",
           "signature": "(cwd: string) => Promise<string | null> | calls: (cwd: string) => Promise<string | null>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "hashItemScalarDecisionValue",
+          "signature": "(value: unknown) => string | calls: (value: unknown) => string"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -26745,12 +27230,24 @@
           "name": "installMergeFence",
           "signature": "(options: { pmRoot: string; workspaceRoot: string; dryRun?: boolean; }) => Promise<MergeInstallResult> | calls: (options: { pmRoot: string; workspaceRoot: string; dryRun?: boolean; }) => Promise<MergeInstallResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isItemScalarMissingValue",
+          "signature": "(value: unknown) => value is typeof ITEM_SCALAR_MISSING_VALUE | calls: (value: unknown) => value is typeof ITEM_SCALAR_MISSING_VALUE"
+        },
         {
           "classification": "supported",
           "kind": "value",
           "name": "ITEM_LATEST_TIMESTAMP_FIELDS",
           "signature": "readonly [\"updated_at\"]"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "ITEM_SCALAR_MISSING_VALUE",
+          "signature": "Readonly<{ readonly pm_item_scalar_missing: true; }>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -26761,13 +27258,25 @@
           "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[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; requested_preference_applied: boolean; conflict_resolution: ItemScalarConflictResolution; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ItemMergeConflictDecision",
-          "signature": "export interface ItemMergeConflictDecision { field: string; base: unknown; ours: unknown; theirs: unknown; retained: unknown; discarded: unknown; }"
+          "signature": "export interface ItemMergeConflictDecision { field: string; base: unknown; ours: unknown; theirs: unknown; retained: unknown; discarded: unknown; retained_side?: MergePreferredSide; resolution_basis?: ItemScalarResolutionBasis; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "ItemScalarConflictResolution",
+          "signature": "export type ItemScalarConflictResolution = \"preferred_side\" | \"stable_value_order\" | \"latest_document_update\";"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "ItemScalarResolutionBasis",
+          "signature": "export type ItemScalarResolutionBasis = \"requested_preference\" | \"document_updated_at\" | \"stable_value_tiebreak\";"
         },
         {
           "classification": "supported",
@@ -26797,13 +27306,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; evidence_source?: \"clone_local\" | \"durable\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; requested_preference_applied?: boolean; preferred?: MergePreferredSide; conflict_resolution: ItemScalarConflictResolution; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\" | \"bounded_inline\" | \"mixed\"; value_policy?: typeof DURABLE_VALUE_POLICY; evidence_source?: \"clone_local\" | \"durable\"; }"
         },
         {
           "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[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; requested_preference_applied: boolean; conflict_resolution: ItemScalarConflictResolution; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -26827,7 +27336,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"latest_document_update\"; requested_preference_applied: false; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -26869,7 +27378,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "mergeItemDocuments",
-          "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"
+          "signature": "(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: ItemScalarConflictResolution; }) => ItemDocumentMergeResult | calls: (baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & { preferred?: MergePreferredSide; conflictResolution?: ItemScalarConflictResolution; }) => ItemDocumentMergeResult"
         },
         {
           "classification": "supported",
@@ -26899,7 +27408,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptInvalidEvidence",
-          "signature": "export interface MergeReceiptInvalidEvidence { evidence_source: \"clone_local\" | \"durable\" | \"clone_local_and_durable\"; reason: \"directory_unreadable\" | \"candidate_not_bounded_regular_file\" | \"candidate_unreadable\" | \"candidate_invalid_json\" | \"schema_or_identity_invalid\" | \"copy_provenance_mismatch\"; receipt_id?: string; candidate_name_hash?: string; }"
+          "signature": "export interface MergeReceiptInvalidEvidence { evidence_source: \"clone_local\" | \"durable\" | \"clone_local_and_durable\"; reason: \"directory_unreadable\" | \"candidate_not_bounded_regular_file\" | \"candidate_unreadable\" | \"candidate_invalid_json\" | \"schema_or_identity_invalid\" | \"schema_invalid\" | \"identity_invalid\" | \"copy_provenance_mismatch\"; validation_error?: \"required_fields\" | \"receipt_id\" | \"item_id\" | \"item_path\" | \"filename\" | \"collections\" | \"enums\" | \"timestamps\" | \"durable_decisions\"; receipt_id?: string; candidate_name_hash?: string; }"
         },
         {
           "classification": "supported",
@@ -26917,7 +27426,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReconcileResult",
-          "signature": "export interface MergeReconcileResult { ok: boolean; dry_run: boolean; repair: HistoryRepairAllResult; receipts: { pending_before: number; reconciled: number; summaries: MergeDecisionReceiptSummary[]; }; validation: ValidateResult; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeReconcileResult { ok: boolean; dry_run: boolean; repair: HistoryRepairAllResult; receipts: { pending_before: number; reconciled: number; summaries: MergeDecisionReceiptSummary[]; missing_history_references_before: number; legacy_disposition_eligible: number; legacy_disposition_recorded: number; missing_history_references_after: number; }; validation: ValidateResult; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -32380,6 +32889,7 @@
     "profile_name_not_normalized",
     "profile_summary_empty",
     "profile_title_empty",
+    "project_runtime_history_epoch_incompatible",
     "project_runtime_stale_mutation",
     "project_runtime_stale_read",
     "projection_options_mutually_exclusive",