@remnic/core 9.7.8 → 9.7.9

package/dist/search/index.js

@@ -2,7 +2,13 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-2FSHROYK.js";
+} from "../chunk-V53GJUSL.js";
+import {
+  LanceDbBackend
+} from "../chunk-N3JDIRBW.js";
+import {
+  MeilisearchBackend
+} from "../chunk-UTRJFDP2.js";
 import {
   NoopSearchBackend
 } from "../chunk-CYEPCZN5.js";
@@ -12,30 +18,24 @@ import {
 import {
   RemoteSearchBackend
 } from "../chunk-ZIDSD6VC.js";
-import {
-  EmbedHelper
-} from "../chunk-FNMFJWBY.js";
-import {
-  LanceDbBackend
-} from "../chunk-N3JDIRBW.js";
-import {
-  MeilisearchBackend
-} from "../chunk-UTRJFDP2.js";
 import {
   scanMemoryDir
 } from "../chunk-6SXVCD7W.js";
+import {
+  EmbedHelper
+} from "../chunk-FNMFJWBY.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-JI5AVXYO.js";
 import "../chunk-TN7THW5U.js";
 import "../chunk-R5VAVVHP.js";
 import "../chunk-FC77VUX5.js";
-import "../chunk-3F4N4WDH.js";
+import "../chunk-AHLPZ2SF.js";
 import "../chunk-WU46YPY6.js";
 import "../chunk-64UDOIMI.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
 import "../chunk-VSMRDBFT.js";
-import "../chunk-AWJ2FHCF.js";
+import "../chunk-X47LWMKA.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-BFPETA3S.js";
 import "../chunk-JUC24CTX.js";

package/dist/search/lancedb-backend.d.ts

@@ -1,6 +1,6 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
 import { EmbedHelper } from './embed-helper.js';
-import '../types-DpxqC8dI.js';
+import '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 import '../host-embedding-provider.js';
 

package/dist/search/meilisearch-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-DpxqC8dI.js';
+import '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 
 interface MeilisearchBackendOptions {

package/dist/search/noop-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-DpxqC8dI.js';
+import '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 
 /**

package/dist/search/orama-backend.d.ts

@@ -1,6 +1,6 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
 import { EmbedHelper } from './embed-helper.js';
-import '../types-DpxqC8dI.js';
+import '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 import '../host-embedding-provider.js';
 

package/dist/search/port.d.ts

@@ -1,4 +1,4 @@
-import { Q as QmdSearchResult } from '../types-DpxqC8dI.js';
+import { Q as QmdSearchResult } from '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 
 /** Alias so consumers don't need to reference "Qmd" in a backend-agnostic context. */

package/dist/search/remote-backend.d.ts

@@ -1,5 +1,5 @@
 import { SearchBackend, SearchQueryOptions, SearchExecutionOptions, SearchResult } from './port.js';
-import '../types-DpxqC8dI.js';
+import '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 
 interface RemoteSearchBackendOptions {

package/dist/{semantic-consolidation-BFtoVosl.d.ts → semantic-consolidation-btIVRC4l.d.ts}

@@ -1,4 +1,4 @@
-import { P as PluginConfig, M as MemoryFile } from './types-DpxqC8dI.js';
+import { P as PluginConfig, M as MemoryFile } from './types-Cmkz7csa.js';
 import { RolloutSummaryInput, MaterializeResult } from './connectors/codex-materialize.js';
 import { LoggerBackend } from './logger.js';
 import { SemanticConsolidationLlmOperator } from './consolidation-operator.js';

package/dist/semantic-consolidation.d.ts

@@ -1,6 +1,6 @@
-import './types-DpxqC8dI.js';
+import './types-Cmkz7csa.js';
 import './connectors/codex-materialize.js';
-export { C as ConsolidationCluster, O as OperatorAwareConsolidationResult, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, c as buildOperatorAwareConsolidationPrompt, e as chooseConsolidationOperator, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, g as parseOperatorAwareConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-BFtoVosl.js';
+export { C as ConsolidationCluster, O as OperatorAwareConsolidationResult, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, c as buildOperatorAwareConsolidationPrompt, e as chooseConsolidationOperator, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, g as parseOperatorAwareConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-btIVRC4l.js';
 export { CONSOLIDATION_OPERATORS, ConsolidationOperator, SemanticConsolidationLlmOperator, isConsolidationOperator, isSemanticConsolidationLlmOperator, isValidDerivedFromEntry } from './consolidation-operator.js';
 import './message-parts/index.js';
 import './logger.js';

package/dist/semantic-consolidation.js

@@ -7,35 +7,33 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-ZW6OKHVX.js";
-import "./chunk-WKE4VXSZ.js";
+} from "./chunk-FKCJH7KP.js";
+import "./chunk-QKVX4Y6D.js";
 import "./chunk-QLULYKWZ.js";
 import {
   resolveExtensionsRoot
 } from "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-ZBJMUXZH.js";
-import "./chunk-KTOH7EJE.js";
+import "./chunk-PV7E2FGY.js";
 import "./chunk-B3ABVQ36.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VSMRDBFT.js";
+import "./chunk-LTJAMRGI.js";
 import "./chunk-EHK6KZHK.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-4KJLYTLS.js";
 import "./chunk-SVOZFLIQ.js";
-import "./chunk-LTJAMRGI.js";
-import "./chunk-JO5AT6QT.js";
-import "./chunk-RHOZ5LLO.js";
-import "./chunk-RL6NEVXT.js";
-import "./chunk-AWJ2FHCF.js";
-import "./chunk-42JKGUFJ.js";
+import "./chunk-3ZVFLMFQ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-LKT755LP.js";
+import "./chunk-VA4WSW54.js";
 import "./chunk-AAD2ZS6P.js";
 import {
   CONSOLIDATION_OPERATORS,
@@ -43,12 +41,16 @@ import {
   isSemanticConsolidationLlmOperator,
   isValidDerivedFromEntry
 } from "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
+import "./chunk-VZ5OJE4X.js";
+import "./chunk-OKUEZOGW.js";
+import "./chunk-X47LWMKA.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-GKCCHHZK.js";
+import "./chunk-UXKMMNJD.js";
 import "./chunk-K2ZLHESQ.js";
-import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-U3PN77QT.js";

package/dist/semantic-rule-promotion.js

@@ -1,36 +1,38 @@
 import {
   promoteSemanticRuleFromMemory,
   setSemanticRulePromotionTestHooks
-} from "./chunk-UVIQHSS7.js";
-import "./chunk-KTOH7EJE.js";
+} from "./chunk-UP25ZZCN.js";
+import "./chunk-PV7E2FGY.js";
 import "./chunk-B3ABVQ36.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VSMRDBFT.js";
+import "./chunk-LTJAMRGI.js";
 import "./chunk-EHK6KZHK.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-4KJLYTLS.js";
 import "./chunk-SVOZFLIQ.js";
-import "./chunk-LTJAMRGI.js";
-import "./chunk-JO5AT6QT.js";
-import "./chunk-RHOZ5LLO.js";
-import "./chunk-RL6NEVXT.js";
-import "./chunk-AWJ2FHCF.js";
-import "./chunk-42JKGUFJ.js";
+import "./chunk-3ZVFLMFQ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-LKT755LP.js";
+import "./chunk-VA4WSW54.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
+import "./chunk-VZ5OJE4X.js";
+import "./chunk-OKUEZOGW.js";
+import "./chunk-X47LWMKA.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-GKCCHHZK.js";
+import "./chunk-UXKMMNJD.js";
 import "./chunk-K2ZLHESQ.js";
-import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";

package/dist/semantic-rule-verifier.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryFile } from './types-DpxqC8dI.js';
+import { M as MemoryFile } from './types-Cmkz7csa.js';
 import './message-parts/index.js';
 
 type SemanticRuleVerificationStatus = "verified" | "source-memory-missing" | "source-memory-archived" | "source-memory-forgotten" | "source-memory-not-episode";
@@ -16,6 +16,10 @@ declare function searchVerifiedSemanticRules(options: {
     query: string;
     maxResults: number;
     minEffectiveConfidence?: number;
+    /** Hot-memories cache gate (issue #1902, Codex P2). Threaded from the caller
+     *  so a named-namespace root (never registered in the per-dir default map)
+     *  honors the owning daemon's config instead of the process-wide default. */
+    hotMemoriesCacheEnabled?: boolean;
 }): Promise<VerifiedSemanticRuleResult[]>;
 
 export { type SemanticRuleVerificationStatus, type VerifiedSemanticRuleResult, compareVerifiedSemanticRuleResults, searchVerifiedSemanticRules };

package/dist/semantic-rule-verifier.js

@@ -1,37 +1,39 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-TVRPRFUB.js";
+} from "./chunk-TY43GBX2.js";
 import "./chunk-ZBJMUXZH.js";
-import "./chunk-KTOH7EJE.js";
+import "./chunk-PV7E2FGY.js";
 import "./chunk-B3ABVQ36.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VSMRDBFT.js";
+import "./chunk-LTJAMRGI.js";
 import "./chunk-EHK6KZHK.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-4KJLYTLS.js";
 import "./chunk-SVOZFLIQ.js";
-import "./chunk-LTJAMRGI.js";
-import "./chunk-JO5AT6QT.js";
-import "./chunk-RHOZ5LLO.js";
-import "./chunk-RL6NEVXT.js";
-import "./chunk-AWJ2FHCF.js";
-import "./chunk-42JKGUFJ.js";
+import "./chunk-3ZVFLMFQ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-LKT755LP.js";
+import "./chunk-VA4WSW54.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
+import "./chunk-VZ5OJE4X.js";
+import "./chunk-OKUEZOGW.js";
+import "./chunk-X47LWMKA.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-GKCCHHZK.js";
+import "./chunk-UXKMMNJD.js";
 import "./chunk-K2ZLHESQ.js";
-import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";

package/dist/session-observer-bands.d.ts

@@ -1,4 +1,4 @@
-import { S as SessionObserverBandConfig } from './types-DpxqC8dI.js';
+import { S as SessionObserverBandConfig } from './types-Cmkz7csa.js';
 import './message-parts/index.js';
 
 declare const DEFAULT_SESSION_OBSERVER_BANDS: SessionObserverBandConfig[];

package/dist/session-observer-state.d.ts

@@ -1,4 +1,4 @@
-import { S as SessionObserverBandConfig } from './types-DpxqC8dI.js';
+import { S as SessionObserverBandConfig } from './types-Cmkz7csa.js';
 import './message-parts/index.js';
 
 interface SessionObservationInput {

package/dist/shared-context/manager.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { P as PluginConfig } from '../types-DpxqC8dI.js';
+import { P as PluginConfig } from '../types-Cmkz7csa.js';
 import '../message-parts/index.js';
 
 declare const SharedFeedbackEntrySchema: z.ZodObject<{
@@ -17,29 +17,29 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     evidenceWindowEnd: z.ZodOptional<z.ZodString>;
     refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    reason: string;
     decision: "rejected" | "approved" | "approved_with_feedback";
     date: string;
+    reason: string;
     agent: string;
-    severity?: "low" | "medium" | "high" | undefined;
-    confidence?: number | undefined;
-    tags?: string[] | undefined;
     workflow?: string | undefined;
+    tags?: string[] | undefined;
+    confidence?: number | undefined;
     outcome?: string | undefined;
+    severity?: "high" | "low" | "medium" | undefined;
     refs?: string[] | undefined;
     learning?: string | undefined;
     evidenceWindowStart?: string | undefined;
     evidenceWindowEnd?: string | undefined;
 }, {
-    reason: string;
     decision: "rejected" | "approved" | "approved_with_feedback";
     date: string;
+    reason: string;
     agent: string;
-    severity?: "low" | "medium" | "high" | undefined;
-    confidence?: number | undefined;
-    tags?: string[] | undefined;
     workflow?: string | undefined;
+    tags?: string[] | undefined;
+    confidence?: number | undefined;
     outcome?: string | undefined;
+    severity?: "high" | "low" | "medium" | undefined;
     refs?: string[] | undefined;
     learning?: string | undefined;
     evidenceWindowStart?: string | undefined;

package/dist/signal.d.ts

@@ -1,4 +1,4 @@
-import { au as SignalScanResult } from './types-DpxqC8dI.js';
+import { au as SignalScanResult } from './types-Cmkz7csa.js';
 import './message-parts/index.js';
 
 declare function isDisagreementPrompt(text: string): boolean;

package/dist/{storage-CXjwBr69.d.ts → storage-BVv_Mqa0.d.ts}

@@ -1,4 +1,4 @@
-import { M as MemoryFile, P as PluginConfig, v as MemoryStatus, u as MemoryCategory, ak as ImportanceScore, ax as MemoryLink, p as MemoryFrontmatter, F as FaithfulnessFrontmatter, N as ProvenanceSource, ad as EntityStructuredSection, ay as BufferState, az as MetaState, a8 as MemoryActionEvent, x as MemoryLifecycleEvent, Z as BufferSurpriseEvent, B as BehaviorSignalEvent, a9 as CompressionGuidelineOptimizerState, ag as ContinuityIncidentOpenInput, ae as ContinuityIncidentRecord, af as ContinuityIncidentCloseInput, ah as ContinuityImprovementLoop, aj as ContinuityLoopUpsertInput, ai as ContinuityLoopReviewInput, aA as FileHygieneConfig, aB as EntityRelationship, aC as EntityActivityEntry, E as EntityFile, aD as AccessTrackingEntry, w as MemoryProjectionCurrentState, aE as MemorySummary, av as TopicScore, aF as EntityTimelineEntry } from './types-DpxqC8dI.js';
+import { M as MemoryFile, P as PluginConfig, v as MemoryStatus, u as MemoryCategory, ak as ImportanceScore, ax as MemoryLink, p as MemoryFrontmatter, F as FaithfulnessFrontmatter, N as ProvenanceSource, ad as EntityStructuredSection, ay as BufferState, az as MetaState, a8 as MemoryActionEvent, x as MemoryLifecycleEvent, Z as BufferSurpriseEvent, B as BehaviorSignalEvent, a9 as CompressionGuidelineOptimizerState, ag as ContinuityIncidentOpenInput, ae as ContinuityIncidentRecord, af as ContinuityIncidentCloseInput, ah as ContinuityImprovementLoop, aj as ContinuityLoopUpsertInput, ai as ContinuityLoopReviewInput, aA as FileHygieneConfig, aB as EntityRelationship, aC as EntityActivityEntry, E as EntityFile, aD as AccessTrackingEntry, w as MemoryProjectionCurrentState, aE as MemorySummary, av as TopicScore, aF as EntityTimelineEntry } from './types-Cmkz7csa.js';
 import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
 import { ProjectedMemoryBrowseOptions, ProjectedMemoryBrowsePage, readProjectedGovernanceRecord } from './memory-projection-store.js';
@@ -762,10 +762,56 @@ declare class StorageManager {
     static readonly ARTIFACT_INDEX_CACHE_TTL_MS = 60000;
     private static readonly artifactWriteVersionByDir;
     private static readonly memoryStatusVersionByDir;
+    private static readonly memoryCorpusVersionByDir;
     private static readonly secureStoreEntityCacheKeyIds;
     private static nextSecureStoreEntityCacheKeyId;
     private static readonly coldWriteVersionByDir;
-    private static readonly allMemoriesInFlight;
+    /**
+     * Process-wide default for the hot-memories result cache gate (issue #1902).
+     * Set once from config by the orchestrator/access layer via
+     * setHotMemoriesCacheDefault() so that EVERY StorageManager — including the
+     * ephemeral instances recall sub-stages (verified-recall, semantic-rule
+     * verification, ...) construct over the same dir — honors the operator's
+     * hotMemoriesCacheEnabled setting. The constructor option overrides this
+     * per-instance (tests). Defaults true (cache on).
+     */
+    private static hotMemoriesCacheDefault;
+    /**
+     * Per-memory-directory override of the hot-cache gate (issue #1902, Codex
+     * P2). setHotMemoriesCacheDefault(memoryDir, enabled) registers the
+     * operator's setting keyed by dir, so a StorageManager constructed over that
+     * dir honors ITS owning orchestrator's config — not merely the last
+     * orchestrator constructed in the process. Unregistered dirs fall back to
+     * the process-wide default above.
+     */
+    private static readonly hotMemoriesCacheDefaultByDir;
+    /**
+     * Process-wide TTL (ms) safety net for the hot cache (issue #1902). Bounds
+     * how long a version-keyed entry is served before a fresh disk scan, so
+     * external filesystem edits (manual/git/editor) that don't bump the sentinel
+     * self-heal. Set from config by the orchestrator via setHotMemoriesCacheDefault.
+     * 0 disables the TTL (version invalidation only). Default 60s.
+     */
+    private static hotMemoriesCacheTtlMs;
+    /**
+     * Per-memory-directory override of the hot-cache TTL (issue #1902, Codex P2),
+     * mirroring hotMemoriesCacheDefaultByDir. Registered by
+     * setHotMemoriesCacheDefault so two orchestrators in one process with
+     * different TTLs don't clobber each other's setting. Unregistered dirs fall
+     * back to the process-wide default above.
+     */
+    private static readonly hotMemoriesCacheTtlByDir;
+    /**
+     * Whether the process-wide hot-cache fallbacks (hotMemoriesCacheDefault /
+     * hotMemoriesCacheTtlMs) have been seeded by the first
+     * setHotMemoriesCacheDefault call (issue #1902, Cursor Low). Only the first
+     * registration seeds them; later registrations touch ONLY their per-dir map
+     * entry. This makes the process-wide fallback deterministic (first-writer,
+     * by init order) instead of last-writer-wins, so a second orchestrator with
+     * a divergent config cannot silently flip the fallback that unregistered
+     * dirs resolve to. All REGISTERED dirs are isolated by the per-dir maps.
+     */
+    private static hotMemoriesCacheProcessDefaultSeeded;
     /** Read by storage/memory-read-store.ts (decomposition). */
     static readonly COLD_SCAN_CACHE_TTL_MS = 30000;
     /** Read by storage/memory-read-store.ts (decomposition). */
@@ -773,6 +819,7 @@ declare class StorageManager {
         memories: MemoryFile[];
         loadedAt: number;
         coldVersion: number;
+        keyId: string;
     }>;
     /** Read by storage/memory-read-store.ts (decomposition). */
     static readonly QUESTIONS_CACHE_TTL_MS = 60000;
@@ -844,6 +891,36 @@ declare class StorageManager {
      */
     setSecureStoreKey(key: Buffer | null, encryptOnWrite?: boolean): void;
     private getEntityCacheSecureStoreKey;
+    /**
+     * Secure-store key identity for the version-keyed hot/archive memory caches
+     * (issue #1902, Codex P1). Scopes cached DECRYPTED corpora by the key that
+     * decrypted them, so a locked/unkeyed StorageManager for the same baseDir
+     * never reads content another instance decrypted under a key (which would
+     * bypass the locked-store error). Plaintext and locked stores share the ""
+     * namespace; an unlocked encrypted store uses its per-key id.
+     */
+    hotCacheKeyId(): string;
+    /**
+     * Resolved hot-cache gate for THIS store (issue #1902, Cursor Medium): the
+     * per-instance override if one was passed, else the per-dir/process default.
+     * Recall sub-stages (verified-recall, semantic-rule) read this to honor the
+     * operator's opt-out for their derived caches even when the caller omits the
+     * flag in options.
+     */
+    isHotCacheEnabled(): boolean;
+    /**
+     * Effective hot-cache TTL (ms) for this store's dir (issue #1902): the per-dir
+     * registration if present, else the process-wide default. 0 disables the TTL.
+     */
+    hotCacheTtlMs(): number;
+    /**
+     * True if `p` lives in this store's cold/ or archive/ tier (issue #1902,
+     * Codex P2). Determined RELATIVE to baseDir — a substring scan of the
+     * absolute path would misclassify every active path when memoryDir itself is
+     * nested under a dir literally named "cold" or "archive" (e.g.
+     * /srv/cold/remnic), skipping the patch and stranding a stale hot entry.
+     */
+    private isColdOrArchiveTierPath;
     /**
      * Mark the secure-store as required for this storage instance.
      * When required and locked, writes throw SecureStoreLockedError
@@ -885,7 +962,22 @@ declare class StorageManager {
      * rather than block the consolidation).
      */
     snapshotForProvenance(filePath: string): Promise<string | null>;
-    constructor(baseDir: string, entitySchemas?: PluginConfig["entitySchemas"]);
+    private readonly hotMemoriesCacheEnabled;
+    constructor(baseDir: string, entitySchemas?: PluginConfig["entitySchemas"], 
+    /**
+     * Hot-memories result cache gate (issue #1902). When omitted, resolves to
+     * the per-directory default registered by setHotMemoriesCacheDefault()
+     * (falling back to the process-wide default); pass an explicit boolean to
+     * override per-instance (tests, memory-constrained readers).
+     */
+    hotMemoriesCacheEnabledOverride?: boolean);
+    /** Set the process-wide hot-memories cache default (issue #1902). The
+     *  orchestrator/access layer calls this with the operator's
+     *  hotMemoriesCacheEnabled config so the escape hatch reaches every
+     *  StorageManager, including ephemeral recall-sub-stage instances. Only an
+     *  explicit `false` disables; `undefined` (e.g. a cast test config missing
+     *  the field) leaves the cache on. */
+    static setHotMemoriesCacheDefault(memoryDir: string, enabled: boolean | undefined, ttlMs?: number): void;
     /**
      * The LIVE class object of this instance (issue #1809 review of the
      * storage decomposition): extracted store modules must read/write the
@@ -913,6 +1005,26 @@ declare class StorageManager {
     private readSharedVersion;
     private bumpMemoryStatusVersion;
     getMemoryStatusVersion(): number;
+    /**
+     * Corpus version sentinel for the hot-memories result cache (issue #1902).
+     * Distinct from memory-status: it bumps on EVERY memory-file mutation
+     * (create/update/delete/bulk) so the version-keyed hot cache stays coherent
+     * across processes, WITHOUT bumping memory-status — which would needlessly
+     * invalidate the version-keyed entity cache on every plain fact create (the
+     * ki-spike regression the sibling perf work removes). memory-status keeps its
+     * lifecycle/status/entity semantics unchanged.
+     */
+    getMemoryCorpusVersion(): number;
+    private bumpMemoryCorpusVersion;
+    /**
+     * Corpus bump that reports whether THIS process's append was the only one
+     * since the pre-bump size (issue #1902, Codex P1). appendFileSync is atomic
+     * per write, but a peer process can append concurrently; the `exclusive`
+     * flag lets patchHotMemoriesCache refuse to re-key its locally patched
+     * (peer-incomplete) corpus at a version that already reflects a peer's
+     * still-unread write.
+     */
+    private bumpMemoryCorpusVersionExclusive;
     private bumpArtifactWriteVersion;
     private getArtifactWriteVersion;
     private get wearablesDir();
@@ -1265,6 +1377,24 @@ declare class StorageManager {
      *  cold content actually changes (hot→cold demotions, writeMemoryFileAtomic
      *  inside cold/, archiveMemory, etc.). */
     private invalidateAllMemoriesCache;
+    /**
+     * Single-file write/delete fast path for the hot-memories cache (issue
+     * #1902). Keeps THIS process's version-keyed corpus entry warm by patching
+     * the changed memory in place, bumps the dedicated `.memory-corpus-version.log`
+     * sentinel so PEER processes rescan (memory-status is deliberately NOT bumped
+     * here so plain creates/content edits don't invalidate the entity cache), and
+     * evicts only the derived/global layers (which
+     * are cheap to rebuild and are never patched). Mirrors the in-flight-dedup
+     * and tombstone-store invalidation that invalidateAllMemoriesCache() does.
+     *
+     * `added` is the written MemoryFile (writes/overwrites); `removedPath` is a
+     * deleted path. A path outside the active scan roots (under cold/ or
+     * archive/) is NOT applied to the hot map — that cache holds active memories
+     * only — but the version bump and derived/global eviction still run so
+     * coherence is preserved. Bulk/ambiguous mutations keep the wholesale
+     * invalidateAllMemoriesCache() drop instead (issue #1902 Step 5).
+     */
+    private patchHotMemoriesCache;
     /**
      * Invalidate the cold-scan cache for this storage root and bump the
      * on-disk cold-version sentinel so that other processes (gateway, CLI) see

package/dist/storage.d.ts

@@ -1,6 +1,6 @@
-import './types-DpxqC8dI.js';
+import './types-Cmkz7csa.js';
 import './page-versioning.js';
-export { C as ContentHashIndex, w as MemoryLifecycleEventWriteOptions, M as MemoryWriteResult, R as ReextractJobRequest, S as StorageManager, x as buildEntitySchemaCacheKey, y as compareEntityTimestamps, z as compileEntityFacts, A as countEntityStructuredFacts, B as fingerprintEntityStructuredFacts, E as isEntitySynthesisStale, G as isValidBufferSurpriseEvent, r as normalizeAttributePairs, H as normalizeEntityName, I as normalizeFrontmatterForPath, J as normalizeStructuredSectionFacts, s as parseEntityFile, K as parseFrontmatter, L as parseFrontmatterStringValue, u as serializeEntityFile } from './storage-CXjwBr69.js';
+export { C as ContentHashIndex, w as MemoryLifecycleEventWriteOptions, M as MemoryWriteResult, R as ReextractJobRequest, S as StorageManager, x as buildEntitySchemaCacheKey, y as compareEntityTimestamps, z as compileEntityFacts, A as countEntityStructuredFacts, B as fingerprintEntityStructuredFacts, E as isEntitySynthesisStale, G as isValidBufferSurpriseEvent, r as normalizeAttributePairs, H as normalizeEntityName, I as normalizeFrontmatterForPath, J as normalizeStructuredSectionFacts, s as parseEntityFile, K as parseFrontmatter, L as parseFrontmatterStringValue, u as serializeEntityFile } from './storage-BVv_Mqa0.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';
 export { stripAttributesSuffix } from './structured-attributes.js';

package/dist/storage.js

@@ -16,11 +16,12 @@ import {
   parseFrontmatter,
   parseFrontmatterStringValue,
   serializeEntityFile
-} from "./chunk-KTOH7EJE.js";
+} from "./chunk-PV7E2FGY.js";
 import "./chunk-B3ABVQ36.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VSMRDBFT.js";
+import "./chunk-LTJAMRGI.js";
 import "./chunk-EHK6KZHK.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
@@ -28,25 +29,26 @@ import "./chunk-4KJLYTLS.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
-import "./chunk-LTJAMRGI.js";
-import "./chunk-JO5AT6QT.js";
-import "./chunk-RHOZ5LLO.js";
-import "./chunk-RL6NEVXT.js";
-import "./chunk-AWJ2FHCF.js";
-import "./chunk-42JKGUFJ.js";
+import "./chunk-3ZVFLMFQ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-RHOZ5LLO.js";
+import "./chunk-RL6NEVXT.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-LKT755LP.js";
+import "./chunk-VA4WSW54.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
+import "./chunk-VZ5OJE4X.js";
+import "./chunk-OKUEZOGW.js";
+import "./chunk-X47LWMKA.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-GKCCHHZK.js";
+import "./chunk-UXKMMNJD.js";
 import "./chunk-K2ZLHESQ.js";
-import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";

package/dist/summarizer.d.ts

@@ -1,5 +1,5 @@
 import { ModelRegistry } from './model-registry.js';
-import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-DpxqC8dI.js';
+import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-Cmkz7csa.js';
 import { TranscriptManager } from './transcript.js';
 import './message-parts/index.js';
 import './session-integrity.js';

package/dist/summarizer.js

@@ -1,6 +1,6 @@
 import {
   HourlySummarizer
-} from "./chunk-KIPLG7S7.js";
+} from "./chunk-JKLJ6A7W.js";
 import "./chunk-3FAMU5TX.js";
 import "./chunk-KAWTOYAW.js";
 import "./chunk-VY6LKKVN.js";
@@ -8,10 +8,10 @@ import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-GKCCHHZK.js";
+import "./chunk-UXKMMNJD.js";
 import "./chunk-K2ZLHESQ.js";
-import "./chunk-L2EXJQJP.js";
 import "./chunk-VFSP73LP.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-BFPETA3S.js";