@remnic/core 9.38.3 → 9.39.0

package/dist/access-service.d.ts

@@ -1,5 +1,5 @@
-export { A as AccessProfilingReportRequest, a as AccessProfilingReportResponse, C as CodingScopedWriteInput, S as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, T as EngramAccessActionConfidenceRequest, U as EngramAccessActionConfidenceResponse, n as EngramAccessBriefingRequest, o as EngramAccessBriefingResponse, b as EngramAccessCapsuleListResponse, V as EngramAccessDaySummaryRequest, W as EngramAccessEntityListResponse, X as EngramAccessEntityResponse, Y as EngramAccessEntitySummary, d as EngramAccessExtractionForceFlushRequest, e as EngramAccessExtractionForceFlushResponse, O as EngramAccessLcmCompactionFlushRequest, g as EngramAccessLcmCompactionFlushResponse, Z as EngramAccessLcmCompactionRecordRequest, h as EngramAccessLcmCompactionRecordResponse, i as EngramAccessLcmSearchRequest, j as EngramAccessLcmSearchResponse, _ as EngramAccessLcmStatusResponse, $ as EngramAccessMaintenanceResponse, a0 as EngramAccessMemoryBrowseRequest, a1 as EngramAccessMemoryBrowseResponse, a2 as EngramAccessMemoryRecord, x as EngramAccessMemoryResponse, l as EngramAccessMemoryStoreRequest, G as EngramAccessMemorySummary, a3 as EngramAccessObserveMessage, q as EngramAccessObserveRequest, r as EngramAccessObserveResponse, a4 as EngramAccessOfflineSyncApplyFileContentRequest, a5 as EngramAccessOfflineSyncApplyFileContentResponse, a6 as EngramAccessOfflineSyncApplyRequest, a7 as EngramAccessOfflineSyncApplyResponse, a8 as EngramAccessOfflineSyncFileContentRequest, a9 as EngramAccessOfflineSyncFileContentResponse, aa as EngramAccessOfflineSyncFilesRequest, ab as EngramAccessOfflineSyncFilesResponse, ac as EngramAccessOfflineSyncSnapshotRequest, ad as EngramAccessOfflineSyncSnapshotResponse, ae as EngramAccessOfflineSyncSnapshotStreamResponse, af as EngramAccessQualityResponse, ag as EngramAccessRecallExplainRequest, ah as EngramAccessRecallExplainResponse, F as EngramAccessRecallRequest, B as EngramAccessRecallResponse, ai as EngramAccessReviewDispositionRequest, aj as EngramAccessReviewDispositionResponse, E as EngramAccessReviewQueueResponse, ak as EngramAccessScopeDebug, f as EngramAccessService, H as EngramAccessSetCodingContextRequest, m as EngramAccessSuggestionSubmitRequest, al as EngramAccessTimelineResponse, am as EngramAccessTrustZoneBrowseRequest, an as EngramAccessTrustZoneBrowseResponse, ao as EngramAccessTrustZoneDemoSeedRequest, ap as EngramAccessTrustZoneDemoSeedResponse, aq as EngramAccessTrustZonePromoteRequest, ar as EngramAccessTrustZonePromoteResponse, as as EngramAccessTrustZoneRecordSummary, at as EngramAccessTrustZoneStatusResponse, au as EngramAccessWriteEnvelope, p as EngramAccessWriteResponse, k as MemoryScopePlan, av as buildProjectedGovernanceProposedActions, aw as hasGroupedGovernanceActions, ax as shapeMemorySummary } from './access-service-C2WYT1pO.js';
-import './storage-BbH4HDUS.js';
+export { A as AccessProfilingReportRequest, a as AccessProfilingReportResponse, C as CodingScopedWriteInput, S as ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, T as EngramAccessActionConfidenceRequest, U as EngramAccessActionConfidenceResponse, n as EngramAccessBriefingRequest, o as EngramAccessBriefingResponse, b as EngramAccessCapsuleListResponse, V as EngramAccessDaySummaryRequest, W as EngramAccessEntityListResponse, X as EngramAccessEntityResponse, Y as EngramAccessEntitySummary, d as EngramAccessExtractionForceFlushRequest, e as EngramAccessExtractionForceFlushResponse, O as EngramAccessLcmCompactionFlushRequest, g as EngramAccessLcmCompactionFlushResponse, Z as EngramAccessLcmCompactionRecordRequest, h as EngramAccessLcmCompactionRecordResponse, i as EngramAccessLcmSearchRequest, j as EngramAccessLcmSearchResponse, _ as EngramAccessLcmStatusResponse, $ as EngramAccessMaintenanceResponse, a0 as EngramAccessMemoryBrowseRequest, a1 as EngramAccessMemoryBrowseResponse, a2 as EngramAccessMemoryRecord, x as EngramAccessMemoryResponse, l as EngramAccessMemoryStoreRequest, G as EngramAccessMemorySummary, a3 as EngramAccessObserveMessage, q as EngramAccessObserveRequest, r as EngramAccessObserveResponse, a4 as EngramAccessOfflineSyncApplyFileContentRequest, a5 as EngramAccessOfflineSyncApplyFileContentResponse, a6 as EngramAccessOfflineSyncApplyRequest, a7 as EngramAccessOfflineSyncApplyResponse, a8 as EngramAccessOfflineSyncFileContentRequest, a9 as EngramAccessOfflineSyncFileContentResponse, aa as EngramAccessOfflineSyncFilesRequest, ab as EngramAccessOfflineSyncFilesResponse, ac as EngramAccessOfflineSyncSnapshotRequest, ad as EngramAccessOfflineSyncSnapshotResponse, ae as EngramAccessOfflineSyncSnapshotStreamResponse, af as EngramAccessQualityResponse, ag as EngramAccessRecallExplainRequest, ah as EngramAccessRecallExplainResponse, F as EngramAccessRecallRequest, B as EngramAccessRecallResponse, ai as EngramAccessReviewDispositionRequest, aj as EngramAccessReviewDispositionResponse, E as EngramAccessReviewQueueResponse, ak as EngramAccessScopeDebug, f as EngramAccessService, H as EngramAccessSetCodingContextRequest, m as EngramAccessSuggestionSubmitRequest, al as EngramAccessTimelineResponse, am as EngramAccessTrustZoneBrowseRequest, an as EngramAccessTrustZoneBrowseResponse, ao as EngramAccessTrustZoneDemoSeedRequest, ap as EngramAccessTrustZoneDemoSeedResponse, aq as EngramAccessTrustZonePromoteRequest, ar as EngramAccessTrustZonePromoteResponse, as as EngramAccessTrustZoneRecordSummary, at as EngramAccessTrustZoneStatusResponse, au as EngramAccessWriteEnvelope, p as EngramAccessWriteResponse, k as MemoryScopePlan, av as buildProjectedGovernanceProposedActions, aw as hasGroupedGovernanceActions, ax as shapeMemorySummary } from './access-service-C6QuKBCG.js';
+import './storage-CNKZocJF.js';
 import './types-B1VHaf2w.js';
 import './recall-explain-renderer.js';
 import './types-5398p7Zm.js';
@@ -7,12 +7,12 @@ import './access-citation.js';
 import './resolve-auth-token.js';
 export { EngramAccessHealthResponse, EngramAccessQmdCollectionState, EngramAccessQmdHealthResponse } from './access-health-types.js';
 import './recall-audit-anomaly.js';
-import './orchestrator-DV_u9bfx.js';
+import './orchestrator-CEhod0MJ.js';
 import './explicit-capture.js';
 import './cross-namespace-budget.js';
 import './maintenance/memory-governance.js';
 import './live-connectors-runner.js';
-import './service-JxXXY-Eh.js';
+import './service-BlOfGid8.js';
 export { WearablesMeetingsScope } from './access-wearables-meetings-surface.js';
 import './scope-profiles-C4zY-a2K.js';
 export { E as EngramAccessNamespaceWritableRequest } from './access-namespace-preflight-CWyL4Zai.js';
@@ -61,7 +61,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-Ha9Dg93M.js';
+import './maintenance-Dsvprbod.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';

package/dist/access-service.js

@@ -4,7 +4,7 @@ import {
   buildProjectedGovernanceProposedActions,
   hasGroupedGovernanceActions,
   shapeMemorySummary
-} from "./chunk-XEM77GGX.js";
+} from "./chunk-BVJIAIB3.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-3CE77VAP.js";
@@ -20,11 +20,11 @@ import "./chunk-MYXWPG5O.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-KWU6MAD4.js";
 import "./chunk-AHVEHR6K.js";
-import "./chunk-UBWOCQ3I.js";
+import "./chunk-MHCRASVK.js";
 import "./chunk-ICP53SKG.js";
 import "./chunk-AQEJKOKI.js";
 import "./chunk-6HMYUWXR.js";
-import "./chunk-HUS2XN3T.js";
+import "./chunk-YFHMW37V.js";
 import "./chunk-R6YJI3HE.js";
 import "./chunk-ULARSG5Z.js";
 import "./chunk-XOQSEF7X.js";
@@ -39,8 +39,8 @@ import "./chunk-NLE6TSLG.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-Q53RLEW7.js";
 import "./chunk-C37ZRXX7.js";
-import "./chunk-BGLDKAYY.js";
-import "./chunk-RY7CHVGE.js";
+import "./chunk-VK33JSBR.js";
+import "./chunk-G57BGHQ2.js";
 import "./chunk-IOQFPVGY.js";
 import "./chunk-UZQCNOPS.js";
 import "./chunk-ES36HTSC.js";
@@ -51,7 +51,7 @@ import "./chunk-S2BBISHU.js";
 import "./chunk-W7IGLX4G.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-CYEPCZN5.js";
-import "./chunk-PYTUBWAS.js";
+import "./chunk-UGAZILZG.js";
 import "./chunk-LEPOP46W.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
@@ -71,20 +71,20 @@ import "./chunk-64UDOIMI.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-5ZGHUWTT.js";
+import "./chunk-ZBDORYWM.js";
 import "./chunk-KSXJOC4F.js";
 import "./chunk-NRV4Y3PM.js";
-import "./chunk-6TF4M2LB.js";
-import "./chunk-Q3CVY7LV.js";
+import "./chunk-AVGTOOYP.js";
+import "./chunk-ENLZOWYK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-WIPEXG6R.js";
-import "./chunk-HKF5VASQ.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-HXDWZFNP.js";
-import "./chunk-T3FVAHM7.js";
+import "./chunk-4VXGRIH6.js";
 import "./chunk-EGGE52UU.js";
-import "./chunk-ILGC6JH6.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";

package/dist/access-surface-catalog.d.ts

@@ -1,6 +1,6 @@
 import { OperationName } from './access-boundary.js';
 import 'zod';
-import './access-service-C2WYT1pO.js';
+import './access-service-C6QuKBCG.js';
 import './catalog-Du4bpZWM.js';
 import './types-5398p7Zm.js';
 import './message-parts/index.js';
@@ -11,7 +11,7 @@ import './access-namespace-preflight-CWyL4Zai.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './scope-profiles-C4zY-a2K.js';
-import './storage-BbH4HDUS.js';
+import './storage-CNKZocJF.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
@@ -36,7 +36,7 @@ import './corpus-watermark.js';
 import './replica-divergence.js';
 import './recall-audit-anomaly.js';
 import './recall-audit.js';
-import './orchestrator-DV_u9bfx.js';
+import './orchestrator-CEhod0MJ.js';
 import './briefing.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
@@ -47,7 +47,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-Ha9Dg93M.js';
+import './maintenance-Dsvprbod.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -91,7 +91,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-TddhF0y7.js';
 import './replay/types.js';
-import './service-JxXXY-Eh.js';
+import './service-BlOfGid8.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/access-wearables-meetings-surface.d.ts

@@ -1,10 +1,10 @@
-import { W as WearablesService, M as MeetingsService, a as MeetingsDayBuildSummary, b as MeetingsGetResult, c as MeetingsListResult } from './service-JxXXY-Eh.js';
+import { W as WearablesService, M as MeetingsService, a as MeetingsDayBuildSummary, b as MeetingsGetResult, c as MeetingsListResult } from './service-BlOfGid8.js';
 import './types-5398p7Zm.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './types-continuity.js';
-import './storage-BbH4HDUS.js';
+import './storage-CNKZocJF.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
 import './consolidation-operator.js';

package/dist/bootstrap.d.ts

@@ -1,5 +1,5 @@
 import { P as PluginConfig } from './types-5398p7Zm.js';
-import { O as Orchestrator } from './orchestrator-DV_u9bfx.js';
+import { O as Orchestrator } from './orchestrator-CEhod0MJ.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,7 +8,7 @@ import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './briefing.js';
-import './storage-BbH4HDUS.js';
+import './storage-CNKZocJF.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
@@ -27,7 +27,7 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-Ha9Dg93M.js';
+import './maintenance-Dsvprbod.js';
 import './catalog-Du4bpZWM.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
@@ -77,7 +77,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-TddhF0y7.js';
 import './replay/types.js';
-import './service-JxXXY-Eh.js';
+import './service-BlOfGid8.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';

package/dist/briefing.d.ts

@@ -1,4 +1,4 @@
-import { S as StorageManager } from './storage-BbH4HDUS.js';
+import { S as StorageManager } from './storage-CNKZocJF.js';
 import { B as BriefingSections, d as BriefingFollowup, e as BriefingFocus, C as CalendarSource, f as CalendarEvent, M as MemoryFile, g as BriefingActiveThread, h as BriefingResult, E as EntityFile, i as BriefingRecentEntity } from './types-5398p7Zm.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';

package/dist/briefing.js

@@ -17,17 +17,17 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-6TF4M2LB.js";
-import "./chunk-Q3CVY7LV.js";
+} from "./chunk-AVGTOOYP.js";
+import "./chunk-ENLZOWYK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-WIPEXG6R.js";
-import "./chunk-HKF5VASQ.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-HXDWZFNP.js";
-import "./chunk-T3FVAHM7.js";
+import "./chunk-4VXGRIH6.js";
 import "./chunk-EGGE52UU.js";
-import "./chunk-ILGC6JH6.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";

package/dist/buffer.d.ts

@@ -1,4 +1,4 @@
-import { S as StorageManager } from './storage-BbH4HDUS.js';
+import { S as StorageManager } from './storage-CNKZocJF.js';
 import { P as PluginConfig, j as BufferTurn, k as ExtractionBufferSnapshot } from './types-5398p7Zm.js';
 import './entity-id-normalization.js';
 import './page-versioning.js';

package/dist/causal-consolidation.js

@@ -4,26 +4,26 @@ import {
 } from "./chunk-MU7ZHSZE.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-FE7MUX7M.js";
+} from "./chunk-AL73FWSS.js";
 import "./chunk-JLNBQWZ2.js";
 import "./chunk-B7RWBZXW.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-5ZGHUWTT.js";
+} from "./chunk-ZBDORYWM.js";
 import "./chunk-KSXJOC4F.js";
 import {
   resolveCausalTrajectoryStoreDir
 } from "./chunk-NRV4Y3PM.js";
-import "./chunk-Q3CVY7LV.js";
+import "./chunk-ENLZOWYK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-ENTCVTQR.js";
 import "./chunk-WIPEXG6R.js";
-import "./chunk-HKF5VASQ.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-HXDWZFNP.js";
-import "./chunk-T3FVAHM7.js";
+import "./chunk-4VXGRIH6.js";
 import "./chunk-EGGE52UU.js";
-import "./chunk-ILGC6JH6.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-7RJUVTVF.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";

package/dist/{chunk-POQGCS4H.js → chunk-4CSTEPFA.js}

@@ -22,7 +22,7 @@ import {
 } from "./chunk-IKKWIPYN.js";
 import {
   getOperation
-} from "./chunk-XEM77GGX.js";
+} from "./chunk-BVJIAIB3.js";
 import {
   assertOperationAllowed,
   capabilityAllowsOp,
@@ -3755,4 +3755,4 @@ export {
   MCP_SUPPORTED_PROTOCOL_VERSIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-POQGCS4H.js.map
+//# sourceMappingURL=chunk-4CSTEPFA.js.map

package/dist/{chunk-T3FVAHM7.js → chunk-4VXGRIH6.js}

@@ -1,14 +1,26 @@
+import {
+  warnProjectionFallback
+} from "./chunk-ZA53AZND.js";
 import {
   MEMORY_LIFECYCLE_LEDGER_APPEND_LOCK_MAX_WAIT_MS,
   MEMORY_LIFECYCLE_LEDGER_LOCK_STALE_MS,
   compareMemoryLifecycleEvents,
+  isFrontmatterDerivedLifecycleEventType,
+  memoryLifecycleEventProjectionIdentity,
   memoryLifecycleLedgerLockPath,
   sortMemoryLifecycleEvents
-} from "./chunk-ILGC6JH6.js";
+} from "./chunk-7RJUVTVF.js";
 import {
   ensureContainedSpillDir,
   listContainedSpillFiles
 } from "./chunk-GCASGYIO.js";
+import {
+  getMemoryProjectionPath,
+  openProjectionReadonly,
+  readProjectedEntityMentions,
+  readProjectedGovernanceRecord,
+  readProjectedNativeKnowledgeChunks
+} from "./chunk-3CSX3ETE.js";
 import {
   displayErrorDetail
 } from "./chunk-RL6NEVXT.js";
@@ -24,6 +36,135 @@ import {
   isErrnoCode
 } from "./chunk-5UZXUTVO.js";
 
+// src/maintenance/projection-support.ts
+import path from "path";
+function readProjectionRebuiltAt(memoryDir) {
+  const db = openProjectionReadonly(memoryDir);
+  if (!db) return null;
+  try {
+    const row = db.prepare("SELECT value FROM meta WHERE key = 'rebuiltAt'").get();
+    return typeof row?.value === "string" && row.value.length > 0 ? row.value : null;
+  } catch {
+    return null;
+  } finally {
+    db.close();
+  }
+}
+function formatProjectionAge(rebuiltAt) {
+  if (!rebuiltAt) return "projection never rebuilt";
+  const ageMs = Date.now() - Date.parse(rebuiltAt);
+  if (!Number.isFinite(ageMs)) return `projection rebuiltAt=${rebuiltAt}`;
+  const ageMin = Math.max(0, Math.round(ageMs / 6e4));
+  const age = ageMin >= 120 ? `${Math.round(ageMin / 60)}h` : `${ageMin}m`;
+  return `projection ${age} stale, last rebuilt ${rebuiltAt}`;
+}
+function readProjectionHighWaterFromDb(db) {
+  const sourceRow = db.prepare(
+    "SELECT value FROM meta WHERE key = 'sourceLifecycleLedgerEventCount'"
+  ).get();
+  const projectedRow = db.prepare(
+    "SELECT value FROM meta WHERE key = 'projectedLifecycleLedgerEventCount'"
+  ).get();
+  if (typeof sourceRow?.value !== "string" || !/^\d+$/.test(sourceRow.value) || typeof projectedRow?.value !== "string" || !/^\d+$/.test(projectedRow.value)) return null;
+  const sourceEventCount = Number(sourceRow.value);
+  const eventCount = Number(projectedRow.value);
+  if (!Number.isSafeInteger(sourceEventCount) || !Number.isSafeInteger(eventCount)) return null;
+  return { eventCount, sourceEventCount };
+}
+function openProjectionLifecycleLedgerLagTracker(memoryDir) {
+  const db = openProjectionReadonly(memoryDir);
+  if (!db) return null;
+  try {
+    const highWater = readProjectionHighWaterFromDb(db);
+    if (!highWater) {
+      db.close();
+      return null;
+    }
+    db.pragma("temp_store = FILE");
+    db.exec(`
+      CREATE TEMP TABLE projection_lag_current_identity (
+        identity TEXT PRIMARY KEY
+      ) WITHOUT ROWID;
+    `);
+    db.pragma("temp.cache_size = -1024");
+    const insertCurrent = db.prepare(
+      "INSERT OR IGNORE INTO projection_lag_current_identity(identity) VALUES (?)"
+    );
+    const findProjectedEvent = db.prepare(
+      "SELECT 1 FROM memory_timeline WHERE event_id = ? LIMIT 1"
+    );
+    const findProjectedFrontmatterEvent = db.prepare(`
+      SELECT 1
+      FROM memory_timeline
+      WHERE memory_id = ? AND event_type = ? AND timestamp = ?
+      LIMIT 1
+    `);
+    return {
+      highWater,
+      record(event) {
+        if (!event.memoryId.trim()) return { unique: false, projected: false };
+        const identity = memoryLifecycleEventProjectionIdentity(event);
+        const inserted = insertCurrent.run(identity);
+        if (inserted.changes === 0) return { unique: false, projected: false };
+        const projected = isFrontmatterDerivedLifecycleEventType(event.eventType) ? findProjectedFrontmatterEvent.get(event.memoryId, event.eventType, event.timestamp) : findProjectedEvent.get(event.eventId);
+        return { unique: true, projected: projected !== void 0 };
+      },
+      close: () => db.close()
+    };
+  } catch {
+    db.close();
+    return null;
+  }
+}
+function writeProjectionMetaHighWater(insertMeta, sourceLifecycleLedgerEventCount, timelineRows) {
+  insertMeta.run("sourceLifecycleLedgerEventCount", String(sourceLifecycleLedgerEventCount));
+  insertMeta.run(
+    "projectedLifecycleLedgerEventCount",
+    String(new Set(timelineRows.map(memoryLifecycleEventProjectionIdentity)).size)
+  );
+}
+function readProjectedEntityMentionRows(memoryDir) {
+  const rows = readProjectedEntityMentions(memoryDir);
+  if (rows === null) return { projectionExists: false, rows: [] };
+  return { projectionExists: true, rows };
+}
+function readProjectedNativeKnowledgeRows(memoryDir) {
+  const rows = readProjectedNativeKnowledgeChunks(memoryDir);
+  if (rows === null) return { projectionExists: false, rows: [] };
+  return { projectionExists: true, rows };
+}
+function readProjectedGovernanceRows(memoryDir) {
+  const record = readProjectedGovernanceRecord(memoryDir);
+  if (record === null) {
+    return {
+      projectionExists: false,
+      runId: null,
+      summary: void 0,
+      metrics: void 0,
+      reviewQueueRows: [],
+      appliedActionRows: [],
+      report: ""
+    };
+  }
+  return {
+    projectionExists: true,
+    runId: record.runId,
+    summary: record.summary,
+    metrics: record.metrics,
+    reviewQueueRows: record.reviewQueueRows,
+    appliedActionRows: record.appliedActionRows,
+    report: record.report
+  };
+}
+function assertInjectedStorageRooted(label, memoryDir, injected) {
+  if (injected && path.resolve(injected.dir) !== path.resolve(memoryDir)) {
+    throw new Error(
+      `${label}: storage.dir (${injected.dir}) must match memoryDir (${memoryDir})`
+    );
+  }
+  return injected;
+}
+
 // src/storage/secure-line-reader.ts
 import { createReadStream } from "fs";
 import { lstat, open } from "fs/promises";
@@ -149,7 +290,7 @@ var BoundedLifecycleTopN = class {
     }
   }
 };
-async function readMemoryLifecycleEventsFromLines(lines, limit, memoryId, compare) {
+async function readMemoryLifecycleEventsFromLines(lines, limit, memoryId, compare, onEvent) {
   if (limit <= 0) return [];
   const top = compare ? new BoundedLifecycleTopN(limit, compare) : null;
   const ring = [];
@@ -160,8 +301,9 @@ async function readMemoryLifecycleEventsFromLines(lines, limit, memoryId, compar
     if (!line) continue;
     try {
       const parsed = JSON.parse(line);
-      if (memoryId !== void 0 && parsed.memoryId !== memoryId) continue;
       if (!isValidLifecycleEventRow(parsed)) continue;
+      onEvent?.(parsed);
+      if (memoryId !== void 0 && parsed.memoryId !== memoryId) continue;
       if (top) {
         top.add(parsed, seq++);
       } else if (ring.length < limit) {
@@ -178,9 +320,9 @@ async function readMemoryLifecycleEventsFromLines(lines, limit, memoryId, compar
 }
 
 // src/storage/memory-lifecycle-ledger-access.ts
-import { rename, stat, unlink } from "fs/promises";
+import { lstat as lstat2, rename, stat, unlink } from "fs/promises";
 import { randomUUID } from "crypto";
-import path from "path";
+import path2 from "path";
 async function collectLifecycleEvents(lines) {
   const out = [];
   for await (const line of lines) {
@@ -254,6 +396,135 @@ async function readBoundedLifecycleEventsFromLedger(ledgerPath, readSecureFile,
     return [];
   }
 }
+async function readBoundedLifecycleEventsWithProjectionLag(ledgerPath, readSecureFile, limit, memoryId, tracker) {
+  let currentEventCount = 0;
+  let deltaEvents = 0;
+  let telemetryAvailable = true;
+  try {
+    const events = await readMemoryLifecycleEventsFromLines(
+      readMaybeEncryptedLines(
+        ledgerPath,
+        () => readSecureFile(ledgerPath),
+        STATE_FILE_MAX_DECRYPT_BYTES
+      ),
+      Math.max(0, Math.floor(limit)),
+      memoryId,
+      compareMemoryLifecycleEvents,
+      (event) => {
+        if (!telemetryAvailable) return;
+        try {
+          const tracked = tracker.record(event);
+          if (!tracked.unique) return;
+          currentEventCount += 1;
+          if (!tracked.projected) deltaEvents += 1;
+        } catch {
+          telemetryAvailable = false;
+          currentEventCount = 0;
+          deltaEvents = 0;
+        }
+      }
+    );
+    return { events, currentEventCount, deltaEvents, telemetryAvailable };
+  } catch (err) {
+    if (err instanceof SecureStoreLockedError) throw err;
+    if (!isErrnoCode(err, "ENOENT")) throw err;
+    return { events: [], currentEventCount: 0, deltaEvents: 0, telemetryAvailable: false };
+  }
+}
+async function probeProjectionLedgerIdentities(projectionPath, ledgerPath) {
+  try {
+    const [projectionIdentity, ledgerIdentity] = await Promise.all(
+      [projectionPath, ledgerPath].map(async (filePath) => {
+        try {
+          const file = await lstat2(filePath);
+          return `${file.dev}:${file.ino}:${file.size}:${file.mtimeMs}:${file.ctimeMs}`;
+        } catch (err) {
+          if (isErrnoCode(err, "ENOENT")) return "absent";
+          return null;
+        }
+      })
+    );
+    if (!projectionIdentity || !ledgerIdentity) return null;
+    return { projectionIdentity, ledgerIdentity };
+  } catch {
+    return null;
+  }
+}
+var ProjectionLedgerLagManager = class {
+  lagCache = null;
+  lagInFlight = null;
+  async resolveTimelineWithLag(options) {
+    const { baseDir, ledgerPath, memoryId, cappedLimit, readSecureFile, projectionAge } = options;
+    const projectionPath = getMemoryProjectionPath(baseDir);
+    const identities = await probeProjectionLedgerIdentities(projectionPath, ledgerPath);
+    if (!identities) {
+      warnProjectionFallback(baseDir, "getMemoryTimeline", projectionAge);
+      return readBoundedLifecycleEventsFromLedger(ledgerPath, readSecureFile, cappedLimit, memoryId);
+    }
+    const { projectionIdentity, ledgerIdentity } = identities;
+    const generation = `${projectionIdentity}\0${ledgerIdentity}`;
+    const cachedLag = this.lagCache?.generation === generation ? this.lagCache.telemetry : null;
+    if (cachedLag) {
+      warnProjectionFallback(baseDir, "getMemoryTimeline", projectionAge, cachedLag);
+      return readBoundedLifecycleEventsFromLedger(ledgerPath, readSecureFile, cappedLimit, memoryId);
+    }
+    const inFlight = this.lagInFlight?.generation === generation ? this.lagInFlight.scan : null;
+    if (inFlight) {
+      const result = await inFlight;
+      if (result.telemetry) {
+        this.lagCache = { generation, telemetry: result.telemetry };
+      }
+      warnProjectionFallback(baseDir, "getMemoryTimeline", projectionAge, result.telemetry ?? void 0);
+      if (result.memoryId === memoryId && result.limit === cappedLimit) return result.events;
+      return readBoundedLifecycleEventsFromLedger(ledgerPath, readSecureFile, cappedLimit, memoryId);
+    }
+    const tracker = openProjectionLifecycleLedgerLagTracker(baseDir);
+    if (tracker) {
+      const highWater = tracker.highWater;
+      const scan = (async () => {
+        try {
+          const fallback = await readBoundedLifecycleEventsWithProjectionLag(
+            ledgerPath,
+            readSecureFile,
+            cappedLimit,
+            memoryId,
+            tracker
+          );
+          return {
+            telemetry: fallback.telemetryAvailable ? {
+              projectedEvents: highWater.eventCount,
+              currentLedgerEvents: fallback.currentEventCount,
+              deltaEvents: fallback.deltaEvents
+            } : null,
+            events: fallback.events,
+            memoryId,
+            limit: cappedLimit
+          };
+        } finally {
+          try {
+            tracker.close();
+          } catch {
+          }
+        }
+      })();
+      this.lagInFlight = { generation, scan };
+      try {
+        const result = await scan;
+        if (result.telemetry) {
+          this.lagCache = { generation, telemetry: result.telemetry };
+        }
+        warnProjectionFallback(baseDir, "getMemoryTimeline", projectionAge, result.telemetry ?? void 0);
+        return result.events;
+      } finally {
+        if (this.lagInFlight?.scan === scan) {
+          this.lagInFlight = null;
+        }
+      }
+    }
+    warnProjectionFallback(baseDir, "getMemoryTimeline", projectionAge);
+    return readBoundedLifecycleEventsFromLedger(ledgerPath, readSecureFile, cappedLimit, memoryId);
+  }
+};
 function pendingLifecycleLedgerDir(ledgerPath) {
   return `${ledgerPath}.pending.d`;
 }
@@ -275,7 +546,7 @@ function serializeLifecycleAppendPayload(events) {
 async function spillPendingAppend(ledgerPath, io, payload) {
   const dir = pendingLifecycleLedgerDir(ledgerPath);
   await ensureContainedSpillDir(dir);
-  const finalPath = path.join(dir, `${randomUUID()}.jsonl`);
+  const finalPath = path2.join(dir, `${randomUUID()}.jsonl`);
   await io.writeSecure(finalPath, payload);
 }
 var CLAIMED_SPILL_SUFFIX = ".claimed";
@@ -432,12 +703,20 @@ async function drainPendingLifecycleForSyncOrThrow(drain, maxAttempts = 3) {
 }
 
 export {
+  readProjectionRebuiltAt,
+  formatProjectionAge,
+  writeProjectionMetaHighWater,
+  readProjectedEntityMentionRows,
+  readProjectedNativeKnowledgeRows,
+  readProjectedGovernanceRows,
+  assertInjectedStorageRooted,
   STATE_FILE_MAX_DECRYPT_BYTES,
   readMaybeEncryptedLines,
   readMemoryActionEventRowsFromLines,
   readAllLifecycleEventsFromLedger,
   readAllLifecycleEventsFromLedgerBuffer,
   readBoundedLifecycleEventsFromLedger,
+  ProjectionLedgerLagManager,
   pendingLifecycleLedgerDir,
   serializeLifecycleAppendPayload,
   appendLifecycleEventsSerialized,
@@ -445,4 +724,4 @@ export {
   drainPendingLifecycleLedgerForSync,
   drainPendingLifecycleForSyncOrThrow
 };
-//# sourceMappingURL=chunk-T3FVAHM7.js.map
+//# sourceMappingURL=chunk-4VXGRIH6.js.map