@remnic/core 10.0.58 → 10.0.60

package/dist/chunk-4LZ7SVKM.js

@@ -0,0 +1,211 @@
+import {
+  collectContainedMarkdownPaths,
+  fingerprintEntityEntries,
+  statMtimes
+} from "./chunk-YHTG64XV.js";
+import {
+  abortError
+} from "./chunk-R2MBW2S4.js";
+import {
+  log
+} from "./chunk-3WCASNQZ.js";
+
+// src/corpus-scan-worker-host.ts
+import { existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { Worker } from "worker_threads";
+function resolveWorkerEntryUrl() {
+  const candidates = [
+    "./corpus-scan-worker.entry.mjs",
+    "../corpus-scan-worker.entry.mjs"
+  ];
+  for (const candidate of candidates) {
+    const url = new URL(candidate, import.meta.url);
+    if (existsSync(fileURLToPath(url))) return url;
+  }
+  throw new Error(`corpus scan worker entry not found (looked for ${candidates.join(", ")})`);
+}
+function toError(payload, fallback) {
+  const error = new Error(payload.message === "" ? fallback : payload.message);
+  error.name = payload.name;
+  if (payload.code !== void 0) {
+    const errno = error;
+    errno.code = payload.code;
+  }
+  return error;
+}
+async function runInline(payload, checkCancelled) {
+  switch (payload.kind) {
+    case "walk":
+      return await collectContainedMarkdownPaths({
+        baseDir: payload.baseDir,
+        startDirs: payload.startDirs,
+        propagateReadErrors: payload.propagateReadErrors,
+        checkCancelled
+      });
+    case "entity-entries-fingerprint":
+      return await fingerprintEntityEntries(payload.entitiesDir);
+    case "stat-mtimes":
+      return await statMtimes(payload.paths);
+  }
+}
+var CorpusScanWorkerHost = class {
+  worker = null;
+  pending = /* @__PURE__ */ new Map();
+  nextId = 1;
+  jobCounts = /* @__PURE__ */ new Map();
+  attached = false;
+  workerUnavailable = false;
+  /** Completed jobs per kind — observability for tests and diagnostics. */
+  stats() {
+    const byKind = {};
+    let jobs = 0;
+    for (const [kind, count] of this.jobCounts) {
+      byKind[kind] = count;
+      jobs += count;
+    }
+    return { jobs, byKind };
+  }
+  /**
+   * Run one scan. It executes in the worker; when no worker can run it, the
+   * same implementation runs inline. Rejects with the job's error (errno code
+   * preserved) or an AbortError when `signal` fires first.
+   */
+  async request(payload, signal) {
+    if (signal?.aborted) throw abortError("corpus read aborted");
+    const result = await this.runInWorker(payload, signal);
+    return result;
+  }
+  async runInWorker(payload, signal) {
+    if (this.workerUnavailable) {
+      return await runInline(payload, this.cancellationCheck(signal));
+    }
+    let worker;
+    try {
+      worker = this.ensureWorker();
+    } catch (error) {
+      this.disableWorker(error instanceof Error ? error : new Error(String(error)));
+      return await runInline(payload, this.cancellationCheck(signal));
+    }
+    const id = this.nextId++;
+    this.setAttached(true);
+    try {
+      return await new Promise((resolve, reject) => {
+        const job = { kind: payload.kind, resolve, reject };
+        if (signal) {
+          const onAbort = () => {
+            this.cancelJob(id);
+            this.pending.delete(id);
+            if (this.pending.size === 0) this.setAttached(false);
+            reject(abortError("corpus read aborted"));
+          };
+          signal.addEventListener("abort", onAbort, { once: true });
+          job.cleanup = () => signal.removeEventListener("abort", onAbort);
+        }
+        this.pending.set(id, job);
+        worker.postMessage({ id, payload });
+      });
+    } catch (error) {
+      if (!this.pending.has(id) && this.workerUnavailable) {
+        return await runInline(payload, this.cancellationCheck(signal));
+      }
+      throw error;
+    }
+  }
+  cancellationCheck(signal) {
+    if (!signal) return void 0;
+    return () => {
+      if (signal.aborted) throw abortError("corpus read aborted");
+    };
+  }
+  /** Tell the worker to abandon a job (its next checkpoint stops the walk). */
+  cancelJob(id) {
+    this.worker?.postMessage({ id, cancel: true });
+  }
+  /**
+   * Attach/detach the worker's message listener. A worker with a `message`
+   * listener keeps the parent's event loop alive (the port stays ref'd), so an
+   * idle worker is detached: the daemon must be able to exit with a warm
+   * corpus-scan worker in memory.
+   */
+  setAttached(attached) {
+    const worker = this.worker;
+    if (!worker) return;
+    if (attached) {
+      if (!this.attached) {
+        worker.on("message", this.onMessage);
+        this.attached = true;
+      }
+      worker.ref();
+    } else {
+      if (this.attached) {
+        worker.removeAllListeners("message");
+        this.attached = false;
+      }
+      worker.unref();
+    }
+  }
+  onMessage = (message) => {
+    const job = this.pending.get(message.id);
+    if (!job) return;
+    this.pending.delete(message.id);
+    job.cleanup?.();
+    this.jobCounts.set(job.kind, (this.jobCounts.get(job.kind) ?? 0) + 1);
+    if (message.ok && message.result !== void 0) job.resolve(message.result);
+    else job.reject(toError(message.error ?? { name: "Error", message: "corpus scan worker job failed" }, "corpus scan worker job failed"));
+    if (this.pending.size === 0) this.setAttached(false);
+  };
+  /**
+   * Disable the worker and say why, exactly once: after this, every corpus
+   * scan runs inline on the main thread, which is the starvation this module
+   * exists to avoid. Silence here would hide the regression.
+   */
+  disableWorker(error) {
+    if (this.workerUnavailable) return;
+    this.workerUnavailable = true;
+    log.warn("corpus scan worker unavailable; falling back to inline scans", error);
+  }
+  ensureWorker() {
+    if (this.worker) return this.worker;
+    const worker = new Worker(resolveWorkerEntryUrl());
+    worker.unref();
+    worker.on("error", (error) => {
+      if (this.worker !== worker) return;
+      this.failAll(error);
+      this.disableWorker(error);
+    });
+    worker.on("exit", () => {
+      if (this.worker !== worker) return;
+      this.worker = null;
+      this.attached = false;
+      this.failAll(new Error("corpus scan worker exited"));
+    });
+    this.worker = worker;
+    return worker;
+  }
+  failAll(error) {
+    for (const [id, job] of [...this.pending]) {
+      this.pending.delete(id);
+      job.cleanup?.();
+      job.reject(error);
+    }
+  }
+  /**
+   * Terminate the worker and reject in-flight jobs. The next request spawns a
+   * fresh worker, so a shutdown (or a test teardown) leaves no handle behind.
+   */
+  close() {
+    const worker = this.worker;
+    this.worker = null;
+    this.attached = false;
+    this.failAll(new Error("corpus scan worker closed"));
+    void worker?.terminate();
+  }
+};
+var corpusScanWorker = new CorpusScanWorkerHost();
+
+export {
+  CorpusScanWorkerHost,
+  corpusScanWorker
+};
+//# sourceMappingURL=chunk-4LZ7SVKM.js.map

package/dist/chunk-4LZ7SVKM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/corpus-scan-worker-host.ts"],"sourcesContent":["/**\n * Corpus-scan worker host (main-thread starvation fix).\n *\n * The periodic corpus maintenance scans are pure, read-only filesystem work\n * whose volume scales with the corpus (hundreds of thousands of files on a\n * large deployment). Running them on the daemon's main thread starves observe,\n * recall and the extraction queue: every awaited syscall is a main-thread\n * continuation.\n *\n * This host runs the scans in ONE `worker_threads` worker so the main thread\n * stays free. The worker entry is plain JavaScript\n * (`corpus-scan-worker.entry.mjs`, generated from the TypeScript source), so\n * it loads on every runtime the package supports — no TypeScript loader is\n * needed inside a worker thread.\n *\n * Lifecycle:\n *   - lazy spawn on the first job; `unref()`ed, so it never keeps the process\n *     alive;\n *   - a cancelled job is rejected on the main thread immediately and the\n *     worker is told to stop the walk at its next checkpoint;\n *   - a worker that cannot start (or dies before answering) makes the host run\n *     the SAME implementation inline, so the scan still happens;\n *   - `close()` terminates the worker and rejects in-flight jobs.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { Worker } from \"node:worker_threads\";\nimport { abortError } from \"./abort-error.js\";\nimport { log } from \"./logger.js\";\nimport {\n  collectContainedMarkdownPaths,\n  fingerprintEntityEntries,\n  statMtimes,\n} from \"./corpus-scan.js\";\n\n/** The scans the worker can run. */\nexport type CorpusScanJobKind = \"walk\" | \"entity-entries-fingerprint\" | \"stat-mtimes\";\n\n/** Job payloads, one per kind. */\nexport type CorpusScanPayload =\n  | { kind: \"walk\"; baseDir: string; startDirs: string[]; propagateReadErrors: boolean }\n  | { kind: \"entity-entries-fingerprint\"; entitiesDir: string }\n  | { kind: \"stat-mtimes\"; paths: string[] };\n\n/** Result shape per job kind. */\nexport interface CorpusScanResults {\n  walk: string[];\n  \"entity-entries-fingerprint\": string;\n  \"stat-mtimes\": Array<number | null>;\n}\n\n/** Every result shape the worker can return, in one union. */\nexport type CorpusScanResult = string[] | string | Array<number | null>;\n\n/** A worker-side failure, flattened for the thread boundary. */\nexport interface CorpusScanErrorPayload {\n  name: string;\n  message: string;\n  code?: string;\n}\n\n/** A message posted back from the worker. */\nexport interface CorpusScanReply {\n  id: number;\n  ok: boolean;\n  result?: CorpusScanResult;\n  error?: CorpusScanErrorPayload;\n}\n\n/** Completed-job counters per kind. */\nexport interface CorpusScanStats {\n  jobs: number;\n  byKind: Record<string, number>;\n}\n\ninterface PendingJob {\n  kind: CorpusScanJobKind;\n  resolve: (value: CorpusScanResult) => void;\n  reject: (error: Error) => void;\n  cleanup?: () => void;\n}\n\n/**\n * Resolve the worker entry beside THIS module: the source tree keeps the\n * generated JavaScript entry at `src/corpus-scan-worker.entry.mjs` and the\n * built package copies it next to the bundled host, so the same relative path\n * works in both.\n */\nfunction resolveWorkerEntryUrl(): URL {\n  const candidates = [\n    \"./corpus-scan-worker.entry.mjs\",\n    \"../corpus-scan-worker.entry.mjs\",\n  ];\n  for (const candidate of candidates) {\n    const url = new URL(candidate, import.meta.url);\n    if (existsSync(fileURLToPath(url))) return url;\n  }\n  throw new Error(`corpus scan worker entry not found (looked for ${candidates.join(\", \")})`);\n}\n\nfunction toError(payload: CorpusScanErrorPayload, fallback: string): Error {\n  const error = new Error(payload.message === \"\" ? fallback : payload.message);\n  error.name = payload.name;\n  if (payload.code !== undefined) {\n    // SAFETY: the errno `code` is an optional string on an Error, and the\n    // worker only forwards a code it read off a filesystem rejection.\n    const errno = error as NodeJS.ErrnoException;\n    errno.code = payload.code;\n  }\n  return error;\n}\n\n/** Run the same scan inline (the fallback when no worker is available). */\nasync function runInline(payload: CorpusScanPayload, checkCancelled?: () => void): Promise<CorpusScanResult> {\n  switch (payload.kind) {\n    case \"walk\":\n      return await collectContainedMarkdownPaths({\n        baseDir: payload.baseDir,\n        startDirs: payload.startDirs,\n        propagateReadErrors: payload.propagateReadErrors,\n        checkCancelled,\n      });\n    case \"entity-entries-fingerprint\":\n      return await fingerprintEntityEntries(payload.entitiesDir);\n    case \"stat-mtimes\":\n      return await statMtimes(payload.paths);\n  }\n}\n\nexport class CorpusScanWorkerHost {\n  private worker: Worker | null = null;\n  private readonly pending = new Map<number, PendingJob>();\n  private nextId = 1;\n  private readonly jobCounts = new Map<CorpusScanJobKind, number>();\n  private attached = false;\n  private workerUnavailable = false;\n\n  /** Completed jobs per kind — observability for tests and diagnostics. */\n  public stats(): CorpusScanStats {\n    const byKind: Record<string, number> = {};\n    let jobs = 0;\n    for (const [kind, count] of this.jobCounts) {\n      byKind[kind] = count;\n      jobs += count;\n    }\n    return { jobs, byKind };\n  }\n\n  /**\n   * Run one scan. It executes in the worker; when no worker can run it, the\n   * same implementation runs inline. Rejects with the job's error (errno code\n   * preserved) or an AbortError when `signal` fires first.\n   */\n  public async request<P extends CorpusScanPayload>(\n    payload: P,\n    signal?: AbortSignal,\n  ): Promise<CorpusScanResults[P[\"kind\"]]> {\n    if (signal?.aborted) throw abortError(\"corpus read aborted\");\n    const result = await this.runInWorker(payload, signal);\n    // SAFETY: the worker answers with the result type of the job it was given,\n    // and the kind is part of the request, so the pair holds.\n    return result as CorpusScanResults[P[\"kind\"]];\n  }\n\n  private async runInWorker(payload: CorpusScanPayload, signal?: AbortSignal): Promise<CorpusScanResult> {\n    if (this.workerUnavailable) {\n      return await runInline(payload, this.cancellationCheck(signal));\n    }\n    let worker: Worker;\n    try {\n      worker = this.ensureWorker();\n    } catch (error) {\n      // No worker available (missing entry, unsupported runtime): the scan\n      // still happens, on this thread. Report the fallback once: every later\n      // scan would otherwise run inline silently.\n      this.disableWorker(error instanceof Error ? error : new Error(String(error)));\n      return await runInline(payload, this.cancellationCheck(signal));\n    }\n    const id = this.nextId++;\n    // Keep the process alive while a job is in flight; release it when the\n    // queue drains so an idle worker never holds the event loop open.\n    this.setAttached(true);\n    try {\n      return await new Promise<CorpusScanResult>((resolve, reject) => {\n        const job: PendingJob = { kind: payload.kind, resolve, reject };\n        if (signal) {\n          const onAbort = (): void => {\n            this.cancelJob(id);\n            // Drop the job now: the worker's late reply is ignored, and the\n            // queue must not stay \"busy\" for a job nobody awaits.\n            this.pending.delete(id);\n            if (this.pending.size === 0) this.setAttached(false);\n            reject(abortError(\"corpus read aborted\"));\n          };\n          signal.addEventListener(\"abort\", onAbort, { once: true });\n          job.cleanup = () => signal.removeEventListener(\"abort\", onAbort);\n        }\n        this.pending.set(id, job);\n        worker.postMessage({ id, payload });\n      });\n    } catch (error) {\n      // A worker that died before answering leaves the scan undone: run it\n      // inline so the caller still gets its result.\n      if (!this.pending.has(id) && this.workerUnavailable) {\n        return await runInline(payload, this.cancellationCheck(signal));\n      }\n      throw error;\n    }\n  }\n\n  private cancellationCheck(signal?: AbortSignal): (() => void) | undefined {\n    if (!signal) return undefined;\n    return () => {\n      if (signal.aborted) throw abortError(\"corpus read aborted\");\n    };\n  }\n\n  /** Tell the worker to abandon a job (its next checkpoint stops the walk). */\n  private cancelJob(id: number): void {\n    this.worker?.postMessage({ id, cancel: true });\n  }\n\n  /**\n   * Attach/detach the worker's message listener. A worker with a `message`\n   * listener keeps the parent's event loop alive (the port stays ref'd), so an\n   * idle worker is detached: the daemon must be able to exit with a warm\n   * corpus-scan worker in memory.\n   */\n  private setAttached(attached: boolean): void {\n    const worker = this.worker;\n    if (!worker) return;\n    if (attached) {\n      if (!this.attached) {\n        worker.on(\"message\", this.onMessage);\n        this.attached = true;\n      }\n      worker.ref();\n    } else {\n      if (this.attached) {\n        worker.removeAllListeners(\"message\");\n        this.attached = false;\n      }\n      worker.unref();\n    }\n  }\n\n  private readonly onMessage = (message: CorpusScanReply): void => {\n    const job = this.pending.get(message.id);\n    if (!job) return;\n    this.pending.delete(message.id);\n    job.cleanup?.();\n    this.jobCounts.set(job.kind, (this.jobCounts.get(job.kind) ?? 0) + 1);\n    if (message.ok && message.result !== undefined) job.resolve(message.result);\n    else job.reject(toError(message.error ?? { name: \"Error\", message: \"corpus scan worker job failed\" }, \"corpus scan worker job failed\"));\n    if (this.pending.size === 0) this.setAttached(false);\n  };\n\n  /**\n   * Disable the worker and say why, exactly once: after this, every corpus\n   * scan runs inline on the main thread, which is the starvation this module\n   * exists to avoid. Silence here would hide the regression.\n   */\n  private disableWorker(error: Error): void {\n    if (this.workerUnavailable) return;\n    this.workerUnavailable = true;\n    log.warn(\"corpus scan worker unavailable; falling back to inline scans\", error);\n  }\n\n  private ensureWorker(): Worker {\n    if (this.worker) return this.worker;\n    const worker = new Worker(resolveWorkerEntryUrl());\n    worker.unref();\n    // Events from a worker that is no longer current (closed, replaced) must\n    // not touch jobs that belong to its successor: `exit` is delivered after\n    // `terminate()` resolves, by which time a new worker may own the queue.\n    worker.on(\"error\", (error: Error) => {\n      if (this.worker !== worker) return;\n      this.failAll(error);\n      this.disableWorker(error);\n    });\n    worker.on(\"exit\", () => {\n      if (this.worker !== worker) return;\n      this.worker = null;\n      this.attached = false;\n      this.failAll(new Error(\"corpus scan worker exited\"));\n    });\n    this.worker = worker;\n    return worker;\n  }\n\n  private failAll(error: Error): void {\n    for (const [id, job] of [...this.pending]) {\n      this.pending.delete(id);\n      job.cleanup?.();\n      job.reject(error);\n    }\n  }\n\n  /**\n   * Terminate the worker and reject in-flight jobs. The next request spawns a\n   * fresh worker, so a shutdown (or a test teardown) leaves no handle behind.\n   */\n  public close(): void {\n    const worker = this.worker;\n    this.worker = null;\n    this.attached = false;\n    this.failAll(new Error(\"corpus scan worker closed\"));\n    void worker?.terminate();\n  }\n}\n\n/** Process-wide corpus-scan worker. */\nexport const corpusScanWorker = new CorpusScanWorkerHost();\n"],"mappings":"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","names":[]}

package/dist/{chunk-LIVNX7WK.js → chunk-4O4VAEWH.js}

@@ -1,6 +1,6 @@
 import {
   parseFrontmatter
-} from "./chunk-OCXDZJL4.js";
+} from "./chunk-I6UTOUBK.js";
 import {
   activityDigestPath,
   isValidActivityDate
@@ -199,4 +199,4 @@ export {
   buildStandup,
   standupHelp
 };
-//# sourceMappingURL=chunk-LIVNX7WK.js.map
+//# sourceMappingURL=chunk-4O4VAEWH.js.map

package/dist/{chunk-NRGQ5HJO.js → chunk-4P4VLPGB.js}

@@ -400,4 +400,4 @@ export {
   getCausalTrajectoryStoreStatus,
   searchCausalTrajectories
 };
-//# sourceMappingURL=chunk-NRGQ5HJO.js.map
+//# sourceMappingURL=chunk-4P4VLPGB.js.map

package/dist/{chunk-GIRWNTMV.js → chunk-4PG5R6BJ.js}

@@ -1,6 +1,6 @@
 import {
   isGenericRecallExcludedPath
-} from "./chunk-VV73XT3A.js";
+} from "./chunk-BJLCV2P3.js";
 import {
   normalizeProjectionPreview
 } from "./chunk-SCU65EZI.js";
@@ -209,4 +209,4 @@ export {
   browsePatternMatches,
   runMemoryBrowse
 };
-//# sourceMappingURL=chunk-GIRWNTMV.js.map
+//# sourceMappingURL=chunk-4PG5R6BJ.js.map

package/dist/{chunk-AOSCGNIC.js → chunk-5XY46Z2W.js}

@@ -1,9 +1,9 @@
 import {
   NamespaceStorageRouter
-} from "./chunk-34UVJNSG.js";
+} from "./chunk-M3GOWG2P.js";
 import {
   namespaceCollectionName
-} from "./chunk-JEX2JL3U.js";
+} from "./chunk-JEDS2QYV.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-PCXDUHQH.js";
@@ -213,4 +213,4 @@ export {
   verifyNamespaces,
   runNamespaceMigration
 };
-//# sourceMappingURL=chunk-AOSCGNIC.js.map
+//# sourceMappingURL=chunk-5XY46Z2W.js.map

package/dist/{chunk-52II7PB6.js → chunk-645WOU5I.js}

@@ -1,12 +1,12 @@
+import {
+  shouldRecallEventOrderEvidence
+} from "./chunk-BUYVPUEM.js";
 import {
   unifiedDedupeAndRank
 } from "./chunk-LUPVCGYK.js";
 import {
   buildEvidencePack
 } from "./chunk-DGFU5MSX.js";
-import {
-  shouldRecallEventOrderEvidence
-} from "./chunk-BUYVPUEM.js";
 import {
   lcmEvidenceIdentity
 } from "./chunk-C37ZRXX7.js";
@@ -2236,4 +2236,4 @@ var NUMBER_WORD_VALUES = {
 export {
   buildEventOrderRecallSection
 };
-//# sourceMappingURL=chunk-52II7PB6.js.map
+//# sourceMappingURL=chunk-645WOU5I.js.map

package/dist/{chunk-RG3I2663.js → chunk-64JLBFCQ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DBB5JPSL.js";
 import {
   isGenericRecallExcludedPath
-} from "./chunk-VV73XT3A.js";
+} from "./chunk-BJLCV2P3.js";
 import {
   isChangeOrientedQuery
 } from "./chunk-EH3HNCAM.js";
@@ -69,4 +69,4 @@ export {
   filterRecentScanMemoriesForStateView,
   indexStateViewAnnotatedResults
 };
-//# sourceMappingURL=chunk-RG3I2663.js.map
+//# sourceMappingURL=chunk-64JLBFCQ.js.map

package/dist/{chunk-G3T6YMBO.js → chunk-64S6X4IU.js}

@@ -1,15 +1,15 @@
-import {
-  ReplitAdapter
-} from "./chunk-SI36RWC3.js";
-import {
-  ClaudeCodeAdapter
-} from "./chunk-3JKYQBLC.js";
 import {
   CodexAdapter
 } from "./chunk-7RKSJVOQ.js";
 import {
   HermesAdapter
 } from "./chunk-HCAGBFE7.js";
+import {
+  ReplitAdapter
+} from "./chunk-SI36RWC3.js";
+import {
+  ClaudeCodeAdapter
+} from "./chunk-3JKYQBLC.js";
 import {
   headerValue
 } from "./chunk-NJAIR57U.js";
@@ -110,4 +110,4 @@ export {
   OpenCodeAdapter,
   AdapterRegistry
 };
-//# sourceMappingURL=chunk-G3T6YMBO.js.map
+//# sourceMappingURL=chunk-64S6X4IU.js.map

package/dist/{chunk-XHEKS4UN.js → chunk-66CC6L6R.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-B7RWBZXW.js";
 import {
   StorageManager
-} from "./chunk-OCXDZJL4.js";
+} from "./chunk-I6UTOUBK.js";
 import {
   getCachedEpisodeMap,
   setCachedEpisodeMap
@@ -109,4 +109,4 @@ export {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
 };
-//# sourceMappingURL=chunk-XHEKS4UN.js.map
+//# sourceMappingURL=chunk-66CC6L6R.js.map

package/dist/{chunk-3632XJMR.js → chunk-6BKSUA6P.js}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-3UXOZBHV.js";
 import {
   StorageManager
-} from "./chunk-OCXDZJL4.js";
+} from "./chunk-I6UTOUBK.js";
 import {
   OKF_PROFILE_TYPE,
   okfTypeForMemory
@@ -272,4 +272,4 @@ export {
   exportOkfBundle,
   firstHeading
 };
-//# sourceMappingURL=chunk-3632XJMR.js.map
+//# sourceMappingURL=chunk-6BKSUA6P.js.map

package/dist/{chunk-6AEKSOWV.js → chunk-6I6DFULH.js}

@@ -1,18 +1,13 @@
 import {
   matchesOfflineSyncDefaultExclude
 } from "./chunk-63LFM77Z.js";
-import {
-  EMBEDDING_SHARD_FILE_PATTERN
-} from "./chunk-LDWE7OZS.js";
 import {
   prepareSafeArchiveRoot,
   resolveSafeArchiveTarget
 } from "./chunk-GCGJW34D.js";
 import {
-  assertEmbeddingGenerationLockHeld,
-  embeddingGenerationLockPath,
-  withEmbeddingGenerationLock
-} from "./chunk-TRSKATZQ.js";
+  EMBEDDING_SHARD_FILE_PATTERN
+} from "./chunk-LDWE7OZS.js";
 import {
   EmbeddingIndexFileStore,
   EmbeddingIndexStorageError,
@@ -21,6 +16,11 @@ import {
   shardEntriesForIndex,
   validateShardMembership
 } from "./chunk-SWRRZNHM.js";
+import {
+  assertEmbeddingGenerationLockHeld,
+  embeddingGenerationLockPath,
+  withEmbeddingGenerationLock
+} from "./chunk-TRSKATZQ.js";
 import {
   GENERATION_MARKER_BASENAME,
   beginGenerationMarker,
@@ -709,4 +709,4 @@ export {
   divergedEmbeddingGenerationDeferrals,
   applyIncomingEmbeddingGenerations
 };
-//# sourceMappingURL=chunk-6AEKSOWV.js.map
+//# sourceMappingURL=chunk-6I6DFULH.js.map

package/dist/{chunk-2EYCW2ET.js → chunk-74Z2BYEK.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-ZCUTSMR2.js";
 import {
   StorageManager
-} from "./chunk-OCXDZJL4.js";
+} from "./chunk-I6UTOUBK.js";
 import {
   excludeSupportPassportPrivateMemories
 } from "./chunk-PWPIERBM.js";
@@ -134,4 +134,4 @@ export {
   runCodexMaterialize,
   runPostConsolidationMaterialize
 };
-//# sourceMappingURL=chunk-2EYCW2ET.js.map
+//# sourceMappingURL=chunk-74Z2BYEK.js.map

package/dist/{chunk-QAHP5SBG.js → chunk-7DHNBABU.js}

@@ -7,10 +7,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-TTTPTQ6S.js";
+} from "./chunk-IA3XZG4V.js";
 import {
   StorageManager
-} from "./chunk-OCXDZJL4.js";
+} from "./chunk-I6UTOUBK.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -1156,4 +1156,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-QAHP5SBG.js.map
+//# sourceMappingURL=chunk-7DHNBABU.js.map

package/dist/{chunk-HJ4X4BGS.js → chunk-ADK5TMQL.js}

@@ -1,6 +1,6 @@
 import {
   getOperation
-} from "./chunk-QF5EJ5VP.js";
+} from "./chunk-C5GTIRIO.js";
 import {
   EngramAccessInputError
 } from "./chunk-LGEH473S.js";
@@ -22,4 +22,4 @@ async function respondBriefingHttp(options) {
 export {
   respondBriefingHttp
 };
-//# sourceMappingURL=chunk-HJ4X4BGS.js.map
+//# sourceMappingURL=chunk-ADK5TMQL.js.map

package/dist/{chunk-KCTL5EY7.js → chunk-AWKADEMO.js}

@@ -1,9 +1,9 @@
 import {
   hasMemoryData
-} from "./chunk-P5FYZH5G.js";
+} from "./chunk-ZRDEOC4X.js";
 import {
   resolveNamespaceStorageRoot
-} from "./chunk-34UVJNSG.js";
+} from "./chunk-M3GOWG2P.js";
 import {
   getConfiguredNamespaces
 } from "./chunk-I6QGI65T.js";
@@ -726,4 +726,4 @@ export {
   runNamespaceMaintenancePlan,
   runNamespaceMaintenanceBatchPlan
 };
-//# sourceMappingURL=chunk-KCTL5EY7.js.map
+//# sourceMappingURL=chunk-AWKADEMO.js.map

package/dist/{chunk-VV73XT3A.js → chunk-BJLCV2P3.js}

@@ -3,7 +3,7 @@ import {
   isArtifactMemoryPath,
   isLocationDayPath,
   isMeetingRecordPath
-} from "./chunk-YDT3OEYF.js";
+} from "./chunk-R4ZHF4K2.js";
 import {
   isExternalWikiCollectionName
 } from "./chunk-JV3C2MNQ.js";
@@ -228,4 +228,4 @@ export {
   isGenericRecallExcludedPath,
   filterRecallCandidates
 };
-//# sourceMappingURL=chunk-VV73XT3A.js.map
+//# sourceMappingURL=chunk-BJLCV2P3.js.map