@remnic/core 9.48.1 → 9.49.1

package/dist/{types-D_Au9qJO.d.ts → types-D_a6Sqjz.d.ts}

@@ -1788,6 +1788,18 @@ interface ContradictionScanConfig {
     /** When true, pairs judged "duplicates" are auto-flagged for dedup (still need user approval). Default false. */
     autoMergeDuplicates: boolean;
 }
+interface DependencyPropagationConfig {
+    /** Master switch. Default false. */
+    enabled: boolean;
+    /** Link types that can identify one-hop dependents. */
+    linkTypes: Array<"supports" | "follows" | "references">;
+    /** Maximum active dependents to revalidate. `0` disables propagation. */
+    maxDependents: number;
+    /** Maximum duration of the single batched revalidation call, in milliseconds. */
+    timeoutMs: number;
+    /** Discover and revalidate dependents without writing supersession changes. */
+    dryRun: boolean;
+}
 interface HeartbeatConfig {
     enabled: boolean;
     journalPath: string;
@@ -1992,6 +2004,8 @@ interface PluginConfig extends BoundedJsonlStateConfig {
     contradictionAutoResolve: boolean;
     /** Nightly contradiction-scan cron config (issue #520). */
     contradictionScan: ContradictionScanConfig;
+    /** One-hop dependency invalidation propagation settings (issue #2326). */
+    dependencyPropagation: DependencyPropagationConfig;
     /**
      * When enabled, writes that carry `structuredAttributes` mark any older
      * fact with the same `entityRef + attribute_name` supersession key and a
@@ -3819,6 +3833,10 @@ interface MemoryFrontmatter extends SourceConnectorProvenance {
     supersededBy?: string;
     /** Timestamp when superseded */
     supersededAt?: string;
+    /** Why this memory was superseded. Absent means legacy/direct. */
+    supersessionCause?: "direct" | "dependency";
+    /** ID of the superseded memory that caused dependency invalidation. */
+    invalidatedBy?: string;
     /** Timestamp when archived */
     archivedAt?: string;
     /**
@@ -4149,14 +4167,12 @@ interface ExtractedFact {
     confidence: number;
     tags: string[];
     entityRef?: string;
+    cueAnchors?: Array<{
+        type: "entity" | "file" | "tool" | "outcome" | "constraint" | "date";
+        value: string;
+    }>;
     source?: ExtractionPassSource;
-    /**
-     * Claim-level provenance spans backing this fact (issue #1575).
-     * Populated by the PR 2 extraction validator when `provenance.enabled`
-     * is true. Absent for legacy extractions — downstream consumers (the
-     * faithfulness gate #1576, TrustScore #1577) MUST treat absent as
-     * "no verified span" and skip gracefully.
-     */
+    /** Claim-level provenance spans. Missing spans fail closed when verification requires them. */
     sources?: ProvenanceSource[];
     /**
      * Coarse provenance strength tag (issue #1575 PR 2). Set by the extraction
@@ -4267,6 +4283,7 @@ interface ExtractionResult {
     entities: EntityMention[];
     questions: ExtractedQuestion[];
     identityReflection?: string;
+    episodeTitle?: string;
     relationships?: ExtractedRelationship[];
     extractionFailure?: string;
     /** Coarse class used by the retry/backoff + circuit-breaker layer (extraction hot loop). */
@@ -4695,4 +4712,4 @@ interface HourlySummary {
     generatedAt: string;
 }
 
-export { type ReplicaPeerConfig as $, type AgentPersonaModelConfig as A, type BriefingSections as B, type CodingContext as C, type DreamsPhase as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type MemoryLifecycleEvent as J, type ExtractionResult as K, type LiveConnectorsConfig as L, type MemoryFile as M, type ConsolidationResult as N, type DaySummaryResult as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallPlanMode as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type ProvenanceSource as U, type TrustWeights as V, type ConversationThread as W, type LifecycleState as X, type VerificationState as Y, type PolicyClass as Z, type ReplicaPeersConfig as _, type DreamsRunResult as a, type WearableSourceConnector as a$, type ExtractionFailureClass as a0, type ImportanceLevel as a1, type ConvergeConflictPolicy as a2, type ActiveRecallChatType as a3, type ActiveRecallQueryMode as a4, type ActiveRecallPromptStyle as a5, type ActiveRecallThinking as a6, type ActiveRecallModelFallbackPolicy as a7, type BehaviorSignalEvent as a8, type BufferSurpriseEvent as a9, summarizeExtractionLiveness as aA, type RetrievalTier as aB, type SignalScanResult as aC, type TopicScore as aD, type QmdSearchExplain as aE, type ActivitySnapshot as aF, type ActivityConfig as aG, type ActivitySourceConfig as aH, type ActivitySourceClient as aI, type FusedWearableConversation as aJ, type FusedDayMeta as aK, type FusedDayFile as aL, type MeetingRecord as aM, type MeetingDetectionSource as aN, type FusedMeeting as aO, type EntityTimelineEntry as aP, type MemoryLink as aQ, type BufferState as aR, type FileHygieneConfig as aS, type EntityRelationship as aT, type EntityActivityEntry as aU, type AccessTrackingEntry as aV, type MemorySummary as aW, type WearableConversation as aX, type WearableSourceSettings as aY, type WearableNativeMemory as aZ, type WearableMemoryMode as a_, type ImportTurn as aa, type BulkImportOptions as ab, type BulkImportSource as ac, type BulkImportResult as ad, type CompressionGuidelineOptimizerEventCounts as ae, type CompressionGuidelineOptimizerActionSummary as af, type CompressionGuidelineOptimizerRuleUpdate as ag, type MemoryActionType as ah, type MemoryActionEvent as ai, type CompressionGuidelineOptimizerState as aj, type ConvergeConfig as ak, type EntityMention as al, type EntitySchemaDefinition as am, type EntitySchemaSectionDefinition as an, type EntityStructuredSection as ao, type ProvenanceConfig as ap, type ImportanceScore as aq, type MemoryIntent as ar, type MemoryActionEligibilityContext as as, type MemoryActionPolicyResult as at, type MemoryLifecycleEventType as au, type MemoryLifecycleStateSummary as av, type ModelProviderConfig as aw, type NativeKnowledgeConfig as ax, type ExtractionBufferSource as ay, type MetaState as az, type RecallTierExplain as b, parseIsoTimestamp as b$, type WearablesConfig as b0, type WearableSyncSummary as b1, type WearableSourceStatus as b2, type WearableDayTranscript as b3, type WearableCorrectionRule as b4, type MeetingBuildInput as b5, type MeetingsConfig as b6, type MeetingsDetectionInput as b7, type FusionConversationInput as b8, type MeetingActivitySnapshot as b9, type BriefingWindow as bA, type BulkImportError as bB, type BulkImportSourceAdapter as bC, type CodexCompatConfig as bD, DEFAULT_RECALL_DISCLOSURE as bE, type DisagreementKind as bF, type ExtractedFact as bG, type FusedContribution as bH, type FusedConversationProvenance as bI, type FusedSegmentProvenance as bJ, type FusionSegmentInput as bK, type ImportSourceRole as bL, type ImportTurnValidationIssue as bM, type MeetingScreenContextEvent as bN, type MeetingSummaryMode as bO, type MemoryActionEligibilitySource as bP, type MemoryObservation as bQ, type MemoryScope as bR, RECALL_DISCLOSURE_LEVELS as bS, type SegmentPickReason as bT, type WearableAuthCheck as bU, type WearableFetchOptions as bV, type WearableFetchPage as bW, type WearableNativeMemoryPage as bX, type WearableTranscriptSegment as bY, isImportRole as bZ, isRecallDisclosure as b_, type DetectedMeeting as ba, type DreamsStatusResult as bb, type RecallSectionConfig as bc, type BootstrapOptions as bd, type BootstrapResult as be, type ConsolidationObservation as bf, type CodingModeConfig as bg, type FusedSpeaker as bh, type FusedSegment as bi, type FusedDisagreement as bj, type FusionOptions as bk, type FusionDayResult as bl, type CodingKnowledgeConfig as bm, type WearableCleanupSettings as bn, type WearableFusionConfig as bo, type WearableDayTranscriptMeta as bp, type ActivityDayMeta as bq, type ActivityDayDigest as br, type ActivitySourceCheck as bs, type ActivitySnapshotPage as bt, type MeetingsDetectionConfig as bu, type MeetingAudioWindow as bv, type MeetingAppSpan as bw, type ActivityExtractionMode as bx, type BriefingConfig as by, type BriefingOpenCommitment as bz, type BriefingFollowup as c, type GmailLiveConnectorConfig as c$, validateImportTurn as c0, type ExtractionLivenessConfig as c1, ExtractionLivenessWarnThrottle as c2, type ExtractionRootStats as c3, type ExtractionWatermarkOrStorage as c4, type ExtractionWatermarkRead as c5, coerceExtractionWatermark as c6, computeExtractionLivenessStatus as c7, evaluateExtractionLiveness as c8, formatAgeMs as c9, type CodexCliReasoningEffort as cA, type CodexCompactionFlushMode as cB, type CodexConnectorConfig as cC, type CodingGraphLspConfig as cD, type CompressionGuidelineActivationState as cE, type CompressionGuidelineOptimizerSourceWindow as cF, type ConfidenceTier as cG, type ConsolidationAction as cH, type ConsolidationItem as cI, type ContradictionScanConfig as cJ, type CronConversationRecallMode as cK, type CronRecallMode as cL, type DreamingConfig as cM, type DreamingNarrativePromptStyle as cN, type DreamsDeepSleepConfig as cO, type DreamsLightSleepConfig as cP, type DreamsPhaseStatus as cQ, type DreamsPhasesConfig as cR, type DreamsRemConfig as cS, type EngramTraceEvent as cT, type ExtractedProcedureStep as cU, type ExtractedQuestion as cV, type ExtractedReasoningTrace as cW, type ExtractedReasoningTraceStep as cX, type ExtractedRelationship as cY, type ExtractionPassSource as cZ, type GitHubLiveConnectorConfig as c_, gatherExtractionLivenessStatus as ca, parseExtractionLivenessConfig as cb, renderExtractionLivenessStats as cc, resolveExtractionLivenessConfig as cd, parseReplicaPeersConfig as ce, resolveReplicaPeersConfig as cf, type AmbientCaptureProvenance as cg, type BufferTurnOwner as ch, ProbeTimeoutError as ci, bufferTurnArrayIsSuffixOfSnapshot as cj, bufferTurnArraysEqual as ck, bufferTurnsEqual as cl, copyBufferTurn as cm, describeError as cn, liveTurnsFromExtractionSnapshot as co, matchingQueuedExtractionPrefixLength as cp, probeWithTimeout as cq, type AgentAccessHttpConfig as cr, type AgentDefaultsConfig as cs, type AgentPersona as ct, type BehaviorLoopAdjustment as cu, type BehaviorSignalDirection as cv, type BehaviorSignalType as cw, type BriefingCalendarSourceError as cx, type BufferEntryState as cy, type ChatConfig as cz, type BriefingFocus as d, type GoogleDriveLiveConnectorConfig as d0, type HeartbeatConfig as d1, type HeartbeatDetectionMode as d2, type LlmTraceCallback as d3, type LlmTraceEvent as d4, type MemoryActionOutcome as d5, type MemoryActionPolicyDecision as d6, type MemoryActionStatus as d7, type MemoryLinkType as d8, type MemoryOsPresetName as d9, type TriggerMode as dA, confidenceTier as dB, type ModelApi as da, type ModelDefinitionConfig as db, type ModelProviderAuthMode as dc, type NamespacePolicy as dd, type NativeKnowledgeFolderRuleConfig as de, type NativeKnowledgeObsidianVaultConfig as df, type NativeKnowledgeOpenClawWorkspaceConfig as dg, type NotionLiveConnectorConfig as dh, type PrincipalFromSessionKeyMode as di, type PrincipalRule as dj, type ProceduralConfig as dk, type QuestionEntry as dl, type ReasoningEffort as dm, type RecallPipelineConfig as dn, type RecallTraceEvent as dp, type RelevanceFeedback as dq, SPECULATIVE_TTL_DAYS as dr, type ScopeProfileAutoPromoteConfig as ds, type ScopeProfileTeamProjectConfig as dt, type ScopeTeamConfig as du, type ScoredEntity as dv, type SemanticChunkingConfigShape as dw, type SignalLevel as dx, type SlotBehaviorConfig as dy, type SlotMismatchMode as dz, type CalendarSource as e, type CalendarEvent as f, type BriefingActiveThread as g, type BriefingResult as h, type BriefingRecentEntity as i, type BufferTurn as j, type ExtractionBufferSnapshot as k, type MemoryFrontmatter as l, type Checkpoint as m, type RecallDisclosure as n, type SourceConnectorProvenance as o, type ScopeProfileConfig as p, type ScopeProfileLayerId as q, type ScopeProfilePromotionTarget as r, type BehaviorLoopPolicyState as s, type SecretRef as t, type AgentAccessAuthToken as u, type ExtractionLivenessStatus as v, type MemoryCategory as w, type CaptureMode as x, type MemoryStatus as y, type MemoryProjectionCurrentState as z };
+export { type ReplicaPeerConfig as $, type AgentPersonaModelConfig as A, type BriefingSections as B, type CodingContext as C, type DreamsPhase as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type MemoryLifecycleEvent as J, type ExtractionResult as K, type LiveConnectorsConfig as L, type MemoryFile as M, type ConsolidationResult as N, type DaySummaryResult as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallPlanMode as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type ProvenanceSource as U, type TrustWeights as V, type ConversationThread as W, type LifecycleState as X, type VerificationState as Y, type PolicyClass as Z, type ReplicaPeersConfig as _, type DreamsRunResult as a, type WearableNativeMemory as a$, type ExtractionFailureClass as a0, type ImportanceLevel as a1, type ConvergeConflictPolicy as a2, type ActiveRecallChatType as a3, type ActiveRecallQueryMode as a4, type ActiveRecallPromptStyle as a5, type ActiveRecallThinking as a6, type ActiveRecallModelFallbackPolicy as a7, type BehaviorSignalEvent as a8, type BufferSurpriseEvent as a9, type ExtractionBufferSource as aA, type MetaState as aB, summarizeExtractionLiveness as aC, type RetrievalTier as aD, type SignalScanResult as aE, type TopicScore as aF, type QmdSearchExplain as aG, type ActivitySnapshot as aH, type ActivityConfig as aI, type ActivitySourceConfig as aJ, type ActivitySourceClient as aK, type FusedWearableConversation as aL, type FusedDayMeta as aM, type FusedDayFile as aN, type MeetingRecord as aO, type MeetingDetectionSource as aP, type FusedMeeting as aQ, type EntityTimelineEntry as aR, type MemoryLink as aS, type BufferState as aT, type FileHygieneConfig as aU, type EntityRelationship as aV, type EntityActivityEntry as aW, type AccessTrackingEntry as aX, type MemorySummary as aY, type WearableConversation as aZ, type WearableSourceSettings as a_, type ImportTurn as aa, type BulkImportOptions as ab, type BulkImportSource as ac, type BulkImportResult as ad, type CompressionGuidelineOptimizerEventCounts as ae, type CompressionGuidelineOptimizerActionSummary as af, type CompressionGuidelineOptimizerRuleUpdate as ag, type MemoryActionType as ah, type MemoryActionEvent as ai, type CompressionGuidelineOptimizerState as aj, type ConvergeConfig as ak, type EntityMention as al, type DependencyPropagationConfig as am, type EntitySchemaDefinition as an, type EntitySchemaSectionDefinition as ao, type EntityStructuredSection as ap, type ExtractedFact as aq, type ProvenanceConfig as ar, type ImportanceScore as as, type MemoryIntent as at, type MemoryActionEligibilityContext as au, type MemoryActionPolicyResult as av, type MemoryLifecycleEventType as aw, type MemoryLifecycleStateSummary as ax, type ModelProviderConfig as ay, type NativeKnowledgeConfig as az, type RecallTierExplain as b, isRecallDisclosure as b$, type WearableMemoryMode as b0, type WearableSourceConnector as b1, type WearablesConfig as b2, type WearableSyncSummary as b3, type WearableSourceStatus as b4, type WearableDayTranscript as b5, type WearableCorrectionRule as b6, type MeetingBuildInput as b7, type MeetingsConfig as b8, type MeetingsDetectionInput as b9, type BriefingConfig as bA, type BriefingOpenCommitment as bB, type BriefingWindow as bC, type BulkImportError as bD, type BulkImportSourceAdapter as bE, type CodexCompatConfig as bF, DEFAULT_RECALL_DISCLOSURE as bG, type DisagreementKind as bH, type FusedContribution as bI, type FusedConversationProvenance as bJ, type FusedSegmentProvenance as bK, type FusionSegmentInput as bL, type ImportSourceRole as bM, type ImportTurnValidationIssue as bN, type MeetingScreenContextEvent as bO, type MeetingSummaryMode as bP, type MemoryActionEligibilitySource as bQ, type MemoryObservation as bR, type MemoryScope as bS, RECALL_DISCLOSURE_LEVELS as bT, type SegmentPickReason as bU, type WearableAuthCheck as bV, type WearableFetchOptions as bW, type WearableFetchPage as bX, type WearableNativeMemoryPage as bY, type WearableTranscriptSegment as bZ, isImportRole as b_, type FusionConversationInput as ba, type MeetingActivitySnapshot as bb, type DetectedMeeting as bc, type DreamsStatusResult as bd, type RecallSectionConfig as be, type BootstrapOptions as bf, type BootstrapResult as bg, type ConsolidationObservation as bh, type CodingModeConfig as bi, type FusedSpeaker as bj, type FusedSegment as bk, type FusedDisagreement as bl, type FusionOptions as bm, type FusionDayResult as bn, type CodingKnowledgeConfig as bo, type WearableCleanupSettings as bp, type WearableFusionConfig as bq, type WearableDayTranscriptMeta as br, type ActivityDayMeta as bs, type ActivityDayDigest as bt, type ActivitySourceCheck as bu, type ActivitySnapshotPage as bv, type MeetingsDetectionConfig as bw, type MeetingAudioWindow as bx, type MeetingAppSpan as by, type ActivityExtractionMode as bz, type BriefingFollowup as c, type GitHubLiveConnectorConfig as c$, parseIsoTimestamp as c0, validateImportTurn as c1, type ExtractionLivenessConfig as c2, ExtractionLivenessWarnThrottle as c3, type ExtractionRootStats as c4, type ExtractionWatermarkOrStorage as c5, type ExtractionWatermarkRead as c6, coerceExtractionWatermark as c7, computeExtractionLivenessStatus as c8, evaluateExtractionLiveness as c9, type ChatConfig as cA, type CodexCliReasoningEffort as cB, type CodexCompactionFlushMode as cC, type CodexConnectorConfig as cD, type CodingGraphLspConfig as cE, type CompressionGuidelineActivationState as cF, type CompressionGuidelineOptimizerSourceWindow as cG, type ConfidenceTier as cH, type ConsolidationAction as cI, type ConsolidationItem as cJ, type ContradictionScanConfig as cK, type CronConversationRecallMode as cL, type CronRecallMode as cM, type DreamingConfig as cN, type DreamingNarrativePromptStyle as cO, type DreamsDeepSleepConfig as cP, type DreamsLightSleepConfig as cQ, type DreamsPhaseStatus as cR, type DreamsPhasesConfig as cS, type DreamsRemConfig as cT, type EngramTraceEvent as cU, type ExtractedProcedureStep as cV, type ExtractedQuestion as cW, type ExtractedReasoningTrace as cX, type ExtractedReasoningTraceStep as cY, type ExtractedRelationship as cZ, type ExtractionPassSource as c_, formatAgeMs as ca, gatherExtractionLivenessStatus as cb, parseExtractionLivenessConfig as cc, renderExtractionLivenessStats as cd, resolveExtractionLivenessConfig as ce, parseReplicaPeersConfig as cf, resolveReplicaPeersConfig as cg, type AmbientCaptureProvenance as ch, type BufferTurnOwner as ci, ProbeTimeoutError as cj, bufferTurnArrayIsSuffixOfSnapshot as ck, bufferTurnArraysEqual as cl, bufferTurnsEqual as cm, copyBufferTurn as cn, describeError as co, liveTurnsFromExtractionSnapshot as cp, matchingQueuedExtractionPrefixLength as cq, probeWithTimeout as cr, type AgentAccessHttpConfig as cs, type AgentDefaultsConfig as ct, type AgentPersona as cu, type BehaviorLoopAdjustment as cv, type BehaviorSignalDirection as cw, type BehaviorSignalType as cx, type BriefingCalendarSourceError as cy, type BufferEntryState as cz, type BriefingFocus as d, type GmailLiveConnectorConfig as d0, type GoogleDriveLiveConnectorConfig as d1, type HeartbeatConfig as d2, type HeartbeatDetectionMode as d3, type LlmTraceCallback as d4, type LlmTraceEvent as d5, type MemoryActionOutcome as d6, type MemoryActionPolicyDecision as d7, type MemoryActionStatus as d8, type MemoryLinkType as d9, type SlotMismatchMode as dA, type TriggerMode as dB, confidenceTier as dC, type MemoryOsPresetName as da, type ModelApi as db, type ModelDefinitionConfig as dc, type ModelProviderAuthMode as dd, type NamespacePolicy as de, type NativeKnowledgeFolderRuleConfig as df, type NativeKnowledgeObsidianVaultConfig as dg, type NativeKnowledgeOpenClawWorkspaceConfig as dh, type NotionLiveConnectorConfig as di, type PrincipalFromSessionKeyMode as dj, type PrincipalRule as dk, type ProceduralConfig as dl, type QuestionEntry as dm, type ReasoningEffort as dn, type RecallPipelineConfig as dp, type RecallTraceEvent as dq, type RelevanceFeedback as dr, SPECULATIVE_TTL_DAYS as ds, type ScopeProfileAutoPromoteConfig as dt, type ScopeProfileTeamProjectConfig as du, type ScopeTeamConfig as dv, type ScoredEntity as dw, type SemanticChunkingConfigShape as dx, type SignalLevel as dy, type SlotBehaviorConfig as dz, type CalendarSource as e, type CalendarEvent as f, type BriefingActiveThread as g, type BriefingResult as h, type BriefingRecentEntity as i, type BufferTurn as j, type ExtractionBufferSnapshot as k, type MemoryFrontmatter as l, type Checkpoint as m, type RecallDisclosure as n, type SourceConnectorProvenance as o, type ScopeProfileConfig as p, type ScopeProfileLayerId as q, type ScopeProfilePromotionTarget as r, type BehaviorLoopPolicyState as s, type SecretRef as t, type AgentAccessAuthToken as u, type ExtractionLivenessStatus as v, type MemoryCategory as w, type CaptureMode as x, type MemoryStatus as y, type MemoryProjectionCurrentState as z };

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { aV as AccessTrackingEntry, a3 as ActiveRecallChatType, a7 as ActiveRecallModelFallbackPolicy, a5 as ActiveRecallPromptStyle, a4 as ActiveRecallQueryMode, a6 as ActiveRecallThinking, u as AgentAccessAuthToken, cr as AgentAccessHttpConfig, cs as AgentDefaultsConfig, ct as AgentPersona, A as AgentPersonaModelConfig, cu as BehaviorLoopAdjustment, s as BehaviorLoopPolicyState, cv as BehaviorSignalDirection, a8 as BehaviorSignalEvent, cw as BehaviorSignalType, bd as BootstrapOptions, be as BootstrapResult, g as BriefingActiveThread, cx as BriefingCalendarSourceError, by as BriefingConfig, d as BriefingFocus, c as BriefingFollowup, bz as BriefingOpenCommitment, i as BriefingRecentEntity, h as BriefingResult, B as BriefingSections, bA as BriefingWindow, cy as BufferEntryState, aR as BufferState, a9 as BufferSurpriseEvent, j as BufferTurn, f as CalendarEvent, e as CalendarSource, x as CaptureMode, cz as ChatConfig, m as Checkpoint, cA as CodexCliReasoningEffort, cB as CodexCompactionFlushMode, bD as CodexCompatConfig, cC as CodexConnectorConfig, C as CodingContext, cD as CodingGraphLspConfig, bm as CodingKnowledgeConfig, bg as CodingModeConfig, cE as CompressionGuidelineActivationState, af as CompressionGuidelineOptimizerActionSummary, ae as CompressionGuidelineOptimizerEventCounts, ag as CompressionGuidelineOptimizerRuleUpdate, cF as CompressionGuidelineOptimizerSourceWindow, aj as CompressionGuidelineOptimizerState, cG as ConfidenceTier, cH as ConsolidationAction, cI as ConsolidationItem, bf as ConsolidationObservation, N as ConsolidationResult, cJ as ContradictionScanConfig, ak as ConvergeConfig, a2 as ConvergeConflictPolicy, W as ConversationThread, cK as CronConversationRecallMode, cL as CronRecallMode, bE as DEFAULT_RECALL_DISCLOSURE, O as DaySummaryResult, cM as DreamingConfig, cN as DreamingNarrativePromptStyle, cO as DreamsDeepSleepConfig, cP as DreamsLightSleepConfig, D as DreamsPhase, cQ as DreamsPhaseStatus, cR as DreamsPhasesConfig, cS as DreamsRemConfig, a as DreamsRunResult, bb as DreamsStatusResult, cT as EngramTraceEvent, aU as EntityActivityEntry, E as EntityFile, al as EntityMention, aT as EntityRelationship, am as EntitySchemaDefinition, an as EntitySchemaSectionDefinition, ao as EntityStructuredSection, aP as EntityTimelineEntry, bG as ExtractedFact, cU as ExtractedProcedureStep, cV as ExtractedQuestion, cW as ExtractedReasoningTrace, cX as ExtractedReasoningTraceStep, cY as ExtractedRelationship, a0 as ExtractionFailureClass, cZ as ExtractionPassSource, K as ExtractionResult, F as FaithfulnessFrontmatter, aS as FileHygieneConfig, G as GatewayConfig, c_ as GitHubLiveConnectorConfig, c$ as GmailLiveConnectorConfig, d0 as GoogleDriveLiveConnectorConfig, d1 as HeartbeatConfig, d2 as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, a1 as ImportanceLevel, aq as ImportanceScore, X as LifecycleState, L as LiveConnectorsConfig, d3 as LlmTraceCallback, d4 as LlmTraceEvent, as as MemoryActionEligibilityContext, bP as MemoryActionEligibilitySource, ai as MemoryActionEvent, d5 as MemoryActionOutcome, d6 as MemoryActionPolicyDecision, at as MemoryActionPolicyResult, d7 as MemoryActionStatus, ah as MemoryActionType, w as MemoryCategory, M as MemoryFile, l as MemoryFrontmatter, ar as MemoryIntent, J as MemoryLifecycleEvent, au as MemoryLifecycleEventType, av as MemoryLifecycleStateSummary, aQ as MemoryLink, d8 as MemoryLinkType, bQ as MemoryObservation, d9 as MemoryOsPresetName, z as MemoryProjectionCurrentState, bR as MemoryScope, y as MemoryStatus, aW as MemorySummary, az as MetaState, da as ModelApi, db as ModelDefinitionConfig, dc as ModelProviderAuthMode, aw as ModelProviderConfig, dd as NamespacePolicy, ax as NativeKnowledgeConfig, de as NativeKnowledgeFolderRuleConfig, df as NativeKnowledgeObsidianVaultConfig, dg as NativeKnowledgeOpenClawWorkspaceConfig, dh as NotionLiveConnectorConfig, P as PluginConfig, Z as PolicyClass, di as PrincipalFromSessionKeyMode, dj as PrincipalRule, dk as ProceduralConfig, ap as ProvenanceConfig, U as ProvenanceSource, aE as QmdSearchExplain, Q as QmdSearchResult, dl as QuestionEntry, bS as RECALL_DISCLOSURE_LEVELS, dm as ReasoningEffort, n as RecallDisclosure, dn as RecallPipelineConfig, R as RecallPlanMode, bc as RecallSectionConfig, b as RecallTierExplain, dp as RecallTraceEvent, dq as RelevanceFeedback, aB as RetrievalTier, dr as SPECULATIVE_TTL_DAYS, ds as ScopeProfileAutoPromoteConfig, p as ScopeProfileConfig, q as ScopeProfileLayerId, r as ScopeProfilePromotionTarget, dt as ScopeProfileTeamProjectConfig, du as ScopeTeamConfig, dv as ScoredEntity, t as SecretRef, dw as SemanticChunkingConfigShape, S as SessionObserverBandConfig, dx as SignalLevel, aC as SignalScanResult, dy as SlotBehaviorConfig, dz as SlotMismatchMode, o as SourceConnectorProvenance, aD as TopicScore, T as TranscriptEntry, dA as TriggerMode, V as TrustWeights, Y as VerificationState, dB as confidenceTier, b_ as isRecallDisclosure } from './types-D_Au9qJO.js';
+export { aX as AccessTrackingEntry, a3 as ActiveRecallChatType, a7 as ActiveRecallModelFallbackPolicy, a5 as ActiveRecallPromptStyle, a4 as ActiveRecallQueryMode, a6 as ActiveRecallThinking, u as AgentAccessAuthToken, cs as AgentAccessHttpConfig, ct as AgentDefaultsConfig, cu as AgentPersona, A as AgentPersonaModelConfig, cv as BehaviorLoopAdjustment, s as BehaviorLoopPolicyState, cw as BehaviorSignalDirection, a8 as BehaviorSignalEvent, cx as BehaviorSignalType, bf as BootstrapOptions, bg as BootstrapResult, g as BriefingActiveThread, cy as BriefingCalendarSourceError, bA as BriefingConfig, d as BriefingFocus, c as BriefingFollowup, bB as BriefingOpenCommitment, i as BriefingRecentEntity, h as BriefingResult, B as BriefingSections, bC as BriefingWindow, cz as BufferEntryState, aT as BufferState, a9 as BufferSurpriseEvent, j as BufferTurn, f as CalendarEvent, e as CalendarSource, x as CaptureMode, cA as ChatConfig, m as Checkpoint, cB as CodexCliReasoningEffort, cC as CodexCompactionFlushMode, bF as CodexCompatConfig, cD as CodexConnectorConfig, C as CodingContext, cE as CodingGraphLspConfig, bo as CodingKnowledgeConfig, bi as CodingModeConfig, cF as CompressionGuidelineActivationState, af as CompressionGuidelineOptimizerActionSummary, ae as CompressionGuidelineOptimizerEventCounts, ag as CompressionGuidelineOptimizerRuleUpdate, cG as CompressionGuidelineOptimizerSourceWindow, aj as CompressionGuidelineOptimizerState, cH as ConfidenceTier, cI as ConsolidationAction, cJ as ConsolidationItem, bh as ConsolidationObservation, N as ConsolidationResult, cK as ContradictionScanConfig, ak as ConvergeConfig, a2 as ConvergeConflictPolicy, W as ConversationThread, cL as CronConversationRecallMode, cM as CronRecallMode, bG as DEFAULT_RECALL_DISCLOSURE, O as DaySummaryResult, am as DependencyPropagationConfig, cN as DreamingConfig, cO as DreamingNarrativePromptStyle, cP as DreamsDeepSleepConfig, cQ as DreamsLightSleepConfig, D as DreamsPhase, cR as DreamsPhaseStatus, cS as DreamsPhasesConfig, cT as DreamsRemConfig, a as DreamsRunResult, bd as DreamsStatusResult, cU as EngramTraceEvent, aW as EntityActivityEntry, E as EntityFile, al as EntityMention, aV as EntityRelationship, an as EntitySchemaDefinition, ao as EntitySchemaSectionDefinition, ap as EntityStructuredSection, aR as EntityTimelineEntry, aq as ExtractedFact, cV as ExtractedProcedureStep, cW as ExtractedQuestion, cX as ExtractedReasoningTrace, cY as ExtractedReasoningTraceStep, cZ as ExtractedRelationship, a0 as ExtractionFailureClass, c_ as ExtractionPassSource, K as ExtractionResult, F as FaithfulnessFrontmatter, aU as FileHygieneConfig, G as GatewayConfig, c$ as GitHubLiveConnectorConfig, d0 as GmailLiveConnectorConfig, d1 as GoogleDriveLiveConnectorConfig, d2 as HeartbeatConfig, d3 as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, a1 as ImportanceLevel, as as ImportanceScore, X as LifecycleState, L as LiveConnectorsConfig, d4 as LlmTraceCallback, d5 as LlmTraceEvent, au as MemoryActionEligibilityContext, bQ as MemoryActionEligibilitySource, ai as MemoryActionEvent, d6 as MemoryActionOutcome, d7 as MemoryActionPolicyDecision, av as MemoryActionPolicyResult, d8 as MemoryActionStatus, ah as MemoryActionType, w as MemoryCategory, M as MemoryFile, l as MemoryFrontmatter, at as MemoryIntent, J as MemoryLifecycleEvent, aw as MemoryLifecycleEventType, ax as MemoryLifecycleStateSummary, aS as MemoryLink, d9 as MemoryLinkType, bR as MemoryObservation, da as MemoryOsPresetName, z as MemoryProjectionCurrentState, bS as MemoryScope, y as MemoryStatus, aY as MemorySummary, aB as MetaState, db as ModelApi, dc as ModelDefinitionConfig, dd as ModelProviderAuthMode, ay as ModelProviderConfig, de as NamespacePolicy, az as NativeKnowledgeConfig, df as NativeKnowledgeFolderRuleConfig, dg as NativeKnowledgeObsidianVaultConfig, dh as NativeKnowledgeOpenClawWorkspaceConfig, di as NotionLiveConnectorConfig, P as PluginConfig, Z as PolicyClass, dj as PrincipalFromSessionKeyMode, dk as PrincipalRule, dl as ProceduralConfig, ar as ProvenanceConfig, U as ProvenanceSource, aG as QmdSearchExplain, Q as QmdSearchResult, dm as QuestionEntry, bT as RECALL_DISCLOSURE_LEVELS, dn as ReasoningEffort, n as RecallDisclosure, dp as RecallPipelineConfig, R as RecallPlanMode, be as RecallSectionConfig, b as RecallTierExplain, dq as RecallTraceEvent, dr as RelevanceFeedback, aD as RetrievalTier, ds as SPECULATIVE_TTL_DAYS, dt as ScopeProfileAutoPromoteConfig, p as ScopeProfileConfig, q as ScopeProfileLayerId, r as ScopeProfilePromotionTarget, du as ScopeProfileTeamProjectConfig, dv as ScopeTeamConfig, dw as ScoredEntity, t as SecretRef, dx as SemanticChunkingConfigShape, S as SessionObserverBandConfig, dy as SignalLevel, aE as SignalScanResult, dz as SlotBehaviorConfig, dA as SlotMismatchMode, o as SourceConnectorProvenance, aF as TopicScore, T as TranscriptEntry, dB as TriggerMode, V as TrustWeights, Y as VerificationState, dC as confidenceTier, b$ as isRecallDisclosure } from './types-D_a6Sqjz.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './external-wiki-config.js';

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-3S63QIFQ.js";
+} from "./chunk-LAQ33B5D.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_RECALL_DISCLOSURE,

package/dist/utility-learner.js

@@ -3,11 +3,11 @@ import {
   learnUtilityPromotionWeights,
   readUtilityLearningSnapshot,
   resolveUtilityLearningStatePath
-} from "./chunk-2F6NP3NT.js";
-import "./chunk-TERNBNJB.js";
+} from "./chunk-HDQUQBPW.js";
+import "./chunk-6FC3IZ26.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-LPSF4OQH.js";
+import "./chunk-P77QX3ID.js";
 import "./chunk-PZ5AY32C.js";
 export {
   getUtilityLearningStatus,

package/dist/utility-runtime.d.ts

@@ -1,5 +1,5 @@
 import { TierRoutingPolicy } from './tier-routing.js';
-import './types-D_Au9qJO.js';
+import './types-D_a6Sqjz.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/utility-runtime.js

@@ -2,12 +2,12 @@ import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
-} from "./chunk-LXOM6IQU.js";
-import "./chunk-2F6NP3NT.js";
-import "./chunk-TERNBNJB.js";
+} from "./chunk-SEF4IOFE.js";
+import "./chunk-HDQUQBPW.js";
+import "./chunk-6FC3IZ26.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-LPSF4OQH.js";
+import "./chunk-P77QX3ID.js";
 import "./chunk-PZ5AY32C.js";
 export {
   applyUtilityPromotionRuntimePolicy,

package/dist/utility-telemetry.js

@@ -4,9 +4,9 @@ import {
   recordUtilityTelemetryEvent,
   resolveUtilityTelemetryDir,
   validateUtilityTelemetryEvent
-} from "./chunk-TERNBNJB.js";
+} from "./chunk-6FC3IZ26.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-LPSF4OQH.js";
+import "./chunk-P77QX3ID.js";
 import "./chunk-PZ5AY32C.js";
 export {
   getUtilityTelemetryStatus,

package/dist/verified-recall.js

@@ -1,33 +1,34 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-GD7UPIBG.js";
+} from "./chunk-4JWJMRPJ.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-PLCZD3LG.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-24BKGKGO.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-SXIMQLGV.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-3S63QIFQ.js";
-import "./chunk-WRJVB3C2.js";
+import "./chunk-LAQ33B5D.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-WRJVB3C2.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-SYUBB3WM.js";
-import "./chunk-CGASUJVP.js";
-import "./chunk-R3DJVOSM.js";
+import "./chunk-GKEYXXKX.js";
+import "./chunk-5V6IXHPI.js";
 import "./chunk-BT7NVCML.js";
+import "./chunk-R3DJVOSM.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-7YKVM5H3.js";
-import "./chunk-IJ7HK452.js";
-import "./chunk-PDJTHRAW.js";
-import "./chunk-NZBZ7IS2.js";
-import "./chunk-DNHVPZOD.js";
+import "./chunk-PWLB4TRK.js";
+import "./chunk-KMAP7SNQ.js";
+import "./chunk-RBOJCG4T.js";
+import "./chunk-JDCQK3C5.js";
+import "./chunk-P26YHAQH.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
@@ -38,8 +39,8 @@ import "./chunk-45GF7Y3V.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-QBSFOKY6.js";
-import "./chunk-5GKPFL3S.js";
 import "./chunk-ZIKENA2C.js";
+import "./chunk-5GKPFL3S.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";

package/dist/work-product-ledger.js

@@ -4,10 +4,10 @@ import {
   resolveWorkProductLedgerDir,
   searchWorkProductLedgerEntries,
   validateWorkProductLedgerEntry
-} from "./chunk-ZRWB5D4H.js";
+} from "./chunk-WT6UL3UA.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-A2IYSXDQ.js";
-import "./chunk-LPSF4OQH.js";
+import "./chunk-P77QX3ID.js";
 import "./chunk-PZ5AY32C.js";
 export {
   getWorkProductLedgerStatus,

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { w as MemoryCategory } from './types-D_Au9qJO.js';
+import { w as MemoryCategory } from './types-D_a6Sqjz.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/write-envelope.js

@@ -11,9 +11,9 @@ import {
   isMemoryCategory,
   isSealedMemoryEnvelope,
   sealedWriteToLegacyArgs
-} from "./chunk-CGASUJVP.js";
-import "./chunk-R3DJVOSM.js";
+} from "./chunk-5V6IXHPI.js";
 import "./chunk-BT7NVCML.js";
+import "./chunk-R3DJVOSM.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
 import "./chunk-P7FMDTKL.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.48.1",
+  "version": "9.49.1",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,16 @@
       "remnic-source": "./src/index.ts",
       "import": "./dist/index.js"
     },
+    "./maintenance/atomic-file": {
+      "types": "./dist/maintenance/atomic-file.d.ts",
+      "remnic-source": "./src/maintenance/atomic-file.ts",
+      "import": "./dist/maintenance/atomic-file.js"
+    },
+    "./maintenance/atomic-file.js": {
+      "types": "./dist/maintenance/atomic-file.d.ts",
+      "remnic-source": "./src/maintenance/atomic-file.ts",
+      "import": "./dist/maintenance/atomic-file.js"
+    },
     "./abort-error": {
       "types": "./dist/abort-error.d.ts",
       "remnic-source": "./src/abort-error.ts",
@@ -36,6 +46,16 @@
       "remnic-source": "./src/abstraction-nodes.ts",
       "import": "./dist/abstraction-nodes.js"
     },
+    "./harmonic-construction": {
+      "types": "./dist/harmonic-construction.d.ts",
+      "remnic-source": "./src/harmonic-construction.ts",
+      "import": "./dist/harmonic-construction.js"
+    },
+    "./harmonic-construction.js": {
+      "types": "./dist/harmonic-construction.d.ts",
+      "remnic-source": "./src/harmonic-construction.ts",
+      "import": "./dist/harmonic-construction.js"
+    },
     "./access-audit": {
       "types": "./dist/access-audit.d.ts",
       "remnic-source": "./src/access-audit.ts",
@@ -515,6 +535,16 @@
       "remnic-source": "./src/coding/coding-graph-types.ts",
       "import": "./dist/coding/coding-graph-types.js"
     },
+    "./coding/pre-action-gate": {
+      "types": "./dist/coding/pre-action-gate.d.ts",
+      "remnic-source": "./src/coding/pre-action-gate.ts",
+      "import": "./dist/coding/pre-action-gate.js"
+    },
+    "./coding/pre-action-gate.js": {
+      "types": "./dist/coding/pre-action-gate.d.ts",
+      "remnic-source": "./src/coding/pre-action-gate.ts",
+      "import": "./dist/coding/pre-action-gate.js"
+    },
     "./commitment-ledger": {
       "types": "./dist/commitment-ledger.d.ts",
       "remnic-source": "./src/commitment-ledger.ts",
@@ -3096,7 +3126,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.48.1"
+    "@remnic/coding-graph": "^9.49.1"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/abstraction-nodes.ts

@@ -1,6 +1,7 @@
+import { mkdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { mkdir, writeFile } from "node:fs/promises";
-import { listJsonFiles, readJsonFile } from "./json-store.js";
+import { listJsonFilesStrict, readJsonFile, withJsonStoreMutationLock, writeJsonFileAtomic } from "./json-store.js";
+import { compareDeterministicStrings, mergeSortedUniqueStrings } from "./deterministic-order.js";
 import {
   assertIsoRecordedAt,
   assertSafePathSegment,
@@ -11,6 +12,10 @@ import {
   validateStringRecord,
 } from "./store-contract.js";
 
+function isNotFoundError(error: unknown): boolean {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+
 export type AbstractionNodeKind = "episode" | "topic" | "project" | "workflow" | "constraint";
 export type AbstractionLevel = "micro" | "meso" | "macro";
 
@@ -109,6 +114,177 @@ export async function recordAbstractionNode(options: {
   return filePath;
 }
 
+const MAX_ABSTRACTION_NODE_VALUES = 50;
+
+function mergeSortedValues(existing: string[] | undefined, incoming: string[] | undefined): string[] {
+  return mergeSortedUniqueStrings(existing, incoming).slice(0, MAX_ABSTRACTION_NODE_VALUES);
+}
+
+export const HARMONIC_SOURCE_MEMORY_INSERTED_AT_KEY = "remnic.harmonic.sourceMemoryInsertedAt.v1";
+
+function sourceMemoryInsertedAt(node: AbstractionNode | undefined): Map<string, string> {
+  const insertedAtById = new Map<string, string>();
+  if (!node) return insertedAtById;
+  let stored: Record<string, unknown> = {};
+  try {
+    const parsed = JSON.parse(node.metadata?.[HARMONIC_SOURCE_MEMORY_INSERTED_AT_KEY] ?? "{}") as unknown;
+    stored = isRecord(parsed) ? parsed : {};
+  } catch {
+    stored = {};
+  }
+  for (const memoryId of node.sourceMemoryIds ?? []) {
+    const insertedAt = stored[memoryId];
+    insertedAtById.set(
+      memoryId,
+      typeof insertedAt === "string" && Number.isFinite(Date.parse(insertedAt)) ? insertedAt : node.recordedAt
+    );
+  }
+  return insertedAtById;
+}
+
+function mergeRecentSourceMemoryIds(
+  existing: AbstractionNode | undefined,
+  incoming: AbstractionNode
+): { ids: string[]; insertedAtJson: string } {
+  const insertedAtById = sourceMemoryInsertedAt(existing);
+  const incomingSources = [...sourceMemoryInsertedAt(incoming).entries()].sort(
+    ([leftId, leftAt], [rightId, rightAt]) =>
+      Date.parse(leftAt) - Date.parse(rightAt) || compareDeterministicStrings(leftId, rightId)
+  );
+  let nextInsertedAtMs = Math.max(
+    Date.now(),
+    [...insertedAtById.values()].reduce((latest, insertedAt) => Math.max(latest, Date.parse(insertedAt) + 1), 0)
+  );
+  for (const [memoryId] of incomingSources) {
+    if (insertedAtById.has(memoryId)) continue;
+    insertedAtById.set(memoryId, new Date(nextInsertedAtMs).toISOString());
+    nextInsertedAtMs++;
+  }
+  const retained = [...insertedAtById.entries()]
+    .sort(
+      ([leftId, leftAt], [rightId, rightAt]) =>
+        Date.parse(rightAt) - Date.parse(leftAt) || compareDeterministicStrings(leftId, rightId)
+    )
+    .slice(0, MAX_ABSTRACTION_NODE_VALUES);
+  const ids = retained.map(([memoryId]) => memoryId).sort(compareDeterministicStrings);
+  const retainedInsertedAt = Object.fromEntries(ids.map((memoryId) => [memoryId, insertedAtById.get(memoryId)]));
+  return { ids, insertedAtJson: JSON.stringify(retainedInsertedAt) };
+}
+
+type AbstractionNodeFile = {
+  filePath: string;
+  node: AbstractionNode;
+};
+
+function compareNodeFiles(left: AbstractionNodeFile, right: AbstractionNodeFile): number {
+  return (
+    Date.parse(right.node.recordedAt) - Date.parse(left.node.recordedAt) ||
+    compareDeterministicStrings(left.filePath, right.filePath)
+  );
+}
+
+function compareIncomingNodes(left: AbstractionNode, right: AbstractionNode): number {
+  return (
+    Date.parse(left.recordedAt) - Date.parse(right.recordedAt) ||
+    compareDeterministicStrings(canonicalNodeKey(left), canonicalNodeKey(right))
+  );
+}
+
+function canonicalMetadata(metadata: Record<string, string> | undefined): Record<string, string> {
+  return Object.fromEntries(
+    Object.entries(metadata ?? {}).sort(([left], [right]) => compareDeterministicStrings(left, right))
+  );
+}
+
+function canonicalNodeKey(node: AbstractionNode): string {
+  return JSON.stringify({
+    ...node,
+    metadata: canonicalMetadata(node.metadata),
+  });
+}
+
+function mergeAbstractionNodes(existing: AbstractionNode | undefined, incoming: AbstractionNode): AbstractionNode {
+  const incomingIsNewest = !existing || Date.parse(existing.recordedAt) <= Date.parse(incoming.recordedAt);
+  const newest = incomingIsNewest ? incoming : existing;
+  const older = incomingIsNewest ? existing : incoming;
+  if (!newest) throw new Error("abstraction node merge requires a node");
+  const retainedSources = mergeRecentSourceMemoryIds(existing, incoming);
+  const mergedMetadata = canonicalMetadata({
+    ...(older?.metadata ?? {}),
+    ...(newest.metadata ?? {}),
+    [HARMONIC_SOURCE_MEMORY_INSERTED_AT_KEY]: retainedSources.insertedAtJson,
+  });
+  return validateAbstractionNode({
+    ...newest,
+    sourceMemoryIds: retainedSources.ids,
+    entityRefs: mergeSortedValues(existing?.entityRefs, incoming.entityRefs),
+    tags: mergeSortedValues(existing?.tags, incoming.tags),
+    metadata: mergedMetadata,
+  });
+}
+
+export async function upsertAbstractionNodes(options: {
+  memoryDir: string;
+  abstractionNodeStoreDir?: string;
+  nodes: AbstractionNode[];
+}): Promise<string[]> {
+  const rootDir = resolveAbstractionNodeStoreDir(options.memoryDir, options.abstractionNodeStoreDir);
+  const incomingNodes = options.nodes.map(validateAbstractionNode);
+  if (incomingNodes.length === 0) return [];
+  return withJsonStoreMutationLock(rootDir, async () => {
+    const nodesDir = path.join(rootDir, "nodes");
+    const nodeFiles = await listJsonFilesStrict(nodesDir, { allowMissingDirectory: true });
+    const existingNodes = await Promise.all(
+      nodeFiles.map(async (filePath) => ({
+        filePath,
+        node: validateAbstractionNode(await readJsonFile(filePath)),
+      }))
+    );
+    const existingById = new Map<string, AbstractionNodeFile[]>();
+    for (const existing of existingNodes) {
+      const records = existingById.get(existing.node.nodeId) ?? [];
+      records.push(existing);
+      existingById.set(existing.node.nodeId, records);
+    }
+    const incomingById = new Map<string, AbstractionNode[]>();
+    for (const incoming of incomingNodes) {
+      const records = incomingById.get(incoming.nodeId) ?? [];
+      records.push(incoming);
+      incomingById.set(incoming.nodeId, records);
+    }
+
+    const filePaths: string[] = [];
+    for (const nodeId of [...incomingById.keys()].sort(compareDeterministicStrings)) {
+      const existing = (existingById.get(nodeId) ?? []).sort(compareNodeFiles);
+      const incoming = (incomingById.get(nodeId) ?? []).sort(compareIncomingNodes);
+      let merged: AbstractionNode | undefined;
+      for (const next of [...existing].reverse()) merged = mergeAbstractionNodes(merged, next.node);
+      for (const next of incoming) merged = mergeAbstractionNodes(merged, next);
+      if (!merged) throw new Error(`abstraction node batch has no node: ${nodeId}`);
+      const filePath =
+        existing[0]?.filePath ?? path.join(nodesDir, recordStoreDay(merged.recordedAt), `${merged.nodeId}.json`);
+      await writeJsonFileAtomic(filePath, merged);
+      for (const duplicate of existing.slice(1)) {
+        await unlink(duplicate.filePath).catch((error) => {
+          if (!isNotFoundError(error)) throw error;
+        });
+      }
+      filePaths.push(filePath);
+    }
+    return filePaths;
+  });
+}
+
+export async function upsertAbstractionNode(options: {
+  memoryDir: string;
+  abstractionNodeStoreDir?: string;
+  node: AbstractionNode;
+}): Promise<string> {
+  const [filePath] = await upsertAbstractionNodes({ ...options, nodes: [options.node] });
+  if (!filePath) throw new Error("abstraction node upsert did not write a file");
+  return filePath;
+}
+
 export async function getAbstractionNodeStoreStatus(options: {
   memoryDir: string;
   abstractionNodeStoreDir?: string;
@@ -117,7 +293,7 @@ export async function getAbstractionNodeStoreStatus(options: {
 }): Promise<AbstractionNodeStoreStatus> {
   const rootDir = resolveAbstractionNodeStoreDir(options.memoryDir, options.abstractionNodeStoreDir);
   const nodesDir = path.join(rootDir, "nodes");
-  const files = await listJsonFiles(nodesDir);
+  const files = await listJsonFilesStrict(nodesDir, { allowMissingDirectory: true });
   const nodes: AbstractionNode[] = [];
   const invalidNodes: Array<{ path: string; error: string }> = [];
 
@@ -132,7 +308,9 @@ export async function getAbstractionNodeStoreStatus(options: {
     }
   }
 
-  nodes.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));
+  nodes.sort(
+    (a, b) => Date.parse(b.recordedAt) - Date.parse(a.recordedAt) || compareDeterministicStrings(a.nodeId, b.nodeId)
+  );
 
   const byKind: Partial<Record<AbstractionNodeKind, number>> = {};
   const byLevel: Partial<Record<AbstractionLevel, number>> = {};