@remnic/core 9.7.15 → 9.8.0

package/dist/{types-Cg8q7W7_.d.ts → types-D_fG2ix8.d.ts}

@@ -1,4 +1,6 @@
 import { LcmMessagePartInput, MessagePartSourceFormat } from './message-parts/index.js';
+import { BoundedJsonlStateConfig } from './bounded-jsonl-state.js';
+import './types-continuity.js';
 
 interface BulkImportSource {
     turns: ImportTurn[];
@@ -1082,7 +1084,7 @@ interface SemanticChunkingConfigShape {
     embeddingBatchSize: number;
     fallbackToRecursive: boolean;
 }
-interface PluginConfig {
+interface PluginConfig extends BoundedJsonlStateConfig {
     openaiApiKey: string | undefined;
     openaiBaseUrl: string | undefined;
     model: string;
@@ -1090,6 +1092,14 @@ interface PluginConfig {
     triggerMode: TriggerMode;
     bufferMaxTurns: number;
     bufferMaxMinutes: number;
+    /**
+     * Debounce window (ms) for persisting the smart buffer to `state/buffer.json`
+     * (issue #1909). Steady-state buffering coalesces the whole-state serialize
+     * onto a trailing-edge timer instead of rewriting on every turn; extraction
+     * trigger/clear and shutdown still force an immediate flush. Default 3000.
+     * `0` restores the legacy save-every-turn behavior exactly.
+     */
+    bufferSaveDebounceMs: number;
     /**
      * Surprise-gated buffer flush (issue #563, D-MEM).
      *
@@ -1138,6 +1148,7 @@ interface PluginConfig {
     qmdEnabled: boolean;
     qmdCollection: string;
     qmdMaxResults: number;
+    qmdEmbeddingBacklogThreshold: number;
     qmdColdTierEnabled?: boolean;
     qmdColdCollection?: string;
     qmdColdMaxResults?: number;
@@ -1401,12 +1412,8 @@ interface PluginConfig {
      * whose resolved taxonomy category is not in this list never qualify.
      */
     recallDirectAnswerEligibleTaxonomyBuckets: string[];
-    /**
-     * Cross-namespace query-budget limiter (issue #565 PR 4/5). When true,
-     * a principal that issues a burst of recalls against namespaces other
-     * than their own is throttled once its per-window count crosses
-     * `recallCrossNamespaceBudgetHardLimit`. Default false — ships disabled.
-     */
+    /** Cross-namespace query-budget limiter (issue #565 PR 4/5): throttle a
+     *  principal's cross-namespace recall burst past the hard limit. Default false. */
     recallCrossNamespaceBudgetEnabled: boolean;
     /** Rolling window in milliseconds over which cross-namespace reads are counted. */
     recallCrossNamespaceBudgetWindowMs: number;
@@ -1418,6 +1425,10 @@ interface PluginConfig {
     recallCrossNamespaceBudgetSoftLimit: number;
     /** Hard threshold — calls past this count are denied in the window. */
     recallCrossNamespaceBudgetHardLimit: number;
+    /** Max concurrent recalls per principal; `0` = unlimited. Default 4 (#1906). */
+    recallMaxConcurrentPerPrincipal: number;
+    /** Coalesce identical concurrent recalls per principal; each caller gets its own clone. Default true. */
+    recallSingleFlightEnabled: boolean;
     /**
      * When true, recall multiplies candidate scores by the Memory Worth
      * factor computed from `mw_success` / `mw_fail` counters on each
@@ -1427,6 +1438,14 @@ interface PluginConfig {
      * once the benchmark shows precision tie-or-win.
      */
     recallMemoryWorthFilterEnabled: boolean;
+    /**
+     * When false, the Trust/Memory-Worth recall stage skips its corpus-level
+     * fallback (a per-namespace `readAllMemories`-derived counter/signal map)
+     * and relies only on frontmatter already loaded on the hot recall path plus
+     * a bounded-parallel per-candidate direct read — fully O(candidates)
+     * (issue #1905). Default true keeps the corpus fallback reachable.
+     */
+    recallTrustStageCorpusFallbackEnabled: boolean;
     /**
      * Serve `StorageManager.readAllMemories()` from a version-keyed in-process
      * cache of the full parsed corpus (issue #1902). Default true. When on, a
@@ -1548,6 +1567,8 @@ interface PluginConfig {
     activeRecallQueryMode: ActiveRecallQueryMode;
     activeRecallPromptStyle: ActiveRecallPromptStyle;
     activeRecallCustomInstruction: string | null;
+    activeRecallPromptReplacement: string | null;
+    activeRecallPromptOverride: string | null;
     activeRecallPromptAppend: string | null;
     activeRecallMaxSummaryChars: number;
     activeRecallRecentUserTurns: number;
@@ -2189,6 +2210,8 @@ interface PluginConfig {
     entityRetrievalRecentTurns: number;
     entitySchemas?: Record<string, EntitySchemaDefinition>;
     recallBudgetChars: number;
+    /** Maximum fraction of the total recall budget that the behavioral profile may consume. */
+    recallProfileMaxRatio: number;
     recallOuterTimeoutMs: number;
     recallCoreDeadlineMs: number;
     recallEnrichmentDeadlineMs: number;
@@ -2267,6 +2290,7 @@ interface PluginConfig {
     compressionGuidelineSemanticTimeoutMs: number;
     maxProactiveQuestionsPerExtraction: number;
     proactiveExtractionTimeoutMs: number;
+    proactiveExtractionSkipWhenLocalLlmBusy: boolean;
     proactiveExtractionMaxTokens: number;
     extractionMaxOutputTokens: number;
     proactiveExtractionCategoryAllowlist?: MemoryCategory[];
@@ -2417,11 +2441,9 @@ interface PluginConfig {
     /** Confidence threshold for the "below visibility" telemetry counter. Default 0.2. */
     graphEdgeDecayVisibilityThreshold: number;
     /**
-     * Issue #681 PR 3/3 — minimum edge confidence required for an edge to be
-     * traversed during spreading activation. Edges with `confidence` below this
-     * floor are pruned and contribute neither activation nor downstream
-     * neighbors. Legacy edges without `confidence` are treated as 1.0 so they
-     * always pass the floor. Range `[0, 1]`; default `0.2`.
+     * Issue #681 PR 3/3 — minimum edge confidence to traverse during spreading
+     * activation. Edges below are pruned (no activation, no downstream neighbors);
+     * legacy edges without `confidence` are treated as 1.0. Range `[0, 1]`; default `0.2`.
      */
     graphTraversalConfidenceFloor: number;
     /**
@@ -3590,6 +3612,8 @@ interface QmdSearchResult {
     line?: number;
     explain?: QmdSearchExplain;
     transport?: "daemon" | "subprocess" | "hybrid" | "scoped_prefilter";
+    /** Namespace that owned this result when returned by a namespace fanout search. */
+    namespace?: string;
 }
 interface QmdSearchExplain {
     ftsScores?: number[];
@@ -3751,59 +3775,11 @@ interface CompressionGuidelineOptimizerState {
     actionSummaries?: CompressionGuidelineOptimizerActionSummary[];
     ruleUpdates?: CompressionGuidelineOptimizerRuleUpdate[];
 }
-type ContinuityIncidentState = "open" | "closed";
-interface ContinuityIncidentRecord {
-    id: string;
-    state: ContinuityIncidentState;
-    openedAt: string;
-    updatedAt: string;
-    triggerWindow?: string;
-    symptom: string;
-    suspectedCause?: string;
-    fixApplied?: string;
-    verificationResult?: string;
-    preventiveRule?: string;
-    closedAt?: string;
-    filePath?: string;
-}
-interface ContinuityIncidentOpenInput {
-    triggerWindow?: string;
-    symptom: string;
-    suspectedCause?: string;
-}
-interface ContinuityIncidentCloseInput {
-    fixApplied: string;
-    verificationResult: string;
-    preventiveRule?: string;
-}
-type ContinuityLoopCadence = "daily" | "weekly" | "monthly" | "quarterly";
-type ContinuityLoopStatus = "active" | "paused" | "retired";
-interface ContinuityImprovementLoop {
-    id: string;
-    cadence: ContinuityLoopCadence;
-    purpose: string;
-    status: ContinuityLoopStatus;
-    killCondition: string;
-    lastReviewed: string;
-    notes?: string;
-}
-interface ContinuityLoopUpsertInput {
-    id: string;
-    cadence: ContinuityLoopCadence;
-    purpose: string;
-    status: ContinuityLoopStatus;
-    killCondition: string;
-    lastReviewed?: string;
-    notes?: string;
-}
-interface ContinuityLoopReviewInput {
-    status?: ContinuityLoopStatus;
-    notes?: string;
-    reviewedAt?: string;
-}
+
 /** Entry in the access tracking buffer (batched updates) */
 interface AccessTrackingEntry {
     memoryId: string;
+    memoryPath?: string;
     newCount: number;
     lastAccessed: string;
 }
@@ -3948,4 +3924,4 @@ interface HourlySummary {
     generatedAt: string;
 }
 
-export { type BulkImportOptions as $, type ActiveRecallChatType as A, type BehaviorSignalEvent as B, type CalendarSource 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 DaySummaryResult as J, type ExtractionFailureClass as K, type LiveConnectorsConfig as L, type MemoryFile as M, type ProvenanceSource as N, type TrustWeights as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallDisclosure as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type ConversationThread as U, type LifecycleState as V, type VerificationState as W, type PolicyClass as X, type ImportanceLevel as Y, type BufferSurpriseEvent as Z, type ImportTurn as _, type DreamsRunResult as a, type WearableCleanupSettings as a$, type BulkImportSource as a0, type BulkImportResult as a1, type SecretRef as a2, type AgentAccessAuthToken as a3, type CompressionGuidelineOptimizerEventCounts as a4, type CompressionGuidelineOptimizerActionSummary as a5, type CompressionGuidelineOptimizerRuleUpdate as a6, type MemoryActionType as a7, type MemoryActionEvent as a8, type CompressionGuidelineOptimizerState as a9, type FileHygieneConfig as aA, type EntityRelationship as aB, type EntityActivityEntry as aC, type AccessTrackingEntry as aD, type MemorySummary as aE, type EntityTimelineEntry as aF, type CodingContext as aG, type DreamsStatusResult as aH, type ScopeProfileConfig as aI, type ScopeProfileLayerId as aJ, type ScopeProfilePromotionTarget as aK, type WearableConversation as aL, type WearableSourceSettings as aM, type WearableNativeMemory as aN, type WearableMemoryMode as aO, type WearableSourceConnector as aP, type WearablesConfig as aQ, type WearableSyncSummary as aR, type WearableSourceStatus as aS, type WearableDayTranscript as aT, type WearableCorrectionRule as aU, type RecallSectionConfig as aV, type BootstrapOptions as aW, type BootstrapResult as aX, type ConsolidationObservation as aY, type CodingModeConfig as aZ, type CodingKnowledgeConfig as a_, type EntityMention as aa, type EntitySchemaDefinition as ab, type EntitySchemaSectionDefinition as ac, type EntityStructuredSection as ad, type ContinuityIncidentRecord as ae, type ContinuityIncidentCloseInput as af, type ContinuityIncidentOpenInput as ag, type ContinuityImprovementLoop as ah, type ContinuityLoopReviewInput as ai, type ContinuityLoopUpsertInput as aj, type ImportanceScore as ak, type MemoryIntent as al, type MemoryActionEligibilityContext as am, type MemoryActionPolicyResult as an, type MemoryLifecycleEventType as ao, type MemoryLifecycleStateSummary as ap, type ModelProviderConfig as aq, type NativeKnowledgeConfig as ar, type ProvenanceConfig as as, type RetrievalTier as at, type SignalScanResult as au, type TopicScore as av, type QmdSearchExplain as aw, type MemoryLink as ax, type BufferState as ay, type MetaState as az, type RecallPlanMode as b, type ExtractionPassSource as b$, type WearableFusionConfig as b0, type WearableDayTranscriptMeta as b1, type BriefingConfig as b2, type BriefingOpenCommitment as b3, type BriefingWindow as b4, type BulkImportError as b5, type BulkImportSourceAdapter as b6, type CodexCompatConfig as b7, DEFAULT_RECALL_DISCLOSURE as b8, type ExtractedFact as b9, type CodexCompactionFlushMode as bA, type CodexConnectorConfig as bB, type CodingGraphLspConfig as bC, type CompressionGuidelineActivationState as bD, type CompressionGuidelineOptimizerSourceWindow as bE, type ConfidenceTier as bF, type ConsolidationAction as bG, type ConsolidationItem as bH, type ContinuityIncidentState as bI, type ContinuityLoopCadence as bJ, type ContinuityLoopStatus as bK, type ContradictionScanConfig as bL, type CronConversationRecallMode as bM, type CronRecallMode as bN, type DreamingConfig as bO, type DreamingNarrativePromptStyle as bP, type DreamsDeepSleepConfig as bQ, type DreamsLightSleepConfig as bR, type DreamsPhaseStatus as bS, type DreamsPhasesConfig as bT, type DreamsRemConfig as bU, type EngramTraceEvent as bV, type ExtractedProcedureStep as bW, type ExtractedQuestion as bX, type ExtractedReasoningTrace as bY, type ExtractedReasoningTraceStep as bZ, type ExtractedRelationship as b_, type ImportSourceRole as ba, type ImportTurnValidationIssue as bb, type MemoryActionEligibilitySource as bc, type MemoryObservation as bd, type MemoryScope as be, RECALL_DISCLOSURE_LEVELS as bf, type WearableAuthCheck as bg, type WearableFetchOptions as bh, type WearableFetchPage as bi, type WearableNativeMemoryPage as bj, type WearableTranscriptSegment as bk, isImportRole as bl, isRecallDisclosure as bm, parseIsoTimestamp as bn, validateImportTurn as bo, type AgentAccessHttpConfig as bp, type AgentDefaultsConfig as bq, type AgentPersona as br, type BehaviorLoopAdjustment as bs, type BehaviorSignalDirection as bt, type BehaviorSignalType as bu, type BriefingCalendarSourceError as bv, type BufferEntryState as bw, type CaptureMode as bx, type ChatConfig as by, type CodexCliReasoningEffort as bz, type ActiveRecallQueryMode as c, type GitHubLiveConnectorConfig as c0, type GmailLiveConnectorConfig as c1, type GoogleDriveLiveConnectorConfig as c2, type HeartbeatConfig as c3, type HeartbeatDetectionMode as c4, type LlmTraceCallback as c5, type LlmTraceEvent as c6, type MemoryActionOutcome as c7, type MemoryActionPolicyDecision as c8, type MemoryActionStatus as c9, type SlotMismatchMode as cA, type TriggerMode as cB, confidenceTier as cC, type MemoryLinkType as ca, type MemoryOsPresetName as cb, type ModelApi as cc, type ModelDefinitionConfig as cd, type ModelProviderAuthMode as ce, type NamespacePolicy as cf, type NativeKnowledgeFolderRuleConfig as cg, type NativeKnowledgeObsidianVaultConfig as ch, type NativeKnowledgeOpenClawWorkspaceConfig as ci, type NotionLiveConnectorConfig as cj, type PrincipalFromSessionKeyMode as ck, type PrincipalRule as cl, type ProceduralConfig as cm, type QuestionEntry as cn, type ReasoningEffort as co, type RecallPipelineConfig as cp, type RecallTraceEvent as cq, type RelevanceFeedback as cr, SPECULATIVE_TTL_DAYS as cs, type ScopeProfileAutoPromoteConfig as ct, type ScopeProfileTeamProjectConfig as cu, type ScopeTeamConfig as cv, type ScoredEntity as cw, type SemanticChunkingConfigShape as cx, type SignalLevel as cy, type SlotBehaviorConfig as cz, type ActiveRecallPromptStyle as d, type ActiveRecallThinking as e, type ActiveRecallModelFallbackPolicy as f, type BehaviorLoopPolicyState as g, type BriefingSections as h, type BriefingFollowup as i, type BriefingFocus as j, type CalendarEvent as k, type BriefingActiveThread as l, type BriefingResult as m, type BriefingRecentEntity as n, type BufferTurn as o, type MemoryFrontmatter as p, type Checkpoint as q, type AgentPersonaModelConfig as r, type RecallTierExplain as s, type SourceConnectorProvenance as t, type MemoryCategory as u, type MemoryStatus as v, type MemoryProjectionCurrentState as w, type MemoryLifecycleEvent as x, type ExtractionResult as y, type ConsolidationResult as z };
+export { type BehaviorSignalEvent as $, type ActiveRecallChatType as A, type BriefingSections as B, type CalendarSource 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 ExtractionResult as J, type ConsolidationResult as K, type LiveConnectorsConfig as L, type MemoryFile as M, type DaySummaryResult as N, type ExtractionFailureClass 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 ImportanceLevel as _, type DreamsRunResult as a, type BulkImportError as a$, type BufferSurpriseEvent as a0, type ImportTurn as a1, type BulkImportOptions as a2, type BulkImportSource as a3, type BulkImportResult as a4, type SecretRef as a5, type AgentAccessAuthToken as a6, type CompressionGuidelineOptimizerEventCounts as a7, type CompressionGuidelineOptimizerActionSummary as a8, type CompressionGuidelineOptimizerRuleUpdate as a9, type EntityActivityEntry as aA, type AccessTrackingEntry as aB, type MemorySummary as aC, type CodingContext as aD, type DreamsStatusResult as aE, type WearableConversation as aF, type WearableSourceSettings as aG, type WearableNativeMemory as aH, type WearableMemoryMode as aI, type WearableSourceConnector as aJ, type WearablesConfig as aK, type WearableSyncSummary as aL, type WearableSourceStatus as aM, type WearableDayTranscript as aN, type WearableCorrectionRule as aO, type RecallSectionConfig as aP, type BootstrapOptions as aQ, type BootstrapResult as aR, type ConsolidationObservation as aS, type CodingModeConfig as aT, type CodingKnowledgeConfig as aU, type WearableCleanupSettings as aV, type WearableFusionConfig as aW, type WearableDayTranscriptMeta as aX, type BriefingConfig as aY, type BriefingOpenCommitment as aZ, type BriefingWindow as a_, type MemoryActionType as aa, type MemoryActionEvent as ab, type CompressionGuidelineOptimizerState as ac, type EntityMention as ad, type EntitySchemaDefinition as ae, type EntitySchemaSectionDefinition as af, type EntityStructuredSection as ag, type ImportanceScore as ah, type MemoryIntent as ai, type MemoryActionEligibilityContext as aj, type MemoryActionPolicyResult as ak, type MemoryLifecycleEventType as al, type MemoryLifecycleStateSummary as am, type ModelProviderConfig as an, type NativeKnowledgeConfig as ao, type ProvenanceConfig as ap, type RetrievalTier as aq, type SignalScanResult as ar, type TopicScore as as, type QmdSearchExplain as at, type EntityTimelineEntry as au, type MemoryLink as av, type BufferState as aw, type MetaState as ax, type FileHygieneConfig as ay, type EntityRelationship as az, type RecallDisclosure as b, type MemoryActionPolicyDecision as b$, type BulkImportSourceAdapter as b0, type CodexCompatConfig as b1, DEFAULT_RECALL_DISCLOSURE as b2, type ExtractedFact as b3, type ImportSourceRole as b4, type ImportTurnValidationIssue as b5, type MemoryActionEligibilitySource as b6, type MemoryObservation as b7, type MemoryScope as b8, RECALL_DISCLOSURE_LEVELS as b9, type ConsolidationAction as bA, type ConsolidationItem as bB, type ContradictionScanConfig as bC, type CronConversationRecallMode as bD, type CronRecallMode as bE, type DreamingConfig as bF, type DreamingNarrativePromptStyle as bG, type DreamsDeepSleepConfig as bH, type DreamsLightSleepConfig as bI, type DreamsPhaseStatus as bJ, type DreamsPhasesConfig as bK, type DreamsRemConfig as bL, type EngramTraceEvent as bM, type ExtractedProcedureStep as bN, type ExtractedQuestion as bO, type ExtractedReasoningTrace as bP, type ExtractedReasoningTraceStep as bQ, type ExtractedRelationship as bR, type ExtractionPassSource as bS, type GitHubLiveConnectorConfig as bT, type GmailLiveConnectorConfig as bU, type GoogleDriveLiveConnectorConfig as bV, type HeartbeatConfig as bW, type HeartbeatDetectionMode as bX, type LlmTraceCallback as bY, type LlmTraceEvent as bZ, type MemoryActionOutcome as b_, type WearableAuthCheck as ba, type WearableFetchOptions as bb, type WearableFetchPage as bc, type WearableNativeMemoryPage as bd, type WearableTranscriptSegment as be, isImportRole as bf, isRecallDisclosure as bg, parseIsoTimestamp as bh, validateImportTurn as bi, type AgentAccessHttpConfig as bj, type AgentDefaultsConfig as bk, type AgentPersona as bl, type BehaviorLoopAdjustment as bm, type BehaviorSignalDirection as bn, type BehaviorSignalType as bo, type BriefingCalendarSourceError as bp, type BufferEntryState as bq, type CaptureMode as br, type ChatConfig as bs, type CodexCliReasoningEffort as bt, type CodexCompactionFlushMode as bu, type CodexConnectorConfig as bv, type CodingGraphLspConfig as bw, type CompressionGuidelineActivationState as bx, type CompressionGuidelineOptimizerSourceWindow as by, type ConfidenceTier as bz, type ActiveRecallQueryMode as c, type MemoryActionStatus as c0, type MemoryLinkType as c1, type MemoryOsPresetName as c2, type ModelApi as c3, type ModelDefinitionConfig as c4, type ModelProviderAuthMode as c5, type NamespacePolicy as c6, type NativeKnowledgeFolderRuleConfig as c7, type NativeKnowledgeObsidianVaultConfig as c8, type NativeKnowledgeOpenClawWorkspaceConfig as c9, type NotionLiveConnectorConfig as ca, type PrincipalFromSessionKeyMode as cb, type PrincipalRule as cc, type ProceduralConfig as cd, type QuestionEntry as ce, type ReasoningEffort as cf, type RecallPipelineConfig as cg, type RecallTraceEvent as ch, type RelevanceFeedback as ci, SPECULATIVE_TTL_DAYS as cj, type ScopeProfileAutoPromoteConfig as ck, type ScopeProfileTeamProjectConfig as cl, type ScopeTeamConfig as cm, type ScoredEntity as cn, type SemanticChunkingConfigShape as co, type SignalLevel as cp, type SlotBehaviorConfig as cq, type SlotMismatchMode as cr, type TriggerMode as cs, confidenceTier as ct, type ActiveRecallPromptStyle as d, type ActiveRecallThinking as e, type ActiveRecallModelFallbackPolicy as f, type RecallTierExplain as g, type BriefingFollowup as h, type BriefingFocus as i, type CalendarEvent as j, type BriefingActiveThread as k, type BriefingResult as l, type BriefingRecentEntity as m, type BufferTurn as n, type MemoryFrontmatter as o, type Checkpoint as p, type AgentPersonaModelConfig as q, type SourceConnectorProvenance as r, type ScopeProfileConfig as s, type ScopeProfileLayerId as t, type ScopeProfilePromotionTarget as u, type BehaviorLoopPolicyState as v, type MemoryCategory as w, type MemoryStatus as x, type MemoryProjectionCurrentState as y, type MemoryLifecycleEvent as z };

package/dist/types-continuity.d.ts

@@ -0,0 +1,52 @@
+type ContinuityIncidentState = "open" | "closed";
+interface ContinuityIncidentRecord {
+    id: string;
+    state: ContinuityIncidentState;
+    openedAt: string;
+    updatedAt: string;
+    triggerWindow?: string;
+    symptom: string;
+    suspectedCause?: string;
+    fixApplied?: string;
+    verificationResult?: string;
+    preventiveRule?: string;
+    closedAt?: string;
+    filePath?: string;
+}
+interface ContinuityIncidentOpenInput {
+    triggerWindow?: string;
+    symptom: string;
+    suspectedCause?: string;
+}
+interface ContinuityIncidentCloseInput {
+    fixApplied: string;
+    verificationResult: string;
+    preventiveRule?: string;
+}
+type ContinuityLoopCadence = "daily" | "weekly" | "monthly" | "quarterly";
+type ContinuityLoopStatus = "active" | "paused" | "retired";
+interface ContinuityImprovementLoop {
+    id: string;
+    cadence: ContinuityLoopCadence;
+    purpose: string;
+    status: ContinuityLoopStatus;
+    killCondition: string;
+    lastReviewed: string;
+    notes?: string;
+}
+interface ContinuityLoopUpsertInput {
+    id: string;
+    cadence: ContinuityLoopCadence;
+    purpose: string;
+    status: ContinuityLoopStatus;
+    killCondition: string;
+    lastReviewed?: string;
+    notes?: string;
+}
+interface ContinuityLoopReviewInput {
+    status?: ContinuityLoopStatus;
+    notes?: string;
+    reviewedAt?: string;
+}
+
+export type { ContinuityImprovementLoop, ContinuityIncidentCloseInput, ContinuityIncidentOpenInput, ContinuityIncidentRecord, ContinuityIncidentState, ContinuityLoopCadence, ContinuityLoopReviewInput, ContinuityLoopStatus, ContinuityLoopUpsertInput };

package/dist/types-continuity.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types-continuity.js.map

package/dist/types-continuity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types.d.ts

@@ -1,2 +1,4 @@
-export { aD as AccessTrackingEntry, A as ActiveRecallChatType, f as ActiveRecallModelFallbackPolicy, d as ActiveRecallPromptStyle, c as ActiveRecallQueryMode, e as ActiveRecallThinking, a3 as AgentAccessAuthToken, bp as AgentAccessHttpConfig, bq as AgentDefaultsConfig, br as AgentPersona, r as AgentPersonaModelConfig, bs as BehaviorLoopAdjustment, g as BehaviorLoopPolicyState, bt as BehaviorSignalDirection, B as BehaviorSignalEvent, bu as BehaviorSignalType, aW as BootstrapOptions, aX as BootstrapResult, l as BriefingActiveThread, bv as BriefingCalendarSourceError, b2 as BriefingConfig, j as BriefingFocus, i as BriefingFollowup, b3 as BriefingOpenCommitment, n as BriefingRecentEntity, m as BriefingResult, h as BriefingSections, b4 as BriefingWindow, bw as BufferEntryState, ay as BufferState, Z as BufferSurpriseEvent, o as BufferTurn, k as CalendarEvent, C as CalendarSource, bx as CaptureMode, by as ChatConfig, q as Checkpoint, bz as CodexCliReasoningEffort, bA as CodexCompactionFlushMode, b7 as CodexCompatConfig, bB as CodexConnectorConfig, aG as CodingContext, bC as CodingGraphLspConfig, a_ as CodingKnowledgeConfig, aZ as CodingModeConfig, bD as CompressionGuidelineActivationState, a5 as CompressionGuidelineOptimizerActionSummary, a4 as CompressionGuidelineOptimizerEventCounts, a6 as CompressionGuidelineOptimizerRuleUpdate, bE as CompressionGuidelineOptimizerSourceWindow, a9 as CompressionGuidelineOptimizerState, bF as ConfidenceTier, bG as ConsolidationAction, bH as ConsolidationItem, aY as ConsolidationObservation, z as ConsolidationResult, ah as ContinuityImprovementLoop, af as ContinuityIncidentCloseInput, ag as ContinuityIncidentOpenInput, ae as ContinuityIncidentRecord, bI as ContinuityIncidentState, bJ as ContinuityLoopCadence, ai as ContinuityLoopReviewInput, bK as ContinuityLoopStatus, aj as ContinuityLoopUpsertInput, bL as ContradictionScanConfig, U as ConversationThread, bM as CronConversationRecallMode, bN as CronRecallMode, b8 as DEFAULT_RECALL_DISCLOSURE, J as DaySummaryResult, bO as DreamingConfig, bP as DreamingNarrativePromptStyle, bQ as DreamsDeepSleepConfig, bR as DreamsLightSleepConfig, D as DreamsPhase, bS as DreamsPhaseStatus, bT as DreamsPhasesConfig, bU as DreamsRemConfig, a as DreamsRunResult, aH as DreamsStatusResult, bV as EngramTraceEvent, aC as EntityActivityEntry, E as EntityFile, aa as EntityMention, aB as EntityRelationship, ab as EntitySchemaDefinition, ac as EntitySchemaSectionDefinition, ad as EntityStructuredSection, aF as EntityTimelineEntry, b9 as ExtractedFact, bW as ExtractedProcedureStep, bX as ExtractedQuestion, bY as ExtractedReasoningTrace, bZ as ExtractedReasoningTraceStep, b_ as ExtractedRelationship, K as ExtractionFailureClass, b$ as ExtractionPassSource, y as ExtractionResult, F as FaithfulnessFrontmatter, aA as FileHygieneConfig, G as GatewayConfig, c0 as GitHubLiveConnectorConfig, c1 as GmailLiveConnectorConfig, c2 as GoogleDriveLiveConnectorConfig, c3 as HeartbeatConfig, c4 as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, Y as ImportanceLevel, ak as ImportanceScore, V as LifecycleState, L as LiveConnectorsConfig, c5 as LlmTraceCallback, c6 as LlmTraceEvent, am as MemoryActionEligibilityContext, bc as MemoryActionEligibilitySource, a8 as MemoryActionEvent, c7 as MemoryActionOutcome, c8 as MemoryActionPolicyDecision, an as MemoryActionPolicyResult, c9 as MemoryActionStatus, a7 as MemoryActionType, u as MemoryCategory, M as MemoryFile, p as MemoryFrontmatter, al as MemoryIntent, x as MemoryLifecycleEvent, ao as MemoryLifecycleEventType, ap as MemoryLifecycleStateSummary, ax as MemoryLink, ca as MemoryLinkType, bd as MemoryObservation, cb as MemoryOsPresetName, w as MemoryProjectionCurrentState, be as MemoryScope, v as MemoryStatus, aE as MemorySummary, az as MetaState, cc as ModelApi, cd as ModelDefinitionConfig, ce as ModelProviderAuthMode, aq as ModelProviderConfig, cf as NamespacePolicy, ar as NativeKnowledgeConfig, cg as NativeKnowledgeFolderRuleConfig, ch as NativeKnowledgeObsidianVaultConfig, ci as NativeKnowledgeOpenClawWorkspaceConfig, cj as NotionLiveConnectorConfig, P as PluginConfig, X as PolicyClass, ck as PrincipalFromSessionKeyMode, cl as PrincipalRule, cm as ProceduralConfig, as as ProvenanceConfig, N as ProvenanceSource, aw as QmdSearchExplain, Q as QmdSearchResult, cn as QuestionEntry, bf as RECALL_DISCLOSURE_LEVELS, co as ReasoningEffort, R as RecallDisclosure, cp as RecallPipelineConfig, b as RecallPlanMode, aV as RecallSectionConfig, s as RecallTierExplain, cq as RecallTraceEvent, cr as RelevanceFeedback, at as RetrievalTier, cs as SPECULATIVE_TTL_DAYS, ct as ScopeProfileAutoPromoteConfig, aI as ScopeProfileConfig, aJ as ScopeProfileLayerId, aK as ScopeProfilePromotionTarget, cu as ScopeProfileTeamProjectConfig, cv as ScopeTeamConfig, cw as ScoredEntity, a2 as SecretRef, cx as SemanticChunkingConfigShape, S as SessionObserverBandConfig, cy as SignalLevel, au as SignalScanResult, cz as SlotBehaviorConfig, cA as SlotMismatchMode, t as SourceConnectorProvenance, av as TopicScore, T as TranscriptEntry, cB as TriggerMode, O as TrustWeights, W as VerificationState, cC as confidenceTier, bm as isRecallDisclosure } from './types-Cg8q7W7_.js';
+export { aB as AccessTrackingEntry, A as ActiveRecallChatType, f as ActiveRecallModelFallbackPolicy, d as ActiveRecallPromptStyle, c as ActiveRecallQueryMode, e as ActiveRecallThinking, a6 as AgentAccessAuthToken, bj as AgentAccessHttpConfig, bk as AgentDefaultsConfig, bl as AgentPersona, q as AgentPersonaModelConfig, bm as BehaviorLoopAdjustment, v as BehaviorLoopPolicyState, bn as BehaviorSignalDirection, $ as BehaviorSignalEvent, bo as BehaviorSignalType, aQ as BootstrapOptions, aR as BootstrapResult, k as BriefingActiveThread, bp as BriefingCalendarSourceError, aY as BriefingConfig, i as BriefingFocus, h as BriefingFollowup, aZ as BriefingOpenCommitment, m as BriefingRecentEntity, l as BriefingResult, B as BriefingSections, a_ as BriefingWindow, bq as BufferEntryState, aw as BufferState, a0 as BufferSurpriseEvent, n as BufferTurn, j as CalendarEvent, C as CalendarSource, br as CaptureMode, bs as ChatConfig, p as Checkpoint, bt as CodexCliReasoningEffort, bu as CodexCompactionFlushMode, b1 as CodexCompatConfig, bv as CodexConnectorConfig, aD as CodingContext, bw as CodingGraphLspConfig, aU as CodingKnowledgeConfig, aT as CodingModeConfig, bx as CompressionGuidelineActivationState, a8 as CompressionGuidelineOptimizerActionSummary, a7 as CompressionGuidelineOptimizerEventCounts, a9 as CompressionGuidelineOptimizerRuleUpdate, by as CompressionGuidelineOptimizerSourceWindow, ac as CompressionGuidelineOptimizerState, bz as ConfidenceTier, bA as ConsolidationAction, bB as ConsolidationItem, aS as ConsolidationObservation, K as ConsolidationResult, bC as ContradictionScanConfig, W as ConversationThread, bD as CronConversationRecallMode, bE as CronRecallMode, b2 as DEFAULT_RECALL_DISCLOSURE, N as DaySummaryResult, bF as DreamingConfig, bG as DreamingNarrativePromptStyle, bH as DreamsDeepSleepConfig, bI as DreamsLightSleepConfig, D as DreamsPhase, bJ as DreamsPhaseStatus, bK as DreamsPhasesConfig, bL as DreamsRemConfig, a as DreamsRunResult, aE as DreamsStatusResult, bM as EngramTraceEvent, aA as EntityActivityEntry, E as EntityFile, ad as EntityMention, az as EntityRelationship, ae as EntitySchemaDefinition, af as EntitySchemaSectionDefinition, ag as EntityStructuredSection, au as EntityTimelineEntry, b3 as ExtractedFact, bN as ExtractedProcedureStep, bO as ExtractedQuestion, bP as ExtractedReasoningTrace, bQ as ExtractedReasoningTraceStep, bR as ExtractedRelationship, O as ExtractionFailureClass, bS as ExtractionPassSource, J as ExtractionResult, F as FaithfulnessFrontmatter, ay as FileHygieneConfig, G as GatewayConfig, bT as GitHubLiveConnectorConfig, bU as GmailLiveConnectorConfig, bV as GoogleDriveLiveConnectorConfig, bW as HeartbeatConfig, bX as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, _ as ImportanceLevel, ah as ImportanceScore, X as LifecycleState, L as LiveConnectorsConfig, bY as LlmTraceCallback, bZ as LlmTraceEvent, aj as MemoryActionEligibilityContext, b6 as MemoryActionEligibilitySource, ab as MemoryActionEvent, b_ as MemoryActionOutcome, b$ as MemoryActionPolicyDecision, ak as MemoryActionPolicyResult, c0 as MemoryActionStatus, aa as MemoryActionType, w as MemoryCategory, M as MemoryFile, o as MemoryFrontmatter, ai as MemoryIntent, z as MemoryLifecycleEvent, al as MemoryLifecycleEventType, am as MemoryLifecycleStateSummary, av as MemoryLink, c1 as MemoryLinkType, b7 as MemoryObservation, c2 as MemoryOsPresetName, y as MemoryProjectionCurrentState, b8 as MemoryScope, x as MemoryStatus, aC as MemorySummary, ax as MetaState, c3 as ModelApi, c4 as ModelDefinitionConfig, c5 as ModelProviderAuthMode, an as ModelProviderConfig, c6 as NamespacePolicy, ao as NativeKnowledgeConfig, c7 as NativeKnowledgeFolderRuleConfig, c8 as NativeKnowledgeObsidianVaultConfig, c9 as NativeKnowledgeOpenClawWorkspaceConfig, ca as NotionLiveConnectorConfig, P as PluginConfig, Z as PolicyClass, cb as PrincipalFromSessionKeyMode, cc as PrincipalRule, cd as ProceduralConfig, ap as ProvenanceConfig, U as ProvenanceSource, at as QmdSearchExplain, Q as QmdSearchResult, ce as QuestionEntry, b9 as RECALL_DISCLOSURE_LEVELS, cf as ReasoningEffort, b as RecallDisclosure, cg as RecallPipelineConfig, R as RecallPlanMode, aP as RecallSectionConfig, g as RecallTierExplain, ch as RecallTraceEvent, ci as RelevanceFeedback, aq as RetrievalTier, cj as SPECULATIVE_TTL_DAYS, ck as ScopeProfileAutoPromoteConfig, s as ScopeProfileConfig, t as ScopeProfileLayerId, u as ScopeProfilePromotionTarget, cl as ScopeProfileTeamProjectConfig, cm as ScopeTeamConfig, cn as ScoredEntity, a5 as SecretRef, co as SemanticChunkingConfigShape, S as SessionObserverBandConfig, cp as SignalLevel, ar as SignalScanResult, cq as SlotBehaviorConfig, cr as SlotMismatchMode, r as SourceConnectorProvenance, as as TopicScore, T as TranscriptEntry, cs as TriggerMode, V as TrustWeights, Y as VerificationState, ct as confidenceTier, bg as isRecallDisclosure } from './types-D_fG2ix8.js';
 import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+export { ContinuityImprovementLoop, ContinuityIncidentCloseInput, ContinuityIncidentOpenInput, ContinuityIncidentRecord, ContinuityIncidentState, ContinuityLoopCadence, ContinuityLoopReviewInput, ContinuityLoopStatus, ContinuityLoopUpsertInput } from './types-continuity.js';

package/dist/types.js

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

package/dist/utility-runtime.d.ts

@@ -1,6 +1,8 @@
 import { TierRoutingPolicy } from './tier-routing.js';
-import './types-Cg8q7W7_.js';
+import './types-D_fG2ix8.js';
 import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './types-continuity.js';
 import './lifecycle.js';
 
 interface UtilityRuntimeValues {

package/dist/utils/serialize-mutations.d.ts

@@ -78,6 +78,14 @@ interface HeldFileLockOptions {
      * production. Used to prove the pre-check prevents the rename entirely.
      */
     readonly onAfterReleaseRenameForTest?: () => Promise<void> | void;
+    /**
+     * Test seam (#2033): fires inside {@link HeldFileLockController.refresh} AFTER
+     * the ownership pre-check passes and BEFORE the `utimes` mtime bump —
+     * simulating a peer that deletes the lock (making the bump throw) or replaces
+     * it (a different owner the post-bump re-check must catch). No-op in
+     * production; proves refresh reports LOST rather than clobbering a peer.
+     */
+    readonly onBeforeRefreshUtimesForTest?: () => Promise<void> | void;
     /**
      * Best-effort hook for non-fatal lock warnings (heartbeat refresh failure,
      * release-time ownership check failure). Never throws into the caller. If
@@ -86,6 +94,27 @@ interface HeldFileLockOptions {
      */
     readonly onLockWarning?: (message: string, err: unknown) => void;
 }
+/**
+ * Control surface handed to a held-lock task so a long, CPU-bound critical
+ * section can re-assert ownership immediately before its destructive write.
+ */
+interface HeldFileLockController {
+    /**
+     * Re-verify THIS acquirer still owns the lock and, when it does, refresh the
+     * lock's mtime. Returns `true` only while we still hold it.
+     *
+     * The timer heartbeat cannot fire while a synchronous, CPU-bound section
+     * (a large parse/merge/sort/serialize) blocks the event loop, so a peer can
+     * judge the lock stale, break it, and start its own write within the stale
+     * window. A caller about to perform a destructive rewrite MUST call this
+     * first: `false` means the lock was stale-broken/replaced and the caller MUST
+     * abort rather than clobber the peer that now holds it; `true` also re-stamps
+     * the mtime so the bounded write that immediately follows cannot itself be
+     * judged stale mid-write. On the best-effort unlocked path (`acquired` was
+     * `false`) this always resolves `false` — there is no lock to hold.
+     */
+    refresh(): Promise<boolean>;
+}
 /**
  * Run `task` under an exclusive on-disk lock at `lockPath`.
  *
@@ -117,6 +146,6 @@ interface HeldFileLockOptions {
  * long scan — a scan-length lock makes concurrent writers time out and
  * silently drop work (catalog round 5, codex/cursor P2).
  */
-declare function withHeldFileLock<T>(lockPath: string, opts: HeldFileLockOptions, task: (acquired: boolean) => Promise<T>): Promise<T>;
+declare function withHeldFileLock<T>(lockPath: string, opts: HeldFileLockOptions, task: (acquired: boolean, lock: HeldFileLockController) => Promise<T>): Promise<T>;
 
-export { type HeldFileLockOptions, MutationSerializer, serializeMutations, withHeldFileLock };
+export { type HeldFileLockController, type HeldFileLockOptions, MutationSerializer, serializeMutations, withHeldFileLock };

package/dist/utils/serialize-mutations.js

@@ -2,7 +2,7 @@ import {
   MutationSerializer,
   serializeMutations,
   withHeldFileLock
-} from "../chunk-LTJAMRGI.js";
+} from "../chunk-WL5EBRDH.js";
 import "../chunk-PZ5AY32C.js";
 export {
   MutationSerializer,

package/dist/verified-recall.js

@@ -1,28 +1,32 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-Q5WG43OP.js";
-import "./chunk-2A3OXAP2.js";
-import "./chunk-ZBJMUXZH.js";
-import "./chunk-K7LOWSLU.js";
-import "./chunk-L2B3EE7B.js";
+} from "./chunk-MYFQ3ED4.js";
+import "./chunk-B7RWBZXW.js";
+import "./chunk-4BJQODZF.js";
 import "./chunk-B3ABVQ36.js";
-import "./chunk-5UZXUTVO.js";
-import "./chunk-VSMRDBFT.js";
-import "./chunk-LTJAMRGI.js";
-import "./chunk-EHK6KZHK.js";
+import "./chunk-2QMKMVHH.js";
+import "./chunk-DEBHXHJR.js";
+import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-4KJLYTLS.js";
-import "./chunk-SVOZFLIQ.js";
-import "./chunk-PBSAPHHA.js";
-import "./chunk-RULE4VG5.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-RHOZ5LLO.js";
+import "./chunk-V57NLO5P.js";
+import "./chunk-FF4KLI5W.js";
+import "./chunk-YVKF3HEW.js";
+import "./chunk-AVPXXV6J.js";
+import "./chunk-EGGE52UU.js";
+import "./chunk-GCASGYIO.js";
+import "./chunk-WL5EBRDH.js";
+import "./chunk-347WD2LE.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-ILGC6JH6.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-VA4WSW54.js";
+import "./chunk-CGASUJVP.js";
+import "./chunk-R3DJVOSM.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-5VQJBH2G.js";
@@ -31,25 +35,31 @@ import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-UXKMMNJD.js";
-import "./chunk-K2ZLHESQ.js";
-import "./chunk-VFSP73LP.js";
+import "./chunk-C23BYTJV.js";
+import "./chunk-QIEUU4UK.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-45GF7Y3V.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
-import "./chunk-OEHCMALU.js";
-import "./chunk-PHK3HARR.js";
-import "./chunk-4DJQYKMN.js";
+import "./chunk-5I4M26Q7.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-PQVCH2AE.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
-import "./chunk-37CTGERM.js";
-import "./chunk-J2HSAU72.js";
+import "./chunk-6MKAMLQL.js";
+import "./chunk-JAKIDQB2.js";
+import "./chunk-ZBJMUXZH.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-AIK5W3IW.js";
 import "./chunk-A6XUJE5D.js";
+import "./chunk-5UZXUTVO.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
-import "./chunk-6MKAMLQL.js";
-import "./chunk-JAKIDQB2.js";
+import "./chunk-SCCO46KZ.js";
+import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   compareVerifiedEpisodeResults,