@remnic/core 9.7.14 → 9.7.15

package/dist/index.js

@@ -96,7 +96,7 @@ import {
   validateTaxonomy,
   watchForChanges,
   writeManifest
-} from "./chunk-ASKEM4AR.js";
+} from "./chunk-QKQYXZVS.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -121,7 +121,7 @@ import {
   writeDailyDigestMemory
 } from "./chunk-LC7OODWZ.js";
 import "./chunk-TRWPCR6P.js";
-import "./chunk-NUWYOKS6.js";
+import "./chunk-QQGPUKMT.js";
 import "./chunk-I74SUMNI.js";
 import {
   PEERS_DIR_NAME,
@@ -173,7 +173,7 @@ import {
   readAuditLog,
   runEnrichmentPipeline
 } from "./chunk-KBL3JJR6.js";
-import "./chunk-FBNWOMCE.js";
+import "./chunk-T7Y5KPLN.js";
 import "./chunk-5CJVLG3H.js";
 import {
   MARKETPLACE_MANIFEST_FILENAME,
@@ -342,7 +342,7 @@ import {
 import "./chunk-ZQ7UBUZ6.js";
 import {
   buildEntityRecallSection
-} from "./chunk-4B4MUS5D.js";
+} from "./chunk-RVZRYUQH.js";
 import {
   clearTrainingExportAdapters,
   convertMemoriesToRecords,
@@ -351,7 +351,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-F7AU34FC.js";
+} from "./chunk-OVJ2HIPE.js";
 import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
 import "./chunk-MMACM5G2.js";
@@ -371,8 +371,8 @@ import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-FGDKJJZS.js";
 import "./chunk-AJVLDJU6.js";
-import "./chunk-UN3CH3CO.js";
-import "./chunk-7LFXDGLH.js";
+import "./chunk-XDSXEKYK.js";
+import "./chunk-DMSDUGDM.js";
 import "./chunk-LZZNTPLR.js";
 import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
@@ -394,31 +394,31 @@ import {
   validateImportTurn
 } from "./chunk-NOUJNHWG.js";
 import "./chunk-GQL52GQ5.js";
-import "./chunk-67ZCJLJY.js";
+import "./chunk-Q5WG43OP.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-DBRYEIGY.js";
-import "./chunk-JMBVCAR4.js";
-import "./chunk-IKSELOIV.js";
+import "./chunk-JREB6UFH.js";
+import "./chunk-G6XXLKC5.js";
 import {
   clearAuthTokenSecretCache,
   isAgentAccessSecretRef,
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
-import "./chunk-4LEF6XWJ.js";
+import "./chunk-FDCTQWLW.js";
 import "./chunk-ZRWB5D4H.js";
 import "./chunk-5EZXHU36.js";
 import "./chunk-SFQ6QNL7.js";
 import {
   parseXrayBudgetFlag,
   parseXrayCliOptions
-} from "./chunk-KGWXHWAH.js";
-import "./chunk-VYOFVVNK.js";
+} from "./chunk-HDTQVNWD.js";
+import "./chunk-FIJUY7GG.js";
 import {
   NamespaceCatalog
-} from "./chunk-5UNWK7KU.js";
-import "./chunk-6CALL5VN.js";
-import "./chunk-RBQLJSJ7.js";
+} from "./chunk-HF77M34J.js";
+import "./chunk-VJVNLNDQ.js";
+import "./chunk-3IY64MV6.js";
 import "./chunk-KFY3SGN7.js";
 import {
   parseStrictCliDate
@@ -472,7 +472,7 @@ import {
   renderConnectorsRunResult,
   runConnectorPollOnce
 } from "./chunk-OKTXM5H4.js";
-import "./chunk-5S7Z5SHA.js";
+import "./chunk-34RC5RT7.js";
 import "./chunk-FZZ2QTJI.js";
 import "./chunk-LMDRGRJ2.js";
 import "./chunk-OD4FM2U7.js";
@@ -481,11 +481,11 @@ import {
 } from "./chunk-3I4FUAVJ.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-TXVD7PLT.js";
+} from "./chunk-ZHIVCODT.js";
 import {
   runCodexMaterialize,
   runPostConsolidationMaterialize
-} from "./chunk-W5NKDU24.js";
+} from "./chunk-RO4LQGT3.js";
 import {
   MATERIALIZE_VERSION,
   SENTINEL_FILE,
@@ -534,7 +534,7 @@ import {
   parseConfig,
   parseWearablesConfig,
   resolveEnvVars
-} from "./chunk-IFJ23BHU.js";
+} from "./chunk-INELTPRG.js";
 import {
   REDACTION_PLACEHOLDER,
   applyCorrections,
@@ -554,7 +554,7 @@ import "./chunk-K6MV3TRQ.js";
 import "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-ND5M64JJ.js";
+} from "./chunk-DCFV7A7H.js";
 import {
   WearablesInputError,
   describeErrorForOperator
@@ -568,7 +568,7 @@ import "./chunk-42NQ7AVG.js";
 import "./chunk-7RXCMVFQ.js";
 import {
   EngramMcpServer
-} from "./chunk-A7B4RMQG.js";
+} from "./chunk-PBNZVPFS.js";
 import "./chunk-IC2TCZJ2.js";
 import {
   buildCitationGuidance,
@@ -598,7 +598,7 @@ import {
   relayMissionAppendOperation,
   relayMissionReadOperation,
   relayMissionReceiptDigest
-} from "./chunk-ANADNYWK.js";
+} from "./chunk-OAZVR2BV.js";
 import {
   formatZodError,
   memoryStoreRequestSchema,
@@ -607,9 +607,9 @@ import {
   suggestionSubmitRequestSchema,
   validateRequest
 } from "./chunk-2MR3MFQB.js";
-import "./chunk-AD6AMF2N.js";
+import "./chunk-VDW4VU7B.js";
 import "./chunk-YF6FMLBT.js";
-import "./chunk-HLTAPHZZ.js";
+import "./chunk-UDQUSU27.js";
 import {
   ACTIVE_STATUSES,
   judgeContradictionPairs,
@@ -640,7 +640,7 @@ import {
 } from "./chunk-T4WDJPEZ.js";
 import {
   OPERATION_NAMES
-} from "./chunk-EEARRVZ2.js";
+} from "./chunk-BS4SGLWV.js";
 import {
   TOKEN_CAPABILITIES_VERSION,
   capabilityAllowsNamespace,
@@ -656,10 +656,10 @@ import {
   EngramAccessService,
   computeProcedureStats,
   formatProcedureStatsText
-} from "./chunk-GMSDQUCR.js";
+} from "./chunk-LZOV7MX7.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-OC35KQIN.js";
+import "./chunk-A5UXZRRM.js";
 import "./chunk-64SE4X5G.js";
 import "./chunk-VQ7B2Q6M.js";
 import {
@@ -684,9 +684,9 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-DDGV7NAX.js";
+} from "./chunk-EHCONI6E.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-PK5XBDA6.js";
+import "./chunk-DPAENM7O.js";
 import {
   branchNamespaceName,
   describeCodingScope,
@@ -696,32 +696,32 @@ import {
   resolveGitContext,
   stableHash
 } from "./chunk-7PND4PUC.js";
-import "./chunk-XVLEGMJI.js";
-import "./chunk-V53GJUSL.js";
+import "./chunk-PLQE6MJA.js";
+import "./chunk-G4CN3ZXL.js";
 import {
   LanceDbBackend
-} from "./chunk-N3JDIRBW.js";
+} from "./chunk-74F5STS4.js";
 import {
   MeilisearchBackend
-} from "./chunk-UTRJFDP2.js";
+} from "./chunk-FNZQGN76.js";
 import "./chunk-CYEPCZN5.js";
 import {
   OramaBackend
-} from "./chunk-7MW3CVLD.js";
-import "./chunk-ZIDSD6VC.js";
+} from "./chunk-DZKHSDOM.js";
+import "./chunk-LRNMRXJO.js";
 import "./chunk-6SXVCD7W.js";
 import "./chunk-FNMFJWBY.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-EGGE52UU.js";
-import "./chunk-2E6G7FCE.js";
+import "./chunk-2AZXIZEN.js";
 import "./chunk-JI5AVXYO.js";
 import "./chunk-TN7THW5U.js";
 import "./chunk-R5VAVVHP.js";
 import "./chunk-FC77VUX5.js";
 import {
   QmdClient
-} from "./chunk-AHLPZ2SF.js";
-import "./chunk-WU46YPY6.js";
+} from "./chunk-DYP3YYJJ.js";
+import "./chunk-RAR2BSEM.js";
 import "./chunk-64UDOIMI.js";
 import "./chunk-ICP53SKG.js";
 import {
@@ -739,7 +739,7 @@ import {
   memoryWorthOutcomeEligibleCategories,
   recordMemoryOutcome
 } from "./chunk-EIR5VLIH.js";
-import "./chunk-HG32URJJ.js";
+import "./chunk-E6CBU7XP.js";
 import "./chunk-EI6V5UXY.js";
 import "./chunk-MTWKDOVO.js";
 import "./chunk-O75CRYGF.js";
@@ -759,8 +759,8 @@ import {
   DEFAULT_CROSS_NAMESPACE_BUDGET
 } from "./chunk-ODPLEWB6.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-7XGSIUP5.js";
-import "./chunk-OBMR4VIX.js";
+import "./chunk-AJLLIIML.js";
+import "./chunk-2S6QHZGJ.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-TBBDFYXW.js";
@@ -778,7 +778,7 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-MKDRQAA3.js";
+} from "./chunk-KDXVOFYY.js";
 import {
   ContentHashIndex,
   DEFAULT_PROXIMITY_GAP_MS,
@@ -798,7 +798,7 @@ import {
   reconstructFusionInputs,
   serializeEntityFile,
   serializeFusionDay
-} from "./chunk-7ICYQUOL.js";
+} from "./chunk-K7LOWSLU.js";
 import "./chunk-L2B3EE7B.js";
 import {
   DEFAULT_SELF_NAME,
@@ -846,7 +846,7 @@ import {
   DEFAULT_RECALL_DISCLOSURE,
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-B3F4CWQR.js";
+} from "./chunk-PBSAPHHA.js";
 import "./chunk-RULE4VG5.js";
 import {
   normalizeProjectionPreview,
@@ -865,9 +865,9 @@ import {
   getVersion,
   listVersions,
   revertToVersion
-} from "./chunk-VZ5OJE4X.js";
-import "./chunk-OKUEZOGW.js";
-import "./chunk-X47LWMKA.js";
+} from "./chunk-5VQJBH2G.js";
+import "./chunk-AITCS2RC.js";
+import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-PDJTHRAW.js";
 import "./chunk-W5H6ZRPT.js";

package/dist/intent.d.ts

@@ -1,4 +1,4 @@
-import { al as MemoryIntent, b as RecallPlanMode } from './types-Bl4BWDM8.js';
+import { al as MemoryIntent, b as RecallPlanMode } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 declare function inferIntentFromText(text: string): MemoryIntent;

package/dist/lcm/engine.d.ts

@@ -2,7 +2,7 @@ import { LcmStructuredRecallMatch } from './archive.js';
 import { SummarizeFn } from './summarizer.js';
 import { LcmRecallWithTraceResult } from './recall.js';
 import { LcmObserveMessage } from './queue.js';
-import { P as PluginConfig } from '../types-Bl4BWDM8.js';
+import { P as PluginConfig } from '../types-Cg8q7W7_.js';
 import 'better-sqlite3';
 import '../message-parts/index.js';
 import './dag.js';

package/dist/lcm/index.d.ts

@@ -7,7 +7,7 @@ export { registerLcmTools } from './tools.js';
 export { ensureLcmStateDir, openLcmDatabase } from './schema.js';
 import './queue.js';
 import '../message-parts/index.js';
-import '../types-Bl4BWDM8.js';
+import '../types-Cg8q7W7_.js';
 import 'better-sqlite3';
 import '../runtime/better-sqlite.js';
 

package/dist/lcm/tools.d.ts

@@ -6,7 +6,7 @@ import './summarizer.js';
 import './dag.js';
 import './recall.js';
 import './queue.js';
-import '../types-Bl4BWDM8.js';
+import '../types-Cg8q7W7_.js';
 
 interface ToolApi {
     registerTool(spec: {

package/dist/lifecycle.d.ts

@@ -1,4 +1,4 @@
-import { V as LifecycleState, u as MemoryCategory, M as MemoryFile, p as MemoryFrontmatter } from './types-Bl4BWDM8.js';
+import { V as LifecycleState, u as MemoryCategory, M as MemoryFile, p as MemoryFrontmatter } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 interface LifecyclePolicy {

package/dist/live-connectors-runner.d.ts

@@ -1,5 +1,5 @@
 import { L as LiveConnector, C as ConnectorConfig, a as ConnectorDocument } from './framework-CNDn2164.js';
-import { L as LiveConnectorsConfig } from './types-Bl4BWDM8.js';
+import { L as LiveConnectorsConfig } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 type LiveConnectorSkipReason = "disabled" | "not_due" | "invalid_config" | "state_read_error" | "connector_error";

package/dist/local-llm.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-Bl4BWDM8.js';
+import { P as PluginConfig } from './types-Cg8q7W7_.js';
 import { ModelRegistry } from './model-registry.js';
 import './message-parts/index.js';
 

package/dist/local-model-endpoint.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-Bl4BWDM8.js';
+import { P as PluginConfig } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 /**

package/dist/maintenance/memory-governance.d.ts

@@ -1,4 +1,4 @@
-import { v as MemoryStatus, M as MemoryFile } from '../types-Bl4BWDM8.js';
+import { v as MemoryStatus, M as MemoryFile } from '../types-Cg8q7W7_.js';
 import '../message-parts/index.js';
 
 type MemoryGovernanceMode = "shadow" | "apply";

package/dist/maintenance/memory-governance.js

@@ -7,9 +7,9 @@ import {
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "../chunk-2E6G7FCE.js";
+} from "../chunk-2AZXIZEN.js";
 import "../chunk-TBBDFYXW.js";
-import "../chunk-7ICYQUOL.js";
+import "../chunk-K7LOWSLU.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-B3ABVQ36.js";
 import "../chunk-5UZXUTVO.js";
@@ -20,7 +20,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-4KJLYTLS.js";
 import "../chunk-SVOZFLIQ.js";
-import "../chunk-B3F4CWQR.js";
+import "../chunk-PBSAPHHA.js";
 import "../chunk-RULE4VG5.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-RHOZ5LLO.js";
@@ -30,9 +30,9 @@ import "../chunk-LDXUBPMO.js";
 import "../chunk-VA4WSW54.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-G7D6GZ5J.js";
-import "../chunk-VZ5OJE4X.js";
-import "../chunk-OKUEZOGW.js";
-import "../chunk-X47LWMKA.js";
+import "../chunk-5VQJBH2G.js";
+import "../chunk-AITCS2RC.js";
+import "../chunk-XMMESCPD.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-PDJTHRAW.js";
 import "../chunk-W5H6ZRPT.js";

package/dist/maintenance/rebuild-memory-lifecycle-ledger.js

@@ -1,10 +1,10 @@
 import {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
-} from "../chunk-UN3CH3CO.js";
+} from "../chunk-XDSXEKYK.js";
 import "../chunk-KJTKLXTH.js";
 import "../chunk-SFQ6QNL7.js";
-import "../chunk-7ICYQUOL.js";
+import "../chunk-K7LOWSLU.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-B3ABVQ36.js";
 import "../chunk-5UZXUTVO.js";
@@ -15,7 +15,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-4KJLYTLS.js";
 import "../chunk-SVOZFLIQ.js";
-import "../chunk-B3F4CWQR.js";
+import "../chunk-PBSAPHHA.js";
 import "../chunk-RULE4VG5.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-RHOZ5LLO.js";
@@ -25,9 +25,9 @@ import "../chunk-LDXUBPMO.js";
 import "../chunk-VA4WSW54.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-G7D6GZ5J.js";
-import "../chunk-VZ5OJE4X.js";
-import "../chunk-OKUEZOGW.js";
-import "../chunk-X47LWMKA.js";
+import "../chunk-5VQJBH2G.js";
+import "../chunk-AITCS2RC.js";
+import "../chunk-XMMESCPD.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-PDJTHRAW.js";
 import "../chunk-W5H6ZRPT.js";

package/dist/maintenance/rebuild-memory-projection.js

@@ -3,13 +3,13 @@ import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "../chunk-7LFXDGLH.js";
+} from "../chunk-DMSDUGDM.js";
 import "../chunk-KJTKLXTH.js";
 import "../chunk-SFQ6QNL7.js";
 import "../chunk-MRHFJV44.js";
-import "../chunk-2E6G7FCE.js";
+import "../chunk-2AZXIZEN.js";
 import "../chunk-TBBDFYXW.js";
-import "../chunk-7ICYQUOL.js";
+import "../chunk-K7LOWSLU.js";
 import "../chunk-L2B3EE7B.js";
 import "../chunk-B3ABVQ36.js";
 import "../chunk-5UZXUTVO.js";
@@ -20,7 +20,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-J6A3CX5N.js";
 import "../chunk-4KJLYTLS.js";
 import "../chunk-SVOZFLIQ.js";
-import "../chunk-B3F4CWQR.js";
+import "../chunk-PBSAPHHA.js";
 import "../chunk-RULE4VG5.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-RHOZ5LLO.js";
@@ -30,9 +30,9 @@ import "../chunk-LDXUBPMO.js";
 import "../chunk-VA4WSW54.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-G7D6GZ5J.js";
-import "../chunk-VZ5OJE4X.js";
-import "../chunk-OKUEZOGW.js";
-import "../chunk-X47LWMKA.js";
+import "../chunk-5VQJBH2G.js";
+import "../chunk-AITCS2RC.js";
+import "../chunk-XMMESCPD.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-PDJTHRAW.js";
 import "../chunk-W5H6ZRPT.js";

package/dist/mcp-memory-inspector-app.d.ts

@@ -1,13 +1,13 @@
-import { x as EngramAccessRecallResponse } from './access-service-CPhSnLOH.js';
+import { x as EngramAccessRecallResponse } from './access-service-DpcYZ9Nl.js';
 import { ActionConfidenceRequest } from './access-schema.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import { ActionConfidenceResult } from './action-confidence.js';
-import './catalog-uX9sT9ws.js';
-import './types-Bl4BWDM8.js';
+import './catalog-C9444P10.js';
+import './types-Cg8q7W7_.js';
 import './message-parts/index.js';
-import './orchestrator-BbZ_dQSU.js';
+import './orchestrator-Bp_jeBHK.js';
 import './briefing.js';
-import './storage-CrvzaM9C.js';
+import './storage-hr_Y2z5R.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';
@@ -36,7 +36,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-fvdZRa5Z.js';
+import './semantic-consolidation-C2m5eHHE.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';

package/dist/memory-action-policy.d.ts

@@ -1,4 +1,4 @@
-import { a7 as MemoryActionType, am as MemoryActionEligibilityContext, an as MemoryActionPolicyResult } from './types-Bl4BWDM8.js';
+import { a7 as MemoryActionType, am as MemoryActionEligibilityContext, an as MemoryActionPolicyResult } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 interface MemoryActionPolicyOptions {

package/dist/memory-cache.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryFile, E as EntityFile } from './types-Bl4BWDM8.js';
+import { M as MemoryFile, E as EntityFile } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 declare function getCachedMemories(baseDir: string, currentVersion: number, keyId?: string, ttlMs?: number): MemoryFile[] | null;
@@ -25,6 +25,13 @@ declare function setCachedRuleMemories(baseDir: string, memories: MemoryFile[],
 };
 declare function getCachedQmdSearch(cacheKey: string): unknown[] | null;
 declare function setCachedQmdSearch(cacheKey: string, results: unknown[]): void;
+/**
+ * Mutation scopes (issue #1904). A cache layer declares (via `evictOn`) which
+ * of these mutation kinds evict it, so the invalidation chokepoint can clear
+ * only the layers a given write actually affects instead of nuking every
+ * layer on every write (the permanently-cold-cache regression #1904 fixes).
+ */
+type MemoryMutationScope = "memory-create" | "memory-mutate" | "entity-write" | "secure-key-change";
 /**
  * Cache-layer registry (issue #1535).
  *
@@ -46,6 +53,11 @@ interface MemoryCacheLayer {
      *  the simple-and-correct choice — these caches are re-warmable
      *  (issue #1535, implementation guide option (b)). */
     readonly scope: "dir" | "global";
+    /** Which mutation scopes evict this layer (issue #1904). A `memory-create`
+     *  only refreshes the full-memory-list views (hot + derived episode/rule); a
+     *  `memory-mutate`/`entity-write`/`secure-key-change` evicts every layer whose
+     *  content it can affect. Adding a layer REQUIRES declaring this. */
+    readonly evictOn: Partial<Record<MemoryMutationScope, true>>;
     /** Evict entries for baseDir ("dir" scope) or everything ("global" scope). */
     readonly invalidateForDir: (baseDir: string) => void;
     /** Evict every entry across all dirs. */
@@ -67,6 +79,26 @@ declare const ALL_CACHE_LAYERS: readonly MemoryCacheLayer[];
  * served pre-edit bundles for the remainder of its fresh/stale TTL window).
  */
 declare function invalidateAllForDir(baseDir: string): void;
+/**
+ * Scope-aware invalidation chokepoint (issue #1904). Evicts only the layers
+ * whose `evictOn` includes `scope`, so the highest-frequency write
+ * (`memory-create`, fired continuously by extraction) stops nuking the QMD
+ * result caches and the version-keyed entity cache it cannot affect. This is
+ * the single scoped entry point — like `invalidateAllForDir`, it iterates the
+ * `ALL_CACHE_LAYERS` registry rather than clearing any layer ad hoc, so the
+ * single-chokepoint invariant (#1535) holds: a new layer only participates by
+ * declaring `evictOn`.
+ */
+declare function invalidateForScope(baseDir: string, scope: MemoryMutationScope): void;
+/**
+ * Companion to {@link invalidateForScope} for the single-file write fast path
+ * (issue #1902 + #1904): it patches the hot-memories entry in place and
+ * re-keys it, so this evicts every OTHER layer the scope would clear but leaves
+ * hot-memories alone. A `memory-create` thus evicts only the derived
+ * episode/rule views (hot patched, QMD/entities/archive kept warm), which is
+ * the whole point of #1904 — a create must not evict the QMD result caches.
+ */
+declare function invalidateForScopeExceptHot(baseDir: string, scope: MemoryMutationScope): void;
 /**
  * Invalidate every cache layer for `baseDir` EXCEPT the hot-memories layer
  * (issue #1902). Single-file write paths use this instead of
@@ -80,6 +112,16 @@ declare function invalidateAllForDir(baseDir: string): void;
  */
 declare function invalidateDerivedAndGlobalForDir(baseDir: string): void;
 declare function clearMemoryCache(baseDir?: string): void;
+/**
+ * Clear ONLY the two global QMD result caches (qmd-search + qmd-recall), leaving
+ * every dir-scoped layer (hot/archive/entities/derived) untouched. Called after
+ * a successful QMD maintenance update+embed (#1904, Codex): a newly-persisted
+ * fact becomes searchable at that moment, so any cached pre-index recall/search
+ * bundle is now stale and must not be served. This lets the create path keep the
+ * QMD caches warm during index lag (perf win) while guaranteeing invalidation
+ * the moment the fact is actually indexed — no extended stale window.
+ */
+declare function clearQmdResultCaches(): void;
 declare function getMemoryCacheStats(baseDir: string): {
     hotSize: number;
     archiveSize: number;
@@ -87,4 +129,4 @@ declare function getMemoryCacheStats(baseDir: string): {
     archiveVersion: number | null;
 };
 
-export { ALL_CACHE_LAYERS, type MemoryCacheLayer, clearMemoryCache, getCachedArchivedMemories, getCachedEntities, getCachedEpisodeMap, getCachedMemories, getCachedQmdSearch, getCachedRuleMemories, getMemoryCacheStats, invalidateAllForDir, invalidateCachedEntities, invalidateDerivedAndGlobalForDir, setCachedArchivedMemories, setCachedEntities, setCachedEpisodeMap, setCachedMemories, setCachedQmdSearch, setCachedRuleMemories, updateCacheOnDelete, updateCacheOnWrite };
+export { ALL_CACHE_LAYERS, type MemoryCacheLayer, type MemoryMutationScope, clearMemoryCache, clearQmdResultCaches, getCachedArchivedMemories, getCachedEntities, getCachedEpisodeMap, getCachedMemories, getCachedQmdSearch, getCachedRuleMemories, getMemoryCacheStats, invalidateAllForDir, invalidateCachedEntities, invalidateDerivedAndGlobalForDir, invalidateForScope, invalidateForScopeExceptHot, setCachedArchivedMemories, setCachedEntities, setCachedEpisodeMap, setCachedMemories, setCachedQmdSearch, setCachedRuleMemories, updateCacheOnDelete, updateCacheOnWrite };

package/dist/memory-cache.js

@@ -1,6 +1,7 @@
 import {
   ALL_CACHE_LAYERS,
   clearMemoryCache,
+  clearQmdResultCaches,
   getCachedArchivedMemories,
   getCachedEntities,
   getCachedEpisodeMap,
@@ -11,6 +12,8 @@ import {
   invalidateAllForDir,
   invalidateCachedEntities,
   invalidateDerivedAndGlobalForDir,
+  invalidateForScope,
+  invalidateForScopeExceptHot,
   setCachedArchivedMemories,
   setCachedEntities,
   setCachedEpisodeMap,
@@ -19,12 +22,13 @@ import {
   setCachedRuleMemories,
   updateCacheOnDelete,
   updateCacheOnWrite
-} from "./chunk-X47LWMKA.js";
+} from "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   ALL_CACHE_LAYERS,
   clearMemoryCache,
+  clearQmdResultCaches,
   getCachedArchivedMemories,
   getCachedEntities,
   getCachedEpisodeMap,
@@ -35,6 +39,8 @@ export {
   invalidateAllForDir,
   invalidateCachedEntities,
   invalidateDerivedAndGlobalForDir,
+  invalidateForScope,
+  invalidateForScopeExceptHot,
   setCachedArchivedMemories,
   setCachedEntities,
   setCachedEpisodeMap,

package/dist/memory-corpus-version.js

@@ -1,8 +1,8 @@
 import {
   MEMORY_CORPUS_VERSION_SENTINEL,
   bumpMemoryCorpusVersionForDir
-} from "./chunk-OKUEZOGW.js";
-import "./chunk-X47LWMKA.js";
+} from "./chunk-AITCS2RC.js";
+import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-PDJTHRAW.js";
 import "./chunk-PZ5AY32C.js";

package/dist/memory-lifecycle-ledger-utils.d.ts

@@ -1,4 +1,4 @@
-import { ao as MemoryLifecycleEventType, M as MemoryFile, x as MemoryLifecycleEvent, p as MemoryFrontmatter, v as MemoryStatus, ap as MemoryLifecycleStateSummary } from './types-Bl4BWDM8.js';
+import { ao as MemoryLifecycleEventType, M as MemoryFile, x as MemoryLifecycleEvent, p as MemoryFrontmatter, v as MemoryStatus, ap as MemoryLifecycleStateSummary } from './types-Cg8q7W7_.js';
 import './message-parts/index.js';
 
 declare const MEMORY_LIFECYCLE_RULE_VERSION = "memory-lifecycle-ledger.v1";