@remnic/core 10.0.95 → 10.0.97

package/dist/transfer/export-okf.js

@@ -4,20 +4,20 @@ import {
   exportOkfBundle,
   firstHeading,
   parseIncludeStatus
-} from "../chunk-SUTEBYGI.js";
+} from "../chunk-VRBTZDQ5.js";
 import {
   OKF_EXPORT_VERSION
 } from "../chunk-I7TR2OCU.js";
 import "../chunk-D24OXEPB.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-FWRXW7CZ.js";
+import "../chunk-D6WJNWZG.js";
 import "../chunk-QGVCFVX6.js";
 import "../chunk-UHVXE24Y.js";
-import "../chunk-IGOW4TJE.js";
-import "../chunk-RFUL2ZIQ.js";
+import "../chunk-O3JG4PD3.js";
 import "../chunk-G6OFEGUR.js";
-import "../chunk-A4F7OIC5.js";
-import "../chunk-XPXHQI6N.js";
+import "../chunk-RFUL2ZIQ.js";
+import "../chunk-BUOP3DOK.js";
+import "../chunk-FVMEZ57K.js";
 import "../chunk-DOJBV6WR.js";
 import "../chunk-PFUXPTBT.js";
 import "../chunk-CYEPCZN5.js";
@@ -49,25 +49,20 @@ import "../chunk-3WU7XOFN.js";
 import "../chunk-P4GUQSK3.js";
 import "../chunk-4LZ7SVKM.js";
 import "../chunk-YHTG64XV.js";
-import "../chunk-SQ3GEIEL.js";
-import "../chunk-IAYUTGF2.js";
+import "../chunk-KUQLUYIR.js";
+import "../chunk-O3GZPLVY.js";
 import "../chunk-5WITETWU.js";
-import "../chunk-M5GVCJSJ.js";
-import "../chunk-RBOJCG4T.js";
 import "../chunk-6CIAGZ6X.js";
-import "../chunk-7CT3AI52.js";
 import "../chunk-G7D6GZ5J.js";
 import "../chunk-7VLBZKNB.js";
 import "../chunk-Y33KJ556.js";
-import "../chunk-R23JWJD3.js";
+import "../chunk-J426U7XK.js";
 import "../chunk-NWA6IXR3.js";
+import "../chunk-AF2XMJKD.js";
 import "../chunk-OR42ZI54.js";
 import "../chunk-IUM3VSHI.js";
 import "../chunk-EZ47HOJ6.js";
-import "../chunk-AF2XMJKD.js";
 import "../chunk-23G5P7TA.js";
-import "../chunk-C64XATK7.js";
-import "../chunk-42JKGUFJ.js";
 import "../chunk-MMRTPH3J.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
@@ -111,6 +106,11 @@ import "../chunk-P7FMDTKL.js";
 import "../chunk-X4OZMANG.js";
 import "../chunk-ZEFVK7XC.js";
 import "../chunk-R2MBW2S4.js";
+import "../chunk-M5GVCJSJ.js";
+import "../chunk-RBOJCG4T.js";
+import "../chunk-7CT3AI52.js";
+import "../chunk-C64XATK7.js";
+import "../chunk-42JKGUFJ.js";
 import "../chunk-QUIRIG2P.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";

package/dist/verified-recall.js

@@ -1,16 +1,16 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-ILY5SSOM.js";
+} from "./chunk-FVPWQWIK.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-FWRXW7CZ.js";
+import "./chunk-D6WJNWZG.js";
 import "./chunk-QGVCFVX6.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-IGOW4TJE.js";
-import "./chunk-RFUL2ZIQ.js";
+import "./chunk-O3JG4PD3.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-A4F7OIC5.js";
-import "./chunk-XPXHQI6N.js";
+import "./chunk-RFUL2ZIQ.js";
+import "./chunk-BUOP3DOK.js";
+import "./chunk-FVMEZ57K.js";
 import "./chunk-DOJBV6WR.js";
 import "./chunk-PFUXPTBT.js";
 import "./chunk-CYEPCZN5.js";
@@ -42,25 +42,20 @@ import "./chunk-3WU7XOFN.js";
 import "./chunk-P4GUQSK3.js";
 import "./chunk-4LZ7SVKM.js";
 import "./chunk-YHTG64XV.js";
-import "./chunk-SQ3GEIEL.js";
-import "./chunk-IAYUTGF2.js";
+import "./chunk-KUQLUYIR.js";
+import "./chunk-O3GZPLVY.js";
 import "./chunk-5WITETWU.js";
-import "./chunk-M5GVCJSJ.js";
-import "./chunk-RBOJCG4T.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-7VLBZKNB.js";
 import "./chunk-Y33KJ556.js";
-import "./chunk-R23JWJD3.js";
+import "./chunk-J426U7XK.js";
 import "./chunk-NWA6IXR3.js";
+import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-EZ47HOJ6.js";
-import "./chunk-AF2XMJKD.js";
 import "./chunk-23G5P7TA.js";
-import "./chunk-C64XATK7.js";
-import "./chunk-42JKGUFJ.js";
 import "./chunk-MMRTPH3J.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -104,6 +99,11 @@ import "./chunk-P7FMDTKL.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-R2MBW2S4.js";
+import "./chunk-M5GVCJSJ.js";
+import "./chunk-RBOJCG4T.js";
+import "./chunk-7CT3AI52.js";
+import "./chunk-C64XATK7.js";
+import "./chunk-42JKGUFJ.js";
 import "./chunk-QUIRIG2P.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows-cli.js

@@ -4,16 +4,16 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-J7BIFOYP.js";
-import "./chunk-IQ55QGY5.js";
-import "./chunk-FWRXW7CZ.js";
+} from "./chunk-MXXTU4R2.js";
+import "./chunk-RXL67CV6.js";
+import "./chunk-D6WJNWZG.js";
 import "./chunk-QGVCFVX6.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-IGOW4TJE.js";
-import "./chunk-RFUL2ZIQ.js";
+import "./chunk-O3JG4PD3.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-A4F7OIC5.js";
-import "./chunk-XPXHQI6N.js";
+import "./chunk-RFUL2ZIQ.js";
+import "./chunk-BUOP3DOK.js";
+import "./chunk-FVMEZ57K.js";
 import "./chunk-DOJBV6WR.js";
 import "./chunk-PFUXPTBT.js";
 import "./chunk-CYEPCZN5.js";
@@ -45,25 +45,20 @@ import "./chunk-3WU7XOFN.js";
 import "./chunk-P4GUQSK3.js";
 import "./chunk-4LZ7SVKM.js";
 import "./chunk-YHTG64XV.js";
-import "./chunk-SQ3GEIEL.js";
-import "./chunk-IAYUTGF2.js";
+import "./chunk-KUQLUYIR.js";
+import "./chunk-O3GZPLVY.js";
 import "./chunk-5WITETWU.js";
-import "./chunk-M5GVCJSJ.js";
-import "./chunk-RBOJCG4T.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-7VLBZKNB.js";
 import "./chunk-Y33KJ556.js";
-import "./chunk-R23JWJD3.js";
+import "./chunk-J426U7XK.js";
 import "./chunk-NWA6IXR3.js";
+import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-EZ47HOJ6.js";
-import "./chunk-AF2XMJKD.js";
 import "./chunk-23G5P7TA.js";
-import "./chunk-C64XATK7.js";
-import "./chunk-42JKGUFJ.js";
 import "./chunk-MMRTPH3J.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -107,6 +102,11 @@ import "./chunk-P7FMDTKL.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-R2MBW2S4.js";
+import "./chunk-M5GVCJSJ.js";
+import "./chunk-RBOJCG4T.js";
+import "./chunk-7CT3AI52.js";
+import "./chunk-C64XATK7.js";
+import "./chunk-42JKGUFJ.js";
 import "./chunk-QUIRIG2P.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows.js

@@ -9,15 +9,15 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-IQ55QGY5.js";
-import "./chunk-FWRXW7CZ.js";
+} from "./chunk-RXL67CV6.js";
+import "./chunk-D6WJNWZG.js";
 import "./chunk-QGVCFVX6.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-IGOW4TJE.js";
-import "./chunk-RFUL2ZIQ.js";
+import "./chunk-O3JG4PD3.js";
 import "./chunk-G6OFEGUR.js";
-import "./chunk-A4F7OIC5.js";
-import "./chunk-XPXHQI6N.js";
+import "./chunk-RFUL2ZIQ.js";
+import "./chunk-BUOP3DOK.js";
+import "./chunk-FVMEZ57K.js";
 import "./chunk-DOJBV6WR.js";
 import "./chunk-PFUXPTBT.js";
 import "./chunk-CYEPCZN5.js";
@@ -49,25 +49,20 @@ import "./chunk-3WU7XOFN.js";
 import "./chunk-P4GUQSK3.js";
 import "./chunk-4LZ7SVKM.js";
 import "./chunk-YHTG64XV.js";
-import "./chunk-SQ3GEIEL.js";
-import "./chunk-IAYUTGF2.js";
+import "./chunk-KUQLUYIR.js";
+import "./chunk-O3GZPLVY.js";
 import "./chunk-5WITETWU.js";
-import "./chunk-M5GVCJSJ.js";
-import "./chunk-RBOJCG4T.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-7VLBZKNB.js";
 import "./chunk-Y33KJ556.js";
-import "./chunk-R23JWJD3.js";
+import "./chunk-J426U7XK.js";
 import "./chunk-NWA6IXR3.js";
+import "./chunk-AF2XMJKD.js";
 import "./chunk-OR42ZI54.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-EZ47HOJ6.js";
-import "./chunk-AF2XMJKD.js";
 import "./chunk-23G5P7TA.js";
-import "./chunk-C64XATK7.js";
-import "./chunk-42JKGUFJ.js";
 import "./chunk-MMRTPH3J.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -111,6 +106,11 @@ import "./chunk-P7FMDTKL.js";
 import "./chunk-X4OZMANG.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-R2MBW2S4.js";
+import "./chunk-M5GVCJSJ.js";
+import "./chunk-RBOJCG4T.js";
+import "./chunk-7CT3AI52.js";
+import "./chunk-C64XATK7.js";
+import "./chunk-42JKGUFJ.js";
 import "./chunk-QUIRIG2P.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/package.json

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

package/src/abstraction-nodes.ts

@@ -1,6 +1,7 @@
 import { mkdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { listJsonFilesStrict, readJsonFile, withJsonStoreMutationLock, writeJsonFileAtomic } from "./json-store.js";
+import { bumpHarmonicGraphVersion } from "./harmonic-graph-version.js";
 import { compareDeterministicStrings, mergeSortedUniqueStrings } from "./deterministic-order.js";
 import { isNotFoundError } from "./utils/errno.js";
 import {
@@ -107,7 +108,11 @@ export async function recordAbstractionNode(options: {
   const nodesDir = path.join(rootDir, "nodes", day);
   const filePath = path.join(nodesDir, `${validated.nodeId}.json`);
   await mkdir(nodesDir, { recursive: true });
-  await writeFile(filePath, JSON.stringify(validated, null, 2), "utf8");
+  try {
+    await writeFile(filePath, JSON.stringify(validated, null, 2), "utf8");
+  } finally {
+    bumpHarmonicGraphVersion(rootDir);
+  }
   return filePath;
 }
 
@@ -269,7 +274,7 @@ export async function upsertAbstractionNodes(options: {
       filePaths.push(filePath);
     }
     return filePaths;
-  });
+  }).finally(() => bumpHarmonicGraphVersion(rootDir));
 }
 
 export async function upsertAbstractionNode(options: {

package/src/access-http-cancellation.test.ts

@@ -96,6 +96,51 @@ test("HTTP recall aborts in-flight work when the client disconnects", async () =
   }
 });
 
+test("stop() does not wait for an in-flight request longer than the grace period", async () => {
+  // An in-flight recall or observe holds server.close() open. On jarvis-ml a
+  // restart sat in listener-closure until systemd's 700 s stop timeout killed
+  // the process. After the grace period stop() must cut the connection, which
+  // also aborts the request's signal.
+  const started = deferred<void>();
+  const settled = deferred<void>();
+  let observedSignal: AbortSignal | undefined;
+  const stub: Pick<EngramAccessService, "recall"> = {
+    recall: async (input: EngramAccessRecallRequest) => {
+      observedSignal = input.abortSignal;
+      started.resolve();
+      await new Promise<void>((_resolve, reject) => {
+        input.abortSignal?.addEventListener("abort", () => reject(input.abortSignal?.reason), { once: true });
+      }).finally(() => settled.resolve());
+      // SAFETY: the request is aborted before this return is read; the value is never used.
+      return {} as never;
+    },
+  };
+  // SAFETY: the server calls only recall on this route and the stub implements it.
+  const service = stub as EngramAccessService;
+  const server = new EngramAccessHttpServer({
+    service,
+    port: 0,
+    authToken: "test-token",
+    adminConsoleEnabled: false,
+    stopGraceMs: 50,
+  });
+  const status = await server.start();
+  const client = httpRequest({
+    host: "127.0.0.1",
+    port: status.port,
+    path: "/engram/v1/recall",
+    method: "POST",
+    headers: { authorization: "Bearer test-token", "content-type": "application/json" },
+  });
+  client.on("error", () => {});
+  client.end(JSON.stringify({ query: "never finishes" }));
+  await waitFor(started.promise);
+
+  await waitFor(server.stop(), 2_000);
+  await waitFor(settled.promise);
+  assert.equal(observedSignal?.aborted, true);
+});
+
 test("a queued recall rejects immediately on abort — before the holder releases — and never starts", async () => {
   const firstStarted = deferred<void>();
   const releaseFirst = deferred<void>();

package/src/access-http-types.ts

@@ -42,6 +42,8 @@ export interface EngramAccessHttpServerOptions {
   tokenPathPolicy?: (connector: string, pathname: string | undefined) => boolean;
   principal?: string;
   maxBodyBytes?: number;
+  /** How long stop() lets in-flight requests finish before it cuts their connections (default 10000 ms). */
+  stopGraceMs?: number;
   /**
    * Max non-replayed write requests per rolling window before 429
    * `write_rate_limited` (issue #1937). Positive integer; defaults to 30.

package/src/access-http.ts

@@ -289,6 +289,7 @@ export class EngramAccessHttpServer extends ReviewDeckAccessHttpBase {
   private readonly tokenPathPolicy?: (connector: string, pathname: string | undefined) => boolean;
   private readonly authenticatedPrincipal?: string;
   protected readonly maxBodyBytes: number;
+  private readonly stopGraceMs: number;
   private readonly adminConsoleEnabled: boolean;
   protected readonly adminConsolePublicDir: string;
   private readonly adminConsolePrefillToken?: string;
@@ -338,6 +339,7 @@ export class EngramAccessHttpServer extends ReviewDeckAccessHttpBase {
     this.authTokenEntriesGetter = options.authTokenEntriesGetter;
     this.tokenPathPolicy = options.tokenPathPolicy;
     this.authenticatedPrincipal = options.principal?.trim() || undefined;
+    this.stopGraceMs = Number.isFinite(options.stopGraceMs) ? Math.max(0, Math.floor(options.stopGraceMs ?? 10_000)) : 10_000;
     this.maxBodyBytes = Number.isFinite(options.maxBodyBytes)
       ? Math.max(1, Math.floor(options.maxBodyBytes ?? 131072))
       : 131072;
@@ -516,9 +518,19 @@ export class EngramAccessHttpServer extends ReviewDeckAccessHttpBase {
       try { res.end(); } catch { /* ignore */ }
     }
     this.sseClients.clear();
-    await new Promise<void>((resolve, reject) => {
+    // server.close() waits for every open request. An in-flight recall or
+    // observe (extraction can run for minutes) kept it open until systemd's
+    // 700 s stop timeout killed the process. Let requests finish for the grace
+    // period, then cut their connections; that also aborts their signals.
+    const closed = new Promise<void>((resolve, reject) => {
       server.close((err) => (err ? reject(err) : resolve()));
     });
+    const cutTimer = setTimeout(() => server.closeAllConnections(), this.stopGraceMs);
+    try {
+      await closed;
+    } finally {
+      clearTimeout(cutTimer);
+    }
   }
 
   /**

package/src/cue-anchors.ts

@@ -1,6 +1,7 @@
 import { mkdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { resolveAbstractionNodeStoreDir, validateAbstractionNode, type AbstractionNode } from "./abstraction-nodes.js";
+import { bumpHarmonicGraphVersion } from "./harmonic-graph-version.js";
 import { listJsonFilesStrict, readJsonFile, withJsonStoreMutationLock, writeJsonFileAtomic } from "./json-store.js";
 import { compareDeterministicStrings, mergeSortedUniqueStrings } from "./deterministic-order.js";
 import { isNotFoundError } from "./utils/errno.js";
@@ -163,7 +164,11 @@ export async function recordCueAnchor(options: {
   const anchorDir = path.join(rootDir, bounded.anchorType);
   const filePath = path.join(anchorDir, `${bounded.anchorId}.json`);
   await mkdir(anchorDir, { recursive: true });
-  await writeFile(filePath, JSON.stringify(bounded, null, 2), "utf8");
+  try {
+    await writeFile(filePath, JSON.stringify(bounded, null, 2), "utf8");
+  } finally {
+    bumpHarmonicGraphVersion(abstractionNodeStoreDir);
+  }
   return filePath;
 }
 
@@ -247,7 +252,7 @@ export async function upsertCueAnchors(options: {
       filePaths.push(filePath);
     }
     return filePaths;
-  });
+  }).finally(() => bumpHarmonicGraphVersion(abstractionNodeStoreDir));
 }
 
 function compareIncomingCueAnchors(left: CueAnchor, right: CueAnchor): number {
@@ -351,7 +356,7 @@ export async function pruneOrphanCueAnchors(options: {
       }
     }
     return removed;
-  });
+  }).finally(() => bumpHarmonicGraphVersion(abstractionNodeStoreDir));
 }
 
 export async function getCueAnchorStoreStatus(options: {