@remnic/core 9.48.1 → 9.49.1

package/dist/{chunk-2P3GQVM2.js → chunk-RBPH3GZV.js}

@@ -6,14 +6,14 @@ import {
   loadSyncState,
   syncWearableSource,
   wearableSourceLabel
-} from "./chunk-UYUYZ4WY.js";
+} from "./chunk-IARXXZU4.js";
 import {
   CompressionGuidelineCoordinator
 } from "./chunk-6LKEUCEM.js";
 import {
   ActivityStore,
   MaintenanceScheduler
-} from "./chunk-S55OAS5P.js";
+} from "./chunk-4EABKPZS.js";
 import {
   runPeerProfileReasoner
 } from "./chunk-I74SUMNI.js";
@@ -22,7 +22,7 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import {
   LcmEngine
-} from "./chunk-GF22HWS2.js";
+} from "./chunk-Z54EM5YZ.js";
 import {
   chunkTranscriptEntries
 } from "./chunk-TECVW3JP.js";
@@ -32,7 +32,7 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-2EJNXE53.js";
+} from "./chunk-PLCHU56K.js";
 import {
   SharedContextManager
 } from "./chunk-M23RF3LJ.js";
@@ -40,16 +40,7 @@ import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
-} from "./chunk-LXOM6IQU.js";
-import {
-  extractTopics
-} from "./chunk-UHGBNIOS.js";
-import {
-  buildTemporalTimelineRecallSection
-} from "./chunk-I6WYQSX4.js";
-import {
-  CODEX_THREAD_KEY_PREFIX
-} from "./chunk-4EX5WZ4M.js";
+} from "./chunk-SEF4IOFE.js";
 import {
   TierMigrationExecutor
 } from "./chunk-YRFAYOFQ.js";
@@ -59,6 +50,15 @@ import {
 import {
   TmtBuilder
 } from "./chunk-ECZU5BJH.js";
+import {
+  extractTopics
+} from "./chunk-UHGBNIOS.js";
+import {
+  buildTemporalTimelineRecallSection
+} from "./chunk-I6WYQSX4.js";
+import {
+  CODEX_THREAD_KEY_PREFIX
+} from "./chunk-4EX5WZ4M.js";
 import {
   HourlySummarizer
 } from "./chunk-LLJMAULE.js";
@@ -69,11 +69,6 @@ import {
 import {
   SessionObserverState
 } from "./chunk-QFN4U7AG.js";
-import {
-  RerankCache,
-  reorderByRankedKeys,
-  rerankLocalOrNoop
-} from "./chunk-LUDXM7MD.js";
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
@@ -107,13 +102,18 @@ import {
 } from "./chunk-X7XN6YU4.js";
 import {
   RelevanceStore
-} from "./chunk-LULR4IUW.js";
+} from "./chunk-KATEWTQJ.js";
+import {
+  RerankCache,
+  reorderByRankedKeys,
+  rerankLocalOrNoop
+} from "./chunk-LUDXM7MD.js";
 import {
   LastRecallStore,
   RecallHandleHistoryStore,
   TierMigrationStatusStore,
   clampGraphRecallExpandedEntries
-} from "./chunk-NM2WP3B7.js";
+} from "./chunk-BJYET5TX.js";
 import {
   dedupeResultsByNamespace,
   hasMemoryForResult,
@@ -144,25 +144,32 @@ import {
 import {
   runLiveConnectorsOnce
 } from "./chunk-HTIIXNJQ.js";
+import {
+  deriveHarmonicRecords,
+  harmonicEntityReferenceMatches,
+  harmonicEntitySegment,
+  normalizedHarmonicEntityIdentity,
+  persistHarmonicRecords
+} from "./chunk-GXSOUIA4.js";
 import {
   classifyMemoryKind
 } from "./chunk-YAZNBMNF.js";
+import {
+  buildFocusedListRecallSection,
+  shouldRecallFocusedListEvidence
+} from "./chunk-OH7QLI6W.js";
 import {
   ExtractionEngine
-} from "./chunk-LZGCJSQR.js";
+} from "./chunk-3LD4N2TF.js";
 import {
   parseMemoryActionEligibilityContext
-} from "./chunk-CMQZNEIF.js";
+} from "./chunk-WFLBP5GC.js";
 import {
   ModelRegistry
 } from "./chunk-WLZYGLJ4.js";
 import {
   LocalLlmClient
 } from "./chunk-L6CQ7WIW.js";
-import {
-  buildFocusedListRecallSection,
-  shouldRecallFocusedListEvidence
-} from "./chunk-OH7QLI6W.js";
 import {
   recordJudgeTrainingPair
 } from "./chunk-PWFCHOB3.js";
@@ -173,6 +180,11 @@ import {
   judgeFactDurability,
   validateProcedureExtraction
 } from "./chunk-K2TDK7GG.js";
+import {
+  buildEntityRecallSection,
+  entityRecentTranscriptLookbackHours,
+  readRecentEntityTranscriptEntries
+} from "./chunk-ZJIFYUJI.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
@@ -184,29 +196,24 @@ import {
 import {
   buildExplicitCueRecallSection
 } from "./chunk-TVIVY7KU.js";
+import {
+  tryDirectAnswer
+} from "./chunk-CSOYVTRX.js";
 import {
   EmbeddingFallback
 } from "./chunk-YK6BDDHP.js";
-import {
-  buildEntityRecallSection,
-  entityRecentTranscriptLookbackHours,
-  readRecentEntityTranscriptEntries
-} from "./chunk-4WBGZYZZ.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-RPSYDM6C.js";
-import {
-  tryDirectAnswer
-} from "./chunk-CSOYVTRX.js";
 import {
   refreshConvergedNamespaces
-} from "./chunk-3JUYWPFJ.js";
+} from "./chunk-VFS3MK5F.js";
 import {
   builtInConnectorPackageSpecifier,
   ensureBuiltInWearableConnectors,
   getWearableConnector,
   listWearableConnectors
-} from "./chunk-KSGEGHYA.js";
+} from "./chunk-T35UJI5R.js";
 import {
   RoutingRulesStore
 } from "./chunk-XL24QQ63.js";
@@ -216,17 +223,17 @@ import {
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-GD7UPIBG.js";
+} from "./chunk-4JWJMRPJ.js";
 import {
   ThreadingManager
 } from "./chunk-OJP3N7UK.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-5L7PTX2Q.js";
+} from "./chunk-S2SJEOTM.js";
 import {
   searchWorkProductLedgerEntries
-} from "./chunk-ZRWB5D4H.js";
+} from "./chunk-WT6UL3UA.js";
 import {
   TranscriptManager
 } from "./chunk-HYQJQGD3.js";
@@ -236,25 +243,28 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-HIDEBEAN.js";
+} from "./chunk-E633OXMH.js";
 import {
   NamespaceCatalog,
   planNamespaceMaintenance
-} from "./chunk-D5NGH2EW.js";
+} from "./chunk-O76MWTVS.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
 } from "./chunk-JXS5PDQ7.js";
 import {
   searchHarmonicRetrieval
-} from "./chunk-KVJRXN2E.js";
+} from "./chunk-P4QOYG52.js";
 import {
   EXTRACTION_JUDGE_VERDICT_CATEGORY,
   recordJudgeVerdict
 } from "./chunk-OZKOPQCM.js";
 import {
   recordEvalShadowRecall
-} from "./chunk-3PY7VHV7.js";
+} from "./chunk-MCA2X4WH.js";
+import {
+  pruneOrphanCueAnchors
+} from "./chunk-ACPCA4NO.js";
 import {
   collectNativeKnowledgeChunks,
   formatNativeKnowledgeSection,
@@ -262,7 +272,7 @@ import {
 } from "./chunk-2DQ2XREU.js";
 import {
   applyCommitmentLedgerLifecycle
-} from "./chunk-LMDRGRJ2.js";
+} from "./chunk-NOB2T2FC.js";
 import {
   buildConsolidationPrompt,
   buildExtensionsBlockForConsolidation,
@@ -272,7 +282,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-GWHPQOUC.js";
+} from "./chunk-GGBSF2X7.js";
 import {
   BoxBuilder
 } from "./chunk-B7RWBZXW.js";
@@ -284,10 +294,10 @@ import {
 } from "./chunk-UQ7RN5HK.js";
 import {
   SmartBuffer
-} from "./chunk-2RPJ4NEE.js";
+} from "./chunk-64BHFFKZ.js";
 import {
   detectMeetings
-} from "./chunk-RN53QBM4.js";
+} from "./chunk-A4QMKFFO.js";
 import {
   compileCorrectionRule,
   correctionsFilePath,
@@ -318,7 +328,7 @@ import {
 } from "./chunk-H3FZVNRN.js";
 import {
   MeetingsInputError
-} from "./chunk-FMCHFSZF.js";
+} from "./chunk-LQKXVQZR.js";
 import {
   WearablesInputError,
   describeErrorForOperator
@@ -339,10 +349,10 @@ import {
   filterRecallCandidates,
   isGenericRecallExcludedPath,
   isTopLevelArchivePath
-} from "./chunk-45OTV7FZ.js";
+} from "./chunk-PWIMF7LP.js";
 import {
   importCapsule
-} from "./chunk-A4JMGKCD.js";
+} from "./chunk-5XCN4XBU.js";
 import {
   isCodingGraphInstalled
 } from "./chunk-VQ7B2Q6M.js";
@@ -356,7 +366,10 @@ import {
 import {
   listTrustZoneRecords,
   searchTrustZoneRecords
-} from "./chunk-JGSKJHF7.js";
+} from "./chunk-KQS72GCR.js";
+import {
+  buildXraySnapshot
+} from "./chunk-NSGU76YO.js";
 import {
   boundRecallContextComposition,
   composeRecallContext,
@@ -364,41 +377,38 @@ import {
   formatCuriosityFooter,
   selectCuriosityQuestion
 } from "./chunk-AHVEHR6K.js";
-import {
-  buildXraySnapshot
-} from "./chunk-P2OTGMTR.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
-} from "./chunk-6HMYUWXR.js";
+} from "./chunk-HTP6XRUI.js";
+import {
+  contentMatchesRedactionRules,
+  loadRedactionRules
+} from "./chunk-LTHVM4XN.js";
 import {
   ProfilingCollector
 } from "./chunk-NLE6TSLG.js";
 import {
   buildProcedurePersistBody
 } from "./chunk-QDW3E4RD.js";
-import {
-  contentMatchesRedactionRules,
-  loadRedactionRules
-} from "./chunk-LTHVM4XN.js";
 import {
   shouldSkipImplicitExtraction
-} from "./chunk-S5NZBKKQ.js";
+} from "./chunk-N3CXAYPJ.js";
 import {
   NamespaceSearchRouter,
   namespaceCollectionName
-} from "./chunk-PRVJH7CY.js";
+} from "./chunk-KMWYZTIE.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend,
   isSearchBackendEnabled
-} from "./chunk-FJ2ND6CZ.js";
+} from "./chunk-47J4EDGR.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-ANCC3JJH.js";
+} from "./chunk-JI62YGPI.js";
 import {
   writeConversationChunks
 } from "./chunk-72A4L5JJ.js";
@@ -407,10 +417,10 @@ import {
 } from "./chunk-L2DPF4DF.js";
 import {
   searchCausalTrajectories
-} from "./chunk-W4FBGYGK.js";
+} from "./chunk-M4MP34AQ.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-3NDN5P55.js";
+} from "./chunk-4S3ECH3U.js";
 import {
   QmdResultResolver,
   StorageManager,
@@ -429,7 +439,10 @@ import {
   reconstructFusionInputs,
   selfDeps,
   serializeFusionDay
-} from "./chunk-PLCZD3LG.js";
+} from "./chunk-24BKGKGO.js";
+import {
+  buildRetiredFactTombstoneInputs
+} from "./chunk-ENTCVTQR.js";
 import {
   bodyIsEscaped,
   decodeTranscriptBody,
@@ -440,9 +453,6 @@ import {
   saveSpeakerRegistry,
   speakerRegistryKey
 } from "./chunk-UHVXE24Y.js";
-import {
-  buildRetiredFactTombstoneInputs
-} from "./chunk-ENTCVTQR.js";
 import {
   canRecallToolScopedMemory,
   shouldPromoteGlobalFactToShared,
@@ -455,7 +465,7 @@ import {
 } from "./chunk-J6A3CX5N.js";
 import {
   confidenceTier
-} from "./chunk-3S63QIFQ.js";
+} from "./chunk-LAQ33B5D.js";
 import {
   lintWorkspaceFiles,
   rotateMarkdownFileToArchive
@@ -469,17 +479,20 @@ import {
   TAG_LIMITS,
   composeMemoryEnvelope,
   isMemoryCategory
-} from "./chunk-CGASUJVP.js";
+} from "./chunk-5V6IXHPI.js";
+import {
+  normalizeTags
+} from "./chunk-BT7NVCML.js";
 import {
   normalizeAttributePairs,
   stripAttributesSuffix
 } from "./chunk-R3DJVOSM.js";
 import {
-  normalizeTags
-} from "./chunk-BT7NVCML.js";
+  checkCorpusReadAbort
+} from "./chunk-5GINB5LC.js";
 import {
   bumpMemoryCorpusVersionForDir
-} from "./chunk-IJ7HK452.js";
+} from "./chunk-KMAP7SNQ.js";
 import {
   HistoricalEntityCanonicalIdCache,
   canonicalizeEntityRefFrontmatter,
@@ -490,13 +503,14 @@ import {
   requestEntityCanonicalIdReconcile,
   requestEntityCanonicalIdReconcileSync,
   withRawEntityPageMutation
-} from "./chunk-NZBZ7IS2.js";
+} from "./chunk-JDCQK3C5.js";
 import {
   applyTemporalSupersession,
   normalizeSupersessionKey,
+  propagateInvalidation,
   shouldFilterSupersededFromRecall,
   supersessionKeysForFact
-} from "./chunk-DNHVPZOD.js";
+} from "./chunk-P26YHAQH.js";
 import {
   isValidAsOf,
   isValidityExpiredNow
@@ -540,7 +554,7 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-WQIHRA5F.js";
+} from "./chunk-N3LL5NEU.js";
 import {
   inferIntentFromText,
   intentCompatibilityScore,
@@ -2790,12 +2804,39 @@ var ContradictionLinkingCoordinator = class {
     if (!contradiction || !config.contradictionAutoResolve || postWriteGuard) {
       return;
     }
+    let oldMemory = null;
     try {
-      await storage.supersedeMemory(
+      oldMemory = await storage.getMemoryById(contradiction.supersededId);
+    } catch (err) {
+      log.warn(`contradiction propagation snapshot failed for ${contradiction.supersededId}: ${err}`);
+    }
+    try {
+      const superseded = await storage.supersedeMemory(
         contradiction.supersededId,
         newMemoryId,
         contradiction.reason
       );
+      if (!superseded) return;
+      if (oldMemory) {
+        try {
+          await propagateInvalidation(
+            {
+              storage,
+              extraction: this.getExtraction(),
+              config
+            },
+            {
+              oldMemory,
+              replacementId: newMemoryId,
+              replacementContent: (await storage.getMemoryById(newMemoryId))?.content ?? null,
+              cause: "contradiction",
+              namespaceScope: this.namespaceFromPath(storage.dir)
+            }
+          );
+        } catch (err) {
+          log.warn(`contradiction dependency propagation failed for ${contradiction.supersededId}: ${err}`);
+        }
+      }
       if (resolveIndexingCapabilities(config).queryAwareIndexing && contradiction.supersededPath) {
         await deindexMemoryAsync(
           config.memoryDir,
@@ -2860,11 +2901,107 @@ var ContradictionLinkingCoordinator = class {
 // src/orchestration/consolidation-run.ts
 import path4 from "path";
 import { mkdir as mkdir2, readFile, writeFile as writeFile2 } from "fs/promises";
+var MAX_HARMONIC_NAMESPACE_STORES = 50;
+var HARMONIC_CATALOG_CURSOR_FILE = "harmonic-catalog-cursor.json";
 var ConsolidationRunCoordinator = class {
   constructor(deps) {
     this.deps = deps;
   }
   deps;
+  async readHarmonicCatalogCursor(defaultDir) {
+    const cursorPath = path4.join(defaultDir, "state", HARMONIC_CATALOG_CURSOR_FILE);
+    try {
+      const raw = await readFile(cursorPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      return typeof parsed.nextStorageDir === "string" && parsed.nextStorageDir.length > 0 ? path4.resolve(parsed.nextStorageDir) : void 0;
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        log.warn(
+          `harmonic namespace catalog cursor read failed open: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+      return void 0;
+    }
+  }
+  async writeHarmonicCatalogCursor(defaultDir, nextStorageDir) {
+    const stateDir = path4.join(defaultDir, "state");
+    await mkdir2(stateDir, { recursive: true });
+    await writeFile2(
+      path4.join(stateDir, HARMONIC_CATALOG_CURSOR_FILE),
+      JSON.stringify({ nextStorageDir }, null, 2),
+      "utf-8"
+    );
+  }
+  async pruneHarmonicStores(storage) {
+    const config = this.deps.config;
+    if (!resolveCapabilities(config).harmonicRetrieval || !resolveConsolidationCapabilities(config).abstractionAnchors) {
+      return;
+    }
+    const stores = /* @__PURE__ */ new Map();
+    const defaultDir = path4.resolve(storage.dir);
+    stores.set(defaultDir, {
+      memoryDir: storage.dir,
+      abstractionNodeStoreDir: config.abstractionNodeStoreDir
+    });
+    try {
+      const catalog = this.deps.getNamespaceCatalog?.();
+      if (catalog?.enabled) {
+        const records = await catalog.listNamespaces({ discoveredBy: "write" });
+        const catalogStores = /* @__PURE__ */ new Map();
+        for (const record of records) {
+          const storageDir = path4.resolve(record.storageDir);
+          if (!stores.has(storageDir) && !catalogStores.has(storageDir)) {
+            catalogStores.set(storageDir, { memoryDir: record.storageDir });
+          }
+        }
+        const candidates = [...catalogStores.entries()];
+        if (candidates.length > 0) {
+          const cursor = await this.readHarmonicCatalogCursor(defaultDir);
+          const cursorIndex = cursor ? candidates.findIndex(([storageDir]) => storageDir === cursor) : -1;
+          const startIndex = cursorIndex >= 0 ? cursorIndex : 0;
+          const selectedCount = Math.min(
+            candidates.length,
+            MAX_HARMONIC_NAMESPACE_STORES - 1
+          );
+          for (let offset = 0; offset < selectedCount; offset += 1) {
+            const index = (startIndex + offset) % candidates.length;
+            const [storageDir, store] = candidates[index];
+            stores.set(storageDir, store);
+          }
+          const nextIndex = (startIndex + selectedCount) % candidates.length;
+          const nextStorageDir = candidates[nextIndex][0];
+          try {
+            await this.writeHarmonicCatalogCursor(defaultDir, nextStorageDir);
+          } catch (error) {
+            log.warn(
+              `harmonic namespace catalog cursor write failed open: ${error instanceof Error ? error.message : String(error)}`
+            );
+          }
+          if (selectedCount < candidates.length) {
+            log.warn(
+              `harmonic namespace catalog truncated at ${MAX_HARMONIC_NAMESPACE_STORES} stores; skipped ${candidates.length - selectedCount} store(s)`
+            );
+          }
+        }
+      }
+    } catch (error) {
+      log.warn(
+        `harmonic namespace catalog read failed open: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+    for (const store of stores.values()) {
+      try {
+        const removed = await pruneOrphanCueAnchors(store);
+        if (removed > 0) {
+          log.info(`harmonic anchor prune removed ${removed} orphan(s) from ${store.memoryDir}`);
+        }
+      } catch (error) {
+        log.warn(
+          `harmonic anchor prune failed open for ${store.memoryDir}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   async run() {
     const config = this.deps.config;
     const storage = this.deps.getStorage();
@@ -2876,6 +3013,7 @@ var ConsolidationRunCoordinator = class {
     if (this.deps.getAccessTrackingBuffer().size > 0) {
       await this.deps.flushAccessTracking();
     }
+    await this.pruneHarmonicStores(storage);
     let allMemories = await storage.readAllMemories();
     if (allMemories.length < 5) {
       return { memoriesProcessed: allMemories.length, merged, invalidated };
@@ -2895,10 +3033,35 @@ var ConsolidationRunCoordinator = class {
         switch (item.action) {
           case "INVALIDATE": {
             const toInvalidate = resolveIndexingCapabilities(config).queryAwareIndexing ? memoryLookup?.get(item.existingId) ?? null : null;
+            const propagationOld = allMemories.find(
+              (memory) => memory.frontmatter.id === item.existingId
+            );
             if (await storage.invalidateMemory(item.existingId)) {
               invalidated += 1;
               memoryItemMutated = true;
               await this.deps.embeddingFallback.removeFromIndex(item.existingId);
+              if (propagationOld) {
+                try {
+                  await propagateInvalidation(
+                    {
+                      storage,
+                      extraction: this.deps.getExtraction(),
+                      config
+                    },
+                    {
+                      oldMemory: propagationOld,
+                      replacementId: null,
+                      replacementContent: null,
+                      cause: "consolidation_invalidate",
+                      namespaceScope: config.defaultNamespace
+                    }
+                  );
+                } catch (propagationErr) {
+                  log.warn(
+                    `consolidation dependency propagation failed for ${item.existingId}: ${propagationErr}`
+                  );
+                }
+              }
               if (toInvalidate?.path && toInvalidate.frontmatter?.created) {
                 itemsDeindexBatch.push({
                   path: toInvalidate.path,
@@ -2935,10 +3098,35 @@ var ConsolidationRunCoordinator = class {
               memoryItemMutated = true;
               await this.deps.indexPersistedMemory(storage, item.existingId);
               const toMergeInvalidate = resolveIndexingCapabilities(config).queryAwareIndexing ? memoryLookup?.get(item.mergeWith) ?? null : null;
+              const propagationOld = allMemories.find(
+                (memory) => memory.frontmatter.id === item.mergeWith
+              );
               if (await storage.invalidateMemory(item.mergeWith)) {
                 invalidated += 1;
                 merged += 1;
                 await this.deps.embeddingFallback.removeFromIndex(item.mergeWith);
+                if (propagationOld) {
+                  try {
+                    await propagateInvalidation(
+                      {
+                        storage,
+                        extraction: this.deps.getExtraction(),
+                        config
+                      },
+                      {
+                        oldMemory: propagationOld,
+                        replacementId: item.existingId,
+                        replacementContent: item.updatedContent,
+                        cause: "consolidation_merge",
+                        namespaceScope: config.defaultNamespace
+                      }
+                    );
+                  } catch (propagationErr) {
+                    log.warn(
+                      `consolidation dependency propagation failed for ${item.mergeWith}: ${propagationErr}`
+                    );
+                  }
+                }
                 if (toMergeInvalidate?.path && toMergeInvalidate.frontmatter?.created) {
                   itemsDeindexBatch.push({
                     path: toMergeInvalidate.path,
@@ -3449,6 +3637,59 @@ async function flushDeferredFactHashOnFailure(saveContentHashIndexes, deferred)
   );
 }
 
+// src/orchestration/harmonic-construction-persist.ts
+function filterHarmonicEntityMentions(facts, entityMentions) {
+  const identitiesBySegment = /* @__PURE__ */ new Map();
+  for (const entity of entityMentions) {
+    const segment = harmonicEntitySegment(entity.name);
+    const identities = identitiesBySegment.get(segment) ?? /* @__PURE__ */ new Set();
+    identities.add(normalizedHarmonicEntityIdentity(entity.name));
+    identitiesBySegment.set(segment, identities);
+  }
+  return entityMentions.flatMap((entity) => {
+    const allowSegmentFallback = identitiesBySegment.get(harmonicEntitySegment(entity.name))?.size === 1;
+    const activeFacts = facts.filter(
+      (fact) => typeof fact.entityRef === "string" && harmonicEntityReferenceMatches(fact.entityRef, entity.name, allowSegmentFallback)
+    );
+    return activeFacts.length > 0 ? [{ ...entity, facts: activeFacts.map((fact) => fact.content) }] : [];
+  });
+}
+async function persistConstructedHarmonicRecords(options) {
+  const sessionKey = options.sessionKey?.trim();
+  if (!sessionKey) {
+    log.warn("harmonic construction skipped: extraction session key is missing");
+    return;
+  }
+  const recordedAt = options.validAt && Number.isFinite(Date.parse(options.validAt)) ? new Date(options.validAt).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+  const entries = [...options.entries];
+  const sharedEpisodeTitle = entries.length === 1 ? options.episodeTitle : void 0;
+  for (const entry of entries) {
+    try {
+      const records = deriveHarmonicRecords({
+        sessionKey,
+        recordedAt,
+        episodeTitle: sharedEpisodeTitle,
+        persistedFacts: entry.facts,
+        entityMentions: filterHarmonicEntityMentions(entry.facts, options.entityMentions).map((entity) => ({
+          name: entity.name,
+          type: entity.type,
+          facts: entity.facts
+        }))
+      });
+      await persistHarmonicRecords({
+        memoryDir: entry.storage.dir,
+        abstractionNodeStoreDir: entry.storage.dir === options.baseStorageDir ? options.abstractionNodeStoreDir : void 0,
+        nodes: records.nodes,
+        anchors: options.anchorsEnabled ? records.anchors : []
+      });
+    } catch (error) {
+      log.warn(
+        `harmonic construction failed open for namespace ${entry.storage.dir}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+}
+
 // src/orchestration/extraction-persist.ts
 var ExtractionPersistCoordinator = class {
   constructor(deps) {
@@ -3462,6 +3703,12 @@ var ExtractionPersistCoordinator = class {
     const citationEnabled = resolvePipelineProcessingCapabilities(this.deps.config).inlineSourceAttribution === true;
     const citationTemplate = this.deps.config.inlineSourceAttributionFormat;
     const factDedupEnabled = resolveRecallAuxiliaryCapabilities(this.deps.config).factDeduplication;
+    const harmonicConstructionEnabled = resolveCapabilities(this.deps.config).harmonicRetrieval;
+    const harmonicAnchorsEnabled = resolveConsolidationCapabilities(this.deps.config).abstractionAnchors;
+    const harmonicBaseNamespace = baseNamespace ?? this.deps.storageDirNamespace(storage.dir);
+    const harmonicFactsByStorage = /* @__PURE__ */ new Map();
+    const harmonicSourceInsertedAtBase = Date.now();
+    let harmonicSourceOrder = 0;
     const normalizeStoredHashSource = (raw) => ContentHashIndex.normalizeContent(
       sanitizeMemoryContent(
         citationEnabled && hasCitationForTemplate(raw, citationTemplate) ? stripCitationForTemplate(raw, citationTemplate) : raw
@@ -3499,6 +3746,19 @@ var ExtractionPersistCoordinator = class {
       } else {
         persistedIdsByStorage.set(key, { storage: targetStorage, ids: [id] });
       }
+      if (harmonicConstructionEnabled && options.harmonicFact && !options.pendingReview) {
+        const harmonicEntry = harmonicFactsByStorage.get(key) ?? {
+          storage: targetStorage,
+          facts: []
+        };
+        harmonicEntry.facts.push({
+          ...options.harmonicFact,
+          memoryId: id,
+          insertedAt: new Date(harmonicSourceInsertedAtBase + harmonicSourceOrder).toISOString()
+        });
+        harmonicSourceOrder++;
+        harmonicFactsByStorage.set(key, harmonicEntry);
+      }
       if (options.category && !memoryPathById.has(id)) {
         const relPath = resolvePersistedMemoryRelativePath({ memoryId: id, pathById: memoryPathById, category: options.category });
         memoryPathById.set(id, relPath);
@@ -3643,7 +3903,10 @@ var ExtractionPersistCoordinator = class {
                 entityRef: targetPromotionEnvelope.entityRef,
                 structuredAttributes: { ...targetSurvivingAttrs },
                 createdAt: supersessionOrderingAt(options.validAt),
-                enabled: !(options.eventTimeSource === "extracted" && !options.validAt)
+                enabled: !(options.eventTimeSource === "extracted" && !options.validAt),
+                extraction: this.deps.getExtraction(),
+                config: this.config,
+                namespaceScope: this.deps.storageDirNamespace(targetStorage.dir)
               });
             } catch (profileSupersessionErr) {
               log.warn(
@@ -3652,7 +3915,11 @@ var ExtractionPersistCoordinator = class {
             }
           }
           if (!targetPromotion.tombstoneBlocked) {
-            trackPersistedId(targetStorage, promotedId, { includeReturnedIds: false, category: options.category });
+            trackPersistedId(targetStorage, promotedId, {
+              includeReturnedIds: false,
+              category: options.category,
+              harmonicFact: options.harmonicFact
+            });
             await this.deps.indexPersistedMemory(targetStorage, promotedId);
             trackBehaviorSignals(
               targetStorage,
@@ -3780,7 +4047,10 @@ var ExtractionPersistCoordinator = class {
                   structuredAttributes: { ...sharedSurvivingAttrs },
                   createdAt: supersessionOrderingAt(options.validAt),
                   enabled: !(options.eventTimeSource === "extracted" && !options.validAt),
-                  useCallerTimestamp: true
+                  useCallerTimestamp: true,
+                  extraction: this.deps.getExtraction(),
+                  config: this.config,
+                  namespaceScope: this.deps.storageDirNamespace(sharedStorage.dir)
                 });
                 if (hashDedupSupersession.supersededIds.length > 0) {
                 }
@@ -3850,7 +4120,10 @@ var ExtractionPersistCoordinator = class {
               entityRef: sharedPromotionEnvelope.entityRef,
               structuredAttributes: { ...sharedSurvivingAttrs },
               createdAt: supersessionOrderingAt(options.validAt),
-              enabled: !(options.eventTimeSource === "extracted" && !options.validAt)
+              enabled: !(options.eventTimeSource === "extracted" && !options.validAt),
+              extraction: this.deps.getExtraction(),
+              config: this.config,
+              namespaceScope: this.deps.storageDirNamespace(sharedStorage.dir)
             });
           } catch (sharedSupersessionErr) {
             log.warn(
@@ -3861,7 +4134,8 @@ var ExtractionPersistCoordinator = class {
         if (!sharedPromotion.tombstoneBlocked) {
           trackPersistedId(sharedStorage, promotedId, {
             includeReturnedIds: false,
-            category: options.category
+            category: options.category,
+            harmonicFact: options.harmonicFact
           });
           await this.deps.indexPersistedMemory(sharedStorage, promotedId);
           trackBehaviorSignals(
@@ -4262,6 +4536,14 @@ var ExtractionPersistCoordinator = class {
           );
         }
       }
+      const harmonicFact = {
+        category: writeCategory,
+        content: fact.content,
+        tags: fact.tags,
+        cueAnchors: fact.cueAnchors,
+        entityRef: fact.entityRef,
+        validAt: biTemporal?.validFrom ?? sourceContext?.validAt
+      };
       try {
         const redactionRules = await redactionRulesFor(sourceStorageDir, targetStorage.dir);
         const redactionCandidate = fact.content + (fact.structuredAttributes ? " " + JSON.stringify(fact.structuredAttributes) : "") + (fact.procedureSteps ? " " + fact.procedureSteps.map((s) => `${s.intent} ${s.expectedOutcome ?? ""} ${s.toolCall ? `${s.toolCall.kind} ${s.toolCall.signature}` : ""}`.trim()).join(" ") : "");
@@ -4637,7 +4919,8 @@ var ExtractionPersistCoordinator = class {
           );
           trackPersistedId(targetStorage, parentId, {
             pendingReview: postWriteGuard2,
-            category: writeCategory
+            category: writeCategory,
+            harmonicFact
           });
           if (!postWriteGuard2 && threadEpisodeIdsForGraph && !threadEpisodeIdsForGraph.includes(parentId)) {
             threadEpisodeIdsForGraph.push(parentId);
@@ -4656,7 +4939,10 @@ var ExtractionPersistCoordinator = class {
                 // #1578 r3: an extracted end-only bound (validFrom absent) is
                 // historical, not a new authoritative state — never let it
                 // supersede a later active fact (codex P1 on :15534).
-                enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom)
+                enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom),
+                extraction: this.deps.getExtraction(),
+                config: this.config,
+                namespaceScope: this.deps.storageDirNamespace(targetStorage.dir)
               });
             } catch (err) {
               log.warn(`temporal-supersession (chunked): unexpected error: ${err}`);
@@ -4686,7 +4972,8 @@ var ExtractionPersistCoordinator = class {
             ...extractionSourceConnector ? { sourceConnector: extractionSourceConnector } : {},
             ...fact.procedureSteps && fact.procedureSteps.length ? { procedureSteps: fact.procedureSteps } : {},
             ...fact.sources && fact.sources.length > 0 ? { sources: fact.sources } : {},
-            ...fact.provenance ? { provenance: fact.provenance } : {}
+            ...fact.provenance ? { provenance: fact.provenance } : {},
+            harmonicFact
           });
           try {
             const canonicalChunkedContent = citationEnabled && hasCitationForTemplate(fact.content, citationTemplate) ? stripCitationForTemplate(fact.content, citationTemplate) : fact.content;
@@ -4842,7 +5129,10 @@ var ExtractionPersistCoordinator = class {
             entityRef: factWriteEnvelope.entityRef,
             structuredAttributes: factWriteEnvelope.rawStructuredAttributes ? { ...factWriteEnvelope.rawStructuredAttributes } : void 0,
             createdAt: supersessionOrderingAt(biTemporal?.validFrom ?? sourceContext?.validAt),
-            enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom)
+            enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom),
+            extraction: this.deps.getExtraction(),
+            config: this.config,
+            namespaceScope: this.deps.storageDirNamespace(targetStorage.dir)
           });
         } catch (err) {
           log.warn(`temporal-supersession: unexpected error: ${err}`);
@@ -4862,7 +5152,8 @@ var ExtractionPersistCoordinator = class {
         );
         trackPersistedId(targetStorage, memoryId, {
           pendingReview: postWriteGuard,
-          category: writeCategory
+          category: writeCategory,
+          harmonicFact
         });
         if (!postWriteGuard && threadEpisodeIdsForGraph && !threadEpisodeIdsForGraph.includes(memoryId)) {
           threadEpisodeIdsForGraph.push(memoryId);
@@ -4894,7 +5185,8 @@ var ExtractionPersistCoordinator = class {
           ...extractionSourceConnector ? { sourceConnector: extractionSourceConnector } : {},
           ...fact.procedureSteps && fact.procedureSteps.length ? { procedureSteps: fact.procedureSteps } : {},
           ...fact.sources && fact.sources.length > 0 ? { sources: fact.sources } : {},
-          ...fact.provenance ? { provenance: fact.provenance } : {}
+          ...fact.provenance ? { provenance: fact.provenance } : {},
+          harmonicFact
         });
         if (graphCaps.multiGraphMemory && !postWriteGuard) {
           try {
@@ -5075,6 +5367,18 @@ var ExtractionPersistCoordinator = class {
     log.info(
       `persisted: ${facts.length - dedupedCount - importanceGatedCount - judgeGatedCount - redactionGatedCount} facts${dedupSuffix}${gatedSuffix}${judgeSuffix}${redactionSuffix}, ${entities.length} entities, ${questions.length} questions, ${profileUpdates.length} profile updates`
     );
+    if (harmonicConstructionEnabled && harmonicFactsByStorage.size > 0) {
+      await persistConstructedHarmonicRecords({
+        entries: harmonicFactsByStorage.values(),
+        baseStorageDir: storage.dir,
+        abstractionNodeStoreDir: !scopeProfileWritePlan && harmonicBaseNamespace === this.deps.config.defaultNamespace ? this.deps.config.abstractionNodeStoreDir : void 0,
+        sessionKey: sourceContext?.sessionKey,
+        validAt: sourceContext?.validAt,
+        episodeTitle: result.episodeTitle,
+        anchorsEnabled: harmonicAnchorsEnabled,
+        entityMentions: entities
+      });
+    }
     void (async () => {
       if (persistedIdsByStorage.size === 0) {
         await this.deps.updateTemporalTagIndexes(storage, []);
@@ -6654,6 +6958,7 @@ ${rows.join("\n")}
                 maxResults,
                 sessionKey,
                 anchorsEnabled: resolveConsolidationCapabilities(this.deps.config).abstractionAnchors,
+                temporalExpiredInInjection: this.deps.config.temporalExpiredInInjection,
                 abortSignal: harmonicRetrievalAbort.signal
               })
             )
@@ -8852,7 +9157,9 @@ ${tmtNode.summary}`
           } else {
             const memories = await awaitAssemblyStep(
               "recent-memory-read",
-              () => this.deps.readAllMemoriesForNamespaces(recallNamespaces),
+              (stepSignal) => this.deps.readAllMemoriesForNamespaces(recallNamespaces, {
+                abortSignal: stepSignal
+              }),
               []
             );
             if (memories.length > 0) {
@@ -9601,7 +9908,9 @@ async function fetchActiveArtifactsForNamespace(deps, namespace, prompt, targetC
       )
     );
     throwIfRecallAborted(options.abortSignal);
-    const sourceStatus = sourceIds.length > 0 ? await deps.resolveArtifactSourceStatuses(storage, sourceIds) : /* @__PURE__ */ new Map();
+    const sourceStatus = sourceIds.length > 0 ? await deps.resolveArtifactSourceStatuses(storage, sourceIds, {
+      abortSignal: options.abortSignal
+    }) : /* @__PURE__ */ new Map();
     const filtered = [];
     for (const artifact of rawResults) {
       const sourceId = artifact.frontmatter.sourceMemoryId;
@@ -12207,7 +12516,7 @@ var OrchestratorInitCoordinator = class {
     if (signal.aborted) return;
     if (lifecycleCaps.lifecyclePolicy && resolveQmdCapabilities(this.deps.config).qmdTierMigration) {
       try {
-        const { runFirstStartMigration } = await import("./first-start-migration-ZSHEFEI3.js");
+        const { runFirstStartMigration } = await import("./first-start-migration-626C5554.js");
         const result = await runFirstStartMigration({
           storage: this.deps.storage,
           config: this.deps.config,
@@ -12230,7 +12539,7 @@ var OrchestratorInitCoordinator = class {
     if (signal.aborted) return;
     if (!this.deps.wearablesAutoSyncHandle && this.deps.config.wearables.enabled && this.deps.config.wearables.autoSyncEnabled && Object.values(this.deps.config.wearables.sources).some((source) => source.enabled)) {
       try {
-        const { startWearablesAutoSync } = await import("./auto-sync-7O6RP2RT.js");
+        const { startWearablesAutoSync } = await import("./auto-sync-QFQGOEO2.js");
         if (signal.aborted) return;
         this.deps.wearablesAutoSyncHandle = startWearablesAutoSync(
           {
@@ -15468,7 +15777,8 @@ var NamespaceReadFanoutCoordinator = class {
       execution: options.execution
     });
   }
-  async resolveArtifactSourceStatuses(storage, sourceIds) {
+  async resolveArtifactSourceStatuses(storage, sourceIds, options) {
+    checkCorpusReadAbort(options);
     const currentStatusVersion = storage.getMemoryStatusVersion();
     const cached = this.deps.artifactSourceStatusCache.get(storage);
     let snapshot = cached;
@@ -15478,8 +15788,10 @@ var NamespaceReadFanoutCoordinator = class {
       let latestStatuses = /* @__PURE__ */ new Map();
       let latestVersionAfter = storage.getMemoryStatusVersion();
       for (let attempt = 0; attempt < MAX_STABLE_READ_ATTEMPTS; attempt += 1) {
+        checkCorpusReadAbort(options);
         const versionBefore = storage.getMemoryStatusVersion();
-        const allMemories = await storage.readAllMemories();
+        const allMemories = await storage.readAllMemories(options);
+        checkCorpusReadAbort(options);
         const versionAfter = storage.getMemoryStatusVersion();
         latestVersionAfter = versionAfter;
         latestStatuses = new Map(
@@ -15620,12 +15932,12 @@ var NamespaceReadFanoutCoordinator = class {
       loadHints: () => this.deps.loadNamespaceStorageDirHintsFromCatalog()
     });
   }
-  async readAllMemoriesForNamespaces(namespaces) {
+  async readAllMemoriesForNamespaces(namespaces, options) {
     const uniq = Array.from(new Set(namespaces.filter(Boolean)));
     const lists = await Promise.all(
       uniq.map(async (ns) => {
         const sm = await this.deps.storageRouter.storageFor(ns);
-        return sm.readAllMemories();
+        return sm.readAllMemories(options);
       })
     );
     return lists.flat();
@@ -16095,6 +16407,7 @@ var Orchestrator = class {
         config: this.config,
         getStorage: () => this.storage,
         getStorageRouter: () => this.storageRouter,
+        getNamespaceCatalog: () => this.namespaceCatalog,
         getExtraction: () => this.extraction,
         embeddingFallback: this.embeddingFallback,
         tmtBuilder: this.tmtBuilder,
@@ -16127,6 +16440,7 @@ var Orchestrator = class {
         getStorageRouter: () => this.storageRouter,
         getThreading: () => this.threading,
         getLocalLlm: () => this.localLlm,
+        getExtraction: () => this.extraction,
         getQmd: () => this.qmd,
         getJudgeVerdictCache: () => this.judgeVerdictCache,
         getJudgeDeferCounts: () => this.judgeDeferCounts,
@@ -16901,10 +17215,11 @@ var Orchestrator = class {
       return [];
     }
   }
-  async resolveArtifactSourceStatuses(storage, sourceIds) {
+  async resolveArtifactSourceStatuses(storage, sourceIds, options) {
     return this.namespaceReadFanoutCoordinator.resolveArtifactSourceStatuses(
       storage,
-      sourceIds
+      sourceIds,
+      options
     );
   }
   /**
@@ -18133,10 +18448,8 @@ ${doc.content}` : doc.content,
    * and inline-note writes were missing from `writtenSince`/maintenance).
    */
   // markCatalogRead removed — use storageRouter.recordRead() instead (#1522).
-  async readAllMemoriesForNamespaces(namespaces) {
-    return this.namespaceReadFanoutCoordinator.readAllMemoriesForNamespaces(
-      namespaces
-    );
+  async readAllMemoriesForNamespaces(namespaces, options) {
+    return this.namespaceReadFanoutCoordinator.readAllMemoriesForNamespaces(namespaces, options);
   }
 };
 
@@ -24138,4 +24451,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-2P3GQVM2.js.map
+//# sourceMappingURL=chunk-RBPH3GZV.js.map