@remnic/core 9.3.722 → 9.3.724

package/dist/{chunk-EBDA5TYA.js → chunk-FXCIOLRB.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-ZBJMUXZH.js";
 import {
   StorageManager
-} from "./chunk-EVPNWN7Z.js";
+} from "./chunk-4R3CGCI5.js";
 import {
   getCachedEpisodeMap,
   setCachedEpisodeMap
@@ -107,4 +107,4 @@ export {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
 };
-//# sourceMappingURL=chunk-EBDA5TYA.js.map
+//# sourceMappingURL=chunk-FXCIOLRB.js.map

package/dist/{chunk-TXQCG6SE.js → chunk-H7HUQIY7.js}

@@ -10,10 +10,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-EDOQM4E4.js";
+} from "./chunk-WAFDHKES.js";
 import {
   StorageManager
-} from "./chunk-EVPNWN7Z.js";
+} from "./chunk-4R3CGCI5.js";
 import {
   MEMORY_LIFECYCLE_EVENT_SORT_ORDER,
   buildLifecycleEventsForMemory,
@@ -929,4 +929,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-TXQCG6SE.js.map
+//# sourceMappingURL=chunk-H7HUQIY7.js.map

package/dist/{chunk-QD6QP5P6.js → chunk-I2HL5M6T.js}

@@ -47,12 +47,12 @@ import {
 } from "./chunk-D6RIFG4O.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-6FAMMBQ3.js";
+} from "./chunk-UBHVAGO7.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-TXQCG6SE.js";
+} from "./chunk-H7HUQIY7.js";
 import {
   rebuildObservations
 } from "./chunk-LZZNTPLR.js";
@@ -70,7 +70,7 @@ import {
 } from "./chunk-GQL52GQ5.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-J3JPB7ZI.js";
+} from "./chunk-FACTVMXQ.js";
 import {
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
@@ -81,7 +81,7 @@ import {
 } from "./chunk-D7EBTQ24.js";
 import {
   parseXrayCliOptions
-} from "./chunk-BXEOHV7K.js";
+} from "./chunk-ZOHMPFOB.js";
 import {
   runBenchmarkRecall,
   runOperatorConfigReview,
@@ -89,12 +89,12 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-A5XNBK2D.js";
+} from "./chunk-DF3I6JGP.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-EEJMD2L2.js";
+} from "./chunk-6CWGS2LY.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -124,13 +124,13 @@ import {
 } from "./chunk-TERNBNJB.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-EBDA5TYA.js";
+} from "./chunk-FXCIOLRB.js";
 import {
   ThreadingManager
 } from "./chunk-QRDOSYOR.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-YEE5KJQQ.js";
+} from "./chunk-T55EGZSJ.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -145,7 +145,7 @@ import {
 } from "./chunk-33JBK2XP.js";
 import {
   formatNamespaceMaintenanceHealthText
-} from "./chunk-PD42EYQN.js";
+} from "./chunk-5OPYYPJN.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -215,7 +215,7 @@ import {
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-UIXXE6NI.js";
+} from "./chunk-C6BWLYW5.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
@@ -228,10 +228,10 @@ import {
   createProductionChatLlmAdapter,
   loadChatSession,
   sessionBelongsToPrincipal
-} from "./chunk-B7WISIAJ.js";
+} from "./chunk-FN6QP7JQ.js";
 import {
   EngramAccessService
-} from "./chunk-GDUOCHCD.js";
+} from "./chunk-KGZF2VO3.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -243,13 +243,13 @@ import {
   parseRecallExplainFormat,
   renderRecallExplain,
   renderXray
-} from "./chunk-7CTNUVHZ.js";
+} from "./chunk-6SQQOJ4U.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-EDOQM4E4.js";
+} from "./chunk-WAFDHKES.js";
 import {
   getTrustZoneStoreStatus,
   promoteTrustZoneRecord,
@@ -274,7 +274,7 @@ import {
 import {
   RECALL_DISCLOSURE_LEVELS,
   isRecallDisclosure
-} from "./chunk-ILFSEIRT.js";
+} from "./chunk-7AG54AF3.js";
 import {
   RECALL_FALLBACK_DIRS
 } from "./chunk-VS2IYZRU.js";
@@ -6825,7 +6825,7 @@ Semantic consolidation complete. clusters=${result.clustersFound}, consolidated=
           console.error(`Invalid --format '${fmt}'. Must be one of: text, json, markdown`);
           process.exit(1);
         }
-        const { normalizeDreamsStatusWindowHours } = await import("./dreams-ledger-3WSCI5V4.js");
+        const { normalizeDreamsStatusWindowHours } = await import("./dreams-ledger-6UODQOX6.js");
         let windowHours;
         const rawWindowHours = options.windowHours;
         try {
@@ -7505,4 +7505,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-QD6QP5P6.js.map
+//# sourceMappingURL=chunk-I2HL5M6T.js.map

package/dist/{chunk-M7R5R6OJ.js → chunk-IAIPNEHD.js}

@@ -347,9 +347,27 @@ function resolveFactEventTime(expression, anchorIso) {
     eventTimeSource: "assumed"
   };
 }
+function pickFactEventTimeAnchor(fact, batchAnchor) {
+  if (typeof fact.sourceTurnTimestamp === "string" && fact.sourceTurnTimestamp.trim().length > 0) {
+    const ms = parseFlexibleIsoTimestamp(fact.sourceTurnTimestamp.trim());
+    if (ms !== null) return new Date(ms).toISOString();
+  }
+  if (fact.sources && fact.sources.length > 0) {
+    let earliestMs = null;
+    for (const src of fact.sources) {
+      if (typeof src.observedAt !== "string") continue;
+      const ms = parseFlexibleIsoTimestamp(src.observedAt.trim());
+      if (ms === null) continue;
+      if (earliestMs === null || ms < earliestMs) earliestMs = ms;
+    }
+    if (earliestMs !== null) return new Date(earliestMs).toISOString();
+  }
+  return batchAnchor;
+}
 
 export {
   resolveEventTime,
-  resolveFactEventTime
+  resolveFactEventTime,
+  pickFactEventTimeAnchor
 };
-//# sourceMappingURL=chunk-M7R5R6OJ.js.map
+//# sourceMappingURL=chunk-IAIPNEHD.js.map

package/dist/{chunk-M7R5R6OJ.js.map → chunk-IAIPNEHD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/event-time.ts"],"sourcesContent":["/**\n * Event-time resolver (issue #1578).\n *\n * Extraction can carry an optional per-fact `eventTime` expression — an ISO\n * date or a relative phrase verbatim from the source turn (\"last March\",\n * \"yesterday\", \"since 2024\").  This module resolves such expressions into a\n * `[validFrom, validUntil)` event-time interval, **anchored to the source\n * turn's timestamp** — never to `Date.now()`.\n *\n * Why anchor (not wall-clock): replay/import of old transcripts must resolve\n * \"yesterday\" against the *old* turn's yesterday, not today.  A relative\n * expression is meaningless without its anchor; resolving it against the\n * current time would silently rewrite history (AGENTS.md §39 — byte-identical\n * when the feature is off; rule 35 — half-open intervals; rule 51 — never\n * silently default invalid input).\n *\n * Resolution is **write-time-only**.  The on-disk frontmatter stores absolute\n * ISO timestamps strings (`valid_at` / `invalid_at`); readers never call back\n * into this module.  Anything unresolvable yields `ok: false` and the caller\n * records `eventTimeSource: \"assumed\"` with `valid_at` copied from the\n * ingestion anchor (`observedAt`).\n *\n * Interval semantics are `[validFrom, validUntil)` — inclusive start,\n * exclusive end (AGENTS.md §23).  A date-only expression resolving an *end*\n * bound converts to start-of-next-day so the end date itself is excluded.\n */\nimport { parseFlexibleIsoTimestamp } from \"./utils/iso-timestamp.js\";\n\n/**\n * Resolved event-time interval.  All timestamps are UTC ISO strings.\n *\n * - `validFrom` / `validUntil` carry the half-open `[from, until)` event\n *   interval.  Either may be absent when the expression only pinned one side\n *   (\"since 2024\" → validFrom only).\n * - `ok` is false when the expression could not be resolved.  The caller then\n *   falls back to `eventTimeSource: \"assumed\"`.\n */\nexport interface ResolvedEventTime {\n  validFrom?: string;\n  validUntil?: string;\n  ok: boolean;\n}\n\nconst UNITS = [\"day\", \"week\", \"month\", \"quarter\", \"year\"] as const;\ntype RelativeUnit = (typeof UNITS)[number];\n\nfunction isRelativeUnit(unit: string): unit is RelativeUnit {\n  return (UNITS as readonly string[]).includes(unit);\n}\n\n/**\n * Format a `Date` as a UTC ISO string with millisecond precision, matching the\n * canonical frontmatter form.  Returns `undefined` when the input is not\n * finite (the resolver treats that as unresolvable rather than emitting\n * `Invalid Date`).\n */\nfunction toIsoUtc(ms: number | null): string | undefined {\n  if (ms === null || !Number.isFinite(ms)) return undefined;\n  return new Date(ms).toISOString();\n}\n\n/**\n * Compute the start of the day (UTC) for the given ms, used when a date-only\n * expression resolves a *start* bound — the fact holds from midnight UTC.\n */\nfunction startOfDayUtc(ms: number): number {\n  const d = new Date(ms);\n  d.setUTCHours(0, 0, 0, 0);\n  return d.getTime();\n}\n\n/**\n * Compute the start of the *next* day (UTC) for the given ms, used when a\n * date-only expression resolves an *end* bound — the exclusive `validUntil`\n * must land on the following midnight so the end date itself is excluded\n * (AGENTS.md §23: date-only ends convert to start-of-next-day).\n */\nfunction startOfNextDayUtc(ms: number): number {\n  const d = new Date(startOfDayUtc(ms));\n  d.setUTCDate(d.getUTCDate() + 1);\n  return d.getTime();\n}\n\nconst SEASON_TO_MONTH: Record<string, number> = {\n  winter: 12, // Dec–Feb anchor Dec (Northern Hemisphere convention)\n  spring: 3,\n  summer: 6,\n  fall: 9,\n  autumn: 9,\n};\n\nconst MONTH_NAMES: Record<string, number> = {\n  january: 1, february: 2, march: 3, april: 4, may: 5, june: 6,\n  july: 7, august: 8, september: 9, october: 10, november: 11, december: 12,\n  jan: 1, feb: 2, mar: 3, apr: 4, jun: 6, jul: 7, aug: 8, sep: 9, sept: 9,\n  oct: 10, nov: 11, dec: 12,\n};\n\nconst QUARTER_START_MONTH: Record<number, number> = {\n  1: 1, 2: 4, 3: 7, 4: 10,\n};\n\nfunction monthIndex(token: string): number | undefined {\n  const idx = MONTH_NAMES[token.toLowerCase()];\n  return typeof idx === \"number\" ? idx : undefined;\n}\n\n/**\n * Construct a UTC timestamp from year/month(1-12)/day with overflow validation.\n * Returns `null` when the components do not form a real calendar date (e.g.\n * Feb 30) rather than letting `Date` silently roll over.\n */\nfunction buildDateMs(year: number, month1: number, day: number): number | null {\n  if (\n    !Number.isInteger(year) ||\n    !Number.isInteger(month1) ||\n    month1 < 1 ||\n    month1 > 12 ||\n    !Number.isInteger(day) ||\n    day < 1 ||\n    day > daysInMonth(year, month1)\n  ) {\n    return null;\n  }\n  return Date.UTC(year, month1 - 1, day, 0, 0, 0, 0);\n}\n\nfunction daysInMonth(year: number, month1: number): number {\n  return new Date(Date.UTC(year, month1, 0)).getUTCDate();\n}\n\n/**\n * Add `count` units to a UTC ms timestamp, returning the start-of-period for\n * the resulting date.  Used by \"last/this/next <unit>\" resolution.\n */\nfunction shiftUnit(anchorMs: number, unit: RelativeUnit, count: number): number {\n  const d = new Date(anchorMs);\n  switch (unit) {\n    case \"day\":\n      d.setUTCDate(d.getUTCDate() + count);\n      return startOfDayUtc(d.getTime());\n    case \"week\":\n      d.setUTCDate(d.getUTCDate() + count * 7);\n      return startOfDayUtc(d.getTime());\n    case \"month\":\n      d.setUTCMonth(d.getUTCMonth() + count, 1);\n      return startOfDayUtc(d.getTime());\n    case \"quarter\":\n      d.setUTCMonth(d.getUTCMonth() + count * 3, 1);\n      return startOfDayUtc(d.getTime());\n    case \"year\":\n      d.setUTCFullYear(d.getUTCFullYear() + count, 0, 1);\n      return startOfDayUtc(d.getTime());\n  }\n}\n\n/**\n * Resolve \"last December\" / \"this March\" / \"next Q2\" against the anchor.\n * `direction` is -1 (last), 0 (this), +1 (next).  Returns the start-of-period\n * ms for the referenced month/season/quarter, or `null` if it cannot be\n * placed (e.g. month token not recognized).\n */\nfunction resolveMonthYear(\n  anchorMs: number,\n  monthToken: string,\n  direction: number,\n): number | null {\n  const lower = monthToken.toLowerCase();\n  const targetMonth = monthIndex(lower);\n  if (typeof targetMonth === \"number\") {\n    const d = new Date(anchorMs);\n    let year = d.getUTCFullYear();\n    let m = targetMonth;\n    if (direction === -1 && m >= d.getUTCMonth() + 1) year -= 1;\n    else if (direction === +1 && m <= d.getUTCMonth() + 1) year += 1;\n    return buildDateMs(year, m, 1);\n  }\n  return null;\n}\n/**\n * Resolve an explicit \"<month|season> <year>\" token (e.g. \"march 2025\",\n * \"dec 2024\", \"spring 2025\") to a start-of-month ms.  The explicit year is\n * authoritative — it is never derived from the anchor.  Returns null when\n * the token is not in that shape or does not name a real month/season.\n * Shared by the bare phrase path, \"since <month> <year>\", and the end bound\n * so all three resolve identically (review: month-year phrases after since).\n */\nfunction resolveExplicitMonthYear(token: string): number | null {\n  const m = token.trim().toLowerCase().match(/^([a-z]+)\\s+(\\d{4})$/);\n  if (!m) return null;\n  const year = parseInt(m[2], 10);\n  if (!Number.isInteger(year)) return null;\n  const monthIdx = monthIndex(m[1]);\n  const baseMonth = typeof monthIdx === \"number\" ? monthIdx : SEASON_TO_MONTH[m[1]];\n  if (typeof baseMonth !== \"number\") return null;\n  return buildDateMs(year, baseMonth, 1);\n}\n\n\n/**\n * Resolve a bare four-digit year token (e.g. \"2024\") to January 1 of that\n * year.  Used by \"since 2024\" and bare year expressions.  Review #1578 r2:\n * previously these fell through to ok:false, stamping the fact at ingestion\n * time instead of the documented year start.\n */\nfunction resolveBareYear(token: string): number | null {\n  const m = token.trim().match(/^(\\d{4})$/);\n  if (!m) return null;\n  return buildDateMs(Number(m[1]), 1, 1);\n}\n\n\n/**\n * Check whether the anchor month falls inside a season's 3-month span.\n * Seasons start at `baseMonth` and span 3 months (e.g. summer = Jun–Aug).\n * Winter (Dec=12) wraps: Dec, Jan, Feb.\n */\nfunction isInSeason(baseMonth: number, anchorMonth: number): boolean {\n  for (let i = 0; i < 3; i++) {\n    if (((baseMonth - 1 + i) % 12) + 1 === anchorMonth) return true;\n  }\n  return false;\n}\n\nfunction resolveSeasonYear(\n  anchorMs: number,\n  seasonToken: string,\n  direction: number,\n): number | null {\n  const baseMonth = SEASON_TO_MONTH[seasonToken.toLowerCase()];\n  if (typeof baseMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n\n  if (direction === -1) {\n    // \"last <season>\": go to the previous occurrence.\n    // If the season hasn't started yet this year (baseMonth > anchorMonth)\n    // or the anchor is currently INSIDE the season, roll back a year.\n    if (baseMonth > anchorMonth || isInSeason(baseMonth, anchorMonth)) year -= 1;\n    // Winter tail (Jan/Feb): current winter started prev Dec, so \"last\"\n    // needs one more year back.\n    if (baseMonth === 12 && anchorMonth <= 2) year -= 1;\n  } else if (direction === +1) {\n    // \"next <season>\": go to the next occurrence.\n    // Winter from Jan/Feb: current winter started prev Dec; next is this Dec.\n    if (baseMonth === 12 && anchorMonth <= 2) {\n      // no year change — next winter is December of the anchor year\n    } else if (baseMonth < anchorMonth || isInSeason(baseMonth, anchorMonth)) {\n      year += 1;\n    }\n  } else if (direction === 0 && baseMonth === 12 && anchorMonth <= 2) {\n    // \"this winter\" from Jan/Feb: winter started in the previous December.\n    year -= 1;\n  }\n  return buildDateMs(year, baseMonth, 1);\n}\n\nfunction resolveQuarter(\n  anchorMs: number,\n  qNumber: number,\n  direction: number,\n): number | null {\n  const startMonth = QUARTER_START_MONTH[qNumber];\n  if (typeof startMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n  const anchorQ = Math.floor((anchorMonth - 1) / 3) + 1;\n  // Roll back/forward when the target quarter hasn't started yet this year\n  // (startMonth past the anchor month) OR when the anchor is currently\n  // INSIDE the target quarter (review r2: \"last Q2\" from May returned 2026\n  // instead of 2025 because the quarter start month had already passed but\n  // the quarter was still ongoing).\n  if (direction === -1 && (startMonth >= anchorMonth || anchorQ === qNumber))\n    year -= 1;\n  else if (direction === +1 && (startMonth <= anchorMonth || anchorQ === qNumber))\n    year += 1;\n  return buildDateMs(year, startMonth, 1);\n}\n\n/**\n * Resolve an absolute ISO date/datetime to ms.  A date-only value yields\n * start-of-day (UTC).  Returns `null` when the string is not a well-formed,\n * non-overflowed ISO timestamp.\n */\nfunction resolveAbsolute(raw: string): number | null {\n  const trimmed = raw.trim();\n  // YYYY-MM (ISO year-month, no day) → first day of that month, UTC\n  // (#1578 review r3: the prompt example \"until 2025-06\" must resolve, not\n  // fall back to \"assumed\").\n  const ym = /^(\\d{4})-(\\d{2})$/.exec(trimmed);\n  if (ym) {\n    const ms = buildDateMs(Number(ym[1]), Number(ym[2]), 1);\n    return ms === null ? null : startOfDayUtc(ms);\n  }\n  const ms = parseFlexibleIsoTimestamp(trimmed);\n  if (ms === null) return null;\n  // Date-only inputs (no T) anchor to start-of-day UTC.\n  if (!/[Tt]/.test(trimmed)) return startOfDayUtc(ms);\n  return ms;\n}\n\n/**\n * Resolve a relative event-time expression against an anchor ISO timestamp.\n *\n * Supported shapes (case-insensitive, trimmed):\n *   - absolute ISO date / datetime: `\"2026-03-01\"`, `\"2026-03-01T00:00:00Z\"`\n *   - `\"since <date|monthyear>\"` → validFrom only\n *   - `\"until <date|monthyear>\"` / `\"through ...\"` / `\"until end of ...\"` → validUntil only\n *   - `\"last <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"this <month|season|Qn|unit>\"` → validFrom = start of current period\n *   - `\"next <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"yesterday\"` / `\"today\"` / `\"tomorrow\"` → validFrom = start of that day\n *\n * Anything else returns `{ ok: false }`.  The caller then records\n * `eventTimeSource: \"assumed\"`.\n *\n * @param expression the raw per-fact event-time phrase (may be empty/garbage)\n * @param anchorIso  the source turn's ISO timestamp — the resolution anchor\n */\nexport function resolveEventTime(\n  expression: string | undefined | null,\n  anchorIso: string,\n): ResolvedEventTime {\n  const fallback: ResolvedEventTime = { ok: false };\n  if (typeof expression !== \"string\") return fallback;\n  const expr = expression.trim();\n  if (expr.length === 0) return fallback;\n\n  const anchorMs = parseFlexibleIsoTimestamp(anchorIso);\n  if (anchorMs === null || !Number.isFinite(anchorMs)) return fallback;\n\n  const lower = expr.toLowerCase();\n\n  // ── \"since <x>\" / \"until <x>\" / \"through <x>\" ──────────────────────────\n  const sinceMatch = lower.match(/^since\\s+(.+)$/);\n  if (sinceMatch) {\n    const inner = sinceMatch[1].trim();\n    let fromMs =\n      resolveRelativePeriod(anchorMs, inner) ??\n      resolveExplicitMonthYear(inner) ??\n      resolveBareYear(inner) ??\n      resolveAbsolute(inner);\n    // \"since <bare month/season>\": if the resolved start is future and the\n    // expression carries no explicit 4-digit year, the fact meant the most\n    // recent PAST occurrence of that period (codex review r2: \"since March\"\n    // from January produced a future validFrom).\n    if (\n      fromMs !== null &&\n      fromMs > anchorMs &&\n      !/\\d{4}/.test(inner)\n    ) {\n      const nd = new Date(fromMs);\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      fromMs = nd.getTime();\n    }\n    const fromIso = toIsoUtc(fromMs);\n    if (!fromIso) return fallback;\n    return { validFrom: fromIso, ok: true };\n  }\n  const untilMatch = lower.match(/^(?:until|through|till|ending)\\s+(.+)$/);\n  if (untilMatch) {\n    const inner = untilMatch[1].trim();\n    const untilMs = resolveEndBound(anchorMs, inner);\n    const untilIso = toIsoUtc(untilMs);\n    if (!untilIso) return fallback;\n    return { validUntil: untilIso, ok: true };\n  }\n\n  // ── \"yesterday\" / \"today\" / \"tomorrow\" ─────────────────────────────────\n  if (lower === \"today\") {\n    const fromIso = toIsoUtc(startOfDayUtc(anchorMs));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"yesterday\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", -1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"tomorrow\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", +1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── \"last/this/next <period>\" ──────────────────────────────────────────\n  const relMatch = lower.match(/^(last|this|next)\\s+(.+)$/);\n  if (relMatch) {\n    const direction = relMatch[1] === \"last\" ? -1 : relMatch[1] === \"next\" ? +1 : 0;\n    const period = relMatch[2].trim();\n    const ms = resolveRelativePeriod(anchorMs, period, direction);\n    const fromIso = toIsoUtc(ms);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── bare month+year (\"March 2025\", \"Dec 2024\", \"spring 2025\") or\n  // bare four-digit year (\"2024\") ────────────────────────────────────────\n  // Explicit year is authoritative (never derived from the anchor). Shares\n  // resolveExplicitMonthYear / resolveBareYear with the since/until paths.\n  const explicitMs = resolveExplicitMonthYear(lower) ?? resolveBareYear(lower);\n  if (explicitMs !== null) {\n    const fromIso = toIsoUtc(explicitMs);\n    if (fromIso) return { validFrom: fromIso, ok: true };\n  }\n\n  // ── absolute ISO date / datetime ───────────────────────────────────────\n  const absMs = resolveAbsolute(expr);\n  if (absMs !== null) {\n    const fromIso = toIsoUtc(absMs);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Resolve a period token (with optional direction) to a start-of-period ms.\n * Handles month/season names, quarter tokens (`q1`..`q4`), and relative units\n * (`day/week/month/quarter/year`) used by \"last week\", \"this month\", etc.\n */\nfunction resolveRelativePeriod(\n  anchorMs: number,\n  period: string,\n  direction: number = 0,\n): number | null {\n  const lower = period.trim().toLowerCase();\n\n  // Quarter token: \"q1\", \"Q2\", \"quarter 3\"\n  const qTok = lower.match(/^q(?:uarter)?\\s?([1-4])$/);\n  if (qTok) {\n    return resolveQuarter(anchorMs, Number(qTok[1]), direction);\n  }\n  if (lower === \"quarter\") {\n    // \"last quarter\" / \"next quarter\" move the quarter INDEX (with year\n    // wraparound), not just the year — resolveQuarter only nudges the year\n    // for an explicit quarter number, so routing \"last quarter\" through it\n    // returned the current quarter's start (review: bare last/next quarter).\n    const d = new Date(anchorMs);\n    let q = Math.floor(d.getUTCMonth() / 3) + 1;\n    let year = d.getUTCFullYear();\n    if (direction === -1) {\n      q -= 1;\n      if (q < 1) { q = 4; year -= 1; }\n    } else if (direction === +1) {\n      q += 1;\n      if (q > 4) { q = 1; year += 1; }\n    }\n    return buildDateMs(year, QUARTER_START_MONTH[q], 1);\n  }\n\n  // Relative unit: \"week\", \"month\", \"year\", \"day\"\n  if (isRelativeUnit(lower)) {\n    return shiftUnit(anchorMs, lower, direction);\n  }\n\n  // Month or season name\n  const monthMs = resolveMonthYear(anchorMs, lower, direction);\n  if (monthMs !== null) return monthMs;\n  const seasonMs = resolveSeasonYear(anchorMs, lower, direction);\n  if (seasonMs !== null) return seasonMs;\n\n  return null;\n}\n\n/**\n * Resolve an end-bound period to an *exclusive* upper bound ms.  Date-only\n * values convert to start-of-next-day (AGENTS.md §23); period names resolve to\n * the start of the *following* period.\n */\nfunction resolveEndBound(anchorMs: number, period: string): number | null {\n  // Strip an optional \"end of \" prefix so \"until end of March\" resolves the\n  // same as \"until March\".  Review #1578 r2: previously the prefix was passed\n  // unchanged and resolveEndBound returned null for the full phrase.\n  const trimmed = period.trim().replace(/^end\\s+of\\s+/i, \"\").trim();\n\n  // Bare four-digit year: exclusive end = January 1 of the FOLLOWING year.\n  if (/^\\d{4}$/.test(trimmed)) {\n    return buildDateMs(Number(trimmed) + 1, 1, 1);\n  }\n\n  // YYYY-MM (year-month) end bound: exclusive end = start of the FOLLOWING\n  // month, so \"until 2025-06\" spans all of June (#1578 review r3).\n  const ymEnd = /^(\\d{4})-(\\d{2})$/.exec(trimmed);\n  if (ymEnd) {\n    const startMs = buildDateMs(Number(ymEnd[1]), Number(ymEnd[2]), 1);\n    if (startMs === null) return null;\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 1);\n    return startOfDayUtc(nd.getTime());\n  }\n\n  // Absolute date/datetime end bound.\n  const absMs = resolveAbsolute(trimmed);\n  if (absMs !== null) {\n    // Date-only → start of next day (exclusive end).  Datetime → use as-is.\n    if (!/[Tt]/.test(trimmed)) return startOfNextDayUtc(absMs);\n    return absMs;\n  }\n  // Explicit \"<month|season> <year>\" end bound (e.g. \"until March 2025\",\n  // \"through spring 2025\"). The explicit year is authoritative, so the\n  // exclusive end = start of the FOLLOWING month (for a single month) or the\n  // start of the month AFTER the season ends (for a 3-month season).\n  // Review r2: seasons previously advanced only 1 month, cutting off the\n  // last 2 months of the season.\n  const explicitMs = resolveExplicitMonthYear(trimmed);\n  if (explicitMs !== null) {\n    const nd = new Date(explicitMs);\n    const firstWord = trimmed.toLowerCase().split(/\\s+/)[0];\n    const monthAdvance = firstWord in SEASON_TO_MONTH ? 3 : 1;\n    nd.setUTCMonth(nd.getUTCMonth() + monthAdvance);\n    return startOfDayUtc(nd.getTime());\n  }\n\n  // Period-name end bound: month → exclusive end at start of the FOLLOWING\n  // month. \"until <month>\" is backwards-looking (the fact already stopped\n  // being true), so prefer the most recent PAST boundary: build it in the\n  // anchor year and roll back a year if that boundary is still future.\n  const lower = trimmed.toLowerCase();\n  const monthIdx = monthIndex(lower);\n  if (typeof monthIdx === \"number\") {\n    const d = new Date(anchorMs);\n    const startMs = buildDateMs(d.getUTCFullYear(), monthIdx, 1);\n    if (startMs === null) return null;\n    // Exclusive end = start of the month AFTER the named month.\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 1);\n    let endMs = startOfDayUtc(nd.getTime());\n    // Only roll back when the named month boundary is genuinely future\n    // relative to the anchor cycle.  When the anchor IS in the named month,\n    // the end of the current month is the right boundary — do not roll back\n    // (cursor review r2: \"until March\" from mid-March returned the prior year).\n    if (endMs > anchorMs && d.getUTCMonth() + 1 !== monthIdx) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  // Season end bound: advance by the full 3-month season.  Same\n  // backwards-looking rollback logic as month names, but do not roll back\n  // when the anchor is currently inside the season (codex review r2: bare\n  // season end bounds like \"until spring\" / \"through summer\" returned null).\n  const seasonMonth = SEASON_TO_MONTH[lower];\n  if (typeof seasonMonth === \"number\") {\n    const d = new Date(anchorMs);\n    const anchorMonth = d.getUTCMonth() + 1;\n    let year = d.getUTCFullYear();\n    // Winter (Dec) from Jan/Feb: the current winter started in prev Dec,\n    // so build the season start from the previous year (codex review r2:\n    // bare winter end bounds used the anchor year's December, producing\n    // an exclusive end one year too far forward).\n    if (seasonMonth === 12 && anchorMonth <= 2) year -= 1;\n    const startMs = buildDateMs(year, seasonMonth, 1);\n    if (startMs === null) return null;\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 3);\n    let endMs = startOfDayUtc(nd.getTime());\n    if (endMs > anchorMs && !isInSeason(seasonMonth, anchorMonth)) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  if (lower === \"year\") {\n    const d = new Date(anchorMs);\n    return buildDateMs(d.getUTCFullYear() + 1, 1, 1);\n  }\n  return null;\n}\n\n/**\n * Resolved bi-temporal fields for a single extracted fact (issue #1578 PR2).\n *\n * - `validFrom` / `validUntil` — the event-time `[from, until)` interval.\n *   When `eventTimeSource === \"assumed\"`, `validFrom` is copied from\n *   `observedAt` (the ingestion anchor) so every bi-temporal-on fact carries\n *   at least a start bound.\n * - `observedAt` — always the ingestion anchor (the source turn timestamp).\n * - `eventTimeSource` — `\"extracted\"` when the expression resolved to a real\n *   event-time interval; `\"assumed\"` when the expression was absent or\n *   unresolvable.\n *\n * This is the single write-time helper every extraction entry path calls\n * (rule 39). It is pure: (expression, anchor) in, interval out. Resolution\n * never touches `Date.now()` — replay/import of old transcripts resolves\n * against the old anchor.\n */\nexport interface FactEventTime {\n  validFrom?: string;\n  validUntil?: string;\n  observedAt: string;\n  eventTimeSource: \"extracted\" | \"assumed\";\n}\n\n/**\n * Resolve a single fact's event-time expression against the ingestion anchor.\n *\n * Returns the bi-temporal interval to persist alongside the fact. When the\n * expression is absent, empty, or unresolvable, falls back to\n * `eventTimeSource: \"assumed\"` with `validFrom = observedAt` — per the\n * #1578 frontmatter contract. When the expression resolves but only pins one\n * bound (\"since 2024\" → validFrom only; \"until 2025-06\" → validUntil only),\n * only the resolved bound is returned.\n */\nexport function resolveFactEventTime(\n  expression: string | undefined | null,\n  anchorIso: string,\n): FactEventTime {\n  const resolved = resolveEventTime(expression, anchorIso);\n  if (resolved.ok && (resolved.validFrom !== undefined || resolved.validUntil !== undefined)) {\n    return {\n      ...(resolved.validFrom !== undefined ? { validFrom: resolved.validFrom } : {}),\n      ...(resolved.validUntil !== undefined ? { validUntil: resolved.validUntil } : {}),\n      observedAt: anchorIso,\n      eventTimeSource: \"extracted\",\n    };\n  }\n  return {\n    validFrom: anchorIso,\n    observedAt: anchorIso,\n    eventTimeSource: \"assumed\",\n  };\n}\n"],"mappings":"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","names":["ms"]}
+{"version":3,"sources":["../src/event-time.ts"],"sourcesContent":["/**\n * Event-time resolver (issue #1578).\n *\n * Extraction can carry an optional per-fact `eventTime` expression — an ISO\n * date or a relative phrase verbatim from the source turn (\"last March\",\n * \"yesterday\", \"since 2024\").  This module resolves such expressions into a\n * `[validFrom, validUntil)` event-time interval, **anchored to the source\n * turn's timestamp** — never to `Date.now()`.\n *\n * Why anchor (not wall-clock): replay/import of old transcripts must resolve\n * \"yesterday\" against the *old* turn's yesterday, not today.  A relative\n * expression is meaningless without its anchor; resolving it against the\n * current time would silently rewrite history (AGENTS.md §39 — byte-identical\n * when the feature is off; rule 35 — half-open intervals; rule 51 — never\n * silently default invalid input).\n *\n * Resolution is **write-time-only**.  The on-disk frontmatter stores absolute\n * ISO timestamps strings (`valid_at` / `invalid_at`); readers never call back\n * into this module.  Anything unresolvable yields `ok: false` and the caller\n * records `eventTimeSource: \"assumed\"` with `valid_at` copied from the\n * ingestion anchor (`observedAt`).\n *\n * Interval semantics are `[validFrom, validUntil)` — inclusive start,\n * exclusive end (AGENTS.md §23).  A date-only expression resolving an *end*\n * bound converts to start-of-next-day so the end date itself is excluded.\n */\nimport { parseFlexibleIsoTimestamp } from \"./utils/iso-timestamp.js\";\n\n/**\n * Resolved event-time interval.  All timestamps are UTC ISO strings.\n *\n * - `validFrom` / `validUntil` carry the half-open `[from, until)` event\n *   interval.  Either may be absent when the expression only pinned one side\n *   (\"since 2024\" → validFrom only).\n * - `ok` is false when the expression could not be resolved.  The caller then\n *   falls back to `eventTimeSource: \"assumed\"`.\n */\nexport interface ResolvedEventTime {\n  validFrom?: string;\n  validUntil?: string;\n  ok: boolean;\n}\n\nconst UNITS = [\"day\", \"week\", \"month\", \"quarter\", \"year\"] as const;\ntype RelativeUnit = (typeof UNITS)[number];\n\nfunction isRelativeUnit(unit: string): unit is RelativeUnit {\n  return (UNITS as readonly string[]).includes(unit);\n}\n\n/**\n * Format a `Date` as a UTC ISO string with millisecond precision, matching the\n * canonical frontmatter form.  Returns `undefined` when the input is not\n * finite (the resolver treats that as unresolvable rather than emitting\n * `Invalid Date`).\n */\nfunction toIsoUtc(ms: number | null): string | undefined {\n  if (ms === null || !Number.isFinite(ms)) return undefined;\n  return new Date(ms).toISOString();\n}\n\n/**\n * Compute the start of the day (UTC) for the given ms, used when a date-only\n * expression resolves a *start* bound — the fact holds from midnight UTC.\n */\nfunction startOfDayUtc(ms: number): number {\n  const d = new Date(ms);\n  d.setUTCHours(0, 0, 0, 0);\n  return d.getTime();\n}\n\n/**\n * Compute the start of the *next* day (UTC) for the given ms, used when a\n * date-only expression resolves an *end* bound — the exclusive `validUntil`\n * must land on the following midnight so the end date itself is excluded\n * (AGENTS.md §23: date-only ends convert to start-of-next-day).\n */\nfunction startOfNextDayUtc(ms: number): number {\n  const d = new Date(startOfDayUtc(ms));\n  d.setUTCDate(d.getUTCDate() + 1);\n  return d.getTime();\n}\n\nconst SEASON_TO_MONTH: Record<string, number> = {\n  winter: 12, // Dec–Feb anchor Dec (Northern Hemisphere convention)\n  spring: 3,\n  summer: 6,\n  fall: 9,\n  autumn: 9,\n};\n\nconst MONTH_NAMES: Record<string, number> = {\n  january: 1, february: 2, march: 3, april: 4, may: 5, june: 6,\n  july: 7, august: 8, september: 9, october: 10, november: 11, december: 12,\n  jan: 1, feb: 2, mar: 3, apr: 4, jun: 6, jul: 7, aug: 8, sep: 9, sept: 9,\n  oct: 10, nov: 11, dec: 12,\n};\n\nconst QUARTER_START_MONTH: Record<number, number> = {\n  1: 1, 2: 4, 3: 7, 4: 10,\n};\n\nfunction monthIndex(token: string): number | undefined {\n  const idx = MONTH_NAMES[token.toLowerCase()];\n  return typeof idx === \"number\" ? idx : undefined;\n}\n\n/**\n * Construct a UTC timestamp from year/month(1-12)/day with overflow validation.\n * Returns `null` when the components do not form a real calendar date (e.g.\n * Feb 30) rather than letting `Date` silently roll over.\n */\nfunction buildDateMs(year: number, month1: number, day: number): number | null {\n  if (\n    !Number.isInteger(year) ||\n    !Number.isInteger(month1) ||\n    month1 < 1 ||\n    month1 > 12 ||\n    !Number.isInteger(day) ||\n    day < 1 ||\n    day > daysInMonth(year, month1)\n  ) {\n    return null;\n  }\n  return Date.UTC(year, month1 - 1, day, 0, 0, 0, 0);\n}\n\nfunction daysInMonth(year: number, month1: number): number {\n  return new Date(Date.UTC(year, month1, 0)).getUTCDate();\n}\n\n/**\n * Add `count` units to a UTC ms timestamp, returning the start-of-period for\n * the resulting date.  Used by \"last/this/next <unit>\" resolution.\n */\nfunction shiftUnit(anchorMs: number, unit: RelativeUnit, count: number): number {\n  const d = new Date(anchorMs);\n  switch (unit) {\n    case \"day\":\n      d.setUTCDate(d.getUTCDate() + count);\n      return startOfDayUtc(d.getTime());\n    case \"week\":\n      d.setUTCDate(d.getUTCDate() + count * 7);\n      return startOfDayUtc(d.getTime());\n    case \"month\":\n      d.setUTCMonth(d.getUTCMonth() + count, 1);\n      return startOfDayUtc(d.getTime());\n    case \"quarter\":\n      d.setUTCMonth(d.getUTCMonth() + count * 3, 1);\n      return startOfDayUtc(d.getTime());\n    case \"year\":\n      d.setUTCFullYear(d.getUTCFullYear() + count, 0, 1);\n      return startOfDayUtc(d.getTime());\n  }\n}\n\n/**\n * Resolve \"last December\" / \"this March\" / \"next Q2\" against the anchor.\n * `direction` is -1 (last), 0 (this), +1 (next).  Returns the start-of-period\n * ms for the referenced month/season/quarter, or `null` if it cannot be\n * placed (e.g. month token not recognized).\n */\nfunction resolveMonthYear(\n  anchorMs: number,\n  monthToken: string,\n  direction: number,\n): number | null {\n  const lower = monthToken.toLowerCase();\n  const targetMonth = monthIndex(lower);\n  if (typeof targetMonth === \"number\") {\n    const d = new Date(anchorMs);\n    let year = d.getUTCFullYear();\n    let m = targetMonth;\n    if (direction === -1 && m >= d.getUTCMonth() + 1) year -= 1;\n    else if (direction === +1 && m <= d.getUTCMonth() + 1) year += 1;\n    return buildDateMs(year, m, 1);\n  }\n  return null;\n}\n/**\n * Resolve an explicit \"<month|season> <year>\" token (e.g. \"march 2025\",\n * \"dec 2024\", \"spring 2025\") to a start-of-month ms.  The explicit year is\n * authoritative — it is never derived from the anchor.  Returns null when\n * the token is not in that shape or does not name a real month/season.\n * Shared by the bare phrase path, \"since <month> <year>\", and the end bound\n * so all three resolve identically (review: month-year phrases after since).\n */\nfunction resolveExplicitMonthYear(token: string): number | null {\n  const m = token.trim().toLowerCase().match(/^([a-z]+)\\s+(\\d{4})$/);\n  if (!m) return null;\n  const year = parseInt(m[2], 10);\n  if (!Number.isInteger(year)) return null;\n  const monthIdx = monthIndex(m[1]);\n  const baseMonth = typeof monthIdx === \"number\" ? monthIdx : SEASON_TO_MONTH[m[1]];\n  if (typeof baseMonth !== \"number\") return null;\n  return buildDateMs(year, baseMonth, 1);\n}\n\n\n/**\n * Resolve a bare four-digit year token (e.g. \"2024\") to January 1 of that\n * year.  Used by \"since 2024\" and bare year expressions.  Review #1578 r2:\n * previously these fell through to ok:false, stamping the fact at ingestion\n * time instead of the documented year start.\n */\nfunction resolveBareYear(token: string): number | null {\n  const m = token.trim().match(/^(\\d{4})$/);\n  if (!m) return null;\n  return buildDateMs(Number(m[1]), 1, 1);\n}\n\n\n/**\n * Check whether the anchor month falls inside a season's 3-month span.\n * Seasons start at `baseMonth` and span 3 months (e.g. summer = Jun–Aug).\n * Winter (Dec=12) wraps: Dec, Jan, Feb.\n */\nfunction isInSeason(baseMonth: number, anchorMonth: number): boolean {\n  for (let i = 0; i < 3; i++) {\n    if (((baseMonth - 1 + i) % 12) + 1 === anchorMonth) return true;\n  }\n  return false;\n}\n\nfunction resolveSeasonYear(\n  anchorMs: number,\n  seasonToken: string,\n  direction: number,\n): number | null {\n  const baseMonth = SEASON_TO_MONTH[seasonToken.toLowerCase()];\n  if (typeof baseMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n\n  if (direction === -1) {\n    // \"last <season>\": go to the previous occurrence.\n    // If the season hasn't started yet this year (baseMonth > anchorMonth)\n    // or the anchor is currently INSIDE the season, roll back a year.\n    if (baseMonth > anchorMonth || isInSeason(baseMonth, anchorMonth)) year -= 1;\n    // Winter tail (Jan/Feb): current winter started prev Dec, so \"last\"\n    // needs one more year back.\n    if (baseMonth === 12 && anchorMonth <= 2) year -= 1;\n  } else if (direction === +1) {\n    // \"next <season>\": go to the next occurrence.\n    // Winter from Jan/Feb: current winter started prev Dec; next is this Dec.\n    if (baseMonth === 12 && anchorMonth <= 2) {\n      // no year change — next winter is December of the anchor year\n    } else if (baseMonth < anchorMonth || isInSeason(baseMonth, anchorMonth)) {\n      year += 1;\n    }\n  } else if (direction === 0 && baseMonth === 12 && anchorMonth <= 2) {\n    // \"this winter\" from Jan/Feb: winter started in the previous December.\n    year -= 1;\n  }\n  return buildDateMs(year, baseMonth, 1);\n}\n\nfunction resolveQuarter(\n  anchorMs: number,\n  qNumber: number,\n  direction: number,\n): number | null {\n  const startMonth = QUARTER_START_MONTH[qNumber];\n  if (typeof startMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n  const anchorQ = Math.floor((anchorMonth - 1) / 3) + 1;\n  // Roll back/forward when the target quarter hasn't started yet this year\n  // (startMonth past the anchor month) OR when the anchor is currently\n  // INSIDE the target quarter (review r2: \"last Q2\" from May returned 2026\n  // instead of 2025 because the quarter start month had already passed but\n  // the quarter was still ongoing).\n  if (direction === -1 && (startMonth >= anchorMonth || anchorQ === qNumber))\n    year -= 1;\n  else if (direction === +1 && (startMonth <= anchorMonth || anchorQ === qNumber))\n    year += 1;\n  return buildDateMs(year, startMonth, 1);\n}\n\n/**\n * Resolve an absolute ISO date/datetime to ms.  A date-only value yields\n * start-of-day (UTC).  Returns `null` when the string is not a well-formed,\n * non-overflowed ISO timestamp.\n */\nfunction resolveAbsolute(raw: string): number | null {\n  const trimmed = raw.trim();\n  // YYYY-MM (ISO year-month, no day) → first day of that month, UTC\n  // (#1578 review r3: the prompt example \"until 2025-06\" must resolve, not\n  // fall back to \"assumed\").\n  const ym = /^(\\d{4})-(\\d{2})$/.exec(trimmed);\n  if (ym) {\n    const ms = buildDateMs(Number(ym[1]), Number(ym[2]), 1);\n    return ms === null ? null : startOfDayUtc(ms);\n  }\n  const ms = parseFlexibleIsoTimestamp(trimmed);\n  if (ms === null) return null;\n  // Date-only inputs (no T) anchor to start-of-day UTC.\n  if (!/[Tt]/.test(trimmed)) return startOfDayUtc(ms);\n  return ms;\n}\n\n/**\n * Resolve a relative event-time expression against an anchor ISO timestamp.\n *\n * Supported shapes (case-insensitive, trimmed):\n *   - absolute ISO date / datetime: `\"2026-03-01\"`, `\"2026-03-01T00:00:00Z\"`\n *   - `\"since <date|monthyear>\"` → validFrom only\n *   - `\"until <date|monthyear>\"` / `\"through ...\"` / `\"until end of ...\"` → validUntil only\n *   - `\"last <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"this <month|season|Qn|unit>\"` → validFrom = start of current period\n *   - `\"next <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"yesterday\"` / `\"today\"` / `\"tomorrow\"` → validFrom = start of that day\n *\n * Anything else returns `{ ok: false }`.  The caller then records\n * `eventTimeSource: \"assumed\"`.\n *\n * @param expression the raw per-fact event-time phrase (may be empty/garbage)\n * @param anchorIso  the source turn's ISO timestamp — the resolution anchor\n */\nexport function resolveEventTime(\n  expression: string | undefined | null,\n  anchorIso: string,\n): ResolvedEventTime {\n  const fallback: ResolvedEventTime = { ok: false };\n  if (typeof expression !== \"string\") return fallback;\n  const expr = expression.trim();\n  if (expr.length === 0) return fallback;\n\n  const anchorMs = parseFlexibleIsoTimestamp(anchorIso);\n  if (anchorMs === null || !Number.isFinite(anchorMs)) return fallback;\n\n  const lower = expr.toLowerCase();\n\n  // ── \"since <x>\" / \"until <x>\" / \"through <x>\" ──────────────────────────\n  const sinceMatch = lower.match(/^since\\s+(.+)$/);\n  if (sinceMatch) {\n    const inner = sinceMatch[1].trim();\n    let fromMs =\n      resolveRelativePeriod(anchorMs, inner) ??\n      resolveExplicitMonthYear(inner) ??\n      resolveBareYear(inner) ??\n      resolveAbsolute(inner);\n    // \"since <bare month/season>\": if the resolved start is future and the\n    // expression carries no explicit 4-digit year, the fact meant the most\n    // recent PAST occurrence of that period (codex review r2: \"since March\"\n    // from January produced a future validFrom).\n    if (\n      fromMs !== null &&\n      fromMs > anchorMs &&\n      !/\\d{4}/.test(inner)\n    ) {\n      const nd = new Date(fromMs);\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      fromMs = nd.getTime();\n    }\n    const fromIso = toIsoUtc(fromMs);\n    if (!fromIso) return fallback;\n    return { validFrom: fromIso, ok: true };\n  }\n  const untilMatch = lower.match(/^(?:until|through|till|ending)\\s+(.+)$/);\n  if (untilMatch) {\n    const inner = untilMatch[1].trim();\n    const untilMs = resolveEndBound(anchorMs, inner);\n    const untilIso = toIsoUtc(untilMs);\n    if (!untilIso) return fallback;\n    return { validUntil: untilIso, ok: true };\n  }\n\n  // ── \"yesterday\" / \"today\" / \"tomorrow\" ─────────────────────────────────\n  if (lower === \"today\") {\n    const fromIso = toIsoUtc(startOfDayUtc(anchorMs));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"yesterday\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", -1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"tomorrow\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", +1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── \"last/this/next <period>\" ──────────────────────────────────────────\n  const relMatch = lower.match(/^(last|this|next)\\s+(.+)$/);\n  if (relMatch) {\n    const direction = relMatch[1] === \"last\" ? -1 : relMatch[1] === \"next\" ? +1 : 0;\n    const period = relMatch[2].trim();\n    const ms = resolveRelativePeriod(anchorMs, period, direction);\n    const fromIso = toIsoUtc(ms);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── bare month+year (\"March 2025\", \"Dec 2024\", \"spring 2025\") or\n  // bare four-digit year (\"2024\") ────────────────────────────────────────\n  // Explicit year is authoritative (never derived from the anchor). Shares\n  // resolveExplicitMonthYear / resolveBareYear with the since/until paths.\n  const explicitMs = resolveExplicitMonthYear(lower) ?? resolveBareYear(lower);\n  if (explicitMs !== null) {\n    const fromIso = toIsoUtc(explicitMs);\n    if (fromIso) return { validFrom: fromIso, ok: true };\n  }\n\n  // ── absolute ISO date / datetime ───────────────────────────────────────\n  const absMs = resolveAbsolute(expr);\n  if (absMs !== null) {\n    const fromIso = toIsoUtc(absMs);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Resolve a period token (with optional direction) to a start-of-period ms.\n * Handles month/season names, quarter tokens (`q1`..`q4`), and relative units\n * (`day/week/month/quarter/year`) used by \"last week\", \"this month\", etc.\n */\nfunction resolveRelativePeriod(\n  anchorMs: number,\n  period: string,\n  direction: number = 0,\n): number | null {\n  const lower = period.trim().toLowerCase();\n\n  // Quarter token: \"q1\", \"Q2\", \"quarter 3\"\n  const qTok = lower.match(/^q(?:uarter)?\\s?([1-4])$/);\n  if (qTok) {\n    return resolveQuarter(anchorMs, Number(qTok[1]), direction);\n  }\n  if (lower === \"quarter\") {\n    // \"last quarter\" / \"next quarter\" move the quarter INDEX (with year\n    // wraparound), not just the year — resolveQuarter only nudges the year\n    // for an explicit quarter number, so routing \"last quarter\" through it\n    // returned the current quarter's start (review: bare last/next quarter).\n    const d = new Date(anchorMs);\n    let q = Math.floor(d.getUTCMonth() / 3) + 1;\n    let year = d.getUTCFullYear();\n    if (direction === -1) {\n      q -= 1;\n      if (q < 1) { q = 4; year -= 1; }\n    } else if (direction === +1) {\n      q += 1;\n      if (q > 4) { q = 1; year += 1; }\n    }\n    return buildDateMs(year, QUARTER_START_MONTH[q], 1);\n  }\n\n  // Relative unit: \"week\", \"month\", \"year\", \"day\"\n  if (isRelativeUnit(lower)) {\n    return shiftUnit(anchorMs, lower, direction);\n  }\n\n  // Month or season name\n  const monthMs = resolveMonthYear(anchorMs, lower, direction);\n  if (monthMs !== null) return monthMs;\n  const seasonMs = resolveSeasonYear(anchorMs, lower, direction);\n  if (seasonMs !== null) return seasonMs;\n\n  return null;\n}\n\n/**\n * Resolve an end-bound period to an *exclusive* upper bound ms.  Date-only\n * values convert to start-of-next-day (AGENTS.md §23); period names resolve to\n * the start of the *following* period.\n */\nfunction resolveEndBound(anchorMs: number, period: string): number | null {\n  // Strip an optional \"end of \" prefix so \"until end of March\" resolves the\n  // same as \"until March\".  Review #1578 r2: previously the prefix was passed\n  // unchanged and resolveEndBound returned null for the full phrase.\n  const trimmed = period.trim().replace(/^end\\s+of\\s+/i, \"\").trim();\n\n  // Bare four-digit year: exclusive end = January 1 of the FOLLOWING year.\n  if (/^\\d{4}$/.test(trimmed)) {\n    return buildDateMs(Number(trimmed) + 1, 1, 1);\n  }\n\n  // YYYY-MM (year-month) end bound: exclusive end = start of the FOLLOWING\n  // month, so \"until 2025-06\" spans all of June (#1578 review r3).\n  const ymEnd = /^(\\d{4})-(\\d{2})$/.exec(trimmed);\n  if (ymEnd) {\n    const startMs = buildDateMs(Number(ymEnd[1]), Number(ymEnd[2]), 1);\n    if (startMs === null) return null;\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 1);\n    return startOfDayUtc(nd.getTime());\n  }\n\n  // Absolute date/datetime end bound.\n  const absMs = resolveAbsolute(trimmed);\n  if (absMs !== null) {\n    // Date-only → start of next day (exclusive end).  Datetime → use as-is.\n    if (!/[Tt]/.test(trimmed)) return startOfNextDayUtc(absMs);\n    return absMs;\n  }\n  // Explicit \"<month|season> <year>\" end bound (e.g. \"until March 2025\",\n  // \"through spring 2025\"). The explicit year is authoritative, so the\n  // exclusive end = start of the FOLLOWING month (for a single month) or the\n  // start of the month AFTER the season ends (for a 3-month season).\n  // Review r2: seasons previously advanced only 1 month, cutting off the\n  // last 2 months of the season.\n  const explicitMs = resolveExplicitMonthYear(trimmed);\n  if (explicitMs !== null) {\n    const nd = new Date(explicitMs);\n    const firstWord = trimmed.toLowerCase().split(/\\s+/)[0];\n    const monthAdvance = firstWord in SEASON_TO_MONTH ? 3 : 1;\n    nd.setUTCMonth(nd.getUTCMonth() + monthAdvance);\n    return startOfDayUtc(nd.getTime());\n  }\n\n  // Period-name end bound: month → exclusive end at start of the FOLLOWING\n  // month. \"until <month>\" is backwards-looking (the fact already stopped\n  // being true), so prefer the most recent PAST boundary: build it in the\n  // anchor year and roll back a year if that boundary is still future.\n  const lower = trimmed.toLowerCase();\n  const monthIdx = monthIndex(lower);\n  if (typeof monthIdx === \"number\") {\n    const d = new Date(anchorMs);\n    const startMs = buildDateMs(d.getUTCFullYear(), monthIdx, 1);\n    if (startMs === null) return null;\n    // Exclusive end = start of the month AFTER the named month.\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 1);\n    let endMs = startOfDayUtc(nd.getTime());\n    // Only roll back when the named month boundary is genuinely future\n    // relative to the anchor cycle.  When the anchor IS in the named month,\n    // the end of the current month is the right boundary — do not roll back\n    // (cursor review r2: \"until March\" from mid-March returned the prior year).\n    if (endMs > anchorMs && d.getUTCMonth() + 1 !== monthIdx) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  // Season end bound: advance by the full 3-month season.  Same\n  // backwards-looking rollback logic as month names, but do not roll back\n  // when the anchor is currently inside the season (codex review r2: bare\n  // season end bounds like \"until spring\" / \"through summer\" returned null).\n  const seasonMonth = SEASON_TO_MONTH[lower];\n  if (typeof seasonMonth === \"number\") {\n    const d = new Date(anchorMs);\n    const anchorMonth = d.getUTCMonth() + 1;\n    let year = d.getUTCFullYear();\n    // Winter (Dec) from Jan/Feb: the current winter started in prev Dec,\n    // so build the season start from the previous year (codex review r2:\n    // bare winter end bounds used the anchor year's December, producing\n    // an exclusive end one year too far forward).\n    if (seasonMonth === 12 && anchorMonth <= 2) year -= 1;\n    const startMs = buildDateMs(year, seasonMonth, 1);\n    if (startMs === null) return null;\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 3);\n    let endMs = startOfDayUtc(nd.getTime());\n    if (endMs > anchorMs && !isInSeason(seasonMonth, anchorMonth)) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  if (lower === \"year\") {\n    const d = new Date(anchorMs);\n    return buildDateMs(d.getUTCFullYear() + 1, 1, 1);\n  }\n  return null;\n}\n\n/**\n * Resolved bi-temporal fields for a single extracted fact (issue #1578 PR2).\n *\n * - `validFrom` / `validUntil` — the event-time `[from, until)` interval.\n *   When `eventTimeSource === \"assumed\"`, `validFrom` is copied from\n *   `observedAt` (the ingestion anchor) so every bi-temporal-on fact carries\n *   at least a start bound.\n * - `observedAt` — always the ingestion anchor (the source turn timestamp).\n * - `eventTimeSource` — `\"extracted\"` when the expression resolved to a real\n *   event-time interval; `\"assumed\"` when the expression was absent or\n *   unresolvable.\n *\n * This is the single write-time helper every extraction entry path calls\n * (rule 39). It is pure: (expression, anchor) in, interval out. Resolution\n * never touches `Date.now()` — replay/import of old transcripts resolves\n * against the old anchor.\n */\nexport interface FactEventTime {\n  validFrom?: string;\n  validUntil?: string;\n  observedAt: string;\n  eventTimeSource: \"extracted\" | \"assumed\";\n}\n\n/**\n * Resolve a single fact's event-time expression against the ingestion anchor.\n *\n * Returns the bi-temporal interval to persist alongside the fact. When the\n * expression is absent, empty, or unresolvable, falls back to\n * `eventTimeSource: \"assumed\"` with `validFrom = observedAt` — per the\n * #1578 frontmatter contract. When the expression resolves but only pins one\n * bound (\"since 2024\" → validFrom only; \"until 2025-06\" → validUntil only),\n * only the resolved bound is returned.\n */\nexport function resolveFactEventTime(\n  expression: string | undefined | null,\n  anchorIso: string,\n): FactEventTime {\n  const resolved = resolveEventTime(expression, anchorIso);\n  if (resolved.ok && (resolved.validFrom !== undefined || resolved.validUntil !== undefined)) {\n    return {\n      ...(resolved.validFrom !== undefined ? { validFrom: resolved.validFrom } : {}),\n      ...(resolved.validUntil !== undefined ? { validUntil: resolved.validUntil } : {}),\n      observedAt: anchorIso,\n      eventTimeSource: \"extracted\",\n    };\n  }\n  return {\n    validFrom: anchorIso,\n    observedAt: anchorIso,\n    eventTimeSource: \"assumed\",\n  };\n}\n\n/**\n * Input shape for {@link pickFactEventTimeAnchor} — a structural slice of\n * `ExtractedFact` so the helper stays decoupled from the full type.\n */\nexport interface FactAnchorInput {\n  /** Explicit per-fact source-turn timestamp (#1670). */\n  sourceTurnTimestamp?: string;\n  /** Claim-level provenance spans (#1575), each carrying the turn's `observedAt`. */\n  sources?: { observedAt: string }[];\n}\n\n/**\n * Issue #1670 — select the per-fact event-time anchor.\n *\n * Prefers the fact's explicit `sourceTurnTimestamp` (set by extractors that\n * know the exact source turn). Falls back to the earliest provenance span's\n * `observedAt` (the turn where the supporting quote was located). Finally\n * falls back to the batch-wide anchor (latest source turn timestamp) when\n * neither per-fact signal is present — preserving legacy behaviour for\n * extractors that do not emit provenance.\n *\n * The earliest provenance span wins because a fact backed by quotes from\n * multiple turns was *first* uttered at the earliest turn: a relative\n * expression (\"yesterday\") on that fact should resolve against that turn,\n * not a later turn that merely restated the claim.\n *\n * Returns `undefined` only when no signal is usable AND `batchAnchor` is\n * absent — in which case the caller skips bi-temporal resolution entirely\n * (identical to the pre-feature pipeline when biTemporal is off).\n */\nexport function pickFactEventTimeAnchor(\n  fact: FactAnchorInput,\n  batchAnchor: string | undefined,\n): string | undefined {\n  // 1. Explicit per-fact source-turn timestamp (highest priority).\n  if (\n    typeof fact.sourceTurnTimestamp === \"string\" &&\n    fact.sourceTurnTimestamp.trim().length > 0\n  ) {\n    const ms = parseFlexibleIsoTimestamp(fact.sourceTurnTimestamp.trim());\n    if (ms !== null) return new Date(ms).toISOString();\n  }\n  // 2. Earliest provenance span turn timestamp.\n  if (fact.sources && fact.sources.length > 0) {\n    let earliestMs: number | null = null;\n    for (const src of fact.sources) {\n      if (typeof src.observedAt !== \"string\") continue;\n      const ms = parseFlexibleIsoTimestamp(src.observedAt.trim());\n      if (ms === null) continue;\n      if (earliestMs === null || ms < earliestMs) earliestMs = ms;\n    }\n    if (earliestMs !== null) return new Date(earliestMs).toISOString();\n  }\n  // 3. Batch-wide anchor (legacy fallback).\n  return batchAnchor;\n}\n"],"mappings":"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","names":["ms"]}

package/dist/{chunk-Z4RU5VPM.js → chunk-J334N6QV.js}

@@ -10,7 +10,7 @@ import {
 import {
   planNamespaceMaintenance,
   runNamespaceMaintenanceBatchPlan
-} from "./chunk-EXUCUPV2.js";
+} from "./chunk-WM7DNKBD.js";
 import {
   resolveHomeDir
 } from "./chunk-JUC24CTX.js";
@@ -441,4 +441,4 @@ var MaintenanceScheduler = class {
 export {
   MaintenanceScheduler
 };
-//# sourceMappingURL=chunk-Z4RU5VPM.js.map
+//# sourceMappingURL=chunk-J334N6QV.js.map

package/dist/{chunk-NXRUUDUF.js → chunk-JJJCVCCQ.js}

@@ -1,6 +1,6 @@
 import {
   runPostConsolidationMaterialize
-} from "./chunk-A7TJZLPK.js";
+} from "./chunk-ZK2L72VN.js";
 import {
   discoverMemoryExtensions,
   renderExtensionsBlock,
@@ -217,4 +217,4 @@ export {
   buildExtensionsBlockForConsolidation,
   materializeAfterSemanticConsolidation
 };
-//# sourceMappingURL=chunk-NXRUUDUF.js.map
+//# sourceMappingURL=chunk-JJJCVCCQ.js.map

package/dist/{chunk-GDUOCHCD.js → chunk-KGZF2VO3.js}

@@ -22,7 +22,7 @@ import {
 } from "./chunk-H7XKCNR6.js";
 import {
   toRecallExplainJson
-} from "./chunk-7CTNUVHZ.js";
+} from "./chunk-6SQQOJ4U.js";
 import {
   buildProposedActions,
   buildQualityScore,
@@ -30,12 +30,12 @@ import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   runMemoryGovernance
-} from "./chunk-EDOQM4E4.js";
+} from "./chunk-WAFDHKES.js";
 import {
   clusterByKey,
   createCorrectionService,
   isCorrectionFeatureEnabled
-} from "./chunk-VCLGUIFM.js";
+} from "./chunk-Z3FGC3QE.js";
 import {
   getTrustZoneStoreStatus,
   isTrustZoneName,
@@ -50,7 +50,7 @@ import {
 } from "./chunk-FF4KLI5W.js";
 import {
   estimateRecallTokens
-} from "./chunk-GJSL4WG2.js";
+} from "./chunk-F3XZN24Z.js";
 import {
   namespaceCollectionName
 } from "./chunk-QR67FU5G.js";
@@ -116,17 +116,17 @@ import {
   buildBriefing,
   parseBriefingFocus,
   parseBriefingWindow
-} from "./chunk-UO5ZHIIH.js";
+} from "./chunk-4WZ3J7M6.js";
 import {
   parseEntityFile
-} from "./chunk-EVPNWN7Z.js";
+} from "./chunk-4R3CGCI5.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
 import {
   DEFAULT_RECALL_DISCLOSURE,
   isRecallDisclosure
-} from "./chunk-ILFSEIRT.js";
+} from "./chunk-7AG54AF3.js";
 import {
   inferMemoryStatus,
   toMemoryPathRel
@@ -8107,7 +8107,7 @@ ${next}`);
    * Return per-phase Dreams telemetry for the last N hours (default 24).
    */
   async dreamsStatus(options) {
-    const { getDreamsStatus, normalizeDreamsStatusWindowHours } = await import("./dreams-ledger-3WSCI5V4.js");
+    const { getDreamsStatus, normalizeDreamsStatusWindowHours } = await import("./dreams-ledger-6UODQOX6.js");
     let windowHours;
     try {
       windowHours = normalizeDreamsStatusWindowHours(options?.windowHours);
@@ -8126,7 +8126,7 @@ ${next}`);
    * respectively, returning the same telemetry shape as a scheduled run.
    */
   async dreamsRun(options) {
-    const { runDreamsPhase } = await import("./dreams-ledger-3WSCI5V4.js");
+    const { runDreamsPhase } = await import("./dreams-ledger-6UODQOX6.js");
     const validPhases = ["lightSleep", "rem", "deepSleep"];
     if (!validPhases.includes(options.phase)) {
       throw new EngramAccessInputError(
@@ -8393,4 +8393,4 @@ export {
   shapeMemorySummary,
   EngramAccessService
 };
-//# sourceMappingURL=chunk-GDUOCHCD.js.map
+//# sourceMappingURL=chunk-KGZF2VO3.js.map