@remnic/core 9.3.515 → 9.3.516

package/dist/offline-sync.d.ts

@@ -128,6 +128,7 @@ declare function iterateOfflineSyncSnapshotFileRecords(options: {
     includeTranscripts?: boolean;
     readFile?: (target: OfflineSyncFileTarget) => Promise<Buffer>;
     readFileDigest?: (target: OfflineSyncFileTarget) => Promise<OfflineSyncFileDigest>;
+    signal?: AbortSignal;
 }): AsyncIterable<OfflineSyncFileRecord>;
 declare function buildOfflineSyncSnapshot(options: {
     root: string;
@@ -137,6 +138,7 @@ declare function buildOfflineSyncSnapshot(options: {
     now?: Date;
     readFile?: (target: OfflineSyncFileTarget) => Promise<Buffer>;
     readFileDigest?: (target: OfflineSyncFileTarget) => Promise<OfflineSyncFileDigest>;
+    signal?: AbortSignal;
 }): Promise<OfflineSyncSnapshot>;
 declare function buildOfflineSyncSnapshotFromBase(options: {
     root: string;
@@ -148,6 +150,7 @@ declare function buildOfflineSyncSnapshotFromBase(options: {
     now?: Date;
     readFile?: (target: OfflineSyncFileTarget) => Promise<Buffer>;
     readFileDigest?: (target: OfflineSyncFileTarget) => Promise<OfflineSyncFileDigest>;
+    signal?: AbortSignal;
 }): Promise<OfflineSyncSnapshot>;
 declare function buildOfflineSyncSnapshotForPaths(options: {
     root: string;
@@ -158,6 +161,7 @@ declare function buildOfflineSyncSnapshotForPaths(options: {
     now?: Date;
     readFile?: (target: OfflineSyncFileTarget) => Promise<Buffer>;
     readFileDigest?: (target: OfflineSyncFileTarget) => Promise<OfflineSyncFileDigest>;
+    signal?: AbortSignal;
 }): Promise<OfflineSyncSnapshot>;
 declare function readOfflineSyncFileContentChunk(options: {
     root: string;

package/dist/offline-sync.js

@@ -29,7 +29,7 @@ import {
   summarizeOfflineSyncPendingChanges,
   summarizeOfflineSyncPendingFiles,
   writeOfflineSyncState
-} from "./chunk-4Q73JBSM.js";
+} from "./chunk-ZEY4KYRQ.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-GCGJW34D.js";
 import "./chunk-KJMYHC7K.js";

package/dist/operator-toolkit.d.ts

@@ -15,7 +15,9 @@ import 'better-sqlite3';
 interface QmdRuntimeLike {
     probe(): Promise<boolean>;
     isAvailable(): boolean;
-    ensureCollection(memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(memoryDir: string, execution?: {
+        signal?: AbortSignal;
+    }): Promise<"present" | "missing" | "unknown" | "skipped">;
     debugStatus(): string;
 }
 interface ConversationIndexLike {

package/dist/operator-toolkit.js

@@ -11,17 +11,17 @@ import {
   summarizeMemoryWorthLegacyCounters,
   summarizeObservationThroughput,
   summarizeTierDistribution
-} from "./chunk-L7S47WZT.js";
-import "./chunk-EDBEWFJO.js";
+} from "./chunk-YNXOKMJP.js";
+import "./chunk-6BR7L222.js";
 import "./chunk-LZ3VEOU5.js";
 import "./chunk-YBPYIAA5.js";
-import "./chunk-7MV5CWTE.js";
-import "./chunk-EIPUHVKE.js";
-import "./chunk-A52AKD7C.js";
-import "./chunk-RCTS5CKK.js";
-import "./chunk-NJ3MJQZX.js";
-import "./chunk-BLZAVUD2.js";
-import "./chunk-PIRJPV5T.js";
+import "./chunk-KXULCVOC.js";
+import "./chunk-SML26KED.js";
+import "./chunk-FUC4LZMD.js";
+import "./chunk-FK556DDH.js";
+import "./chunk-2I5JGH3M.js";
+import "./chunk-QVJ4NWL2.js";
+import "./chunk-JNANKJLN.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-ONPLNAPX.js";
 import "./chunk-CINZGPSJ.js";
@@ -32,7 +32,7 @@ import "./chunk-ORFGK3XI.js";
 import "./chunk-HENLZHIT.js";
 import "./chunk-7DTASS5T.js";
 import "./chunk-KFY3SGN7.js";
-import "./chunk-TVRN5QKH.js";
+import "./chunk-PCI747N2.js";
 import "./chunk-CMTINOFS.js";
 import "./chunk-BEUDU7Y4.js";
 import "./chunk-G3Z3QEF5.js";

package/dist/orchestrator.js

@@ -26,7 +26,7 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-R26QUUQN.js";
+} from "./chunk-YDMVYYD2.js";
 import "./chunk-Y2SXZ5KZ.js";
 import "./chunk-BFBF3XEF.js";
 import "./chunk-S53PKKWK.js";
@@ -109,13 +109,13 @@ import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-4426WSWL.js";
 import "./chunk-A2Z6UCWT.js";
-import "./chunk-7MV5CWTE.js";
-import "./chunk-EIPUHVKE.js";
-import "./chunk-A52AKD7C.js";
-import "./chunk-RCTS5CKK.js";
-import "./chunk-NJ3MJQZX.js";
-import "./chunk-BLZAVUD2.js";
-import "./chunk-PIRJPV5T.js";
+import "./chunk-KXULCVOC.js";
+import "./chunk-SML26KED.js";
+import "./chunk-FUC4LZMD.js";
+import "./chunk-FK556DDH.js";
+import "./chunk-2I5JGH3M.js";
+import "./chunk-QVJ4NWL2.js";
+import "./chunk-JNANKJLN.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-ONPLNAPX.js";
 import "./chunk-CINZGPSJ.js";
@@ -126,7 +126,7 @@ import "./chunk-ORFGK3XI.js";
 import "./chunk-HENLZHIT.js";
 import "./chunk-7DTASS5T.js";
 import "./chunk-KFY3SGN7.js";
-import "./chunk-TVRN5QKH.js";
+import "./chunk-PCI747N2.js";
 import "./chunk-BECQDWBA.js";
 import "./chunk-CWWMTTQE.js";
 import "./chunk-JXS5PDQ7.js";

package/dist/qmd.d.ts

@@ -209,7 +209,7 @@ declare class QmdClient implements SearchBackend {
     private runUpdateForCollection;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;
-    ensureCollection(memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(memoryDir: string, execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
 }
 
 export { QMD_SUPPORTED_VERSION, type QmdCapabilities, type QmdChunkStrategy, QmdClient, type QmdClientOptions, type QmdDoctorReport, type QmdStructuredSearch, type QmdStructuredSearchType, type QmdVersionStatus, type QmdVersionTuple, compareQmdVersions, getQmdCommandName, getQmdPostInstallProbeTargets, parseQmdExplain, parseQmdVersion, parseQmdVersionOutput, resolveQmdCapabilities, shouldAutoUpgradeQmd, versionAtLeast };

package/dist/qmd.js

@@ -10,7 +10,7 @@ import {
   resolveQmdCapabilities,
   shouldAutoUpgradeQmd,
   versionAtLeast
-} from "./chunk-TVRN5QKH.js";
+} from "./chunk-PCI747N2.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-NNVTUXEB.js";
 import "./chunk-CPPS65WS.js";

package/dist/search/factory.js

@@ -2,12 +2,12 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-EIPUHVKE.js";
-import "../chunk-A52AKD7C.js";
-import "../chunk-RCTS5CKK.js";
-import "../chunk-NJ3MJQZX.js";
-import "../chunk-BLZAVUD2.js";
-import "../chunk-PIRJPV5T.js";
+} from "../chunk-SML26KED.js";
+import "../chunk-FUC4LZMD.js";
+import "../chunk-FK556DDH.js";
+import "../chunk-2I5JGH3M.js";
+import "../chunk-QVJ4NWL2.js";
+import "../chunk-JNANKJLN.js";
 import "../chunk-Q4CAQGKQ.js";
 import "../chunk-ONPLNAPX.js";
 import "../chunk-CINZGPSJ.js";
@@ -15,7 +15,7 @@ import "../chunk-KIB7SDIJ.js";
 import "../chunk-ORFGK3XI.js";
 import "../chunk-HENLZHIT.js";
 import "../chunk-7DTASS5T.js";
-import "../chunk-TVRN5QKH.js";
+import "../chunk-PCI747N2.js";
 import "../chunk-PVGDJXVK.js";
 import "../chunk-NNVTUXEB.js";
 import "../chunk-CPPS65WS.js";

package/dist/search/index.js

@@ -2,22 +2,22 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-EIPUHVKE.js";
+} from "../chunk-SML26KED.js";
 import {
   LanceDbBackend
-} from "../chunk-A52AKD7C.js";
+} from "../chunk-FUC4LZMD.js";
 import {
   MeilisearchBackend
-} from "../chunk-RCTS5CKK.js";
+} from "../chunk-FK556DDH.js";
 import {
   NoopSearchBackend
-} from "../chunk-NJ3MJQZX.js";
+} from "../chunk-2I5JGH3M.js";
 import {
   OramaBackend
-} from "../chunk-BLZAVUD2.js";
+} from "../chunk-QVJ4NWL2.js";
 import {
   RemoteSearchBackend
-} from "../chunk-PIRJPV5T.js";
+} from "../chunk-JNANKJLN.js";
 import {
   scanMemoryDir
 } from "../chunk-Q4CAQGKQ.js";
@@ -29,7 +29,7 @@ import "../chunk-KIB7SDIJ.js";
 import "../chunk-ORFGK3XI.js";
 import "../chunk-HENLZHIT.js";
 import "../chunk-7DTASS5T.js";
-import "../chunk-TVRN5QKH.js";
+import "../chunk-PCI747N2.js";
 import "../chunk-PVGDJXVK.js";
 import "../chunk-NNVTUXEB.js";
 import "../chunk-CPPS65WS.js";

package/dist/search/lancedb-backend.d.ts

@@ -39,7 +39,7 @@ declare class LanceDbBackend implements SearchBackend {
     updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;
-    ensureCollection(_memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(_memoryDir: string, _execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
     private table;
     private get lanceIndex();
     private ensureDb;

package/dist/search/lancedb-backend.js

@@ -1,6 +1,6 @@
 import {
   LanceDbBackend
-} from "../chunk-A52AKD7C.js";
+} from "../chunk-FUC4LZMD.js";
 import "../chunk-Q4CAQGKQ.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-PVGDJXVK.js";

package/dist/search/meilisearch-backend.d.ts

@@ -40,7 +40,7 @@ declare class MeilisearchBackend implements SearchBackend {
     updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;
-    ensureCollection(_memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(_memoryDir: string, _execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
     private ensureClient;
     private doSearch;
     private mapHits;

package/dist/search/meilisearch-backend.js

@@ -1,6 +1,6 @@
 import {
   MeilisearchBackend
-} from "../chunk-RCTS5CKK.js";
+} from "../chunk-FK556DDH.js";
 import "../chunk-Q4CAQGKQ.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-PVGDJXVK.js";

package/dist/search/noop-backend.d.ts

@@ -21,7 +21,7 @@ declare class NoopSearchBackend implements SearchBackend {
     updatesAllCollections(): boolean;
     embed(): Promise<void>;
     embedCollection(_collection: string): Promise<void>;
-    ensureCollection(_memoryDir: string): Promise<"skipped">;
+    ensureCollection(_memoryDir: string, _execution?: SearchExecutionOptions): Promise<"skipped">;
 }
 
 export { NoopSearchBackend };

package/dist/search/noop-backend.js

@@ -1,6 +1,6 @@
 import {
   NoopSearchBackend
-} from "../chunk-NJ3MJQZX.js";
+} from "../chunk-2I5JGH3M.js";
 import "../chunk-PZ5AY32C.js";
 export {
   NoopSearchBackend

package/dist/search/orama-backend.d.ts

@@ -41,7 +41,7 @@ declare class OramaBackend implements SearchBackend {
     updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;
-    ensureCollection(_memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(_memoryDir: string, _execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
     private ensureModules;
     private ensureDb;
     private ensureDbForCollection;

package/dist/search/orama-backend.js

@@ -1,7 +1,7 @@
 import {
   OramaBackend,
   resolveOramaCollectionDbFilePath
-} from "../chunk-BLZAVUD2.js";
+} from "../chunk-QVJ4NWL2.js";
 import "../chunk-Q4CAQGKQ.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-PVGDJXVK.js";

package/dist/search/port.d.ts

@@ -56,7 +56,7 @@ interface SearchBackend {
     updateCollectionStrict?(collection: string, execution?: SearchExecutionOptions): Promise<void>;
     embed(): Promise<void>;
     embedCollection(collection: string): Promise<void>;
-    ensureCollection(memoryDir: string): Promise<"present" | "missing" | "unknown" | "skipped">;
+    ensureCollection(memoryDir: string, execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
 }
 
 export type { SearchBackend, SearchExecutionOptions, SearchQueryOptions, SearchResult };

package/dist/search/remote-backend.d.ts

@@ -32,7 +32,7 @@ declare class RemoteSearchBackend implements SearchBackend {
     updateCollection(_collection: string, _execution?: SearchExecutionOptions): Promise<void>;
     embed(): Promise<void>;
     embedCollection(_collection: string): Promise<void>;
-    ensureCollection(_memoryDir: string): Promise<"skipped">;
+    ensureCollection(_memoryDir: string, _execution?: SearchExecutionOptions): Promise<"skipped">;
     private headers;
     private post;
 }

package/dist/search/remote-backend.js

@@ -1,6 +1,6 @@
 import {
   RemoteSearchBackend
-} from "../chunk-PIRJPV5T.js";
+} from "../chunk-JNANKJLN.js";
 import "../chunk-2ODBA7MQ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.515",
+  "version": "9.3.516",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/access-http.ts

@@ -735,6 +735,7 @@ export class EngramAccessHttpServer {
         principal: this.resolveRequestPrincipal(req),
         includeTranscripts: includeTranscriptsRaw !== "false",
         includeContent: false,
+        signal: this.createRequestAbortSignal(req, res),
       });
       await this.respondOfflineSnapshotStream(res, result);
       return;
@@ -756,6 +757,7 @@ export class EngramAccessHttpServer {
         includeContent: body.includeContent,
         baseFiles: body.baseFiles,
         ...(body.baseCapturedAt ? { baseCapturedAt: new Date(body.baseCapturedAt) } : {}),
+        signal: this.createRequestAbortSignal(req, res),
       });
       this.respondJson(res, 200, result);
       return;
@@ -1786,6 +1788,18 @@ export class EngramAccessHttpServer {
     this.respondJson(res, 404, { error: "not_found", code: "not_found" });
   }
 
+  private createRequestAbortSignal(req: IncomingMessage, res: ServerResponse): AbortSignal {
+    const controller = new AbortController();
+    const abort = () => {
+      if (!controller.signal.aborted) controller.abort();
+    };
+    req.once("aborted", abort);
+    res.once("close", () => {
+      if (!res.writableEnded) abort();
+    });
+    return controller.signal;
+  }
+
   /**
    * SSE handler for /engram/v1/graph/events.
    *

package/src/access-service-namespace.test.ts

@@ -186,27 +186,25 @@ test("offlineSyncFiles reports symlink requested paths as input errors", async (
   }
 });
 
-test("offlineSyncSnapshot ignores client capture time for server fast-base scans", async () => {
+test("offlineSyncSnapshot does not trust client base capture time for server fast-base scans", async () => {
   const root = await mkdtemp(path.join(os.tmpdir(), "remnic-offline-snapshot-client-clock-"));
   try {
     const relPath = "facts/a.md";
     const filePath = path.join(root, relPath);
-    const oldContent = Buffer.from("alpha");
-    const newContent = Buffer.from("bravo");
+    const content = Buffer.from("alpha");
     const mtimeMs = 1_700_000_000_000;
     await mkdir(path.dirname(filePath), { recursive: true });
-    await writeFile(filePath, oldContent);
+    await writeFile(filePath, content);
     await utimes(filePath, mtimeMs / 1000, mtimeMs / 1000);
     const baseFile = {
       path: relPath,
-      sha256: createHash("sha256").update(oldContent).digest("hex"),
-      bytes: oldContent.byteLength,
+      sha256: createHash("sha256").update(content).digest("hex"),
+      bytes: content.byteLength,
       mtimeMs,
     };
-    await writeFile(filePath, newContent);
-    await utimes(filePath, mtimeMs / 1000, mtimeMs / 1000);
 
     const { service } = makeService();
+    let digestReads = 0;
     (service as unknown as {
       orchestrator: {
         config: PluginConfig;
@@ -218,6 +216,7 @@ test("offlineSyncSnapshot ignores client capture time for server fast-base scans
         return readFile(targetPath);
       },
       async digestOfflineSyncFile(targetPath: string) {
+        digestReads += 1;
         const content = await readFile(targetPath);
         return {
           sha256: createHash("sha256").update(content).digest("hex"),
@@ -234,7 +233,8 @@ test("offlineSyncSnapshot ignores client capture time for server fast-base scans
       baseCapturedAt: new Date(Date.now() + 60_000),
     });
 
-    assert.equal(snapshot.files[0]?.sha256, createHash("sha256").update(newContent).digest("hex"));
+    assert.equal(digestReads, 1);
+    assert.deepEqual(snapshot.files, [baseFile]);
   } finally {
     await rm(root, { recursive: true, force: true });
   }

package/src/access-service.ts

@@ -5611,7 +5611,7 @@ export class EngramAccessService {
   }
 
   async offlineSyncSnapshot(
-    options: EngramAccessOfflineSyncSnapshotRequest = {},
+    options: EngramAccessOfflineSyncSnapshotRequest & { signal?: AbortSignal } = {},
   ): Promise<EngramAccessOfflineSyncSnapshotResponse> {
     const resolvedNamespace = this.resolveReadableNamespace(options.namespace, options.principal);
     const storage = await this.orchestrator.getStorage(resolvedNamespace);
@@ -5623,12 +5623,11 @@ export class EngramAccessService {
       root: storage.dir,
       sourceId: `remnic:${resolvedNamespace}:${storageHash}`,
       ...(options.baseFiles && options.baseFiles.length > 0 ? { baseFiles: options.baseFiles } : {}),
-      // Client clocks are not authoritative for server-side ctime reuse. A
-      // future client timestamp can hide same-size, preserved-mtime rewrites.
       includeContent: options.includeContent !== false,
       includeTranscripts: options.includeTranscripts !== false,
       readFile: async ({ filePath }) => storage.readOfflineSyncFile(filePath),
       readFileDigest: async ({ filePath }) => storage.digestOfflineSyncFile(filePath),
+      signal: options.signal,
     });
     return {
       namespace: resolvedNamespace,
@@ -5637,7 +5636,7 @@ export class EngramAccessService {
   }
 
   async offlineSyncSnapshotStream(
-    options: Omit<EngramAccessOfflineSyncSnapshotRequest, "baseCapturedAt" | "baseFiles"> = {},
+    options: Omit<EngramAccessOfflineSyncSnapshotRequest, "baseCapturedAt" | "baseFiles"> & { signal?: AbortSignal } = {},
   ): Promise<EngramAccessOfflineSyncSnapshotStreamResponse> {
     const resolvedNamespace = this.resolveReadableNamespace(options.namespace, options.principal);
     const storage = await this.orchestrator.getStorage(resolvedNamespace);
@@ -5655,6 +5654,7 @@ export class EngramAccessService {
         includeTranscripts: options.includeTranscripts !== false,
         readFile: async ({ filePath }) => storage.readOfflineSyncFile(filePath),
         readFileDigest: async ({ filePath }) => storage.digestOfflineSyncFile(filePath),
+        signal: options.signal,
       }),
     };
   }

package/src/namespaces/search.test.ts

@@ -7,6 +7,7 @@ import type { PluginConfig, QmdSearchResult } from "../types.js";
 class FakeBackend implements SearchBackend {
   updates = 0;
   calls: Array<{ method: string; collection: string | undefined }> = [];
+  ensureSignals: Array<AbortSignal | undefined> = [];
 
   constructor(
     private readonly globalUpdate: boolean,
@@ -63,7 +64,8 @@ class FakeBackend implements SearchBackend {
 
   async embedCollection(): Promise<void> {}
 
-  async ensureCollection(): Promise<"present"> {
+  async ensureCollection(_memoryDir?: string, execution?: { signal?: AbortSignal }): Promise<"present"> {
+    this.ensureSignals.push(execution?.signal);
     return "present";
   }
 }
@@ -173,3 +175,20 @@ test("searchAcrossNamespaces passes scoped collection to backend search methods"
     );
   }
 });
+
+test("ensureNamespaceCollection forwards abort signals to backend collection checks", async () => {
+  const backend = new FakeBackend(false);
+  const router = new NamespaceSearchRouter(
+    config(),
+    { storageFor: async (namespace: string) => ({ dir: `/tmp/remnic/${namespace}` }) },
+    () => backend,
+  );
+  const controller = new AbortController();
+
+  const state = await router.ensureNamespaceCollection("main", {
+    signal: controller.signal,
+  });
+
+  assert.equal(state, "present");
+  assert.deepEqual(backend.ensureSignals, [controller.signal]);
+});

package/src/namespaces/search.ts

@@ -144,8 +144,11 @@ export class NamespaceSearchRouter {
     );
   }
 
-  async ensureNamespaceCollection(namespace: string): Promise<"present" | "missing" | "unknown" | "skipped"> {
-    const record = await this.backendRecordFor(namespace);
+  async ensureNamespaceCollection(
+    namespace: string,
+    execution?: SearchExecutionOptions,
+  ): Promise<"present" | "missing" | "unknown" | "skipped"> {
+    const record = await this.backendRecordFor(namespace, execution);
     return record.collectionState;
   }
 
@@ -168,7 +171,10 @@ export class NamespaceSearchRouter {
     );
   }
 
-  private async backendRecordFor(namespace: string): Promise<NamespaceBackendRecord> {
+  private async backendRecordFor(
+    namespace: string,
+    execution?: SearchExecutionOptions,
+  ): Promise<NamespaceBackendRecord> {
     const key = namespace.trim() || this.config.defaultNamespace;
     const existing = this.cache.get(key);
     if (existing) return await existing;
@@ -189,7 +195,7 @@ export class NamespaceSearchRouter {
       const backend = this.createBackend(scopedConfig);
       const available = await backend.probe().catch(() => false);
       const collectionState = available
-        ? await backend.ensureCollection(storage.dir).catch(() => "unknown" as const)
+        ? await backend.ensureCollection(storage.dir, execution).catch(() => "unknown" as const)
         : "unknown";
       return {
         backend,