@remnic/core 10.0.83 → 10.0.85

package/dist/{chunk-R45L4TV6.js → chunk-BUKK5SWA.js}

@@ -1,7 +1,3 @@
-import {
-  CAPSULE_SCHEMA_VERSION,
-  EXPORT_FORMAT
-} from "./chunk-J4EB7DNW.js";
 import {
   CAPSULE_ID_PATTERN,
   CapsuleBlockSchema,
@@ -10,7 +6,11 @@ import {
 } from "./chunk-WEHSQBFR.js";
 import {
   encryptCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-UVYI6VIX.js";
+import {
+  CAPSULE_SCHEMA_VERSION,
+  EXPORT_FORMAT
+} from "./chunk-J4EB7DNW.js";
 import {
   DEFAULT_TRANSFER_EXCLUDE_DIRS,
   computeTransferOutputRel
@@ -261,4 +261,4 @@ export {
   exportCapsule,
   isValidCapsuleSince
 };
-//# sourceMappingURL=chunk-R45L4TV6.js.map
+//# sourceMappingURL=chunk-BUKK5SWA.js.map

package/dist/{chunk-TFLPDNQV.js → chunk-CCU7URRP.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-HPFVZPRH.js";
+} from "./chunk-FK4WC6VK.js";
 import {
   corpusScanWorker
 } from "./chunk-4LZ7SVKM.js";
@@ -292,4 +292,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-TFLPDNQV.js.map
+//# sourceMappingURL=chunk-CCU7URRP.js.map

package/dist/{chunk-2XJZLSXE.js → chunk-CMRHXPLQ.js}

@@ -1,12 +1,12 @@
 import {
   WearablesInputError
 } from "./chunk-V7IZKJI3.js";
-import {
-  WriteRateLimiter
-} from "./chunk-TB6CBZ5V.js";
 import {
   AdapterRegistry
 } from "./chunk-G3T6YMBO.js";
+import {
+  WriteRateLimiter
+} from "./chunk-TB6CBZ5V.js";
 import {
   maybeRespondRecallNavigation
 } from "./chunk-2TGIKMMZ.js";
@@ -18,13 +18,13 @@ import {
 } from "./chunk-3HSRWJTC.js";
 import {
   respondDeepRecall
-} from "./chunk-E33UJHY3.js";
+} from "./chunk-WFDWLWDK.js";
 import {
   handleSupportPassportOwnerHttp
-} from "./chunk-GGJFRVRD.js";
+} from "./chunk-OMYRPMQC.js";
 import {
   buildSupportPassportPublicRequestHandler
-} from "./chunk-GQZSGXR6.js";
+} from "./chunk-BATPQNRG.js";
 import {
   handleMcpGetSse
 } from "./chunk-SRT6SHVZ.js";
@@ -37,18 +37,18 @@ import {
   processChatMessage,
   sessionBelongsToPrincipal,
   subscribeChatTranscript
-} from "./chunk-Z3DDQXM4.js";
+} from "./chunk-XSFQN7TP.js";
 import {
   RelayMissionStoreError
-} from "./chunk-BK7AJUWB.js";
+} from "./chunk-NIV7RPWQ.js";
+import {
+  executeResolution,
+  isValidResolutionVerb
+} from "./chunk-S7GJNA3K.js";
 import {
   handleRecallWhyHttpQuery,
   handleRecallXrayHttpQuery
 } from "./chunk-ZXF3O7P4.js";
-import {
-  executeResolution,
-  isValidResolutionVerb
-} from "./chunk-2RUTN7PR.js";
 import {
   toDottedRemnicName
 } from "./chunk-ZQUVBZI4.js";
@@ -61,10 +61,10 @@ import {
   optionalNamespaceKindQueryParam,
   optionalQueryString,
   positiveIntQueryParam
-} from "./chunk-54FDG7K7.js";
+} from "./chunk-4DPLCYEK.js";
 import {
   respondBriefingHttp
-} from "./chunk-LECSS7EE.js";
+} from "./chunk-2ASEDFOA.js";
 import {
   maybeHandleLifecycleFlush
 } from "./chunk-2BPPGNAQ.js";
@@ -75,14 +75,14 @@ import {
   authorizationProbeNamespaces,
   authorizationProbeRequiresPrincipalNamespace,
   probeOperationAuthorization
-} from "./chunk-LTDLJCMQ.js";
+} from "./chunk-FZPDRCOB.js";
 import {
   getOperation,
   resolveQueryNamespaceWritablePreflight
-} from "./chunk-6LCWKS62.js";
+} from "./chunk-HVFX2N2G.js";
 import {
   handleWhoKnowsHttpQuery
-} from "./chunk-FUOAIJKQ.js";
+} from "./chunk-Y43X3E24.js";
 import {
   isTrustZoneName
 } from "./chunk-JWX2Q6HS.js";
@@ -105,10 +105,10 @@ import {
 } from "./chunk-V4XE263I.js";
 import {
   validateRequest
-} from "./chunk-HWHNQVRV.js";
+} from "./chunk-GYNRNKMW.js";
 import {
   peerManifestRevision
-} from "./chunk-A7BM2JTH.js";
+} from "./chunk-AJHNXIQU.js";
 import {
   assertOperationAllowed,
   capabilityAllowsOp,
@@ -3573,4 +3573,4 @@ export {
   resolveDefaultAdminConsolePublicDir,
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-2XJZLSXE.js.map
+//# sourceMappingURL=chunk-CMRHXPLQ.js.map

package/dist/{chunk-BK4FBHZ3.js → chunk-D6THW7PA.js}

@@ -1,9 +1,9 @@
 import {
   StorageManager
-} from "./chunk-WAD32CZG.js";
+} from "./chunk-ELWI2R6H.js";
 import {
   composeMemoryEnvelope
-} from "./chunk-JRVMCZE3.js";
+} from "./chunk-QEYTRFR3.js";
 import {
   isErrnoCode
 } from "./chunk-KNA3BXXL.js";
@@ -546,4 +546,4 @@ export {
   setSemanticRulePromotionTestHooks,
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-BK4FBHZ3.js.map
+//# sourceMappingURL=chunk-D6THW7PA.js.map

package/dist/{chunk-BFBS7OFQ.js → chunk-DC55RIEZ.js}

@@ -3,6 +3,9 @@ import {
   withGraphWriteLock,
   yieldForLockHeartbeat
 } from "./chunk-QGJSBU4R.js";
+import {
+  readEdgeConfidence
+} from "./chunk-2LSZVONP.js";
 import {
   emitGraphEvent
 } from "./chunk-DEUNUKTD.js";
@@ -14,9 +17,6 @@ import {
 import {
   GraphEdgeAppendError
 } from "./chunk-GKCXTSFF.js";
-import {
-  readEdgeConfidence
-} from "./chunk-2LSZVONP.js";
 import {
   isErrnoCode
 } from "./chunk-KNA3BXXL.js";
@@ -758,4 +758,4 @@ export {
   applyPageRankRefinement,
   applyLateralInhibition
 };
-//# sourceMappingURL=chunk-BFBS7OFQ.js.map
+//# sourceMappingURL=chunk-DC55RIEZ.js.map

package/dist/{chunk-VKDAJJQP.js → chunk-DI5ET2IE.js}

@@ -1,3 +1,6 @@
+import {
+  OramaBackend
+} from "./chunk-DLZGSZVC.js";
 import {
   RemoteSearchBackend
 } from "./chunk-OVZIYLBZ.js";
@@ -13,12 +16,9 @@ import {
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
-import {
-  OramaBackend
-} from "./chunk-DLZGSZVC.js";
 import {
   createConversationIndexBackend
-} from "./chunk-TFA6HPOA.js";
+} from "./chunk-QCP75JGO.js";
 import {
   FaissConversationIndexAdapter
 } from "./chunk-F4TWWUMP.js";
@@ -179,4 +179,4 @@ export {
   createConversationSearchBackend,
   createConversationIndexRuntime
 };
-//# sourceMappingURL=chunk-VKDAJJQP.js.map
+//# sourceMappingURL=chunk-DI5ET2IE.js.map

package/dist/{chunk-QZBTIYKD.js → chunk-DM4RRTN7.js}

@@ -1,6 +1,6 @@
 import {
   applyExtractionSourceGrounding
-} from "./chunk-CIIHIAJ2.js";
+} from "./chunk-433EXTC4.js";
 import {
   CONNECTOR_LABEL_MAX_LENGTH,
   knownConnectorIds
@@ -10,7 +10,7 @@ import {
 } from "./chunk-QA3Y2O6H.js";
 import {
   deriveSourceConnector
-} from "./chunk-KO3YBHOV.js";
+} from "./chunk-4IWEPQEV.js";
 import {
   resolvePipelineProcessingCapabilities
 } from "./chunk-C5LWPYS3.js";
@@ -112,4 +112,4 @@ export {
   renderExtractionConversation,
   applyGroundingWithConnector
 };
-//# sourceMappingURL=chunk-QZBTIYKD.js.map
+//# sourceMappingURL=chunk-DM4RRTN7.js.map

package/dist/{chunk-S57QBPTA.js → chunk-DPPLNZ3A.js}

@@ -1,3 +1,6 @@
+import {
+  compareStrings
+} from "./chunk-ULM7JCDH.js";
 import {
   entityMentionEpoch
 } from "./chunk-7CT3AI52.js";
@@ -88,11 +91,6 @@ function throwIfMentionAborted(signal) {
   const reason = signal.reason;
   throw reason instanceof Error ? reason : new Error("entity mention rebuild aborted");
 }
-function compareStrings(left, right) {
-  if (left < right) return -1;
-  if (left > right) return 1;
-  return 0;
-}
 function deduped(values) {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
@@ -327,4 +325,4 @@ export {
   settleEntityMentionIndex,
   resolveEntityMentionIndex
 };
-//# sourceMappingURL=chunk-S57QBPTA.js.map
+//# sourceMappingURL=chunk-DPPLNZ3A.js.map

package/dist/chunk-DPPLNZ3A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/entity-mention-index-cache.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { raceAbort } from \"./abort-error.js\";\nimport { entityMentionEpoch } from \"./entity-mention-epoch.js\";\nimport { log } from \"./logger.js\";\nimport { compareStrings } from \"./eval-trajectory-contracts.js\";\n\n/**\n * In-memory entity mention index.\n *\n * Scope (namespaces, dirs, secure-store key, alias map, native revision) is\n * the cache key. Mention epoch and entity-file mutation are identity inside\n * the slot, not part of the key:\n *\n * - metadata-only corpus bumps do not move the epoch, so the next recall hits\n * - entity-file changes rebuild from entity files before the recall returns,\n *   reusing memory snippets (no fact scan). A new entity is visible on that\n *   recall; its memory snippets arrive with the next full reconcile. A new\n *   canonical id schedules that reconcile. Callers share one scan. One\n *   caller's abort stops that caller waiting and leaves the scan running\n *   for the others\n * - memory create/edit/delete moves the epoch. The recall serves the last\n *   index immediately and one background reconcile runs, plus at most one\n *   follow-up if that scan overlaps a later write. A recall during either\n *   scan does not grant another follow-up. Further rescans wait for the\n *   next recall. After writes quiesce and `settleEntityMentionIndex`\n *   finishes, the index matches a full rebuild\n * - secure-store key, alias map, and native revision stay in the key, so a\n *   change is a miss and awaits a full rebuild. A locked store never reads\n *   another key's plaintext. Evicting that older scope also stops its scan\n *   from publishing the persisted index\n * - a persisted index is readable per storage root. A process-wide cache\n *   clear blocks every root until that root's own post-clear build publishes.\n *   One root publishing does not reopen another root's file\n */\n\nconst MAX_SLOTS = 32;\nconst SETTLE_ROUNDS = 8;\n\nexport type EntityMentionIdentity = {\n  mentionEpoch: string;\n  entityMutation: string;\n};\n\ntype ScopedStorage = {\n  dir: string;\n  hotCacheKeyId?(): string;\n  entityAliases?: Readonly<Record<string, string>> | null;\n  getEntityMutationVersion?(): number;\n};\n\ntype Slot = {\n  scopeKey: string;\n  index: unknown;\n  identity: EntityMentionIdentity;\n  token: number;\n  rebuild: Promise<void> | null;\n  entityJob: Promise<void> | null;\n  again: boolean;\n  followUps: number;\n  currentIdentity: () => EntityMentionIdentity;\n  buildFull: (abortSignal?: AbortSignal) => Promise<unknown>;\n};\n\nconst slots = new Map<string, Slot>();\nconst rebuildsByScope = new Map<string, number>();\nconst GENERATION_STRIDE = 1_000_000_000;\nlet clearEpoch = 0;\nconst localGenerationByDir = new Map<string, number>();\nconst publishedGenerationByDir = new Map<string, number>();\nconst persistTailByDir = new Map<string, Promise<void>>();\n\nfunction resolveMentionDir(dir: string): string {\n  return path.resolve(dir);\n}\n\nexport function entityMentionCacheGeneration(dir: string): number {\n  const resolved = resolveMentionDir(dir);\n  return clearEpoch * GENERATION_STRIDE + (localGenerationByDir.get(resolved) ?? 0);\n}\n\nexport function entityMentionPersistedIndexReadable(dir: string): boolean {\n  const resolved = resolveMentionDir(dir);\n  const local = localGenerationByDir.get(resolved) ?? 0;\n  if (clearEpoch === 0 && local === 0) return true;\n  return publishedGenerationByDir.get(resolved) === entityMentionCacheGeneration(resolved);\n}\n\nfunction dirsInScope(scopeKey: string): string[] {\n  const nsEnd = scopeKey.indexOf(\"\\u001e\");\n  const storageEnd = nsEnd === -1 ? -1 : scopeKey.indexOf(\"\\u001e\", nsEnd + 1);\n  if (nsEnd === -1 || storageEnd === -1) return [];\n  return scopeKey\n    .slice(nsEnd + 1, storageEnd)\n    .split(\"\\u001f\")\n    .map((part) => part.split(\"\\u001d\")[0] ?? \"\")\n    .filter((dir) => dir.length > 0)\n    .map((dir) => resolveMentionDir(dir));\n}\n\nfunction persistedMentionIndexFiles(scopeKey: string): string[] {\n  return dirsInScope(scopeKey).map((dir) => path.join(dir, \"state\", \"entity-mention-index.json\"));\n}\n\nfunction bumpScopeDirs(scopeKey: string): void {\n  for (const dir of dirsInScope(scopeKey)) {\n    localGenerationByDir.set(dir, (localGenerationByDir.get(dir) ?? 0) + 1);\n  }\n}\n\nfunction captureDirGenerations(scopeKey: string): Map<string, number> {\n  const captured = new Map<string, number>();\n  for (const dir of dirsInScope(scopeKey)) captured.set(dir, entityMentionCacheGeneration(dir));\n  return captured;\n}\n\nfunction generationsCurrent(captured: Map<string, number>): boolean {\n  for (const [dir, generation] of captured) {\n    if (entityMentionCacheGeneration(dir) !== generation) return false;\n  }\n  return true;\n}\n\nfunction publishDirGenerations(captured: Map<string, number>): void {\n  for (const [dir, generation] of captured) {\n    if (entityMentionCacheGeneration(dir) === generation) publishedGenerationByDir.set(dir, generation);\n  }\n}\n\nexport async function writePersistedEntityMentionIndex(\n  dir: string,\n  generation: number,\n  content: string,\n): Promise<void> {\n  const resolved = resolveMentionDir(dir);\n  const previous = persistTailByDir.get(resolved) ?? Promise.resolve();\n  const run = previous.catch(() => undefined).then(async () => {\n    if (entityMentionCacheGeneration(resolved) !== generation) return;\n    const file = path.join(resolved, \"state\", \"entity-mention-index.json\");\n    await mkdir(path.dirname(file), { recursive: true });\n    const current = await readFile(file, \"utf-8\").catch(() => \"\");\n    if (current === content) return;\n    if (entityMentionCacheGeneration(resolved) !== generation) return;\n    await writeFile(file, content, \"utf-8\");\n  });\n  persistTailByDir.set(resolved, run.then(() => undefined, () => undefined));\n  await run;\n}\n\nfunction discardPersistedMentionIndex(scopeKey: string): void {\n  for (const file of persistedMentionIndexFiles(scopeKey)) {\n    void rm(file, { force: true }).catch(() => undefined);\n  }\n}\n\nfunction throwIfMentionAborted(signal?: AbortSignal): void {\n  if (!signal?.aborted) return;\n  const reason = signal.reason;\n  throw reason instanceof Error ? reason : new Error(\"entity mention rebuild aborted\");\n}\n\nfunction deduped(values: readonly string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0 || seen.has(trimmed)) continue;\n    seen.add(trimmed);\n    out.push(trimmed);\n  }\n  return out;\n}\n\nfunction sameIdentity(left: EntityMentionIdentity, right: EntityMentionIdentity): boolean {\n  return left.mentionEpoch === right.mentionEpoch && left.entityMutation === right.entityMutation;\n}\n\nfunction noteRebuild(scopeKey: string): void {\n  rebuildsByScope.set(scopeKey, (rebuildsByScope.get(scopeKey) ?? 0) + 1);\n}\n\nfunction scopeFamily(scopeKey: string): string {\n  const nsEnd = scopeKey.indexOf(\"\\u001e\");\n  const storageEnd = nsEnd === -1 ? -1 : scopeKey.indexOf(\"\\u001e\", nsEnd + 1);\n  const namespaceKey = nsEnd === -1 ? scopeKey : scopeKey.slice(0, nsEnd);\n  const storageKey = nsEnd === -1 || storageEnd === -1 ? \"\" : scopeKey.slice(nsEnd + 1, storageEnd);\n  const dirs = storageKey\n    .split(\"\\u001f\")\n    .map((part) => part.split(\"\\u001d\")[0] ?? \"\")\n    .join(\"\\u001f\");\n  return `${namespaceKey}\\u001e${dirs}`;\n}\n\nfunction forgetScope(scopeKey: string, bumpPersisted = false): void {\n  const slot = slots.get(scopeKey);\n  if (slot) {\n    slot.token += 1;\n    slot.again = false;\n  }\n  if (bumpPersisted) bumpScopeDirs(scopeKey);\n  slots.delete(scopeKey);\n  rebuildsByScope.delete(scopeKey);\n}\n\nfunction evictOldest(scopeKey: string): void {\n  if (slots.size < MAX_SLOTS || slots.has(scopeKey)) return;\n  const oldest = slots.keys().next().value;\n  if (typeof oldest === \"string\") forgetScope(oldest);\n}\n\nfunction evictSameFamily(scopeKey: string): void {\n  const family = scopeFamily(scopeKey);\n  for (const key of [...slots.keys()]) {\n    if (key !== scopeKey && scopeFamily(key) === family) forgetScope(key, true);\n  }\n}\n\nfunction wantsSnippetReconcile(index: unknown): boolean {\n  return (\n    !!index &&\n    typeof index === \"object\" &&\n    (index as { pendingSnippetReconcile?: boolean }).pendingSnippetReconcile === true\n  );\n}\n\nfunction armRebuild(slot: Slot): void {\n  // A recall that arrives while a scan is already running must not grant\n  // another follow-up. The chain stops after the one already armed.\n  if (!slot.rebuild) slot.followUps = 1;\n  startRebuild(slot);\n}\n\nfunction startRebuild(slot: Slot): void {\n  // A recall that arrives during a scan is not a write. The follow-up is\n  // armed only when the scan's end identity differs from the identity it\n  // started with. Setting `again` here made every concurrent recall pay a\n  // second full corpus scan after a stable rebuild.\n  if (slot.rebuild) return;\n  const token = slot.token;\n  const captured = captureDirGenerations(slot.scopeKey);\n  noteRebuild(slot.scopeKey);\n  const started = slot.currentIdentity();\n  slot.again = false;\n  const handle: { pending: Promise<void> | null } = { pending: null };\n  handle.pending = slot\n    .buildFull(undefined)\n    .then((index) => {\n      if (slot.token !== token || !generationsCurrent(captured)) return;\n      publishDirGenerations(captured);\n      const ended = slot.currentIdentity();\n      slot.index = index;\n      if (sameIdentity(started, ended)) {\n        slot.identity = ended;\n        return;\n      }\n      // Scan overlapped later writes. Keep the start identity so the next\n      // recall stays stale and exactly one follow-up reconcile runs.\n      slot.identity = started;\n      slot.again = true;\n    })\n    .catch((err: unknown) => {\n      const message = err instanceof Error ? err.message : String(err);\n      log.warn(`entity mention index rebuild failed: ${message}`);\n    })\n    .finally(() => {\n      if (slot.rebuild === handle.pending) slot.rebuild = null;\n      // One automatic follow-up per caller-started rebuild. A store that keeps\n      // changing during every scan waits for the next recall (or settle) instead\n      // of chaining full scans with nobody waiting.\n      if (!slot.again || slot.followUps <= 0) return;\n      slot.again = false;\n      slot.followUps -= 1;\n      startRebuild(slot);\n    });\n  slot.rebuild = handle.pending;\n}\n\nexport function entityMentionScopeKey(\n  namespaces: readonly string[] | undefined,\n  storages: readonly ScopedStorage[],\n  nativeRevision: string,\n): string {\n  const namespaceKey = deduped(namespaces ?? []).join(\"\\u001f\");\n  const storageKey = storages\n    .map((storage) => {\n      const aliases = Object.entries(storage.entityAliases ?? {}).sort(([left], [right]) =>\n        compareStrings(left, right),\n      );\n      return `${path.resolve(storage.dir)}\\u001d${storage.hotCacheKeyId?.() ?? \"\"}\\u001d${JSON.stringify(aliases)}`;\n    })\n    .join(\"\\u001f\");\n  return `${namespaceKey}\\u001e${storageKey}\\u001e${nativeRevision}`;\n}\n\nexport function entityMentionIdentity(storages: readonly ScopedStorage[]): EntityMentionIdentity {\n  return {\n    mentionEpoch: storages.map((storage) => String(entityMentionEpoch.current(storage.dir))).join(\"\\u001f\"),\n    entityMutation: storages.map((storage) => String(storage.getEntityMutationVersion?.() ?? 0)).join(\"\\u001f\"),\n  };\n}\n\nexport function entityMentionFullRebuildsStarted(scopeKey: string): number {\n  return rebuildsByScope.get(scopeKey) ?? 0;\n}\n\nexport function entityMentionIndexScopeKeys(): string[] {\n  return [...slots.keys()];\n}\n\nexport function dropEntityMentionIndexCache(scopeKey?: string): void {\n  if (scopeKey === undefined) {\n    clearEpoch += 1;\n    for (const key of [...slots.keys()]) {\n      discardPersistedMentionIndex(key);\n      forgetScope(key);\n    }\n    return;\n  }\n  discardPersistedMentionIndex(scopeKey);\n  forgetScope(scopeKey, true);\n}\n\nexport async function settleEntityMentionIndex(scopeKey?: string): Promise<void> {\n  const matches = (slot: Slot) => scopeKey === undefined || slot.scopeKey === scopeKey;\n  for (let round = 0; round < SETTLE_ROUNDS; round += 1) {\n    for (const slot of slots.values()) {\n      if (!matches(slot)) continue;\n      if (!slot.rebuild && slot.again) {\n        slot.again = false;\n        startRebuild(slot);\n      }\n    }\n    const pending = [...slots.values()].filter((slot) => matches(slot) && slot.rebuild).map((slot) => slot.rebuild!);\n    if (pending.length === 0) return;\n    await Promise.all(pending);\n  }\n}\n\nexport async function resolveEntityMentionIndex<T>(options: {\n  scopeKey: string;\n  currentIdentity: () => EntityMentionIdentity;\n  buildFull: (abortSignal?: AbortSignal) => Promise<T>;\n  rebuildEntities: (previous: T, abortSignal?: AbortSignal) => Promise<T>;\n  abortSignal?: AbortSignal;\n}): Promise<T> {\n  const live = options.currentIdentity();\n  const existing = slots.get(options.scopeKey);\n  if (!existing) {\n    evictSameFamily(options.scopeKey);\n    evictOldest(options.scopeKey);\n    noteRebuild(options.scopeKey);\n    const captured = captureDirGenerations(options.scopeKey);\n    const started = options.currentIdentity();\n    const index = await options.buildFull(options.abortSignal);\n    // A clear or family eviction during this first scan must not publish it.\n    if (!generationsCurrent(captured)) return index;\n    publishDirGenerations(captured);\n    const ended = options.currentIdentity();\n    evictSameFamily(options.scopeKey);\n    evictOldest(options.scopeKey);\n    const slot: Slot = {\n      scopeKey: options.scopeKey,\n      index,\n      identity: sameIdentity(started, ended) ? ended : started,\n      token: 0,\n      rebuild: null,\n      entityJob: null,\n      again: false,\n      followUps: 0,\n      currentIdentity: options.currentIdentity,\n      buildFull: options.buildFull,\n    };\n    slots.set(options.scopeKey, slot);\n    if (!sameIdentity(started, ended)) armRebuild(slot);\n    return index;\n  }\n  existing.currentIdentity = options.currentIdentity;\n  existing.buildFull = options.buildFull;\n  while (existing.identity.entityMutation !== options.currentIdentity().entityMutation) {\n    throwIfMentionAborted(options.abortSignal);\n    const pending = existing.entityJob;\n    if (pending) {\n      await raceAbort(pending, options.abortSignal, \"entity mention rebuild aborted\");\n      continue;\n    }\n    const liveNow = options.currentIdentity();\n    const epochBefore = existing.identity.mentionEpoch;\n    const mutationBefore = liveNow.entityMutation;\n    let release = (): void => {};\n    const gate = new Promise<void>((resolve) => {\n      release = resolve;\n    });\n    existing.entityJob = gate;\n    existing.token += 1;\n    existing.again = false;\n    const token = existing.token;\n    const captured = captureDirGenerations(existing.scopeKey);\n    // Shared scan. This caller's abort stops its wait and leaves the scan\n    // running. Publish when the scan settles, even if this caller has left.\n    // A family eviction bumps the token and the root generation; this scan\n    // must not install its result or start a follow-up that would republish.\n    const scan = options.rebuildEntities(existing.index as T, undefined);\n    void scan\n      .then(\n        (rebuilt) => {\n          if (existing.token !== token || !generationsCurrent(captured)) return;\n          const now = options.currentIdentity();\n          existing.index = rebuilt;\n          const epochStable = epochBefore === liveNow.mentionEpoch && epochBefore === now.mentionEpoch;\n          const mutationStable = mutationBefore === now.entityMutation;\n          existing.identity = {\n            entityMutation: mutationStable ? now.entityMutation : mutationBefore,\n            mentionEpoch: epochStable ? now.mentionEpoch : epochBefore,\n          };\n          if (existing.identity.mentionEpoch !== now.mentionEpoch || wantsSnippetReconcile(rebuilt)) {\n            armRebuild(existing);\n          }\n        },\n        () => {},\n      )\n      .finally(() => {\n        if (existing.entityJob === gate) existing.entityJob = null;\n        release();\n      });\n    const rebuilt = await raceAbort(scan, options.abortSignal, \"entity mention rebuild aborted\");\n    throwIfMentionAborted(options.abortSignal);\n    return rebuilt;\n  }\n  if (existing.identity.mentionEpoch !== live.mentionEpoch) {\n    armRebuild(existing);\n    return existing.index as T;\n  }\n  return existing.index as T;\n}\n\nentityMentionEpoch.registerReset(() => {\n  dropEntityMentionIndexCache();\n});\n"],"mappings":";;;;;;;;;;;;;;AAAA,OAAO,UAAU;AACjB,SAAS,OAAO,UAAU,IAAI,iBAAiB;AAmC/C,IAAM,YAAY;AAClB,IAAM,gBAAgB;AA2BtB,IAAM,QAAQ,oBAAI,IAAkB;AACpC,IAAM,kBAAkB,oBAAI,IAAoB;AAChD,IAAM,oBAAoB;AAC1B,IAAI,aAAa;AACjB,IAAM,uBAAuB,oBAAI,IAAoB;AACrD,IAAM,2BAA2B,oBAAI,IAAoB;AACzD,IAAM,mBAAmB,oBAAI,IAA2B;AAExD,SAAS,kBAAkB,KAAqB;AAC9C,SAAO,KAAK,QAAQ,GAAG;AACzB;AAEO,SAAS,6BAA6B,KAAqB;AAChE,QAAM,WAAW,kBAAkB,GAAG;AACtC,SAAO,aAAa,qBAAqB,qBAAqB,IAAI,QAAQ,KAAK;AACjF;AAEO,SAAS,oCAAoC,KAAsB;AACxE,QAAM,WAAW,kBAAkB,GAAG;AACtC,QAAM,QAAQ,qBAAqB,IAAI,QAAQ,KAAK;AACpD,MAAI,eAAe,KAAK,UAAU,EAAG,QAAO;AAC5C,SAAO,yBAAyB,IAAI,QAAQ,MAAM,6BAA6B,QAAQ;AACzF;AAEA,SAAS,YAAY,UAA4B;AAC/C,QAAM,QAAQ,SAAS,QAAQ,GAAQ;AACvC,QAAM,aAAa,UAAU,KAAK,KAAK,SAAS,QAAQ,KAAU,QAAQ,CAAC;AAC3E,MAAI,UAAU,MAAM,eAAe,GAAI,QAAO,CAAC;AAC/C,SAAO,SACJ,MAAM,QAAQ,GAAG,UAAU,EAC3B,MAAM,GAAQ,EACd,IAAI,CAAC,SAAS,KAAK,MAAM,GAAQ,EAAE,CAAC,KAAK,EAAE,EAC3C,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,EAC9B,IAAI,CAAC,QAAQ,kBAAkB,GAAG,CAAC;AACxC;AAEA,SAAS,2BAA2B,UAA4B;AAC9D,SAAO,YAAY,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,KAAK,KAAK,SAAS,2BAA2B,CAAC;AAChG;AAEA,SAAS,cAAc,UAAwB;AAC7C,aAAW,OAAO,YAAY,QAAQ,GAAG;AACvC,yBAAqB,IAAI,MAAM,qBAAqB,IAAI,GAAG,KAAK,KAAK,CAAC;AAAA,EACxE;AACF;AAEA,SAAS,sBAAsB,UAAuC;AACpE,QAAM,WAAW,oBAAI,IAAoB;AACzC,aAAW,OAAO,YAAY,QAAQ,EAAG,UAAS,IAAI,KAAK,6BAA6B,GAAG,CAAC;AAC5F,SAAO;AACT;AAEA,SAAS,mBAAmB,UAAwC;AAClE,aAAW,CAAC,KAAK,UAAU,KAAK,UAAU;AACxC,QAAI,6BAA6B,GAAG,MAAM,WAAY,QAAO;AAAA,EAC/D;AACA,SAAO;AACT;AAEA,SAAS,sBAAsB,UAAqC;AAClE,aAAW,CAAC,KAAK,UAAU,KAAK,UAAU;AACxC,QAAI,6BAA6B,GAAG,MAAM,WAAY,0BAAyB,IAAI,KAAK,UAAU;AAAA,EACpG;AACF;AAEA,eAAsB,iCACpB,KACA,YACA,SACe;AACf,QAAM,WAAW,kBAAkB,GAAG;AACtC,QAAM,WAAW,iBAAiB,IAAI,QAAQ,KAAK,QAAQ,QAAQ;AACnE,QAAM,MAAM,SAAS,MAAM,MAAM,MAAS,EAAE,KAAK,YAAY;AAC3D,QAAI,6BAA6B,QAAQ,MAAM,WAAY;AAC3D,UAAM,OAAO,KAAK,KAAK,UAAU,SAAS,2BAA2B;AACrE,UAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAM,UAAU,MAAM,SAAS,MAAM,OAAO,EAAE,MAAM,MAAM,EAAE;AAC5D,QAAI,YAAY,QAAS;AACzB,QAAI,6BAA6B,QAAQ,MAAM,WAAY;AAC3D,UAAM,UAAU,MAAM,SAAS,OAAO;AAAA,EACxC,CAAC;AACD,mBAAiB,IAAI,UAAU,IAAI,KAAK,MAAM,QAAW,MAAM,MAAS,CAAC;AACzE,QAAM;AACR;AAEA,SAAS,6BAA6B,UAAwB;AAC5D,aAAW,QAAQ,2BAA2B,QAAQ,GAAG;AACvD,SAAK,GAAG,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,EACtD;AACF;AAEA,SAAS,sBAAsB,QAA4B;AACzD,MAAI,CAAC,QAAQ,QAAS;AACtB,QAAM,SAAS,OAAO;AACtB,QAAM,kBAAkB,QAAQ,SAAS,IAAI,MAAM,gCAAgC;AACrF;AAEA,SAAS,QAAQ,QAAqC;AACpD,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,MAAgB,CAAC;AACvB,aAAW,SAAS,QAAQ;AAC1B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,QAAQ,WAAW,KAAK,KAAK,IAAI,OAAO,EAAG;AAC/C,SAAK,IAAI,OAAO;AAChB,QAAI,KAAK,OAAO;AAAA,EAClB;AACA,SAAO;AACT;AAEA,SAAS,aAAa,MAA6B,OAAuC;AACxF,SAAO,KAAK,iBAAiB,MAAM,gBAAgB,KAAK,mBAAmB,MAAM;AACnF;AAEA,SAAS,YAAY,UAAwB;AAC3C,kBAAgB,IAAI,WAAW,gBAAgB,IAAI,QAAQ,KAAK,KAAK,CAAC;AACxE;AAEA,SAAS,YAAY,UAA0B;AAC7C,QAAM,QAAQ,SAAS,QAAQ,GAAQ;AACvC,QAAM,aAAa,UAAU,KAAK,KAAK,SAAS,QAAQ,KAAU,QAAQ,CAAC;AAC3E,QAAM,eAAe,UAAU,KAAK,WAAW,SAAS,MAAM,GAAG,KAAK;AACtE,QAAM,aAAa,UAAU,MAAM,eAAe,KAAK,KAAK,SAAS,MAAM,QAAQ,GAAG,UAAU;AAChG,QAAM,OAAO,WACV,MAAM,GAAQ,EACd,IAAI,CAAC,SAAS,KAAK,MAAM,GAAQ,EAAE,CAAC,KAAK,EAAE,EAC3C,KAAK,GAAQ;AAChB,SAAO,GAAG,YAAY,IAAS,IAAI;AACrC;AAEA,SAAS,YAAY,UAAkB,gBAAgB,OAAa;AAClE,QAAM,OAAO,MAAM,IAAI,QAAQ;AAC/B,MAAI,MAAM;AACR,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AACA,MAAI,cAAe,eAAc,QAAQ;AACzC,QAAM,OAAO,QAAQ;AACrB,kBAAgB,OAAO,QAAQ;AACjC;AAEA,SAAS,YAAY,UAAwB;AAC3C,MAAI,MAAM,OAAO,aAAa,MAAM,IAAI,QAAQ,EAAG;AACnD,QAAM,SAAS,MAAM,KAAK,EAAE,KAAK,EAAE;AACnC,MAAI,OAAO,WAAW,SAAU,aAAY,MAAM;AACpD;AAEA,SAAS,gBAAgB,UAAwB;AAC/C,QAAM,SAAS,YAAY,QAAQ;AACnC,aAAW,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG;AACnC,QAAI,QAAQ,YAAY,YAAY,GAAG,MAAM,OAAQ,aAAY,KAAK,IAAI;AAAA,EAC5E;AACF;AAEA,SAAS,sBAAsB,OAAyB;AACtD,SACE,CAAC,CAAC,SACF,OAAO,UAAU,YAChB,MAAgD,4BAA4B;AAEjF;AAEA,SAAS,WAAW,MAAkB;AAGpC,MAAI,CAAC,KAAK,QAAS,MAAK,YAAY;AACpC,eAAa,IAAI;AACnB;AAEA,SAAS,aAAa,MAAkB;AAKtC,MAAI,KAAK,QAAS;AAClB,QAAM,QAAQ,KAAK;AACnB,QAAM,WAAW,sBAAsB,KAAK,QAAQ;AACpD,cAAY,KAAK,QAAQ;AACzB,QAAM,UAAU,KAAK,gBAAgB;AACrC,OAAK,QAAQ;AACb,QAAM,SAA4C,EAAE,SAAS,KAAK;AAClE,SAAO,UAAU,KACd,UAAU,MAAS,EACnB,KAAK,CAAC,UAAU;AACf,QAAI,KAAK,UAAU,SAAS,CAAC,mBAAmB,QAAQ,EAAG;AAC3D,0BAAsB,QAAQ;AAC9B,UAAM,QAAQ,KAAK,gBAAgB;AACnC,SAAK,QAAQ;AACb,QAAI,aAAa,SAAS,KAAK,GAAG;AAChC,WAAK,WAAW;AAChB;AAAA,IACF;AAGA,SAAK,WAAW;AAChB,SAAK,QAAQ;AAAA,EACf,CAAC,EACA,MAAM,CAAC,QAAiB;AACvB,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,QAAI,KAAK,wCAAwC,OAAO,EAAE;AAAA,EAC5D,CAAC,EACA,QAAQ,MAAM;AACb,QAAI,KAAK,YAAY,OAAO,QAAS,MAAK,UAAU;AAIpD,QAAI,CAAC,KAAK,SAAS,KAAK,aAAa,EAAG;AACxC,SAAK,QAAQ;AACb,SAAK,aAAa;AAClB,iBAAa,IAAI;AAAA,EACnB,CAAC;AACH,OAAK,UAAU,OAAO;AACxB;AAEO,SAAS,sBACd,YACA,UACA,gBACQ;AACR,QAAM,eAAe,QAAQ,cAAc,CAAC,CAAC,EAAE,KAAK,GAAQ;AAC5D,QAAM,aAAa,SAChB,IAAI,CAAC,YAAY;AAChB,UAAM,UAAU,OAAO,QAAQ,QAAQ,iBAAiB,CAAC,CAAC,EAAE;AAAA,MAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAC9E,eAAe,MAAM,KAAK;AAAA,IAC5B;AACA,WAAO,GAAG,KAAK,QAAQ,QAAQ,GAAG,CAAC,IAAS,QAAQ,gBAAgB,KAAK,EAAE,IAAS,KAAK,UAAU,OAAO,CAAC;AAAA,EAC7G,CAAC,EACA,KAAK,GAAQ;AAChB,SAAO,GAAG,YAAY,IAAS,UAAU,IAAS,cAAc;AAClE;AAEO,SAAS,sBAAsB,UAA2D;AAC/F,SAAO;AAAA,IACL,cAAc,SAAS,IAAI,CAAC,YAAY,OAAO,mBAAmB,QAAQ,QAAQ,GAAG,CAAC,CAAC,EAAE,KAAK,GAAQ;AAAA,IACtG,gBAAgB,SAAS,IAAI,CAAC,YAAY,OAAO,QAAQ,2BAA2B,KAAK,CAAC,CAAC,EAAE,KAAK,GAAQ;AAAA,EAC5G;AACF;AAEO,SAAS,iCAAiC,UAA0B;AACzE,SAAO,gBAAgB,IAAI,QAAQ,KAAK;AAC1C;AAEO,SAAS,8BAAwC;AACtD,SAAO,CAAC,GAAG,MAAM,KAAK,CAAC;AACzB;AAEO,SAAS,4BAA4B,UAAyB;AACnE,MAAI,aAAa,QAAW;AAC1B,kBAAc;AACd,eAAW,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG;AACnC,mCAA6B,GAAG;AAChC,kBAAY,GAAG;AAAA,IACjB;AACA;AAAA,EACF;AACA,+BAA6B,QAAQ;AACrC,cAAY,UAAU,IAAI;AAC5B;AAEA,eAAsB,yBAAyB,UAAkC;AAC/E,QAAM,UAAU,CAAC,SAAe,aAAa,UAAa,KAAK,aAAa;AAC5E,WAAS,QAAQ,GAAG,QAAQ,eAAe,SAAS,GAAG;AACrD,eAAW,QAAQ,MAAM,OAAO,GAAG;AACjC,UAAI,CAAC,QAAQ,IAAI,EAAG;AACpB,UAAI,CAAC,KAAK,WAAW,KAAK,OAAO;AAC/B,aAAK,QAAQ;AACb,qBAAa,IAAI;AAAA,MACnB;AAAA,IACF;AACA,UAAM,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,QAAQ,IAAI,KAAK,KAAK,OAAO,EAAE,IAAI,CAAC,SAAS,KAAK,OAAQ;AAC/G,QAAI,QAAQ,WAAW,EAAG;AAC1B,UAAM,QAAQ,IAAI,OAAO;AAAA,EAC3B;AACF;AAEA,eAAsB,0BAA6B,SAMpC;AACb,QAAM,OAAO,QAAQ,gBAAgB;AACrC,QAAM,WAAW,MAAM,IAAI,QAAQ,QAAQ;AAC3C,MAAI,CAAC,UAAU;AACb,oBAAgB,QAAQ,QAAQ;AAChC,gBAAY,QAAQ,QAAQ;AAC5B,gBAAY,QAAQ,QAAQ;AAC5B,UAAM,WAAW,sBAAsB,QAAQ,QAAQ;AACvD,UAAM,UAAU,QAAQ,gBAAgB;AACxC,UAAM,QAAQ,MAAM,QAAQ,UAAU,QAAQ,WAAW;AAEzD,QAAI,CAAC,mBAAmB,QAAQ,EAAG,QAAO;AAC1C,0BAAsB,QAAQ;AAC9B,UAAM,QAAQ,QAAQ,gBAAgB;AACtC,oBAAgB,QAAQ,QAAQ;AAChC,gBAAY,QAAQ,QAAQ;AAC5B,UAAM,OAAa;AAAA,MACjB,UAAU,QAAQ;AAAA,MAClB;AAAA,MACA,UAAU,aAAa,SAAS,KAAK,IAAI,QAAQ;AAAA,MACjD,OAAO;AAAA,MACP,SAAS;AAAA,MACT,WAAW;AAAA,MACX,OAAO;AAAA,MACP,WAAW;AAAA,MACX,iBAAiB,QAAQ;AAAA,MACzB,WAAW,QAAQ;AAAA,IACrB;AACA,UAAM,IAAI,QAAQ,UAAU,IAAI;AAChC,QAAI,CAAC,aAAa,SAAS,KAAK,EAAG,YAAW,IAAI;AAClD,WAAO;AAAA,EACT;AACA,WAAS,kBAAkB,QAAQ;AACnC,WAAS,YAAY,QAAQ;AAC7B,SAAO,SAAS,SAAS,mBAAmB,QAAQ,gBAAgB,EAAE,gBAAgB;AACpF,0BAAsB,QAAQ,WAAW;AACzC,UAAM,UAAU,SAAS;AACzB,QAAI,SAAS;AACX,YAAM,UAAU,SAAS,QAAQ,aAAa,gCAAgC;AAC9E;AAAA,IACF;AACA,UAAM,UAAU,QAAQ,gBAAgB;AACxC,UAAM,cAAc,SAAS,SAAS;AACtC,UAAM,iBAAiB,QAAQ;AAC/B,QAAI,UAAU,MAAY;AAAA,IAAC;AAC3B,UAAM,OAAO,IAAI,QAAc,CAAC,YAAY;AAC1C,gBAAU;AAAA,IACZ,CAAC;AACD,aAAS,YAAY;AACrB,aAAS,SAAS;AAClB,aAAS,QAAQ;AACjB,UAAM,QAAQ,SAAS;AACvB,UAAM,WAAW,sBAAsB,SAAS,QAAQ;AAKxD,UAAM,OAAO,QAAQ,gBAAgB,SAAS,OAAY,MAAS;AACnE,SAAK,KACF;AAAA,MACC,CAACA,aAAY;AACX,YAAI,SAAS,UAAU,SAAS,CAAC,mBAAmB,QAAQ,EAAG;AAC/D,cAAM,MAAM,QAAQ,gBAAgB;AACpC,iBAAS,QAAQA;AACjB,cAAM,cAAc,gBAAgB,QAAQ,gBAAgB,gBAAgB,IAAI;AAChF,cAAM,iBAAiB,mBAAmB,IAAI;AAC9C,iBAAS,WAAW;AAAA,UAClB,gBAAgB,iBAAiB,IAAI,iBAAiB;AAAA,UACtD,cAAc,cAAc,IAAI,eAAe;AAAA,QACjD;AACA,YAAI,SAAS,SAAS,iBAAiB,IAAI,gBAAgB,sBAAsBA,QAAO,GAAG;AACzF,qBAAW,QAAQ;AAAA,QACrB;AAAA,MACF;AAAA,MACA,MAAM;AAAA,MAAC;AAAA,IACT,EACC,QAAQ,MAAM;AACb,UAAI,SAAS,cAAc,KAAM,UAAS,YAAY;AACtD,cAAQ;AAAA,IACV,CAAC;AACH,UAAM,UAAU,MAAM,UAAU,MAAM,QAAQ,aAAa,gCAAgC;AAC3F,0BAAsB,QAAQ,WAAW;AACzC,WAAO;AAAA,EACT;AACA,MAAI,SAAS,SAAS,iBAAiB,KAAK,cAAc;AACxD,eAAW,QAAQ;AACnB,WAAO,SAAS;AAAA,EAClB;AACA,SAAO,SAAS;AAClB;AAEA,mBAAmB,cAAc,MAAM;AACrC,8BAA4B;AAC9B,CAAC;","names":["rebuilt"]}

package/dist/{chunk-EBOHFZI4.js → chunk-E5QEF3JO.js}

@@ -1,6 +1,6 @@
 import {
   resolveCorpusNamespaceRoots
-} from "./chunk-TFLPDNQV.js";
+} from "./chunk-CCU7URRP.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-YO2JEX2Z.js";
@@ -200,4 +200,4 @@ async function readAggregateExtractionWatermark(options) {
 export {
   readAggregateExtractionWatermark
 };
-//# sourceMappingURL=chunk-EBOHFZI4.js.map
+//# sourceMappingURL=chunk-E5QEF3JO.js.map

package/dist/{chunk-DD6OIFDG.js → chunk-E7V5AK7I.js}

@@ -5,7 +5,7 @@ import {
   entityMentionScopeKey,
   resolveEntityMentionIndex,
   writePersistedEntityMentionIndex
-} from "./chunk-S57QBPTA.js";
+} from "./chunk-DPPLNZ3A.js";
 import {
   buildOriginStructuredSections,
   sanitizeOriginatedFacts
@@ -34,7 +34,7 @@ import {
 } from "./chunk-NVKO5YKP.js";
 import {
   compareEntityTimestamps
-} from "./chunk-WAD32CZG.js";
+} from "./chunk-ELWI2R6H.js";
 import {
   normalizeEntityText,
   resolveRequestedEntitySectionKeys
@@ -927,4 +927,4 @@ export {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours
 };
-//# sourceMappingURL=chunk-DD6OIFDG.js.map
+//# sourceMappingURL=chunk-E7V5AK7I.js.map

package/dist/{chunk-WAD32CZG.js → chunk-ELWI2R6H.js}

@@ -22,11 +22,11 @@ import {
 } from "./chunk-IGOW4TJE.js";
 import {
   BufferSessionFiles
-} from "./chunk-7PMOCQOL.js";
+} from "./chunk-3ODZLCHC.js";
 import {
   normalizeQmdResultPath,
   resolveNamespaceResultPath
-} from "./chunk-LU66I56Q.js";
+} from "./chunk-H34INI3P.js";
 import {
   withholdToolScopedFromSharedNamespace
 } from "./chunk-S2V7RUCL.js";
@@ -37,13 +37,13 @@ import {
 import {
   parseOfflineSyncDigestCache
 } from "./chunk-X3724WL4.js";
+import {
+  createMemorySnapshot
+} from "./chunk-S2HLHAZ4.js";
 import {
   rewriteProjectedEntityReferences,
   rewriteProjectedMemoryEntityReference
 } from "./chunk-MRPOZBJC.js";
-import {
-  createMemorySnapshot
-} from "./chunk-S2HLHAZ4.js";
 import {
   rotateMarkdownFileToArchive
 } from "./chunk-DM2T26WE.js";
@@ -61,7 +61,7 @@ import {
   parseProvenanceTag,
   reconcileProvenanceRead,
   serializeProvenanceFields
-} from "./chunk-FF6N7BXC.js";
+} from "./chunk-S45INSV3.js";
 import {
   parseFaithfulnessField,
   serializeFaithfulnessFields
@@ -73,15 +73,12 @@ import {
   invalidationCommitFingerprint,
   parseTombstoneBlockedOfflineSyncMemory,
   withCasCommitReceipt
-} from "./chunk-BV2BRHD4.js";
+} from "./chunk-FHGWKODN.js";
 import {
   matchEntitySchemaSection,
   normalizeEntityStructuredSection,
   sortStructuredSectionsBySchema
 } from "./chunk-ZIKENA2C.js";
-import {
-  normalizeEntityName
-} from "./chunk-YXZG5TVN.js";
 import {
   OKF_QUESTION_TYPE,
   assertNotOkfReservedBasename,
@@ -94,6 +91,9 @@ import {
   normalizeProjectionPreview,
   normalizeProjectionTags
 } from "./chunk-SCU65EZI.js";
+import {
+  normalizeEntityName
+} from "./chunk-YXZG5TVN.js";
 import {
   checkCorpusReadAbort
 } from "./chunk-P4GUQSK3.js";
@@ -182,7 +182,7 @@ import {
   composeMemoryEnvelope,
   isSealedMemoryEnvelope,
   sealedWriteToLegacyArgs
-} from "./chunk-JRVMCZE3.js";
+} from "./chunk-QEYTRFR3.js";
 import {
   DEFAULT_CITATION_FORMAT,
   hasCitationForTemplate,
@@ -228,7 +228,7 @@ import {
   CONTENT_HASH_INDEX_RETRY_MAX_DELAY_MS,
   ContentHashIndex,
   FactHashIndexNotAuthoritativeError
-} from "./chunk-KQUSP6LB.js";
+} from "./chunk-UDKWFDV2.js";
 import {
   computeLegacyContentHash
 } from "./chunk-5FVVY2EB.js";
@@ -8584,6 +8584,19 @@ ${sanitized.text}
   async isFactContentHashAuthoritative() {
     return await this.ensureFactHashIndexAuthoritative();
   }
+  /**
+   * Shared-index membership of `content` plus the authority of that answer,
+   * read in one synchronous step after the freshness check or locked rebuild.
+   * A separate probe and `isFactContentHashAuthoritative()` call can pair a
+   * stale MISS with authority from another moment, because each one may rebuild
+   * the index (#3312). Trust a MISS only when `authoritative`; otherwise
+   * confirm against the corpus.
+   */
+  async lookupContentHash(content) {
+    const index = await this.getFactHashIndex();
+    await this.ensureFactHashIndexAuthoritative();
+    return { present: index.has(content), authoritative: this.factHashIndexAuthoritative === true };
+  }
   async writeArtifact(quote, options = {}) {
     await this.ensureDirectories();
     const now = /* @__PURE__ */ new Date();
@@ -11039,4 +11052,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-WAD32CZG.js.map
+//# sourceMappingURL=chunk-ELWI2R6H.js.map