@unbrained/pm-cli 2026.9.1 → 2026.9.3

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1824,
+    "covered_symbols": 1838,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1825
+    "required_symbols": 1839
   },
   "breaking_acknowledgements": [
     {
@@ -1463,6 +1463,64 @@
       ],
       "package_version": "2026.8.31",
       "reason": "Add optional host-owned cursor integrity key for deployment-stable pagination; existing callers and process-local fallback remain compatible."
+    },
+    {
+      "changes": [
+        "signature ./sdk:MergeReceiptEvidenceReport",
+        "signature ./sdk:MergeReceiptEvidenceScan",
+        "signature ./sdk/merge:MergeReceiptEvidenceReport",
+        "signature ./sdk/merge:MergeReceiptEvidenceScan"
+      ],
+      "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"
     }
   ],
   "entrypoints": {
@@ -2861,6 +2919,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",
@@ -3153,7 +3217,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",
@@ -3449,6 +3513,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",
@@ -3527,6 +3597,12 @@
           "name": "classifyHistoryAuthorEvent",
           "signature": "(parsed: unknown) => \"actionable_unknown\" | \"attributed\" | \"legacy_unknown\" | calls: (parsed: unknown) => \"attributed\" | \"legacy_unknown\" | \"actionable_unknown\""
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "classifyHistoryEvent",
+          "signature": "(entry: Pick<HistoryEntry, \"event_class\" | \"op\" | \"patch\">) => HistoryEventClass | calls: (entry: Pick<HistoryEntry, \"op\" | \"patch\" | \"event_class\">) => HistoryEventClass"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -3713,6 +3789,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",
@@ -4181,6 +4263,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",
@@ -4197,13 +4285,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",
@@ -4359,13 +4447,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",
@@ -4421,17 +4515,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",
@@ -4467,13 +4567,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",
@@ -4481,6 +4581,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",
@@ -6773,6 +6879,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",
@@ -7667,6 +7779,12 @@
           "name": "HISTORY_COMPACT_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "HISTORY_EVENT_CLASSIFICATION_VERSION",
+          "signature": "1"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -7781,6 +7899,12 @@
           "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",
@@ -8409,7 +8533,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",
@@ -9107,6 +9231,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",
@@ -9291,13 +9421,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptEvidenceReport",
-          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
+          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; invalid_evidence: MergeReceiptInvalidEvidence[]; invalid_evidence_truncated: boolean; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptEvidenceScan",
-          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; }"
+          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; invalid_evidence: MergeReceiptInvalidEvidence[]; invalid_evidence_truncated: boolean; clone_local_evidence_resolved?: boolean; }"
+        },
+        {
+          "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; }"
         },
         {
           "classification": "advanced_export",
@@ -12995,6 +13131,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",
@@ -13391,11 +13533,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",
@@ -17249,6 +17397,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",
@@ -26733,13 +26887,19 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptEvidenceReport",
-          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
+          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; invalid_evidence: MergeReceiptInvalidEvidence[]; invalid_evidence_truncated: boolean; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeReceiptEvidenceScan",
-          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; }"
+          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; invalid_evidence: MergeReceiptInvalidEvidence[]; invalid_evidence_truncated: boolean; clone_local_evidence_resolved?: boolean; }"
+        },
+        {
+          "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; }"
         },
         {
           "classification": "supported",
@@ -26951,6 +27111,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",
@@ -27015,7 +27181,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",
@@ -27089,6 +27255,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",
@@ -27147,13 +27319,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",
@@ -27303,13 +27475,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",
@@ -27365,17 +27543,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",
@@ -27411,13 +27595,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",
@@ -27425,6 +27609,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",
@@ -27527,6 +27717,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",
@@ -27603,7 +27799,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",
@@ -28001,6 +28197,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",
@@ -28091,11 +28293,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",
@@ -28673,6 +28881,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",
@@ -29327,6 +29541,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",
@@ -29339,6 +29559,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",
@@ -29645,6 +29871,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",
@@ -31037,6 +31269,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",
@@ -32029,6 +32267,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",
@@ -32095,6 +32334,7 @@
     "merge_decisions_unreviewed",
     "merge_git_config_unwritable",
     "merge_receipt_evidence_invalid",
+    "merge_receipt_history_reference_missing",
     "merge_receipts_pending",
     "merge_reconcile_receipt_evidence_untrusted",
     "merge_root_not_found",