@remnic/core 9.69.50 → 9.69.52

package/dist/verified-recall.js

@@ -1,20 +1,20 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-D6WX5FEF.js";
+} from "./chunk-SZ7IVZGD.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-D2XUSZ24.js";
+import "./chunk-QWQB7TOB.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-TZ44E732.js";
-import "./chunk-JOP7W24J.js";
+import "./chunk-AIVRD66I.js";
+import "./chunk-PLJ2MQFT.js";
+import "./chunk-KVO2BTA4.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
-import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -22,14 +22,16 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-PQWICTRO.js";
+import "./chunk-4UVJ6EIT.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-S45INSV3.js";
 import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
+import "./chunk-ZIKENA2C.js";
 import "./chunk-PCEYGOSL.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
@@ -49,15 +51,13 @@ import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-6Q3ZTEF6.js";
 import "./chunk-ZTHGFTMW.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
-import "./chunk-S45INSV3.js";
-import "./chunk-ZIKENA2C.js";
-import "./chunk-6Q3ZTEF6.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
@@ -72,12 +72,12 @@ import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-SGHGCFVV.js";
+import "./chunk-JE334SIA.js";
 import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
-import "./chunk-7RJUVTVF.js";
 import "./chunk-C7HJ3NEI.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";

package/dist/who-knows-cli.d.ts

@@ -1,5 +1,5 @@
-import { W as WhoKnowsResult } from './access-service-BZaC-RZw.js';
-import './types-DCB90q3g.js';
+import { W as WhoKnowsResult } from './access-service-CUNM5RfA.js';
+import './types-Du6VdoAg.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -17,13 +17,13 @@ import './active-context-config.js';
 import './local-llm-config.js';
 import './semantic-merge-config.js';
 import './types-continuity.js';
-import './orchestrator-BTqT3F6X.js';
+import './orchestrator-iexgVLow.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-DNQWtOSM.js';
+import './storage-CMm-3aD3.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -39,7 +39,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-BXYC-mbU.js';
+import './local-llm-BkkEK9rn.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -48,8 +48,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-zJiLsKBY.js';
-import './catalog-DK2eHhax.js';
+import './maintenance-CLBIvVxg.js';
+import './catalog-BuMyYPUn.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -59,7 +59,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-DEzRyeyn.js';
+import './semantic-consolidation-D--qe0eE.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -81,17 +81,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-BMkR4gmY.js';
+import './dependency-propagation-delivery-BrhPjAHQ.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-Bg1rB-Dp.js';
+import './scope-profiles-BN1Dgfha.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-BCRtXU32.js';
+import './generic-recall-paths-C0J1Oxb7.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -99,7 +99,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-DGEIDOeD.js';
+import './service-VealHeqO.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -122,7 +122,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-C1q3XuAc.js';
+import './access-namespace-preflight-U9RAdxqZ.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -130,7 +130,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-CPVwgadt.js';
+import './tagging-BjsNFKWz.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows-cli.js

@@ -4,20 +4,20 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-DNO6QWCB.js";
-import "./chunk-KOEDSRF5.js";
-import "./chunk-D2XUSZ24.js";
+} from "./chunk-SPWNCGSM.js";
+import "./chunk-43IQRLEF.js";
+import "./chunk-QWQB7TOB.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-TZ44E732.js";
-import "./chunk-JOP7W24J.js";
+import "./chunk-AIVRD66I.js";
+import "./chunk-PLJ2MQFT.js";
+import "./chunk-KVO2BTA4.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
-import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -25,14 +25,16 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-PQWICTRO.js";
+import "./chunk-4UVJ6EIT.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-S45INSV3.js";
 import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
+import "./chunk-ZIKENA2C.js";
 import "./chunk-PCEYGOSL.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
@@ -52,15 +54,13 @@ import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-6Q3ZTEF6.js";
 import "./chunk-ZTHGFTMW.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
-import "./chunk-S45INSV3.js";
-import "./chunk-ZIKENA2C.js";
-import "./chunk-6Q3ZTEF6.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
@@ -75,12 +75,12 @@ import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-SGHGCFVV.js";
+import "./chunk-JE334SIA.js";
 import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
-import "./chunk-7RJUVTVF.js";
 import "./chunk-C7HJ3NEI.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";

package/dist/who-knows.d.ts

@@ -1,6 +1,6 @@
-export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-BZaC-RZw.js';
-import './types-DCB90q3g.js';
-import './orchestrator-BTqT3F6X.js';
+export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-CUNM5RfA.js';
+import './types-Du6VdoAg.js';
+import './orchestrator-iexgVLow.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
@@ -23,7 +23,7 @@ import './semantic-merge-config.js';
 import './types-continuity.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-DNQWtOSM.js';
+import './storage-CMm-3aD3.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -39,7 +39,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-BXYC-mbU.js';
+import './local-llm-BkkEK9rn.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -48,8 +48,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-zJiLsKBY.js';
-import './catalog-DK2eHhax.js';
+import './maintenance-CLBIvVxg.js';
+import './catalog-BuMyYPUn.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -59,7 +59,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-DEzRyeyn.js';
+import './semantic-consolidation-D--qe0eE.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -81,17 +81,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-BMkR4gmY.js';
+import './dependency-propagation-delivery-BrhPjAHQ.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-Bg1rB-Dp.js';
+import './scope-profiles-BN1Dgfha.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-BCRtXU32.js';
+import './generic-recall-paths-C0J1Oxb7.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -99,7 +99,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-DGEIDOeD.js';
+import './service-VealHeqO.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -122,7 +122,7 @@ import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
 import './recall-navigation.js';
-import './access-namespace-preflight-C1q3XuAc.js';
+import './access-namespace-preflight-U9RAdxqZ.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -130,7 +130,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
-import './tagging-CPVwgadt.js';
+import './tagging-BjsNFKWz.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows.js

@@ -9,19 +9,19 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-KOEDSRF5.js";
-import "./chunk-D2XUSZ24.js";
+} from "./chunk-43IQRLEF.js";
+import "./chunk-QWQB7TOB.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-TZ44E732.js";
-import "./chunk-JOP7W24J.js";
+import "./chunk-AIVRD66I.js";
+import "./chunk-PLJ2MQFT.js";
+import "./chunk-KVO2BTA4.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
-import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
@@ -29,14 +29,16 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-PQWICTRO.js";
+import "./chunk-4UVJ6EIT.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-S45INSV3.js";
 import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
+import "./chunk-ZIKENA2C.js";
 import "./chunk-PCEYGOSL.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
@@ -56,15 +58,13 @@ import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-6Q3ZTEF6.js";
 import "./chunk-ZTHGFTMW.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
-import "./chunk-S45INSV3.js";
-import "./chunk-ZIKENA2C.js";
-import "./chunk-6Q3ZTEF6.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
@@ -79,12 +79,12 @@ import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-SGHGCFVV.js";
+import "./chunk-JE334SIA.js";
 import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
-import "./chunk-7RJUVTVF.js";
 import "./chunk-C7HJ3NEI.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { u as MemoryCategory, N as MemorySubject } from './types-DCB90q3g.js';
+import { u as MemoryCategory, N as MemorySubject } from './types-Du6VdoAg.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.50",
+  "version": "9.69.52",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3307,7 +3307,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.69.50"
+    "@remnic/coding-graph": "^9.69.52"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-mcp-output-schemas.ts

@@ -83,7 +83,20 @@ const TOOL_OUTPUT_SCHEMAS: Readonly<Record<string, Record<string, unknown>>> = {
     query: T_STRING,
     namespace: T_STRING,
     context: T_STRING,
-    contextComposition: objectSchema({ context: T_STRING, footer: T_STRING }),
+    contextComposition: objectSchema({
+      context: T_STRING,
+      footer: T_STRING,
+      degradation: objectSchema({
+        state: T_STRING,
+        reason: T_STRING,
+        detail: T_STRING,
+        budget: objectSchema({
+          contextBudget: T_NUMBER,
+          fullChars: T_NUMBER,
+          deliveredChars: T_NUMBER,
+        }),
+      }),
+    }),
     count: T_NUMBER,
     memoryIds: T_ARRAY,
     results: T_ARRAY,

package/src/access-recall-response.ts

@@ -276,6 +276,9 @@ export async function assembleRecallResponse(
         plannerMode: snapshot?.plannerMode ?? mode,
         requestedMode: mode,
         fallbackUsed: snapshot?.fallbackUsed ?? false,
+        ...(effectiveComposition.degradation
+          ? { degradation: effectiveComposition.degradation }
+          : {}),
       };
       const auditResult = await deps.auditAdapter.record(
         resolvedAgentId || "__anonymous__",

package/src/config.ts

@@ -34,10 +34,6 @@ import { cloneDefaultSessionObserverBands } from "./session-observer-bands.js";
 import { readEnvVar, resolveHomeDir } from "./runtime/env.js";
 import { normalizeEntitySchemas } from "./entity-schema.js";
 import { expandTildePath } from "./utils/path.js";
-// Finding 4 (#394): use the shared coerce helper instead of inlining the same
-// boolean-coercion logic that connectors/index.ts already exports. The helper
-// lives in connectors/coerce.ts (a tiny, dependency-free module) so neither
-// config.ts → connectors/index.ts nor the reverse circular import arises.
 import { coerceBool, coerceBooleanLike, coerceInstallExtension, coerceNumber } from "./connectors/coerce.js";
 import { parseSubjectRuntimeConfig } from "./subject-config.js";
 import { parseRecallStateViews } from "./recall-state-view.js";
@@ -58,6 +54,7 @@ import { parseDriftDetectionConfig } from "./preferences/drift-config.js";
 import { parseDeepRecallConfig } from "./deep-recall-config.js";
 import { parseRecallNavigationConfig } from "./recall-navigation-config.js";
 import { parseSessionExperienceConfig } from "./experience/session-experience-config.js";
+import { parseSeedGraduationConfig } from "./lifecycle/seed-graduation.js";
 import { parseContradictionLocalizationConfig, parseContradictionScanConfig } from "./contradiction-config.js";
 import { parseGraphPathScoringConfig } from "./graph-path-scoring-config.js";
 import { parseWritePathDedupConfig } from "./dedup/novelty-gate.js";
@@ -639,6 +636,7 @@ const MEMORY_OS_PRESETS: Record<MemoryOsPresetName, Record<string, unknown>> = {
     // explicitly.
     procedural: { enabled: false },
     sessionExperience: { enabled: false },
+    seedGraduation: { enabled: false },
     recallNavigation: { enabled: false },
   },
   balanced: {
@@ -1834,6 +1832,7 @@ export function parseConfig(
     recallNavigation: parseRecallNavigationConfig(cfg.recallNavigation),
     // Session-end experience extraction (issue #2979) — default off.
     sessionExperience: parseSessionExperienceConfig(cfg.sessionExperience),
+    seedGraduation: parseSeedGraduationConfig(cfg.seedGraduation),
     dependencyPropagation: parseDependencyPropagationConfig(cfg),
     // Temporal Supersession (issue #375)
     temporalSupersessionEnabled: cfg.temporalSupersessionEnabled !== false, // On by default

package/src/directory-sidecars.test.ts

@@ -10,6 +10,8 @@ import {
   DIRECTORY_SIDECAR_MARKER,
   findDirectorySidecarsForQuery,
   loadDirectorySidecar,
+  parseDirectorySidecarsEnabled,
+  refreshDirectorySidecarsAfterWrite,
   runDirectorySidecarMaintenance,
 } from "./directory-sidecars.js";
 import {
@@ -266,3 +268,120 @@ test("user-authored sidecar-named files are never clobbered or removed", async (
     rmSync(root, { recursive: true, force: true });
   }
 });
+
+test("parseDirectorySidecarsEnabled defaults off and rejects nothing silently", () => {
+  assert.equal(parseDirectorySidecarsEnabled(undefined), false);
+  assert.equal(parseDirectorySidecarsEnabled(null), false);
+  assert.equal(parseDirectorySidecarsEnabled(false), false);
+  assert.equal(parseDirectorySidecarsEnabled("false"), false);
+  assert.equal(parseDirectorySidecarsEnabled(0), false);
+  assert.equal(parseDirectorySidecarsEnabled(true), true);
+  assert.equal(parseDirectorySidecarsEnabled("true"), true);
+  assert.equal(parseDirectorySidecarsEnabled(1), true);
+});
+
+test("write-path refresh is a zero-write no-op when disabled", async () => {
+  const root = store();
+  try {
+    const written = await writeMemory(
+      root,
+      "facts/2026-01-02/fact-1.md",
+      "North dome shutter cycle completed.",
+    );
+    const report = await refreshDirectorySidecarsAfterWrite(root, written, false);
+    assert.deepEqual(report.written, []);
+    assert.deepEqual(report.removed, []);
+    assert.equal(await exists(path.join(root, "facts", "2026-01-02", DIRECTORY_SIDECAR_BASENAME)), false);
+    assert.equal(await exists(path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME)), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh populates the day sidecar and the parent abstract", async () => {
+  const root = store();
+  try {
+    const written = await writeMemory(
+      root,
+      "facts/2026-01-02/fact-1.md",
+      "Telescope calibration log for the north dome.",
+    );
+    const report = await refreshDirectorySidecarsAfterWrite(root, written, true);
+    const daySidecar = path.join(root, "facts", "2026-01-02", DIRECTORY_SIDECAR_BASENAME);
+    const parentSidecar = path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME);
+    assert.ok(report.written.includes(daySidecar), "day sidecar written on the write path");
+    assert.ok(report.written.includes(parentSidecar), "parent sidecar written after the child");
+    assert.ok(
+      report.written.indexOf(daySidecar) < report.written.indexOf(parentSidecar),
+      "child sidecar written before parent (bottom-up)",
+    );
+
+    const day = await loadDirectorySidecar(path.join(root, "facts", "2026-01-02"), { refresh: false });
+    assert.equal(day?.fresh, true, "write-path reuse of fingerprints leaves the sidecar fresh");
+    assert.match(day?.overview ?? "", /Telescope calibration/);
+
+    const parent = await readFile(parentSidecar, "utf8");
+    assert.match(parent, /2026-01-02/);
+    assert.ok(parent.startsWith(DIRECTORY_SIDECAR_MARKER));
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh after delete updates the parent and prunes an emptied directory", async () => {
+  const root = store();
+  try {
+    const fact1 = await writeMemory(root, "facts/2026-01-02/fact-1.md", "First observation run.");
+    await writeMemory(root, "facts/2026-01-02/fact-2.md", "Second observation run.");
+    await refreshDirectorySidecarsAfterWrite(root, fact1, true);
+
+    rmSync(fact1);
+    const report = await refreshDirectorySidecarsAfterWrite(root, fact1, true);
+    const dayDir = path.join(root, "facts", "2026-01-02");
+    const daySidecar = await readFile(path.join(dayDir, DIRECTORY_SIDECAR_BASENAME), "utf8");
+    assert.doesNotMatch(daySidecar, /First observation/, "deleted child leaves the sidecar");
+    assert.match(daySidecar, /Second observation/);
+    assert.ok(report.written.some((p) => p === path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)));
+    assert.ok(report.written.some((p) => p === path.join(root, "facts", DIRECTORY_SIDECAR_BASENAME)));
+
+    rmSync(path.join(dayDir, "fact-2.md"));
+    const pruned = await refreshDirectorySidecarsAfterWrite(root, path.join(dayDir, "fact-2.md"), true);
+    assert.ok(pruned.removed.some((p) => p === path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)));
+    assert.equal(await exists(path.join(dayDir, DIRECTORY_SIDECAR_BASENAME)), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("write-path refresh stays inside the changed namespace and skips unrelated categories", async () => {
+  const root = store();
+  try {
+    const alpha = await writeMemory(
+      root,
+      "namespaces/alpha/facts/2026-05-01/a-1.md",
+      "Alpha wing telescope mirror audit.",
+    );
+    await writeMemory(root, "namespaces/beta/facts/2026-05-01/b-1.md", "Beta wing spectrograph dark frames.");
+    await writeMemory(root, "entities/obs-1.md", "The north dome observer rotation schedule.");
+
+    const report = await refreshDirectorySidecarsAfterWrite(root, alpha, true);
+    assert.ok(
+      report.written.every((p) => p.includes(`${path.sep}namespaces${path.sep}alpha${path.sep}`)),
+      "write-path only touches the changed namespace ancestry",
+    );
+    assert.equal(
+      await exists(path.join(root, "namespaces", "beta", "facts", "2026-05-01", DIRECTORY_SIDECAR_BASENAME)),
+      false,
+    );
+    assert.equal(await exists(path.join(root, "entities", DIRECTORY_SIDECAR_BASENAME)), false);
+
+    const scoped = await loadDirectorySidecar(
+      path.join(root, "namespaces", "alpha", "facts", "2026-05-01"),
+      { refresh: false },
+    );
+    assert.equal(scoped?.fresh, true);
+    assert.match(scoped?.overview ?? "", /telescope mirror/);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});