@remnic/core 9.69.50 → 9.69.51

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-4PXFLDMJ.js";
+} from "../chunk-MNF6PTNL.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-X6B2QWXW.js";
-import "../chunk-3RZB7TYL.js";
+} from "../chunk-DX63RFDJ.js";
+import "../chunk-2EICZYIG.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,19 +56,19 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-OQZYHCWM.js";
+} from "../chunk-2G2CVN2T.js";
 import "../chunk-W4F3C7N7.js";
 import "../chunk-MPC7TYTZ.js";
-import "../chunk-ZHXSOMYH.js";
+import "../chunk-VVX5PZFS.js";
 import "../chunk-IFBSZGW3.js";
 import "../chunk-QKCXRS5A.js";
 import "../chunk-C3QXITIP.js";
 import "../chunk-VQ7B2Q6M.js";
-import "../chunk-KOEDSRF5.js";
+import "../chunk-ETNC6TT6.js";
 import "../chunk-PJSK6OJM.js";
+import "../chunk-ROBHL3GL.js";
 import "../chunk-GNVZQ5JN.js";
 import "../chunk-YN2UN7N3.js";
-import "../chunk-ROBHL3GL.js";
 import "../chunk-BXOPUJ3W.js";
 import "../chunk-6DNMUYEE.js";
 import "../chunk-P5FPO2BR.js";
@@ -82,21 +82,21 @@ import "../chunk-VYDGHJIN.js";
 import "../chunk-UVEBBXB5.js";
 import "../chunk-7O5EW7KX.js";
 import "../chunk-H7XKCNR6.js";
-import "../chunk-DH536WT2.js";
+import "../chunk-ST7FDKZT.js";
 import "../chunk-SOBJ6NEY.js";
-import "../chunk-ECLY4NZA.js";
-import "../chunk-PMLFPVYJ.js";
+import "../chunk-LZI6FWZW.js";
+import "../chunk-CKBA2MWS.js";
 import "../chunk-CVILPI77.js";
 import "../chunk-6WHJ2EAB.js";
 import "../chunk-AQEJKOKI.js";
 import "../chunk-HM7RHKS4.js";
 import "../chunk-UD7UNYRD.js";
 import "../chunk-IISBCCWR.js";
-import "../chunk-E64HBW7M.js";
-import "../chunk-2IVHOQRY.js";
+import "../chunk-DLXBMXIB.js";
+import "../chunk-2ERLN25A.js";
 import "../chunk-2YA5N2BY.js";
 import "../chunk-HWLIMQE2.js";
-import "../chunk-UI6R2YUB.js";
+import "../chunk-IGDEKECC.js";
 import "../chunk-EI6V5UXY.js";
 import "../chunk-CEO4DONG.js";
 import "../chunk-SGUDMW2K.js";
@@ -110,21 +110,21 @@ import "../chunk-LTHVM4XN.js";
 import "../chunk-C37ZRXX7.js";
 import "../chunk-B4EGAHHS.js";
 import "../chunk-IHOXK2I6.js";
-import "../chunk-UD6W67JM.js";
+import "../chunk-72AV2H3R.js";
 import "../chunk-NAFPHFDM.js";
 import "../chunk-RF2SMMPP.js";
 import "../chunk-AJBWVDRV.js";
-import "../chunk-HS75MCQF.js";
+import "../chunk-WUUGE7QC.js";
+import "../chunk-HRATODNO.js";
 import "../chunk-WTWQA7BB.js";
 import "../chunk-VZIAVM72.js";
-import "../chunk-HRATODNO.js";
-import "../chunk-D7QX26FF.js";
-import "../chunk-ZUNYFDI4.js";
-import "../chunk-6525YIYL.js";
-import "../chunk-42BV46XS.js";
+import "../chunk-O4JFBEUL.js";
+import "../chunk-JGPG5UHM.js";
+import "../chunk-SMI2G3MA.js";
+import "../chunk-T73ZC7C5.js";
 import "../chunk-UFGFMWAD.js";
 import "../chunk-BMWN7B3Y.js";
-import "../chunk-MECKA6G2.js";
+import "../chunk-ISA5U5AP.js";
 import "../chunk-3UXOZBHV.js";
 import "../chunk-PIWFNPQT.js";
 import "../chunk-5FAGCOZD.js";
@@ -140,19 +140,19 @@ import "../chunk-K2XUWZBM.js";
 import "../chunk-OD4FM2U7.js";
 import "../chunk-ZY2MNJR6.js";
 import "../chunk-TBBDFYXW.js";
-import "../chunk-XUKUMBP3.js";
-import "../chunk-D2XUSZ24.js";
+import "../chunk-XRUOO7OT.js";
+import "../chunk-RIP2AOZW.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";
@@ -224,17 +224,17 @@ import "../chunk-RGMVMVMF.js";
 import "../chunk-3QL24R5Y.js";
 import "../chunk-SYOIVK7K.js";
 import "../chunk-PQVCH2AE.js";
-import "../chunk-F5V7KRQS.js";
+import "../chunk-LIAKZGOY.js";
 import "../chunk-UDAUULK2.js";
 import "../chunk-GDYU6VF4.js";
 import "../chunk-BT7NVCML.js";
 import "../chunk-353C5UNV.js";
 import "../chunk-VYCOJKSX.js";
-import "../chunk-AYP2FZFA.js";
-import "../chunk-IPLYGWQF.js";
-import "../chunk-J4EB7DNW.js";
+import "../chunk-YIIW2OH2.js";
+import "../chunk-VDX2J7OX.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
@@ -321,9 +321,9 @@ import "../chunk-46EST7JO.js";
 import "../chunk-G73MCJKL.js";
 import "../chunk-A2IYSXDQ.js";
 import "../chunk-B6O2YLUR.js";
-import "../chunk-TVVEYCNW.js";
+import "../chunk-DAOMWGO2.js";
 import "../chunk-RFYAYKTD.js";
-import "../chunk-LBLXEFWK.js";
+import "../chunk-4MN27537.js";
 import "../chunk-YRLHEEQT.js";
 import "../chunk-FF4KLI5W.js";
 import "../chunk-JN72EPOE.js";

package/dist/transfer/autodetect.js

@@ -4,8 +4,8 @@ import {
 import "../chunk-2DL3OFLD.js";
 import "../chunk-G4IAEX6D.js";
 import "../chunk-765K3SAT.js";
-import "../chunk-J4EB7DNW.js";
 import "../chunk-WEHSQBFR.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-UI3NYK34.js";
 import "../chunk-GCGJW34D.js";
 import "../chunk-PZ5AY32C.js";

package/dist/transfer/backup.js

@@ -1,9 +1,9 @@
 import {
   backupMemoryDir
-} from "../chunk-2NLLXCJG.js";
+} from "../chunk-BXLOS5AJ.js";
 import "../chunk-765K3SAT.js";
+import "../chunk-DQEMWVMT.js";
 import "../chunk-J4EB7DNW.js";
-import "../chunk-X7Y7WX73.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/capsule-export.js

@@ -1,10 +1,10 @@
 import {
   exportCapsule,
   isValidCapsuleSince
-} from "../chunk-IPLYGWQF.js";
-import "../chunk-J4EB7DNW.js";
+} from "../chunk-VDX2J7OX.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/capsule-import.js

@@ -1,6 +1,6 @@
 import {
   importCapsule
-} from "../chunk-ZHXSOMYH.js";
+} from "../chunk-VVX5PZFS.js";
 import "../chunk-JPKK466T.js";
 import "../chunk-XCB6QDL6.js";
 import "../chunk-RBOJCG4T.js";
@@ -10,7 +10,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/export-okf.js

@@ -4,24 +4,24 @@ import {
   exportOkfBundle,
   firstHeading,
   parseIncludeStatus
-} from "../chunk-BHI5ILU5.js";
+} from "../chunk-25HSEIEM.js";
 import {
   OKF_EXPORT_VERSION
 } from "../chunk-UJX4I26O.js";
 import "../chunk-D24OXEPB.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-D2XUSZ24.js";
+import "../chunk-RIP2AOZW.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";

package/dist/verified-recall.js

@@ -1,20 +1,20 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-D6WX5FEF.js";
+} from "./chunk-3QZRSEAM.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-D2XUSZ24.js";
+import "./chunk-RIP2AOZW.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";

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-7TTOX6NW.js";
+import "./chunk-ETNC6TT6.js";
+import "./chunk-RIP2AOZW.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";

package/dist/who-knows.js

@@ -9,19 +9,19 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-KOEDSRF5.js";
-import "./chunk-D2XUSZ24.js";
+} from "./chunk-ETNC6TT6.js";
+import "./chunk-RIP2AOZW.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.50",
+  "version": "9.69.51",
   "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.51"
   },
   "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/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 });
+  }
+});