@remnic/core 9.69.45 → 9.69.47

package/dist/{chunk-IFULZYYQ.js → chunk-LIAM7U2J.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-IAT5WFEU.js";
+} from "./chunk-MNG536IS.js";
 import {
   getCachedRuleMemories,
   setCachedRuleMemories
@@ -119,4 +119,4 @@ export {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
 };
-//# sourceMappingURL=chunk-IFULZYYQ.js.map
+//# sourceMappingURL=chunk-LIAM7U2J.js.map

package/dist/{chunk-LZAJONO5.js → chunk-LIDJWAQV.js}

@@ -4,7 +4,7 @@ import {
 import {
   computeCorpusWatermarks,
   resolveCorpusNamespaceRoots
-} from "./chunk-AOMUIF3R.js";
+} from "./chunk-MQT3WP3F.js";
 
 // src/operator-doctor-corpus.ts
 var DIGEST_PREFIX_LENGTH = 12;
@@ -78,4 +78,4 @@ export {
   corpusWatermarksFromCheck,
   summarizeCorpusAndReplica
 };
-//# sourceMappingURL=chunk-LZAJONO5.js.map
+//# sourceMappingURL=chunk-LIDJWAQV.js.map

package/dist/{chunk-B55FYF6F.js → chunk-LYMJ36UI.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-D3DJYGU2.js";
+} from "./chunk-XEHLYA5Z.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-B55FYF6F.js.map
+//# sourceMappingURL=chunk-LYMJ36UI.js.map

package/dist/chunk-M4DB6ZNN.js

@@ -0,0 +1,87 @@
+// src/memory-age.ts
+import { stat } from "fs/promises";
+var BULK_TOUCH_MIN_FILES = 2;
+var BULK_TOUCH_STORE_FRACTION = 0.2;
+var RECENCY_HALF_LIFE_DAYS = 7;
+function finiteMs(value) {
+  if (typeof value !== "string") return null;
+  const ms = Date.parse(value);
+  return Number.isFinite(ms) ? ms : null;
+}
+function resolveMemoryAge(subject, mtimeMs, trust) {
+  const contentMs = finiteMs(subject.created) ?? finiteMs(subject.updated);
+  if (contentMs !== null) return { referenceMs: contentMs, source: "content" };
+  if (typeof mtimeMs === "number" && Number.isFinite(mtimeMs) && trust?.isTrusted(mtimeMs) !== false) {
+    return { referenceMs: mtimeMs, source: "mtime" };
+  }
+  return { referenceMs: null, source: "unknown" };
+}
+function utcDayKey(ms) {
+  return new Date(ms).toISOString().slice(0, 10);
+}
+function assessMtimeTrust(sampleMtimesMs) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const ms of sampleMtimesMs) {
+    if (!Number.isFinite(ms)) continue;
+    const key = utcDayKey(ms);
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+  }
+  const threshold = Math.max(
+    BULK_TOUCH_MIN_FILES,
+    sampleMtimesMs.length * BULK_TOUCH_STORE_FRACTION
+  );
+  const bulkTouchDays = /* @__PURE__ */ new Set();
+  for (const [day, count] of counts) {
+    if (count >= threshold) bulkTouchDays.add(day);
+  }
+  return {
+    bulkTouchDays,
+    isTrusted: (mtimeMs) => Number.isFinite(mtimeMs) && !bulkTouchDays.has(utcDayKey(mtimeMs))
+  };
+}
+async function collectMtimeFallbackContext(memories) {
+  const needsFallback = memories.some(
+    (m) => finiteMs(m.created) === null && finiteMs(m.updated) === null
+  );
+  if (!needsFallback) return null;
+  const stats = await Promise.all(
+    memories.map(async (m) => {
+      try {
+        return (await stat(m.path)).mtimeMs;
+      } catch {
+        return null;
+      }
+    })
+  );
+  const mtimeMsByPath = new Map(
+    memories.map((m, i) => [m.path, stats[i] ?? null])
+  );
+  const trust = assessMtimeTrust(
+    stats.filter((ms) => ms !== null && Number.isFinite(ms))
+  );
+  return { mtimeMsByPath, trust };
+}
+function applyRecencyBoost(score, memory, recencyWeight, nowMs, fallback) {
+  if (recencyWeight <= 0) return score;
+  const resolved = resolveMemoryAge(
+    memory.frontmatter,
+    fallback?.mtimeMsByPath.get(memory.path) ?? null,
+    fallback?.trust
+  );
+  if (resolved.referenceMs === null) return score;
+  const ageDays = Math.max(0, (nowMs - resolved.referenceMs) / 864e5);
+  const recencyScore = Math.pow(0.5, ageDays / RECENCY_HALF_LIFE_DAYS);
+  return score * (1 - recencyWeight) + recencyScore * recencyWeight;
+}
+
+export {
+  BULK_TOUCH_MIN_FILES,
+  BULK_TOUCH_STORE_FRACTION,
+  RECENCY_HALF_LIFE_DAYS,
+  resolveMemoryAge,
+  utcDayKey,
+  assessMtimeTrust,
+  collectMtimeFallbackContext,
+  applyRecencyBoost
+};
+//# sourceMappingURL=chunk-M4DB6ZNN.js.map

package/dist/chunk-M4DB6ZNN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory-age.ts"],"sourcesContent":["/**\n * Shared memory-age resolution (issue #2976).\n *\n * \"Age is not mtime\" (distill-kura `weave.py` `age_days`): `cp -r`, a\n * restore, a checkout, or a bulk import resets file mtimes, so any freshness\n * mechanism keyed on mtime either switches itself off or boosts everything\n * equally. Remnic therefore resolves a memory's age from dates written\n * INSIDE the memory first:\n *\n *   1. frontmatter `created` — the recall ranking reference before #2976,\n *      kept first so every dated memory scores exactly as it did;\n *   2. frontmatter `updated` — the content-revision date;\n *   3. file mtime — only when no content date exists AND the caller's trust\n *      assessment accepts it (see `assessMtimeTrust`);\n *   4. otherwise UNKNOWN: no reference instant, and downstream scoring must\n *      treat unknown age as never-fresh (no recency boost), never as\n *      \"just written\".\n *\n * Bi-temporal `valid_at`/`observedAt` are deliberately NOT in the ladder:\n * they date when the fact was true, not when the memory was written, so a\n * fresh correction about an old event would be misaged by them.\n *\n * Bulk-touch heuristic (distill-kura measured 50/214 files sharing one\n * bulk-touch day, mtime understating true age by a median of 11 days, worst\n * case 425): a UTC calendar day shared by >= max(BULK_TOUCH_MIN_FILES,\n * BULK_TOUCH_STORE_FRACTION of the sampled files) is a bulk-touch day, and\n * mtimes falling on a bulk-touch day are untrusted — those ages are unknown,\n * not fresh. The sample is the scored result set of the calling pipeline\n * (bounded I/O), which observes a bulk-touched store as a same-day cluster.\n */\n\nimport { stat } from \"node:fs/promises\";\n\n/** Minimum files sharing one calendar day before that day is bulk-touched. */\nexport const BULK_TOUCH_MIN_FILES = 2;\n/** Fraction of the sampled files on one day that marks a bulk touch. */\nexport const BULK_TOUCH_STORE_FRACTION = 0.2;\n\n/** Recency half-life (days) used by `applyRecencyBoost`. */\nexport const RECENCY_HALF_LIFE_DAYS = 7;\n\n/** How the resolved age reference was obtained. */\nexport type MemoryAgeSource = \"content\" | \"mtime\" | \"unknown\";\n\nexport interface ResolvedMemoryAge {\n  /** Reference instant for age computations, or null when age is unknown. */\n  referenceMs: number | null;\n  source: MemoryAgeSource;\n}\n\n/** Content dates written inside the memory (frontmatter). */\nexport interface MemoryAgeDates {\n  created?: string | null;\n  updated?: string | null;\n}\n\n/** Minimal memory shape the resolver needs; `path` keys the mtime fallback. */\nexport interface MemoryAgeSubject extends MemoryAgeDates {\n  path: string;\n}\n\n/** MemoryFile slice `applyRecencyBoost` reads; dates live in frontmatter. */\nexport interface RecencyBoostSubject {\n  path: string;\n  frontmatter: MemoryAgeDates;\n}\n\n/** Result of assessing a sample of mtimes for bulk-touch clustering. */\nexport interface MtimeTrust {\n  /** UTC day keys (\"YYYY-MM-DD\") whose mtime counts mark a bulk touch. */\n  bulkTouchDays: ReadonlySet<string>;\n  isTrusted(mtimeMs: number): boolean;\n}\n\n/** Per-recall mtime fallback context (null when no scored memory needs it). */\nexport interface MtimeFallbackContext {\n  mtimeMsByPath: Map<string, number | null>;\n  trust: MtimeTrust;\n}\n\nfunction finiteMs(value: string | null | undefined): number | null {\n  if (typeof value !== \"string\") return null;\n  const ms = Date.parse(value);\n  return Number.isFinite(ms) ? ms : null;\n}\n\n/**\n * Resolve the reference instant for a memory's age. Content dates win over\n * mtime; an mtime is consulted only when no content date parses and the\n * trust assessment (when provided) accepts it; otherwise age is unknown.\n */\nexport function resolveMemoryAge(\n  subject: MemoryAgeDates,\n  mtimeMs?: number | null,\n  trust?: MtimeTrust | null,\n): ResolvedMemoryAge {\n  const contentMs = finiteMs(subject.created) ?? finiteMs(subject.updated);\n  if (contentMs !== null) return { referenceMs: contentMs, source: \"content\" };\n  if (\n    typeof mtimeMs === \"number\" &&\n    Number.isFinite(mtimeMs) &&\n    trust?.isTrusted(mtimeMs) !== false\n  ) {\n    return { referenceMs: mtimeMs, source: \"mtime\" };\n  }\n  return { referenceMs: null, source: \"unknown\" };\n}\n\n/** UTC calendar-day key (\"YYYY-MM-DD\") for a millisecond instant. */\nexport function utcDayKey(ms: number): string {\n  return new Date(ms).toISOString().slice(0, 10);\n}\n\n/**\n * Assess a sample of mtimes: days shared by >= max(BULK_TOUCH_MIN_FILES,\n * BULK_TOUCH_STORE_FRACTION of the sample) are bulk-touch days, and their\n * mtimes are untrusted for age. An empty or scattered sample trusts nothing\n * less than it did before — only clustering changes anything.\n */\nexport function assessMtimeTrust(sampleMtimesMs: readonly number[]): MtimeTrust {\n  const counts = new Map<string, number>();\n  for (const ms of sampleMtimesMs) {\n    if (!Number.isFinite(ms)) continue;\n    const key = utcDayKey(ms);\n    counts.set(key, (counts.get(key) ?? 0) + 1);\n  }\n  const threshold = Math.max(\n    BULK_TOUCH_MIN_FILES,\n    sampleMtimesMs.length * BULK_TOUCH_STORE_FRACTION,\n  );\n  const bulkTouchDays = new Set<string>();\n  for (const [day, count] of counts) {\n    if (count >= threshold) bulkTouchDays.add(day);\n  }\n  return {\n    bulkTouchDays,\n    isTrusted: (mtimeMs: number) => Number.isFinite(mtimeMs) && !bulkTouchDays.has(utcDayKey(mtimeMs)),\n  };\n}\n\n/**\n * Build the mtime fallback context for a recall boost pass. Returns null —\n * with zero stat calls — when every scored memory already has a content\n * date, so the common path pays nothing. Otherwise stats the scored files\n * (bounded by the result count) and assesses their mtimes for bulk-touch\n * clustering. Unreadable files map to null mtimes (unknown age, never fresh).\n */\nexport async function collectMtimeFallbackContext(\n  memories: ReadonlyArray<MemoryAgeSubject>,\n): Promise<MtimeFallbackContext | null> {\n  const needsFallback = memories.some(\n    (m) => finiteMs(m.created) === null && finiteMs(m.updated) === null,\n  );\n  if (!needsFallback) return null;\n  const stats = await Promise.all(\n    memories.map(async (m) => {\n      try {\n        return (await stat(m.path)).mtimeMs;\n      } catch {\n        return null;\n      }\n    }),\n  );\n  const mtimeMsByPath = new Map<string, number | null>(\n    memories.map((m, i) => [m.path, stats[i] ?? null]),\n  );\n  const trust = assessMtimeTrust(\n    stats.filter((ms): ms is number => ms !== null && Number.isFinite(ms)),\n  );\n  return { mtimeMsByPath, trust };\n}\n\n/**\n * Apply the exponential recency blend to one score. Age resolves per\n * `resolveMemoryAge`; unknown age leaves the score untouched (never fresh).\n * A future reference instant clamps to age zero rather than boosting above\n * the recency ceiling (corrupt dates are not super-fresh).\n */\nexport function applyRecencyBoost(\n  score: number,\n  memory: RecencyBoostSubject,\n  recencyWeight: number,\n  nowMs: number,\n  fallback?: MtimeFallbackContext | null,\n): number {\n  if (recencyWeight <= 0) return score;\n  const resolved = resolveMemoryAge(\n    memory.frontmatter,\n    fallback?.mtimeMsByPath.get(memory.path) ?? null,\n    fallback?.trust,\n  );\n  if (resolved.referenceMs === null) return score;\n  const ageDays = Math.max(0, (nowMs - resolved.referenceMs) / 86_400_000);\n  const recencyScore = Math.pow(0.5, ageDays / RECENCY_HALF_LIFE_DAYS);\n  return score * (1 - recencyWeight) + recencyScore * recencyWeight;\n}\n"],"mappings":";AA+BA,SAAS,YAAY;AAGd,IAAM,uBAAuB;AAE7B,IAAM,4BAA4B;AAGlC,IAAM,yBAAyB;AAyCtC,SAAS,SAAS,OAAiD;AACjE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,KAAK,KAAK,MAAM,KAAK;AAC3B,SAAO,OAAO,SAAS,EAAE,IAAI,KAAK;AACpC;AAOO,SAAS,iBACd,SACA,SACA,OACmB;AACnB,QAAM,YAAY,SAAS,QAAQ,OAAO,KAAK,SAAS,QAAQ,OAAO;AACvE,MAAI,cAAc,KAAM,QAAO,EAAE,aAAa,WAAW,QAAQ,UAAU;AAC3E,MACE,OAAO,YAAY,YACnB,OAAO,SAAS,OAAO,KACvB,OAAO,UAAU,OAAO,MAAM,OAC9B;AACA,WAAO,EAAE,aAAa,SAAS,QAAQ,QAAQ;AAAA,EACjD;AACA,SAAO,EAAE,aAAa,MAAM,QAAQ,UAAU;AAChD;AAGO,SAAS,UAAU,IAAoB;AAC5C,SAAO,IAAI,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AAC/C;AAQO,SAAS,iBAAiB,gBAA+C;AAC9E,QAAM,SAAS,oBAAI,IAAoB;AACvC,aAAW,MAAM,gBAAgB;AAC/B,QAAI,CAAC,OAAO,SAAS,EAAE,EAAG;AAC1B,UAAM,MAAM,UAAU,EAAE;AACxB,WAAO,IAAI,MAAM,OAAO,IAAI,GAAG,KAAK,KAAK,CAAC;AAAA,EAC5C;AACA,QAAM,YAAY,KAAK;AAAA,IACrB;AAAA,IACA,eAAe,SAAS;AAAA,EAC1B;AACA,QAAM,gBAAgB,oBAAI,IAAY;AACtC,aAAW,CAAC,KAAK,KAAK,KAAK,QAAQ;AACjC,QAAI,SAAS,UAAW,eAAc,IAAI,GAAG;AAAA,EAC/C;AACA,SAAO;AAAA,IACL;AAAA,IACA,WAAW,CAAC,YAAoB,OAAO,SAAS,OAAO,KAAK,CAAC,cAAc,IAAI,UAAU,OAAO,CAAC;AAAA,EACnG;AACF;AASA,eAAsB,4BACpB,UACsC;AACtC,QAAM,gBAAgB,SAAS;AAAA,IAC7B,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,QAAQ,SAAS,EAAE,OAAO,MAAM;AAAA,EACjE;AACA,MAAI,CAAC,cAAe,QAAO;AAC3B,QAAM,QAAQ,MAAM,QAAQ;AAAA,IAC1B,SAAS,IAAI,OAAO,MAAM;AACxB,UAAI;AACF,gBAAQ,MAAM,KAAK,EAAE,IAAI,GAAG;AAAA,MAC9B,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF,CAAC;AAAA,EACH;AACA,QAAM,gBAAgB,IAAI;AAAA,IACxB,SAAS,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,KAAK,IAAI,CAAC;AAAA,EACnD;AACA,QAAM,QAAQ;AAAA,IACZ,MAAM,OAAO,CAAC,OAAqB,OAAO,QAAQ,OAAO,SAAS,EAAE,CAAC;AAAA,EACvE;AACA,SAAO,EAAE,eAAe,MAAM;AAChC;AAQO,SAAS,kBACd,OACA,QACA,eACA,OACA,UACQ;AACR,MAAI,iBAAiB,EAAG,QAAO;AAC/B,QAAM,WAAW;AAAA,IACf,OAAO;AAAA,IACP,UAAU,cAAc,IAAI,OAAO,IAAI,KAAK;AAAA,IAC5C,UAAU;AAAA,EACZ;AACA,MAAI,SAAS,gBAAgB,KAAM,QAAO;AAC1C,QAAM,UAAU,KAAK,IAAI,IAAI,QAAQ,SAAS,eAAe,KAAU;AACvE,QAAM,eAAe,KAAK,IAAI,KAAK,UAAU,sBAAsB;AACnE,SAAO,SAAS,IAAI,iBAAiB,eAAe;AACtD;","names":[]}

package/dist/{chunk-5TKHJ5RW.js → chunk-MMQVWKFY.js}

@@ -3,13 +3,16 @@ import {
 } from "./chunk-V7IZKJI3.js";
 import {
   AdapterRegistry
-} from "./chunk-Q4AUIFUA.js";
+} from "./chunk-QMWKENNK.js";
 import {
   WriteRateLimiter
 } from "./chunk-TB6CBZ5V.js";
 import {
   maybeRespondRecallNavigation
 } from "./chunk-QZ4U67KO.js";
+import {
+  maybeRespondMemoryBrowse
+} from "./chunk-HMDYSGY6.js";
 import {
   serializeInlineScriptValue
 } from "./chunk-3HSRWJTC.js";
@@ -18,10 +21,10 @@ import {
 } from "./chunk-WNMVUWI7.js";
 import {
   handleSupportPassportOwnerHttp
-} from "./chunk-F6AYWLRN.js";
+} from "./chunk-NE45P3OF.js";
 import {
   buildSupportPassportPublicRequestHandler
-} from "./chunk-ZLVURGAJ.js";
+} from "./chunk-V2XNMIAM.js";
 import {
   handleMcpGetSse
 } from "./chunk-SRT6SHVZ.js";
@@ -34,10 +37,10 @@ import {
   processChatMessage,
   sessionBelongsToPrincipal,
   subscribeChatTranscript
-} from "./chunk-UJXNBZYJ.js";
+} from "./chunk-R4JTUTU6.js";
 import {
   RelayMissionStoreError
-} from "./chunk-OREGA7GY.js";
+} from "./chunk-2JFSQWFH.js";
 import {
   executeResolution,
   isValidResolutionVerb
@@ -59,10 +62,10 @@ import {
   optionalNamespaceKindQueryParam,
   optionalQueryString,
   positiveIntQueryParam
-} from "./chunk-2LRO73MN.js";
+} from "./chunk-DRLZB3CN.js";
 import {
   respondBriefingHttp
-} from "./chunk-C3MCMFNV.js";
+} from "./chunk-2QX65IEC.js";
 import {
   maybeHandleLifecycleFlush
 } from "./chunk-TIDEL77O.js";
@@ -73,14 +76,14 @@ import {
   authorizationProbeNamespaces,
   authorizationProbeRequiresPrincipalNamespace,
   probeOperationAuthorization
-} from "./chunk-T2ZNUWUY.js";
+} from "./chunk-QKFYJVDG.js";
 import {
   getOperation,
   resolveQueryNamespaceWritablePreflight
-} from "./chunk-NKDQXDFL.js";
+} from "./chunk-AS4YKT75.js";
 import {
   handleWhoKnowsHttpQuery
-} from "./chunk-NGAFYIHQ.js";
+} from "./chunk-PPJLJD2D.js";
 import {
   isTrustZoneName
 } from "./chunk-ROBHL3GL.js";
@@ -89,7 +92,7 @@ import {
 } from "./chunk-DEUNUKTD.js";
 import {
   isRecallDisclosure
-} from "./chunk-66YUOI53.js";
+} from "./chunk-WQW6KPVC.js";
 import {
   CorrectionContractError
 } from "./chunk-QLK3SL7Q.js";
@@ -98,7 +101,7 @@ import {
 } from "./chunk-JUOJGZPV.js";
 import {
   peerManifestRevision
-} from "./chunk-TNQR7N52.js";
+} from "./chunk-S3YM4SZQ.js";
 import {
   assertOperationAllowed,
   capabilityAllowsOp,
@@ -1826,6 +1829,7 @@ var EngramAccessHttpServer = class extends ReviewDeckAccessHttpBase {
       return;
     }
     if (await maybeRespondRecallNavigation(req, res, pathname, req.method, (op) => this.enforceTokenOp(op), this.respondJson.bind(this), this.readJsonBody.bind(this), this.service, (ns, sk) => this.wearablesScope(req, ns ?? parsed.searchParams.get("namespace") ?? void 0, sk ?? parsed.searchParams.get("sessionKey") ?? void 0))) return;
+    if (await maybeRespondMemoryBrowse(req, res, pathname, req.method, (op) => this.enforceTokenOp(op), this.respondJson.bind(this), this.readJsonBody.bind(this), this.service, (ns) => this.wearablesScope(req, ns ?? parsed.searchParams.get("namespace") ?? void 0))) return;
     if (req.method === "GET" && (pathname === "/engram/v1/location/status" || pathname === "/remnic/v1/location/status")) {
       this.enforceTokenOp("location_status");
       await respondLocationStatus(res, this.respondJson.bind(this), this.service);
@@ -3595,4 +3599,4 @@ export {
   resolveDefaultAdminConsolePublicDir,
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-5TKHJ5RW.js.map
+//# sourceMappingURL=chunk-MMQVWKFY.js.map