agenr 1.9.2 → 2.0.0

package/dist/core/recall/index.js

@@ -1,4 +1,3 @@
-import "../../chunk-ETQPUJGS.js";
 import {
   buildLexicalPlan,
   combinedRelevance,
@@ -12,7 +11,7 @@ import {
   recencyScore,
   scoreCandidate,
   tokenize
-} from "../../chunk-GUDCFFRV.js";
+} from "../../chunk-MEHOGUZE.js";
 export {
   buildLexicalPlan,
   combinedRelevance,

package/dist/internal-recall-eval-server.js

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
-import "./chunk-ETQPUJGS.js";
+import {
+  composeProcedureRecallText,
+  computeProcedureRevisionHash,
+  computeProcedureSourceHash
+} from "./chunk-ZYADFKX3.js";
 import {
   CLAIM_KEY_SOURCES,
   CLAIM_KEY_STATUSES,
@@ -11,6 +15,7 @@ import {
   createEmbeddingClient,
   createRecallAdapter,
   isRecord,
+  normalizeProcedureDefinition,
   parseOptionalBoolean,
   parseOptionalIntegerInRange,
   parseOptionalTimestampString,
@@ -23,10 +28,10 @@ import {
   resolveEmbeddingApiKey,
   resolveEmbeddingModel,
   runUnifiedRecall
-} from "./chunk-EMRMV2QR.js";
+} from "./chunk-Y2BC7RCE.js";
 import {
   recall
-} from "./chunk-GUDCFFRV.js";
+} from "./chunk-MEHOGUZE.js";
 
 // src/internal-recall-eval-server.ts
 import process from "process";
@@ -424,6 +429,21 @@ function buildMetadata(request, results, projectedEntries) {
       routing: results.routing,
       timeWindow: results.timeWindow,
       asOf: results.asOf,
+      procedure: results.procedure ? {
+        id: results.procedure.id,
+        procedureKey: results.procedure.procedure_key,
+        title: results.procedure.title,
+        goal: results.procedure.goal
+      } : void 0,
+      procedureCandidates: results.procedureCandidates.map((candidate) => ({
+        id: candidate.procedure.id,
+        procedureKey: candidate.procedure.procedure_key,
+        title: candidate.procedure.title,
+        score: candidate.score,
+        lexicalScore: candidate.scores.lexical,
+        vectorScore: candidate.scores.vector
+      })),
+      procedureNotices: results.procedureNotices,
       notices: results.notices,
       episodeCount: results.episodes.length
     }
@@ -635,6 +655,87 @@ function hashText(value) {
   return createHash("sha256").update(value).digest("hex");
 }
 
+// src/app/evals/recall/provision-procedure-fixtures.ts
+import { createHash as createHash2 } from "crypto";
+async function provisionRecallEvalProcedureFixtures(params) {
+  const procedures = prepareProcedures(params.caseId, params.procedurePool, params.provisionedAt);
+  if (procedures.length === 0) {
+    return {
+      provisionedCount: 0
+    };
+  }
+  await params.store.withTransaction(async (store) => {
+    for (const procedure of procedures) {
+      await store.insertProcedure(procedure);
+    }
+  });
+  return {
+    provisionedCount: procedures.length
+  };
+}
+function prepareProcedures(caseId, fixtures, provisionedAt) {
+  const resolvedIds = fixtures.map((fixture, index) => fixture.id ?? createFixtureId2(caseId, index, fixture));
+  const duplicateIds = findDuplicateIds2(resolvedIds);
+  if (duplicateIds.length > 0) {
+    throw new Error(`Procedure fixture IDs must be unique. Duplicate IDs: ${duplicateIds.join(", ")}.`);
+  }
+  const knownIds = new Set(resolvedIds);
+  return fixtures.map((fixture, index) => {
+    if (fixture.superseded_by && !knownIds.has(fixture.superseded_by)) {
+      throw new Error(`procedurePool[${index}].superseded_by references unknown fixture id "${fixture.superseded_by}".`);
+    }
+    const normalizedBody = normalizeProcedureDefinition(
+      {
+        procedure_key: fixture.procedure_key,
+        title: fixture.title,
+        goal: fixture.goal,
+        when_to_use: fixture.when_to_use ?? [],
+        when_not_to_use: fixture.when_not_to_use ?? [],
+        prerequisites: fixture.prerequisites ?? [],
+        steps: fixture.steps,
+        verification: fixture.verification ?? [],
+        failure_modes: fixture.failure_modes ?? [],
+        sources: fixture.sources ?? [{ kind: "manual", label: "recall eval fixture" }]
+      },
+      `procedurePool[${index}]`
+    );
+    const createdAt = fixture.created_at ?? provisionedAt;
+    const updatedAt = fixture.updated_at ?? createdAt;
+    return {
+      id: resolvedIds[index] ?? "",
+      ...normalizedBody,
+      source_file: fixture.source_file,
+      recall_text: composeProcedureRecallText(normalizedBody),
+      revision_hash: computeProcedureRevisionHash(normalizedBody),
+      source_hash: computeProcedureSourceHash(JSON.stringify(normalizedBody)),
+      retired: fixture.retired ?? false,
+      retired_at: fixture.retired_at,
+      retired_reason: fixture.retired_reason,
+      superseded_by: fixture.superseded_by,
+      created_at: createdAt,
+      updated_at: updatedAt
+    };
+  });
+}
+function createFixtureId2(caseId, index, fixture) {
+  const digest = createHash2("sha256").update(caseId).update(":").update(String(index)).update(":").update(fixture.procedure_key).update(":").update(fixture.title).update(":").update(fixture.goal).digest("hex");
+  return `eval-procedure-${digest.slice(0, 24)}`;
+}
+function findDuplicateIds2(ids) {
+  const seen = /* @__PURE__ */ new Set();
+  const duplicates = [];
+  for (const id of ids) {
+    if (seen.has(id)) {
+      if (!duplicates.includes(id)) {
+        duplicates.push(id);
+      }
+      continue;
+    }
+    seen.add(id);
+  }
+  return duplicates;
+}
+
 // src/app/evals/recall/sandbox.ts
 import { mkdir, mkdtemp, rm } from "fs/promises";
 import { tmpdir } from "os";
@@ -644,6 +745,7 @@ import path from "path";
 function createRecallEvalFixtureStore(database) {
   return {
     insertEntry: async (entry, embedding, contentHash) => database.insertEntry(entry, embedding, contentHash),
+    insertProcedure: async (procedure) => database.upsertProcedure(procedure),
     withTransaction: async (fn) => database.withTransaction(async (transaction) => fn(createRecallEvalFixtureStore(transaction)))
   };
 }
@@ -670,6 +772,7 @@ async function setupRecallEvalSandbox(request) {
       preserved,
       fixtureStore: createRecallEvalFixtureStore(openDatabase),
       episodeDatabase: openDatabase,
+      procedureDatabase: openDatabase,
       createRecallPorts: (embedding) => createRecallAdapter(openDatabase, embedding),
       cleanup: async () => {
         await openDatabase.close().catch(() => void 0);
@@ -759,17 +862,32 @@ async function runRecallEvalCase(request) {
         timings: diagnostics.buildTimings(elapsedMs2(startedAt))
       });
     }
-    if (request.memoryPool.length > 0) {
+    if (request.memoryPool.length > 0 || (request.procedurePool?.length ?? 0) > 0) {
       const provisionStartedAt = Date.now();
       try {
-        const provisionResult = await provisionRecallEvalFixtures({
-          caseId: request.caseId,
-          memoryPool: request.memoryPool,
-          store: sandbox.fixtureStore,
-          embedding: getEmbeddingPort(),
-          provisionedAt
-        });
-        diagnostics.recordProvision(provisionResult, elapsedMs2(provisionStartedAt));
+        let entryProvisionResult;
+        if (request.memoryPool.length > 0) {
+          entryProvisionResult = await provisionRecallEvalFixtures({
+            caseId: request.caseId,
+            memoryPool: request.memoryPool,
+            store: sandbox.fixtureStore,
+            embedding: getEmbeddingPort(),
+            provisionedAt
+          });
+        }
+        if ((request.procedurePool?.length ?? 0) > 0) {
+          await provisionRecallEvalProcedureFixtures({
+            caseId: request.caseId,
+            procedurePool: request.procedurePool ?? [],
+            store: sandbox.fixtureStore,
+            provisionedAt
+          });
+        }
+        if (entryProvisionResult) {
+          diagnostics.recordProvision(entryProvisionResult, elapsedMs2(provisionStartedAt));
+        } else {
+          diagnostics.recordFixtureProvisionTiming(elapsedMs2(provisionStartedAt));
+        }
       } catch (error) {
         diagnostics.recordFixtureProvisionTiming(elapsedMs2(provisionStartedAt));
         return buildRecallEvalErrorResponse({
@@ -807,6 +925,7 @@ async function runRecallEvalCase(request) {
         },
         {
           database: sandbox.episodeDatabase,
+          procedures: sandbox.procedureDatabase,
           recall: recallPorts,
           embeddingAvailable: embeddingSupport.available,
           ...embeddingSupport.error ? { embeddingError: embeddingSupport.error } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "1.9.2",
+  "version": "2.0.0",
   "description": "Agent memory - local-first knowledge infrastructure for AI agents",
   "type": "module",
   "bin": {
@@ -13,14 +13,15 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@libsql/client": "^0.17.2",
     "@mariozechner/pi-agent-core": "^0.63.1",
     "@mariozechner/pi-ai": "^0.63.2",
     "@sinclair/typebox": "^0.34.0",
-    "@clack/prompts": "^1.1.0",
-    "@libsql/client": "^0.17.2",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "openclaw": "^2026.4.9"
+    "openclaw": "^2026.4.9",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/dist/{chunk-GUDCFFRV.js → chunk-MEHOGUZE.js}

@@ -1,176 +1,3 @@
-// src/core/recall/scoring.ts
-var DAY_IN_MILLISECONDS = 1e3 * 60 * 60 * 24;
-var IMPORTANCE_FLOOR = 0.4;
-var RELEVANCE_WEIGHT = 0.5;
-var RECENCY_WEIGHT = 0.25;
-var IMPORTANCE_WEIGHT = 0.25;
-function recencyScore(createdAt, expiry, now = /* @__PURE__ */ new Date()) {
-  if (expiry === "core") {
-    return 1;
-  }
-  const createdDate = asValidDate(createdAt);
-  const nowDate = asValidDate(now);
-  if (!createdDate || !nowDate) {
-    return 0;
-  }
-  const halfLifeDays = expiry === "permanent" ? 365 : 30;
-  const daysOld = Math.max(0, (nowDate.getTime() - createdDate.getTime()) / DAY_IN_MILLISECONDS);
-  return clampUnit(Math.pow(0.5, daysOld / halfLifeDays));
-}
-function gaussianRecency(createdAt, aroundDate, radiusDays) {
-  const createdDate = asValidDate(createdAt);
-  const anchorDate = asValidDate(aroundDate);
-  const normalizedRadius = sanitizeNonNegative(radiusDays);
-  if (!createdDate || !anchorDate) {
-    return 0;
-  }
-  if (normalizedRadius <= 0) {
-    return createdDate.getTime() === anchorDate.getTime() ? 1 : 0;
-  }
-  const daysDelta = Math.abs(createdDate.getTime() - anchorDate.getTime()) / DAY_IN_MILLISECONDS;
-  return clampUnit(Math.exp(-0.5 * (daysDelta / normalizedRadius) ** 2));
-}
-function importanceScore(importance) {
-  const clampedImportance = clampRange(sanitizeNonNegative(importance), 1, 10);
-  return clampUnit(IMPORTANCE_FLOOR + (clampedImportance - 1) / 9 * (1 - IMPORTANCE_FLOOR));
-}
-function combinedRelevance(vectorSim, lexical) {
-  const normalizedVector = clampUnit(sanitizeNonNegative(vectorSim));
-  const normalizedLexical = clampUnit(sanitizeNonNegative(lexical));
-  if (normalizedVector > 0 && normalizedLexical > 0) {
-    return clampUnit(normalizedVector * 0.6 + normalizedLexical * 0.4);
-  }
-  return Math.max(normalizedVector, normalizedLexical);
-}
-function scoreCandidate(params) {
-  const vector = clampUnit(sanitizeNonNegative(params.vectorSim));
-  const lexical = clampUnit(sanitizeNonNegative(params.lexical));
-  const recency = clampUnit(sanitizeNonNegative(params.recency));
-  const importance = clampUnit(sanitizeNonNegative(params.importance));
-  const relevance = combinedRelevance(vector, lexical);
-  const score = clampUnit(relevance * RELEVANCE_WEIGHT + recency * RECENCY_WEIGHT + importance * IMPORTANCE_WEIGHT);
-  return {
-    score,
-    scores: {
-      relevance,
-      vector,
-      lexical,
-      recency,
-      importance
-    }
-  };
-}
-function cosineSimilarity(left, right) {
-  const size = Math.min(left.length, right.length);
-  if (size === 0) {
-    return 0;
-  }
-  let dot = 0;
-  let leftNorm = 0;
-  let rightNorm = 0;
-  for (let index = 0; index < size; index += 1) {
-    const leftValue = sanitizeFinite(left[index]);
-    const rightValue = sanitizeFinite(right[index]);
-    dot += leftValue * rightValue;
-    leftNorm += leftValue * leftValue;
-    rightNorm += rightValue * rightValue;
-  }
-  if (leftNorm <= 0 || rightNorm <= 0) {
-    return 0;
-  }
-  return clampUnit(dot / (Math.sqrt(leftNorm) * Math.sqrt(rightNorm)));
-}
-var asValidDate = (value) => {
-  const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
-  return Number.isNaN(date.getTime()) ? null : date;
-};
-var clampUnit = (value) => clampRange(sanitizeNonNegative(value), 0, 1);
-var clampRange = (value, min, max) => Math.min(max, Math.max(min, value));
-var sanitizeFinite = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
-var sanitizeNonNegative = (value) => Math.max(0, sanitizeFinite(value));
-
-// src/core/recall/temporal.ts
-var DAY_IN_MILLISECONDS2 = 1e3 * 60 * 60 * 24;
-var MONTH_INDEX = /* @__PURE__ */ new Map([
-  ["january", 0],
-  ["february", 1],
-  ["march", 2],
-  ["april", 3],
-  ["may", 4],
-  ["june", 5],
-  ["july", 6],
-  ["august", 7],
-  ["september", 8],
-  ["october", 9],
-  ["november", 10],
-  ["december", 11]
-]);
-function inferAroundDate(text, now = /* @__PURE__ */ new Date()) {
-  const normalized = text.trim().toLowerCase();
-  const referenceNow = asValidDate2(now);
-  if (normalized.length === 0 || !referenceNow) {
-    return null;
-  }
-  let inferred = null;
-  if (/\byesterday\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 1);
-  } else if (/\blast week\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 7);
-  } else if (/\blast month\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 30);
-  } else if (/\blast year\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 365);
-  } else if (/\bthis week\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 3);
-  } else if (/\bthis month\b/.test(normalized)) {
-    inferred = offsetDays(referenceNow, 15);
-  } else {
-    const relativeMatch = normalized.match(/\b(\d+)\s+(day|days|week|weeks|month|months)\s+ago\b/);
-    if (relativeMatch) {
-      const amount = Number(relativeMatch[1]);
-      const unit = relativeMatch[2];
-      const multiplier = unit?.startsWith("week") ? 7 : unit?.startsWith("month") ? 30 : 1;
-      inferred = Number.isFinite(amount) ? offsetDays(referenceNow, amount * multiplier) : null;
-    } else {
-      const monthMatch = normalized.match(/\bin\s+(january|february|march|april|may|june|july|august|september|october|november|december)\b/);
-      if (monthMatch?.[1]) {
-        inferred = inferMonthAnchor(monthMatch[1], referenceNow);
-      }
-    }
-  }
-  if (!inferred) {
-    return null;
-  }
-  return inferred.getTime() > referenceNow.getTime() ? new Date(referenceNow.getTime()) : inferred;
-}
-function parseRelativeDate(input, now = /* @__PURE__ */ new Date()) {
-  const trimmed = input.trim();
-  const referenceNow = asValidDate2(now);
-  if (trimmed.length === 0 || !referenceNow) {
-    return null;
-  }
-  const durationMatch = trimmed.match(/^(\d+)d$/i);
-  if (durationMatch?.[1]) {
-    const days = Number(durationMatch[1]);
-    return Number.isFinite(days) ? offsetDays(referenceNow, days) : null;
-  }
-  const parsed = new Date(trimmed);
-  return Number.isNaN(parsed.getTime()) ? null : parsed;
-}
-var asValidDate2 = (value) => {
-  const date = new Date(value.getTime());
-  return Number.isNaN(date.getTime()) ? null : date;
-};
-var offsetDays = (date, days) => new Date(date.getTime() - days * DAY_IN_MILLISECONDS2);
-var inferMonthAnchor = (monthName, now) => {
-  const monthIndex = MONTH_INDEX.get(monthName);
-  if (monthIndex === void 0) {
-    return null;
-  }
-  const year = monthIndex <= now.getUTCMonth() ? now.getUTCFullYear() : now.getUTCFullYear() - 1;
-  return new Date(Date.UTC(year, monthIndex, 15));
-};
-
 // src/core/recall/lexical.ts
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "the",
@@ -361,6 +188,97 @@ var hasConsecutivePhrase = (haystack, needle) => {
   return false;
 };
 
+// src/core/recall/scoring.ts
+var DAY_IN_MILLISECONDS = 1e3 * 60 * 60 * 24;
+var IMPORTANCE_FLOOR = 0.4;
+var RELEVANCE_WEIGHT = 0.5;
+var RECENCY_WEIGHT = 0.25;
+var IMPORTANCE_WEIGHT = 0.25;
+function recencyScore(createdAt, expiry, now = /* @__PURE__ */ new Date()) {
+  if (expiry === "core") {
+    return 1;
+  }
+  const createdDate = asValidDate(createdAt);
+  const nowDate = asValidDate(now);
+  if (!createdDate || !nowDate) {
+    return 0;
+  }
+  const halfLifeDays = expiry === "permanent" ? 365 : 30;
+  const daysOld = Math.max(0, (nowDate.getTime() - createdDate.getTime()) / DAY_IN_MILLISECONDS);
+  return clampUnit(Math.pow(0.5, daysOld / halfLifeDays));
+}
+function gaussianRecency(createdAt, aroundDate, radiusDays) {
+  const createdDate = asValidDate(createdAt);
+  const anchorDate = asValidDate(aroundDate);
+  const normalizedRadius = sanitizeNonNegative(radiusDays);
+  if (!createdDate || !anchorDate) {
+    return 0;
+  }
+  if (normalizedRadius <= 0) {
+    return createdDate.getTime() === anchorDate.getTime() ? 1 : 0;
+  }
+  const daysDelta = Math.abs(createdDate.getTime() - anchorDate.getTime()) / DAY_IN_MILLISECONDS;
+  return clampUnit(Math.exp(-0.5 * (daysDelta / normalizedRadius) ** 2));
+}
+function importanceScore(importance) {
+  const clampedImportance = clampRange(sanitizeNonNegative(importance), 1, 10);
+  return clampUnit(IMPORTANCE_FLOOR + (clampedImportance - 1) / 9 * (1 - IMPORTANCE_FLOOR));
+}
+function combinedRelevance(vectorSim, lexical) {
+  const normalizedVector = clampUnit(sanitizeNonNegative(vectorSim));
+  const normalizedLexical = clampUnit(sanitizeNonNegative(lexical));
+  if (normalizedVector > 0 && normalizedLexical > 0) {
+    return clampUnit(normalizedVector * 0.6 + normalizedLexical * 0.4);
+  }
+  return Math.max(normalizedVector, normalizedLexical);
+}
+function scoreCandidate(params) {
+  const vector = clampUnit(sanitizeNonNegative(params.vectorSim));
+  const lexical = clampUnit(sanitizeNonNegative(params.lexical));
+  const recency = clampUnit(sanitizeNonNegative(params.recency));
+  const importance = clampUnit(sanitizeNonNegative(params.importance));
+  const relevance = combinedRelevance(vector, lexical);
+  const score = clampUnit(relevance * RELEVANCE_WEIGHT + recency * RECENCY_WEIGHT + importance * IMPORTANCE_WEIGHT);
+  return {
+    score,
+    scores: {
+      relevance,
+      vector,
+      lexical,
+      recency,
+      importance
+    }
+  };
+}
+function cosineSimilarity(left, right) {
+  const size = Math.min(left.length, right.length);
+  if (size === 0) {
+    return 0;
+  }
+  let dot = 0;
+  let leftNorm = 0;
+  let rightNorm = 0;
+  for (let index = 0; index < size; index += 1) {
+    const leftValue = sanitizeFinite(left[index]);
+    const rightValue = sanitizeFinite(right[index]);
+    dot += leftValue * rightValue;
+    leftNorm += leftValue * leftValue;
+    rightNorm += rightValue * rightValue;
+  }
+  if (leftNorm <= 0 || rightNorm <= 0) {
+    return 0;
+  }
+  return clampUnit(dot / (Math.sqrt(leftNorm) * Math.sqrt(rightNorm)));
+}
+var asValidDate = (value) => {
+  const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+};
+var clampUnit = (value) => clampRange(sanitizeNonNegative(value), 0, 1);
+var clampRange = (value, min, max) => Math.min(max, Math.max(min, value));
+var sanitizeFinite = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
+var sanitizeNonNegative = (value) => Math.max(0, sanitizeFinite(value));
+
 // src/core/claim-key.ts
 var UNKNOWN_SEGMENT = "unknown";
 var SELF_REFERENTIAL_ENTITIES = /* @__PURE__ */ new Set(["i", "me", "myself", "the_user", "user", "we", "our_team", "the_project", "this_project"]);
@@ -877,6 +795,88 @@ function resolveConfiguredAttributeHeadPolicy(attributeHead, config) {
   return config?.attributeHeads?.[loweredAttributeHead];
 }
 
+// src/core/recall/temporal.ts
+var DAY_IN_MILLISECONDS2 = 1e3 * 60 * 60 * 24;
+var MONTH_INDEX = /* @__PURE__ */ new Map([
+  ["january", 0],
+  ["february", 1],
+  ["march", 2],
+  ["april", 3],
+  ["may", 4],
+  ["june", 5],
+  ["july", 6],
+  ["august", 7],
+  ["september", 8],
+  ["october", 9],
+  ["november", 10],
+  ["december", 11]
+]);
+function inferAroundDate(text, now = /* @__PURE__ */ new Date()) {
+  const normalized = text.trim().toLowerCase();
+  const referenceNow = asValidDate2(now);
+  if (normalized.length === 0 || !referenceNow) {
+    return null;
+  }
+  let inferred = null;
+  if (/\byesterday\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 1);
+  } else if (/\blast week\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 7);
+  } else if (/\blast month\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 30);
+  } else if (/\blast year\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 365);
+  } else if (/\bthis week\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 3);
+  } else if (/\bthis month\b/.test(normalized)) {
+    inferred = offsetDays(referenceNow, 15);
+  } else {
+    const relativeMatch = normalized.match(/\b(\d+)\s+(day|days|week|weeks|month|months)\s+ago\b/);
+    if (relativeMatch) {
+      const amount = Number(relativeMatch[1]);
+      const unit = relativeMatch[2];
+      const multiplier = unit?.startsWith("week") ? 7 : unit?.startsWith("month") ? 30 : 1;
+      inferred = Number.isFinite(amount) ? offsetDays(referenceNow, amount * multiplier) : null;
+    } else {
+      const monthMatch = normalized.match(/\bin\s+(january|february|march|april|may|june|july|august|september|october|november|december)\b/);
+      if (monthMatch?.[1]) {
+        inferred = inferMonthAnchor(monthMatch[1], referenceNow);
+      }
+    }
+  }
+  if (!inferred) {
+    return null;
+  }
+  return inferred.getTime() > referenceNow.getTime() ? new Date(referenceNow.getTime()) : inferred;
+}
+function parseRelativeDate(input, now = /* @__PURE__ */ new Date()) {
+  const trimmed = input.trim();
+  const referenceNow = asValidDate2(now);
+  if (trimmed.length === 0 || !referenceNow) {
+    return null;
+  }
+  const durationMatch = trimmed.match(/^(\d+)d$/i);
+  if (durationMatch?.[1]) {
+    const days = Number(durationMatch[1]);
+    return Number.isFinite(days) ? offsetDays(referenceNow, days) : null;
+  }
+  const parsed = new Date(trimmed);
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+var asValidDate2 = (value) => {
+  const date = new Date(value.getTime());
+  return Number.isNaN(date.getTime()) ? null : date;
+};
+var offsetDays = (date, days) => new Date(date.getTime() - days * DAY_IN_MILLISECONDS2);
+var inferMonthAnchor = (monthName, now) => {
+  const monthIndex = MONTH_INDEX.get(monthName);
+  if (monthIndex === void 0) {
+    return null;
+  }
+  const year = monthIndex <= now.getUTCMonth() ? now.getUTCFullYear() : now.getUTCFullYear() - 1;
+  return new Date(Date.UTC(year, monthIndex, 15));
+};
+
 // src/core/recall/trace.ts
 var NOOP_RECALL_TRACE_SINK = {
   reportSummary() {
@@ -1507,11 +1507,11 @@ export {
   describeClaimKeyNormalizationFailure,
   describeExtractedClaimKeyRejection,
   describeClaimKeySuspicion,
-  inferAroundDate,
-  parseRelativeDate,
   tokenize,
   buildLexicalPlan,
   computeLexicalScore,
+  inferAroundDate,
+  parseRelativeDate,
   resolveClaimSlotPolicy,
   recall
 };