@remnic/core 10.0.6 → 10.0.7

package/dist/utils/sleep.d.ts

@@ -0,0 +1,3 @@
+/** Wait without cancellation; keep the timer referenced so awaited polling can finish. */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C"}

package/dist/verified-recall.js

@@ -1,14 +1,14 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-XPRAOTJY.js";
+} from "./chunk-MHGHEBTR.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-37HCPM56.js";
-import "./chunk-46WM6JX2.js";
+import "./chunk-OX5LMCEQ.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-RSMIRLKM.js";
-import "./chunk-U6OXJQEH.js";
+import "./chunk-YV54LYEB.js";
+import "./chunk-J5QL66XK.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -30,7 +30,7 @@ import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-EIFYYHAF.js";
+import "./chunk-YYO447A7.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
@@ -38,18 +38,18 @@ import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-W5XWHTDO.js";
+import "./chunk-QZZPUREO.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-R7QY5ZVB.js";
+import "./chunk-4NDWE44P.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-AJ6ORARY.js";
+import "./chunk-JALYQUYO.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
-import "./chunk-IM2GO42H.js";
+import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
@@ -69,30 +69,31 @@ import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
 import "./chunk-QWWMS4AE.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-XVC7JU2N.js";
+import "./chunk-FQD2KPQH.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows-cli.js

@@ -4,14 +4,14 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-FC6RCOIU.js";
-import "./chunk-XQSJXNWC.js";
-import "./chunk-37HCPM56.js";
-import "./chunk-46WM6JX2.js";
+} from "./chunk-JFGX2DKT.js";
+import "./chunk-Z4CETAL7.js";
+import "./chunk-OX5LMCEQ.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-RSMIRLKM.js";
-import "./chunk-U6OXJQEH.js";
+import "./chunk-YV54LYEB.js";
+import "./chunk-J5QL66XK.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -33,7 +33,7 @@ import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-EIFYYHAF.js";
+import "./chunk-YYO447A7.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
@@ -41,18 +41,18 @@ import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-W5XWHTDO.js";
+import "./chunk-QZZPUREO.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-R7QY5ZVB.js";
+import "./chunk-4NDWE44P.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-AJ6ORARY.js";
+import "./chunk-JALYQUYO.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
-import "./chunk-IM2GO42H.js";
+import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
@@ -72,30 +72,31 @@ import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
 import "./chunk-QWWMS4AE.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-XVC7JU2N.js";
+import "./chunk-FQD2KPQH.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows.js

@@ -9,13 +9,13 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-XQSJXNWC.js";
-import "./chunk-37HCPM56.js";
-import "./chunk-46WM6JX2.js";
+} from "./chunk-Z4CETAL7.js";
+import "./chunk-OX5LMCEQ.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-RSMIRLKM.js";
-import "./chunk-U6OXJQEH.js";
+import "./chunk-YV54LYEB.js";
+import "./chunk-J5QL66XK.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -37,7 +37,7 @@ import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-EIFYYHAF.js";
+import "./chunk-YYO447A7.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
@@ -45,18 +45,18 @@ import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-W5XWHTDO.js";
+import "./chunk-QZZPUREO.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-R7QY5ZVB.js";
+import "./chunk-4NDWE44P.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-AJ6ORARY.js";
+import "./chunk-JALYQUYO.js";
 import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
-import "./chunk-IM2GO42H.js";
+import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
@@ -76,30 +76,31 @@ import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
 import "./chunk-QWWMS4AE.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-XVC7JU2N.js";
+import "./chunk-FQD2KPQH.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/write-envelope.js

@@ -12,16 +12,17 @@ import {
   isMemoryCategory,
   isSealedMemoryEnvelope,
   sealedWriteToLegacyArgs
-} from "./chunk-5AYUHSAU.js";
+} from "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-VFTK5WKI.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-MAAL6OZV.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-VS2IYZRU.js";

package/package.json

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

package/src/access-idempotency.ts

@@ -1,6 +1,7 @@
 import { mkdir, open, readFile, rename, stat, unlink, utimes, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
+import { sleep } from "./utils/sleep.js";
 
 type AccessIdempotencyEntry = {
   recordedAt: string;
@@ -359,7 +360,3 @@ async function unlinkStaleLockIfStillOwned(options: {
   await unlink(options.lockPath);
   return true;
 }
-
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/src/http-retry.ts

@@ -13,6 +13,8 @@
  * `@remnic/core/abort-error`) — the root index stays untouched.
  */
 
+import { sleep as defaultSleep } from "./utils/sleep.js";
+
 export interface RetryingFetchOptions {
   /** Request init for every attempt. Ignored when `buildInit` is set. */
   init?: RequestInit;
@@ -70,12 +72,6 @@ const DEFAULT_MAX_RETRIES = 3;
 const DEFAULT_MAX_RETRY_DELAY_MS = 30_000;
 const DEFAULT_BACKOFF_BASE_MS = 1_000;
 
-function defaultSleep(ms: number): Promise<void> {
-  const { promise, resolve } = Promise.withResolvers<void>();
-  setTimeout(resolve, ms);
-  return promise;
-}
-
 /**
  * Network/timeout failures wrap Node error text that can carry loader
  * paths or stack fragments; sync errors reach MCP clients verbatim, so

package/src/memory-projection-batch.test.ts

@@ -0,0 +1,55 @@
+import assert from "node:assert/strict";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { readProjectedMemoryStates } from "./memory-projection-batch.js";
+import { getMemoryProjectionPath, readProjectedMemoryState } from "./memory-projection-store.js";
+import { rebuildMemoryProjection } from "./maintenance/rebuild-memory-projection.js";
+import { openBetterSqlite3 } from "./runtime/better-sqlite.js";
+import { StorageManager } from "./storage.js";
+
+test("projection batches return only requested rows and preserve completeness metadata", async () => {
+  const memoryDir = await mkdtemp(path.join(tmpdir(), "remnic-projection-batch-"));
+  try {
+    assert.equal(readProjectedMemoryStates(memoryDir, ["missing"]), null);
+    const storage = new StorageManager(memoryDir);
+    await storage.ensureDirectories();
+    const source = await storage.writeMemory("fact", "batch source payload", {
+      source: "test", tags: ["zeta", "alpha"], entityRef: "person:narwhal", confidence: 0.9,
+    });
+    const excluded = await storage.writeMemory("fact", "unrequested source payload", { source: "test" });
+    await rebuildMemoryProjection({ memoryDir, storage, dryRun: false });
+
+    const batch = readProjectedMemoryStates(memoryDir, new Set([source.id, "missing"]));
+    assert.ok(batch);
+    assert.deepEqual([...batch.states.keys()], [source.id]);
+    assert.equal(batch.states.has(excluded.id), false);
+    assert.deepEqual(batch.states.get(source.id), readProjectedMemoryState(memoryDir, source.id));
+    assert.deepEqual(batch.states.get(source.id)?.tags, ["alpha", "zeta"]);
+    assert.equal(batch.states.get(source.id)?.preview, "batch source payload");
+    assert.equal(batch.complete, true);
+    assert.ok(Number.isFinite(Date.parse(batch.rebuiltAt ?? "")));
+    assert.deepEqual(readProjectedMemoryStates(memoryDir, []), { ...batch, states: new Map() });
+
+    const db = openBetterSqlite3(getMemoryProjectionPath(memoryDir));
+    try {
+      const stamp = db.prepare("SELECT value FROM meta WHERE key = 'rebuiltAt'").get() as { value: string };
+      assert.equal(batch.rebuiltAt, stamp.value);
+      db.prepare("UPDATE meta SET value = 'false' WHERE key = 'complete'").run();
+      assert.equal(readProjectedMemoryStates(memoryDir, [source.id])?.complete, false);
+      db.prepare("DELETE FROM meta WHERE key IN ('complete', 'rebuiltAt')").run();
+      const legacy = readProjectedMemoryStates(memoryDir, [source.id]);
+      assert.ok(legacy);
+      assert.equal(legacy.complete, false);
+      assert.equal(legacy.rebuiltAt, null);
+      assert.deepEqual(legacy.states, batch.states);
+      db.exec("DROP TABLE memory_current");
+      assert.equal(readProjectedMemoryStates(memoryDir, [source.id]), null, "unreadable schema must fall back");
+    } finally {
+      db.close();
+    }
+  } finally {
+    await rm(memoryDir, { recursive: true, force: true });
+  }
+});

package/src/offline-sync-digest-cache.test.ts

@@ -0,0 +1,45 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { parseOfflineSyncDigestCache } from "./offline-sync-digest-cache.js";
+
+const digest = {
+  statBytes: 120, mtimeMs: 1_760_000_000_000, ctimeMs: 1_760_000_000_500,
+  encrypted: false, sha256: "a".repeat(64), bytes: 118,
+};
+const entry = { path: "facts/alpha.md", ...digest };
+const cacheFile = (entries: unknown[]) => JSON.stringify({ version: 1, entries });
+
+test("digest cache parses valid plaintext and encrypted entries without losing fields", () => {
+  const encrypted = { ...digest, encrypted: true, bytes: 0, sha256: "ABCDEF0123456789".repeat(4) };
+  assert.deepEqual([...parseOfflineSyncDigestCache(cacheFile([
+    entry, { path: "facts/beta.md", ...encrypted },
+  ]))], [[entry.path, digest], ["facts/beta.md", encrypted]]);
+});
+
+test("digest cache skips legacy records missing stat data but does not expire old timestamps", () => {
+  const old = { ...digest, mtimeMs: 1, ctimeMs: 1 };
+  const legacy = ["statBytes", "mtimeMs", "ctimeMs", "bytes", "sha256"].map((field) => ({
+    ...entry, [field]: undefined,
+  }));
+  // Freshness is checked against the file's stat by the caller, not by an age-based TTL here.
+  assert.deepEqual([...parseOfflineSyncDigestCache(cacheFile([
+    ...legacy, { path: "facts/old.md", ...old },
+  ]))], [["facts/old.md", old]]);
+});
+
+test("digest cache rejects garbage shapes and unsafe records while retaining valid siblings", () => {
+  for (const raw of ["null", "[]", "42", "{}", '{"entries":{}}']) {
+    assert.equal(parseOfflineSyncDigestCache(raw).size, 0);
+  }
+  const invalid = [
+    null, [], "garbage",
+    ...["", "..", "../escape.md", "/absolute.md"].map((path) => ({ ...entry, path })),
+    { ...entry, sha256: "z".repeat(64) }, { ...entry, sha256: "abc" },
+    { ...entry, statBytes: "120" }, { ...entry, mtimeMs: 1e400 },
+    { ...entry, ctimeMs: null }, { ...entry, bytes: "118" },
+  ];
+  assert.deepEqual([...parseOfflineSyncDigestCache(cacheFile([...invalid, entry]))], [[entry.path, digest]]);
+  for (const raw of ["", "{", '{"entries":[}']) {
+    assert.throws(() => parseOfflineSyncDigestCache(raw), SyntaxError);
+  }
+});

package/src/procedural/procedure-miner.ts

@@ -14,6 +14,7 @@ import { clusterByKey } from "./reinforcement-core.js";
 import { log } from "../logger.js";
 import { composeMemoryEnvelope, STRUCTURED_ATTRIBUTE_LIMITS } from "../write-envelope.js";
 import { isErrnoCode } from "../utils/errno.js";
+import { sleep } from "../utils/sleep.js";
 
 /** Must match truncation on `procedure_cluster` structured attribute (dedupe + storage). */
 const PROCEDURE_CLUSTER_ATTR_MAX = 500;
@@ -51,10 +52,6 @@ function clusterKeyHash(cluster: string): string {
   return createHash("sha256").update(cluster).digest("hex");
 }
 
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 async function acquireClusterWriteLock(memoryDir: string, clusterHash: string): Promise<() => Promise<void>> {
   const lockRoot = path.join(path.resolve(memoryDir), "state", "procedure-miner-locks");
   const lockDir = path.join(lockRoot, `${clusterHash}.lock`);

package/src/qmd-daemon-session.ts

@@ -2,6 +2,7 @@ import { abortError, throwIfAborted } from "./abort-error.js";
 import { log } from "./logger.js";
 import { type CommandChildProcess, launchProcess } from "./runtime/child-process.js";
 import { mergeEnv } from "./runtime/env.js";
+import { sleep } from "./utils/sleep.js";
 
 export type QmdRuntimeEnv = Record<string, string | undefined>;
 
@@ -20,10 +21,6 @@ type PendingRequest = {
 
 let nextJsonRpcId = 1;
 
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 /**
  * Drop C0 controls and one ANSI CSI sequence. Char scan on purpose:
  * the regex-safety ratchet flags new regular expressions on changed lines.

package/src/qmd.ts

@@ -218,10 +218,6 @@ function getGlobalQmdState(): QmdGlobalState {
   return state;
 }
 
-function sleep(ms: number): Promise<void> {
-  return new Promise((r) => setTimeout(r, ms));
-}
-
 function errorMessage(err: unknown): string {
   if (typeof err === "string") return err;
   if (err instanceof Error) return err.message;

package/src/testing/orchestrator-lite.ts

@@ -18,6 +18,8 @@ import { getAbstractionNodeStoreStatus, type AbstractionNodeStoreStatus } from "
 import type { Orchestrator } from "../orchestrator.js";
 import type { ExtractionRunCoordinatorDeps } from "../orchestration/extraction-run.js";
 import type { BufferTurn, ExtractionResult, PluginConfig } from "../types.js";
+import { sleep } from "../utils/sleep.js";
+export { sleep } from "../utils/sleep.js";
 
 /**
  * Offline-safe config: QMD off, embedding fallback off, planner off (so the
@@ -76,13 +78,6 @@ export function pastIso(): string {
   return new Date(Date.now() - 3600_000).toISOString();
 }
 
-/** Linear async sleep (shared by the retrying cleanup and pollers). */
-export function sleep(ms: number): Promise<void> {
-  const { promise, resolve } = Promise.withResolvers<void>();
-  setTimeout(resolve, ms);
-  return promise;
-}
-
 /**
  * Remove a temp memory dir, retrying transient ENOTEMPTY/EBUSY races: the
  * orchestrator keeps best-effort background writers that can still be running

package/src/utils/serialize-mutations.ts

@@ -22,6 +22,7 @@
 import { randomUUID } from "node:crypto";
 import { link, mkdir, open, readFile, rename, stat, unlink, utimes } from "node:fs/promises";
 import path from "node:path";
+import { sleep } from "./sleep.js";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // 1. serializeMutations — keyed async serialization with rejection recovery
@@ -732,16 +733,3 @@ async function refreshHeldLock(
   }
   return lockHeldBySelf(held);
 }
-
-function sleep(ms: number): Promise<void> {
-  // Manual deferred instead of Promise.withResolvers (ES2024) — plugin-openclaw's
-  // standalone tsconfig targets ES2022 lib and this module is reachable from its
-  // type graph, so withResolvers would TS2550 there (same fix as
-  // extraction-faithfulness.ts:467).
-  return new Promise<void>((resolve) => {
-    // NOT unref'd: this polls inside an awaited acquire loop, so the caller's
-    // await chain keeps the loop alive; unref would let Node exit mid-poll when
-    // nothing else is pending (the heartbeat interval IS unref'd separately).
-    setTimeout(resolve, ms);
-  });
-}

package/src/utils/sleep.test.ts

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { sleep } from "./sleep.js";
+
+test("sleep preserves delays, stays referenced, and settles only when its timer fires", async (t) => {
+  let fire: () => void = () => assert.fail("timer was not scheduled");
+  const delays: number[] = [];
+  const unref = t.mock.fn();
+  t.mock.method(globalThis, "setTimeout", (callback: () => void, ms: number) => {
+    delays.push(ms);
+    fire = callback;
+    return { unref };
+  });
+  const clear = t.mock.method(globalThis, "clearTimeout", () => {});
+
+  for (const ms of [0, 10, 25, 100, 250, 1_000]) {
+    let settled = false;
+    const waiting = sleep(ms).then((value) => {
+      settled = true;
+      assert.equal(value, undefined);
+    });
+    await Promise.resolve();
+    assert.equal(settled, false, "sleep must not resolve before its timer");
+    fire();
+    await waiting;
+    assert.equal(settled, true);
+  }
+
+  assert.deepEqual(delays, [0, 10, 25, 100, 250, 1_000]);
+  assert.equal(unref.mock.callCount(), 0, "awaited poll timers must keep the process alive");
+  assert.equal(clear.mock.callCount(), 0, "the non-cancellable helper must not cancel its timers");
+});

package/src/utils/sleep.ts

@@ -0,0 +1,5 @@
+/** Wait without cancellation; keep the timer referenced so awaited polling can finish. */
+export function sleep(ms: number): Promise<void> {
+  // Constructor form keeps this reachable utility compatible with ES2022 adapter type graphs.
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}