agenr 0.7.13 → 0.7.14

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.7.14] - 2026-02-21
+
+### Added
+- feat(recall): added `until` upper date bound to recall query filtering in CLI, MCP, and DB recall paths (`since` + `until` now define an inclusive window)
+
+### Changed
+- fix(recall): recency decay now anchors to the `until` ceiling for historical windows while freshness boost remains anchored to real query time
+- fix(recall): centralized `parseSinceToIso` in `src/utils/time.ts` and removed duplicate implementations from recall CLI and MCP server
+- fix(recall): added inverted date-range validation - recall now returns a descriptive error when `since > until` instead of returning an empty list
+- fix(recall): interim 3x candidate over-fetch under date bounds to improve in-window recall coverage until SQL-level date filtering is added
+- fix(recall): corrupt `created_at` values are now safely excluded under date-bound filters instead of leaking invalid rows into filtered recall
+
 ## [0.7.13] - 2026-02-21
 
 ### Fixed

package/README.md

@@ -161,7 +161,7 @@ agenr watch --platform openclaw --context ~/.agenr/CONTEXT.md
 
 ## How it works
 
-**Extract** - An LLM reads your transcripts and pulls out structured entries: facts, decisions, preferences, todos, relationships, events, lessons. Smart filtering removes noise (tool calls, file contents, boilerplate) before the LLM ever sees it.
+**Extract** - An LLM reads your transcripts and pulls out structured entries: facts, decisions, preferences, todos, relationships, events, lessons. Smart filtering removes noise (tool calls, file contents, boilerplate) before the LLM ever sees it. For OpenClaw sessions, hedged or unverified agent claims are detected and capped at importance 5 with an `unverified` tag - so speculative assistant statements do not pollute your memory as facts.
 
 **Store** - Entries get embedded and compared against what's already in the database. Near-duplicates reinforce existing knowledge. New information gets inserted. Online dedup catches copies in real-time.
 
@@ -201,7 +201,7 @@ MCP settings.
 | `agenr ingest <paths...>` | Bulk-ingest files and directories |
 | `agenr extract <files...>` | Extract knowledge entries from text files |
 | `agenr store [files...]` | Store entries with semantic dedup |
-| `agenr recall [query]` | Semantic + memory-aware recall |
+| `agenr recall [query]` | Semantic + memory-aware recall. Use `--since` / `--until` for date range queries (e.g. `--since 14d --until 7d` for entries from two weeks ago). |
 | `agenr retire [subject]` | Retire a stale entry (hidden, not deleted). Match by subject text or use --id <id> to target by entry ID. |
 | `agenr watch [file]` | Live-watch files/directories, auto-extract knowledge |
 | `agenr daemon install` | Install background watch daemon (macOS launchd) |
@@ -227,13 +227,12 @@ Deep dive: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)
 
 ## Status
 
-The core pipeline is stable and tested (797 tests). We use it daily managing
+The core pipeline is stable and tested (841 tests). We use it daily managing
 thousands of knowledge entries across OpenClaw sessions.
 
 What works: extraction, storage, recall, MCP integration, online dedup, consolidation, smart filtering, live watching, daemon mode.
 
-What's next: Cursor live signals, Claude Code UserPromptSubmit adapter,
-transitive project dependencies.
+What's next: GUI Management Console (browse, search, and curate your knowledge database visually), Cursor live signals, Claude Code UserPromptSubmit adapter, transitive project dependencies.
 
 ## Philosophy
 

package/dist/cli-main.d.ts

@@ -171,6 +171,7 @@ declare function extractKnowledgeFromChunks(params: {
     chunks: TranscriptChunk[];
     client: LlmClient;
     verbose: boolean;
+    platform?: KnowledgePlatform | (string & {});
     noDedup?: boolean;
     interChunkDelayMs?: number;
     llmConcurrency?: number;

package/dist/cli-main.js

@@ -3335,6 +3335,47 @@ function resolveEmbeddingApiKey(config, env = process.env) {
   );
 }
 
+// src/utils/time.ts
+var DURATION_PATTERN = /^(\d+)\s*([hdmy])$/i;
+var UNIT_TO_MILLISECONDS = {
+  h: 1e3 * 60 * 60,
+  d: 1e3 * 60 * 60 * 24,
+  m: 1e3 * 60 * 60 * 24 * 30,
+  y: 1e3 * 60 * 60 * 24 * 365
+};
+function parseSince(since, now = /* @__PURE__ */ new Date()) {
+  if (!since) {
+    return void 0;
+  }
+  const trimmed = since.trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  const durationMatch = trimmed.match(DURATION_PATTERN);
+  if (durationMatch) {
+    const amount = Number(durationMatch[1]);
+    const unit = durationMatch[2]?.toLowerCase();
+    const multiplier = unit ? UNIT_TO_MILLISECONDS[unit] : void 0;
+    if (!Number.isFinite(amount) || amount <= 0 || !multiplier) {
+      throw new Error("Invalid since value");
+    }
+    return new Date(now.getTime() - amount * multiplier);
+  }
+  const parsed = new Date(trimmed);
+  if (Number.isNaN(parsed.getTime())) {
+    throw new Error("Invalid since value");
+  }
+  return parsed;
+}
+function parseSinceToIso(since, now = /* @__PURE__ */ new Date(), invalidMessage = "Invalid date value") {
+  try {
+    const parsed = parseSince(since, now);
+    return parsed ? parsed.toISOString() : void 0;
+  } catch {
+    throw new Error(invalidMessage);
+  }
+}
+
 // src/db/session-start.ts
 var DEFAULT_SESSION_CANDIDATE_LIMIT = 500;
 var DEFAULT_CORE_CANDIDATE_LIMIT = 5e3;
@@ -3641,40 +3682,6 @@ function resolveScopeSet(scope) {
   }
   return /* @__PURE__ */ new Set(["private", "personal", "public"]);
 }
-function parseSince(since, now) {
-  if (!since) {
-    return void 0;
-  }
-  const trimmed = since.trim();
-  if (!trimmed) {
-    return void 0;
-  }
-  const durationMatch = trimmed.match(/^(\d+)\s*([hdy])$/i);
-  if (durationMatch) {
-    const amount = Number(durationMatch[1]);
-    const unit = durationMatch[2]?.toLowerCase();
-    if (!Number.isFinite(amount) || amount <= 0 || !unit) {
-      return void 0;
-    }
-    let multiplier = 0;
-    if (unit === "h") {
-      multiplier = 1e3 * 60 * 60;
-    } else if (unit === "d") {
-      multiplier = MILLISECONDS_PER_DAY;
-    } else if (unit === "y") {
-      multiplier = MILLISECONDS_PER_DAY * 365;
-    }
-    if (multiplier <= 0) {
-      return void 0;
-    }
-    return new Date(now.getTime() - amount * multiplier);
-  }
-  const parsed = new Date(trimmed);
-  if (Number.isNaN(parsed.getTime())) {
-    return void 0;
-  }
-  return parsed;
-}
 function entryCreatedAfter(entry, cutoff) {
   if (!cutoff) {
     return true;
@@ -3685,10 +3692,23 @@ function entryCreatedAfter(entry, cutoff) {
   }
   return created.getTime() >= cutoff.getTime();
 }
-function passesFilters(entry, query, cutoff, allowedScopes, normalizedTags, isSessionStart) {
+function entryCreatedBefore(entry, ceiling) {
+  if (!ceiling) {
+    return true;
+  }
+  const created = new Date(entry.created_at);
+  if (Number.isNaN(created.getTime())) {
+    return false;
+  }
+  return created.getTime() <= ceiling.getTime();
+}
+function passesFilters(entry, query, cutoff, ceiling, allowedScopes, normalizedTags, isSessionStart) {
   if (entry.superseded_by) {
     return false;
   }
+  if (entry.retired) {
+    return false;
+  }
   if (isSessionStart && entry.suppressed_contexts?.includes("session-start")) {
     return false;
   }
@@ -3710,6 +3730,9 @@ function passesFilters(entry, query, cutoff, allowedScopes, normalizedTags, isSe
   if (!entryCreatedAfter(entry, cutoff)) {
     return false;
   }
+  if (!entryCreatedBefore(entry, ceiling)) {
+    return false;
+  }
   const entryScope = entry.scope ?? "private";
   if (!allowedScopes.has(entryScope)) {
     return false;
@@ -3792,7 +3815,7 @@ function computeSpacingFactor(intervals, recallCount, createdAt, lastRecalledAt)
   }
   return Math.max(1, Math.log1p(maxGapDays + 1));
 }
-function scoreEntryWithBreakdown(entry, vectorSim, ftsMatch, now) {
+function scoreEntryWithBreakdown(entry, vectorSim, ftsMatch, now, freshnessNow = now) {
   const daysOld = parseDaysBetween(now, entry.created_at);
   const daysSinceRecall = entry.last_recalled_at ? parseDaysBetween(now, entry.last_recalled_at) : daysOld;
   const rawVector = clamp01(vectorSim);
@@ -3807,7 +3830,7 @@ function scoreEntryWithBreakdown(entry, vectorSim, ftsMatch, now) {
     entry.last_recalled_at
   );
   const fts = ftsMatch ? 0.15 : 0;
-  const fresh = freshnessBoost(entry, now);
+  const fresh = freshnessBoost(entry, freshnessNow);
   const spacedRecallBase = Math.min(recallBase * spacingFactor, 1);
   const memoryStrength = Math.min(Math.max(imp, spacedRecallBase) * fresh, 1);
   const todoPenalty = entry.type === "todo" ? todoStaleness(entry, now) : 1;
@@ -3893,6 +3916,7 @@ async function fetchVectorCandidates(db, queryEmbedding, limit, platform, projec
       CROSS JOIN entries AS e ON e.rowid = v.id
       WHERE e.embedding IS NOT NULL
         AND e.superseded_by IS NULL
+        AND e.retired = 0
         ${projectSql.clause}
         ${platform ? "AND e.platform = ?" : ""}
     `,
@@ -3957,6 +3981,7 @@ async function fetchSessionCandidates(db, limit, context, platform, project, exc
         suppressed_contexts
       FROM entries
       WHERE superseded_by IS NULL
+        AND retired = 0
         ${context === "session-start" ? `AND (suppressed_contexts IS NULL OR suppressed_contexts NOT LIKE '%"session-start"%')` : ""}
         ${projectSql.clause}
         ${platform ? "AND platform = ?" : ""}
@@ -3999,6 +4024,7 @@ async function runFts(db, text2, platform, project, excludeProject, projectStric
         JOIN entries AS e ON e.rowid = entries_fts.rowid
         WHERE entries_fts MATCH ?
           AND e.superseded_by IS NULL
+          AND e.retired = 0
           ${projectSql.clause}
           ${platform ? "AND e.platform = ?" : ""}
         LIMIT 250
@@ -4027,8 +4053,8 @@ async function updateRecallMetadata(db, ids, now) {
     args: [now.toISOString(), epochSecs, ...ids]
   });
 }
-function scoreSessionEntry(entry, now) {
-  return scoreEntryWithBreakdown(entry, 1, false, now);
+function scoreSessionEntry(entry, effectiveNow, freshnessNow) {
+  return scoreEntryWithBreakdown(entry, 1, false, effectiveNow, freshnessNow);
 }
 async function recall(db, query, apiKey, options = {}) {
   const now = options.now ?? /* @__PURE__ */ new Date();
@@ -4046,8 +4072,28 @@ async function recall(db, query, apiKey, options = {}) {
     throw new Error("--no-boost requires query text.");
   }
   const normalizedTags = normalizeTags(query.tags);
-  const cutoff = parseSince(query.since, now);
+  let cutoff;
+  try {
+    cutoff = parseSince(query.since, now);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    const sinceValue = query.since ?? "";
+    throw new Error(`Invalid since value "${sinceValue}": ${reason}`);
+  }
+  let ceiling;
+  try {
+    ceiling = parseSince(query.until, now);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid until value "${query.until ?? ""}": ${reason}`);
+  }
+  if (cutoff !== void 0 && ceiling !== void 0 && cutoff > ceiling) {
+    throw new Error(
+      `Invalid date range: since (${cutoff.toISOString()}) must be earlier than until (${ceiling.toISOString()}). since sets the lower bound, until the upper bound.`
+    );
+  }
   const allowedScopes = resolveScopeSet(query.scope);
+  const hasDateBounds = cutoff !== void 0 || ceiling !== void 0;
   let candidates;
   let effectiveText = text2;
   if (text2) {
@@ -4058,19 +4104,21 @@ async function recall(db, query, apiKey, options = {}) {
     if (!queryEmbedding) {
       throw new Error("Embedding provider returned no vector for recall query.");
     }
+    const vectorLimit = hasDateBounds ? (options.vectorCandidateLimit ?? DEFAULT_VECTOR_CANDIDATE_LIMIT) * 3 : options.vectorCandidateLimit ?? DEFAULT_VECTOR_CANDIDATE_LIMIT;
     candidates = await fetchVectorCandidates(
       db,
       queryEmbedding,
-      options.vectorCandidateLimit ?? DEFAULT_VECTOR_CANDIDATE_LIMIT,
+      vectorLimit,
       platform,
       project,
       excludeProject,
       projectStrict
     );
   } else {
+    const sessionLimit = hasDateBounds ? (options.sessionCandidateLimit ?? DEFAULT_SESSION_CANDIDATE_LIMIT) * 3 : options.sessionCandidateLimit ?? DEFAULT_SESSION_CANDIDATE_LIMIT;
     candidates = await fetchSessionCandidates(
       db,
-      options.sessionCandidateLimit ?? DEFAULT_SESSION_CANDIDATE_LIMIT,
+      sessionLimit,
       context,
       platform,
       project,
@@ -4079,16 +4127,17 @@ async function recall(db, query, apiKey, options = {}) {
     );
   }
   const filtered = candidates.filter(
-    (candidate) => passesFilters(candidate.entry, query, cutoff, allowedScopes, normalizedTags, isSessionStart)
+    (candidate) => passesFilters(candidate.entry, query, cutoff, ceiling, allowedScopes, normalizedTags, isSessionStart)
   );
   if (filtered.length === 0) {
     return [];
   }
   const ftsMatches = text2 && !query.noBoost ? await runFts(db, effectiveText, platform, project, excludeProject, projectStrict) : /* @__PURE__ */ new Set();
+  const effectiveNow = ceiling ?? now;
   const scored = filtered.map((candidate) => {
     const ftsMatch = ftsMatches.has(candidate.entry.id);
     if (!text2) {
-      const sessionScore = scoreSessionEntry(candidate.entry, now);
+      const sessionScore = scoreSessionEntry(candidate.entry, effectiveNow, now);
       return {
         entry: candidate.entry,
         score: sessionScore.score,
@@ -4112,7 +4161,7 @@ async function recall(db, query, apiKey, options = {}) {
         }
       };
     }
-    const detailed = scoreEntryWithBreakdown(candidate.entry, candidate.vectorSim, ftsMatch, now);
+    const detailed = scoreEntryWithBreakdown(candidate.entry, candidate.vectorSim, ftsMatch, effectiveNow, now);
     return {
       entry: candidate.entry,
       score: detailed.score,
@@ -5849,6 +5898,7 @@ async function countActiveEntries(db, platform, project, excludeProject) {
       SELECT COUNT(*) AS count
       FROM entries
       WHERE superseded_by IS NULL
+        AND retired = 0
         ${platform ? "AND platform = ?" : ""}
         ${projectSql.clause}
     `,
@@ -5890,6 +5940,7 @@ async function expireDecayedEntries(db, now, options) {
     SELECT id, content, expiry, created_at
     FROM entries
     WHERE superseded_by IS NULL
+      AND retired = 0
       AND expiry = 'temporary'
       ${options.platform ? "AND platform = ?" : ""}
       ${projectSql.clause}
@@ -5952,6 +6003,7 @@ async function mergeNearExactDuplicates(db, options) {
     SELECT COUNT(*) AS count
     FROM entries
     WHERE superseded_by IS NULL
+      AND retired = 0
       AND embedding IS NOT NULL
       ${options.platform ? "AND platform = ?" : ""}
       ${projectSql.clause}
@@ -5976,6 +6028,7 @@ async function mergeNearExactDuplicates(db, options) {
     SELECT id, type, subject, content, project, embedding, confirmations, recall_count, created_at
     FROM entries
     WHERE superseded_by IS NULL
+      AND retired = 0
       AND embedding IS NOT NULL
       ${options.platform ? "AND platform = ?" : ""}
       ${projectSql.clause}
@@ -6362,6 +6415,7 @@ async function buildClusters(db, options = {}) {
            recall_count, created_at, merged_from, consolidated_at
     FROM entries
     WHERE superseded_by IS NULL
+      AND retired = 0
       AND embedding IS NOT NULL
       ${platform ? "AND platform = ?" : ""}
       ${projectCondition}
@@ -9219,6 +9273,29 @@ PREFERENCE:
   "source_context": "User mentioned scheduling preference during calendar discussion -- scored 6 not 8 because no parallel session needs to act on this immediately; it is a low-urgency convenience preference"
 }
 
+// NOTE: These examples are drawn from OpenClaw transcripts (agent role labels, tool-verified claims). They provide soft cross-platform guidance for hedged-claim handling; mechanical enforcement (importance cap + unverified tag) is only applied for the openclaw platform via applyConfidenceCap().
+Example: hedged agent claim (correct handling):
+{
+  "type": "fact",
+  "subject": "agenr openclaw ingestion support",
+  "content": "Agent expressed uncertainty about whether agenr supports OpenClaw session ingestion. This has not been tool-verified.",
+  "importance": 5,
+  "expiry": "temporary",
+  "tags": ["agenr", "openclaw", "unverified"],
+  "canonical_key": "agenr-openclaw-ingestion-support-uncertain"
+}
+
+Example: tool-verified agent claim (correct handling):
+{
+  "type": "fact",
+  "subject": "agenr openclaw ingestion",
+  "content": "agenr actively ingests OpenClaw sessions. Confirmed via exec output showing watch active on 3 files.",
+  "importance": 7,
+  "expiry": "temporary",
+  "tags": ["agenr", "openclaw"],
+  "canonical_key": "agenr-openclaw-ingestion-active"
+}
+
 ### BORDERLINE \u2014 skip these
 
 SKIP: "The assistant read the config file and found the port was 3000."
@@ -9264,6 +9341,84 @@ WHY: Routine execution. No durable knowledge, decisions, or lessons.
 - source_context: one sentence, max 20 words.
 - tags: 1-4 lowercase descriptive tags.
 When related memories are injected before a chunk, they are reference material only. They do not lower the emission threshold.`;
+var OPENCLAW_CONFIDENCE_ADDENDUM = `
+## Confidence Language (role-labeled transcripts)
+
+Transcript lines are prefixed with [user] or [assistant] role labels.
+Apply confidence-language analysis to [assistant] statements only.
+Never apply this logic to [user] messages.
+
+### Verified agent statements - normal importance rules apply
+
+An [assistant] statement is verified when it meets ANY of these conditions:
+- It immediately follows a line matching the pattern [called X: ...] such as
+  [called exec: ...], [called web_search: ...], [called web_fetch: ...],
+  [called Read: ...], [called write: ...], or any [called ...: ...] marker
+- It uses explicit verification language such as: "I confirmed", "I verified",
+  "I checked and", "the output shows", "the test shows", "confirmed via",
+  "the file shows", "I ran", "the result shows"
+- It is a direct summary of tool output returned in the same chunk
+
+### Hedged agent statements - cap importance at 5 and add "unverified" tag
+
+An [assistant] statement is hedged when it uses speculative language WITHOUT
+any of the verification signals above. Hedging indicators:
+- Uncertainty: "I think", "I believe", "I assume", "I'm not sure", "probably",
+  "likely", "I don't know if", "I imagine", "I suspect"
+- Conditional: "it might be", "it could be", "possibly", "maybe"
+- Unverified recall: "I recall that", "if I remember correctly",
+  "I seem to recall", "I think we"
+
+When an [assistant] factual claim is hedged and unverified:
+- Set importance to min(your assigned importance, 5)
+- Add the tag "unverified"
+- Apply all other normal extraction rules unchanged
+
+EXCEPTION: Do NOT cap agent recommendations or opinions. "I think we should
+use pnpm" is a recommendation, not a factual claim. Only cap FACTUAL CLAIMS
+made with hedging language. Ask: is the agent asserting a fact about the
+world, or expressing a preference or suggestion?
+
+Do NOT apply any cap to [assistant] lines that ARE the tool call markers
+themselves (lines like "[called exec: ls]"). These are structural metadata,
+not agent assertions.
+
+### Examples
+
+HEDGED FACTUAL CLAIM - cap at 5, add "unverified":
+  [m00010][assistant] I think agenr doesn't support OpenClaw ingestion yet.
+  Result: importance capped at 5, tags include "unverified"
+
+HEDGED FACTUAL CLAIM - cap at 5, add "unverified":
+  [m00015][assistant] Probably the port is 3000 - I'm not 100% sure.
+  Result: importance capped at 5, tags include "unverified"
+
+VERIFIED after tool call - normal importance:
+  [m00020][assistant] [called exec: agenr watch --list]
+  [m00021][assistant] I confirmed via the output that OpenClaw ingestion is
+  active on 3 files.
+  Result: normal importance, no "unverified" tag
+
+VERIFIED by explicit language - normal importance:
+  [m00030][assistant] I verified in the source that the port is 4242.
+  Result: normal importance
+
+USER STATEMENT - never capped regardless of hedging language:
+  [m00040][user] I'm not 100% sure, but I think our API key was rotated.
+  Result: normal importance, no cap applied
+
+RECOMMENDATION - not a factual claim, never capped:
+  [m00050][assistant] I think we should switch to pnpm for consistency.
+  Result: this is a suggestion, not a fact - do not apply the cap
+`;
+function buildExtractionSystemPrompt(platform) {
+  if (platform === "openclaw") {
+    return `${SYSTEM_PROMPT}
+
+${OPENCLAW_CONFIDENCE_ADDENDUM}`;
+  }
+  return SYSTEM_PROMPT;
+}
 var MAX_ATTEMPTS = 5;
 var DEFAULT_INTER_CHUNK_DELAY_MS = 150;
 var DEDUP_BATCH_SIZE = 50;
@@ -9525,6 +9680,12 @@ function validateEntry(entry) {
   }
   return null;
 }
+function applyConfidenceCap(entry, platform) {
+  if (platform === "openclaw" && entry.tags.includes("unverified") && entry.importance > 5) {
+    return { ...entry, importance: 5 };
+  }
+  return entry;
+}
 function selectStringField(record, ...keys) {
   for (const key of keys) {
     const value = record[key];
@@ -9990,7 +10151,7 @@ async function sleepMs2(ms) {
 async function extractChunkOnce(params) {
   const prompt = buildUserPrompt(params.chunk, params.related);
   const context = {
-    systemPrompt: SYSTEM_PROMPT,
+    systemPrompt: params.systemPrompt ?? SYSTEM_PROMPT,
     messages: [
       {
         role: "user",
@@ -10029,6 +10190,7 @@ async function extractChunkOnce(params) {
   return { entries, warnings };
 }
 async function extractKnowledgeFromChunks(params) {
+  const systemPrompt = buildExtractionSystemPrompt(params.platform);
   const warnings = [];
   const entries = [];
   let successfulChunks = 0;
@@ -10087,6 +10249,7 @@ async function extractKnowledgeFromChunks(params) {
               chunk,
               model: params.client.resolvedModel.model,
               apiKey: params.client.credentials.apiKey,
+              systemPrompt,
               verbose: params.verbose,
               onVerbose: params.onVerbose,
               onStreamDelta: bufferStreamDeltas ? (delta, kind) => {
@@ -10126,15 +10289,32 @@ async function extractKnowledgeFromChunks(params) {
           );
         } else if (chunkResult) {
           dynamicDelay = Math.max(baseDelay, Math.floor(dynamicDelay * 0.9));
+          const validatedChunkEntries = [];
+          for (const entry of chunkResult.entries) {
+            const capped = applyConfidenceCap(entry, params.platform);
+            if (params.verbose && capped.importance !== entry.importance) {
+              params.onVerbose?.(
+                `[confidence-cap] lowered importance from ${entry.importance} to 5 (unverified tag)`
+              );
+            }
+            const validationIssue = validateEntry(capped);
+            if (validationIssue) {
+              if (params.verbose) {
+                params.onVerbose?.(`[entry-drop] ${validationIssue}`);
+              }
+              continue;
+            }
+            validatedChunkEntries.push(capped);
+          }
           if (params.onChunkComplete) {
             await params.onChunkComplete({
               chunkIndex: chunk.chunk_index,
               totalChunks: params.chunks.length,
-              entries: chunkResult.entries,
+              entries: validatedChunkEntries,
               warnings: chunkResult.warnings
             });
           } else {
-            entries.push(...chunkResult.entries);
+            entries.push(...validatedChunkEntries);
           }
         }
         if (params.onStreamDelta) {
@@ -12887,6 +13067,7 @@ async function runIngestCommand(inputPaths, options, deps) {
         chunks: parsed.chunks,
         client,
         verbose: false,
+        platform: platform ?? parsed.metadata?.platform ?? void 0,
         llmConcurrency,
         db: options.noPreFetch ? void 0 : db,
         embeddingApiKey: options.noPreFetch ? void 0 : embeddingApiKey ?? void 0,
@@ -13803,6 +13984,10 @@ var TOOL_DEFINITIONS = [
           type: "string",
           description: "Only entries newer than this (ISO date or relative, e.g. 7d, 1m)."
         },
+        until: {
+          type: "string",
+          description: "Only entries created before this point in time (ISO date or relative, e.g. 7d = entries older than 7 days). Use with since for a date range: since sets the lower bound, until the upper bound."
+        },
         threshold: {
           type: "number",
           description: "Minimum relevance score from 0.0 to 1.0.",
@@ -14047,42 +14232,6 @@ function parseCsvProjects(input) {
   }
   return parsed;
 }
-function parseSinceToIso(since, now) {
-  if (!since) {
-    return void 0;
-  }
-  const trimmed = since.trim();
-  if (!trimmed) {
-    return void 0;
-  }
-  const durationMatch = trimmed.match(/^(\d+)\s*([hdmy])$/i);
-  if (durationMatch) {
-    const amount = Number(durationMatch[1]);
-    const unit = durationMatch[2]?.toLowerCase();
-    if (!Number.isFinite(amount) || amount <= 0 || !unit) {
-      throw new RpcError(JSON_RPC_INVALID_PARAMS, "Invalid since value");
-    }
-    let multiplier = 0;
-    if (unit === "h") {
-      multiplier = 1e3 * 60 * 60;
-    } else if (unit === "d") {
-      multiplier = 1e3 * 60 * 60 * 24;
-    } else if (unit === "m") {
-      multiplier = 1e3 * 60 * 60 * 24 * 30;
-    } else if (unit === "y") {
-      multiplier = 1e3 * 60 * 60 * 24 * 365;
-    }
-    if (multiplier <= 0) {
-      throw new RpcError(JSON_RPC_INVALID_PARAMS, "Invalid since value");
-    }
-    return new Date(now.getTime() - amount * multiplier).toISOString();
-  }
-  const parsedDate = new Date(trimmed);
-  if (Number.isNaN(parsedDate.getTime())) {
-    throw new RpcError(JSON_RPC_INVALID_PARAMS, "Invalid since value");
-  }
-  return parsedDate.toISOString();
-}
 function normalizeTags3(value) {
   if (!Array.isArray(value)) {
     return [];
@@ -14359,7 +14508,22 @@ function createMcpServer(options = {}, deps = {}) {
     const threshold = parseThreshold(args.threshold);
     const now = resolvedDeps.nowFn();
     const types = typeof args.types === "string" && args.types.trim().length > 0 ? parseCsvTypes(args.types) : void 0;
-    const since = typeof args.since === "string" && args.since.trim().length > 0 ? parseSinceToIso(args.since, now) : void 0;
+    let since;
+    if (typeof args.since === "string" && args.since.trim().length > 0) {
+      try {
+        since = parseSinceToIso(args.since, now);
+      } catch {
+        throw new RpcError(JSON_RPC_INVALID_PARAMS, "Invalid since value");
+      }
+    }
+    let until;
+    if (typeof args.until === "string" && args.until.trim().length > 0) {
+      try {
+        until = parseSinceToIso(args.until, now);
+      } catch {
+        throw new RpcError(JSON_RPC_INVALID_PARAMS, "Invalid until value");
+      }
+    }
     const platformRaw = typeof args.platform === "string" ? args.platform.trim() : "";
     const platform = platformRaw ? normalizeKnowledgePlatform(platformRaw) : null;
     if (platformRaw && !platform) {
@@ -14397,6 +14561,7 @@ function createMcpServer(options = {}, deps = {}) {
           limit,
           types,
           since,
+          until,
           platform: platform ?? void 0,
           project,
           projectStrict: projectStrict ? true : void 0,
@@ -14417,6 +14582,7 @@ function createMcpServer(options = {}, deps = {}) {
           limit,
           types,
           since,
+          until,
           platform: platform ?? void 0,
           project,
           projectStrict: projectStrict ? true : void 0
@@ -14807,40 +14973,6 @@ function parseCsv(input) {
     )
   );
 }
-function parseSinceToIso2(since, now = /* @__PURE__ */ new Date()) {
-  if (!since) {
-    return void 0;
-  }
-  const trimmed = since.trim();
-  if (!trimmed) {
-    return void 0;
-  }
-  const duration = trimmed.match(/^(\d+)\s*([hdy])$/i);
-  if (duration) {
-    const amount = Number(duration[1]);
-    const unit = duration[2]?.toLowerCase();
-    if (!Number.isFinite(amount) || amount <= 0 || !unit) {
-      throw new Error("Invalid --since duration. Use 1h, 7d, 30d, or 1y.");
-    }
-    let millis = 0;
-    if (unit === "h") {
-      millis = amount * 60 * 60 * 1e3;
-    } else if (unit === "d") {
-      millis = amount * 24 * 60 * 60 * 1e3;
-    } else if (unit === "y") {
-      millis = amount * 365 * 24 * 60 * 60 * 1e3;
-    }
-    if (millis <= 0) {
-      throw new Error("Invalid --since duration. Use 1h, 7d, 30d, or 1y.");
-    }
-    return new Date(now.getTime() - millis).toISOString();
-  }
-  const parsed = new Date(trimmed);
-  if (Number.isNaN(parsed.getTime())) {
-    throw new Error("Invalid --since value. Use 1h, 7d, 30d, 1y, or an ISO date.");
-  }
-  return parsed.toISOString();
-}
 function stripEmbedding(result) {
   const { embedding, ...entryWithoutEmbedding } = result.entry;
   return {
@@ -15009,7 +15141,8 @@ async function runRecallCommand(queryInput, options, deps) {
   const project = parsedProject.length > 0 ? parsedProject : void 0;
   const excludeProject = parsedExcludeProject.length > 0 ? parsedExcludeProject : void 0;
   const projectStrict = options.strict === true && Boolean(project && project.length > 0);
-  const sinceIso = parseSinceToIso2(options.since, now);
+  const sinceIso = parseSinceToIso(options.since, now, "Invalid --since value. Use 1h, 7d, 1m, 1y, or an ISO date.");
+  const untilIso = parseSinceToIso(options.until, now, "Invalid --until value. Use 1h, 7d, 1m, 1y, or an ISO date.");
   const queryForRecall = {
     text: queryText ? shapeRecallText(queryText, context) : void 0,
     limit,
@@ -15017,6 +15150,7 @@ async function runRecallCommand(queryInput, options, deps) {
     tags: tags.length > 0 ? tags : void 0,
     minImportance,
     since: sinceIso,
+    until: untilIso,
     expiry,
     scope: scope ?? "private",
     platform,
@@ -16091,6 +16225,7 @@ async function runWatcher(options, deps) {
           chunks: parsed.chunks,
           client,
           verbose: options.verbose,
+          platform: currentPlatform && currentPlatform !== "mtime" ? normalizeKnowledgePlatform(currentPlatform) ?? void 0 : void 0,
           db: options.noPreFetch ? void 0 : db ?? void 0,
           embeddingApiKey: options.noPreFetch ? void 0 : embeddingApiKey ?? void 0,
           noPreFetch: options.noPreFetch === true,
@@ -17456,13 +17591,14 @@ function createProgram() {
       process.exitCode = result.exitCode;
     }
   );
-  program.command("recall").description("Recall knowledge from the local database").argument("[query]", "Natural language query").option("--limit <n>", "Maximum number of results", parseIntOption, 10).option("--type <types>", "Filter by comma-separated entry types").option("--tags <tags>", "Filter by comma-separated tags").option("--min-importance <n>", "Minimum importance: 1-10").option("--since <duration>", "Filter by recency (1h, 7d, 30d, 1y) or ISO timestamp").option("--expiry <level>", "Filter by expiry: core|permanent|temporary").option("--platform <name>", "Filter by platform: openclaw, claude-code, codex").option("--project <name>", "Filter by project (repeatable)", (val, prev) => [...prev, val], []).option("--exclude-project <name>", "Exclude entries from project (repeatable)", (val, prev) => [...prev, val], []).option("--strict", "Exclude NULL-project entries from results", false).option("--json", "Output JSON", false).option("--db <path>", "Database path override").option("--budget <tokens>", "Approximate token budget", parseIntOption).option("--context <mode>", "Context mode: default|session-start|topic:<query>", "default").option("--scope <level>", "Visibility scope: private|personal|public", "private").option("--no-boost", "Disable scoring boosts and use raw vector similarity", false).option("--no-update", "Do not increment recall metadata", false).action(async (query, opts) => {
+  program.command("recall").description("Recall knowledge from the local database").argument("[query]", "Natural language query").option("--limit <n>", "Maximum number of results", parseIntOption, 10).option("--type <types>", "Filter by comma-separated entry types").option("--tags <tags>", "Filter by comma-separated tags").option("--min-importance <n>", "Minimum importance: 1-10").option("--since <duration>", "Filter by recency (1h, 7d, 30d, 1y) or ISO timestamp").option("--until <date>", "Only entries at or before this time (ISO date or relative, e.g. 7d, 1m)").option("--expiry <level>", "Filter by expiry: core|permanent|temporary").option("--platform <name>", "Filter by platform: openclaw, claude-code, codex").option("--project <name>", "Filter by project (repeatable)", (val, prev) => [...prev, val], []).option("--exclude-project <name>", "Exclude entries from project (repeatable)", (val, prev) => [...prev, val], []).option("--strict", "Exclude NULL-project entries from results", false).option("--json", "Output JSON", false).option("--db <path>", "Database path override").option("--budget <tokens>", "Approximate token budget", parseIntOption).option("--context <mode>", "Context mode: default|session-start|topic:<query>", "default").option("--scope <level>", "Visibility scope: private|personal|public", "private").option("--no-boost", "Disable scoring boosts and use raw vector similarity", false).option("--no-update", "Do not increment recall metadata", false).action(async (query, opts) => {
     const result = await runRecallCommand(query, {
       limit: opts.limit,
       type: opts.type,
       tags: opts.tags,
       minImportance: opts.minImportance,
       since: opts.since,
+      until: opts.until,
       expiry: opts.expiry,
       platform: opts.platform,
       project: opts.project,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.7.13",
+  "version": "0.7.14",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"