recallnest 1.4.1 → 2.2.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 (233) hide show
  1. package/.env +4 -0
  2. package/CLAUDE.md +7 -3
  3. package/README.md +202 -130
  4. package/README_CN.md +263 -190
  5. package/bin/recallnest.mjs +62 -0
  6. package/config.json +55 -0
  7. package/daily-recall.sh +23 -0
  8. package/integrations/setup-all.sh +31 -0
  9. package/logs/daily-recall.error.log +0 -0
  10. package/logs/daily-recall.log +30 -0
  11. package/logs/ingest-2026-04-11.log +110 -0
  12. package/logs/ingest-2026-04-12.log +90 -0
  13. package/logs/launchagent-stderr.log +0 -0
  14. package/logs/launchagent-stdout.log +0 -0
  15. package/package.json +10 -3
  16. package/src/access-tracker.ts +3 -2
  17. package/src/activity-counter.ts +109 -0
  18. package/src/adaptive-retrieval.ts +6 -5
  19. package/src/admission-control.ts +163 -0
  20. package/src/anchor-generator.ts +80 -0
  21. package/src/api-server.ts +10 -0
  22. package/src/audit-log.ts +122 -0
  23. package/src/auto-gc.ts +98 -29
  24. package/src/auto-recall.ts +33 -4
  25. package/src/capture-engine.ts +372 -23
  26. package/src/cascade-forget.ts +3 -2
  27. package/src/cli.ts +107 -5
  28. package/src/compat.ts +22 -0
  29. package/src/confidence-tracker.ts +210 -47
  30. package/src/conflict-store.ts +12 -3
  31. package/src/consolidation-engine.ts +296 -8
  32. package/src/context-collapse-renderer.ts +222 -0
  33. package/src/context-composer-stable-selection.ts +5 -1
  34. package/src/context-composer.ts +239 -4
  35. package/src/context-reconstructor.ts +404 -0
  36. package/src/conversation-importer.ts +441 -0
  37. package/src/data-checkup.ts +232 -0
  38. package/src/decay-engine.ts +84 -0
  39. package/src/distill-lock.ts +122 -0
  40. package/src/doctor.ts +8 -10
  41. package/src/dream-pipeline.ts +227 -0
  42. package/src/emotion-detector.ts +90 -0
  43. package/src/eval.ts +3 -2
  44. package/src/forget-engine.ts +269 -0
  45. package/src/frequency-tracker.ts +175 -0
  46. package/src/graph-export.ts +644 -0
  47. package/src/ingest.ts +36 -6
  48. package/src/interference-detector.ts +187 -0
  49. package/src/kg-extractor.ts +15 -24
  50. package/src/kg-store.ts +2 -1
  51. package/src/language-hook.ts +67 -0
  52. package/src/llm-client.ts +289 -6
  53. package/src/mcp-server.ts +707 -80
  54. package/src/memory-assets.ts +22 -5
  55. package/src/memory-evolution.ts +365 -0
  56. package/src/memory-lint.ts +429 -0
  57. package/src/memory-output.ts +69 -0
  58. package/src/memory-schema.ts +74 -2
  59. package/src/narrative-schema.ts +79 -0
  60. package/src/narrative-tagger.ts +164 -0
  61. package/src/pii-detector.ts +98 -0
  62. package/src/post-retrieval-filter.ts +76 -0
  63. package/src/prediction-engine.ts +253 -0
  64. package/src/preference-slots.ts +65 -2
  65. package/src/prospective-memory.ts +215 -0
  66. package/src/query-expander.ts +67 -0
  67. package/src/recall-governor.ts +183 -0
  68. package/src/retention-policy.ts +90 -0
  69. package/src/retriever.ts +828 -55
  70. package/src/rif.ts +34 -8
  71. package/src/runtime-config.ts +23 -8
  72. package/src/scope-inventory.ts +4 -3
  73. package/src/scope-policy.ts +4 -0
  74. package/src/session-distiller.ts +307 -0
  75. package/src/session-output.ts +40 -0
  76. package/src/session-schema.ts +37 -0
  77. package/src/session-store.ts +7 -2
  78. package/src/skill-engine.ts +208 -0
  79. package/src/skill-promotion.ts +293 -0
  80. package/src/skill-schema.ts +39 -0
  81. package/src/store.ts +96 -10
  82. package/src/topic-tag.ts +66 -0
  83. package/src/tracker.ts +3 -1
  84. package/src/ui-server.ts +80 -8
  85. package/src/workflow-observation-scope-review.ts +2 -1
  86. package/src/workflow-observation-store.ts +2 -1
  87. package/src/write-verifier.ts +126 -0
  88. package/.claude-plugin/CLAUDE.md +0 -29
  89. package/.claude-plugin/marketplace.json +0 -18
  90. package/.github/workflows/ci.yml +0 -28
  91. package/.mcp.json +0 -9
  92. package/CHANGELOG.md +0 -51
  93. package/DEMO.md +0 -94
  94. package/EVAL.md +0 -89
  95. package/FAILURES.md +0 -75
  96. package/OPERATIONS.md +0 -59
  97. package/ROADMAP.md +0 -198
  98. package/assets/recallnest-workbench.png +0 -0
  99. package/assets/ui/app.js +0 -807
  100. package/assets/ui/index.html +0 -154
  101. package/assets/ui/styles.css +0 -605
  102. package/assets/wechat-qr.jpg +0 -0
  103. package/daily-reflections/2026-03-05.md +0 -15
  104. package/daily-reflections/2026-03-06.md +0 -15
  105. package/daily-reflections/2026-03-07.md +0 -7
  106. package/daily-reflections/2026-03-08.md +0 -34
  107. package/daily-reflections/2026-03-09.md +0 -35
  108. package/daily-reflections/2026-03-10.md +0 -36
  109. package/daily-reflections/2026-03-11.md +0 -35
  110. package/daily-reflections/2026-03-12.md +0 -36
  111. package/daily-reflections/2026-03-13.md +0 -35
  112. package/daily-reflections/2026-03-14.md +0 -35
  113. package/daily-reflections/2026-03-15.md +0 -35
  114. package/daily-reflections/2026-03-16.md +0 -41
  115. package/daily-reflections/2026-03-17.md +0 -10
  116. package/daily-reflections/2026-03-18.md +0 -10
  117. package/daily-reflections/2026-03-19.md +0 -10
  118. package/daily-reflections/2026-03-20.md +0 -10
  119. package/daily-reflections/2026-03-21.md +0 -10
  120. package/daily-reflections/2026-03-22.md +0 -10
  121. package/daily-reflections/2026-03-23.md +0 -10
  122. package/daily-reflections/2026-03-24.md +0 -10
  123. package/daily-reflections/2026-03-25.md +0 -32
  124. package/daily-reflections/2026-03-26.md +0 -37
  125. package/daily-reflections/2026-03-27.md +0 -35
  126. package/daily-reflections/2026-03-28.md +0 -35
  127. package/daily-reflections/2026-03-29.md +0 -35
  128. package/daily-reflections/2026-03-30.md +0 -36
  129. package/daily-reflections/2026-03-31.md +0 -35
  130. package/daily-reflections/2026-04-01.md +0 -35
  131. package/docs/api-reference.md +0 -1291
  132. package/docs/architecture.md +0 -168
  133. package/docs/memory-boundary-contract.md +0 -226
  134. package/docs/memory-categories.md +0 -119
  135. package/docs/pipeline-audit-ultramemory.md +0 -177
  136. package/docs/plans/2026-03-08-query-expansion.md +0 -270
  137. package/docs/plans/2026-03-16-continuity-layer.md +0 -196
  138. package/docs/plans/mcp-tiering-plan.md +0 -126
  139. package/docs/research/recall-quality-audit-2026-03-22.md +0 -153
  140. package/docs/self-evolution.md +0 -198
  141. package/docs/superpowers/plans/2026-03-19-ingest-pipeline-upgrade.md +0 -782
  142. package/docs/superpowers/specs/2026-03-19-ingest-pipeline-upgrade-design.md +0 -77
  143. package/docs/superpowers/specs/2026-03-23-pull-claude-desktop-design.md +0 -95
  144. package/eval/continuity/results-2026-03-16.md +0 -117
  145. package/eval/continuity/results-2026-03-19.md +0 -453
  146. package/eval/continuity/runbook.md +0 -110
  147. package/eval/continuity/seed-cases.md +0 -54
  148. package/eval/reports/2026-03-06-abstract-query-baseline.md +0 -96
  149. package/eval/reports/2026-03-06-aws-ssh-baseline.md +0 -82
  150. package/eval/reports/2026-03-06-baseline.md +0 -82
  151. package/eval/reports/query-expansion.md +0 -138
  152. package/lm +0 -19
  153. package/plan-v1.2-distributable.md +0 -105
  154. package/scripts/archive-distilled-junk.ts +0 -116
  155. package/scripts/backfill-l0l1l2.ts +0 -98
  156. package/scripts/blind-scan.ts +0 -588
  157. package/scripts/cleanup-step1-exact-dups.ts +0 -117
  158. package/scripts/cleanup-step2-template-dups.ts +0 -113
  159. package/scripts/cleanup-step3-stale-content.ts +0 -149
  160. package/scripts/cleanup-step4-orphan-scopes.ts +0 -131
  161. package/scripts/delete-distilled-junk.ts +0 -88
  162. package/scripts/distill-facts.ts +0 -305
  163. package/scripts/health-check.ts +0 -343
  164. package/scripts/incremental-ingest.sh +0 -71
  165. package/scripts/mlp-health-check.ts +0 -382
  166. package/scripts/pull-claude-desktop.ts +0 -515
  167. package/scripts/re-ingest-cc.sh +0 -66
  168. package/scripts/rebalance-memory-health.ts +0 -181
  169. package/scripts/run-desktop-ingest.sh +0 -11
  170. package/scripts/start-server.sh +0 -12
  171. package/scripts/viz-dashboard.html +0 -423
  172. package/scripts/viz-export.ts +0 -703
  173. package/src/__tests__/access-tracker-novelty.test.ts +0 -228
  174. package/src/__tests__/auto-consolidation.test.ts +0 -168
  175. package/src/__tests__/auto-recall.test.ts +0 -131
  176. package/src/__tests__/batch-dedup.test.ts +0 -65
  177. package/src/__tests__/capture-engine.test.ts +0 -1142
  178. package/src/__tests__/capture-heuristic.test.ts +0 -171
  179. package/src/__tests__/cascade-forget.test.ts +0 -210
  180. package/src/__tests__/category-min-scores.test.ts +0 -33
  181. package/src/__tests__/confidence-tracker.test.ts +0 -196
  182. package/src/__tests__/conflict-advisor.test.ts +0 -206
  183. package/src/__tests__/conflict-escalation.test.ts +0 -149
  184. package/src/__tests__/conflict-lifecycle.test.ts +0 -83
  185. package/src/__tests__/conflict-output.test.ts +0 -85
  186. package/src/__tests__/conflict-store.test.ts +0 -374
  187. package/src/__tests__/consolidation-engine.test.ts +0 -181
  188. package/src/__tests__/context-composer-pins.test.ts +0 -64
  189. package/src/__tests__/context-composer-task-selection.test.ts +0 -24
  190. package/src/__tests__/context-renderer.test.ts +0 -91
  191. package/src/__tests__/continuity-eval.test.ts +0 -275
  192. package/src/__tests__/continuity-schema.test.ts +0 -97
  193. package/src/__tests__/core-recall-eval.test.ts +0 -235
  194. package/src/__tests__/core-summary.test.ts +0 -109
  195. package/src/__tests__/dedup-actions.test.ts +0 -58
  196. package/src/__tests__/deterministic-id.test.ts +0 -39
  197. package/src/__tests__/doctor.test.ts +0 -303
  198. package/src/__tests__/drill-down.test.ts +0 -108
  199. package/src/__tests__/embedder.test.ts +0 -122
  200. package/src/__tests__/entity-resolver.test.ts +0 -58
  201. package/src/__tests__/event-segmenter.test.ts +0 -153
  202. package/src/__tests__/hotness-blend.test.ts +0 -76
  203. package/src/__tests__/ingest.test.ts +0 -360
  204. package/src/__tests__/kg-extractor.test.ts +0 -184
  205. package/src/__tests__/kg-store.test.ts +0 -198
  206. package/src/__tests__/llm-consolidation.test.ts +0 -226
  207. package/src/__tests__/memory-boundaries.test.ts +0 -237
  208. package/src/__tests__/memory-health-rebalance.test.ts +0 -144
  209. package/src/__tests__/memory-output.test.ts +0 -215
  210. package/src/__tests__/multi-vector.test.ts +0 -242
  211. package/src/__tests__/ppr-traversal.test.ts +0 -256
  212. package/src/__tests__/preference-guard-smoke.test.ts +0 -211
  213. package/src/__tests__/preference-matcher.test.ts +0 -230
  214. package/src/__tests__/preference-slots.test.ts +0 -106
  215. package/src/__tests__/prospective-memory.test.ts +0 -283
  216. package/src/__tests__/query-entity-detector.test.ts +0 -171
  217. package/src/__tests__/query-expander.test.ts +0 -34
  218. package/src/__tests__/recall-mode.test.ts +0 -64
  219. package/src/__tests__/result-synthesizer.test.ts +0 -198
  220. package/src/__tests__/resume-context.test.ts +0 -4743
  221. package/src/__tests__/retrieval-trace.test.ts +0 -213
  222. package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
  223. package/src/__tests__/retroactive-boost.test.ts +0 -223
  224. package/src/__tests__/scope-inventory.test.ts +0 -200
  225. package/src/__tests__/scope-policy.test.ts +0 -69
  226. package/src/__tests__/session-checkpoint.test.ts +0 -259
  227. package/src/__tests__/session-gc.test.ts +0 -215
  228. package/src/__tests__/store-scope-audit.test.ts +0 -81
  229. package/src/__tests__/temporal-parser.test.ts +0 -241
  230. package/src/__tests__/term-registry.test.ts +0 -121
  231. package/src/__tests__/tool-output-compressor.test.ts +0 -133
  232. package/src/__tests__/version-manager.test.ts +0 -213
  233. package/src/__tests__/workflow-observation.test.ts +0 -400
@@ -1,91 +0,0 @@
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
- });
@@ -1,275 +0,0 @@
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
- });
@@ -1,97 +0,0 @@
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
- });
@@ -1,235 +0,0 @@
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
- });