@remnic/core 10.0.7 → 10.0.9

package/dist/active-recall.js

@@ -44,12 +44,13 @@ import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-BOOFTFFE.js";
-import "./chunk-OX5LMCEQ.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-WJLGUY27.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-YV54LYEB.js";
-import "./chunk-J5QL66XK.js";
+import "./chunk-7UX44C4N.js";
+import "./chunk-MB5EJ2CT.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -57,7 +58,6 @@ import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
@@ -66,8 +66,8 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
@@ -88,12 +88,12 @@ import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-JALYQUYO.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
-import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -137,15 +137,15 @@ import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-QWDH4QNA.js";
+import "./chunk-MZBWIJJN.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-3E6DGSGZ.js";
-import "./chunk-NJTW2MUV.js";
-import "./chunk-TPNCVFVI.js";
+import "./chunk-AAM66QCP.js";
+import "./chunk-3NFN4Y4P.js";
+import "./chunk-TYT4TEQV.js";
 import "./chunk-63LFM77Z.js";
 import "./chunk-EFHNFTWB.js";
 import "./chunk-GCGJW34D.js";
-import "./chunk-TYT4TEQV.js";
 import "./chunk-ZI7LMSNI.js";
 import "./chunk-Y57GJDG5.js";
 import "./chunk-LQWOFU6L.js";

package/dist/adapters/index.js

@@ -3,7 +3,10 @@ import {
   AdapterRegistry,
   GrokAdapter,
   OpenCodeAdapter
-} from "../chunk-64S6X4IU.js";
+} from "../chunk-XTN54NML.js";
+import {
+  ClaudeCodeAdapter
+} from "../chunk-3JKYQBLC.js";
 import {
   CodexAdapter
 } from "../chunk-7RKSJVOQ.js";
@@ -13,9 +16,6 @@ import {
 import {
   ReplitAdapter
 } from "../chunk-SI36RWC3.js";
-import {
-  ClaudeCodeAdapter
-} from "../chunk-3JKYQBLC.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/adapters/registry.js

@@ -1,10 +1,10 @@
 import {
   AdapterRegistry
-} from "../chunk-64S6X4IU.js";
+} from "../chunk-XTN54NML.js";
+import "../chunk-3JKYQBLC.js";
 import "../chunk-7RKSJVOQ.js";
 import "../chunk-HCAGBFE7.js";
 import "../chunk-SI36RWC3.js";
-import "../chunk-3JKYQBLC.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/briefing.js

@@ -18,15 +18,16 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-BSWHZJSP.js";
+} from "./chunk-C3WJNRGR.js";
 import "./chunk-GZFKCLRC.js";
 import "./chunk-6JMQR72P.js";
-import "./chunk-OX5LMCEQ.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-WJLGUY27.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-YV54LYEB.js";
-import "./chunk-J5QL66XK.js";
+import "./chunk-7UX44C4N.js";
+import "./chunk-MB5EJ2CT.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -34,7 +35,6 @@ import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
@@ -43,8 +43,8 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
@@ -64,12 +64,12 @@ import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-JALYQUYO.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
-import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";

package/dist/buffer.js

@@ -1,21 +1,21 @@
 import {
   SmartBuffer
-} from "./chunk-M4MAVJJX.js";
+} from "./chunk-55ZVZBX4.js";
 import "./chunk-T5IF2ZCE.js";
 import "./chunk-H3FZVNRN.js";
-import "./chunk-T5XG6GQI.js";
-import "./chunk-PXTZOU5F.js";
+import "./chunk-LOFVW6JA.js";
+import "./chunk-PBVNVKYN.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-JALYQUYO.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
-import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";

package/dist/causal-consolidation.js

@@ -4,12 +4,12 @@ import {
 } from "./chunk-YDH2FSDI.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-YMVLPVQP.js";
+} from "./chunk-6PHB45IU.js";
 import "./chunk-5JMAGU26.js";
 import "./chunk-B7RWBZXW.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-BR75HFPC.js";
+} from "./chunk-ZQYAE2C5.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-PIWFNPQT.js";
 import "./chunk-TOTT6S2V.js";
@@ -19,12 +19,13 @@ import "./chunk-QDW3E4RD.js";
 import {
   resolveCausalTrajectoryStoreDir
 } from "./chunk-BOOFTFFE.js";
-import "./chunk-OX5LMCEQ.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-WJLGUY27.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-YV54LYEB.js";
-import "./chunk-J5QL66XK.js";
+import "./chunk-7UX44C4N.js";
+import "./chunk-MB5EJ2CT.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -32,7 +33,6 @@ import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
@@ -41,8 +41,8 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
@@ -62,12 +62,12 @@ import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-JALYQUYO.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WVHRNAXL.js";
 import "./chunk-TPSLVZHS.js";
-import "./chunk-SIGAGKNE.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";

package/dist/{chunk-B2UK6O2O.js → chunk-2K7D6EFT.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-ZSJGYC3C.js";
 import {
   StorageManager
-} from "./chunk-OX5LMCEQ.js";
+} from "./chunk-WJLGUY27.js";
 import {
   parseContinuityImprovementLoops
 } from "./chunk-LDXUBPMO.js";
@@ -1277,4 +1277,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-B2UK6O2O.js.map
+//# sourceMappingURL=chunk-2K7D6EFT.js.map

package/dist/{chunk-Z4CETAL7.js → chunk-3ENX2RB4.js}

@@ -1,6 +1,6 @@
 import {
   parseEntityFile
-} from "./chunk-OX5LMCEQ.js";
+} from "./chunk-WJLGUY27.js";
 import {
   inferMemoryStatus
 } from "./chunk-7RJUVTVF.js";
@@ -253,4 +253,4 @@ export {
   WHO_KNOWS_MCP_TOOLS,
   handleWhoKnowsHttpQuery
 };
-//# sourceMappingURL=chunk-Z4CETAL7.js.map
+//# sourceMappingURL=chunk-3ENX2RB4.js.map

package/dist/{chunk-TPNCVFVI.js → chunk-3NFN4Y4P.js}

@@ -1,12 +1,12 @@
+import {
+  EMBEDDING_SHARD_FILE_PATTERN
+} from "./chunk-TYT4TEQV.js";
 import {
   matchesOfflineSyncDefaultExclude
 } from "./chunk-63LFM77Z.js";
 import {
   resolveSafeArchiveTarget
 } from "./chunk-GCGJW34D.js";
-import {
-  EMBEDDING_SHARD_FILE_PATTERN
-} from "./chunk-TYT4TEQV.js";
 import {
   assertEmbeddingGenerationLockHeld,
   embeddingGenerationLockPath,
@@ -681,4 +681,4 @@ export {
   divergedEmbeddingGenerationDeferrals,
   applyIncomingEmbeddingGenerations
 };
-//# sourceMappingURL=chunk-TPNCVFVI.js.map
+//# sourceMappingURL=chunk-3NFN4Y4P.js.map

package/dist/{chunk-HHE57I2Z.js → chunk-3R6SLDTH.js}

@@ -1,7 +1,7 @@
 import {
   rebuildMemoryProjection,
   watchProjectionRebuildParent
-} from "./chunk-ETGXRGSR.js";
+} from "./chunk-JSIQSZXI.js";
 import {
   initLogger,
   log
@@ -77,4 +77,4 @@ if (invokedAsRunner) {
 export {
   PROJECTION_REBUILD_RUNNER_FLAG
 };
-//# sourceMappingURL=chunk-HHE57I2Z.js.map
+//# sourceMappingURL=chunk-3R6SLDTH.js.map

package/dist/{chunk-WUUE2I2A.js → chunk-3VTNNO2B.js}

@@ -21,13 +21,13 @@ import {
   defineOperation,
   parseNamespacePreflightWriteOp,
   resolveAuthorizedNamespaceWritablePreflight
-} from "./chunk-QF7XX74D.js";
+} from "./chunk-NYVKLB2I.js";
 import {
   parseSharedWriteOutputControls
 } from "./chunk-IFBSZGW3.js";
 import {
   validateBriefingFormat
-} from "./chunk-BSWHZJSP.js";
+} from "./chunk-C3WJNRGR.js";
 import {
   parseDeepRecallMaxSteps
 } from "./chunk-A7AISUJI.js";
@@ -44,7 +44,7 @@ import {
   recallRequestSchema,
   retainedCategoryAlias,
   suggestionSubmitRequestSchema
-} from "./chunk-ZBDTSFRA.js";
+} from "./chunk-CBP4HWCL.js";
 import {
   enforceNamespaceAllowList,
   tokenCapabilityStore
@@ -603,4 +603,4 @@ defineOperation({ name: "graph_events", description: "SSE graph events.", schema
 defineOperation({ name: "chat_message", description: "Chat message.", schema: strictSchema({ message: S.str, chatSessionId: S.str }), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
 defineOperation({ name: "chat_events", description: "SSE chat events.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { stream: "sse" } }) });
 defineOperation({ name: "adapters_status", description: "Adapter registry metadata (issue #1850 round 5). Marker op: the HTTP transport builds the response from its own adapterRegistry, but the op still must be registered so it appears in listRegisteredOperations and enforceTokenOp can gate it for scoped tokens.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
-//# sourceMappingURL=chunk-WUUE2I2A.js.map
+//# sourceMappingURL=chunk-3VTNNO2B.js.map

package/dist/{chunk-ODGXQUPR.js → chunk-4OKPH6FG.js}

@@ -2,7 +2,7 @@ import {
   SupportPassportError,
   SupportPassportOwnerCreateGrantRequestSchema,
   getOperation
-} from "./chunk-QF7XX74D.js";
+} from "./chunk-NYVKLB2I.js";
 
 // src/support-passport/access-http.ts
 var OWNER_ROOT = "/engram/v1/support-passport";
@@ -137,4 +137,4 @@ export {
   SUPPORT_PASSPORT_OWNER_HTTP_ROUTES,
   handleSupportPassportOwnerHttp
 };
-//# sourceMappingURL=chunk-ODGXQUPR.js.map
+//# sourceMappingURL=chunk-4OKPH6FG.js.map

package/dist/{chunk-M4MAVJJX.js → chunk-55ZVZBX4.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-H3FZVNRN.js";
 import {
   ExtractionDeadlineError
-} from "./chunk-T5XG6GQI.js";
+} from "./chunk-LOFVW6JA.js";
 import {
   resolvePrincipal
 } from "./chunk-OEIA4IHU.js";
@@ -801,4 +801,4 @@ var SmartBuffer = class {
 export {
   SmartBuffer
 };
-//# sourceMappingURL=chunk-M4MAVJJX.js.map
+//# sourceMappingURL=chunk-55ZVZBX4.js.map

package/dist/{chunk-VQBGV44L.js → chunk-5EOV7ANU.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-OX5LMCEQ.js";
+} from "./chunk-WJLGUY27.js";
 import {
   getCachedRuleMemories,
   setCachedRuleMemories
@@ -119,4 +119,4 @@ export {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
 };
-//# sourceMappingURL=chunk-VQBGV44L.js.map
+//# sourceMappingURL=chunk-5EOV7ANU.js.map

package/dist/{chunk-JH4XB3RX.js → chunk-5FNVK7MW.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-CG2E6WT5.js";
+} from "./chunk-GDI64ITR.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-IG747LRN.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-JH4XB3RX.js.map
+//# sourceMappingURL=chunk-5FNVK7MW.js.map

package/dist/{chunk-2SKI5ZSH.js → chunk-5NOPZYNI.js}

@@ -3,7 +3,7 @@ import {
   readNamespaceMaintenanceLastRanStatuses,
   readNamespaceMaintenanceStatuses,
   runNamespaceMaintenancePlan
-} from "./chunk-FRRR4KOW.js";
+} from "./chunk-L3Z4NXDO.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -14,7 +14,7 @@ import {
 } from "./chunk-CMTINOFS.js";
 import {
   summarizeCorpusAndReplica
-} from "./chunk-F2QIPGTG.js";
+} from "./chunk-JTUKDLAD.js";
 import {
   readJudgeVerdictStats
 } from "./chunk-OZKOPQCM.js";
@@ -41,14 +41,14 @@ import {
 } from "./chunk-VUQDJ3JB.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-E3OSDZ6M.js";
+} from "./chunk-5Q4NQNW7.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-KMAHEIOH.js";
+} from "./chunk-AV46CT77.js";
 import {
   listNamespaces
-} from "./chunk-CG2E6WT5.js";
+} from "./chunk-GDI64ITR.js";
 import {
   analyzeGraphHealth
 } from "./chunk-BTJ6CAIA.js";
@@ -57,7 +57,7 @@ import {
 } from "./chunk-AWD36R4D.js";
 import {
   StorageManager
-} from "./chunk-OX5LMCEQ.js";
+} from "./chunk-WJLGUY27.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
@@ -1683,4 +1683,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-2SKI5ZSH.js.map
+//# sourceMappingURL=chunk-5NOPZYNI.js.map

package/dist/{chunk-E3OSDZ6M.js → chunk-5Q4NQNW7.js}

@@ -1,6 +1,6 @@
 import {
   resolveCorpusNamespaceRoots
-} from "./chunk-JH4XB3RX.js";
+} from "./chunk-5FNVK7MW.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-IG747LRN.js";
@@ -200,4 +200,4 @@ async function readAggregateExtractionWatermark(options) {
 export {
   readAggregateExtractionWatermark
 };
-//# sourceMappingURL=chunk-E3OSDZ6M.js.map
+//# sourceMappingURL=chunk-5Q4NQNW7.js.map

package/dist/chunk-5VC7J76U.js

@@ -0,0 +1,134 @@
+import {
+  readProjectedMemoryPaths
+} from "./chunk-AZEZSQ5R.js";
+import {
+  throwIfAborted
+} from "./chunk-BTTPKDIL.js";
+import {
+  isRecord
+} from "./chunk-A2IYSXDQ.js";
+import {
+  readJsonFile,
+  writeJsonFileAtomic
+} from "./chunk-B6O2YLUR.js";
+import {
+  isPathInsideStorageRoot,
+  isSafeLegacyPathSegment
+} from "./chunk-LDPPTPO5.js";
+import {
+  SecureStoreLockedError
+} from "./chunk-MAAL6OZV.js";
+import {
+  RECALL_FALLBACK_DIRS
+} from "./chunk-VS2IYZRU.js";
+
+// src/harmonic-source-lookup.ts
+import path from "path";
+import { existsSync } from "fs";
+import { mkdir, realpath } from "fs/promises";
+var LOOKUP_TTL_MS = 10 * 6e4;
+var MAX_CACHE_ENTRIES = 4096;
+async function readHarmonicSourceMemory(storage, rootReal, filePath, abortSignal) {
+  throwIfAborted(abortSignal, "harmonic retrieval aborted");
+  if (!existsSync(filePath)) return null;
+  try {
+    if (!isPathInsideStorageRoot(rootReal, await realpath(filePath))) return null;
+    return await storage.readMemoryByPath(filePath);
+  } catch (err) {
+    throwIfAborted(abortSignal, "harmonic retrieval aborted");
+    if (err instanceof SecureStoreLockedError) throw err;
+    return null;
+  }
+}
+function isCorpusPath(memoryDir, filePath) {
+  if (!isPathInsideStorageRoot(memoryDir, filePath)) return false;
+  const [dir] = path.relative(memoryDir, filePath).split(path.sep);
+  return dir === "cold" || RECALL_FALLBACK_DIRS.includes(dir);
+}
+async function readPathCache(filePath, rebuiltAt, corpusVersion, nowMs) {
+  try {
+    const raw = await readJsonFile(filePath);
+    if (!isRecord(raw) || raw.rebuiltAt !== rebuiltAt || raw.corpusVersion !== corpusVersion || !Array.isArray(raw.entries)) return /* @__PURE__ */ new Map();
+    const entries = /* @__PURE__ */ new Map();
+    for (const row of raw.entries) {
+      if (!Array.isArray(row) || row.length !== 3) continue;
+      const [id, storedPath, expiresAt] = row;
+      if (typeof id !== "string" || storedPath !== null && typeof storedPath !== "string") continue;
+      if (typeof expiresAt !== "number" || !Number.isFinite(expiresAt) || expiresAt <= nowMs || expiresAt > nowMs + LOOKUP_TTL_MS) continue;
+      entries.set(id, { path: storedPath, expiresAt });
+    }
+    return entries;
+  } catch {
+    return /* @__PURE__ */ new Map();
+  }
+}
+async function readUnresolvedHarmonicSources(options) {
+  const { storage, rootReal, rebuiltAt, nowMs, abortSignal } = options;
+  throwIfAborted(abortSignal, "harmonic retrieval aborted");
+  const corpusVersion = storage.getCorpusScanVersion();
+  const stateDir = path.join(storage.dir, "state");
+  const cachePath = path.join(stateDir, "harmonic-source-paths.json");
+  const stateReal = await realpath(stateDir).catch(() => null);
+  const safeCache = stateReal !== null && isPathInsideStorageRoot(rootReal, stateReal);
+  const cache = safeCache ? await readPathCache(cachePath, rebuiltAt, corpusVersion, nowMs) : /* @__PURE__ */ new Map();
+  const found = /* @__PURE__ */ new Map();
+  const pending = /* @__PURE__ */ new Set();
+  for (const id of options.sourceMemoryIds) {
+    throwIfAborted(abortSignal, "harmonic retrieval aborted");
+    const entry = cache.get(id);
+    if (entry?.path === null) continue;
+    if (entry?.path) {
+      const candidate = path.resolve(storage.dir, entry.path);
+      const memory = isCorpusPath(storage.dir, candidate) ? await readHarmonicSourceMemory(storage, rootReal, candidate, abortSignal) : null;
+      if (memory?.frontmatter.id === id) {
+        found.set(id, memory);
+        continue;
+      }
+    }
+    pending.add(id);
+  }
+  if (pending.size === 0) return found;
+  const inspectProjected = [...pending].some((id) => !isSafeLegacyPathSegment(id));
+  const projectedPaths = readProjectedMemoryPaths(storage.dir);
+  const walked = [
+    ...await storage.collectActiveMemoryPaths({ abortSignal, propagateReadErrors: true }),
+    ...await storage.collectColdMemoryPaths({ abortSignal, propagateReadErrors: true })
+  ];
+  for (const filePath of walked) {
+    throwIfAborted(abortSignal, "harmonic retrieval aborted");
+    if (!inspectProjected && !pending.has(path.basename(filePath, ".md")) && projectedPaths?.has(filePath)) continue;
+    const memory = await readHarmonicSourceMemory(storage, rootReal, filePath, abortSignal);
+    if (!memory) continue;
+    const id = memory.frontmatter.id;
+    if (pending.has(id)) {
+      found.set(id, memory);
+      cache.set(id, { path: path.relative(storage.dir, filePath), expiresAt: nowMs + LOOKUP_TTL_MS });
+    }
+  }
+  for (const id of pending) {
+    if (!found.has(id)) cache.set(id, { path: null, expiresAt: nowMs + LOOKUP_TTL_MS });
+  }
+  throwIfAborted(abortSignal, "harmonic retrieval aborted");
+  if (storage.getCorpusScanVersion() === corpusVersion) {
+    try {
+      await mkdir(stateDir, { recursive: true });
+      if (isPathInsideStorageRoot(rootReal, await realpath(stateDir))) {
+        throwIfAborted(abortSignal, "harmonic retrieval aborted");
+        await writeJsonFileAtomic(cachePath, {
+          rebuiltAt,
+          corpusVersion,
+          entries: [...cache].slice(-MAX_CACHE_ENTRIES).map(([id, entry]) => [id, entry.path, entry.expiresAt])
+        });
+      }
+    } catch {
+      throwIfAborted(abortSignal, "harmonic retrieval aborted");
+    }
+  }
+  return found;
+}
+
+export {
+  readHarmonicSourceMemory,
+  readUnresolvedHarmonicSources
+};
+//# sourceMappingURL=chunk-5VC7J76U.js.map

package/dist/chunk-5VC7J76U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/harmonic-source-lookup.ts"],"sourcesContent":["import path from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { mkdir, realpath } from \"node:fs/promises\";\nimport { throwIfAborted } from \"./abort-error.js\";\nimport { readJsonFile, writeJsonFileAtomic } from \"./json-store.js\";\nimport { readProjectedMemoryPaths } from \"./memory-projection-batch.js\";\nimport { SecureStoreLockedError } from \"./secure-store/secure-fs.js\";\nimport { isPathInsideStorageRoot, isSafeLegacyPathSegment } from \"./storage-paths.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport type { StorageManager } from \"./storage.js\";\nimport type { MemoryFile } from \"./types.js\";\nimport { RECALL_FALLBACK_DIRS } from \"./utils/category-dir.js\";\n\nconst LOOKUP_TTL_MS = 10 * 60_000;\nconst MAX_CACHE_ENTRIES = 4096;\ntype PathEntry = { path: string | null; expiresAt: number };\n\n/** Direct and cached probes must retain the walk's realpath containment check. */\nexport async function readHarmonicSourceMemory(\n  storage: StorageManager,\n  rootReal: string,\n  filePath: string,\n  abortSignal?: AbortSignal,\n): Promise<MemoryFile | null> {\n  throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n  if (!existsSync(filePath)) return null;\n  try {\n    if (!isPathInsideStorageRoot(rootReal, await realpath(filePath))) return null;\n    return await storage.readMemoryByPath(filePath);\n  } catch (err) {\n    throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n    if (err instanceof SecureStoreLockedError) throw err;\n    return null;\n  }\n}\n\nfunction isCorpusPath(memoryDir: string, filePath: string): boolean {\n  if (!isPathInsideStorageRoot(memoryDir, filePath)) return false;\n  const [dir] = path.relative(memoryDir, filePath).split(path.sep);\n  return dir === \"cold\" || RECALL_FALLBACK_DIRS.includes(dir);\n}\n\n/** A cache miss is not authoritative: unreadable/invalid cache state keeps the walk. */\nasync function readPathCache(\n  filePath: string, rebuiltAt: string, corpusVersion: string, nowMs: number,\n): Promise<Map<string, PathEntry>> {\n  try {\n    const raw = await readJsonFile(filePath);\n    if (!isRecord(raw) || raw.rebuiltAt !== rebuiltAt || raw.corpusVersion !== corpusVersion || !Array.isArray(raw.entries)) return new Map();\n    const entries = new Map<string, PathEntry>();\n    for (const row of raw.entries) {\n      if (!Array.isArray(row) || row.length !== 3) continue;\n      const [id, storedPath, expiresAt] = row;\n      if (typeof id !== \"string\" || (storedPath !== null && typeof storedPath !== \"string\")) continue;\n      if (typeof expiresAt !== \"number\" || !Number.isFinite(expiresAt) || expiresAt <= nowMs || expiresAt > nowMs + LOOKUP_TTL_MS) continue;\n      entries.set(id, { path: storedPath, expiresAt });\n    }\n    return entries;\n  } catch {\n    return new Map();\n  }\n}\n\n/** Resolve only unresolved ids; persist paths/absence, never memory content. */\nexport async function readUnresolvedHarmonicSources(options: {\n  storage: StorageManager;\n  rootReal: string;\n  rebuiltAt: string;\n  sourceMemoryIds: string[];\n  nowMs: number;\n  abortSignal?: AbortSignal;\n}): Promise<Map<string, MemoryFile>> {\n  const { storage, rootReal, rebuiltAt, nowMs, abortSignal } = options;\n  throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n  const corpusVersion = storage.getCorpusScanVersion();\n  const stateDir = path.join(storage.dir, \"state\");\n  const cachePath = path.join(stateDir, \"harmonic-source-paths.json\");\n  const stateReal = await realpath(stateDir).catch(() => null);\n  const safeCache = stateReal !== null && isPathInsideStorageRoot(rootReal, stateReal);\n  const cache = safeCache ? await readPathCache(cachePath, rebuiltAt, corpusVersion, nowMs) : new Map<string, PathEntry>();\n  const found = new Map<string, MemoryFile>();\n  const pending = new Set<string>();\n  for (const id of options.sourceMemoryIds) {\n    throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n    const entry = cache.get(id);\n    if (entry?.path === null) continue;\n    if (entry?.path) {\n      const candidate = path.resolve(storage.dir, entry.path);\n      const memory = isCorpusPath(storage.dir, candidate)\n        ? await readHarmonicSourceMemory(storage, rootReal, candidate, abortSignal) : null;\n      if (memory?.frontmatter.id === id) {\n        found.set(id, memory);\n        continue;\n      }\n    }\n    pending.add(id);\n  }\n  if (pending.size === 0) return found;\n\n  // Opaque legacy ids previously used the full scan, including edited projected files.\n  const inspectProjected = [...pending].some((id) => !isSafeLegacyPathSegment(id));\n  const projectedPaths = readProjectedMemoryPaths(storage.dir);\n  const walked = [\n    ...(await storage.collectActiveMemoryPaths({ abortSignal, propagateReadErrors: true })),\n    ...(await storage.collectColdMemoryPaths({ abortSignal, propagateReadErrors: true })),\n  ];\n  for (const filePath of walked) {\n    throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n    // Existing projected files need no parse unless their filename names a wanted id.\n    // New/imported files must be keyed by frontmatter id, not their basename (#3188).\n    if (!inspectProjected && !pending.has(path.basename(filePath, \".md\")) && projectedPaths?.has(filePath)) continue;\n    const memory = await readHarmonicSourceMemory(storage, rootReal, filePath, abortSignal);\n    if (!memory) continue;\n    const id = memory.frontmatter.id;\n    if (pending.has(id)) {\n      found.set(id, memory);\n      cache.set(id, { path: path.relative(storage.dir, filePath), expiresAt: nowMs + LOOKUP_TTL_MS });\n    }\n  }\n  for (const id of pending) {\n    if (!found.has(id)) cache.set(id, { path: null, expiresAt: nowMs + LOOKUP_TTL_MS });\n  }\n  throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n  // A concurrent mutation must not publish absence for a different corpus epoch.\n  if (storage.getCorpusScanVersion() === corpusVersion) {\n    try {\n      await mkdir(stateDir, { recursive: true });\n      if (isPathInsideStorageRoot(rootReal, await realpath(stateDir))) {\n        throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n        // ponytail: atomic last-writer-wins cache; contention can repeat a walk, not lose sources.\n        await writeJsonFileAtomic(cachePath, {\n          rebuiltAt, corpusVersion,\n          entries: [...cache].slice(-MAX_CACHE_ENTRIES).map(([id, entry]) => [id, entry.path, entry.expiresAt]),\n        });\n      }\n    } catch {\n      throwIfAborted(abortSignal, \"harmonic retrieval aborted\");\n      // Cache publication is optional; resolved memories remain usable on a read-only store.\n    }\n  }\n  return found;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YMVLPVQP.js → chunk-6PHB45IU.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-5JMAGU26.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-BR75HFPC.js";
+} from "./chunk-ZQYAE2C5.js";
 import {
   isSemanticConsolidationLlmOperator
 } from "./chunk-G7D6GZ5J.js";
@@ -220,4 +220,4 @@ export {
   buildExtensionsBlockForConsolidation,
   materializeAfterSemanticConsolidation
 };
-//# sourceMappingURL=chunk-YMVLPVQP.js.map
+//# sourceMappingURL=chunk-6PHB45IU.js.map