@unbrained/pm-cli 2026.9.2 → 2026.9.4

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1825,
+    "covered_symbols": 1844,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1826
+    "required_symbols": 1845
   },
   "breaking_acknowledgements": [
     {
@@ -1473,6 +1473,131 @@
       ],
       "package_version": "2026.9.1",
       "reason": "Expose loss-aware receipt evidence details as required runtime fields so SDK gates cannot silently discard invalid candidates."
+    },
+    {
+      "changes": [
+        "signature ./sdk:BuildItemContextRelevanceCandidatesOptions",
+        "signature ./sdk:CONTEXT_SIGNAL_SET_VERSION",
+        "signature ./sdk:CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
+        "signature ./sdk:ContextRankingSummary",
+        "signature ./sdk:ContextRelevanceCandidate",
+        "signature ./sdk:ContextSignalSnapshotItem",
+        "signature ./sdk:ContextUsageAffinity",
+        "signature ./sdk:ContextUsageEvent",
+        "signature ./sdk:ItemContextRelevanceCandidate",
+        "signature ./sdk:recordContextUsageServing",
+        "signature ./sdk/query:BuildItemContextRelevanceCandidatesOptions",
+        "signature ./sdk/query:CONTEXT_SIGNAL_SET_VERSION",
+        "signature ./sdk/query:CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
+        "signature ./sdk/query:ContextRankingSummary",
+        "signature ./sdk/query:ContextRelevanceCandidate",
+        "signature ./sdk/query:ContextSignalSnapshotItem",
+        "signature ./sdk/query:ContextUsageAffinity",
+        "signature ./sdk/query:ContextUsageEvent",
+        "signature ./sdk/query:ItemContextRelevanceCandidate",
+        "signature ./sdk/query:recordContextUsageServing"
+      ],
+      "package_version": "2026.9.1",
+      "reason": "Version context signal snapshots and usage affinity receipts so substantive recency and exact egress delivery are explicit public contracts."
+    },
+    {
+      "changes": [
+        "signature ./sdk:CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
+        "signature ./sdk:ContextSignalSnapshot",
+        "signature ./sdk:ContextUsageEvent",
+        "signature ./sdk:MAINTENANCE_HISTORY_OPERATIONS",
+        "signature ./sdk/query:CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
+        "signature ./sdk/query:ContextSignalSnapshot",
+        "signature ./sdk/query:ContextUsageEvent",
+        "signature ./sdk/runtime:MAINTENANCE_HISTORY_OPERATIONS"
+      ],
+      "package_version": "2026.9.1",
+      "reason": "Tighten context signal freshness and final-egress feedback contracts before release"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ContextSignalSnapshotItem",
+        "signature ./sdk/query:ContextSignalSnapshotItem"
+      ],
+      "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": {
@@ -1825,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",
@@ -2871,6 +2996,12 @@
           "name": "attachContextIntentReceipt",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; } | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "attachContextUsageServingReceipt",
+          "signature": "(result: unknown, receipt: ContextUsageServingReceipt | null) => void | calls: (result: unknown, receipt: ContextUsageServingReceipt | null) => void"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -3163,7 +3294,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "BuildItemContextRelevanceCandidatesOptions",
-          "signature": "export interface BuildItemContextRelevanceCandidatesOptions { statusRegistry: RuntimeStatusRegistry; now: string; author?: string; usageAffinity?: Readonly<Record<string, number>>; semanticSimilarity?: Readonly<Record<string, number>>; activityDensity?: Readonly<Record<string, number>>; graphProximity?: Readonly<Record<string, number>>; claimFocus?: Readonly<Record<string, number>>; knowledgeDensity?: Readonly<Record<string, number>>; authorAffinity?: Readonly<Record<string, number>>; }"
+          "signature": "export interface BuildItemContextRelevanceCandidatesOptions { statusRegistry: RuntimeStatusRegistry; now: string; author?: string; usageAffinity?: Readonly<Record<string, number>>; semanticSimilarity?: Readonly<Record<string, number>>; activityDensity?: Readonly<Record<string, number>>; graphProximity?: Readonly<Record<string, number>>; claimFocus?: Readonly<Record<string, number>>; knowledgeDensity?: Readonly<Record<string, number>>; authorAffinity?: Readonly<Record<string, number>>; recencyEvidence?: Readonly<Record<string, ContextRecencyEvidence>>; }"
         },
         {
           "classification": "advanced_export",
@@ -3459,6 +3590,12 @@
           "name": "canonicalizeCommandOptionKey",
           "signature": "(command: CommandOptionPolicyCommand, rawOption: string) => string | undefined | calls: (command: CommandOptionPolicyCommand, rawOption: string) => string | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "canonicalizeContextRecencyCoordinate",
+          "signature": "(value: unknown) => string | null | calls: (value: unknown) => string | null"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3537,6 +3674,18 @@
           "name": "classifyHistoryAuthorEvent",
           "signature": "(parsed: unknown) => \"actionable_unknown\" | \"attributed\" | \"legacy_unknown\" | calls: (parsed: unknown) => \"attributed\" | \"legacy_unknown\" | \"actionable_unknown\""
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "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",
@@ -3663,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",
@@ -3723,6 +3878,12 @@
           "name": "collectBlockedByIdsFromCorpus",
           "signature": "(item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[] | calls: (item: ItemMetadata, corpus: readonly ItemMetadata[]) => string[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectContextUsageDeliveredItemIds",
+          "signature": "(result: unknown, surface: ContextRelevanceSurface) => string[] | calls: (result: unknown, surface: ContextRelevanceSurface) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -4191,6 +4352,12 @@
           "name": "CONTEXT_PACKING_PROFILES",
           "signature": "{ readonly balanced: { readonly redundancyPenalty: 0.35; readonly uncertaintyPenalty: 0.2; }; readonly context: { readonly redundancyPenalty: 0.45; readonly uncertaintyPenalty: 0.15; }; readonly next: { readonly redundancyPenalty: 0.25; readonly uncertaintyPenalty: 0.3; }; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "CONTEXT_RECENCY_EPOCH",
+          "signature": "\"1970-01-01T00:00:00.000Z\""
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -4207,13 +4374,13 @@
           "classification": "supported",
           "kind": "value",
           "name": "CONTEXT_SIGNAL_SET_VERSION",
-          "signature": "1"
+          "signature": "2"
         },
         {
           "classification": "supported",
           "kind": "value",
           "name": "CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
-          "signature": "1"
+          "signature": "3"
         },
         {
           "classification": "supported",
@@ -4369,13 +4536,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextRankingSummary",
-          "signature": "export interface ContextRankingSummary { model: string; available_signals: ContextRelevanceSignalName[]; items: Array<{ id: string; rank: number; baseline_rank: number; score: number; contributions: ContextRelevanceContributions; }>; candidate_count: number; omitted_count: number; feature_store?: { source: \"derived_index\" | \"scan_fallback\"; cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; generated_at: string; }; }"
+          "signature": "export interface ContextRankingSummary { model: string; available_signals: ContextRelevanceSignalName[]; items: Array<{ id: string; rank: number; baseline_rank: number; score: number; contributions: ContextRelevanceContributions; recency?: ContextRecencyEvidence; }>; candidate_count: number; omitted_count: number; feature_store?: { source: \"derived_index\" | \"scan_fallback\"; cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; generated_at: string; }; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextRecencyEvidence",
+          "signature": "export interface ContextRecencyEvidence { source: \"substantive_history\" | \"release_cohort\" | \"created_at\"; coordinate: string; history_op?: string; event_class?: HistoryEventClass; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextRelevanceCandidate",
-          "signature": "export interface ContextRelevanceCandidate<TItem> { id: string; item: TItem; signals?: ContextRelevanceSignals; }"
+          "signature": "export interface ContextRelevanceCandidate<TItem> { id: string; item: TItem; signals?: ContextRelevanceSignals; signal_provenance?: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -4431,17 +4604,23 @@
           "name": "ContextResult",
           "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextSignalProvenance",
+          "signature": "export interface ContextSignalProvenance { recency: ContextRecencyEvidence; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalSnapshot",
-          "signature": "export interface ContextSignalSnapshot { format_version: number; signal_set_version: number; source_cursor: string; generated_at: string; source: ContextSignalSnapshotSource; items: readonly ContextSignalSnapshotItem[]; }"
+          "signature": "export interface ContextSignalSnapshot { format_version: number; signal_set_version: number; source_cursor: string; recency_evidence_fingerprint: string; generated_at: string; source: ContextSignalSnapshotSource; items: readonly ContextSignalSnapshotItem[]; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalSnapshotItem",
-          "signature": "export interface ContextSignalSnapshotItem { id: string; signals: ContextRelevanceSignals; }"
+          "signature": "export interface ContextSignalSnapshotItem { id: string; signals: ContextRelevanceSignals; signal_provenance: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -4477,13 +4656,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextUsageAffinity",
-          "signature": "export interface ContextUsageAffinity { affinity: Record<string, number>; positive_judgments: number; serving_events: number; }"
+          "signature": "export interface ContextUsageAffinity { affinity: Record<string, number>; positive_judgments: number; serving_events: number; untrusted_serving_events: number; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "ContextUsageEvent",
-          "signature": "export type ContextUsageEvent = { kind: \"serve\"; at: string; author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; } | { kind: \"touch\"; at: string; author: string; item_id: string; intent: string; };"
+          "signature": "export type ContextUsageEvent = { kind: \"serve\"; schema_version?: 2; serve_id?: string; at: string; author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; result_omitted?: boolean; packed_item_ids?: string[]; delivered_item_ids?: string[]; } | { kind: \"delivery\"; schema_version: 2; serve_id: string; at: string; author: string; surface: ContextRelevanceSurface; result_omitted: boolean; delivered_item_ids: string[]; } | { kind: \"touch\"; at: string; author: string; item_id: string; intent: string; };"
         },
         {
           "classification": "supported",
@@ -4491,6 +4670,12 @@
           "name": "ContextUsageLedgerOptions",
           "signature": "export interface ContextUsageLedgerOptions { pmRoot: string; enabled?: boolean; maxEvents?: number; retentionDays?: number; now?: string; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextUsageServingReceipt",
+          "signature": "export interface ContextUsageServingReceipt { serve_id: string; author: string; surface: ContextRelevanceSurface; rows: readonly ContextUsageServingRow[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -4845,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",
@@ -5127,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",
@@ -5181,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",
@@ -5259,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",
@@ -5451,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",
@@ -5631,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",
@@ -5679,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",
@@ -5763,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",
@@ -5883,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",
@@ -6681,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",
@@ -6783,6 +7064,12 @@
           "name": "FilesResult",
           "signature": "export interface FilesResult { id: string; files: LinkedFile[]; changed: boolean; count: number; migrations_applied?: number; validation?: LinkedPathValidation; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "finalizeContextUsageDelivery",
+          "signature": "(options: { pmRoot: string; result: unknown; }) => Promise<boolean> | calls: (options: { pmRoot: string; result: unknown; }) => Promise<boolean>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7495,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",
@@ -7521,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",
@@ -7677,12 +7988,24 @@
           "name": "HISTORY_COMPACT_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "HISTORY_EVENT_CLASSIFICATION_VERSION",
+          "signature": "1"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
           "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",
@@ -7791,12 +8114,42 @@
           "name": "historyEntryMatchesProvenance",
           "signature": "(entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean | calls: (entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "HistoryEventClass",
+          "signature": "export type HistoryEventClass = \"substantive\" | \"maintenance\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
           "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",
@@ -7827,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",
@@ -8235,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",
@@ -8313,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",
@@ -8397,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",
@@ -8419,7 +8808,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemContextRelevanceCandidate",
-          "signature": "export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> { signals: ContextRelevanceSignals; }"
+          "signature": "export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> { signals: ContextRelevanceSignals; signal_provenance: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -8431,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",
@@ -8467,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",
@@ -8505,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",
@@ -9117,6 +9518,12 @@
           "name": "looksLikeGenericKeyValueEntry",
           "signature": "(raw: string) => boolean | calls: (raw: string) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "MAINTENANCE_HISTORY_OPERATIONS",
+          "signature": "readonly [\"docs_add\", \"files_add\", \"history:author-acknowledge\", \"history_author_acknowledge\", \"history_compact\", \"history_compact_baseline\", \"history_redact\", \"history_repair\", \"normalize\", \"release\", \"test_run_track\", \"tests_add\", \"tests_remove\", \"update_audit\", \"update_ownership_bypass\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9199,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",
@@ -9229,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",
@@ -9277,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",
@@ -9313,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",
@@ -9337,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",
@@ -9363,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",
@@ -9717,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",
@@ -9765,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",
@@ -10689,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",
@@ -10953,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",
@@ -11151,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",
@@ -11613,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",
@@ -12573,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",
@@ -12985,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",
@@ -12997,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",
@@ -13011,6 +13514,12 @@
           "name": "promoteAssuranceAssertion",
           "signature": "(pmRoot: string, definition: AssuranceAssertionDefinition, enforcement: Exclude<AssuranceEnforcement, \"observe\">, options?: { author?: string; message?: string; }) => Promise<Awaited<ReturnType<typeof putAssuranceDeclaration>>> | calls: (pmRoot: string, definition: AssuranceAssertionDefinition, enforcement: Exclude<AssuranceEnforcement, \"observe\">, options?: { author?: string; message?: string; }) => Promise<Awaited<ReturnType<typeof putAssuranceDeclaration>>>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "propagateContextUsageServingReceipt",
+          "signature": "(source: unknown, target: unknown) => void | calls: (source: unknown, target: unknown) => void"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -13371,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",
@@ -13407,11 +13922,17 @@
           "name": "recordClaimSemanticAttribution",
           "signature": "(params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void> | calls: (params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordContextUsageDelivery",
+          "signature": "(options: ContextUsageLedgerOptions & { receipt: ContextUsageServingReceipt | null; deliveredItemIds: readonly string[]; resultOmitted: boolean; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { receipt: ContextUsageServingReceipt | null; deliveredItemIds: readonly string[]; resultOmitted: boolean; }) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "recordContextUsageServing",
-          "signature": "(options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<void>"
+          "signature": "(options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<ContextUsageServingReceipt | null> | calls: (options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<ContextUsageServingReceipt | null>"
         },
         {
           "classification": "supported",
@@ -13425,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",
@@ -13485,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",
@@ -14481,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",
@@ -16563,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",
@@ -16821,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",
@@ -17265,6 +17822,12 @@
           "name": "SubscribeMutationEventsOptions",
           "signature": "export interface SubscribeMutationEventsOptions extends ListMutationEventsOptions { intervalMs?: number; signal?: AbortSignal; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SUBSTANTIVE_HISTORY_OPERATIONS",
+          "signature": "readonly [\"append\", \"cancel\", \"claim\", \"close\", \"comment_add\", \"create\", \"learning_add\", \"note_add\", \"reopen\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -17319,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",
@@ -18261,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",
@@ -18291,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",
@@ -18567,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",
@@ -22513,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",
@@ -23029,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",
@@ -26577,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",
@@ -26607,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",
@@ -26623,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",
@@ -26659,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",
@@ -26689,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",
@@ -26731,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",
@@ -26761,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",
@@ -26779,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",
@@ -26973,6 +27620,12 @@
           "name": "assertCompleteListResult",
           "signature": "(candidate: unknown) => asserts candidate is ListFullResult | calls: (candidate: unknown) => asserts candidate is ListFullResult"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "attachContextUsageServingReceipt",
+          "signature": "(result: unknown, receipt: ContextUsageServingReceipt | null) => void | calls: (result: unknown, receipt: ContextUsageServingReceipt | null) => void"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -27037,7 +27690,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "BuildItemContextRelevanceCandidatesOptions",
-          "signature": "export interface BuildItemContextRelevanceCandidatesOptions { statusRegistry: RuntimeStatusRegistry; now: string; author?: string; usageAffinity?: Readonly<Record<string, number>>; semanticSimilarity?: Readonly<Record<string, number>>; activityDensity?: Readonly<Record<string, number>>; graphProximity?: Readonly<Record<string, number>>; claimFocus?: Readonly<Record<string, number>>; knowledgeDensity?: Readonly<Record<string, number>>; authorAffinity?: Readonly<Record<string, number>>; }"
+          "signature": "export interface BuildItemContextRelevanceCandidatesOptions { statusRegistry: RuntimeStatusRegistry; now: string; author?: string; usageAffinity?: Readonly<Record<string, number>>; semanticSimilarity?: Readonly<Record<string, number>>; activityDensity?: Readonly<Record<string, number>>; graphProximity?: Readonly<Record<string, number>>; claimFocus?: Readonly<Record<string, number>>; knowledgeDensity?: Readonly<Record<string, number>>; authorAffinity?: Readonly<Record<string, number>>; recencyEvidence?: Readonly<Record<string, ContextRecencyEvidence>>; }"
         },
         {
           "classification": "supported",
@@ -27111,6 +27764,12 @@
           "name": "classifyImplicitSemanticFallbackReason",
           "signature": "(error: unknown) => ImplicitSemanticFallbackReason | calls: (error: unknown) => ImplicitSemanticFallbackReason"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "collectContextUsageDeliveredItemIds",
+          "signature": "(result: unknown, surface: ContextRelevanceSurface) => string[] | calls: (result: unknown, surface: ContextRelevanceSurface) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -27169,13 +27828,13 @@
           "classification": "supported",
           "kind": "value",
           "name": "CONTEXT_SIGNAL_SET_VERSION",
-          "signature": "1"
+          "signature": "2"
         },
         {
           "classification": "supported",
           "kind": "value",
           "name": "CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
-          "signature": "1"
+          "signature": "3"
         },
         {
           "classification": "supported",
@@ -27325,13 +27984,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextRankingSummary",
-          "signature": "export interface ContextRankingSummary { model: string; available_signals: ContextRelevanceSignalName[]; items: Array<{ id: string; rank: number; baseline_rank: number; score: number; contributions: ContextRelevanceContributions; }>; candidate_count: number; omitted_count: number; feature_store?: { source: \"derived_index\" | \"scan_fallback\"; cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; generated_at: string; }; }"
+          "signature": "export interface ContextRankingSummary { model: string; available_signals: ContextRelevanceSignalName[]; items: Array<{ id: string; rank: number; baseline_rank: number; score: number; contributions: ContextRelevanceContributions; recency?: ContextRecencyEvidence; }>; candidate_count: number; omitted_count: number; feature_store?: { source: \"derived_index\" | \"scan_fallback\"; cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; generated_at: string; }; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextRecencyEvidence",
+          "signature": "export interface ContextRecencyEvidence { source: \"substantive_history\" | \"release_cohort\" | \"created_at\"; coordinate: string; history_op?: string; event_class?: HistoryEventClass; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextRelevanceCandidate",
-          "signature": "export interface ContextRelevanceCandidate<TItem> { id: string; item: TItem; signals?: ContextRelevanceSignals; }"
+          "signature": "export interface ContextRelevanceCandidate<TItem> { id: string; item: TItem; signals?: ContextRelevanceSignals; signal_provenance?: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -27387,17 +28052,23 @@
           "name": "ContextResult",
           "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextSignalProvenance",
+          "signature": "export interface ContextSignalProvenance { recency: ContextRecencyEvidence; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalSnapshot",
-          "signature": "export interface ContextSignalSnapshot { format_version: number; signal_set_version: number; source_cursor: string; generated_at: string; source: ContextSignalSnapshotSource; items: readonly ContextSignalSnapshotItem[]; }"
+          "signature": "export interface ContextSignalSnapshot { format_version: number; signal_set_version: number; source_cursor: string; recency_evidence_fingerprint: string; generated_at: string; source: ContextSignalSnapshotSource; items: readonly ContextSignalSnapshotItem[]; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalSnapshotItem",
-          "signature": "export interface ContextSignalSnapshotItem { id: string; signals: ContextRelevanceSignals; }"
+          "signature": "export interface ContextSignalSnapshotItem { id: string; signals: ContextRelevanceSignals; signal_provenance: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -27433,13 +28104,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextUsageAffinity",
-          "signature": "export interface ContextUsageAffinity { affinity: Record<string, number>; positive_judgments: number; serving_events: number; }"
+          "signature": "export interface ContextUsageAffinity { affinity: Record<string, number>; positive_judgments: number; serving_events: number; untrusted_serving_events: number; }"
         },
         {
           "classification": "supported",
           "kind": "type",
           "name": "ContextUsageEvent",
-          "signature": "export type ContextUsageEvent = { kind: \"serve\"; at: string; author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; } | { kind: \"touch\"; at: string; author: string; item_id: string; intent: string; };"
+          "signature": "export type ContextUsageEvent = { kind: \"serve\"; schema_version?: 2; serve_id?: string; at: string; author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; result_omitted?: boolean; packed_item_ids?: string[]; delivered_item_ids?: string[]; } | { kind: \"delivery\"; schema_version: 2; serve_id: string; at: string; author: string; surface: ContextRelevanceSurface; result_omitted: boolean; delivered_item_ids: string[]; } | { kind: \"touch\"; at: string; author: string; item_id: string; intent: string; };"
         },
         {
           "classification": "supported",
@@ -27447,6 +28118,12 @@
           "name": "ContextUsageLedgerOptions",
           "signature": "export interface ContextUsageLedgerOptions { pmRoot: string; enabled?: boolean; maxEvents?: number; retentionDays?: number; now?: string; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextUsageServingReceipt",
+          "signature": "export interface ContextUsageServingReceipt { serve_id: string; author: string; surface: ContextRelevanceSurface; rows: readonly ContextUsageServingRow[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -27549,6 +28226,12 @@
           "name": "evaluateContextRanking",
           "signature": "(input: ContextRankingEvaluationInput) => ContextRankingEvaluation | calls: (input: ContextRankingEvaluationInput) => ContextRankingEvaluation"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "finalizeContextUsageDelivery",
+          "signature": "(options: { pmRoot: string; result: unknown; }) => Promise<boolean> | calls: (options: { pmRoot: string; result: unknown; }) => Promise<boolean>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -27625,7 +28308,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemContextRelevanceCandidate",
-          "signature": "export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> { signals: ContextRelevanceSignals; }"
+          "signature": "export interface ItemContextRelevanceCandidate extends ContextRelevanceCandidate<ItemMetadata> { signals: ContextRelevanceSignals; signal_provenance: ContextSignalProvenance; }"
         },
         {
           "classification": "supported",
@@ -28023,6 +28706,12 @@
           "name": "projectContextFocusRows",
           "signature": "<T extends ContextFocusItem>(rows: T[], fields: string[]) => ContextFocusItem[] | calls: <T extends ContextFocusItem>(rows: T[], fields: string[]) => ContextFocusItem[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "propagateContextUsageServingReceipt",
+          "signature": "(source: unknown, target: unknown) => void | calls: (source: unknown, target: unknown) => void"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -28113,11 +28802,17 @@
           "name": "RecentContextItem",
           "signature": "export interface RecentContextItem extends ContextFocusItem { created_at?: string; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordContextUsageDelivery",
+          "signature": "(options: ContextUsageLedgerOptions & { receipt: ContextUsageServingReceipt | null; deliveredItemIds: readonly string[]; resultOmitted: boolean; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { receipt: ContextUsageServingReceipt | null; deliveredItemIds: readonly string[]; resultOmitted: boolean; }) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "recordContextUsageServing",
-          "signature": "(options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<void>"
+          "signature": "(options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<ContextUsageServingReceipt | null> | calls: (options: ContextUsageLedgerOptions & { author: string; surface: ContextRelevanceSurface; profile: string; rows: ContextUsageServingRow[]; }) => Promise<ContextUsageServingReceipt | null>"
         },
         {
           "classification": "supported",
@@ -28695,6 +29390,12 @@
           "name": "ClaimResult",
           "signature": "export interface ClaimResult { item: Record<string, unknown>; claimed_by: string; previous_assignee: string | null; forced: boolean; skipped?: boolean; warnings?: string[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "classifyHistoryEvent",
+          "signature": "(entry: Pick<HistoryEntry, \"event_class\" | \"op\" | \"patch\">) => HistoryEventClass | calls: (entry: Pick<HistoryEntry, \"op\" | \"patch\" | \"event_class\">) => HistoryEventClass"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -29349,6 +30050,12 @@
           "name": "HierarchyNode",
           "signature": "export interface HierarchyNode { id: string; title: string; type: string; status: ItemStatus; children_total: number; children_closed: number; children_open: number; children_in_progress: number; children_blocked: number; children: HierarchyChild[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "HISTORY_EVENT_CLASSIFICATION_VERSION",
+          "signature": "1"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -29361,6 +30068,12 @@
           "name": "historyCompactBulk",
           "signature": "(options: HistoryCompactBulkCommandOptions, clientOptions?: PmClientOptions) => Promise<HistoryCompactBulkResult> | calls: (options: HistoryCompactBulkCommandOptions, clientOptions?: PmClientOptions) => Promise<HistoryCompactBulkResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "HistoryEventClass",
+          "signature": "export type HistoryEventClass = \"substantive\" | \"maintenance\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -29667,6 +30380,12 @@
           "name": "LogNote",
           "signature": "export interface LogNote { created_at: string; author: string; text: string; format?: \"json\"; data?: StructuredJsonValue; event_type?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "MAINTENANCE_HISTORY_OPERATIONS",
+          "signature": "readonly [\"docs_add\", \"files_add\", \"history:author-acknowledge\", \"history_author_acknowledge\", \"history_compact\", \"history_compact_baseline\", \"history_redact\", \"history_repair\", \"normalize\", \"release\", \"test_run_track\", \"tests_add\", \"tests_remove\", \"update_audit\", \"update_ownership_bypass\"]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -31059,6 +31778,12 @@
           "name": "STATUS_VALUES",
           "signature": "readonly [\"draft\", \"open\", \"in_progress\", \"blocked\", \"closed\", \"canceled\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SUBSTANTIVE_HISTORY_OPERATIONS",
+          "signature": "readonly [\"append\", \"cancel\", \"claim\", \"close\", \"comment_add\", \"create\", \"learning_add\", \"note_add\", \"reopen\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -32051,6 +32776,7 @@
     "history_merge_conflict_markers_detected",
     "history_stream_over_compact_threshold",
     "history_target_out_of_range",
+    "history_timestamp_invalid",
     "history_unknown_author_events",
     "host_environment_capacity_fault",
     "host_environment_operation_invalid",
@@ -32163,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",