@remnic/core 9.69.50 → 9.69.52

package/dist/{chunk-IST6MBYC.js → chunk-MSTKJI5T.js}

@@ -6,14 +6,14 @@ import {
   loadSyncState,
   syncWearableSource,
   wearableSourceLabel
-} from "./chunk-YSBYNCCN.js";
+} from "./chunk-YLPCEUXP.js";
 import {
   CompressionGuidelineCoordinator
 } from "./chunk-UXREWVW4.js";
 import {
   ActivityStore,
   MaintenanceScheduler
-} from "./chunk-LR7KUQ2W.js";
+} from "./chunk-IEOBAOA6.js";
 import {
   runPeerProfileReasoner
 } from "./chunk-I74SUMNI.js";
@@ -22,7 +22,7 @@ import {
 } from "./chunk-VZAKYDMJ.js";
 import {
   LcmEngine
-} from "./chunk-A7GQBJP5.js";
+} from "./chunk-LVFI5LG7.js";
 import {
   chunkTranscriptEntries
 } from "./chunk-TECVW3JP.js";
@@ -32,7 +32,7 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-3MIZ2EKQ.js";
+} from "./chunk-KQQEZTH6.js";
 import {
   SharedContextManager
 } from "./chunk-Z22M4JCY.js";
@@ -44,6 +44,9 @@ import {
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
 } from "./chunk-SWIKABKI.js";
+import {
+  TmtBuilder
+} from "./chunk-ECZU5BJH.js";
 import {
   extractTopics
 } from "./chunk-KVDUKH5E.js";
@@ -59,9 +62,6 @@ import {
 import {
   decideTierTransition
 } from "./chunk-GCBIXUPT.js";
-import {
-  TmtBuilder
-} from "./chunk-ECZU5BJH.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
@@ -111,7 +111,7 @@ import {
 import {
   indexStateViewAnnotatedResults,
   resolveRecallStateViewActive
-} from "./chunk-VBRS7Z3O.js";
+} from "./chunk-72N2P44O.js";
 import {
   applyRecallStateViews
 } from "./chunk-DBB5JPSL.js";
@@ -119,7 +119,10 @@ import {
   StateViewAnchorTracker,
   filterRecentScanMemories,
   stateViewPacketActive
-} from "./chunk-VSN2DMQK.js";
+} from "./chunk-G2DF5MI7.js";
+import {
+  reorderRecallResultsWithMmr
+} from "./chunk-YDBIWGNI.js";
 import {
   dedupeResultsByNamespace,
   hasMemoryForResult,
@@ -129,8 +132,11 @@ import {
   resultHasKey
 } from "./chunk-D3V3UMET.js";
 import {
-  reorderRecallResultsWithMmr
-} from "./chunk-YDBIWGNI.js";
+  compactRecallContextFromBuckets,
+  decideRecallContextComposition,
+  notifyContextComposition,
+  recallFailureComposition
+} from "./chunk-6VITOSPL.js";
 import {
   applyReasoningTraceBoost
 } from "./chunk-ZZTOURJI.js";
@@ -166,7 +172,7 @@ import {
 } from "./chunk-LS2FHUML.js";
 import {
   ExtractionEngine
-} from "./chunk-3RABJOGD.js";
+} from "./chunk-KH2D26LQ.js";
 import {
   parseMemoryActionEligibilityContext
 } from "./chunk-JHU4EYDV.js";
@@ -183,7 +189,7 @@ import {
   getVerdictKind,
   judgeFactDurability,
   validateProcedureExtraction
-} from "./chunk-FDDCZDBI.js";
+} from "./chunk-WN4HFL4K.js";
 import {
   buildExplicitCueRecallSection
 } from "./chunk-TVIVY7KU.js";
@@ -201,7 +207,7 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-4SDO74N2.js";
+} from "./chunk-XPFJSUOR.js";
 import {
   planEpisodeWindowsWithFallback
 } from "./chunk-T3GIETKV.js";
@@ -213,7 +219,7 @@ import {
 } from "./chunk-V2HHAAPI.js";
 import {
   refreshConvergedNamespaces
-} from "./chunk-PPNFKQ6D.js";
+} from "./chunk-Y4G6LHJW.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-LVXBC6YB.js";
@@ -225,7 +231,7 @@ import {
   runTimelinePublishCli,
   screenCandidateFact,
   summarizeVaultPublish
-} from "./chunk-IYHHCSF6.js";
+} from "./chunk-SOFATSHJ.js";
 import {
   normalizeReplaySessionKey
 } from "./chunk-AJVLDJU6.js";
@@ -235,14 +241,14 @@ import {
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-D6WX5FEF.js";
+} from "./chunk-SZ7IVZGD.js";
 import {
   ThreadingManager
 } from "./chunk-OJP3N7UK.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-BOTSR5S3.js";
+} from "./chunk-RUUJXAGT.js";
 import {
   searchWorkProductLedgerEntries
 } from "./chunk-G7NYVKD6.js";
@@ -255,10 +261,10 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-FO6IK4IF.js";
+} from "./chunk-SEQ6DWXD.js";
 import {
   planNamespaceMaintenance
-} from "./chunk-SRMBMMTK.js";
+} from "./chunk-7RKAE6Y4.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
@@ -287,7 +293,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-MVMNEU65.js";
+} from "./chunk-DI52XAKG.js";
 import {
   semanticChunkContent
 } from "./chunk-2GBFKHBZ.js";
@@ -296,7 +302,7 @@ import {
 } from "./chunk-6TBIWIAG.js";
 import {
   SmartBuffer
-} from "./chunk-JIWZVOQM.js";
+} from "./chunk-G7S37WD4.js";
 import {
   buildRecallQueryPolicy
 } from "./chunk-C6WMSXCJ.js";
@@ -323,8 +329,9 @@ import {
   decideSemanticMerge,
   detectMeetings,
   embeddingsFromCosineHits,
-  normalizeConnectorScope
-} from "./chunk-OLJYDGGP.js";
+  normalizeConnectorScope,
+  runSeedGraduationPass
+} from "./chunk-UVZBDIJX.js";
 import {
   compileCorrectionRule,
   correctionsFilePath,
@@ -336,13 +343,18 @@ import {
   resolveJournalSource,
   resolveVaultNotePath
 } from "./chunk-3KJTSCSX.js";
+import {
+  decideRecognitionTier,
+  loadRecognitionIndex,
+  runRecognitionTier
+} from "./chunk-4KQIWY4A.js";
 import {
   AMBIENT_CAPTURE_PROMPT_RULE,
   isHighImpactPersonalFact
 } from "./chunk-QW27DOHG.js";
 import {
   MeetingsInputError
-} from "./chunk-56C7OO3N.js";
+} from "./chunk-6KCQNFDQ.js";
 import {
   WearablesInputError,
   describeErrorForOperator
@@ -360,20 +372,24 @@ import {
 } from "./chunk-DGS34QSY.js";
 import {
   NamespaceCatalog
-} from "./chunk-JTPAXDSX.js";
+} from "./chunk-U2SK45U3.js";
 import {
   RecallResultFormatter,
   SessionContextCoordinator,
   capturePassiveCorrections,
   clusterByKey,
   detectPassiveCorrections
-} from "./chunk-OQZYHCWM.js";
+} from "./chunk-DCRK7I5E.js";
 import {
   importCapsule
-} from "./chunk-ZHXSOMYH.js";
+} from "./chunk-VVX5PZFS.js";
 import {
   isCodingGraphInstalled
 } from "./chunk-VQ7B2Q6M.js";
+import {
+  listTrustZoneRecords,
+  searchTrustZoneRecords
+} from "./chunk-ROBHL3GL.js";
 import {
   applyTrustScoreStage,
   buildTrustSignalsForRerank,
@@ -381,10 +397,6 @@ import {
   trustResultFor,
   trustResultKey
 } from "./chunk-GNVZQ5JN.js";
-import {
-  listTrustZoneRecords,
-  searchTrustZoneRecords
-} from "./chunk-ROBHL3GL.js";
 import {
   HourlySummarizer
 } from "./chunk-BXOPUJ3W.js";
@@ -396,7 +408,7 @@ import {
 } from "./chunk-5UBH37SL.js";
 import {
   buildXraySnapshot
-} from "./chunk-ECLY4NZA.js";
+} from "./chunk-WH7RINGG.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
@@ -407,10 +419,10 @@ import {
   isTopLevelArchivePath,
   journalPath,
   writeJournalFile
-} from "./chunk-2IVHOQRY.js";
+} from "./chunk-TEQQQTQS.js";
 import {
   searchHarmonicRetrieval
-} from "./chunk-UI6R2YUB.js";
+} from "./chunk-TQT4AOPO.js";
 import {
   ProfilingCollector
 } from "./chunk-NLE6TSLG.js";
@@ -428,7 +440,6 @@ import {
   shouldSkipImplicitExtraction
 } from "./chunk-B4EGAHHS.js";
 import {
-  boundRecallContextComposition,
   composeRecallContext,
   contextBudgetForFooter,
   formatCuriosityFooter,
@@ -437,7 +448,7 @@ import {
 } from "./chunk-IHOXK2I6.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-42BV46XS.js";
+} from "./chunk-AH44WTLJ.js";
 import {
   pruneOrphanCueAnchors
 } from "./chunk-BMWN7B3Y.js";
@@ -451,7 +462,7 @@ import {
   ExtractionDeadlineError,
   ExtractionRunCoordinator,
   classifyExtractionOrigin
-} from "./chunk-EUP4AXIW.js";
+} from "./chunk-DZP2XMZC.js";
 import {
   ARTIFACT_STATUS_CACHE_TTL_MS,
   BulkImportBatchPartialFailureError,
@@ -504,7 +515,28 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-XUKUMBP3.js";
+} from "./chunk-VGO57TU7.js";
+import {
+  estimateTokenCount
+} from "./chunk-TOTT6S2V.js";
+import {
+  capStateViewPackets,
+  reconcileStateViewPairs,
+  resultStateViewKey,
+  stateViewPacketKeys
+} from "./chunk-EH3HNCAM.js";
+import {
+  shouldRecordRecallAuthorityHistory
+} from "./chunk-LVTT5AUG.js";
+import {
+  assertExternalWikiRootOutsideMemoryDirCanonical
+} from "./chunk-JV3C2MNQ.js";
+import {
+  buildProcedurePersistBody
+} from "./chunk-QDW3E4RD.js";
+import {
+  searchCausalTrajectories
+} from "./chunk-L63GFNKL.js";
 import {
   QmdResultResolver,
   StorageManager,
@@ -523,7 +555,7 @@ import {
   reconstructFusionInputs,
   selfDeps,
   serializeFusionDay
-} from "./chunk-D2XUSZ24.js";
+} from "./chunk-QWQB7TOB.js";
 import {
   bodyIsEscaped,
   decodeTranscriptBody,
@@ -540,12 +572,12 @@ import {
 import {
   NamespaceSearchRouter,
   namespaceCollectionName
-} from "./chunk-TZ44E732.js";
+} from "./chunk-AIVRD66I.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend,
   isSearchBackendEnabled
-} from "./chunk-JOP7W24J.js";
+} from "./chunk-PLJ2MQFT.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -559,7 +591,7 @@ import {
 } from "./chunk-S2V7RUCL.js";
 import {
   confidenceTier
-} from "./chunk-PQWICTRO.js";
+} from "./chunk-4UVJ6EIT.js";
 import {
   lintWorkspaceFiles,
   rotateMarkdownFileToArchive
@@ -618,6 +650,10 @@ import {
   getCachedQmdRecall,
   setCachedQmdRecall
 } from "./chunk-42JKGUFJ.js";
+import {
+  isUntrustedOrigin,
+  parseOriginClass
+} from "./chunk-6Q3ZTEF6.js";
 import {
   FallbackLlmClient,
   gatewayTaskChainOptions
@@ -625,31 +661,6 @@ import {
 import {
   fallbackLlmRuntimeContextFromConfig
 } from "./chunk-EP6BA7VV.js";
-import {
-  estimateTokenCount
-} from "./chunk-TOTT6S2V.js";
-import {
-  capStateViewPackets,
-  reconcileStateViewPairs,
-  resultStateViewKey,
-  stateViewPacketKeys
-} from "./chunk-EH3HNCAM.js";
-import {
-  shouldRecordRecallAuthorityHistory
-} from "./chunk-LVTT5AUG.js";
-import {
-  assertExternalWikiRootOutsideMemoryDirCanonical
-} from "./chunk-JV3C2MNQ.js";
-import {
-  buildProcedurePersistBody
-} from "./chunk-QDW3E4RD.js";
-import {
-  searchCausalTrajectories
-} from "./chunk-L63GFNKL.js";
-import {
-  isUntrustedOrigin,
-  parseOriginClass
-} from "./chunk-6Q3ZTEF6.js";
 import {
   normalizeRecallTokenSet
 } from "./chunk-YCVB7X56.js";
@@ -674,7 +685,14 @@ import {
 import {
   localDayKey,
   renderDayLocationContext
-} from "./chunk-UDAUULK2.js";
+} from "./chunk-IGEZE6QB.js";
+import {
+  activityDayWindow,
+  assertValidTimezone,
+  hashActivityBody,
+  isValidActivityDate,
+  timezoneOffsetIso
+} from "./chunk-353C5UNV.js";
 import {
   TAG_LIMITS,
   composeMemoryEnvelope,
@@ -683,13 +701,6 @@ import {
 import {
   normalizeTags
 } from "./chunk-BT7NVCML.js";
-import {
-  activityDayWindow,
-  assertValidTimezone,
-  hashActivityBody,
-  isValidActivityDate,
-  timezoneOffsetIso
-} from "./chunk-353C5UNV.js";
 import {
   evaluateSubjectGuard,
   isSharedPromotionTarget,
@@ -719,15 +730,15 @@ import {
   stripCitationForTemplate,
   stripRecognizedCitations
 } from "./chunk-L272A5QW.js";
-import {
-  excludeSupportPassportPrivateMemories,
-  isSupportPassportPrivateMemory
-} from "./chunk-PWPIERBM.js";
 import {
   inferMemoryStatus,
   isActiveMemoryStatus,
   toMemoryPathRel
 } from "./chunk-7RJUVTVF.js";
+import {
+  excludeSupportPassportPrivateMemories,
+  isSupportPassportPrivateMemory
+} from "./chunk-PWPIERBM.js";
 import {
   assertPathInsideRoot
 } from "./chunk-C7HJ3NEI.js";
@@ -839,7 +850,7 @@ import {
 } from "./chunk-3WCASNQZ.js";
 
 // src/orchestrator.ts
-import path21 from "path";
+import path22 from "path";
 import { createHash as createHash9 } from "crypto";
 
 // src/orchestration/tier-migration-coordinator.ts
@@ -1557,6 +1568,13 @@ var LifecyclePolicyCoordinator = class {
       });
       if (wrote) updatedCount += 1;
     }
+    const history = this.deps.getHandleHistory?.();
+    await runSeedGraduationPass({
+      memories: allMemories,
+      storage,
+      config: this.config.seedGraduation,
+      recalledBySession: history ? (sessionKey) => history.recent(sessionKey) : void 0
+    });
     if (!lifecycleCaps.lifecycleMetrics) return updatedCount;
     const total = evaluatedCount;
     const metrics = {
@@ -2390,7 +2408,7 @@ var RecallRerankCoordinator = class _RecallRerankCoordinator {
       namespaces,
       {
         readNamespaceMemories: async (ns) => (await this.getStorage(ns)).readAllMemories(),
-        readMemoryFrontmatter: async (path40, preferredNamespace) => {
+        readMemoryFrontmatter: async (path41, preferredNamespace) => {
           if (!fallbackReader) {
             for (const ns of namespaces) {
               try {
@@ -2402,7 +2420,7 @@ var RecallRerankCoordinator = class _RecallRerankCoordinator {
           }
           if (!fallbackReader) return null;
           const memory = await this.readQmdResultMemory(
-            path40,
+            path41,
             fallbackReader,
             namespaces,
             preferredNamespace
@@ -9195,7 +9213,7 @@ function createDependencyPropagationReplayReconciliation(host) {
 // src/orchestration/recall-internal.ts
 import { createHash as createHash6 } from "crypto";
 import { readFile as readFile5, stat, unlink as unlink2 } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 
 // src/orchestration/graph-path-state-loader.ts
 import { lstat, opendir, realpath } from "fs/promises";
@@ -9879,7 +9897,7 @@ var GraphRecallCoordinator = class {
   }
 };
 
-// src/procedural/procedure-recall.ts
+// src/experience/session-experience-recall.ts
 function tokenOverlapScore(prompt, memoryText) {
   const norm = (s) => s.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 2);
   const promptTokens = new Set(norm(prompt));
@@ -9892,13 +9910,52 @@ function tokenOverlapScore(prompt, memoryText) {
   const union = /* @__PURE__ */ new Set([...promptTokens, ...memTokens]);
   return inter / Math.max(1, union.size);
 }
-function scoreProcedureForPrompt(m, prompt, queryIntent) {
+function isSessionExperienceMemory(memory) {
+  const hash = memory.frontmatter.structuredAttributes?.experience_session_hash;
+  return typeof hash === "string" && hash.length > 0;
+}
+function scoreSessionExperienceForPrompt(memory, prompt) {
+  if (!isSessionExperienceMemory(memory)) return null;
+  const situation = memory.frontmatter.structuredAttributes?.experience_situation ?? "";
+  const situationScore = tokenOverlapScore(prompt, situation);
+  const bodyScore = tokenOverlapScore(prompt, memory.content);
+  return Math.min(1, situationScore * 0.75 + bodyScore * 0.25);
+}
+function renderSessionExperiencePreview(memory) {
+  if (!isSessionExperienceMemory(memory)) return null;
+  const attrs = memory.frontmatter.structuredAttributes ?? {};
+  const situation = (attrs.experience_situation ?? "").trim();
+  const approach = (attrs.experience_approach ?? "").trim();
+  const reflection = (attrs.experience_reflection ?? "").trim();
+  if (situation.length === 0 && approach.length === 0 && reflection.length === 0) {
+    return `Experience. ${memory.content.replace(/\s+/g, " ").trim()}`;
+  }
+  return `Experience. Situation: ${situation} Approach: ${approach} Reflection: ${reflection}`.replace(/\s+/g, " ").trim();
+}
+
+// src/procedural/procedure-recall.ts
+function tokenOverlapScore2(prompt, memoryText) {
+  const norm = (s) => s.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 2);
+  const promptTokens = new Set(norm(prompt));
+  const memTokens = new Set(norm(memoryText));
+  if (promptTokens.size === 0 || memTokens.size === 0) return 0;
+  let inter = 0;
+  for (const t of promptTokens) {
+    if (memTokens.has(t)) inter++;
+  }
+  const union = /* @__PURE__ */ new Set([...promptTokens, ...memTokens]);
+  return inter / Math.max(1, union.size);
+}
+function scoreProcedureForPrompt(m, prompt, queryIntent, experienceEnabled) {
   const memText = `${m.content}
 ${(m.frontmatter.tags ?? []).join(" ")}`;
-  const jaccard = tokenOverlapScore(prompt, memText);
+  const jaccard = tokenOverlapScore2(prompt, memText);
   const memIntent = inferIntentFromText(m.content.slice(0, 2e3));
   const intentScore = intentCompatibilityScore(queryIntent, memIntent);
-  return jaccard * 0.55 + intentScore * 0.45;
+  const base = jaccard * 0.55 + intentScore * 0.45;
+  if (!experienceEnabled) return base;
+  const experience = scoreSessionExperienceForPrompt(m, prompt);
+  return experience === null ? base : Math.max(base, experience);
 }
 async function buildProcedureRecallSection(storage, prompt, config, options) {
   if (config.procedural?.enabled !== true) return null;
@@ -9914,9 +9971,10 @@ async function buildProcedureRecallSection(storage, prompt, config, options) {
     )
   );
   const all = await storage.readAllMemories();
+  const experienceEnabled = config.sessionExperience?.enabled === true;
   const scored = all.filter(
     (m) => m.frontmatter.category === "procedure" && isActiveMemoryStatus(m.frontmatter.status) && (options?.partitionToolScoped !== true || canRecallToolScopedMemory(m.frontmatter, options.requestingConnector))
-  ).map((m) => ({ m, score: scoreProcedureForPrompt(m, trimmed, queryIntent) })).filter((x) => x.score > 0.04).sort((a, b) => b.score - a.score).slice(0, maxN);
+  ).map((m) => ({ m, score: scoreProcedureForPrompt(m, trimmed, queryIntent, experienceEnabled) })).filter((x) => x.score > 0.04).sort((a, b) => b.score - a.score).slice(0, maxN);
   if (scored.length === 0) return null;
   if (options?.injectedMemories) {
     for (const { m } of scored) {
@@ -9926,7 +9984,8 @@ async function buildProcedureRecallSection(storage, prompt, config, options) {
   const security = resolveSecurityCapabilities(config);
   const blocks = scored.map(({ m, score }) => {
     const id = m.frontmatter.id;
-    const flat = m.content.replace(/\s+/g, " ").trim();
+    const labeled = experienceEnabled ? renderSessionExperiencePreview(m) : null;
+    const flat = (labeled ?? m.content).replace(/\s+/g, " ").trim();
     const preview = flat.slice(0, 320);
     const suffix = flat.length > 320 ? "\u2026" : "";
     const body = renderAuthorityBoundContent(`${preview}${suffix}`, m.frontmatter.origin, {
@@ -10264,6 +10323,104 @@ function resolveCompositeProfileStorage(options) {
   return { profileStorage, profileStorageDirs };
 }
 
+// src/orchestration/recall-recognition-search.ts
+import path11 from "path";
+async function fetchQmdMemoryResultsWithRecognitionSwap(deps, prompt, qmdFetchLimit, qmdHybridFetchLimit, options) {
+  if (deps.config.recallRecognitionTier !== true || options.collection || options.namespacesEnabled !== true) {
+    return deps.fetchQmdMemoryResultsWithArtifactTopUp(
+      prompt,
+      qmdFetchLimit,
+      qmdHybridFetchLimit,
+      options
+    );
+  }
+  const namespaces = options.recallNamespaces.filter(Boolean);
+  if (namespaces.length === 0) {
+    return deps.fetchQmdMemoryResultsWithArtifactTopUp(
+      prompt,
+      qmdFetchLimit,
+      qmdHybridFetchLimit,
+      options
+    );
+  }
+  throwIfRecallAborted(options.abortSignal);
+  const maxEntries = deps.config.recognitionIndexMaxEntries;
+  const recognitionNs = [];
+  const vectorNs = [];
+  for (const namespace of namespaces) {
+    throwIfRecallAborted(options.abortSignal);
+    const storage = await deps.storageRouter.storageFor(namespace);
+    const index = await loadRecognitionIndex(storage.dir);
+    const decision = decideRecognitionTier(index, { maxEntries });
+    if (index !== null && decision.tier === "recognition") {
+      recognitionNs.push({ namespace, storage, index });
+    } else {
+      vectorNs.push(namespace);
+    }
+  }
+  if (recognitionNs.length === 0) {
+    return deps.fetchQmdMemoryResultsWithArtifactTopUp(
+      prompt,
+      qmdFetchLimit,
+      qmdHybridFetchLimit,
+      options
+    );
+  }
+  const recognize = async (recognitionPrompt) => {
+    const reply = await deps.fastLlmForRerank.chatCompletion(
+      [{ role: "user", content: recognitionPrompt }],
+      { operation: "recognition-tier", priority: "recall-critical" }
+    );
+    return reply?.content;
+  };
+  const recognized = [];
+  for (const { namespace, storage, index } of recognitionNs) {
+    throwIfRecallAborted(options.abortSignal);
+    try {
+      const run = await runRecognitionTier(prompt, index.entries, recognize);
+      recognized.push(
+        ...await hitsFromIds(namespace, storage, index, run.ids)
+      );
+    } catch (err) {
+      log.warn(
+        `recognition tier degraded to vector search: recognizer failed${err instanceof Error ? ` (${err.message})` : ""}`
+      );
+      vectorNs.push(namespace);
+    }
+  }
+  const vectorResults = vectorNs.length === 0 ? [] : await deps.fetchQmdMemoryResultsWithArtifactTopUp(
+    prompt,
+    qmdFetchLimit,
+    qmdHybridFetchLimit,
+    { ...options, recallNamespaces: vectorNs }
+  );
+  return dedupeResultsByNamespace(
+    [...recognized, ...vectorResults],
+    options.resolveNamespace,
+    qmdFetchLimit
+  );
+}
+async function hitsFromIds(namespace, storage, index, ids) {
+  if (ids.length === 0) return [];
+  const pathsById = await storage.findExistingMemoryPaths([...ids]);
+  const descriptionById = new Map(index.entries.map((entry) => [entry.id, entry.description]));
+  const hits = [];
+  for (const [offset, id] of ids.entries()) {
+    const absPath = pathsById.get(id)?.[0];
+    if (!absPath) continue;
+    const rel = path11.relative(storage.dir, absPath).split(path11.sep).join("/");
+    if (!rel || rel.startsWith("..")) continue;
+    hits.push({
+      docid: `${namespace}:${rel}`,
+      namespace,
+      path: rel,
+      score: ids.length - offset,
+      snippet: descriptionById.get(id) ?? id
+    });
+  }
+  return hits;
+}
+
 // src/orchestration/recall-internal.ts
 var RecallInternalCoordinator = class {
   constructor(deps) {
@@ -10498,7 +10655,7 @@ var RecallInternalCoordinator = class {
       const graphExpandedResultPaths = /* @__PURE__ */ new Set();
       const graphSourceLabelsForPath = (resultPath) => {
         const labels = [];
-        const normalizedPath = resultPath.split(path11.sep).join("/");
+        const normalizedPath = resultPath.split(path12.sep).join("/");
         const isEntityPath = normalizedPath.startsWith("entities/") || normalizedPath.includes("/entities/");
         if (graphBaselinePaths.has(resultPath)) labels.push("baseline");
         if (graphExpandedResultPaths.has(resultPath))
@@ -11824,7 +11981,8 @@ ${rows.join("\n")}
             }) : Promise.resolve([])
           ]) : null;
           try {
-            const filteredResults = await this.deps.fetchQmdMemoryResultsWithArtifactTopUp(
+            const filteredResults = await fetchQmdMemoryResultsWithRecognitionSwap(
+              this.deps,
               retrievalQuery,
               qmdFetchLimit,
               qmdHybridFetchLimit,
@@ -12034,11 +12192,11 @@ ${formatted}`;
         if (!resolveRecallAuxiliaryCapabilities(this.deps.config).compactionReset) return null;
         const workspaceDir = compactionWorkspaceDir || this.deps.config.workspaceDir || defaultWorkspaceDir();
         const safeSessionKey = sanitizeSessionKeyForFilename(effectiveSessionKey);
-        const signalPath = path11.join(
+        const signalPath = path12.join(
           workspaceDir,
           `.compaction-reset-signal-${safeSessionKey}`
         );
-        const bootPath = path11.join(workspaceDir, "BOOT.md");
+        const bootPath = path12.join(workspaceDir, "BOOT.md");
         try {
           const signalStat = await stat(signalPath).catch(() => null);
           if (!signalStat) return null;
@@ -14015,27 +14173,15 @@ ${tmtNode.summary}`
         recalledMemoryNamespaces
       );
       const recalledContext = assembledRecall.sections.join("\n\n---\n\n");
-      const composition = boundRecallContextComposition({
+      const { composition, context, truncated: compositionTruncated } = decideRecallContextComposition({
         context: recalledContext,
+        compactContext: compactRecallContextFromBuckets(sectionBuckets),
         footer: curiosityFooter,
         maxChars: recallBudgetChars
       });
-      const context = composeRecallContext(composition);
-      try {
-        const observerResult = options.onContextComposition?.(composition);
-        if (observerResult && typeof observerResult.then === "function") {
-          void Promise.resolve(observerResult).catch((err) => log.warn(
-            "recall: context composition observer rejected",
-            err
-          ));
-        }
-      } catch (err) {
+      notifyContextComposition(options.onContextComposition, composition, (err) => {
         log.warn("recall: context composition observer failed open", err);
-      }
-      const compositionTruncated = context.length < composeRecallContext({
-        context: recalledContext,
-        footer: curiosityFooter
-      }).length;
+      });
       const includedSections = [...assembledRecall.includedIds];
       const omittedSections = [...assembledRecall.omittedIds];
       if (composition.footer && !includedSections.includes("questions")) includedSections.push("questions");
@@ -14203,6 +14349,7 @@ ${tmtNode.summary}`
               chars: this.deps.getRecallBudgetChars(options.budgetCharsOverride),
               used: context.length
             },
+            ...composition.degradation ? { degradation: composition.degradation } : {},
             sessionKey,
             namespace: selfNamespace,
             traceId,
@@ -14324,10 +14471,10 @@ ${tmtNode.summary}`
 
 // src/orchestration/recall-search-pipeline.ts
 import { createHash as createHash7 } from "crypto";
-import path13 from "path";
+import path14 from "path";
 
 // src/orchestration/recall-search-prefilter.ts
-import path12 from "path";
+import path13 from "path";
 async function fetchActiveArtifactsForNamespace(deps, namespace, prompt, targetCount, options = {}) {
   const storage = await deps.storageRouter.storageFor(namespace);
   let fetchLimit = computeArtifactCandidateFetchLimit(targetCount);
@@ -14456,7 +14603,7 @@ async function searchEmbeddingFallback(deps, query, limit) {
   if (hits.length === 0) return [];
   const results = [];
   for (const hit of hits) {
-    const fullPath = path12.isAbsolute(hit.path) ? hit.path : path12.join(deps.config.memoryDir, hit.path);
+    const fullPath = path13.isAbsolute(hit.path) ? hit.path : path13.join(deps.config.memoryDir, hit.path);
     const memory = await deps.storage.readMemoryByPath(fullPath);
     if (!memory) continue;
     results.push({
@@ -14834,7 +14981,7 @@ var RecallSearchPipelineCoordinator = class {
           const storage = await this.deps.storageRouter.storageFor(namespace);
           const storageDir = typeof storage.dir === "string" && storage.dir ? storage.dir : null;
           if (!storageDir) continue;
-          const recallRoot = path13.resolve(storageDir);
+          const recallRoot = path14.resolve(storageDir);
           if (seenRecallRoots.has(recallRoot)) continue;
           seenRecallRoots.add(recallRoot);
           recallRoots.push(recallRoot);
@@ -14858,8 +15005,8 @@ var RecallSearchPipelineCoordinator = class {
           if (resolvedCold) scopedResults.push(resolvedCold.result);
           continue;
         }
-        if (path13.isAbsolute(result.path)) {
-          if (recallRoots.some((recallRoot) => isPathInsideStorageRoot(recallRoot, path13.resolve(result.path)))) {
+        if (path14.isAbsolute(result.path)) {
+          if (recallRoots.some((recallRoot) => isPathInsideStorageRoot(recallRoot, path14.resolve(result.path)))) {
             scopedResults.push(result);
           }
           continue;
@@ -16053,7 +16200,7 @@ var TurnIngestionCoordinator = class {
 
 // src/orchestration/recall-introspection.ts
 import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
-import path15 from "path";
+import path16 from "path";
 
 // src/taxonomy/default-taxonomy.ts
 var DEFAULT_TAXONOMY = {
@@ -16176,7 +16323,7 @@ function generateResolverDocument(taxonomy) {
 
 // src/taxonomy/taxonomy-loader.ts
 import { readFile as readFile6, mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 var TAXONOMY_DIR = ".taxonomy";
 var TAXONOMY_FILE = "taxonomy.json";
 var MAX_SLUG_LENGTH = 32;
@@ -16274,7 +16421,7 @@ function validateTaxonomy(taxonomy) {
   }
 }
 async function loadTaxonomy(memoryDir) {
-  const taxonomyPath = path14.join(memoryDir, TAXONOMY_DIR, TAXONOMY_FILE);
+  const taxonomyPath = path15.join(memoryDir, TAXONOMY_DIR, TAXONOMY_FILE);
   let raw;
   try {
     raw = await readFile6(taxonomyPath, "utf-8");
@@ -16324,16 +16471,16 @@ async function loadTaxonomy(memoryDir) {
 }
 async function saveTaxonomy(memoryDir, taxonomy) {
   validateTaxonomy(taxonomy);
-  const dir = path14.join(memoryDir, TAXONOMY_DIR);
+  const dir = path15.join(memoryDir, TAXONOMY_DIR);
   await mkdir4(dir, { recursive: true });
-  const filePath = path14.join(dir, TAXONOMY_FILE);
+  const filePath = path15.join(dir, TAXONOMY_FILE);
   await writeFile4(filePath, JSON.stringify(taxonomy, null, 2) + "\n", "utf-8");
 }
 function getTaxonomyDir(memoryDir) {
-  return path14.join(memoryDir, TAXONOMY_DIR);
+  return path15.join(memoryDir, TAXONOMY_DIR);
 }
 function getTaxonomyFilePath(memoryDir) {
-  return path14.join(memoryDir, TAXONOMY_DIR, TAXONOMY_FILE);
+  return path15.join(memoryDir, TAXONOMY_DIR, TAXONOMY_FILE);
 }
 
 // src/orchestration/recall-introspection.ts
@@ -16357,7 +16504,7 @@ var RecallIntrospectionCoordinator = class {
   }
   async getLastGraphRecallSnapshot(namespace) {
     const storage = await this.deps.getStorage(namespace);
-    const snapshotPath = path15.join(
+    const snapshotPath = path16.join(
       storage.dir,
       "state",
       "last_graph_recall.json"
@@ -16396,7 +16543,7 @@ var RecallIntrospectionCoordinator = class {
   }
   async getLastIntentSnapshot(namespace) {
     const storage = await this.deps.getStorage(namespace);
-    const snapshotPath = path15.join(storage.dir, "state", "last_intent.json");
+    const snapshotPath = path16.join(storage.dir, "state", "last_intent.json");
     try {
       const raw = await readFile7(snapshotPath, "utf-8");
       const parsed = JSON.parse(raw);
@@ -16429,7 +16576,7 @@ var RecallIntrospectionCoordinator = class {
   }
   async getLastQmdRecallSnapshot(namespace) {
     const storage = await this.deps.getStorage(namespace);
-    const snapshotPath = path15.join(
+    const snapshotPath = path16.join(
       storage.dir,
       "state",
       "last_qmd_recall.json"
@@ -16721,12 +16868,12 @@ var RecallIntrospectionCoordinator = class {
   }
   async recordLastIntentSnapshot(options) {
     try {
-      const snapshotPath = path15.join(
+      const snapshotPath = path16.join(
         options.storage.dir,
         "state",
         "last_intent.json"
       );
-      await mkdir5(path15.dirname(snapshotPath), { recursive: true });
+      await mkdir5(path16.dirname(snapshotPath), { recursive: true });
       await writeFile5(
         snapshotPath,
         JSON.stringify(options.snapshot, null, 2),
@@ -16738,12 +16885,12 @@ var RecallIntrospectionCoordinator = class {
   }
   async recordLastQmdRecallSnapshot(options) {
     try {
-      const snapshotPath = path15.join(
+      const snapshotPath = path16.join(
         options.storage.dir,
         "state",
         "last_qmd_recall.json"
       );
-      await mkdir5(path15.dirname(snapshotPath), { recursive: true });
+      await mkdir5(path16.dirname(snapshotPath), { recursive: true });
       await writeFile5(
         snapshotPath,
         JSON.stringify(options.snapshot, null, 2),
@@ -16758,8 +16905,8 @@ var RecallIntrospectionCoordinator = class {
       const stateDir = await this.deps.resolveStateDirForNamespace(
         options.namespace
       );
-      const snapshotPath = path15.join(stateDir, "last_intent.json");
-      await mkdir5(path15.dirname(snapshotPath), { recursive: true });
+      const snapshotPath = path16.join(stateDir, "last_intent.json");
+      await mkdir5(path16.dirname(snapshotPath), { recursive: true });
       await writeFile5(
         snapshotPath,
         JSON.stringify(options.snapshot, null, 2),
@@ -16773,7 +16920,7 @@ var RecallIntrospectionCoordinator = class {
 
 // src/orchestration/orchestrator-init.ts
 import { readdir as readdir2, stat as stat2, unlink as unlink3 } from "fs/promises";
-import path16 from "path";
+import path17 from "path";
 
 // src/orchestration/startup-collection-checks.ts
 async function startupDiscoveryWithTimeout(discover, configuredFallback, timeoutMs = qmdStartupCollectionCheckTimeoutMs()) {
@@ -17089,7 +17236,7 @@ var OrchestratorInitCoordinator = class {
           const files = await readdir2(wsDir).catch(() => []);
           for (const f of files) {
             if (!f.startsWith(".compaction-reset-signal-")) continue;
-            const fp = path16.join(wsDir, f);
+            const fp = path17.join(wsDir, f);
             const s = await stat2(fp).catch(() => null);
             if (s && Date.now() - s.mtimeMs >= COMPACTION_SIGNAL_MAX_AGE_MS) {
               await unlink3(fp).catch(() => {
@@ -17335,7 +17482,7 @@ var OrchestratorInitCoordinator = class {
     if (signal.aborted || !this.isCurrentStartupEpoch(epoch)) 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-DG5KEOF5.js");
+        const { startWearablesAutoSync } = await import("./auto-sync-CWSZDLLW.js");
         if (signal.aborted || !this.isCurrentStartupEpoch(epoch)) return;
         this.deps.wearablesAutoSyncHandle = startWearablesAutoSync(
           {
@@ -17508,7 +17655,7 @@ var OrchestratorInitCoordinator = class {
 };
 
 // src/orchestration/persistence-index.ts
-import path17 from "path";
+import path18 from "path";
 var PersistenceIndexCoordinator = class {
   constructor(deps) {
     this.deps = deps;
@@ -17700,7 +17847,7 @@ var PersistenceIndexCoordinator = class {
         const allMems = allMemsForGraph ?? [];
         for (const m of allMems) {
           if (m.frontmatter.entityRef === entityRef) {
-            const rel = path17.relative(storage.dir, m.path);
+            const rel = path18.relative(storage.dir, m.path);
             if (rel !== memoryRelPath) entitySiblings.push(rel);
           }
         }
@@ -17855,7 +18002,7 @@ var PersistenceIndexCoordinator = class {
 
 // src/orchestration/workspace-ops.ts
 import { lstat as lstat2, mkdir as mkdir6, readFile as readFile8, readdir as readdir3, realpath as realpath2, writeFile as writeFile6 } from "fs/promises";
-import path18 from "path";
+import path19 from "path";
 
 // src/maintenance/pattern-reinforcement.ts
 function patternReinforcementKey(content) {
@@ -19759,8 +19906,8 @@ var MeetingsService = class {
 // src/orchestration/workspace-ops.ts
 var MEETINGS_BUILD_DEBOUNCE_MS = 5e3;
 function matchesMemoryPath(candidatePath, requestedPath, memoryDir) {
-  const normalizedCandidate = path18.resolve(candidatePath);
-  return normalizedCandidate === path18.resolve(requestedPath) || normalizedCandidate === path18.resolve(memoryDir, requestedPath);
+  const normalizedCandidate = path19.resolve(candidatePath);
+  return normalizedCandidate === path19.resolve(requestedPath) || normalizedCandidate === path19.resolve(memoryDir, requestedPath);
 }
 function accessTrackingPathCandidates(storageDir, memoryPath) {
   const candidates = qmdResultPathCandidates(storageDir, memoryPath);
@@ -19768,12 +19915,12 @@ function accessTrackingPathCandidates(storageDir, memoryPath) {
   if (!parts) return candidates;
   candidates.push(
     ...qmdResultPathCandidates(storageDir, parts.relativePath),
-    ...qmdResultPathCandidates(path18.join(storageDir, "cold"), parts.relativePath)
+    ...qmdResultPathCandidates(path19.join(storageDir, "cold"), parts.relativePath)
   );
   return [...new Set(candidates)];
 }
 function canonicalMemoryPath(memoryPath, memoryDir) {
-  return path18.resolve(path18.isAbsolute(memoryPath) ? memoryPath : path18.resolve(memoryDir, memoryPath));
+  return path19.resolve(path19.isAbsolute(memoryPath) ? memoryPath : path19.resolve(memoryDir, memoryPath));
 }
 var WorkspaceOpsCoordinator = class {
   constructor(deps) {
@@ -19855,15 +20002,15 @@ var WorkspaceOpsCoordinator = class {
     this.deps.lastFileHygieneRunAtMs = now;
     if (hygiene.rotateEnabled) {
       for (const rel of hygiene.rotatePaths) {
-        const abs = path18.isAbsolute(rel) ? rel : path18.join(this.deps.config.workspaceDir, rel);
+        const abs = path19.isAbsolute(rel) ? rel : path19.join(this.deps.config.workspaceDir, rel);
         try {
           const raw = await readFile8(abs, "utf-8");
           if (raw.length > hygiene.rotateMaxBytes) {
-            const archiveDir = path18.join(
+            const archiveDir = path19.join(
               this.deps.config.workspaceDir,
               hygiene.archiveDir
             );
-            const base = path18.basename(abs);
+            const base = path19.basename(abs);
             const prefix = base.toUpperCase().replace(/\.MD$/i, "").replace(/[^A-Z0-9]+/g, "-") || "FILE";
             const { newContent } = await rotateMarkdownFileToArchive({
               filePath: abs,
@@ -19888,8 +20035,8 @@ var WorkspaceOpsCoordinator = class {
         log.warn(w.message);
       }
       if (hygiene.warningsLogEnabled && warnings.length > 0) {
-        const fp = path18.join(this.deps.config.memoryDir, hygiene.warningsLogPath);
-        await mkdir6(path18.dirname(fp), { recursive: true });
+        const fp = path19.join(this.deps.config.memoryDir, hygiene.warningsLogPath);
+        await mkdir6(path19.dirname(fp), { recursive: true });
         const stamp = (/* @__PURE__ */ new Date()).toISOString();
         const block = `
 
@@ -19929,7 +20076,7 @@ var WorkspaceOpsCoordinator = class {
     for (const categoryDir of RECALL_FALLBACK_DIRS) {
       if (memoryRootReal === null) break;
       for (const date of datesToScan) {
-        const dateDir = path18.join(storage.dir, categoryDir, date);
+        const dateDir = path19.join(storage.dir, categoryDir, date);
         try {
           const dirStat = await lstat2(dateDir);
           if (dirStat.isSymbolicLink() || !dirStat.isDirectory()) continue;
@@ -19938,7 +20085,7 @@ var WorkspaceOpsCoordinator = class {
           for (const entry of entries) {
             if (entry.isSymbolicLink()) continue;
             if (!entry.name.endsWith(".md")) continue;
-            const fullPath = path18.join(dateDir, entry.name);
+            const fullPath = path19.join(dateDir, entry.name);
             try {
               assertPathInsideRoot(memoryRootReal, await realpath2(fullPath), fullPath);
               const memory = await storage.readMemoryByPath(fullPath);
@@ -19960,13 +20107,13 @@ var WorkspaceOpsCoordinator = class {
       return a.frontmatter.created < b.frontmatter.created ? -1 : 1;
     });
     const hourlySummaries = [];
-    const hourlyBaseDir = path18.join(storage.dir, "summaries", "hourly");
+    const hourlyBaseDir = path19.join(storage.dir, "summaries", "hourly");
     try {
       const sessionKeys = await readdir3(hourlyBaseDir, { withFileTypes: true });
       for (const sk of sessionKeys) {
         if (!sk.isDirectory()) continue;
         for (const date of datesToScan) {
-          const summaryFile = path18.join(hourlyBaseDir, sk.name, `${date}.md`);
+          const summaryFile = path19.join(hourlyBaseDir, sk.name, `${date}.md`);
           try {
             const raw = await readFile8(summaryFile, "utf-8");
             const filtered = filterHourlySummaryMarkdownForLocalDay(
@@ -20443,18 +20590,18 @@ ${reflectionsContent.trim()}
 // src/orchestration/namespace-read-fanout.ts
 import { existsSync, readFileSync } from "fs";
 import { stat as stat3 } from "fs/promises";
-import path20 from "path";
+import path21 from "path";
 
 // src/orchestration/orchestrator-namespace-scope.ts
-import path19 from "path";
+import path20 from "path";
 function computeSemanticDedupScope(targetStorage, config) {
   if (!resolveNamespaceCapabilities(config).namespaces) return {};
-  const memoryDir = path19.resolve(config.memoryDir);
-  const storageDir = path19.resolve(targetStorage.dir);
+  const memoryDir = path20.resolve(config.memoryDir);
+  const storageDir = path20.resolve(targetStorage.dir);
   if (storageDir === memoryDir) {
     return { pathExcludePrefixes: ["namespaces/"] };
   }
-  let rel = path19.relative(memoryDir, storageDir);
+  let rel = path20.relative(memoryDir, storageDir);
   if (!rel || rel.startsWith("..")) {
     log.debug(
       `semantic dedup: target storage dir ${storageDir} is outside memoryDir ${memoryDir}; scoping lookup to absolute path prefix`
@@ -20507,7 +20654,7 @@ var NamespaceReadFanoutCoordinator = class {
   loadNamespaceStorageDirHintsFromCatalog() {
     if (this.deps.namespaceStorageDirHintsLoaded || !this.deps.namespaceCatalog.enabled) return;
     this.deps.namespaceStorageDirHintsLoaded = true;
-    const catalogPath = path20.join(this.deps.config.memoryDir, "state", "namespaces.jsonl");
+    const catalogPath = path21.join(this.deps.config.memoryDir, "state", "namespaces.jsonl");
     if (!existsSync(catalogPath)) return;
     let body;
     try {
@@ -20544,7 +20691,7 @@ var NamespaceReadFanoutCoordinator = class {
       if (!this.deps.storageDirMatchesNamespaceHint(record.namespace, record.storageDir)) {
         continue;
       }
-      const resolvedStorageDir = path20.resolve(record.storageDir);
+      const resolvedStorageDir = path21.resolve(record.storageDir);
       const current = preferredByStorageDir.get(resolvedStorageDir);
       preferredByStorageDir.set(
         resolvedStorageDir,
@@ -20729,12 +20876,12 @@ var NamespaceReadFanoutCoordinator = class {
   }
   async resolveStateDirForNamespace(namespace) {
     if (!resolveNamespaceCapabilities(this.deps.config).namespaces) {
-      return path20.join(this.deps.config.memoryDir, "state");
+      return path21.join(this.deps.config.memoryDir, "state");
     }
     if (namespace !== this.deps.config.defaultNamespace) {
-      return path20.join(this.deps.config.memoryDir, "namespaces", namespace, "state");
+      return path21.join(this.deps.config.memoryDir, "namespaces", namespace, "state");
     }
-    const candidate = path20.join(
+    const candidate = path21.join(
       this.deps.config.memoryDir,
       "namespaces",
       this.deps.config.defaultNamespace
@@ -20742,11 +20889,11 @@ var NamespaceReadFanoutCoordinator = class {
     try {
       const candidateStat = await stat3(candidate);
       if (candidateStat.isDirectory()) {
-        return path20.join(candidate, "state");
+        return path21.join(candidate, "state");
       }
     } catch {
     }
-    return path20.join(this.deps.config.memoryDir, "state");
+    return path21.join(this.deps.config.memoryDir, "state");
   }
   namespaceFromPath(p) {
     if (!resolveNamespaceCapabilities(this.deps.config).namespaces) return this.deps.config.defaultNamespace;
@@ -20878,7 +21025,12 @@ var RecallEntryCoordinator = class {
     } catch (err) {
       this.deps.logRecallFailure(err);
       this.deps.profiler.endTrace();
-      return "";
+      const missing = options.abortSignal?.aborted ? null : recallFailureComposition(err);
+      if (!missing) return "";
+      notifyContextComposition(options.onContextComposition, missing, (observerErr) => {
+        log.warn("recall: context composition observer failed open", observerErr);
+      });
+      return composeRecallContext(missing);
     } finally {
       options.abortSignal?.removeEventListener("abort", onAbort);
     }
@@ -21196,7 +21348,7 @@ var Orchestrator = class {
     if (this.destroyed) throw new Error("orchestrator has been destroyed");
     if (!this._dependencyPropagationDelivery) {
       this._dependencyPropagationDelivery = new DependencyPropagationDelivery({
-        queueRoot: path21.join(this.config.memoryDir, "state", "dependency-propagation"),
+        queueRoot: path22.join(this.config.memoryDir, "state", "dependency-propagation"),
         config: this.config,
         extraction: this.extraction,
         getStorage: (namespace) => this.getStorage(namespace),
@@ -21551,7 +21703,7 @@ var Orchestrator = class {
     const defaultNs = normalizeNamespaceIdentity(this.config.defaultNamespace);
     if (ns !== defaultNs && !isSafeRouteNamespace(ns)) return;
     if (!this.storageDirMatchesNamespaceHint(ns, storageDir)) return;
-    const resolvedStorageDir = path21.resolve(storageDir);
+    const resolvedStorageDir = path22.resolve(storageDir);
     let hints = this.namespaceStorageDirHints.get(resolvedStorageDir);
     if (!hints) {
       hints = /* @__PURE__ */ new Set();
@@ -21562,21 +21714,21 @@ var Orchestrator = class {
   storageDirMatchesNamespaceHint(namespace, storageDir) {
     const ns = normalizeNamespaceIdentity(namespace);
     if (!ns) return false;
-    const resolvedStorageDir = path21.resolve(storageDir);
-    const resolvedMemoryDir = path21.resolve(this.config.memoryDir);
+    const resolvedStorageDir = path22.resolve(storageDir);
+    const resolvedMemoryDir = path22.resolve(this.config.memoryDir);
     const defaultNs = normalizeNamespaceIdentity(this.config.defaultNamespace);
     if (resolvedStorageDir === resolvedMemoryDir) return ns === defaultNs;
-    const resolvedNamespacesDir = path21.join(resolvedMemoryDir, "namespaces");
+    const resolvedNamespacesDir = path22.join(resolvedMemoryDir, "namespaces");
     if (!isPathInsideStorageRoot(resolvedNamespacesDir, resolvedStorageDir)) return false;
-    const rawRoot = path21.resolve(resolvedNamespacesDir, ns);
-    const tokenRoot = path21.resolve(resolvedNamespacesDir, namespaceIdentityToken(ns));
+    const rawRoot = path22.resolve(resolvedNamespacesDir, ns);
+    const tokenRoot = path22.resolve(resolvedNamespacesDir, namespaceIdentityToken(ns));
     return resolvedStorageDir === rawRoot || resolvedStorageDir === tokenRoot;
   }
   namespaceStorageDirHintOwnershipRank(record, resolvedStorageDir, configured) {
-    if (resolvedStorageDir === path21.resolve(this.config.memoryDir)) {
+    if (resolvedStorageDir === path22.resolve(this.config.memoryDir)) {
       return record.namespace === normalizeNamespaceIdentity(this.config.defaultNamespace) ? 0 : 3;
     }
-    const leaf = path21.basename(resolvedStorageDir);
+    const leaf = path22.basename(resolvedStorageDir);
     const tokenOwnsRoot = namespaceIdentityToken(record.namespace) === leaf;
     if (tokenOwnsRoot && configured.has(record.namespace)) return 0;
     if (record.namespace === leaf) return 1;
@@ -21717,7 +21869,7 @@ var Orchestrator = class {
     StorageManager.setOkfConformanceDefault(config.memoryDir, config.okf?.conformanceEnabled);
     this.profiler = new ProfilingCollector({
       enabled: resolvePipelineProcessingCapabilities(this.config).profiling,
-      storageDir: config.profilingStorageDir || path21.join(config.memoryDir, "profiling"),
+      storageDir: config.profilingStorageDir || path22.join(config.memoryDir, "profiling"),
       maxTraces: config.profilingMaxTraces
     });
     this.namespaceCatalog = new NamespaceCatalog(config);
@@ -21804,7 +21956,7 @@ var Orchestrator = class {
     this.compounding = resolveConsolidationCapabilities(config).compounding ? new CompoundingEngine(config, this.storage) : void 0;
     this.buffer = new SmartBuffer(config, this.storage);
     this.transcript = new TranscriptManager(config);
-    this.conversationIndexDir = path21.join(
+    this.conversationIndexDir = path22.join(
       config.memoryDir,
       "conversation-index",
       "chunks"
@@ -21951,10 +22103,11 @@ var Orchestrator = class {
       embeddingFallback: this.embeddingFallback,
       getEffectiveLifecycleThresholds: () => this.effectiveLifecycleThresholds(),
       removeContentHashForMemory: (targetStorage, memory, context) => this.removeContentHashForMemory(targetStorage, memory, context),
-      saveContentHashIndexes: () => this.saveContentHashIndexes()
+      saveContentHashIndexes: () => this.saveContentHashIndexes(),
+      getHandleHistory: () => this.handleHistory
     });
     this.threading = new ThreadingManager(
-      path21.join(config.memoryDir, "threads"),
+      path22.join(config.memoryDir, "threads"),
       config.threadingGapMinutes
     );
     const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);
@@ -24047,9 +24200,9 @@ function readStructuralSymbol(entry) {
   const rec = entry;
   const symbol = typeof rec.symbol === "string" ? rec.symbol.trim() : "";
   if (!symbol) return null;
-  const path40 = typeof rec.path === "string" && rec.path.length > 0 ? rec.path : void 0;
+  const path41 = typeof rec.path === "string" && rec.path.length > 0 ? rec.path : void 0;
   const kind = typeof rec.kind === "string" && rec.kind.length > 0 ? rec.kind : void 0;
-  const item = path40 !== void 0 && kind !== void 0 ? { symbol, path: path40, kind } : path40 !== void 0 ? { symbol, path: path40 } : kind !== void 0 ? { symbol, kind } : { symbol };
+  const item = path41 !== void 0 && kind !== void 0 ? { symbol, path: path41, kind } : path41 !== void 0 ? { symbol, path: path41 } : kind !== void 0 ? { symbol, kind } : { symbol };
   return item;
 }
 function classifySpawnError(err) {
@@ -24123,7 +24276,7 @@ var DEFAULT_GRACE_PERIOD_DAYS = 7;
 
 // src/binary-lifecycle/backend.ts
 import fsp from "fs/promises";
-import path22 from "path";
+import path23 from "path";
 var FilesystemBackend = class {
   type = "filesystem";
   basePath;
@@ -24131,19 +24284,19 @@ var FilesystemBackend = class {
     if (!basePath || basePath.trim().length === 0) {
       throw new Error("FilesystemBackend requires a non-empty basePath");
     }
-    this.basePath = path22.resolve(basePath);
+    this.basePath = path23.resolve(basePath);
   }
   resolveRemotePath(remotePath) {
-    const resolved = path22.isAbsolute(remotePath) ? path22.resolve(remotePath) : path22.resolve(this.basePath, remotePath);
-    const relative = path22.relative(this.basePath, resolved);
-    if (relative === ".." || relative.startsWith(`..${path22.sep}`) || path22.isAbsolute(relative)) {
+    const resolved = path23.isAbsolute(remotePath) ? path23.resolve(remotePath) : path23.resolve(this.basePath, remotePath);
+    const relative = path23.relative(this.basePath, resolved);
+    if (relative === ".." || relative.startsWith(`..${path23.sep}`) || path23.isAbsolute(relative)) {
       throw new Error(`FilesystemBackend remotePath escapes basePath: ${JSON.stringify(remotePath)}`);
     }
     return resolved;
   }
   isInsideBase(candidate, realBase) {
-    const relative = path22.relative(realBase, candidate);
-    return relative === "" || relative !== ".." && !relative.startsWith(`..${path22.sep}`) && !path22.isAbsolute(relative);
+    const relative = path23.relative(realBase, candidate);
+    return relative === "" || relative !== ".." && !relative.startsWith(`..${path23.sep}`) && !path23.isAbsolute(relative);
   }
   async realBasePathIfExists() {
     try {
@@ -24172,13 +24325,13 @@ var FilesystemBackend = class {
   }
   async ensureSafeParentDirectory(dest) {
     const realBase = await this.ensureBaseDirectory();
-    const destDir = path22.dirname(dest);
-    const relativeDir = path22.relative(this.basePath, destDir);
-    const segments = relativeDir === "" ? [] : relativeDir.split(path22.sep);
+    const destDir = path23.dirname(dest);
+    const relativeDir = path23.relative(this.basePath, destDir);
+    const segments = relativeDir === "" ? [] : relativeDir.split(path23.sep);
     let current = this.basePath;
     for (const segment of segments) {
       if (segment === "." || segment === "") continue;
-      current = path22.join(current, segment);
+      current = path23.join(current, segment);
       try {
         const stat5 = await fsp.lstat(current);
         if (stat5.isSymbolicLink()) {
@@ -24206,13 +24359,13 @@ var FilesystemBackend = class {
     if (realBase === null) {
       return null;
     }
-    const destDir = path22.dirname(dest);
-    const relativeDir = path22.relative(this.basePath, destDir);
-    const segments = relativeDir === "" ? [] : relativeDir.split(path22.sep);
+    const destDir = path23.dirname(dest);
+    const relativeDir = path23.relative(this.basePath, destDir);
+    const segments = relativeDir === "" ? [] : relativeDir.split(path23.sep);
     let current = this.basePath;
     for (const segment of segments) {
       if (segment === "." || segment === "") continue;
-      current = path22.join(current, segment);
+      current = path23.join(current, segment);
       let stat5;
       try {
         stat5 = await fsp.lstat(current);
@@ -24260,7 +24413,7 @@ var FilesystemBackend = class {
     return dest;
   }
   async upload(localPath, remotePath) {
-    if (path22.isAbsolute(remotePath)) {
+    if (path23.isAbsolute(remotePath)) {
       throw new Error(`FilesystemBackend upload remotePath must be relative: ${JSON.stringify(remotePath)}`);
     }
     const dest = this.resolveRemotePath(remotePath);
@@ -24333,7 +24486,7 @@ function createBackend(cfg) {
 
 // src/binary-lifecycle/scanner.ts
 import fsp2 from "fs/promises";
-import path23 from "path";
+import path24 from "path";
 import crypto from "crypto";
 function matchesPatterns(filename, patterns) {
   const lower = filename.toLowerCase();
@@ -24358,8 +24511,8 @@ async function scanForBinaries(memoryDir, config, manifest) {
       return;
     }
     for (const entry of entries) {
-      const fullPath = path23.join(dir, entry.name);
-      const relativePath = path23.relative(memoryDir, fullPath).split(path23.sep).join("/");
+      const fullPath = path24.join(dir, entry.name);
+      const relativePath = path24.relative(memoryDir, fullPath).split(path24.sep).join("/");
       if (entry.isDirectory()) {
         if (entry.name === ".binary-lifecycle") continue;
         await walk(fullPath);
@@ -24399,15 +24552,15 @@ async function hashFile(filePath) {
 
 // src/binary-lifecycle/manifest.ts
 import fsp3 from "fs/promises";
-import path24 from "path";
+import path25 from "path";
 import crypto2 from "crypto";
 var MANIFEST_DIR = ".binary-lifecycle";
 var MANIFEST_FILE = "manifest.json";
 function manifestDir(memoryDir) {
-  return path24.join(memoryDir, MANIFEST_DIR);
+  return path25.join(memoryDir, MANIFEST_DIR);
 }
 function manifestPath(memoryDir) {
-  return path24.join(memoryDir, MANIFEST_DIR, MANIFEST_FILE);
+  return path25.join(memoryDir, MANIFEST_DIR, MANIFEST_FILE);
 }
 async function readManifest(memoryDir) {
   const filePath = manifestPath(memoryDir);
@@ -24459,13 +24612,13 @@ function emptyManifest() {
 
 // src/binary-lifecycle/pipeline.ts
 import fsp4 from "fs/promises";
-import path25 from "path";
+import path26 from "path";
 import crypto3 from "crypto";
 var historicalIdCache = new HistoricalEntityCanonicalIdCache();
 function isRecallCorpusMarkdown(mdPath, memoryDir) {
-  const rel = path25.relative(memoryDir, mdPath);
-  if (rel.startsWith("..") || path25.isAbsolute(rel)) return false;
-  const top = rel.split(path25.sep)[0];
+  const rel = path26.relative(memoryDir, mdPath);
+  if (rel.startsWith("..") || path26.isAbsolute(rel)) return false;
+  const top = rel.split(path26.sep)[0];
   return RECALL_FALLBACK_DIRS.includes(top);
 }
 async function hashFile2(filePath) {
@@ -24489,13 +24642,13 @@ function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function resolveManifestAssetPath(memoryDir, originalPath) {
-  if (originalPath.length === 0 || originalPath.includes("\0") || originalPath.includes("\\") || path25.isAbsolute(originalPath) || path25.win32.isAbsolute(originalPath)) {
+  if (originalPath.length === 0 || originalPath.includes("\0") || originalPath.includes("\\") || path26.isAbsolute(originalPath) || path26.win32.isAbsolute(originalPath)) {
     return null;
   }
-  const memoryRoot = path25.resolve(memoryDir);
-  const fullPath = path25.resolve(memoryRoot, originalPath);
-  const relative = path25.relative(memoryRoot, fullPath);
-  if (relative === "" || relative === ".." || relative.startsWith(`..${path25.sep}`) || path25.isAbsolute(relative)) {
+  const memoryRoot = path26.resolve(memoryDir);
+  const fullPath = path26.resolve(memoryRoot, originalPath);
+  const relative = path26.relative(memoryRoot, fullPath);
+  if (relative === "" || relative === ".." || relative.startsWith(`..${path26.sep}`) || path26.isAbsolute(relative)) {
     return null;
   }
   return fullPath;
@@ -24506,7 +24659,7 @@ function validateBinaryLifecycleConfig(config) {
   }
 }
 function remotePathForAsset(backend, relPath) {
-  const normalized = relPath.split(path25.sep).join("/");
+  const normalized = relPath.split(path26.sep).join("/");
   if (backend.type === "filesystem") {
     return `.binary-lifecycle/mirrors/${normalized}`;
   }
@@ -24519,11 +24672,11 @@ async function stageMirror(memoryDir, newPaths, backend, assets, log2, dryRun) {
   let mirrored = 0;
   const errors = [];
   for (const relPath of newPaths) {
-    const fullPath = path25.join(memoryDir, relPath);
+    const fullPath = path26.join(memoryDir, relPath);
     try {
       const stat5 = await fsp4.stat(fullPath);
       const contentHash = await hashFile2(fullPath);
-      const ext = path25.extname(relPath);
+      const ext = path26.extname(relPath);
       const mimeType = guessMimeType(ext);
       const remotePath = remotePathForAsset(backend, relPath);
       let backendLocation = remotePath;
@@ -24674,7 +24827,7 @@ async function stageRedirect(memoryDir, assets, log2, dryRun, readMarkdownFile,
     for (const update of updates) {
       try {
         await withRawEntityPageMutation(memoryDir, update.mdPath, async () => {
-          const stateDir = path25.join(memoryDir, "state");
+          const stateDir = path26.join(memoryDir, "state");
           const kind = classifyEntityRefWritePath(memoryDir, update.mdPath);
           if (kind === "memory") {
             const idsAtWrite = historicalIdCache.get(stateDir);
@@ -24767,10 +24920,10 @@ async function countRemainingLocalReferences(memoryDir, asset, assetAbsolute, md
   return { remaining, errors };
 }
 function markdownReferencePattern(asset, assetAbsolute, mdPath) {
-  const mdDir = path25.dirname(mdPath);
+  const mdDir = path26.dirname(mdPath);
   const candidates = /* @__PURE__ */ new Set();
   const addCandidate = (candidate) => {
-    const normalized = candidate.split(path25.sep).join("/");
+    const normalized = candidate.split(path26.sep).join("/");
     if (normalized.length === 0) return;
     candidates.add(normalized);
     const isParentTraversal = normalized === ".." || normalized.startsWith("../");
@@ -24778,10 +24931,10 @@ function markdownReferencePattern(asset, assetAbsolute, mdPath) {
       candidates.add(`./${normalized}`);
     }
   };
-  addCandidate(path25.relative(mdDir, assetAbsolute));
-  const originalPath = asset.originalPath.split(path25.sep).join("/");
-  const originalAsFileRelative = path25.resolve(mdDir, ...originalPath.split("/"));
-  if (path25.resolve(originalAsFileRelative) === path25.resolve(assetAbsolute)) {
+  addCandidate(path26.relative(mdDir, assetAbsolute));
+  const originalPath = asset.originalPath.split(path26.sep).join("/");
+  const originalAsFileRelative = path26.resolve(mdDir, ...originalPath.split("/"));
+  if (path26.resolve(originalAsFileRelative) === path26.resolve(assetAbsolute)) {
     addCandidate(originalPath);
   }
   addCandidate(`/${originalPath}`);
@@ -24877,7 +25030,7 @@ async function findMarkdownFiles(dir) {
       return;
     }
     for (const entry of entries) {
-      const full = path25.join(current, entry.name);
+      const full = path26.join(current, entry.name);
       if (entry.isDirectory()) {
         if (entry.name === ".binary-lifecycle") continue;
         await walk(full);
@@ -24952,7 +25105,7 @@ async function runBinaryLifecyclePipeline(memoryDir, config, backend, log2, opts
 
 // src/projection/index.ts
 import fs from "fs";
-import path26 from "path";
+import path27 from "path";
 var VALID_PROJECTION_CATEGORIES = new Set(ALL_CATEGORY_KEYS);
 async function generateContextTree(options) {
   const startTime = Date.now();
@@ -24967,8 +25120,8 @@ async function generateContextTree(options) {
   let nodesGenerated = 0;
   let nodesSkipped = 0;
   const categoryCounts = {};
-  const resolvedMemoryDir = path26.resolve(memoryDir);
-  const resolvedOutputDir = path26.resolve(outputDir);
+  const resolvedMemoryDir = path27.resolve(memoryDir);
+  const resolvedOutputDir = path27.resolve(outputDir);
   const requestedCategories = validateProjectionCategories(filterCategories);
   const realMemoryDir = assertSafeMemoryRoot(resolvedMemoryDir);
   assertNotSymlink(resolvedOutputDir, "context tree outputDir");
@@ -25006,7 +25159,7 @@ async function generateContextTree(options) {
     }
   }
   if (includeEntities) {
-    const entitiesDir = path26.join(memoryDir, "entities");
+    const entitiesDir = path27.join(memoryDir, "entities");
     if (fs.existsSync(entitiesDir)) {
       assertSafeInputRoot(realMemoryDir, entitiesDir, "entities root");
       categoryCounts["entity"] = 0;
@@ -25018,7 +25171,7 @@ async function generateContextTree(options) {
           continue;
         }
         const content = fs.readFileSync(filePath, "utf8");
-        const fileName = path26.basename(filePath, ".md");
+        const fileName = path27.basename(filePath, ".md");
         const node = projectEntityNode(fileName, content);
         const outputPath = resolveContainedOutputPath(realOutputDir, "entities", `${fileName}.md`);
         writeProjectedContent(realOutputDir, outputPath, node.content);
@@ -25030,7 +25183,7 @@ async function generateContextTree(options) {
   }
   const shouldIncludeQuestions = includeQuestions && (requestedCategories === void 0 || requestedCategories.includes("question"));
   if (shouldIncludeQuestions) {
-    const questionsDir = path26.join(memoryDir, "questions");
+    const questionsDir = path27.join(memoryDir, "questions");
     if (fs.existsSync(questionsDir)) {
       assertSafeInputRoot(realMemoryDir, questionsDir, "questions root");
       categoryCounts["question"] = 0;
@@ -25071,8 +25224,8 @@ async function generateContextTree(options) {
   };
 }
 function isPathInside(root, candidate) {
-  const relative = path26.relative(root, candidate);
-  return relative === "" || !relative.startsWith("..") && !path26.isAbsolute(relative);
+  const relative = path27.relative(root, candidate);
+  return relative === "" || !relative.startsWith("..") && !path27.isAbsolute(relative);
 }
 function assertNotSymlink(targetPath, label) {
   try {
@@ -25109,12 +25262,12 @@ function assertSafeInputRoot(realMemoryDir, targetPath, label) {
 }
 function assertSafeOutputTarget(realOutputDir, outputPath) {
   let current = realOutputDir;
-  const relative = path26.relative(realOutputDir, outputPath);
-  if (relative.startsWith("..") || path26.isAbsolute(relative)) {
+  const relative = path27.relative(realOutputDir, outputPath);
+  if (relative.startsWith("..") || path27.isAbsolute(relative)) {
     throw new Error(`context tree output path escapes outputDir: ${outputPath}`);
   }
-  for (const segment of relative.split(path26.sep).filter(Boolean)) {
-    current = path26.join(current, segment);
+  for (const segment of relative.split(path27.sep).filter(Boolean)) {
+    current = path27.join(current, segment);
     try {
       const stat5 = fs.lstatSync(current);
       if (stat5.isSymbolicLink()) {
@@ -25144,17 +25297,17 @@ function validateProjectionCategories(categories) {
   return validated;
 }
 function resolveContainedOutputPath(outputRoot, ...segments) {
-  const resolved = path26.resolve(outputRoot, ...segments);
-  const relative = path26.relative(outputRoot, resolved);
-  if (relative === "" || !relative.startsWith("..") && !path26.isAbsolute(relative)) {
+  const resolved = path27.resolve(outputRoot, ...segments);
+  const relative = path27.relative(outputRoot, resolved);
+  if (relative === "" || !relative.startsWith("..") && !path27.isAbsolute(relative)) {
     return resolved;
   }
   throw new Error(`context tree output path escapes outputDir: ${segments.join("/")}`);
 }
 function writeProjectedContent(realOutputDir, outputPath, generatedContent) {
   assertSafeOutputTarget(realOutputDir, outputPath);
-  fs.mkdirSync(path26.dirname(outputPath), { recursive: true });
-  const realParent = fs.realpathSync(path26.dirname(outputPath));
+  fs.mkdirSync(path27.dirname(outputPath), { recursive: true });
+  const realParent = fs.realpathSync(path27.dirname(outputPath));
   if (!isPathInside(realOutputDir, realParent)) {
     throw new Error(`context tree output path escapes outputDir: ${outputPath}`);
   }
@@ -25193,7 +25346,7 @@ function walkR(dir, realMemoryDir) {
   const results = [];
   function walk(directory) {
     for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-      const fullPath = path26.join(directory, entry.name);
+      const fullPath = path27.join(directory, entry.name);
       if (entry.isSymbolicLink()) {
         throw new Error(`context tree input path contains symlink: ${fullPath}`);
       }
@@ -25246,13 +25399,13 @@ function extractBody(content) {
 }
 function projectNode(filePath, category, fm, rawContent) {
   const body = extractBody(rawContent);
-  const fileName = path26.basename(filePath, ".md");
-  const dateDir = path26.basename(path26.dirname(filePath));
+  const fileName = path27.basename(filePath, ".md");
+  const dateDir = path27.basename(path27.dirname(filePath));
   let relPath;
   if (/^\d{4}-\d{2}-\d{2}$/.test(dateDir)) {
-    relPath = path26.join(category, dateDir, `${fileName}.md`);
+    relPath = path27.join(category, dateDir, `${fileName}.md`);
   } else {
-    relPath = path26.join(category, `${fileName}.md`);
+    relPath = path27.join(category, `${fileName}.md`);
   }
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const md = `# ${fm.id}
@@ -25298,7 +25451,7 @@ function projectEntityNode(fileName, content) {
 ${content}
 `;
   return {
-    path: path26.join("entities", `${fileName}.md`),
+    path: path27.join("entities", `${fileName}.md`),
     category: "entity",
     title: fileName,
     content: md,
@@ -25351,7 +25504,7 @@ function generateIndex(categoryCounts, outputDir) {
 
 // src/onboarding/index.ts
 import fs2 from "fs";
-import path27 from "path";
+import path28 from "path";
 var LANGUAGE_RULES = [
   {
     language: "TypeScript",
@@ -25453,7 +25606,7 @@ function onboard(options) {
     maxDepth = 6,
     excludeDirs = []
   } = options;
-  const directory = path27.resolve(options.directory ?? process.cwd());
+  const directory = path28.resolve(options.directory ?? process.cwd());
   let rootStat;
   try {
     rootStat = fs2.statSync(directory);
@@ -25495,7 +25648,7 @@ function walkDir(root, exclude, maxDepth) {
     }
     for (const entry of entries) {
       if (exclude.has(entry.name)) continue;
-      const fullPath = path27.join(dir, entry.name);
+      const fullPath = path28.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(fullPath, depth + 1);
       } else if (entry.isFile()) {
@@ -25510,11 +25663,11 @@ function detectLanguages(files, root) {
   const results = [];
   const extCounts = /* @__PURE__ */ new Map();
   for (const f of files) {
-    const ext = path27.extname(f).toLowerCase();
+    const ext = path28.extname(f).toLowerCase();
     if (ext) extCounts.set(ext, (extCounts.get(ext) ?? 0) + 1);
   }
   const rootFiles = new Set(
-    files.filter((f) => path27.dirname(f) === root).map((f) => path27.basename(f))
+    files.filter((f) => path28.dirname(f) === root).map((f) => path28.basename(f))
   );
   for (const rule of LANGUAGE_RULES) {
     const evidence = [];
@@ -25558,7 +25711,7 @@ function detectLanguages(files, root) {
 }
 function detectShape(files, root) {
   const rootFiles = new Set(
-    files.filter((f) => path27.dirname(f) === root).map((f) => path27.basename(f))
+    files.filter((f) => path28.dirname(f) === root).map((f) => path28.basename(f))
   );
   const rootDirs = /* @__PURE__ */ new Set();
   try {
@@ -25569,7 +25722,7 @@ function detectShape(files, root) {
   }
   const evidence = [];
   if (rootFiles.has("package.json")) {
-    const pkg = readJsonSafe(path27.join(root, "package.json"));
+    const pkg = readJsonSafe(path28.join(root, "package.json"));
     if (pkg?.workspaces) {
       evidence.push("package.json has workspaces");
       return { shape: "monorepo", evidence };
@@ -25583,13 +25736,13 @@ function detectShape(files, root) {
     evidence.push("workspace manifest found");
     return { shape: "workspace", evidence };
   }
-  const cargoToml = readTomlWorkspace(path27.join(root, "Cargo.toml"));
+  const cargoToml = readTomlWorkspace(path28.join(root, "Cargo.toml"));
   if (cargoToml) {
     evidence.push("Cargo.toml has workspace");
     return { shape: "workspace", evidence };
   }
   if (rootFiles.has("package.json")) {
-    const pkg = readJsonSafe(path27.join(root, "package.json"));
+    const pkg = readJsonSafe(path28.join(root, "package.json"));
     if (pkg?.exports || pkg?.main) {
       if (pkg?.bin) {
         evidence.push("package.json has bin");
@@ -25623,8 +25776,8 @@ function discoverDocs(files, root) {
     { pattern: /^\.editorconfig$/i, kind: "config" }
   ];
   for (const filePath of files) {
-    const basename = path27.basename(filePath).toLowerCase();
-    const relPath = path27.relative(root, filePath);
+    const basename = path28.basename(filePath).toLowerCase();
+    const relPath = path28.relative(root, filePath);
     let kind;
     for (const { pattern, kind: k } of docPatterns) {
       if (pattern.test(basename)) {
@@ -25636,7 +25789,7 @@ function discoverDocs(files, root) {
       kind = "docs";
     }
     if (!kind && (basename.endsWith(".md") || basename.endsWith(".mdx"))) {
-      if (path27.dirname(relPath) === "." || isUnderDocsDir(relPath)) {
+      if (path28.dirname(relPath) === "." || isUnderDocsDir(relPath)) {
         kind = "docs";
       }
     }
@@ -25657,7 +25810,7 @@ function discoverDocs(files, root) {
   return docs;
 }
 function isUnderDocsDir(relPath) {
-  const parts = relPath.split(path27.sep);
+  const parts = relPath.split(path28.sep);
   return parts[0] === "docs" || parts[0] === "doc" || parts[0] === "documentation";
 }
 function buildPlan(languages, shape, docs, _root) {
@@ -25701,7 +25854,7 @@ function readTomlWorkspace(filePath) {
 
 // src/curation/index.ts
 import fs3 from "fs";
-import path28 from "path";
+import path29 from "path";
 import crypto4 from "crypto";
 async function curate(options) {
   const startTime = Date.now();
@@ -25792,12 +25945,12 @@ function resolveTargets(targetPath) {
   const extensions = /* @__PURE__ */ new Set([".md", ".txt", ".mdx", ".rst"]);
   function walk(dir) {
     for (const entry of fs3.readdirSync(dir, { withFileTypes: true })) {
-      const fullPath = path28.join(dir, entry.name);
+      const fullPath = path29.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (entry.name !== "node_modules" && entry.name !== ".git") {
           walk(fullPath);
         }
-      } else if (extensions.has(path28.extname(entry.name).toLowerCase())) {
+      } else if (extensions.has(path29.extname(entry.name).toLowerCase())) {
         results.push(fullPath);
       }
     }
@@ -25806,12 +25959,12 @@ function resolveTargets(targetPath) {
   return results;
 }
 function resolveProvenanceRoot(targetPath) {
-  const resolvedTarget = path28.resolve(targetPath);
+  const resolvedTarget = path29.resolve(targetPath);
   const stat5 = fs3.statSync(resolvedTarget);
-  return stat5.isFile() ? path28.dirname(resolvedTarget) : resolvedTarget;
+  return stat5.isFile() ? path29.dirname(resolvedTarget) : resolvedTarget;
 }
 function extractStatements(content, filePath, projectRoot, source, sourceFileHash, categoryOverride, confidence, entityRef, tags) {
-  const relativePath = path28.relative(projectRoot, path28.resolve(filePath)) || path28.basename(filePath);
+  const relativePath = path29.relative(projectRoot, path29.resolve(filePath)) || path29.basename(filePath);
   const statements = [];
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const paragraphs = content.split(/\n{2,}/).map((p) => p.trim()).filter((p) => p.length > 20 && p.length < 2e3);
@@ -25905,7 +26058,7 @@ function loadExistingMemories(memoryDir) {
   if (!fs3.existsSync(memoryDir)) return result;
   const dirs = ALL_CATEGORY_DIRS;
   for (const dir of dirs) {
-    const fullDir = path28.join(memoryDir, dir);
+    const fullDir = path29.join(memoryDir, dir);
     if (!fs3.existsSync(fullDir)) continue;
     walkFiles(fullDir, (filePath) => {
       const content = readFileSafe(filePath);
@@ -25928,11 +26081,11 @@ function writeStatement(stmt, memoryDir) {
   const now = /* @__PURE__ */ new Date();
   const dateDir = now.toISOString().split("T")[0];
   const categoryDir = getCategoryDir(memoryDir, stmt.category);
-  const dir = path28.join(categoryDir, dateDir);
+  const dir = path29.join(categoryDir, dateDir);
   fs3.mkdirSync(dir, { recursive: true });
   const fileName = `${stmt.category}-${Date.now()}-${stmt.id.slice(0, 8)}.md`;
-  const filePath = path28.join(dir, fileName);
-  const historicalIds = historicalIdCache2.get(path28.join(memoryDir, "state"));
+  const filePath = path29.join(dir, fileName);
+  const historicalIds = historicalIdCache2.get(path29.join(memoryDir, "state"));
   const rawBody = `${[
     "---",
     `id: ${stmt.id}`,
@@ -25955,7 +26108,7 @@ ${stmt.content}
   fs3.writeFileSync(filePath, body);
   try {
     repairContentAfterJournalMoveSync({
-      stateDir: path28.join(memoryDir, "state"),
+      stateDir: path29.join(memoryDir, "state"),
       cache: historicalIdCache2,
       idsAtWrite: historicalIds,
       rawContent: rawBody,
@@ -26016,7 +26169,7 @@ function extractBody2(content) {
 }
 function walkFiles(dir, callback) {
   for (const entry of fs3.readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = path28.join(dir, entry.name);
+    const fullPath = path29.join(dir, entry.name);
     if (entry.isDirectory()) {
       walkFiles(fullPath, callback);
     } else if (entry.name.endsWith(".md")) {
@@ -26028,7 +26181,7 @@ function walkFiles(dir, callback) {
 // src/dedup/index.ts
 import crypto5 from "crypto";
 import fs4 from "fs";
-import path29 from "path";
+import path30 from "path";
 var DEFAULT_DEDUP_THRESHOLD = 0.85;
 var DEFAULT_MAX_LOAD = 1e4;
 function normalizeThreshold(value, defaultValue) {
@@ -26235,7 +26388,7 @@ function loadMemories(memoryDir, categories, maxLoad = 1e4) {
   const memoryRootReal = fs4.realpathSync(memoryDir);
   for (const category of allCategories) {
     if (result.length >= maxLoad) break;
-    const dir = path29.join(memoryDir, category);
+    const dir = path30.join(memoryDir, category);
     if (!fs4.existsSync(dir)) continue;
     const categoryStat = fs4.lstatSync(dir);
     if (categoryStat.isSymbolicLink()) {
@@ -26296,15 +26449,15 @@ function extractBody3(content) {
   return match ? match[1].trim() : content.trim();
 }
 function assertPathInsideRoot2(rootReal, targetReal, sourcePath) {
-  const rel = path29.relative(rootReal, targetReal);
-  if (rel === "" || !rel.startsWith("..") && !path29.isAbsolute(rel)) {
+  const rel = path30.relative(rootReal, targetReal);
+  if (rel === "" || !rel.startsWith("..") && !path30.isAbsolute(rel)) {
     return;
   }
   throw new Error(`Refusing to scan memory path outside root: ${sourcePath}`);
 }
 function walkMdFiles(dir, memoryRootReal, categoryRootReal, callback) {
   for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = path29.join(dir, entry.name);
+    const fullPath = path30.join(dir, entry.name);
     const entryStat = fs4.lstatSync(fullPath);
     if (entryStat.isSymbolicLink()) {
       throw new Error(`Refusing to scan symlinked memory path: ${fullPath}`);
@@ -26322,7 +26475,7 @@ function walkMdFiles(dir, memoryRootReal, categoryRootReal, callback) {
 
 // src/sync/index.ts
 import fs5 from "fs";
-import path30 from "path";
+import path31 from "path";
 import crypto6 from "crypto";
 var DEFAULT_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".txt", ".mdx", ".rst"]);
 var DEFAULT_EXCLUDE2 = /* @__PURE__ */ new Set([
@@ -26344,7 +26497,7 @@ function syncChanges(options) {
   } = options;
   const extSet = new Set(extensions);
   const excludeSet = /* @__PURE__ */ new Set([...DEFAULT_EXCLUDE2, ...excludeDirs]);
-  const stateFilePath = options.stateFile ?? path30.join(memoryDir, ".sync-state.json");
+  const stateFilePath = options.stateFile ?? path31.join(memoryDir, ".sync-state.json");
   const prevState = loadState(stateFilePath);
   const currentFiles = scanFiles(sourceDir, extSet, excludeSet);
   const changes = computeDiff(currentFiles, prevState.fileHashes, sourceDir);
@@ -26360,7 +26513,7 @@ function syncChanges(options) {
     for (const [relPath, hash] of Object.entries(currentFiles)) {
       newState.fileHashes[relPath] = hash;
     }
-    fs5.mkdirSync(path30.dirname(stateFilePath), { recursive: true });
+    fs5.mkdirSync(path31.dirname(stateFilePath), { recursive: true });
     fs5.writeFileSync(stateFilePath, JSON.stringify(newState, null, 2));
   }
   return {
@@ -26426,13 +26579,13 @@ function scanFiles(root, extensions, exclude) {
     }
     for (const entry of entries) {
       if (exclude.has(entry.name)) continue;
-      const fullPath = path30.join(dir, entry.name);
+      const fullPath = path31.join(dir, entry.name);
       if (entry.isDirectory()) {
         walk(fullPath);
       } else if (entry.isFile()) {
-        const ext = path30.extname(entry.name).toLowerCase();
+        const ext = path31.extname(entry.name).toLowerCase();
         if (!extensions.has(ext)) continue;
-        const relPath = path30.relative(root, fullPath);
+        const relPath = path31.relative(root, fullPath);
         try {
           const content = fs5.readFileSync(fullPath, "utf8");
           result[relPath] = hashContent3(content);
@@ -26447,7 +26600,7 @@ function scanFiles(root, extensions, exclude) {
 function computeDiff(current, previous, sourceDir) {
   const changes = [];
   for (const [relPath, hash] of Object.entries(current)) {
-    const fullPath = path30.join(sourceDir, relPath);
+    const fullPath = path31.join(sourceDir, relPath);
     if (!(relPath in previous)) {
       let size = 0;
       try {
@@ -26480,7 +26633,7 @@ function computeDiff(current, previous, sourceDir) {
   for (const relPath of Object.keys(previous)) {
     if (!(relPath in current)) {
       changes.push({
-        filePath: path30.join(sourceDir, relPath),
+        filePath: path31.join(sourceDir, relPath),
         relativePath: relPath,
         type: "deleted",
         currentHash: "",
@@ -26510,21 +26663,21 @@ function hashContent3(content) {
 import { spawnSync } from "child_process";
 import crypto7 from "crypto";
 import fs6 from "fs";
-import path31 from "path";
+import path32 from "path";
 var historicalIdCache3 = new HistoricalEntityCanonicalIdCache();
 var MANIFEST_VERSION = 1;
 var MANIFEST_LOCK_STALE_MS = 3e4;
 var MANIFEST_LOCK_TIMEOUT_MS = MANIFEST_LOCK_STALE_MS + 1e4;
 var MANIFEST_LOCK_SLEEP_MS = 20;
 function normalizeSpaceMemoryDir(memoryDir) {
-  return path31.resolve(memoryDir);
+  return path32.resolve(memoryDir);
 }
 function getSpacesDir(baseDir) {
   const homeDir = baseDir ?? resolveHomeDir();
-  return path31.join(homeDir, ".config", "engram", "spaces");
+  return path32.join(homeDir, ".config", "engram", "spaces");
 }
 function getManifestPath(baseDir) {
-  return path31.join(getSpacesDir(baseDir), "manifest.json");
+  return path32.join(getSpacesDir(baseDir), "manifest.json");
 }
 function loadManifest(baseDir, memoryDirOverride) {
   if (fs6.existsSync(getManifestPath(baseDir))) {
@@ -26571,9 +26724,9 @@ function readManifestUnlocked(baseDir, memoryDirOverride, options = {}) {
 }
 function saveManifestUnlocked(manifest, baseDir) {
   const manifestPath2 = getManifestPath(baseDir);
-  const manifestDir2 = path31.dirname(manifestPath2);
+  const manifestDir2 = path32.dirname(manifestPath2);
   fs6.mkdirSync(manifestDir2, { recursive: true });
-  const tempPath = path31.join(manifestDir2, `.manifest.${process.pid}.${Date.now()}.${crypto7.randomUUID()}.tmp`);
+  const tempPath = path32.join(manifestDir2, `.manifest.${process.pid}.${Date.now()}.${crypto7.randomUUID()}.tmp`);
   try {
     fs6.writeFileSync(tempPath, `${JSON.stringify(manifest, null, 2)}
 `, { flag: "wx" });
@@ -26588,7 +26741,7 @@ function saveManifestUnlocked(manifest, baseDir) {
 }
 function withManifestLock(baseDir, operation) {
   const lockDir = `${getManifestPath(baseDir)}.lock`;
-  fs6.mkdirSync(path31.dirname(lockDir), { recursive: true });
+  fs6.mkdirSync(path32.dirname(lockDir), { recursive: true });
   const lockOwner = acquireManifestLock(lockDir);
   try {
     return operation();
@@ -26614,7 +26767,7 @@ function acquireManifestLock(lockDir) {
     try {
       fs6.mkdirSync(lockDir, { recursive: false });
       try {
-        fs6.writeFileSync(path31.join(lockDir, "owner"), `${owner}
+        fs6.writeFileSync(path32.join(lockDir, "owner"), `${owner}
 `, { flag: "wx" });
       } catch (error) {
         fs6.rmSync(lockDir, { recursive: true, force: true });
@@ -26644,7 +26797,7 @@ function acquireManifestLock(lockDir) {
 }
 function releaseManifestLock(lockDir, owner) {
   try {
-    const ownerPath = path31.join(lockDir, "owner");
+    const ownerPath = path32.join(lockDir, "owner");
     if (fs6.readFileSync(ownerPath, "utf8").trim() === owner) {
       fs6.rmSync(lockDir, { recursive: true, force: true });
     }
@@ -26660,7 +26813,7 @@ function removeStaleManifestLock(lockDir) {
   try {
     fs6.mkdirSync(reclaimDir, { recursive: false });
     try {
-      fs6.writeFileSync(path31.join(reclaimDir, "owner"), `${reclaimOwner}
+      fs6.writeFileSync(path32.join(reclaimDir, "owner"), `${reclaimOwner}
 `, { flag: "wx" });
     } catch (error) {
       fs6.rmSync(reclaimDir, { recursive: true, force: true });
@@ -26735,7 +26888,7 @@ function readManifestLockSnapshot(lockDir) {
     throw error;
   }
   try {
-    const owner = fs6.readFileSync(path31.join(lockDir, "owner"), "utf8").trim();
+    const owner = fs6.readFileSync(path32.join(lockDir, "owner"), "utf8").trim();
     return { mtimeMs: stat5.mtimeMs, owner };
   } catch (error) {
     if (error.code === "ENOENT") {
@@ -26807,8 +26960,8 @@ function sleepSync(ms) {
 }
 function createPersonalSpace(baseDir, memoryDirOverride) {
   const homeDir = baseDir ?? resolveHomeDir();
-  const standalonePath = path31.join(homeDir, ".engram", "memory");
-  const openclawPath = path31.join(homeDir, ".openclaw", "workspace", "memory", "local");
+  const standalonePath = path32.join(homeDir, ".engram", "memory");
+  const openclawPath = path32.join(homeDir, ".openclaw", "workspace", "memory", "local");
   const memoryDir = memoryDirOverride ?? readEnvVar("REMNIC_MEMORY_DIR") ?? readEnvVar("ENGRAM_MEMORY_DIR") ?? (fs6.existsSync(standalonePath) ? standalonePath : fs6.existsSync(openclawPath) ? openclawPath : standalonePath);
   const normalizedMemoryDir = normalizeSpaceMemoryDir(memoryDir);
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -26837,7 +26990,7 @@ function createSpace(options) {
   const id = options.name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-");
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const memoryDir = normalizeSpaceMemoryDir(
-    options.memoryDir ?? path31.join(getSpacesDir(options.baseDir), id, "memory")
+    options.memoryDir ?? path32.join(getSpacesDir(options.baseDir), id, "memory")
   );
   const space = updateManifest(options.baseDir, (manifest) => {
     if (manifest.spaces.some((s) => s.id === id)) {
@@ -27083,14 +27236,14 @@ async function mergeSpaces(sourceSpaceId, targetSpaceId, options) {
   };
 }
 function getAuditLog(baseDir) {
-  const auditPath = path31.join(getSpacesDir(baseDir), "audit.jsonl");
+  const auditPath = path32.join(getSpacesDir(baseDir), "audit.jsonl");
   if (!fs6.existsSync(auditPath)) return [];
   const lines = fs6.readFileSync(auditPath, "utf8").trim().split("\n");
   return lines.filter((l) => l.trim()).map((l) => JSON.parse(l));
 }
 function appendAudit(entry, baseDir) {
-  const auditPath = path31.join(getSpacesDir(baseDir), "audit.jsonl");
-  fs6.mkdirSync(path31.dirname(auditPath), { recursive: true });
+  const auditPath = path32.join(getSpacesDir(baseDir), "audit.jsonl");
+  fs6.mkdirSync(path32.dirname(auditPath), { recursive: true });
   const full = {
     id: crypto7.randomUUID(),
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -27111,11 +27264,11 @@ async function copyMemories(sourceDir, targetDir, options) {
     sourceFiles.filter((p) => {
       const rp = safeRealpath(p);
       if (!rp || !isPathInsideRoot(rp, sourceRoot)) return false;
-      const rel = path31.relative(sourceRoot, rp);
-      const mapped = path31.resolve(targetRoot, rel);
+      const rel = path32.relative(sourceRoot, rp);
+      const mapped = path32.resolve(targetRoot, rel);
       if (!isPathInsideRoot(mapped, targetRoot)) return false;
       return classifyEntityRefWritePath(targetRoot, mapped) === "entity";
-    }).map((p) => path31.basename(p, ".md"))
+    }).map((p) => path32.basename(p, ".md"))
   );
   const firstEntityId = sourceEntityIds.values().next().value;
   if (firstEntityId === void 0) {
@@ -27123,7 +27276,7 @@ async function copyMemories(sourceDir, targetDir, options) {
   }
   return withRawEntityPageMutation(
     targetRoot,
-    path31.join(targetRoot, "entities", `${firstEntityId}.md`),
+    path32.join(targetRoot, "entities", `${firstEntityId}.md`),
     async () => copyPreparedMemories(
       sourceFiles,
       sourceRoot,
@@ -27150,14 +27303,14 @@ function copyPreparedMemories(sourceFiles, sourceRoot, targetRoot, sourceEntityI
       continue;
     }
     const content = fs6.readFileSync(sourcePath, "utf8");
-    const relativePath = path31.relative(sourceRoot, sourceRealPath);
-    const targetPath = path31.resolve(targetRoot, relativePath);
+    const relativePath = path32.relative(sourceRoot, sourceRealPath);
+    const targetPath = path32.resolve(targetRoot, relativePath);
     if (!isPathInsideRoot(targetPath, targetRoot)) {
       skipped++;
       continue;
     }
     const targetKind = classifyEntityRefWritePath(targetRoot, targetPath);
-    const idsAtCompare = historicalIdCache3.get(path31.join(targetRoot, "state"));
+    const idsAtCompare = historicalIdCache3.get(path32.join(targetRoot, "state"));
     const sourceRef = targetKind === "memory" ? readEntityRefFromFrontmatter(content) : null;
     const refHasSourceClaimant = sourceRef !== null && sourceEntityIds.has(sourceRef);
     const canonicalContent = targetKind === "memory" && !refHasSourceClaimant ? canonicalizeEntityRefFrontmatter(content, idsAtCompare) : content;
@@ -27184,7 +27337,7 @@ function copyPreparedMemories(sourceFiles, sourceRoot, targetRoot, sourceEntityI
     if (fs6.existsSync(targetPath) && !options?.force) {
       const targetContent = fs6.readFileSync(targetPath, "utf8");
       const targetHash = hashContent4(targetContent);
-      if (hashContent4(canonicalContent) === targetHash && historicalIdCache3.get(path31.join(targetRoot, "state")) === idsAtCompare) {
+      if (hashContent4(canonicalContent) === targetHash && historicalIdCache3.get(path32.join(targetRoot, "state")) === idsAtCompare) {
         skipped++;
         continue;
       }
@@ -27200,13 +27353,13 @@ function copyPreparedMemories(sourceFiles, sourceRoot, targetRoot, sourceEntityI
         continue;
       }
     }
-    fs6.mkdirSync(path31.dirname(targetPath), { recursive: true });
-    const targetParentRealPath = safeRealpath(path31.dirname(targetPath));
+    fs6.mkdirSync(path32.dirname(targetPath), { recursive: true });
+    const targetParentRealPath = safeRealpath(path32.dirname(targetPath));
     if (!targetParentRealPath || !isPathInsideRoot(targetParentRealPath, targetRoot)) {
       skipped++;
       continue;
     }
-    const stateDir = path31.join(targetRoot, "state");
+    const stateDir = path32.join(targetRoot, "state");
     if (targetKind === "memory" && !refHasSourceClaimant) {
       const idsAtWrite = historicalIdCache3.get(stateDir);
       const written = canonicalizeEntityRefFrontmatter(content, idsAtWrite);
@@ -27250,7 +27403,7 @@ function copyPreparedMemories(sourceFiles, sourceRoot, targetRoot, sourceEntityI
     bumpMemoryCorpusVersionForDir(targetRoot);
   }
   if (reconcileNeeded) {
-    requestEntityCanonicalIdReconcileSync(path31.join(targetRoot, "state"));
+    requestEntityCanonicalIdReconcileSync(path32.join(targetRoot, "state"));
   }
   return { merged, conflicts, skipped };
 }
@@ -27261,7 +27414,7 @@ function walkMd(dir) {
   const results = [];
   function walk(d) {
     for (const entry of fs6.readdirSync(d, { withFileTypes: true })) {
-      const fullPath = path31.join(d, entry.name);
+      const fullPath = path32.join(d, entry.name);
       if (entry.isSymbolicLink()) {
         continue;
       }
@@ -27290,8 +27443,8 @@ function safeRealpath(filePath) {
   }
 }
 function isPathInsideRoot(candidatePath, rootPath) {
-  const relative = path31.relative(rootPath, candidatePath);
-  return relative === "" || !relative.startsWith("..") && !path31.isAbsolute(relative);
+  const relative = path32.relative(rootPath, candidatePath);
+  return relative === "" || !relative.startsWith("..") && !path32.isAbsolute(relative);
 }
 function parseSimpleFrontmatter(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
@@ -27412,7 +27565,7 @@ var REMNIC_RECALL_DECISION_RULES = `## When to Use Recall vs Direct Read
 // src/memory-extension/codex-publisher.ts
 import fs7 from "fs";
 import os from "os";
-import path32 from "path";
+import path33 from "path";
 var REMNIC_EXTENSION_DIR_NAME = "remnic";
 function resolveEnvHome(env) {
   if (env === void 0) return resolveHomeDir();
@@ -27421,12 +27574,12 @@ function resolveEnvHome(env) {
 function expandTildeWithHome(input, homeDir) {
   if (input === "~") return homeDir;
   if (input.startsWith("~/") || input.startsWith("~\\")) {
-    return path32.join(homeDir, input.slice(2));
+    return path33.join(homeDir, input.slice(2));
   }
   return input;
 }
 function normalizeHostRoot(input, homeDir) {
-  return path32.resolve(expandTildeWithHome(input.trim(), homeDir));
+  return path33.resolve(expandTildeWithHome(input.trim(), homeDir));
 }
 var CodexMemoryExtensionPublisher = class {
   hostId = "codex";
@@ -27440,12 +27593,12 @@ var CodexMemoryExtensionPublisher = class {
   async resolveExtensionRoot(env) {
     const homeDir = resolveEnvHome(env);
     const codexHomeInput = env === void 0 ? readEnvVar("CODEX_HOME")?.trim() : env.CODEX_HOME?.trim();
-    const codexHome = codexHomeInput ? normalizeHostRoot(codexHomeInput, homeDir) : path32.resolve(homeDir, ".codex");
-    return path32.join(codexHome, "memories_extensions", REMNIC_EXTENSION_DIR_NAME);
+    const codexHome = codexHomeInput ? normalizeHostRoot(codexHomeInput, homeDir) : path33.resolve(homeDir, ".codex");
+    return path33.join(codexHome, "memories_extensions", REMNIC_EXTENSION_DIR_NAME);
   }
   async isHostAvailable() {
     try {
-      const home = readEnvVar("CODEX_HOME")?.trim() || path32.join(resolveHomeDir(), ".codex");
+      const home = readEnvVar("CODEX_HOME")?.trim() || path33.join(resolveHomeDir(), ".codex");
       return fs7.existsSync(home);
     } catch {
       return false;
@@ -27496,7 +27649,7 @@ When running inside the Codex phase-2 consolidation sandbox:
   }
   async publish(ctx) {
     const extensionRoot = await this.resolveExtensionRoot();
-    const instructionsPath = path32.join(extensionRoot, "instructions.md");
+    const instructionsPath = path33.join(extensionRoot, "instructions.md");
     const filesWritten = [];
     const skipped = [];
     ctx.log.info(`Publishing Codex memory extension to ${extensionRoot}`);
@@ -28128,9 +28281,9 @@ function buildWeeklyActivitySummary(cards, options) {
 // src/activity/timeline/weekly-persist.ts
 import { randomBytes as randomBytes3 } from "crypto";
 import { mkdirSync, readFileSync as readFileSync2, renameSync, unlinkSync, writeFileSync } from "fs";
-import path33 from "path";
+import path34 from "path";
 var WEEKLY_SNAPSHOT_FORMAT_VERSION = 1;
-var WEEKLY_SNAPSHOT_DIR = path33.join("activity", "weekly");
+var WEEKLY_SNAPSHOT_DIR = path34.join("activity", "weekly");
 function requireToken(value, name) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new TypeError(`${name} must be a non-empty string`);
@@ -28153,8 +28306,8 @@ function weeklySnapshotPath(input) {
   const identity = hashActivityBody(
     `${input.summary.weekStartUtc}\0${input.summary.weekEndUtc}\0${sourceRevision}\0${configHash}`
   );
-  return path33.join(
-    path33.resolve(memoryDir),
+  return path34.join(
+    path34.resolve(memoryDir),
     WEEKLY_SNAPSHOT_DIR,
     namespaceIdentityToken(namespace),
     `${weekDate}--${identity}.json`
@@ -28184,7 +28337,7 @@ function persistWeeklySnapshot(input) {
       throw error;
     }
   }
-  mkdirSync(path33.dirname(filePath), { recursive: true, mode: 448 });
+  mkdirSync(path34.dirname(filePath), { recursive: true, mode: 448 });
   const tmpPath = `${filePath}.${process.pid}.${randomBytes3(8).toString("hex")}.tmp`;
   writeFileSync(tmpPath, text, { encoding: "utf8", mode: 384 });
   try {
@@ -28689,7 +28842,7 @@ function selectRecapForDay(input) {
 
 // src/activity/journal-read.ts
 import { closeSync, constants as fsConstants, fstatSync, lstatSync, openSync, readFileSync as readFileSync3, realpathSync, statSync as statSync2 } from "fs";
-import path34 from "path";
+import path35 from "path";
 
 // src/activity/journal-section.ts
 function parseAtxHeading(line) {
@@ -28880,8 +29033,8 @@ function readJournalForDate(input) {
   const relative = resolveVaultNotePath(input.vault.dailyNotePath, input.date, {
     timezone: input.timezone
   });
-  const root = path34.resolve(expandTildePath(input.vault.vaultPath));
-  const filePath = path34.join(root, relative);
+  const root = path35.resolve(expandTildePath(input.vault.vaultPath));
+  const filePath = path35.join(root, relative);
   try {
     const rootStat = lstatSync(root);
     if (rootStat.isSymbolicLink() || !rootStat.isDirectory()) {
@@ -28890,8 +29043,8 @@ function readJournalForDate(input) {
   } catch {
     return { ok: true, exists: false, reason: "missing_file", filePath };
   }
-  const lexical = path34.relative(root, filePath);
-  if (lexical.length === 0 || lexical === ".." || lexical.startsWith(`..${path34.sep}`) || path34.isAbsolute(lexical)) {
+  const lexical = path35.relative(root, filePath);
+  if (lexical.length === 0 || lexical === ".." || lexical.startsWith(`..${path35.sep}`) || path35.isAbsolute(lexical)) {
     return { ok: false, reason: "path_escape", filePath };
   }
   if (!containedBySymlinks(root, filePath)) {
@@ -28924,11 +29077,11 @@ function containedBySymlinks(root, dest) {
     try {
       if (statSync2(probe).isFile() || statSync2(probe).isDirectory()) {
         const real = realpathSync(probe);
-        return real === realRoot || real.startsWith(`${realRoot}${path34.sep}`);
+        return real === realRoot || real.startsWith(`${realRoot}${path35.sep}`);
       }
     } catch {
     }
-    const parent = path34.dirname(probe);
+    const parent = path35.dirname(probe);
     if (parent === probe) return false;
     probe = parent;
   }
@@ -28939,15 +29092,15 @@ function symlinkRejected() {
   return err;
 }
 function readVerifiedDailyNote(root, filePath) {
-  const relative = path34.relative(root, filePath);
-  const parts = relative.split(path34.sep).filter((part) => part.length > 0 && part !== ".");
+  const relative = path35.relative(root, filePath);
+  const parts = relative.split(path35.sep).filter((part) => part.length > 0 && part !== ".");
   let cursor = root;
   for (const part of parts) {
-    cursor = path34.join(cursor, part);
+    cursor = path35.join(cursor, part);
     const st = lstatSync(cursor);
     if (st.isSymbolicLink()) throw symlinkRejected();
   }
-  const parent = path34.dirname(filePath);
+  const parent = path35.dirname(filePath);
   const parentLstat = lstatSync(parent);
   if (parentLstat.isSymbolicLink() || !parentLstat.isDirectory()) throw symlinkRejected();
   const nofollow = fsConstants.O_NOFOLLOW ?? 0;
@@ -28971,7 +29124,7 @@ function readVerifiedDailyNote(root, filePath) {
     try {
       const fdPath = realpathSync(`/proc/self/fd/${fd}`);
       const realRoot = realpathSync(root);
-      if (fdPath !== realRoot && !fdPath.startsWith(`${realRoot}${path34.sep}`)) {
+      if (fdPath !== realRoot && !fdPath.startsWith(`${realRoot}${path35.sep}`)) {
         throw symlinkRejected();
       }
     } catch (err) {
@@ -28986,11 +29139,11 @@ function readVerifiedDailyNote(root, filePath) {
 // src/activity/journal-state.ts
 import { createHash as createHash10, randomBytes as randomBytes4 } from "crypto";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, renameSync as renameSync2, writeFileSync as writeFileSync2 } from "fs";
-import path35 from "path";
+import path36 from "path";
 var STATE_DIR_NAME = "state";
 var STATE_FILE_NAME = "timeline.json";
 function timelineStatePath(memoryDir) {
-  return path35.join(memoryDir, STATE_DIR_NAME, STATE_FILE_NAME);
+  return path36.join(memoryDir, STATE_DIR_NAME, STATE_FILE_NAME);
 }
 function hashJournalText(text) {
   return createHash10("sha256").update(text, "utf8").digest("hex");
@@ -29016,14 +29169,14 @@ function readTimelineState(memoryDir) {
 }
 function writeTimelineState(memoryDir, state) {
   const filePath = timelineStatePath(memoryDir);
-  mkdirSync2(path35.dirname(filePath), { recursive: true });
+  mkdirSync2(path36.dirname(filePath), { recursive: true });
   const tempPath = `${filePath}.${process.pid}.${randomBytes4(8).toString("hex")}.tmp`;
   writeFileSync2(tempPath, `${JSON.stringify(state, null, 2)}
 `);
   renameSync2(tempPath, filePath);
 }
 function journalDateLockPath(memoryDir, date) {
-  return path35.join(memoryDir, STATE_DIR_NAME, `journal-extract-${date}.lock`);
+  return path36.join(memoryDir, STATE_DIR_NAME, `journal-extract-${date}.lock`);
 }
 function timelineStateLockPath(memoryDir) {
   return `${timelineStatePath(memoryDir)}.lock`;
@@ -29715,7 +29868,7 @@ function filterPrivacyWindow(items, options) {
 }
 
 // src/activity/vault-wikilink.ts
-import path36 from "path";
+import path37 from "path";
 function formatVaultWikilink(notePath) {
   if (typeof notePath !== "string" || notePath.trim().length === 0) {
     throw new RangeError("Vault wikilink path must be a non-empty relative path.");
@@ -29723,7 +29876,7 @@ function formatVaultWikilink(notePath) {
   if (notePath.includes("\n") || notePath.includes("\r")) {
     throw new RangeError("Vault wikilink path must not contain newlines.");
   }
-  if (path36.posix.isAbsolute(notePath) || path36.win32.isAbsolute(notePath)) {
+  if (path37.posix.isAbsolute(notePath) || path37.win32.isAbsolute(notePath)) {
     throw new RangeError("Vault wikilink path must be relative; absolute paths are rejected.");
   }
   if (notePath.split(/[\\/]/).some((segment) => segment === "..")) {
@@ -29745,7 +29898,7 @@ function stripVaultMdSuffix(notePath) {
 }
 
 // src/activity/vault-join.ts
-import path37 from "path";
+import path38 from "path";
 function joinVaultSegments(parts) {
   if (parts.length === 0) {
     throw new RangeError("Vault path parts must be a non-empty list.");
@@ -29760,7 +29913,7 @@ function joinVaultSegments(parts) {
     if (part.includes("\n") || part.includes("\r")) {
       throw new RangeError("Vault path part must not contain a newline.");
     }
-    if (path37.posix.isAbsolute(part) || path37.win32.isAbsolute(part)) {
+    if (path38.posix.isAbsolute(part) || path38.win32.isAbsolute(part)) {
       throw new RangeError("Vault path part must be relative.");
     }
     if (part.split("/").includes("..")) {
@@ -29815,7 +29968,7 @@ function planVaultDryRun(inputs) {
 // src/session-summaries/index.ts
 import { createHash as createHash11 } from "crypto";
 import { lstat as lstat3, mkdir as mkdir7, readFile as readFile9, readdir as readdir4, rename, rm, stat as stat4, writeFile as writeFile7 } from "fs/promises";
-import path38 from "path";
+import path39 from "path";
 
 // src/session-summaries/adapters.ts
 var VALID_ROLES = /* @__PURE__ */ new Set(["user", "assistant", "tool", "system", "other"]);
@@ -30320,7 +30473,7 @@ function shortHash(value, length = 16) {
 async function listTranscriptFiles(root, maxFiles) {
   const out = [];
   let truncated = false;
-  const entrySortKey = (entryName, isDirectory) => isDirectory ? `${entryName}${path38.sep}` : entryName;
+  const entrySortKey = (entryName, isDirectory) => isDirectory ? `${entryName}${path39.sep}` : entryName;
   async function visit(dir) {
     if (truncated) return;
     const entries = (await readdir4(dir, { withFileTypes: true })).sort(
@@ -30330,13 +30483,13 @@ async function listTranscriptFiles(root, maxFiles) {
       if (truncated) return;
       if (entry.name.startsWith(".")) continue;
       if (entry.isSymbolicLink()) continue;
-      const fullPath = path38.join(dir, entry.name);
+      const fullPath = path39.join(dir, entry.name);
       if (entry.isDirectory()) {
         await visit(fullPath);
         continue;
       }
       if (!entry.isFile()) continue;
-      const ext = path38.extname(entry.name).toLowerCase();
+      const ext = path39.extname(entry.name).toLowerCase();
       if (!SUPPORTED_EXTENSIONS.has(ext)) continue;
       out.push(fullPath);
       if (out.length > maxFiles) {
@@ -30363,7 +30516,7 @@ function normalizeInputDir(inputDir) {
   if (typeof inputDir !== "string" || inputDir.trim().length === 0) {
     throw new Error("inputDir must be a non-empty string");
   }
-  return path38.resolve(expandTildePath(inputDir.trim()));
+  return path39.resolve(expandTildePath(inputDir.trim()));
 }
 function initRoleCounts() {
   return {
@@ -30520,11 +30673,11 @@ async function collectLocalSessionSummaries(options) {
       continue;
     }
     seenFileHashes.add(fileHash);
-    const fileExtension = path38.extname(filePath).toLowerCase();
+    const fileExtension = path39.extname(filePath).toLowerCase();
     const parsed = await adapter.parseFile(
       {
         content,
-        fileName: path38.basename(filePath),
+        fileName: path39.basename(filePath),
         fileExtension,
         fileRef: fileHash
       },
@@ -30580,7 +30733,7 @@ async function collectLocalSessionSummaries(options) {
 }
 async function readRedactionConfig(pathLike) {
   if (!pathLike) return void 0;
-  const raw = await readFile9(path38.resolve(expandTildePath(pathLike)), "utf-8");
+  const raw = await readFile9(path39.resolve(expandTildePath(pathLike)), "utf-8");
   const parsed = JSON.parse(raw);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error("redaction config must be a JSON object");
@@ -30593,15 +30746,15 @@ function toJsonl(drafts) {
 }
 function defaultDraftOutputPath(memoryDir, generatedAt) {
   const stamp = generatedAt.replace(/[:.]/g, "-");
-  return path38.join(
-    path38.resolve(expandTildePath(memoryDir)),
+  return path39.join(
+    path39.resolve(expandTildePath(memoryDir)),
     "state",
     "session-summary-drafts",
     `session-summaries-${stamp}.jsonl`
   );
 }
 async function writeDrafts(filePath, drafts) {
-  await mkdir7(path38.dirname(filePath), { recursive: true });
+  await mkdir7(path39.dirname(filePath), { recursive: true });
   const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
   try {
     await writeFile7(tempPath, toJsonl(drafts), "utf-8");
@@ -30619,7 +30772,7 @@ async function runLocalSessionSummaryCliCommand(options) {
   });
   const wroteFiles = [];
   if (options.output) {
-    const outputPath = path38.resolve(expandTildePath(options.output));
+    const outputPath = path39.resolve(expandTildePath(options.output));
     await writeDrafts(outputPath, report.drafts);
     wroteFiles.push(outputPath);
   }
@@ -30654,19 +30807,19 @@ async function runLocalSessionSummaryCliCommand(options) {
 
 // src/transfer/capsule-fork.ts
 import { lstat as lstat4, mkdir as mkdir8, readFile as readFile10, realpath as realpath3, writeFile as writeFile8 } from "fs/promises";
-import path39 from "path";
+import path40 from "path";
 async function forkCapsule(opts) {
   validateForkId(opts.forkId);
-  const rootAbs = path39.resolve(opts.targetRoot);
+  const rootAbs = path40.resolve(opts.targetRoot);
   await assertIsDirectoryNotSymlink(rootAbs, "forkCapsule", "targetRoot");
-  const forkDirAbs = path39.join(rootAbs, "forks", opts.forkId);
+  const forkDirAbs = path40.join(rootAbs, "forks", opts.forkId);
   const forkEntryExists = await pathEntryExists(forkDirAbs);
   if (forkEntryExists) {
     throw new Error(
       `forkCapsule: fork path already exists \u2014 forkId "${opts.forkId}" is already in use at: ${forkDirAbs}`
     );
   }
-  const archiveAbs = path39.resolve(opts.sourceArchive);
+  const archiveAbs = path40.resolve(opts.sourceArchive);
   const importResult = await importCapsule({
     archivePath: archiveAbs,
     root: rootAbs,
@@ -30688,10 +30841,10 @@ async function forkCapsule(opts) {
     importedRecords: importResult.imported.length,
     skippedRecords: importResult.skipped.length
   };
-  const lineagePath = path39.join(forkDirAbs, "lineage.json");
+  const lineagePath = path40.join(forkDirAbs, "lineage.json");
   const rootReal = await realpath3(rootAbs);
   await assertRealpathInsideRoot(rootReal, lineagePath, `forks/${opts.forkId}/lineage.json`, "forkCapsule");
-  await mkdir8(path39.dirname(lineagePath), { recursive: true });
+  await mkdir8(path40.dirname(lineagePath), { recursive: true });
   await writeFile8(lineagePath, JSON.stringify(lineage, null, 2) + "\n", "utf-8");
   return {
     archivePath: archiveAbs,
@@ -30705,11 +30858,11 @@ async function readForkLineage(targetRoot, forkId) {
   if (typeof forkId !== "string" || forkId.length === 0 || forkId.length > 64 || !CAPSULE_ID_PATTERN.test(forkId)) {
     return null;
   }
-  const rootAbs = path39.resolve(targetRoot);
+  const rootAbs = path40.resolve(targetRoot);
   const rootReal = await realpath3(rootAbs).catch(() => rootAbs);
-  const lineagePath = path39.join(rootReal, "forks", forkId, "lineage.json");
-  const rel = path39.relative(rootReal, lineagePath);
-  if (rel.startsWith("..") || path39.isAbsolute(rel)) {
+  const lineagePath = path40.join(rootReal, "forks", forkId, "lineage.json");
+  const rel = path40.relative(rootReal, lineagePath);
+  if (rel.startsWith("..") || path40.isAbsolute(rel)) {
     return null;
   }
   if (!await isLineagePathContained(rootReal, lineagePath)) {
@@ -30750,19 +30903,19 @@ async function pathEntryExists(absPath) {
 async function isLineagePathContained(rootReal, lineagePath) {
   let existing = lineagePath;
   const suffix = [];
-  while (existing !== path39.dirname(existing)) {
+  while (existing !== path40.dirname(existing)) {
     const st = await lstat4(existing).catch(() => null);
     if (st !== null) break;
-    suffix.unshift(path39.basename(existing));
-    existing = path39.dirname(existing);
+    suffix.unshift(path40.basename(existing));
+    existing = path40.dirname(existing);
   }
   const existingReal = await realpath3(existing).catch(() => existing);
-  const targetReal = suffix.length > 0 ? path39.join(existingReal, ...suffix) : existingReal;
-  const rel = path39.relative(rootReal, targetReal);
+  const targetReal = suffix.length > 0 ? path40.join(existingReal, ...suffix) : existingReal;
+  const rel = path40.relative(rootReal, targetReal);
   if (rel === "") return true;
   if (rel === "..") return false;
-  if (rel.startsWith(`..${path39.sep}`)) return false;
-  if (path39.isAbsolute(rel)) return false;
+  if (rel.startsWith(`..${path40.sep}`)) return false;
+  if (path40.isAbsolute(rel)) return false;
   return true;
 }
 
@@ -30951,4 +31104,4 @@ export {
   qmdStartupCollectionChecksWithTimeout,
   Orchestrator
 };
-//# sourceMappingURL=chunk-IST6MBYC.js.map
+//# sourceMappingURL=chunk-MSTKJI5T.js.map