agent-recall-core 3.4.51 → 3.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (164) hide show
  1. package/README.md +670 -330
  2. package/dist/digest/match.d.ts +2 -0
  3. package/dist/digest/match.d.ts.map +1 -1
  4. package/dist/digest/match.js +5 -0
  5. package/dist/digest/match.js.map +1 -1
  6. package/dist/digest/store.d.ts.map +1 -1
  7. package/dist/digest/store.js +2 -3
  8. package/dist/digest/store.js.map +1 -1
  9. package/dist/embeddings/config.d.ts.map +1 -1
  10. package/dist/embeddings/config.js +17 -4
  11. package/dist/embeddings/config.js.map +1 -1
  12. package/dist/helpers/alignment-patterns.d.ts +46 -0
  13. package/dist/helpers/alignment-patterns.d.ts.map +1 -1
  14. package/dist/helpers/alignment-patterns.js +103 -2
  15. package/dist/helpers/alignment-patterns.js.map +1 -1
  16. package/dist/helpers/journal-files.d.ts +12 -6
  17. package/dist/helpers/journal-files.d.ts.map +1 -1
  18. package/dist/helpers/journal-files.js +13 -7
  19. package/dist/helpers/journal-files.js.map +1 -1
  20. package/dist/index.d.ts +23 -6
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +23 -5
  23. package/dist/index.js.map +1 -1
  24. package/dist/palace/rooms.d.ts +7 -0
  25. package/dist/palace/rooms.d.ts.map +1 -1
  26. package/dist/palace/rooms.js +13 -0
  27. package/dist/palace/rooms.js.map +1 -1
  28. package/dist/prompts/consolidation-prompt.js +14 -14
  29. package/dist/retrieval/candidates.d.ts +17 -0
  30. package/dist/retrieval/candidates.d.ts.map +1 -1
  31. package/dist/retrieval/candidates.js +4 -2
  32. package/dist/retrieval/candidates.js.map +1 -1
  33. package/dist/retrieval/contradiction.d.ts +42 -0
  34. package/dist/retrieval/contradiction.d.ts.map +1 -1
  35. package/dist/retrieval/contradiction.js +126 -7
  36. package/dist/retrieval/contradiction.js.map +1 -1
  37. package/dist/retrieval/lexical-index.d.ts +150 -0
  38. package/dist/retrieval/lexical-index.d.ts.map +1 -0
  39. package/dist/retrieval/lexical-index.js +516 -0
  40. package/dist/retrieval/lexical-index.js.map +1 -0
  41. package/dist/retrieval/query-memory.d.ts +17 -7
  42. package/dist/retrieval/query-memory.d.ts.map +1 -1
  43. package/dist/retrieval/query-memory.js +279 -71
  44. package/dist/retrieval/query-memory.js.map +1 -1
  45. package/dist/storage/classification.d.ts.map +1 -1
  46. package/dist/storage/classification.js +6 -1
  47. package/dist/storage/classification.js.map +1 -1
  48. package/dist/storage/content-guard.d.ts +32 -0
  49. package/dist/storage/content-guard.d.ts.map +1 -1
  50. package/dist/storage/content-guard.js +467 -48
  51. package/dist/storage/content-guard.js.map +1 -1
  52. package/dist/storage/corrections.d.ts +3 -1
  53. package/dist/storage/corrections.d.ts.map +1 -1
  54. package/dist/storage/corrections.js +52 -67
  55. package/dist/storage/corrections.js.map +1 -1
  56. package/dist/storage/cwd-allowlist.d.ts +30 -2
  57. package/dist/storage/cwd-allowlist.d.ts.map +1 -1
  58. package/dist/storage/cwd-allowlist.js +105 -22
  59. package/dist/storage/cwd-allowlist.js.map +1 -1
  60. package/dist/storage/deferred-bookkeeping.d.ts +34 -0
  61. package/dist/storage/deferred-bookkeeping.d.ts.map +1 -0
  62. package/dist/storage/deferred-bookkeeping.js +201 -0
  63. package/dist/storage/deferred-bookkeeping.js.map +1 -0
  64. package/dist/storage/filelock.d.ts +26 -8
  65. package/dist/storage/filelock.d.ts.map +1 -1
  66. package/dist/storage/filelock.js +202 -26
  67. package/dist/storage/filelock.js.map +1 -1
  68. package/dist/storage/frontmatter.d.ts +14 -0
  69. package/dist/storage/frontmatter.d.ts.map +1 -0
  70. package/dist/storage/frontmatter.js +22 -0
  71. package/dist/storage/frontmatter.js.map +1 -0
  72. package/dist/storage/fs-utils.d.ts +53 -0
  73. package/dist/storage/fs-utils.d.ts.map +1 -1
  74. package/dist/storage/fs-utils.js +140 -2
  75. package/dist/storage/fs-utils.js.map +1 -1
  76. package/dist/storage/hook-session.d.ts +9 -0
  77. package/dist/storage/hook-session.d.ts.map +1 -0
  78. package/dist/storage/hook-session.js +49 -0
  79. package/dist/storage/hook-session.js.map +1 -0
  80. package/dist/storage/identity-card.d.ts +27 -0
  81. package/dist/storage/identity-card.d.ts.map +1 -0
  82. package/dist/storage/identity-card.js +86 -0
  83. package/dist/storage/identity-card.js.map +1 -0
  84. package/dist/storage/lifecycle-telemetry.d.ts +1 -1
  85. package/dist/storage/lifecycle-telemetry.d.ts.map +1 -1
  86. package/dist/storage/lifecycle-telemetry.js +2 -2
  87. package/dist/storage/lifecycle-telemetry.js.map +1 -1
  88. package/dist/storage/memory-protocol.js +55 -55
  89. package/dist/storage/paths.d.ts.map +1 -1
  90. package/dist/storage/paths.js +7 -2
  91. package/dist/storage/paths.js.map +1 -1
  92. package/dist/storage/pending.d.ts +39 -3
  93. package/dist/storage/pending.d.ts.map +1 -1
  94. package/dist/storage/pending.js +126 -20
  95. package/dist/storage/pending.js.map +1 -1
  96. package/dist/storage/project.d.ts.map +1 -1
  97. package/dist/storage/project.js +34 -9
  98. package/dist/storage/project.js.map +1 -1
  99. package/dist/storage/session.d.ts.map +1 -1
  100. package/dist/storage/session.js +43 -16
  101. package/dist/storage/session.js.map +1 -1
  102. package/dist/storage/state-card.d.ts +59 -0
  103. package/dist/storage/state-card.d.ts.map +1 -0
  104. package/dist/storage/state-card.js +162 -0
  105. package/dist/storage/state-card.js.map +1 -0
  106. package/dist/storage/store-manifest.js +57 -57
  107. package/dist/storage/unclaimed.js +2 -2
  108. package/dist/storage/unclaimed.js.map +1 -1
  109. package/dist/supabase/config.d.ts.map +1 -1
  110. package/dist/supabase/config.js +7 -1
  111. package/dist/supabase/config.js.map +1 -1
  112. package/dist/supabase/embedding.d.ts.map +1 -1
  113. package/dist/supabase/embedding.js +7 -0
  114. package/dist/supabase/embedding.js.map +1 -1
  115. package/dist/supabase/sync.d.ts.map +1 -1
  116. package/dist/supabase/sync.js +42 -18
  117. package/dist/supabase/sync.js.map +1 -1
  118. package/dist/tools-logic/bootstrap.d.ts.map +1 -1
  119. package/dist/tools-logic/bootstrap.js +4 -2
  120. package/dist/tools-logic/bootstrap.js.map +1 -1
  121. package/dist/tools-logic/check.d.ts +69 -2
  122. package/dist/tools-logic/check.d.ts.map +1 -1
  123. package/dist/tools-logic/check.js +280 -57
  124. package/dist/tools-logic/check.js.map +1 -1
  125. package/dist/tools-logic/dream-admission.js +29 -29
  126. package/dist/tools-logic/recall-backend.d.ts.map +1 -1
  127. package/dist/tools-logic/recall-backend.js +11 -1
  128. package/dist/tools-logic/recall-backend.js.map +1 -1
  129. package/dist/tools-logic/session-end.d.ts +18 -1
  130. package/dist/tools-logic/session-end.d.ts.map +1 -1
  131. package/dist/tools-logic/session-end.js +36 -5
  132. package/dist/tools-logic/session-end.js.map +1 -1
  133. package/dist/tools-logic/session-start-render.d.ts +35 -0
  134. package/dist/tools-logic/session-start-render.d.ts.map +1 -0
  135. package/dist/tools-logic/session-start-render.js +240 -0
  136. package/dist/tools-logic/session-start-render.js.map +1 -0
  137. package/dist/tools-logic/session-start.d.ts +21 -0
  138. package/dist/tools-logic/session-start.d.ts.map +1 -1
  139. package/dist/tools-logic/session-start.js +279 -225
  140. package/dist/tools-logic/session-start.js.map +1 -1
  141. package/dist/tools-logic/smart-recall.d.ts +60 -0
  142. package/dist/tools-logic/smart-recall.d.ts.map +1 -1
  143. package/dist/tools-logic/smart-recall.js +221 -31
  144. package/dist/tools-logic/smart-recall.js.map +1 -1
  145. package/dist/tools-logic/smart-remember-vector.d.ts +3 -1
  146. package/dist/tools-logic/smart-remember-vector.d.ts.map +1 -1
  147. package/dist/tools-logic/smart-remember-vector.js +3 -1
  148. package/dist/tools-logic/smart-remember-vector.js.map +1 -1
  149. package/dist/tools-logic/smart-remember.d.ts.map +1 -1
  150. package/dist/tools-logic/smart-remember.js +8 -5
  151. package/dist/tools-logic/smart-remember.js.map +1 -1
  152. package/dist/types.d.ts +98 -2
  153. package/dist/types.d.ts.map +1 -1
  154. package/dist/types.js +164 -3
  155. package/dist/types.js.map +1 -1
  156. package/dist/vector/embedding.d.ts +20 -1
  157. package/dist/vector/embedding.d.ts.map +1 -1
  158. package/dist/vector/embedding.js +30 -1
  159. package/dist/vector/embedding.js.map +1 -1
  160. package/dist/vector/local-vector-backend.d.ts +4 -1
  161. package/dist/vector/local-vector-backend.d.ts.map +1 -1
  162. package/dist/vector/local-vector-backend.js +7 -3
  163. package/dist/vector/local-vector-backend.js.map +1 -1
  164. package/package.json +59 -59
@@ -1 +1 @@
1
- {"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../src/retrieval/candidates.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../src/retrieval/candidates.ts"],"names":[],"mappings":"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"}
@@ -268,6 +268,48 @@ export interface ContradictionResult {
268
268
  * pattern, ported verbatim from the plain extractor's callers).
269
269
  */
270
270
  export declare function extractHighPrecisionVersionTokens(text: string): Map<string, string>;
271
+ /**
272
+ * 3.5.2 (2026-10-16) — marker-less `NUMBER unit per unit` rate-fact
273
+ * extractor, the grammar extension the 2026-10-15 rigorous eval's §7 item 2
274
+ * called for. Adversarial T5a proved the gap: "API rate limit set to 100
275
+ * requests per minute" vs "raised to 500 requests per minute" carries no
276
+ * `v/@/version` marker, so `extractHighPrecisionVersionTokens` extracts
277
+ * nothing, the stale fact gets no `supersededBy` annotation, and (under the
278
+ * hybrid leg, whose semantic votes carry no recency signal) the superseded
279
+ * 100-limit deterministically outranked its own replacement.
280
+ *
281
+ * PRECISION ANCHOR — why this is NOT the removed kv/status/bare-number
282
+ * grammar coming back (W5a salvage HIGH-1/HIGH-2; STEP 4b): the full
283
+ * `<number> <unit-word> per <unit-word>` frame is required, making the match
284
+ * self-describing the same way the mandatory version marker is:
285
+ * - a bare count ("30 days", "3 files", "two pages") has no `per` → no token;
286
+ * - "$5 per user" (number directly before `per`, no unit word between) → no
287
+ * token — the unit word is mandatory;
288
+ * - IPs / dot-dates / dotted step numbers ("10.0.0.1", "08.15.2026",
289
+ * "step 1.2.3") never present a whitespace-separated `N unit per unit`
290
+ * frame, and the `(?<![\d.])` lookbehind stops a dotted run's tail
291
+ * digits from posing as the number;
292
+ * - the TWO-word key (`unit-per-unit`, e.g. `request-per-minute`) gives
293
+ * the topical protection the removed one-word kv keys ("priority",
294
+ * "env") never had.
295
+ * Residual risk, accepted and documented like the version branch's own
296
+ * 4-component-semver note: two topically-DIFFERENT facts that share an
297
+ * identical rate frame ("ingested 100 records per day" vs "exported 500
298
+ * records per day") can still collide when both match the same query within
299
+ * one tier's top candidates AND carry different dates. The blast radius is
300
+ * the bounded relative cap (see query-memory.ts's `applySupersessionCap`) —
301
+ * both items are still returned and annotated, never dropped — not the
302
+ * global ×0.5 inversion class STEP 4a removed.
303
+ *
304
+ * Values are numeric-normalized (`String(Number(...))`: "500" === "500.0")
305
+ * and keys unit-normalized (see `normalizeRateUnit`). Same Map semantics as
306
+ * the version extractor: a later mention of the same key within ONE text
307
+ * overwrites the earlier one.
308
+ *
309
+ * EXPORTED for direct unit-testing (the `extractHighPrecisionVersionTokens`
310
+ * precedent) and for any future `conflict-scan.ts`-style consumer.
311
+ */
312
+ export declare function extractRateFactTokens(text: string): Map<string, string>;
271
313
  /**
272
314
  * Pairwise contradiction scan over one tier's candidate list. O(n²) — the
273
315
  * caller (query-memory.ts) is expected to run this AFTER tokenize+score
@@ -1 +1 @@
1
- {"version":3,"file":"contradiction.d.ts","sourceRoot":"","sources":["../../src/retrieval/contradiction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiMG;AAcH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb;kEAC8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;oBAGgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWnF;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAmCpF"}
1
+ {"version":3,"file":"contradiction.d.ts","sourceRoot":"","sources":["../../src/retrieval/contradiction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiMG;AAcH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb;kEAC8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;oBAGgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAuDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWnF;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcvE;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAmCpF"}
@@ -222,13 +222,26 @@
222
222
  */
223
223
  function grammarConflict(a, b) {
224
224
  const av = extractHighPrecisionVersionTokens(a.text);
225
- if (av.size === 0)
226
- return false;
227
- const bv = extractHighPrecisionVersionTokens(b.text);
228
- for (const [key, val] of av) {
229
- const bval = bv.get(key);
230
- if (bval && bval !== val)
231
- return true;
225
+ if (av.size > 0) {
226
+ const bv = extractHighPrecisionVersionTokens(b.text);
227
+ for (const [key, val] of av) {
228
+ const bval = bv.get(key);
229
+ if (bval && bval !== val)
230
+ return true;
231
+ }
232
+ }
233
+ // 3.5.2 (2026-10-16, adversarial T5a — see extractRateFactTokens below):
234
+ // marker-less `NUMBER unit per unit` rate facts join the grammar as a
235
+ // SECOND, independently-anchored branch. Same comparison discipline as the
236
+ // version branch: shared fact-key + differing value → conflict.
237
+ const ar = extractRateFactTokens(a.text);
238
+ if (ar.size > 0) {
239
+ const br = extractRateFactTokens(b.text);
240
+ for (const [key, val] of ar) {
241
+ const bval = br.get(key);
242
+ if (bval && bval !== val)
243
+ return true;
244
+ }
232
245
  }
233
246
  return false;
234
247
  }
@@ -275,6 +288,112 @@ export function extractHighPrecisionVersionTokens(text) {
275
288
  }
276
289
  return result;
277
290
  }
291
+ // ---------------------------------------------------------------------------
292
+ // 3.5.2 rate-fact grammar (2026-10-16, adversarial T5a,
293
+ // reports/2026-10-15-rigorous-eval.md Finding 2 / §7 item 2)
294
+ // ---------------------------------------------------------------------------
295
+ /**
296
+ * 3.5.2 UNIT NORMALIZATION for `extractRateFactTokens` — maps common
297
+ * abbreviations onto their full word and strips a plural `s`, so
298
+ * "50 req per min" and "75 requests per minute" produce the SAME fact-key.
299
+ * Deliberately tiny: only the unambiguous time/request abbreviations that
300
+ * appear in ordinary rate-limit prose. Plural stripping is length-gated
301
+ * (≥4 chars, not `ss`-final) so short abbreviations that END in `s` by
302
+ * construction ("rps", "ms", "qps") are never mangled into non-words.
303
+ */
304
+ const RATE_UNIT_ALIASES = {
305
+ min: "minute",
306
+ mins: "minute",
307
+ sec: "second",
308
+ secs: "second",
309
+ hr: "hour",
310
+ hrs: "hour",
311
+ req: "request",
312
+ reqs: "request",
313
+ };
314
+ function normalizeRateUnit(word) {
315
+ const w = word.toLowerCase();
316
+ const aliased = RATE_UNIT_ALIASES[w];
317
+ if (aliased)
318
+ return aliased;
319
+ if (w.length >= 4 && w.endsWith("s") && !w.endsWith("ss"))
320
+ return w.slice(0, -1);
321
+ return w;
322
+ }
323
+ /**
324
+ * MEDIUM-1 (review fix, 2026-10-16, reports/2026-10-16-review-correctness.md)
325
+ * — GENERIC-FREQUENCY DENYLIST for the COUNTED-NOUN position. "ran 5 times
326
+ * per day" vs "retried 3 times per day" produced a cross-topic supersession:
327
+ * `time-per-<period>` is the single most common `N unit per unit` frame in
328
+ * ordinary narrative prose and carries near-zero topical signal — W5a
329
+ * HIGH-2's generic one-word key recurring in two-word form for exactly this
330
+ * unit family. Genuine rate-limit facts name the RESOURCE noun ("requests",
331
+ * "jobs", "records"); "N times per day" is almost always narrative.
332
+ * Checked POST-normalization ("times" → "time", "occurrences" →
333
+ * "occurrence"), counted-noun position only — the `per <period>` side is
334
+ * untouched. Deliberately tiny, like RATE_UNIT_ALIASES: extend it only with
335
+ * units that are generic FREQUENCY words, never resource nouns.
336
+ * Scalar-noun generalization (ports/timeouts/etc.) is a separate, later
337
+ * branch — see the review's "Brief questions answered" section.
338
+ */
339
+ const RATE_UNIT_DENYLIST = new Set(["time", "occurrence"]);
340
+ /**
341
+ * 3.5.2 (2026-10-16) — marker-less `NUMBER unit per unit` rate-fact
342
+ * extractor, the grammar extension the 2026-10-15 rigorous eval's §7 item 2
343
+ * called for. Adversarial T5a proved the gap: "API rate limit set to 100
344
+ * requests per minute" vs "raised to 500 requests per minute" carries no
345
+ * `v/@/version` marker, so `extractHighPrecisionVersionTokens` extracts
346
+ * nothing, the stale fact gets no `supersededBy` annotation, and (under the
347
+ * hybrid leg, whose semantic votes carry no recency signal) the superseded
348
+ * 100-limit deterministically outranked its own replacement.
349
+ *
350
+ * PRECISION ANCHOR — why this is NOT the removed kv/status/bare-number
351
+ * grammar coming back (W5a salvage HIGH-1/HIGH-2; STEP 4b): the full
352
+ * `<number> <unit-word> per <unit-word>` frame is required, making the match
353
+ * self-describing the same way the mandatory version marker is:
354
+ * - a bare count ("30 days", "3 files", "two pages") has no `per` → no token;
355
+ * - "$5 per user" (number directly before `per`, no unit word between) → no
356
+ * token — the unit word is mandatory;
357
+ * - IPs / dot-dates / dotted step numbers ("10.0.0.1", "08.15.2026",
358
+ * "step 1.2.3") never present a whitespace-separated `N unit per unit`
359
+ * frame, and the `(?<![\d.])` lookbehind stops a dotted run's tail
360
+ * digits from posing as the number;
361
+ * - the TWO-word key (`unit-per-unit`, e.g. `request-per-minute`) gives
362
+ * the topical protection the removed one-word kv keys ("priority",
363
+ * "env") never had.
364
+ * Residual risk, accepted and documented like the version branch's own
365
+ * 4-component-semver note: two topically-DIFFERENT facts that share an
366
+ * identical rate frame ("ingested 100 records per day" vs "exported 500
367
+ * records per day") can still collide when both match the same query within
368
+ * one tier's top candidates AND carry different dates. The blast radius is
369
+ * the bounded relative cap (see query-memory.ts's `applySupersessionCap`) —
370
+ * both items are still returned and annotated, never dropped — not the
371
+ * global ×0.5 inversion class STEP 4a removed.
372
+ *
373
+ * Values are numeric-normalized (`String(Number(...))`: "500" === "500.0")
374
+ * and keys unit-normalized (see `normalizeRateUnit`). Same Map semantics as
375
+ * the version extractor: a later mention of the same key within ONE text
376
+ * overwrites the earlier one.
377
+ *
378
+ * EXPORTED for direct unit-testing (the `extractHighPrecisionVersionTokens`
379
+ * precedent) and for any future `conflict-scan.ts`-style consumer.
380
+ */
381
+ export function extractRateFactTokens(text) {
382
+ const result = new Map();
383
+ const pattern = /(?<![\d.])(\d+(?:\.\d+)?)\s+([a-z][a-z-]{0,30})\s+per\s+([a-z][a-z-]{0,30})\b/gi;
384
+ let m;
385
+ while ((m = pattern.exec(text)) !== null) {
386
+ const unit = normalizeRateUnit(m[2]);
387
+ // MEDIUM-1 review fix — see RATE_UNIT_DENYLIST above: a generic
388
+ // frequency word in the counted-noun position is narrative, not a fact.
389
+ if (RATE_UNIT_DENYLIST.has(unit))
390
+ continue;
391
+ const value = String(Number(m[1]));
392
+ const key = `${unit}-per-${normalizeRateUnit(m[3])}`;
393
+ result.set(key, value);
394
+ }
395
+ return result;
396
+ }
278
397
  function resolveDirection(a, b) {
279
398
  if (a.date && b.date) {
280
399
  const da = Date.parse(a.date);
@@ -1 +1 @@
1
- {"version":3,"file":"contradiction.js","sourceRoot":"","sources":["../../src/retrieval/contradiction.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contradiction.js","sourceRoot":"","sources":["../../src/retrieval/contradiction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,150 @@
1
+ /**
2
+ * retrieval/lexical-index.ts — persistent, incremental lexical index for the
3
+ * journal tier (perf/lexical-index, 2026-10-16; reports/2026-10-15-rigorous-
4
+ * eval.md scale finding: 10k journal entries → recall p50 ~1.0-1.3 s, because
5
+ * `scoreJournalTier` re-reads and re-tokenizes the WHOLE corpus on every
6
+ * query — 10k `readFileSync`s + trust-tagging in the fetch stage alone
7
+ * measured ~1.2 s warm on win32; the full-corpus IDF tokenization adds
8
+ * another ~190 ms).
9
+ *
10
+ * WHAT IT STORES — per journal file, keyed by absolute path and validated by
11
+ * (size, mtimeNs): the DERIVED, query-independent data the journal scorer
12
+ * needs before it has to touch file content:
13
+ * - `u` — the rescue-quarantine trust bit (isRescueSourcedContent), so the
14
+ * trust FILTER no longer requires reading every file per query;
15
+ * - `t` — the file's unique stemmed token set (tokenizeWords + stem, the
16
+ * exact inputs `buildIdfModel`'s per-doc `tokenSet` is built from);
17
+ * - `r` — the file's unique lowercase whitespace-run set. Because every
18
+ * query keyword/variant is whitespace-free (tokenizeWords output),
19
+ * `content.toLowerCase().includes(term)` ⟺ some run contains
20
+ * `term` as a substring — this makes BOTH the per-line
21
+ * `lineMatchesQuery` prefilter AND `buildIdfModel`'s
22
+ * `d.lower.includes(v)` DF predicate answerable from the index
23
+ * with zero false negatives (a false POSITIVE only costs one
24
+ * file read that then produces no hits).
25
+ * Terms are stored once in a shared `vocab` table; docs reference vocab ids.
26
+ *
27
+ * WHAT IT NEVER STORES — file content, excerpts, scores, or anything
28
+ * query-dependent. Line-level hit generation still reads the real file (only
29
+ * for docs the prefilter says CAN match), so a stale/poisoned index can skew
30
+ * ranking weights but cannot fabricate content. Contents ARE cached
31
+ * IN-PROCESS (per (size, mtimeNs), pruned to the enumerated file set on each
32
+ * drift) — a long-lived MCP server holds roughly one copy of the hot
33
+ * project's journal text in RAM, the same order of memory the brute-force
34
+ * path already allocated transiently on EVERY query.
35
+ *
36
+ * BOUNDED CACHE (review fix, 2026-10-16, reports/2026-10-16-review-
37
+ * correctness.md MEDIUM): the in-process per-project states are an LRU —
38
+ * at most AGENT_RECALL_LEXICAL_MAX_PROJECTS project states (default 4) and
39
+ * at most AGENT_RECALL_LEXICAL_MAX_CONTENT_MB of cached content text
40
+ * (default 256 MB, UTF-16 accounting) are retained, least-recently-queried
41
+ * project evicted first; the project being queried is never evicted by its
42
+ * own call, so a single over-budget hot project keeps working (documented
43
+ * exemption, not a leak — it is one corpus, the brute path's own transient
44
+ * working set). Eviction only drops the IN-PROCESS cache: the next query for
45
+ * an evicted project reloads the persisted index from disk and lazily
46
+ * re-reads contents — results identical (pinned by the LRU/byte-budget
47
+ * tests). Bounds are enforced per loadJournalLexicalSnapshot call;
48
+ * trustedContent reads between calls can transiently exceed the byte budget
49
+ * by at most the active project's own corpus until the next query.
50
+ *
51
+ * TRUST (security): the cached `u` bit is an OPTIMIZATION, not the trust
52
+ * boundary. Every content read performed through this module re-runs
53
+ * `isRescueSourcedContent` on the bytes actually read (`trustedContent`
54
+ * below) and refuses to return rescue-tagged content — so a hand-poisoned
55
+ * index file (or the accepted same-(size,mtime)-different-content staleness
56
+ * window, same class the embedding index-store documents) can never SURFACE
57
+ * quarantined content; at worst it perturbs IDF document-frequency counts
58
+ * for files that are never read. An attacker who can write this index file
59
+ * lives inside the AgentRecall root and could already edit the journal
60
+ * files/frontmatter themselves — no new privilege is created (same residual
61
+ * class as storage/corrections.ts's planted-file note).
62
+ *
63
+ * INVALIDATION — every snapshot load re-enumerates the journal directories
64
+ * (listJournalFiles + the same archive readdir/filter the Wave-1 reader
65
+ * uses) and re-stats every enumerated file (bigint mtimeNs + size). A file
66
+ * created, deleted, or edited OUTSIDE the tool is therefore picked up on the
67
+ * very next query — there is no write-path hook to forget, and no TTL
68
+ * window. Stale/missing entries are re-read and re-derived inline (the
69
+ * incremental update), and the refreshed index is persisted.
70
+ *
71
+ * WRITES follow the embeddings/index-store.ts conventions: full payload
72
+ * built first, then written under `withLock("lexical-index-<project>")` via
73
+ * tmp+rename (writeJsonAtomic) — lock-free readers never observe a torn
74
+ * file; concurrent refreshes serialize. READS are lock-free and
75
+ * corruption-TOLERANT: any structural problem (truncated JSON from a killed
76
+ * writer's half-flushed tmp, garbage bytes, wrong version, malformed doc
77
+ * rows) degrades to "entry missing" → re-derive from the real files →
78
+ * rewrite. The recall path never throws from here (`loadJournalLexicalSnapshot`
79
+ * returns null on any unexpected failure, and scoreJournalTier falls back to
80
+ * the brute-force path).
81
+ *
82
+ * EQUIVALENCE — the consumer (query-memory.ts's scoreJournalTier) is built
83
+ * so the indexed path produces IDENTICAL rankings to the brute-force path:
84
+ * same candidate enumeration order (listJournalFiles live half; the same
85
+ * archive filter + date-desc stable sort as candidates.ts's rollup half),
86
+ * same trust filter, same line-scan code on the same content, and an IDF
87
+ * model assembled from index-derived DF counts that match buildIdfModel's
88
+ * predicate exactly (see the `r`/`t` notes above). Pinned by
89
+ * test/lexical-index.test.mjs's brute-vs-indexed deep-equality suite. The
90
+ * ONE documented divergence: a file deleted between this module's stat sweep
91
+ * and a (failed) content read stays counted in the IDF corpus size for that
92
+ * query, where brute force would have dropped it at fetch — a transient,
93
+ * mid-query-mutation-only window.
94
+ */
95
+ /** Kill switch / test oracle toggle — default ON; "0"/"false"/"off" disables. */
96
+ export declare function lexicalIndexEnabled(): boolean;
97
+ /** The index file's on-disk location — built via projectSubPath so the
98
+ * sanitize + assertInsideRoot guards apply exactly once, like every other
99
+ * project-scoped path in this package. */
100
+ export declare function lexicalJournalIndexPath(project: string): string;
101
+ /** Reset all in-process caches (tests — simulates a fresh process). */
102
+ export declare function resetLexicalIndexCaches(): void;
103
+ /** Introspection for tests / a future `ar` doctor surface: how many project
104
+ * states are resident and how much content text they cache (UTF-16 bytes). */
105
+ export declare function lexicalIndexCacheStats(): {
106
+ states: number;
107
+ contentBytes: number;
108
+ };
109
+ export interface LexicalSnapshotDoc {
110
+ /** Filename date prefix for live/archive docs; "" when undeterminable (same semantics as MemoryCandidate.date for the journal tier). */
111
+ date: string;
112
+ /** Basename. */
113
+ file: string;
114
+ /** Absolute path. */
115
+ path: string;
116
+ /** Cached rescue-quarantine bit (content reads re-verify; see module header). */
117
+ untrusted: boolean;
118
+ }
119
+ export interface LexicalJournalSnapshot {
120
+ /** Docs in the EXACT order the brute-force journal fetch would produce
121
+ * (live half via listJournalFiles' own date-desc order, then the rollup-
122
+ * archive half date-desc) — hit-generation order, and therefore stable-
123
+ * sort tie-breaks, match brute force by construction. */
124
+ docs: ReadonlyArray<LexicalSnapshotDoc>;
125
+ /** Indices of docs whose lowercase content contains `term` as a substring
126
+ * (term must be whitespace-free — every tokenizeWords/expandQuery output
127
+ * is). Includes untrusted docs; callers filter. Memoized per snapshot. */
128
+ docsContaining(term: string): ReadonlySet<number>;
129
+ /** Indices of docs whose stemmed token set contains `term` exactly. */
130
+ docsWithStemToken(term: string): ReadonlySet<number>;
131
+ /** The doc's content, re-verified through the rescue-quarantine choke at
132
+ * read time — returns null for unreadable files AND for content that is
133
+ * rescue-tagged on the actual bytes read (whatever the cached bit says). */
134
+ trustedContent(i: number): string | null;
135
+ }
136
+ /**
137
+ * Load (building/refreshing as needed) the lexical snapshot for a project's
138
+ * journal tier. Returns null when the index is disabled or anything
139
+ * unexpected fails — the caller falls back to the brute-force path.
140
+ *
141
+ * Per-call work when nothing changed: one readdir pass per journal dir +
142
+ * one statSync per enumerated file (the external-edit detection the module
143
+ * header documents — ~115 ms for 10k files on win32, measured) + an
144
+ * elementwise fingerprint compare. Derivation/persist run only for drifted
145
+ * files.
146
+ */
147
+ export declare function loadJournalLexicalSnapshot(project: string, opts: {
148
+ includeRollupArchive: boolean;
149
+ }): Promise<LexicalJournalSnapshot | null>;
150
+ //# sourceMappingURL=lexical-index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lexical-index.d.ts","sourceRoot":"","sources":["../../src/retrieval/lexical-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6FG;AAgBH,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;2CAE2C;AAC3C,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AA8HD,uEAAuE;AACvE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;+EAC+E;AAC/E,wBAAgB,sBAAsB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAIjF;AAMD,MAAM,WAAW,kBAAkB;IACjC,wIAAwI;IACxI,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;8DAG0D;IAC1D,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACxC;;+EAE2E;IAC3E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,uEAAuE;IACvE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD;;iFAE6E;IAC7E,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1C;AAgHD;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,GACtC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA4KxC"}