recallnest 1.4.1

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 (261) hide show
  1. package/.claude-plugin/CLAUDE.md +29 -0
  2. package/.claude-plugin/marketplace.json +18 -0
  3. package/.env.example +3 -0
  4. package/.github/workflows/ci.yml +28 -0
  5. package/.mcp.json +9 -0
  6. package/CHANGELOG.md +51 -0
  7. package/CLAUDE.md +42 -0
  8. package/DEMO.md +94 -0
  9. package/EVAL.md +89 -0
  10. package/FAILURES.md +75 -0
  11. package/LICENSE +21 -0
  12. package/OPERATIONS.md +59 -0
  13. package/README.md +427 -0
  14. package/README_CN.md +425 -0
  15. package/ROADMAP.md +198 -0
  16. package/assets/recallnest-workbench.png +0 -0
  17. package/assets/ui/app.js +807 -0
  18. package/assets/ui/index.html +154 -0
  19. package/assets/ui/styles.css +605 -0
  20. package/assets/wechat-qr.jpg +0 -0
  21. package/config.json.example +38 -0
  22. package/daily-recall.sh +87 -0
  23. package/daily-reflections/2026-03-05.md +15 -0
  24. package/daily-reflections/2026-03-06.md +15 -0
  25. package/daily-reflections/2026-03-07.md +7 -0
  26. package/daily-reflections/2026-03-08.md +34 -0
  27. package/daily-reflections/2026-03-09.md +35 -0
  28. package/daily-reflections/2026-03-10.md +36 -0
  29. package/daily-reflections/2026-03-11.md +35 -0
  30. package/daily-reflections/2026-03-12.md +36 -0
  31. package/daily-reflections/2026-03-13.md +35 -0
  32. package/daily-reflections/2026-03-14.md +35 -0
  33. package/daily-reflections/2026-03-15.md +35 -0
  34. package/daily-reflections/2026-03-16.md +41 -0
  35. package/daily-reflections/2026-03-17.md +10 -0
  36. package/daily-reflections/2026-03-18.md +10 -0
  37. package/daily-reflections/2026-03-19.md +10 -0
  38. package/daily-reflections/2026-03-20.md +10 -0
  39. package/daily-reflections/2026-03-21.md +10 -0
  40. package/daily-reflections/2026-03-22.md +10 -0
  41. package/daily-reflections/2026-03-23.md +10 -0
  42. package/daily-reflections/2026-03-24.md +10 -0
  43. package/daily-reflections/2026-03-25.md +32 -0
  44. package/daily-reflections/2026-03-26.md +37 -0
  45. package/daily-reflections/2026-03-27.md +35 -0
  46. package/daily-reflections/2026-03-28.md +35 -0
  47. package/daily-reflections/2026-03-29.md +35 -0
  48. package/daily-reflections/2026-03-30.md +36 -0
  49. package/daily-reflections/2026-03-31.md +35 -0
  50. package/daily-reflections/2026-04-01.md +35 -0
  51. package/docs/api-reference.md +1291 -0
  52. package/docs/architecture.md +168 -0
  53. package/docs/memory-boundary-contract.md +226 -0
  54. package/docs/memory-categories.md +119 -0
  55. package/docs/pipeline-audit-ultramemory.md +177 -0
  56. package/docs/plans/2026-03-08-query-expansion.md +270 -0
  57. package/docs/plans/2026-03-16-continuity-layer.md +196 -0
  58. package/docs/plans/mcp-tiering-plan.md +126 -0
  59. package/docs/research/recall-quality-audit-2026-03-22.md +153 -0
  60. package/docs/self-evolution.md +198 -0
  61. package/docs/superpowers/plans/2026-03-19-ingest-pipeline-upgrade.md +782 -0
  62. package/docs/superpowers/specs/2026-03-19-ingest-pipeline-upgrade-design.md +77 -0
  63. package/docs/superpowers/specs/2026-03-23-pull-claude-desktop-design.md +95 -0
  64. package/eval/cases.json +85 -0
  65. package/eval/continuity/case-seeds.json +90 -0
  66. package/eval/continuity/cases.json +302 -0
  67. package/eval/continuity/memory-seeds.json +26 -0
  68. package/eval/continuity/pattern-seeds.json +100 -0
  69. package/eval/continuity/results-2026-03-16.md +117 -0
  70. package/eval/continuity/results-2026-03-19.md +453 -0
  71. package/eval/continuity/runbook.md +110 -0
  72. package/eval/continuity/seed-cases.md +54 -0
  73. package/eval/reports/2026-03-06-abstract-query-baseline.md +96 -0
  74. package/eval/reports/2026-03-06-aws-ssh-baseline.md +82 -0
  75. package/eval/reports/2026-03-06-baseline.md +82 -0
  76. package/eval/reports/query-expansion.md +138 -0
  77. package/integrations/README.md +57 -0
  78. package/integrations/claude-code/README.md +133 -0
  79. package/integrations/claude-code/claude-md-snippet.md +31 -0
  80. package/integrations/claude-code/setup.sh +66 -0
  81. package/integrations/claude-code/smoke-continuity.sh +452 -0
  82. package/integrations/codex/README.md +49 -0
  83. package/integrations/codex/agents-md-snippet.md +31 -0
  84. package/integrations/codex/setup.sh +58 -0
  85. package/integrations/examples/claude-agent-sdk/memory-agent.ts +182 -0
  86. package/integrations/examples/langchain/memory-chain.py +111 -0
  87. package/integrations/examples/openai-agents-sdk/memory-agent.py +109 -0
  88. package/integrations/gemini-cli/README.md +57 -0
  89. package/integrations/gemini-cli/gemini-md-snippet.md +31 -0
  90. package/integrations/gemini-cli/setup.sh +64 -0
  91. package/integrations/shared/install-managed-block.sh +51 -0
  92. package/lm +19 -0
  93. package/package.json +50 -0
  94. package/plan-v1.2-distributable.md +105 -0
  95. package/scripts/archive-distilled-junk.ts +116 -0
  96. package/scripts/backfill-l0l1l2.ts +98 -0
  97. package/scripts/blind-scan.ts +588 -0
  98. package/scripts/cleanup-step1-exact-dups.ts +117 -0
  99. package/scripts/cleanup-step2-template-dups.ts +113 -0
  100. package/scripts/cleanup-step3-stale-content.ts +149 -0
  101. package/scripts/cleanup-step4-orphan-scopes.ts +131 -0
  102. package/scripts/delete-distilled-junk.ts +88 -0
  103. package/scripts/distill-facts.ts +305 -0
  104. package/scripts/health-check.ts +343 -0
  105. package/scripts/incremental-ingest.sh +71 -0
  106. package/scripts/mlp-health-check.ts +382 -0
  107. package/scripts/pull-claude-desktop.ts +515 -0
  108. package/scripts/re-ingest-cc.sh +66 -0
  109. package/scripts/rebalance-memory-health.ts +181 -0
  110. package/scripts/run-desktop-ingest.sh +11 -0
  111. package/scripts/start-server.sh +12 -0
  112. package/scripts/viz-dashboard.html +423 -0
  113. package/scripts/viz-export.ts +703 -0
  114. package/src/__tests__/access-tracker-novelty.test.ts +228 -0
  115. package/src/__tests__/auto-consolidation.test.ts +168 -0
  116. package/src/__tests__/auto-recall.test.ts +131 -0
  117. package/src/__tests__/batch-dedup.test.ts +65 -0
  118. package/src/__tests__/capture-engine.test.ts +1142 -0
  119. package/src/__tests__/capture-heuristic.test.ts +171 -0
  120. package/src/__tests__/cascade-forget.test.ts +210 -0
  121. package/src/__tests__/category-min-scores.test.ts +33 -0
  122. package/src/__tests__/confidence-tracker.test.ts +196 -0
  123. package/src/__tests__/conflict-advisor.test.ts +206 -0
  124. package/src/__tests__/conflict-escalation.test.ts +149 -0
  125. package/src/__tests__/conflict-lifecycle.test.ts +83 -0
  126. package/src/__tests__/conflict-output.test.ts +85 -0
  127. package/src/__tests__/conflict-store.test.ts +374 -0
  128. package/src/__tests__/consolidation-engine.test.ts +181 -0
  129. package/src/__tests__/context-composer-pins.test.ts +64 -0
  130. package/src/__tests__/context-composer-task-selection.test.ts +24 -0
  131. package/src/__tests__/context-renderer.test.ts +91 -0
  132. package/src/__tests__/continuity-eval.test.ts +275 -0
  133. package/src/__tests__/continuity-schema.test.ts +97 -0
  134. package/src/__tests__/core-recall-eval.test.ts +235 -0
  135. package/src/__tests__/core-summary.test.ts +109 -0
  136. package/src/__tests__/dedup-actions.test.ts +58 -0
  137. package/src/__tests__/deterministic-id.test.ts +39 -0
  138. package/src/__tests__/doctor.test.ts +303 -0
  139. package/src/__tests__/drill-down.test.ts +108 -0
  140. package/src/__tests__/embedder.test.ts +122 -0
  141. package/src/__tests__/entity-resolver.test.ts +58 -0
  142. package/src/__tests__/event-segmenter.test.ts +153 -0
  143. package/src/__tests__/hotness-blend.test.ts +76 -0
  144. package/src/__tests__/ingest.test.ts +360 -0
  145. package/src/__tests__/kg-extractor.test.ts +184 -0
  146. package/src/__tests__/kg-store.test.ts +198 -0
  147. package/src/__tests__/llm-consolidation.test.ts +226 -0
  148. package/src/__tests__/memory-boundaries.test.ts +237 -0
  149. package/src/__tests__/memory-health-rebalance.test.ts +144 -0
  150. package/src/__tests__/memory-output.test.ts +215 -0
  151. package/src/__tests__/multi-vector.test.ts +242 -0
  152. package/src/__tests__/ppr-traversal.test.ts +256 -0
  153. package/src/__tests__/preference-guard-smoke.test.ts +211 -0
  154. package/src/__tests__/preference-matcher.test.ts +230 -0
  155. package/src/__tests__/preference-slots.test.ts +106 -0
  156. package/src/__tests__/prospective-memory.test.ts +283 -0
  157. package/src/__tests__/query-entity-detector.test.ts +171 -0
  158. package/src/__tests__/query-expander.test.ts +34 -0
  159. package/src/__tests__/recall-mode.test.ts +64 -0
  160. package/src/__tests__/result-synthesizer.test.ts +198 -0
  161. package/src/__tests__/resume-context.test.ts +4743 -0
  162. package/src/__tests__/retrieval-trace.test.ts +213 -0
  163. package/src/__tests__/retriever-boundary-weight.test.ts +136 -0
  164. package/src/__tests__/retroactive-boost.test.ts +223 -0
  165. package/src/__tests__/scope-inventory.test.ts +200 -0
  166. package/src/__tests__/scope-policy.test.ts +69 -0
  167. package/src/__tests__/session-checkpoint.test.ts +259 -0
  168. package/src/__tests__/session-gc.test.ts +215 -0
  169. package/src/__tests__/store-scope-audit.test.ts +81 -0
  170. package/src/__tests__/temporal-parser.test.ts +241 -0
  171. package/src/__tests__/term-registry.test.ts +121 -0
  172. package/src/__tests__/tool-output-compressor.test.ts +133 -0
  173. package/src/__tests__/version-manager.test.ts +213 -0
  174. package/src/__tests__/workflow-observation.test.ts +400 -0
  175. package/src/access-tracker.ts +316 -0
  176. package/src/adaptive-retrieval.ts +64 -0
  177. package/src/api-server.ts +667 -0
  178. package/src/asset-sync.ts +79 -0
  179. package/src/auto-consolidation.ts +133 -0
  180. package/src/auto-gc.ts +124 -0
  181. package/src/auto-recall.ts +95 -0
  182. package/src/capture-engine.ts +931 -0
  183. package/src/capture-heuristic.ts +177 -0
  184. package/src/cascade-forget.ts +135 -0
  185. package/src/chunker.ts +253 -0
  186. package/src/cli.ts +1917 -0
  187. package/src/confidence-tracker.ts +166 -0
  188. package/src/conflict-advisor.ts +433 -0
  189. package/src/conflict-engine.ts +181 -0
  190. package/src/conflict-escalation.ts +138 -0
  191. package/src/conflict-lifecycle.ts +67 -0
  192. package/src/conflict-output.ts +218 -0
  193. package/src/conflict-schema.ts +130 -0
  194. package/src/conflict-store.ts +127 -0
  195. package/src/consolidation-engine.ts +256 -0
  196. package/src/context-composer-pins.ts +183 -0
  197. package/src/context-composer-queries.ts +121 -0
  198. package/src/context-composer-scope.ts +56 -0
  199. package/src/context-composer-stable-selection.ts +200 -0
  200. package/src/context-composer-stable.ts +217 -0
  201. package/src/context-composer-task-fallbacks.ts +36 -0
  202. package/src/context-composer-task-ranking.ts +197 -0
  203. package/src/context-composer-task-results.ts +137 -0
  204. package/src/context-composer-task-selection.ts +342 -0
  205. package/src/context-composer-text.ts +57 -0
  206. package/src/context-composer.ts +300 -0
  207. package/src/context-renderer.ts +179 -0
  208. package/src/decay-engine.ts +189 -0
  209. package/src/doctor.ts +543 -0
  210. package/src/embedder.ts +557 -0
  211. package/src/entity-resolver.ts +131 -0
  212. package/src/eval.ts +632 -0
  213. package/src/event-segmenter.ts +216 -0
  214. package/src/ingest.ts +1822 -0
  215. package/src/kg-extractor.ts +217 -0
  216. package/src/kg-store.ts +353 -0
  217. package/src/legacy-scope-review.ts +53 -0
  218. package/src/llm-client.ts +629 -0
  219. package/src/llm-consolidation.ts +168 -0
  220. package/src/mcp-server.ts +1337 -0
  221. package/src/memory-assets.ts +475 -0
  222. package/src/memory-boundaries.ts +354 -0
  223. package/src/memory-health-rebalance.ts +220 -0
  224. package/src/memory-output.ts +474 -0
  225. package/src/memory-schema.ts +184 -0
  226. package/src/multi-vector.ts +234 -0
  227. package/src/noise-filter.ts +155 -0
  228. package/src/ppr-traversal.ts +279 -0
  229. package/src/preference-matcher.ts +174 -0
  230. package/src/preference-slots.ts +259 -0
  231. package/src/prospective-memory.ts +198 -0
  232. package/src/query-entity-detector.ts +207 -0
  233. package/src/query-expander.ts +98 -0
  234. package/src/result-synthesizer.ts +114 -0
  235. package/src/retrieval-profiles.ts +101 -0
  236. package/src/retrieval-trace.ts +94 -0
  237. package/src/retriever.ts +1338 -0
  238. package/src/retroactive-boost.ts +154 -0
  239. package/src/rif.ts +73 -0
  240. package/src/runtime-config.ts +172 -0
  241. package/src/schema-utils.ts +56 -0
  242. package/src/scope-inventory.ts +310 -0
  243. package/src/scope-policy.ts +142 -0
  244. package/src/session-engine.ts +168 -0
  245. package/src/session-output.ts +96 -0
  246. package/src/session-schema.ts +60 -0
  247. package/src/session-store.ts +293 -0
  248. package/src/stderr-log.ts +16 -0
  249. package/src/store.ts +903 -0
  250. package/src/temporal-parser.ts +318 -0
  251. package/src/term-registry.ts +791 -0
  252. package/src/tool-output-compressor.ts +115 -0
  253. package/src/tracker.ts +57 -0
  254. package/src/ui-server.ts +430 -0
  255. package/src/version-manager.ts +172 -0
  256. package/src/workflow-observation-engine.ts +316 -0
  257. package/src/workflow-observation-managed.ts +83 -0
  258. package/src/workflow-observation-output.ts +86 -0
  259. package/src/workflow-observation-schema.ts +87 -0
  260. package/src/workflow-observation-scope-review.ts +409 -0
  261. package/src/workflow-observation-store.ts +69 -0
@@ -0,0 +1,91 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import { computeTermOverlap, extractTerms, renderMemories, type RenderableMemory } from "../context-renderer.js";
4
+
5
+ const MEMORIES: RenderableMemory[] = [
6
+ { id: "a", text: "I prefer TypeScript for all projects", score: 0.8, category: "preferences" },
7
+ { id: "b", text: "Docker deployment pipeline for RecallNest", score: 0.75, category: "patterns" },
8
+ { id: "c", text: "Fixed a LanceDB indexing bug yesterday", score: 0.9, category: "cases" },
9
+ ];
10
+
11
+ describe("extractTerms", () => {
12
+ it("removes stop words and short words", () => {
13
+ const terms = extractTerms("The quick brown fox is a great animal");
14
+ expect(terms.has("the")).toBe(false);
15
+ expect(terms.has("is")).toBe(false);
16
+ expect(terms.has("a")).toBe(false);
17
+ expect(terms.has("quick")).toBe(true);
18
+ expect(terms.has("brown")).toBe(true);
19
+ });
20
+
21
+ it("handles CJK text", () => {
22
+ const terms = extractTerms("我喜欢用 TypeScript 写代码");
23
+ expect(terms.has("typescript")).toBe(true);
24
+ });
25
+
26
+ it("lowercases all terms", () => {
27
+ const terms = extractTerms("TypeScript Docker LanceDB");
28
+ expect(terms.has("typescript")).toBe(true);
29
+ expect(terms.has("docker")).toBe(true);
30
+ });
31
+ });
32
+
33
+ describe("computeTermOverlap", () => {
34
+ it("returns 0 for empty sets", () => {
35
+ expect(computeTermOverlap(new Set(), new Set(["a"]))).toBe(0);
36
+ expect(computeTermOverlap(new Set(["a"]), new Set())).toBe(0);
37
+ });
38
+
39
+ it("returns 1 for identical sets", () => {
40
+ const s = new Set(["typescript", "docker"]);
41
+ expect(computeTermOverlap(s, s)).toBe(1);
42
+ });
43
+
44
+ it("returns partial overlap correctly", () => {
45
+ const a = new Set(["typescript", "docker", "lancedb"]);
46
+ const b = new Set(["typescript", "lancedb", "react"]);
47
+ // overlap=2, max(3,3)=3 → 2/3 ≈ 0.667
48
+ expect(computeTermOverlap(a, b)).toBeCloseTo(0.667, 2);
49
+ });
50
+ });
51
+
52
+ describe("renderMemories", () => {
53
+ it("verbatim mode preserves original order", () => {
54
+ const result = renderMemories(MEMORIES, "anything");
55
+ expect(result.mode).toBe("verbatim");
56
+ expect(result.memories.map(m => m.id)).toEqual(["a", "b", "c"]);
57
+ expect(result.memories[0].relevance).toBe(0.8);
58
+ });
59
+
60
+ it("highlight mode reorders by contextual relevance", () => {
61
+ const result = renderMemories(MEMORIES, "LanceDB indexing bug fix", "highlight");
62
+ expect(result.mode).toBe("highlight");
63
+ // Memory "c" should rank highest because it has strong term overlap with query
64
+ expect(result.memories[0].id).toBe("c");
65
+ });
66
+
67
+ it("highlight mode uses taskContext for scoring", () => {
68
+ const result = renderMemories(MEMORIES, "deployment", "highlight", "Docker pipeline");
69
+ // Memory "b" should rank high due to Docker + deployment + pipeline overlap
70
+ expect(result.memories[0].id).toBe("b");
71
+ });
72
+
73
+ it("synthesize mode processes memories", () => {
74
+ const result = renderMemories(MEMORIES, "TypeScript preferences", "synthesize");
75
+ expect(result.mode).toBe("synthesize");
76
+ expect(result.memories.length).toBe(3);
77
+ });
78
+
79
+ it("returns empty for empty input", () => {
80
+ const result = renderMemories([], "query", "highlight");
81
+ expect(result.memories.length).toBe(0);
82
+ });
83
+
84
+ it("relevance scores are rounded to 3 decimals in highlight mode", () => {
85
+ const result = renderMemories(MEMORIES, "test query", "highlight");
86
+ for (const m of result.memories) {
87
+ const decimals = String(m.relevance).split(".")[1]?.length ?? 0;
88
+ expect(decimals).toBeLessThanOrEqual(3);
89
+ }
90
+ });
91
+ });
@@ -0,0 +1,275 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import { buildContinuityEvalObservationInput, buildContinuityEvalRequest, createContinuityEvalCheckpointStore, runContinuityEval, runRetrievalEval, scoreContinuityCase } from "../eval.js";
4
+ import type { ResumeContextResponse } from "../session-schema.js";
5
+
6
+ describe("scoreContinuityCase", () => {
7
+ it("forwards profile and continuity fields into resume_context eval requests", () => {
8
+ expect(buildContinuityEvalRequest({
9
+ name: "writing_sparse",
10
+ task: "不要让我重复前情,接着写",
11
+ profile: "writing",
12
+ scope: "project:recallnest",
13
+ sessionId: "session-1",
14
+ limitPerSection: 4,
15
+ includeLatestCheckpoint: true,
16
+ })).toEqual({
17
+ task: "不要让我重复前情,接着写",
18
+ scope: "project:recallnest",
19
+ sessionId: "session-1",
20
+ profile: "writing",
21
+ limitPerSection: 4,
22
+ includeLatestCheckpoint: true,
23
+ });
24
+ });
25
+
26
+ it("falls back to the case checkpoint sessionId when the eval case omits top-level sessionId", () => {
27
+ expect(buildContinuityEvalRequest({
28
+ name: "project_scope_checkpoint_continuity",
29
+ task: "继续这个项目,不要让我重复前情",
30
+ profile: "default",
31
+ scope: "project:recallnest",
32
+ includeLatestCheckpoint: true,
33
+ checkpoint: {
34
+ sessionId: "eval-project-recallnest-checkpoint",
35
+ scope: "project:recallnest",
36
+ summary: "RecallNest continuity acceptance checkpoint fixture.",
37
+ },
38
+ })).toEqual({
39
+ task: "继续这个项目,不要让我重复前情",
40
+ scope: "project:recallnest",
41
+ sessionId: "eval-project-recallnest-checkpoint",
42
+ profile: "default",
43
+ limitPerSection: undefined,
44
+ includeLatestCheckpoint: true,
45
+ });
46
+ });
47
+
48
+ it("scores a continuity response using section-specific expectations", () => {
49
+ const response: ResumeContextResponse = {
50
+ summary: "Loaded stable context with a latest checkpoint for RecallNest continuity work.",
51
+ stableContext: [
52
+ "Preference: User prefers concise technical replies.",
53
+ "Entity: RecallNest is shared across Claude Code, Codex, and Gemini CLI.",
54
+ ],
55
+ relevantPatterns: [
56
+ "At task start, run search_memory before coding.",
57
+ ],
58
+ recentCases: [
59
+ "Keep session state in a checkpoint store instead of the durable index.",
60
+ ],
61
+ latestCheckpoint: {
62
+ sessionId: "session-1",
63
+ summary: "Continue building resume_context for fresh windows",
64
+ updatedAt: "2026-03-16T06:00:00.000Z",
65
+ },
66
+ generatedAt: "2026-03-16T06:05:00.000Z",
67
+ };
68
+
69
+ const report = scoreContinuityCase({
70
+ name: "continuity_case",
71
+ task: "continue RecallNest work",
72
+ expectStableAny: ["RecallNest", "Codex"],
73
+ expectPatternsAny: ["search_memory"],
74
+ expectCasesAny: ["checkpoint store"],
75
+ expectCheckpointAny: ["resume_context"],
76
+ }, response);
77
+
78
+ expect(report.passed).toBe(true);
79
+ expect(report.matchedStableAny).toEqual(["RecallNest", "Codex"]);
80
+ expect(report.matchedPatternsAny).toEqual(["search_memory"]);
81
+ expect(report.matchedCasesAny).toEqual(["checkpoint store"]);
82
+ expect(report.matchedCheckpointAny).toEqual(["resume_context"]);
83
+ expect(report.hasCheckpoint).toBe(true);
84
+ expect(report.score).toBeGreaterThan(0.9);
85
+ });
86
+
87
+ it("penalizes forbidden matches", () => {
88
+ const response: ResumeContextResponse = {
89
+ summary: "Loaded unrelated stable context.",
90
+ stableContext: ["Profile: unrelated memory"],
91
+ relevantPatterns: [],
92
+ recentCases: [],
93
+ generatedAt: "2026-03-16T06:10:00.000Z",
94
+ };
95
+
96
+ const report = scoreContinuityCase({
97
+ name: "continuity_forbid",
98
+ task: "fresh window",
99
+ forbid: ["unrelated"],
100
+ }, response);
101
+
102
+ expect(report.passed).toBe(false);
103
+ expect(report.forbiddenMatches).toEqual(["unrelated"]);
104
+ expect(report.score).toBeLessThan(0.8);
105
+ });
106
+
107
+ it("uses only case-defined checkpoint fixtures instead of live checkpoint state", async () => {
108
+ const checkpointStore = createContinuityEvalCheckpointStore([
109
+ {
110
+ name: "checkpoint_case",
111
+ scope: "recallnest",
112
+ includeLatestCheckpoint: true,
113
+ checkpoint: {
114
+ sessionId: "eval-session-1",
115
+ scope: "recallnest",
116
+ summary: "RecallNest Phase 3/4 checkpoint fixture with resume_context and store_memory.",
117
+ task: "Continue RecallNest continuity work",
118
+ decisions: ["Keep checkpoints out of the durable index"],
119
+ updatedAt: "2026-03-16T06:00:00.000Z",
120
+ },
121
+ },
122
+ ]);
123
+
124
+ const byScope = await checkpointStore.getLatest({ scope: "recallnest" });
125
+ const bySession = await checkpointStore.getLatest({ sessionId: "eval-session-1" });
126
+ const missing = await checkpointStore.getLatest({ scope: "other-project" });
127
+
128
+ expect(byScope).toMatchObject({
129
+ sessionId: "eval-session-1",
130
+ resolvedScope: "project:recallnest",
131
+ summary: "RecallNest Phase 3/4 checkpoint fixture with resume_context and store_memory.",
132
+ });
133
+ expect(bySession?.resolvedScope).toBe("project:recallnest");
134
+ expect(missing).toBeNull();
135
+ });
136
+
137
+ it("builds workflow observations for continuity eval results without using regular memory", () => {
138
+ const passed = buildContinuityEvalObservationInput({
139
+ name: "continuity_pass",
140
+ profile: "debug",
141
+ scope: "project:recallnest",
142
+ }, {
143
+ mode: "continuity",
144
+ name: "continuity_pass",
145
+ task: "continue RecallNest work",
146
+ profile: "debug",
147
+ score: 0.94,
148
+ passed: true,
149
+ stableCount: 2,
150
+ patternCount: 1,
151
+ caseCount: 1,
152
+ hasCheckpoint: true,
153
+ matchedStableAny: [],
154
+ matchedStableAll: [],
155
+ matchedPatternsAny: [],
156
+ matchedCasesAny: [],
157
+ matchedCheckpointAny: [],
158
+ forbiddenMatches: [],
159
+ stablePreview: [],
160
+ patternPreview: [],
161
+ casePreview: [],
162
+ checkpointSummary: "ok",
163
+ });
164
+
165
+ expect(passed).toMatchObject({
166
+ workflowId: "resume_context",
167
+ outcome: "success",
168
+ scope: "project:recallnest",
169
+ source: "eval",
170
+ signal: "eval-pass",
171
+ task: "continuity eval: continuity_pass",
172
+ tools: ["resume_context"],
173
+ });
174
+
175
+ const failed = buildContinuityEvalObservationInput({
176
+ name: "continuity_fail",
177
+ expectPatternsAny: ["search_memory"],
178
+ expectCheckpointAny: ["checkpoint"],
179
+ }, {
180
+ mode: "continuity",
181
+ name: "continuity_fail",
182
+ task: "continue",
183
+ profile: "default",
184
+ score: 0.42,
185
+ passed: false,
186
+ stableCount: 0,
187
+ patternCount: 0,
188
+ caseCount: 0,
189
+ hasCheckpoint: false,
190
+ matchedStableAny: [],
191
+ matchedStableAll: [],
192
+ matchedPatternsAny: [],
193
+ matchedCasesAny: [],
194
+ matchedCheckpointAny: [],
195
+ forbiddenMatches: [],
196
+ stablePreview: [],
197
+ patternPreview: [],
198
+ casePreview: [],
199
+ checkpointSummary: "-",
200
+ }, {
201
+ scope: "eval:continuity",
202
+ source: "eval",
203
+ });
204
+
205
+ expect(failed).toMatchObject({
206
+ workflowId: "resume_context",
207
+ outcome: "failure",
208
+ scope: "eval:continuity",
209
+ source: "eval",
210
+ signal: "missing-patterns",
211
+ task: "continuity eval: continuity_fail",
212
+ tools: ["resume_context"],
213
+ });
214
+ expect(failed.summary).toContain("failed");
215
+ });
216
+
217
+ it("creates fresh continuity eval components for each case instead of sharing one resolver", async () => {
218
+ let componentCreations = 0;
219
+
220
+ const reports = await runContinuityEval([
221
+ { name: "case-a", task: "continue A" },
222
+ { name: "case-b", task: "continue B" },
223
+ ], {}, {
224
+ createEvalComponents: () => {
225
+ componentCreations += 1;
226
+ const instanceId = componentCreations;
227
+ return {
228
+ retriever: {
229
+ instanceId,
230
+ async retrieve() {
231
+ return [];
232
+ },
233
+ } as never,
234
+ accessTracker: {
235
+ destroy() {},
236
+ } as never,
237
+ };
238
+ },
239
+ composeResumeContextFn: async (deps) => ({
240
+ summary: `instance:${(deps.retriever as { instanceId: number }).instanceId}`,
241
+ stableContext: [`instance:${(deps.retriever as { instanceId: number }).instanceId}`],
242
+ relevantPatterns: [],
243
+ recentCases: [],
244
+ generatedAt: "2026-03-20T00:00:00.000Z",
245
+ }),
246
+ });
247
+
248
+ expect(componentCreations).toBe(2);
249
+ expect(reports[0]?.stablePreview[0]).toContain("instance:1");
250
+ expect(reports[1]?.stablePreview[0]).toContain("instance:2");
251
+ });
252
+
253
+ it("runs retrieval eval in auto-recall mode so eval does not reinforce access counts", async () => {
254
+ const seenSources: string[] = [];
255
+
256
+ const reports = await runRetrievalEval([
257
+ { name: "retrieval_case", query: "RecallNest" },
258
+ ], {
259
+ createEvalComponents: () => ({
260
+ retriever: {
261
+ async retrieve(context) {
262
+ seenSources.push(context.source || "unset");
263
+ return [];
264
+ },
265
+ } as never,
266
+ accessTracker: {
267
+ destroy() {},
268
+ } as never,
269
+ }),
270
+ });
271
+
272
+ expect(seenSources).toEqual(["auto-recall"]);
273
+ expect(reports).toHaveLength(1);
274
+ });
275
+ });
@@ -0,0 +1,97 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import { PromoteMemoryInputSchema, StoreMemoryInputSchema } from "../memory-schema.js";
4
+ import { ResumeContextRequestSchema, ResumeContextResponseSchema, SessionCheckpointInputSchema } from "../session-schema.js";
5
+
6
+ describe("StoreMemoryInputSchema", () => {
7
+ it("normalizes whitespace, defaults, and deduplicates tags", () => {
8
+ const parsed = StoreMemoryInputSchema.parse({
9
+ text: " User prefers dark mode ",
10
+ category: "preferences",
11
+ scope: "project:test",
12
+ tags: [" ui ", "UI", "frontend"],
13
+ canonicalKey: " user.reply.style ",
14
+ });
15
+
16
+ expect(parsed.text).toBe("User prefers dark mode");
17
+ expect(parsed.importance).toBe(0.7);
18
+ expect(parsed.source).toBe("manual");
19
+ expect(parsed.tags).toEqual(["ui", "frontend"]);
20
+ expect(parsed.canonicalKey).toBe("user.reply.style");
21
+ });
22
+
23
+ it("rejects unsupported categories", () => {
24
+ expect(() => StoreMemoryInputSchema.parse({
25
+ text: "Persist this",
26
+ category: "decision",
27
+ })).toThrow();
28
+ });
29
+ });
30
+
31
+ describe("PromoteMemoryInputSchema", () => {
32
+ it("applies defaults for evidence promotion", () => {
33
+ const parsed = PromoteMemoryInputSchema.parse({
34
+ memoryId: "12345678-1234-1234-1234-123456789abc",
35
+ scope: "project:test",
36
+ });
37
+
38
+ expect(parsed.importance).toBe(0.78);
39
+ expect(parsed.source).toBe("agent");
40
+ expect(parsed.tags).toEqual([]);
41
+ });
42
+ });
43
+
44
+ describe("SessionCheckpointInputSchema", () => {
45
+ it("defaults updatedAt and deduplicates list fields", () => {
46
+ const parsed = SessionCheckpointInputSchema.parse({
47
+ sessionId: "session-123",
48
+ summary: " Working on continuity layer ",
49
+ decisions: ["Use session checkpoints", "use session checkpoints"],
50
+ nextActions: ["Add MCP store_memory", " Add MCP store_memory "],
51
+ });
52
+
53
+ expect(parsed.summary).toBe("Working on continuity layer");
54
+ expect(parsed.decisions).toEqual(["Use session checkpoints"]);
55
+ expect(parsed.nextActions).toEqual(["Add MCP store_memory"]);
56
+ expect(parsed.updatedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
57
+ });
58
+ });
59
+
60
+ describe("ResumeContext schemas", () => {
61
+ it("applies defaults for request parsing", () => {
62
+ const parsed = ResumeContextRequestSchema.parse({});
63
+
64
+ expect(parsed.limitPerSection).toBe(3);
65
+ expect(parsed.includeLatestCheckpoint).toBe(true);
66
+ expect(parsed.profile).toBeUndefined();
67
+ });
68
+
69
+ it("preserves optional retrieval profile on request parsing", () => {
70
+ const parsed = ResumeContextRequestSchema.parse({
71
+ profile: "writing",
72
+ });
73
+
74
+ expect(parsed.profile).toBe("writing");
75
+ });
76
+
77
+ it("accepts a composed response payload", () => {
78
+ const parsed = ResumeContextResponseSchema.parse({
79
+ summary: "Bring forward user identity, recent cases, and the latest checkpoint.",
80
+ resolvedScope: "project:recallnest",
81
+ stableContext: ["User works across Claude Code, Codex, and Gemini CLI"],
82
+ relevantPatterns: ["Always search memory at task start"],
83
+ recentCases: ["Fixed hybrid retrieval tuning last week"],
84
+ latestCheckpoint: {
85
+ sessionId: "session-123",
86
+ resolvedScope: "project:recallnest",
87
+ summary: "Implement schema modules first",
88
+ updatedAt: "2026-03-16T01:41:00.000Z",
89
+ },
90
+ generatedAt: "2026-03-16T01:42:00.000Z",
91
+ });
92
+
93
+ expect(parsed.latestCheckpoint?.sessionId).toBe("session-123");
94
+ expect(parsed.resolvedScope).toBe("project:recallnest");
95
+ expect(parsed.stableContext).toHaveLength(1);
96
+ });
97
+ });
@@ -0,0 +1,235 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import { promoteMemory } from "../capture-engine.js";
4
+ import { createRetriever } from "../retriever.js";
5
+ import { buildRetrievalContext, matchesScopeFilter } from "../scope-policy.js";
6
+
7
+ function cosineSimilarity(a: number[], b: number[]): number {
8
+ let dot = 0;
9
+ let normA = 0;
10
+ let normB = 0;
11
+ for (let i = 0; i < a.length; i += 1) {
12
+ dot += a[i] * b[i];
13
+ normA += a[i] * a[i];
14
+ normB += b[i] * b[i];
15
+ }
16
+ const denom = Math.sqrt(normA) * Math.sqrt(normB);
17
+ return denom === 0 ? 0 : dot / denom;
18
+ }
19
+
20
+ function createCoreRetriever(entries: Array<{
21
+ id: string;
22
+ text: string;
23
+ scope: string;
24
+ category?: "entities" | "events";
25
+ vector: number[];
26
+ }>) {
27
+ return createRetriever({
28
+ hasFtsSupport: false,
29
+ async vectorSearch(queryVector: number[], limit = 5, minScore = 0, scopeFilter?: string[]) {
30
+ return entries
31
+ .filter((entry) => matchesScopeFilter(entry.scope, scopeFilter))
32
+ .map((entry) => ({
33
+ entry: {
34
+ id: entry.id,
35
+ text: entry.text,
36
+ vector: entry.vector,
37
+ category: entry.category || "entities",
38
+ scope: entry.scope,
39
+ importance: 0.8,
40
+ timestamp: Date.parse("2026-03-17T00:00:00.000Z"),
41
+ metadata: "{}",
42
+ },
43
+ score: cosineSimilarity(queryVector, entry.vector),
44
+ }))
45
+ .filter((result) => result.score >= minScore)
46
+ .sort((a, b) => b.score - a.score)
47
+ .slice(0, limit);
48
+ },
49
+ } as any, {
50
+ async embedQuery(query: string) {
51
+ if (/衰减|公式|曲线|weibull/i.test(query)) return [1, 0, 0];
52
+ if (/部署|deploy|region|在哪/i.test(query)) return [0, 1, 0];
53
+ return [0, 0, 1];
54
+ },
55
+ async embedPassage() {
56
+ return [0, 0, 1];
57
+ },
58
+ } as any, {
59
+ mode: "vector",
60
+ rerank: "none",
61
+ filterNoise: false,
62
+ hardMinScore: 0,
63
+ minScore: 0,
64
+ recencyWeight: 0,
65
+ timeDecayHalfLifeDays: 0,
66
+ });
67
+ }
68
+
69
+ function createCaptureDeps() {
70
+ const storedEntries: any[] = [];
71
+ let seq = 1;
72
+
73
+ return {
74
+ storedEntries,
75
+ deps: {
76
+ embedder: {
77
+ async embedPassage(text: string) {
78
+ return [text.length, 1, 0];
79
+ },
80
+ },
81
+ store: {
82
+ async store(entry: any) {
83
+ const stored = {
84
+ ...entry,
85
+ id: `00000000-0000-0000-0000-${String(seq).padStart(12, "0")}`,
86
+ timestamp: 1_700_000_000_000 + seq,
87
+ };
88
+ seq += 1;
89
+ storedEntries.push(stored);
90
+ return stored;
91
+ },
92
+ async list(_scopeFilter?: string[], category?: string, limit = 20, offset = 0) {
93
+ return storedEntries
94
+ .filter((entry) => !category || entry.category === category)
95
+ .slice(offset, offset + limit);
96
+ },
97
+ async update(id: string, updates: any) {
98
+ const index = storedEntries.findIndex((entry) => entry.id === id);
99
+ if (index < 0) return null;
100
+ storedEntries[index] = {
101
+ ...storedEntries[index],
102
+ ...updates,
103
+ timestamp: updates.timestamp ?? storedEntries[index].timestamp,
104
+ };
105
+ return storedEntries[index];
106
+ },
107
+ async get(id: string) {
108
+ return storedEntries.find((entry) => entry.id === id) || null;
109
+ },
110
+ async getById(id: string) {
111
+ return storedEntries.find((entry) => entry.id === id) || null;
112
+ },
113
+ },
114
+ conflictStore: {
115
+ async save(record: any) {
116
+ return record;
117
+ },
118
+ async replace(record: any) {
119
+ return record;
120
+ },
121
+ async getOpenByFingerprint() {
122
+ return null;
123
+ },
124
+ async getLatestByFingerprint() {
125
+ return null;
126
+ },
127
+ },
128
+ },
129
+ };
130
+ }
131
+
132
+ describe("core recall eval", () => {
133
+ it("hits the right memory for a vague associative query within the target scope", async () => {
134
+ const retriever = createCoreRetriever([
135
+ {
136
+ id: "alpha-weibull",
137
+ text: "RecallNest uses Weibull decay with beta=0.8 for the core tier.",
138
+ scope: "project:alpha",
139
+ vector: [1, 0, 0],
140
+ },
141
+ {
142
+ id: "alpha-entity",
143
+ text: "RecallNest exposes checkpoint_session and resume_context.",
144
+ scope: "project:alpha",
145
+ vector: [0, 0, 1],
146
+ },
147
+ {
148
+ id: "beta-deploy",
149
+ text: "Project beta deploys in us-east-1.",
150
+ scope: "project:beta",
151
+ vector: [0, 1, 0],
152
+ },
153
+ ]);
154
+
155
+ const results = await retriever.retrieve(buildRetrievalContext({
156
+ query: "那个衰减曲线用的什么公式来着",
157
+ limit: 5,
158
+ scope: "project:alpha",
159
+ }, {
160
+ operation: "test:associative-recall",
161
+ }));
162
+
163
+ expect(results[0]?.entry.id).toBe("alpha-weibull");
164
+ expect(results.every((result) => result.entry.scope === "project:alpha")).toBe(true);
165
+ });
166
+
167
+ it("does not leak results from another scope when default scope is inferred", async () => {
168
+ const retriever = createCoreRetriever([
169
+ {
170
+ id: "alpha-note",
171
+ text: "Project alpha stores its API key outside the memory index.",
172
+ scope: "project:alpha",
173
+ vector: [0, 0, 1],
174
+ },
175
+ {
176
+ id: "beta-deploy",
177
+ text: "Project beta deploys in us-east-1.",
178
+ scope: "project:beta",
179
+ vector: [0, 1, 0],
180
+ },
181
+ ]);
182
+
183
+ const results = await retriever.retrieve(buildRetrievalContext({
184
+ query: "部署在哪",
185
+ limit: 5,
186
+ }, {
187
+ operation: "test:scope-isolation",
188
+ env: {
189
+ RECALLNEST_DEFAULT_SCOPE: "project:alpha",
190
+ } as NodeJS.ProcessEnv,
191
+ }));
192
+
193
+ expect(results.some((result) => result.entry.id === "beta-deploy")).toBe(false);
194
+ expect(results.every((result) => result.entry.scope === "project:alpha")).toBe(true);
195
+ });
196
+
197
+ it("preserves text and provenance when promoting evidence into durable memory", async () => {
198
+ const { deps, storedEntries } = createCaptureDeps();
199
+ const source = await deps.store.store({
200
+ text: "RecallNest uses Weibull decay with beta=0.8 for the core tier.",
201
+ vector: [1, 0, 0],
202
+ category: "events",
203
+ scope: "cc:session-alpha",
204
+ importance: 0.5,
205
+ metadata: JSON.stringify({
206
+ source: "cc",
207
+ boundary: {
208
+ layer: "evidence",
209
+ authority: "transcript-ingest",
210
+ conflictPolicy: "append-only",
211
+ originalCategory: "entities",
212
+ },
213
+ }),
214
+ });
215
+
216
+ const promoted = await promoteMemory(deps as any, {
217
+ memoryId: source.id,
218
+ category: "entities",
219
+ scope: "project:alpha",
220
+ source: "agent",
221
+ tags: ["core-eval"],
222
+ });
223
+
224
+ expect(promoted.text).toBe("RecallNest uses Weibull decay with beta=0.8 for the core tier.");
225
+ expect(promoted.resolvedScope).toBe("project:alpha");
226
+ expect(storedEntries[1]?.text).toBe("RecallNest uses Weibull decay with beta=0.8 for the core tier.");
227
+ expect(JSON.parse(storedEntries[1]?.metadata || "{}")).toMatchObject({
228
+ promotedFrom: {
229
+ memoryId: source.id,
230
+ scope: "cc:session-alpha",
231
+ category: "events",
232
+ },
233
+ });
234
+ });
235
+ });