@remnic/core 1.1.12 → 1.1.14

package/dist/chunk-NZL6GGQE.js

@@ -0,0 +1,375 @@
+import {
+  log
+} from "./chunk-2ODBA7MQ.js";
+
+// src/boxes.ts
+import { mkdir, writeFile, readFile, readdir } from "fs/promises";
+import path from "path";
+import { createHash } from "crypto";
+var BOX_DIR = "boxes";
+var STATE_DIR = "state";
+var TRACES_FILE = "traces.json";
+var OPEN_BOX_STATE_FILE = "open-box.json";
+function topicOverlapScore(a, b) {
+  if (a.length === 0 || b.length === 0) return 0;
+  const setA = new Set(a.map((t) => t.toLowerCase()));
+  const setB = new Set(b.map((t) => t.toLowerCase()));
+  const intersection = [...setA].filter((t) => setB.has(t)).length;
+  const union = (/* @__PURE__ */ new Set([...setA, ...setB])).size;
+  return union === 0 ? 0 : intersection / union;
+}
+function makeBoxId() {
+  return `box-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+}
+function makeTraceId(topics) {
+  const key = topics.slice().sort().join(",");
+  return `trace-${createHash("sha256").update(key).digest("hex").slice(0, 8)}`;
+}
+function serializeBoxFrontmatter(fm) {
+  const lines = [
+    "---",
+    `id: ${fm.id}`,
+    `memoryKind: ${fm.memoryKind}`,
+    `createdAt: ${fm.createdAt}`,
+    `sealedAt: ${fm.sealedAt}`,
+    `sealReason: ${fm.sealReason}`,
+    `topics: [${fm.topics.map((t) => `"${t}"`).join(", ")}]`,
+    `memoryIds: [${fm.memoryIds.map((m) => `"${m}"`).join(", ")}]`
+  ];
+  if (fm.sessionKey) lines.push(`sessionKey: ${fm.sessionKey}`);
+  if (fm.traceId) lines.push(`traceId: ${fm.traceId}`);
+  if (fm.goal) lines.push(`goal: ${fm.goal.replace(/[\r\n]+/g, " ")}`);
+  if (fm.toolsUsed?.length) lines.push(`toolsUsed: [${fm.toolsUsed.map((t) => `"${t}"`).join(", ")}]`);
+  if (fm.outcome) lines.push(`outcome: ${fm.outcome}`);
+  lines.push("---");
+  return lines.join("\n");
+}
+function parseBoxFrontmatter(raw) {
+  const match = raw.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return null;
+  const fmBlock = match[1];
+  const fm = {};
+  for (const line of fmBlock.split("\n")) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+    fm[line.slice(0, colonIdx).trim()] = line.slice(colonIdx + 1).trim();
+  }
+  const parseArray = (val) => {
+    if (!val) return [];
+    const m = val.match(/\[(.*)]/);
+    if (!m) return [];
+    return m[1].split(",").map((s) => s.trim().replace(/^"|"$/g, "")).filter(Boolean);
+  };
+  const outcome = fm.outcome;
+  return {
+    id: fm.id ?? "",
+    memoryKind: "box",
+    createdAt: fm.createdAt ?? "",
+    sealedAt: fm.sealedAt ?? "",
+    sealReason: fm.sealReason ?? "forced",
+    sessionKey: fm.sessionKey,
+    topics: parseArray(fm.topics),
+    memoryIds: parseArray(fm.memoryIds),
+    traceId: fm.traceId,
+    goal: fm.goal || void 0,
+    toolsUsed: fm.toolsUsed ? parseArray(fm.toolsUsed) : void 0,
+    outcome: outcome && ["success", "failure", "partial", "unknown"].includes(outcome) ? outcome : void 0
+  };
+}
+var BoxBuilder = class {
+  baseDir;
+  cfg;
+  openBox = null;
+  stateLoaded = false;
+  openBoxMutationChain = Promise.resolve();
+  traceMutationChain = Promise.resolve();
+  constructor(baseDir, cfg) {
+    this.baseDir = baseDir;
+    this.cfg = cfg;
+  }
+  enqueueOpenBoxMutation(op) {
+    const run = this.openBoxMutationChain.catch(() => {
+    }).then(op);
+    this.openBoxMutationChain = run.catch(() => {
+    });
+    return run;
+  }
+  enqueueTraceMutation(op) {
+    const run = this.traceMutationChain.catch(() => {
+    }).then(op);
+    this.traceMutationChain = run.catch(() => {
+    });
+    return run;
+  }
+  get boxBaseDir() {
+    return path.join(this.baseDir, BOX_DIR);
+  }
+  get stateDir() {
+    return path.join(this.baseDir, STATE_DIR);
+  }
+  get openBoxStatePath() {
+    return path.join(this.stateDir, OPEN_BOX_STATE_FILE);
+  }
+  get tracesPath() {
+    return path.join(this.stateDir, TRACES_FILE);
+  }
+  // ── State persistence ────────────────────────────────────────────────────
+  async loadOpenBox() {
+    if (this.stateLoaded) return;
+    this.stateLoaded = true;
+    try {
+      const raw = await readFile(this.openBoxStatePath, "utf-8");
+      this.openBox = JSON.parse(raw);
+    } catch {
+      this.openBox = null;
+    }
+  }
+  async saveOpenBox() {
+    await mkdir(this.stateDir, { recursive: true });
+    if (this.openBox) {
+      await writeFile(this.openBoxStatePath, JSON.stringify(this.openBox, null, 2), "utf-8");
+    } else {
+      try {
+        await writeFile(this.openBoxStatePath, "null", "utf-8");
+      } catch {
+      }
+    }
+  }
+  async loadTraceIndex() {
+    try {
+      const raw = await readFile(this.tracesPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      parsed.traceLastSeen ??= {};
+      return parsed;
+    } catch {
+      return { traces: {}, boxToTrace: {}, traceTopics: {}, traceLastSeen: {} };
+    }
+  }
+  async saveTraceIndex(idx) {
+    try {
+      await mkdir(this.stateDir, { recursive: true });
+      await writeFile(this.tracesPath, JSON.stringify(idx, null, 2), "utf-8");
+    } catch (err) {
+      log.warn(`[engram/boxes] Failed to save trace index: ${err.message}`);
+    }
+  }
+  // ── Core logic ────────────────────────────────────────────────────────────
+  /**
+   * Called after each extraction run.
+   * Decides whether to seal the current open box and/or start a new one.
+   */
+  async onExtraction(event) {
+    await this.enqueueOpenBoxMutation(async () => this.onExtractionUnlocked(event));
+  }
+  async onExtractionUnlocked(event) {
+    if (!this.cfg.memoryBoxesEnabled) return;
+    await this.loadOpenBox();
+    const newTopics = event.topics.filter(Boolean);
+    const now = new Date(event.timestamp);
+    const nowMs = now.getTime();
+    if (this.openBox) {
+      const lastActivity = new Date(this.openBox.lastActivityAt).getTime();
+      const timeGapMs = nowMs - lastActivity;
+      const overlap = topicOverlapScore(this.openBox.topics, newTopics);
+      const topicShifted = newTopics.length > 0 && overlap < this.cfg.boxTopicShiftThreshold;
+      const timeExpired = timeGapMs >= this.cfg.boxTimeGapMs;
+      const tooManyMemories = this.openBox.memoryIds.length + event.memoryIds.length > this.cfg.boxMaxMemories;
+      if (tooManyMemories) {
+        const topicSet = /* @__PURE__ */ new Set([...this.openBox.topics, ...newTopics]);
+        this.openBox.topics = [...topicSet];
+        this.openBox.memoryIds.push(...event.memoryIds);
+        if (event.toolsUsed?.length) {
+          const toolSet = /* @__PURE__ */ new Set([...this.openBox.toolsUsed ?? [], ...event.toolsUsed]);
+          this.openBox.toolsUsed = [...toolSet];
+        }
+        await this.sealCurrentUnlocked("max_memories");
+      } else if (topicShifted) {
+        await this.sealCurrentUnlocked("topic_shift");
+        this.openBox = this.newBox(event, now.toISOString());
+        await this.saveOpenBox();
+      } else if (timeExpired) {
+        await this.sealCurrentUnlocked("time_gap");
+        this.openBox = this.newBox(event, now.toISOString());
+        await this.saveOpenBox();
+      } else {
+        this.openBox.memoryIds.push(...event.memoryIds);
+        const topicSet = /* @__PURE__ */ new Set([...this.openBox.topics, ...newTopics]);
+        this.openBox.topics = [...topicSet];
+        this.openBox.lastActivityAt = now.toISOString();
+        if (event.toolsUsed?.length) {
+          const toolSet = /* @__PURE__ */ new Set([...this.openBox.toolsUsed ?? [], ...event.toolsUsed]);
+          this.openBox.toolsUsed = [...toolSet];
+        }
+        await this.saveOpenBox();
+      }
+    } else {
+      this.openBox = this.newBox(event, now.toISOString());
+      if (this.openBox.memoryIds.length > this.cfg.boxMaxMemories) {
+        await this.sealCurrentUnlocked("max_memories");
+      } else {
+        await this.saveOpenBox();
+      }
+    }
+  }
+  newBox(event, ts) {
+    return {
+      id: makeBoxId(),
+      createdAt: ts,
+      lastActivityAt: ts,
+      topics: event.topics.filter(Boolean),
+      memoryIds: [...event.memoryIds],
+      goal: event.goal,
+      toolsUsed: event.toolsUsed?.length ? [...event.toolsUsed] : void 0
+    };
+  }
+  /**
+   * Seal the current open box and write it to disk.
+   * Also runs trace weaving if enabled.
+   */
+  async sealCurrent(reason) {
+    return this.enqueueOpenBoxMutation(async () => this.sealCurrentUnlocked(reason));
+  }
+  async sealCurrentUnlocked(reason) {
+    await this.loadOpenBox();
+    if (!this.openBox) return null;
+    const box = this.openBox;
+    this.openBox = null;
+    if (box.memoryIds.length === 0 && box.topics.length === 0) {
+      await this.saveOpenBox();
+      return null;
+    }
+    const sealedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const day = sealedAt.slice(0, 10);
+    const dir = path.join(this.boxBaseDir, day);
+    await mkdir(dir, { recursive: true });
+    let traceId;
+    if (this.cfg.traceWeaverEnabled && box.topics.length > 0) {
+      traceId = await this.resolveTrace(box.id, box.topics);
+    }
+    const fm = {
+      id: box.id,
+      memoryKind: "box",
+      createdAt: box.createdAt,
+      sealedAt,
+      sealReason: reason,
+      topics: box.topics,
+      memoryIds: box.memoryIds,
+      traceId,
+      goal: box.goal,
+      toolsUsed: box.toolsUsed?.length ? box.toolsUsed : void 0,
+      outcome: "unknown"
+    };
+    const content = `${serializeBoxFrontmatter(fm)}
+
+<!-- Topics: ${box.topics.join(", ")} | Memories: ${box.memoryIds.length} -->
+`;
+    const filePath = path.join(dir, `${box.id}.md`);
+    await writeFile(filePath, content, "utf-8");
+    log.debug(`[boxes] sealed box ${box.id} (${reason}): ${box.memoryIds.length} memories, topics=[${box.topics.join(",")}]`);
+    await this.saveOpenBox();
+    return box.id;
+  }
+  // ── Trace Weaving ─────────────────────────────────────────────────────────
+  /**
+   * Find an existing trace that matches box topics, or create a new trace.
+   * Returns the traceId to assign to this box.
+   */
+  async resolveTrace(boxId, topics) {
+    return this.enqueueTraceMutation(async () => this.resolveTraceUnlocked(boxId, topics));
+  }
+  async resolveTraceUnlocked(boxId, topics) {
+    const idx = await this.loadTraceIndex();
+    const lookbackMs = this.cfg.traceWeaverLookbackDays * 24 * 60 * 60 * 1e3;
+    const cutoff = new Date(Date.now() - lookbackMs);
+    let bestTraceId;
+    let bestScore = 0;
+    for (const [tid, traceTopics] of Object.entries(idx.traceTopics)) {
+      const lastSeen = idx.traceLastSeen[tid];
+      if (lastSeen && new Date(lastSeen) < cutoff) continue;
+      const score = topicOverlapScore(topics, traceTopics);
+      if (score >= this.cfg.traceWeaverOverlapThreshold && score > bestScore) {
+        bestScore = score;
+        bestTraceId = tid;
+      }
+    }
+    const traceId = bestTraceId ?? makeTraceId(topics);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    if (!idx.traces[traceId]) idx.traces[traceId] = [];
+    idx.traces[traceId].push(boxId);
+    idx.boxToTrace[boxId] = traceId;
+    idx.traceLastSeen[traceId] = now;
+    if (idx.traceTopics[traceId]) {
+      const merged = /* @__PURE__ */ new Set([...idx.traceTopics[traceId], ...topics]);
+      idx.traceTopics[traceId] = [...merged];
+    } else {
+      idx.traceTopics[traceId] = [...topics];
+    }
+    await this.saveTraceIndex(idx);
+    return traceId;
+  }
+  // ── Recall ────────────────────────────────────────────────────────────────
+  /**
+   * Read all sealed boxes from the last N days for recall injection.
+   */
+  async readRecentBoxes(days) {
+    const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
+    const cutoffDateStr = cutoff.toISOString().slice(0, 10);
+    let topEntries;
+    try {
+      topEntries = await readdir(this.boxBaseDir, { withFileTypes: true, encoding: "utf-8" });
+    } catch {
+      return [];
+    }
+    const recentDirs = topEntries.filter((e) => e.isDirectory() && /^\d{4}-\d{2}-\d{2}$/.test(e.name) && e.name >= cutoffDateStr).map((e) => path.join(this.boxBaseDir, e.name));
+    const legacyEntries = topEntries.filter(
+      (e) => !e.isDirectory() || !/^\d{4}-\d{2}-\d{2}$/.test(e.name)
+    );
+    const boxes = [];
+    const readDir = async (dir) => {
+      let files;
+      try {
+        files = (await readdir(dir)).filter((f) => f.endsWith(".md"));
+      } catch {
+        return;
+      }
+      const results = await Promise.all(
+        files.map(async (f) => {
+          try {
+            const raw = await readFile(path.join(dir, f), "utf-8");
+            const parsed = parseBoxFrontmatter(raw);
+            return parsed && new Date(parsed.sealedAt) >= cutoff ? parsed : null;
+          } catch {
+            return null;
+          }
+        })
+      );
+      for (const r of results) {
+        if (r !== null) boxes.push(r);
+      }
+    };
+    await Promise.all(recentDirs.map(readDir));
+    for (const e of legacyEntries) {
+      const full = path.join(this.boxBaseDir, e.name);
+      if (e.isDirectory()) {
+        await readDir(full);
+      } else if (e.name.endsWith(".md")) {
+        try {
+          const raw = await readFile(full, "utf-8");
+          const parsed = parseBoxFrontmatter(raw);
+          if (parsed && new Date(parsed.sealedAt) >= cutoff) boxes.push(parsed);
+        } catch {
+        }
+      }
+    }
+    boxes.sort((a, b) => new Date(b.sealedAt).getTime() - new Date(a.sealedAt).getTime());
+    return boxes;
+  }
+};
+
+export {
+  BOX_DIR,
+  topicOverlapScore,
+  parseBoxFrontmatter,
+  BoxBuilder
+};
+//# sourceMappingURL=chunk-NZL6GGQE.js.map

package/dist/chunk-NZL6GGQE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/boxes.ts"],"sourcesContent":["/**\n * Memory Boxes + Trace Weaving (v8.0 Phase 2A)\n *\n * Implements the Membox concept: a sliding topic window that forms an \"open box\"\n * accumulating related memories. The box is sealed on topic shift or time gap,\n * then written to memory/boxes/YYYY-MM-DD/box-<id>.md.\n *\n * Trace Weaving links recurring topic boxes with a shared traceId so that\n * cross-session continuity on the same topics is preserved and discoverable.\n */\n\nimport { mkdir, writeFile, readFile, readdir } from \"node:fs/promises\";\nimport type { Dirent } from \"node:fs\";\nimport path from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { log } from \"./logger.js\";\n\nexport const BOX_DIR = \"boxes\";\nconst STATE_DIR = \"state\";\nconst TRACES_FILE = \"traces.json\";\nconst OPEN_BOX_STATE_FILE = \"open-box.json\";\n\n// ── Types ─────────────────────────────────────────────────────────────────\n\nexport interface BoxFrontmatter {\n  id: string;\n  memoryKind: \"box\";\n  createdAt: string;\n  sealedAt: string;\n  sealReason: SealReason;\n  sessionKey?: string;\n  topics: string[];\n  memoryIds: string[];\n  traceId?: string;\n  /** High-level task goal for this episode (REMem-inspired). */\n  goal?: string;\n  /** Tools invoked during this episode. */\n  toolsUsed?: string[];\n  /** Episode outcome: success, failure, partial, or unknown. */\n  outcome?: \"success\" | \"failure\" | \"partial\" | \"unknown\";\n}\n\nexport type SealReason = \"topic_shift\" | \"time_gap\" | \"max_memories\" | \"forced\" | \"flush\";\n\ninterface OpenBoxState {\n  id: string;\n  createdAt: string;\n  lastActivityAt: string;\n  topics: string[];\n  memoryIds: string[];\n  goal?: string;\n  toolsUsed?: string[];\n}\n\ninterface TraceIndex {\n  /** traceId → list of box IDs */\n  traces: Record<string, string[]>;\n  /** boxId → traceId */\n  boxToTrace: Record<string, string>;\n  /** traceId → canonical topic fingerprint for matching */\n  traceTopics: Record<string, string[]>;\n  /** traceId → ISO timestamp of last box added (for lookback filtering) */\n  traceLastSeen: Record<string, string>;\n}\n\nexport interface BoxBuilderConfig {\n  memoryBoxesEnabled: boolean;\n  traceWeaverEnabled: boolean;\n  /** Jaccard threshold below which topic shift triggers seal (0-1, default 0.35) */\n  boxTopicShiftThreshold: number;\n  /** Time gap in ms before sealing an open box (default 30 min) */\n  boxTimeGapMs: number;\n  /** Max memories in one box before forced seal */\n  boxMaxMemories: number;\n  /** Days back to look for trace links */\n  traceWeaverLookbackDays: number;\n  /** Minimum topic overlap to assign same traceId (0-1, default 0.4) */\n  traceWeaverOverlapThreshold: number;\n}\n\ninterface ExtractionEvent {\n  topics: string[];\n  memoryIds: string[];\n  timestamp: string;\n  goal?: string;\n  toolsUsed?: string[];\n}\n\n// ── Utility ───────────────────────────────────────────────────────────────\n\n/**\n * Jaccard similarity between two topic arrays.\n * Returns 0.0 for empty inputs.\n */\nexport function topicOverlapScore(a: string[], b: string[]): number {\n  if (a.length === 0 || b.length === 0) return 0.0;\n  const setA = new Set(a.map((t) => t.toLowerCase()));\n  const setB = new Set(b.map((t) => t.toLowerCase()));\n  const intersection = [...setA].filter((t) => setB.has(t)).length;\n  const union = new Set([...setA, ...setB]).size;\n  return union === 0 ? 0.0 : intersection / union;\n}\n\nfunction makeBoxId(): string {\n  return `box-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n}\n\nfunction makeTraceId(topics: string[]): string {\n  const key = topics.slice().sort().join(\",\");\n  return `trace-${createHash(\"sha256\").update(key).digest(\"hex\").slice(0, 8)}`;\n}\n\n// ── Frontmatter serialization ──────────────────────────────────────────────\n\nfunction serializeBoxFrontmatter(fm: BoxFrontmatter): string {\n  const lines = [\n    \"---\",\n    `id: ${fm.id}`,\n    `memoryKind: ${fm.memoryKind}`,\n    `createdAt: ${fm.createdAt}`,\n    `sealedAt: ${fm.sealedAt}`,\n    `sealReason: ${fm.sealReason}`,\n    `topics: [${fm.topics.map((t) => `\"${t}\"`).join(\", \")}]`,\n    `memoryIds: [${fm.memoryIds.map((m) => `\"${m}\"`).join(\", \")}]`,\n  ];\n  if (fm.sessionKey) lines.push(`sessionKey: ${fm.sessionKey}`);\n  if (fm.traceId) lines.push(`traceId: ${fm.traceId}`);\n  if (fm.goal) lines.push(`goal: ${fm.goal.replace(/[\\r\\n]+/g, \" \")}`);\n  if (fm.toolsUsed?.length) lines.push(`toolsUsed: [${fm.toolsUsed.map((t) => `\"${t}\"`).join(\", \")}]`);\n  if (fm.outcome) lines.push(`outcome: ${fm.outcome}`);\n  lines.push(\"---\");\n  return lines.join(\"\\n\");\n}\n\nexport function parseBoxFrontmatter(raw: string): BoxFrontmatter | null {\n  const match = raw.match(/^---\\n([\\s\\S]*?)\\n---/);\n  if (!match) return null;\n\n  const fmBlock = match[1];\n  const fm: Record<string, string> = {};\n  for (const line of fmBlock.split(\"\\n\")) {\n    const colonIdx = line.indexOf(\":\");\n    if (colonIdx === -1) continue;\n    fm[line.slice(0, colonIdx).trim()] = line.slice(colonIdx + 1).trim();\n  }\n\n  const parseArray = (val: string | undefined): string[] => {\n    if (!val) return [];\n    const m = val.match(/\\[(.*)]/);\n    if (!m) return [];\n    return m[1].split(\",\").map((s) => s.trim().replace(/^\"|\"$/g, \"\")).filter(Boolean);\n  };\n\n  const outcome = fm.outcome as BoxFrontmatter[\"outcome\"];\n  return {\n    id: fm.id ?? \"\",\n    memoryKind: \"box\",\n    createdAt: fm.createdAt ?? \"\",\n    sealedAt: fm.sealedAt ?? \"\",\n    sealReason: (fm.sealReason ?? \"forced\") as SealReason,\n    sessionKey: fm.sessionKey,\n    topics: parseArray(fm.topics),\n    memoryIds: parseArray(fm.memoryIds),\n    traceId: fm.traceId,\n    goal: fm.goal || undefined,\n    toolsUsed: fm.toolsUsed ? parseArray(fm.toolsUsed) : undefined,\n    outcome: outcome && [\"success\", \"failure\", \"partial\", \"unknown\"].includes(outcome) ? outcome : undefined,\n  };\n}\n\n// ── BoxBuilder ────────────────────────────────────────────────────────────\n\nexport class BoxBuilder {\n  private baseDir: string;\n  private cfg: BoxBuilderConfig;\n  private openBox: OpenBoxState | null = null;\n  private stateLoaded = false;\n  private openBoxMutationChain: Promise<unknown> = Promise.resolve();\n  private traceMutationChain: Promise<unknown> = Promise.resolve();\n\n  constructor(baseDir: string, cfg: BoxBuilderConfig) {\n    this.baseDir = baseDir;\n    this.cfg = cfg;\n  }\n\n  private enqueueOpenBoxMutation<T>(op: () => Promise<T>): Promise<T> {\n    const run = this.openBoxMutationChain.catch(() => {}).then(op);\n    this.openBoxMutationChain = run.catch(() => {});\n    return run;\n  }\n\n  private enqueueTraceMutation<T>(op: () => Promise<T>): Promise<T> {\n    const run = this.traceMutationChain.catch(() => {}).then(op);\n    this.traceMutationChain = run.catch(() => {});\n    return run;\n  }\n\n  private get boxBaseDir(): string {\n    return path.join(this.baseDir, BOX_DIR);\n  }\n\n  private get stateDir(): string {\n    return path.join(this.baseDir, STATE_DIR);\n  }\n\n  private get openBoxStatePath(): string {\n    return path.join(this.stateDir, OPEN_BOX_STATE_FILE);\n  }\n\n  private get tracesPath(): string {\n    return path.join(this.stateDir, TRACES_FILE);\n  }\n\n  // ── State persistence ────────────────────────────────────────────────────\n\n  private async loadOpenBox(): Promise<void> {\n    if (this.stateLoaded) return;\n    this.stateLoaded = true;\n    try {\n      const raw = await readFile(this.openBoxStatePath, \"utf-8\");\n      this.openBox = JSON.parse(raw) as OpenBoxState;\n    } catch {\n      this.openBox = null;\n    }\n  }\n\n  private async saveOpenBox(): Promise<void> {\n    await mkdir(this.stateDir, { recursive: true });\n    if (this.openBox) {\n      await writeFile(this.openBoxStatePath, JSON.stringify(this.openBox, null, 2), \"utf-8\");\n    } else {\n      // Clear open box state\n      try { await writeFile(this.openBoxStatePath, \"null\", \"utf-8\"); } catch { /* ok */ }\n    }\n  }\n\n  private async loadTraceIndex(): Promise<TraceIndex> {\n    try {\n      const raw = await readFile(this.tracesPath, \"utf-8\");\n      const parsed = JSON.parse(raw) as TraceIndex;\n      // Backfill missing field for indexes written before this field was added\n      parsed.traceLastSeen ??= {};\n      return parsed;\n    } catch {\n      return { traces: {}, boxToTrace: {}, traceTopics: {}, traceLastSeen: {} };\n    }\n  }\n\n  private async saveTraceIndex(idx: TraceIndex): Promise<void> {\n    try {\n      await mkdir(this.stateDir, { recursive: true });\n      await writeFile(this.tracesPath, JSON.stringify(idx, null, 2), \"utf-8\");\n    } catch (err) {\n      log.warn(`[engram/boxes] Failed to save trace index: ${(err as Error).message}`);\n    }\n  }\n\n  // ── Core logic ────────────────────────────────────────────────────────────\n\n  /**\n   * Called after each extraction run.\n   * Decides whether to seal the current open box and/or start a new one.\n   */\n  async onExtraction(event: ExtractionEvent): Promise<void> {\n    await this.enqueueOpenBoxMutation(async () => this.onExtractionUnlocked(event));\n  }\n\n  private async onExtractionUnlocked(event: ExtractionEvent): Promise<void> {\n    if (!this.cfg.memoryBoxesEnabled) return;\n\n    await this.loadOpenBox();\n\n    const newTopics = event.topics.filter(Boolean);\n    const now = new Date(event.timestamp);\n    const nowMs = now.getTime();\n\n    if (this.openBox) {\n      // Check seal conditions\n      const lastActivity = new Date(this.openBox.lastActivityAt).getTime();\n      const timeGapMs = nowMs - lastActivity;\n      const overlap = topicOverlapScore(this.openBox.topics, newTopics);\n      const topicShifted = newTopics.length > 0 && overlap < this.cfg.boxTopicShiftThreshold;\n      const timeExpired = timeGapMs >= this.cfg.boxTimeGapMs;\n      const tooManyMemories =\n        this.openBox.memoryIds.length + event.memoryIds.length > this.cfg.boxMaxMemories;\n\n      if (tooManyMemories) {\n        // Merge topics and add current batch then seal\n        const topicSet = new Set([...this.openBox.topics, ...newTopics]);\n        this.openBox.topics = [...topicSet];\n        this.openBox.memoryIds.push(...event.memoryIds);\n        if (event.toolsUsed?.length) {\n          const toolSet = new Set([...(this.openBox.toolsUsed ?? []), ...event.toolsUsed]);\n          this.openBox.toolsUsed = [...toolSet];\n        }\n        await this.sealCurrentUnlocked(\"max_memories\");\n      } else if (topicShifted) {\n        await this.sealCurrentUnlocked(\"topic_shift\");\n        this.openBox = this.newBox(event, now.toISOString());\n        await this.saveOpenBox();\n      } else if (timeExpired) {\n        await this.sealCurrentUnlocked(\"time_gap\");\n        this.openBox = this.newBox(event, now.toISOString());\n        await this.saveOpenBox();\n      } else {\n        // Accumulate\n        this.openBox.memoryIds.push(...event.memoryIds);\n        // Merge new topics (union)\n        const topicSet = new Set([...this.openBox.topics, ...newTopics]);\n        this.openBox.topics = [...topicSet];\n        this.openBox.lastActivityAt = now.toISOString();\n        // Merge toolsUsed (union)\n        if (event.toolsUsed?.length) {\n          const toolSet = new Set([...(this.openBox.toolsUsed ?? []), ...event.toolsUsed]);\n          this.openBox.toolsUsed = [...toolSet];\n        }\n        await this.saveOpenBox();\n      }\n    } else {\n      // No open box — start one\n      this.openBox = this.newBox(event, now.toISOString());\n      // If this initial batch already exceeds max, seal immediately\n      if (this.openBox.memoryIds.length > this.cfg.boxMaxMemories) {\n        await this.sealCurrentUnlocked(\"max_memories\");\n      } else {\n        await this.saveOpenBox();\n      }\n    }\n  }\n\n  private newBox(event: ExtractionEvent, ts: string): OpenBoxState {\n    return {\n      id: makeBoxId(),\n      createdAt: ts,\n      lastActivityAt: ts,\n      topics: event.topics.filter(Boolean),\n      memoryIds: [...event.memoryIds],\n      goal: event.goal,\n      toolsUsed: event.toolsUsed?.length ? [...event.toolsUsed] : undefined,\n    };\n  }\n\n  /**\n   * Seal the current open box and write it to disk.\n   * Also runs trace weaving if enabled.\n   */\n  async sealCurrent(reason: SealReason): Promise<string | null> {\n    return this.enqueueOpenBoxMutation(async () => this.sealCurrentUnlocked(reason));\n  }\n\n  private async sealCurrentUnlocked(reason: SealReason): Promise<string | null> {\n    await this.loadOpenBox();\n    if (!this.openBox) return null;\n\n    const box = this.openBox;\n    this.openBox = null;\n\n    if (box.memoryIds.length === 0 && box.topics.length === 0) {\n      await this.saveOpenBox();\n      return null;\n    }\n\n    const sealedAt = new Date().toISOString();\n    const day = sealedAt.slice(0, 10);\n    const dir = path.join(this.boxBaseDir, day);\n    await mkdir(dir, { recursive: true });\n\n    let traceId: string | undefined;\n    if (this.cfg.traceWeaverEnabled && box.topics.length > 0) {\n      traceId = await this.resolveTrace(box.id, box.topics);\n    }\n\n    const fm: BoxFrontmatter = {\n      id: box.id,\n      memoryKind: \"box\",\n      createdAt: box.createdAt,\n      sealedAt,\n      sealReason: reason,\n      topics: box.topics,\n      memoryIds: box.memoryIds,\n      traceId,\n      goal: box.goal,\n      toolsUsed: box.toolsUsed?.length ? box.toolsUsed : undefined,\n      outcome: \"unknown\",\n    };\n\n    const content = `${serializeBoxFrontmatter(fm)}\\n\\n<!-- Topics: ${box.topics.join(\", \")} | Memories: ${box.memoryIds.length} -->\\n`;\n    const filePath = path.join(dir, `${box.id}.md`);\n    await writeFile(filePath, content, \"utf-8\");\n    log.debug(`[boxes] sealed box ${box.id} (${reason}): ${box.memoryIds.length} memories, topics=[${box.topics.join(\",\")}]`);\n\n    await this.saveOpenBox();\n    return box.id;\n  }\n\n  // ── Trace Weaving ─────────────────────────────────────────────────────────\n\n  /**\n   * Find an existing trace that matches box topics, or create a new trace.\n   * Returns the traceId to assign to this box.\n   */\n  private async resolveTrace(boxId: string, topics: string[]): Promise<string> {\n    return this.enqueueTraceMutation(async () => this.resolveTraceUnlocked(boxId, topics));\n  }\n\n  private async resolveTraceUnlocked(boxId: string, topics: string[]): Promise<string> {\n    const idx = await this.loadTraceIndex();\n\n    // Filter to traces active within the lookback window\n    const lookbackMs = this.cfg.traceWeaverLookbackDays * 24 * 60 * 60 * 1000;\n    const cutoff = new Date(Date.now() - lookbackMs);\n\n    let bestTraceId: string | undefined;\n    let bestScore = 0;\n\n    for (const [tid, traceTopics] of Object.entries(idx.traceTopics)) {\n      const lastSeen = idx.traceLastSeen[tid];\n      if (lastSeen && new Date(lastSeen) < cutoff) continue; // outside lookback window\n      const score = topicOverlapScore(topics, traceTopics);\n      if (score >= this.cfg.traceWeaverOverlapThreshold && score > bestScore) {\n        bestScore = score;\n        bestTraceId = tid;\n      }\n    }\n\n    const traceId = bestTraceId ?? makeTraceId(topics);\n    const now = new Date().toISOString();\n\n    // Update trace index\n    if (!idx.traces[traceId]) idx.traces[traceId] = [];\n    idx.traces[traceId].push(boxId);\n    idx.boxToTrace[boxId] = traceId;\n    idx.traceLastSeen[traceId] = now;\n\n    // Update canonical topics for this trace (merge)\n    if (idx.traceTopics[traceId]) {\n      const merged = new Set([...idx.traceTopics[traceId], ...topics]);\n      idx.traceTopics[traceId] = [...merged];\n    } else {\n      idx.traceTopics[traceId] = [...topics];\n    }\n\n    await this.saveTraceIndex(idx);\n    return traceId;\n  }\n\n  // ── Recall ────────────────────────────────────────────────────────────────\n\n  /**\n   * Read all sealed boxes from the last N days for recall injection.\n   */\n  async readRecentBoxes(days: number): Promise<BoxFrontmatter[]> {\n    const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);\n    const cutoffDateStr = cutoff.toISOString().slice(0, 10); // \"YYYY-MM-DD\"\n\n    let topEntries: Dirent<string>[];\n    try {\n      topEntries = await readdir(this.boxBaseDir, { withFileTypes: true, encoding: \"utf-8\" });\n    } catch {\n      return [];\n    }\n\n    // Filter day directories by name (YYYY-MM-DD) — skip dirs older than cutoff\n    // without reading a single file from them.\n    const recentDirs = topEntries\n      .filter((e) => e.isDirectory() && /^\\d{4}-\\d{2}-\\d{2}$/.test(e.name) && e.name >= cutoffDateStr)\n      .map((e) => path.join(this.boxBaseDir, e.name));\n\n    // Also include legacy flat entries at the root level (non-date dirs and .md files)\n    const legacyEntries = topEntries.filter(\n      (e) => !e.isDirectory() || !/^\\d{4}-\\d{2}-\\d{2}$/.test(e.name),\n    );\n\n    // Read all files in each recent day directory in parallel (per dir)\n    const boxes: BoxFrontmatter[] = [];\n\n    const readDir = async (dir: string) => {\n      let files: string[];\n      try {\n        files = (await readdir(dir)).filter((f) => f.endsWith(\".md\"));\n      } catch {\n        return;\n      }\n      const results = await Promise.all(\n        files.map(async (f) => {\n          try {\n            const raw = await readFile(path.join(dir, f), \"utf-8\");\n            const parsed = parseBoxFrontmatter(raw);\n            return parsed && new Date(parsed.sealedAt) >= cutoff ? parsed : null;\n          } catch {\n            return null;\n          }\n        }),\n      );\n      for (const r of results) {\n        if (r !== null) boxes.push(r);\n      }\n    };\n\n    // Day dirs in parallel\n    await Promise.all(recentDirs.map(readDir));\n\n    // Legacy non-date entries (walk sub-dirs sequentially but read files in parallel)\n    for (const e of legacyEntries) {\n      const full = path.join(this.boxBaseDir, e.name);\n      if (e.isDirectory()) {\n        await readDir(full);\n      } else if (e.name.endsWith(\".md\")) {\n        try {\n          const raw = await readFile(full, \"utf-8\");\n          const parsed = parseBoxFrontmatter(raw);\n          if (parsed && new Date(parsed.sealedAt) >= cutoff) boxes.push(parsed);\n        } catch { /* corrupt file — skip */ }\n      }\n    }\n\n    // Sort newest-first so slice(0, N) gives the most recent boxes\n    boxes.sort((a, b) => new Date(b.sealedAt).getTime() - new Date(a.sealedAt).getTime());\n    return boxes;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-P4NEIHUT.js

@@ -0,0 +1,108 @@
+import {
+  BoxBuilder
+} from "./chunk-NZL6GGQE.js";
+import {
+  StorageManager
+} from "./chunk-7AAT6G4Q.js";
+import {
+  getCachedEpisodeMap,
+  setCachedEpisodeMap
+} from "./chunk-PFV5C235.js";
+import {
+  countRecallTokenOverlap,
+  normalizeRecallTokens
+} from "./chunk-DT5TVLJE.js";
+
+// src/verified-recall.ts
+function createReadOnlyBoxBuilder(memoryDir) {
+  return new BoxBuilder(memoryDir, {
+    memoryBoxesEnabled: true,
+    traceWeaverEnabled: false,
+    boxTopicShiftThreshold: 0.35,
+    boxTimeGapMs: 30 * 60 * 1e3,
+    boxMaxMemories: 50,
+    traceWeaverLookbackDays: 7,
+    traceWeaverOverlapThreshold: 0.4
+  });
+}
+function scoreVerifiedEpisodeCandidate(box, verifiedMemories, queryTokens) {
+  const matchedFields = /* @__PURE__ */ new Set();
+  let score = 0;
+  const topicMatches = countRecallTokenOverlap(queryTokens, box.topics.join(" "));
+  if (topicMatches > 0) {
+    score += topicMatches * 3;
+    matchedFields.add("topics");
+  }
+  const goalMatches = countRecallTokenOverlap(queryTokens, box.goal);
+  if (goalMatches > 0) {
+    score += goalMatches * 4;
+    matchedFields.add("goal");
+  }
+  const toolMatches = countRecallTokenOverlap(queryTokens, box.toolsUsed?.join(" "));
+  if (toolMatches > 0) {
+    score += toolMatches * 2;
+    matchedFields.add("toolsUsed");
+  }
+  let episodeContentMatches = 0;
+  for (const memory of verifiedMemories) {
+    episodeContentMatches += countRecallTokenOverlap(queryTokens, memory.content);
+  }
+  if (episodeContentMatches > 0) {
+    score += episodeContentMatches * 4;
+    matchedFields.add("episodeContent");
+  }
+  return { score, matchedFields };
+}
+function resolveVerifiedEpisodeMemoriesFromMap(memoryById, memoryIds) {
+  const verified = [];
+  for (const memoryId of memoryIds) {
+    try {
+      const memory = memoryById.get(memoryId);
+      if (!memory) continue;
+      if (memory.frontmatter.status === "archived" || memory.frontmatter.status === "forgotten") continue;
+      if (memory.frontmatter.memoryKind !== "episode") continue;
+      verified.push(memory);
+    } catch {
+    }
+  }
+  return verified;
+}
+async function searchVerifiedEpisodes(options) {
+  const queryTokens = new Set(normalizeRecallTokens(options.query, ["what", "which"]));
+  if (queryTokens.size === 0 || options.maxResults <= 0) return [];
+  const storage = new StorageManager(options.memoryDir);
+  const version = storage.getMemoryStatusVersion();
+  let verifiedMemoryById = getCachedEpisodeMap(storage.dir, version);
+  if (!verifiedMemoryById) {
+    const allMemories = await storage.readAllMemories();
+    verifiedMemoryById = setCachedEpisodeMap(storage.dir, allMemories, version);
+  }
+  const boxes = await createReadOnlyBoxBuilder(options.memoryDir).readRecentBoxes(Math.max(1, Math.floor(options.boxRecallDays ?? 3))).catch(() => []);
+  const candidates = [];
+  for (const box of boxes) {
+    const verifiedMemories = resolveVerifiedEpisodeMemoriesFromMap(verifiedMemoryById, box.memoryIds);
+    if (verifiedMemories.length === 0) continue;
+    const { score, matchedFields } = scoreVerifiedEpisodeCandidate(box, verifiedMemories, queryTokens);
+    if (score <= 0) continue;
+    candidates.push({
+      box,
+      score,
+      matchedFields,
+      verifiedMemories
+    });
+  }
+  return candidates.map((candidate) => ({
+    box: candidate.box,
+    score: candidate.score,
+    verifiedEpisodeCount: candidate.verifiedMemories.length,
+    verifiedMemoryIds: candidate.verifiedMemories.map((memory) => memory.frontmatter.id),
+    matchedFields: [...candidate.matchedFields].sort()
+  })).sort(
+    (left, right) => right.score - left.score || right.verifiedEpisodeCount - left.verifiedEpisodeCount || right.box.sealedAt.localeCompare(left.box.sealedAt)
+  ).slice(0, options.maxResults);
+}
+
+export {
+  searchVerifiedEpisodes
+};
+//# sourceMappingURL=chunk-P4NEIHUT.js.map

package/dist/chunk-P7FMDTKL.js

@@ -0,0 +1,103 @@
+// src/utils/iso-timestamp.ts
+var ISO_UTC_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
+var ISO_OFFSET_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+var FLEXIBLE_ISO_TIMESTAMP_RE = /^(\d{4})-(\d{2})-(\d{2})(?:[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,9})?)?(?:[Zz]|([+-])(\d{2}):(\d{2}))?)?$/;
+function isoDaysInMonth(year, month) {
+  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  return [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1] ?? 0;
+}
+function validateDateComponents(isoString) {
+  const match = isoString.match(
+    /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})/
+  );
+  if (!match) return false;
+  const [, yStr, mStr, dStr, hStr, minStr, sStr] = match;
+  const y = Number(yStr);
+  const m = Number(mStr);
+  const d = Number(dStr);
+  const h = Number(hStr);
+  const min = Number(minStr);
+  const s = Number(sStr);
+  if (m < 1 || m > 12) return false;
+  if (d < 1 || d > 31) return false;
+  if (h > 23 || min > 59 || s > 59) return false;
+  if (d > isoDaysInMonth(y, m)) return false;
+  return true;
+}
+function validateOffset(isoString) {
+  const offsetMatch = isoString.match(/([+-])(\d{2}):(\d{2})$/);
+  if (!offsetMatch) return true;
+  const oh = Number(offsetMatch[2]);
+  const om = Number(offsetMatch[3]);
+  if (oh > 14 || om > 59) return false;
+  if (oh === 14 && om > 0) return false;
+  return true;
+}
+function normalizeUtcForComparison(value) {
+  const fracMatch = value.match(/\.(\d+)Z$/);
+  if (fracMatch) {
+    const ms = (fracMatch[1] + "000").slice(0, 3);
+    return value.replace(/\.\d+Z$/, `.${ms}Z`);
+  }
+  return value.replace(/Z$/, ".000Z");
+}
+function parseIsoUtcTimestamp(value) {
+  if (typeof value !== "string" || !ISO_UTC_TIMESTAMP_RE.test(value)) {
+    return null;
+  }
+  const ts = Date.parse(value);
+  if (!Number.isFinite(ts)) return null;
+  if (!validateDateComponents(value)) return null;
+  const roundTrip = new Date(ts).toISOString();
+  if (roundTrip !== normalizeUtcForComparison(value)) return null;
+  return ts;
+}
+function parseIsoOffsetTimestamp(value) {
+  if (typeof value !== "string" || !ISO_OFFSET_TIMESTAMP_RE.test(value)) {
+    return null;
+  }
+  const ts = Date.parse(value);
+  if (!Number.isFinite(ts)) return null;
+  if (!validateDateComponents(value)) return null;
+  if (!validateOffset(value)) return null;
+  if (value.endsWith("Z")) {
+    const roundTrip = new Date(ts).toISOString();
+    if (roundTrip !== normalizeUtcForComparison(value)) return null;
+  }
+  return ts;
+}
+function parseFlexibleIsoTimestamp(value) {
+  const match = typeof value === "string" ? value.match(FLEXIBLE_ISO_TIMESTAMP_RE) : null;
+  if (!match) {
+    return null;
+  }
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const hour = match[4] === void 0 ? 0 : Number(match[4]);
+  const minute = match[5] === void 0 ? 0 : Number(match[5]);
+  const second = match[6] === void 0 ? 0 : Number(match[6]);
+  const offsetHour = match[8] === void 0 ? void 0 : Number(match[8]);
+  const offsetMinute = match[9] === void 0 ? void 0 : Number(match[9]);
+  const hasTime = match[4] !== void 0;
+  const hasOffset = offsetHour !== void 0 && offsetMinute !== void 0;
+  const hasTimezone = /(?:[Zz]|[+-]\d{2}:\d{2})$/.test(value);
+  if (month < 1 || month > 12 || day < 1 || day > isoDaysInMonth(year, month) || hasTime && !hasTimezone) {
+    return null;
+  }
+  if (hasTime && (hour > 23 || minute > 59 || second > 59)) {
+    return null;
+  }
+  if (hasOffset && (offsetMinute > 59 || offsetHour > 14 || offsetHour === 14 && offsetMinute > 0)) {
+    return null;
+  }
+  const ts = Date.parse(value);
+  return Number.isFinite(ts) ? ts : null;
+}
+
+export {
+  parseIsoUtcTimestamp,
+  parseIsoOffsetTimestamp,
+  parseFlexibleIsoTimestamp
+};
+//# sourceMappingURL=chunk-P7FMDTKL.js.map

package/dist/chunk-P7FMDTKL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/iso-timestamp.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Shared ISO-8601 / RFC 3339 timestamp validation helpers.\n//\n// Two public entry points — a strict UTC-only parser used by the replay\n// pipeline, and a more permissive parser used by bulk-import adapters that\n// need to preserve source timezone offsets. Both share date-component,\n// offset-range, and round-trip validation so they cannot silently diverge.\n// ---------------------------------------------------------------------------\n\n// UTC-only: `...Z`, 0 or 3 fractional digits (replay canonical form).\nconst ISO_UTC_TIMESTAMP_RE =\n  /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$/;\n\n// Lenient: variable-precision fractional seconds and `Z` or `[+-]HH:MM` offset.\nconst ISO_OFFSET_TIMESTAMP_RE =\n  /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$/;\n\nconst FLEXIBLE_ISO_TIMESTAMP_RE =\n  /^(\\d{4})-(\\d{2})-(\\d{2})(?:[Tt](\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d{1,9})?)?(?:[Zz]|([+-])(\\d{2}):(\\d{2}))?)?$/;\n\nfunction isoDaysInMonth(year: number, month: number): number {\n  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n  return [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1] ?? 0;\n}\n\n/**\n * Validate the date/time components of an ISO timestamp string.\n * Catches overflowed dates like Feb 31 that `Date.parse` silently normalizes.\n */\nfunction validateDateComponents(isoString: string): boolean {\n  const match = isoString.match(\n    /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})/,\n  );\n  if (!match) return false;\n  const [, yStr, mStr, dStr, hStr, minStr, sStr] = match;\n  const y = Number(yStr);\n  const m = Number(mStr);\n  const d = Number(dStr);\n  const h = Number(hStr);\n  const min = Number(minStr);\n  const s = Number(sStr);\n  if (m < 1 || m > 12) return false;\n  if (d < 1 || d > 31) return false;\n  if (h > 23 || min > 59 || s > 59) return false;\n  if (d > isoDaysInMonth(y, m)) return false;\n  return true;\n}\n\n/**\n * Validate the timezone offset range if present.\n * Max offset is +/-14:00 per ISO 8601; minute part must be 0-59.\n */\nfunction validateOffset(isoString: string): boolean {\n  const offsetMatch = isoString.match(/([+-])(\\d{2}):(\\d{2})$/);\n  if (!offsetMatch) return true; // `Z` form, no offset to validate.\n  const oh = Number(offsetMatch[2]);\n  const om = Number(offsetMatch[3]);\n  if (oh > 14 || om > 59) return false;\n  // +14:00 is max; offsets like +14:30 are invalid.\n  if (oh === 14 && om > 0) return false;\n  return true;\n}\n\n/**\n * Normalize a `Z`-suffixed ISO timestamp to exactly three fractional digits so\n * the round-trip comparison against `Date.prototype.toISOString()` succeeds\n * regardless of input precision (or absence of a fractional part).\n */\nfunction normalizeUtcForComparison(value: string): string {\n  const fracMatch = value.match(/\\.(\\d+)Z$/);\n  if (fracMatch) {\n    const ms = (fracMatch[1] + \"000\").slice(0, 3);\n    return value.replace(/\\.\\d+Z$/, `.${ms}Z`);\n  }\n  return value.replace(/Z$/, \".000Z\");\n}\n\n/**\n * Strict UTC-only parser — accepts `YYYY-MM-DDTHH:MM:SS[.sss]Z`.\n * Returns milliseconds since epoch, or `null` if invalid.\n */\nexport function parseIsoUtcTimestamp(value: string): number | null {\n  if (typeof value !== \"string\" || !ISO_UTC_TIMESTAMP_RE.test(value)) {\n    return null;\n  }\n  const ts = Date.parse(value);\n  if (!Number.isFinite(ts)) return null;\n  if (!validateDateComponents(value)) return null;\n  const roundTrip = new Date(ts).toISOString();\n  if (roundTrip !== normalizeUtcForComparison(value)) return null;\n  return ts;\n}\n\n/**\n * Lenient parser — accepts variable-precision fractional seconds and either\n * a `Z` suffix or a `[+-]HH:MM` offset. Returns milliseconds since epoch, or\n * `null` if the string is not a well-formed RFC 3339 timestamp.\n */\nexport function parseIsoOffsetTimestamp(value: string): number | null {\n  if (typeof value !== \"string\" || !ISO_OFFSET_TIMESTAMP_RE.test(value)) {\n    return null;\n  }\n  const ts = Date.parse(value);\n  if (!Number.isFinite(ts)) return null;\n  if (!validateDateComponents(value)) return null;\n  if (!validateOffset(value)) return null;\n  // For UTC timestamps (ending in `Z`), verify with a round-trip so that\n  // overflowed UTC calendar dates cannot slip through.\n  if (value.endsWith(\"Z\")) {\n    const roundTrip = new Date(ts).toISOString();\n    if (roundTrip !== normalizeUtcForComparison(value)) return null;\n  }\n  return ts;\n}\n\n/**\n * Benchmark/adapter parser — accepts ISO date-only values plus reduced\n * precision date-times used by public benchmark fixtures. Returns milliseconds\n * since epoch, or `null` if invalid.\n */\nexport function parseFlexibleIsoTimestamp(value: string): number | null {\n  const match = typeof value === \"string\"\n    ? value.match(FLEXIBLE_ISO_TIMESTAMP_RE)\n    : null;\n  if (!match) {\n    return null;\n  }\n\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const hour = match[4] === undefined ? 0 : Number(match[4]);\n  const minute = match[5] === undefined ? 0 : Number(match[5]);\n  const second = match[6] === undefined ? 0 : Number(match[6]);\n  const offsetHour = match[8] === undefined ? undefined : Number(match[8]);\n  const offsetMinute = match[9] === undefined ? undefined : Number(match[9]);\n  const hasTime = match[4] !== undefined;\n  const hasOffset = offsetHour !== undefined && offsetMinute !== undefined;\n  const hasTimezone = /(?:[Zz]|[+-]\\d{2}:\\d{2})$/.test(value);\n\n  if (\n    month < 1 ||\n    month > 12 ||\n    day < 1 ||\n    day > isoDaysInMonth(year, month) ||\n    (hasTime && !hasTimezone)\n  ) {\n    return null;\n  }\n  if (hasTime && (hour > 23 || minute > 59 || second > 59)) {\n    return null;\n  }\n  if (\n    hasOffset &&\n    (offsetMinute > 59 ||\n      offsetHour > 14 ||\n      (offsetHour === 14 && offsetMinute > 0))\n  ) {\n    return null;\n  }\n\n  const ts = Date.parse(value);\n  return Number.isFinite(ts) ? ts : null;\n}\n"],"mappings":"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","names":[]}