recallnest 2.2.0 → 2.3.0

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 (249) hide show
  1. package/.env +4 -0
  2. package/CLAUDE.md +1 -1
  3. package/README.md +30 -5
  4. package/README_CN.md +30 -5
  5. package/config.json +55 -0
  6. package/connectors/examples/email-adapter.ts +73 -0
  7. package/connectors/examples/logs-adapter.ts +103 -0
  8. package/connectors/examples/rss-adapter.ts +95 -0
  9. package/logs/daily-recall.error.log +0 -0
  10. package/logs/daily-recall.log +60 -0
  11. package/logs/ingest-2026-04-11.log +110 -0
  12. package/logs/ingest-2026-04-12.log +90 -0
  13. package/logs/ingest-2026-04-13.log +87 -0
  14. package/logs/launchagent-stderr.log +0 -0
  15. package/logs/launchagent-stdout.log +0 -0
  16. package/package.json +1 -1
  17. package/src/cli.ts +30 -0
  18. package/src/connector-types.ts +57 -0
  19. package/src/conversation-importer.ts +25 -1
  20. package/src/data-checkup.ts +31 -1
  21. package/src/doctor.ts +29 -0
  22. package/src/ingest.ts +203 -0
  23. package/src/mcp-server.ts +2 -2
  24. package/src/obsidian-connector.ts +282 -0
  25. package/src/session-schema.ts +2 -2
  26. package/src/source-heartbeat.ts +108 -0
  27. package/.claude-plugin/CLAUDE.md +0 -29
  28. package/.claude-plugin/marketplace.json +0 -18
  29. package/.dockerignore +0 -11
  30. package/.github/workflows/ci.yml +0 -28
  31. package/.mcp.json +0 -9
  32. package/CHANGELOG.md +0 -51
  33. package/DEMO.md +0 -94
  34. package/Dockerfile +0 -20
  35. package/EVAL.md +0 -89
  36. package/FAILURES.md +0 -75
  37. package/OPERATIONS.md +0 -59
  38. package/ROADMAP.md +0 -245
  39. package/SKILL.md +0 -250
  40. package/assets/dashboard.png +0 -0
  41. package/assets/knowledge-graph.png +0 -0
  42. package/assets/recallnest-workbench.png +0 -0
  43. package/assets/screenshots/ui-full.png +0 -0
  44. package/assets/screenshots/ui-overview.png +0 -0
  45. package/assets/screenshots/ui-search.png +0 -0
  46. package/assets/ui/app.js +0 -1031
  47. package/assets/ui/index.html +0 -224
  48. package/assets/ui/styles.css +0 -781
  49. package/assets/wechat-qr.jpg +0 -0
  50. package/bun.lock +0 -337
  51. package/daily-reflections/2026-03-05.md +0 -15
  52. package/daily-reflections/2026-03-06.md +0 -15
  53. package/daily-reflections/2026-03-07.md +0 -7
  54. package/daily-reflections/2026-03-08.md +0 -34
  55. package/daily-reflections/2026-03-09.md +0 -35
  56. package/daily-reflections/2026-03-10.md +0 -36
  57. package/daily-reflections/2026-03-11.md +0 -35
  58. package/daily-reflections/2026-03-12.md +0 -36
  59. package/daily-reflections/2026-03-13.md +0 -35
  60. package/daily-reflections/2026-03-14.md +0 -35
  61. package/daily-reflections/2026-03-15.md +0 -35
  62. package/daily-reflections/2026-03-16.md +0 -41
  63. package/daily-reflections/2026-03-17.md +0 -10
  64. package/daily-reflections/2026-03-18.md +0 -10
  65. package/daily-reflections/2026-03-19.md +0 -10
  66. package/daily-reflections/2026-03-20.md +0 -10
  67. package/daily-reflections/2026-03-21.md +0 -10
  68. package/daily-reflections/2026-03-22.md +0 -10
  69. package/daily-reflections/2026-03-23.md +0 -10
  70. package/daily-reflections/2026-03-24.md +0 -10
  71. package/daily-reflections/2026-03-25.md +0 -32
  72. package/daily-reflections/2026-03-26.md +0 -37
  73. package/daily-reflections/2026-03-27.md +0 -35
  74. package/daily-reflections/2026-03-28.md +0 -35
  75. package/daily-reflections/2026-03-29.md +0 -35
  76. package/daily-reflections/2026-03-30.md +0 -36
  77. package/daily-reflections/2026-03-31.md +0 -35
  78. package/daily-reflections/2026-04-01.md +0 -35
  79. package/daily-reflections/2026-04-02.md +0 -35
  80. package/daily-reflections/2026-04-03.md +0 -37
  81. package/daily-reflections/2026-04-04.md +0 -37
  82. package/daily-reflections/2026-04-05.md +0 -35
  83. package/daily-reflections/2026-04-06.md +0 -36
  84. package/daily-reflections/2026-04-07.md +0 -35
  85. package/daily-reflections/2026-04-08.md +0 -35
  86. package/daily-reflections/2026-04-12.md +0 -35
  87. package/data/alias-map.example.json +0 -22
  88. package/docs/api-reference.md +0 -1291
  89. package/docs/architecture.md +0 -168
  90. package/docs/memory-boundary-contract.md +0 -226
  91. package/docs/memory-categories.md +0 -119
  92. package/docs/pipeline-audit-ultramemory.md +0 -177
  93. package/docs/plans/2026-03-08-query-expansion.md +0 -270
  94. package/docs/plans/2026-03-16-continuity-layer.md +0 -196
  95. package/docs/plans/2026-04-01-recall-boost.md +0 -100
  96. package/docs/plans/mcp-tiering-plan.md +0 -126
  97. package/docs/research/recall-quality-audit-2026-03-22.md +0 -153
  98. package/docs/self-evolution.md +0 -198
  99. package/docs/superpowers/plans/2026-03-19-ingest-pipeline-upgrade.md +0 -782
  100. package/docs/superpowers/plans/2026-04-11-constructive-retrieval-emotion.md +0 -1195
  101. package/docs/superpowers/specs/2026-03-19-ingest-pipeline-upgrade-design.md +0 -77
  102. package/docs/superpowers/specs/2026-03-23-pull-claude-desktop-design.md +0 -95
  103. package/docs/superpowers/specs/2026-04-11-constructive-retrieval-emotion-design.md +0 -398
  104. package/eval/continuity/results-2026-03-16.md +0 -117
  105. package/eval/continuity/results-2026-03-19.md +0 -453
  106. package/eval/continuity/runbook.md +0 -110
  107. package/eval/continuity/seed-cases.md +0 -54
  108. package/eval/reports/2026-03-06-abstract-query-baseline.md +0 -96
  109. package/eval/reports/2026-03-06-aws-ssh-baseline.md +0 -82
  110. package/eval/reports/2026-03-06-baseline.md +0 -82
  111. package/eval/reports/query-expansion.md +0 -138
  112. package/glama.json +0 -6
  113. package/lm +0 -19
  114. package/plan-philosophy-upgrades.md +0 -363
  115. package/plan-product-upgrades.md +0 -155
  116. package/plan-v1.2-distributable.md +0 -105
  117. package/plan.md +0 -140
  118. package/research-memory-evolution.md +0 -440
  119. package/research-rl-agent-memory.md +0 -330
  120. package/scripts/archive-distilled-junk.ts +0 -116
  121. package/scripts/backfill-anchors.ts +0 -130
  122. package/scripts/backfill-l0l1l2.ts +0 -98
  123. package/scripts/blind-scan.ts +0 -588
  124. package/scripts/cleanup-step1-exact-dups.ts +0 -117
  125. package/scripts/cleanup-step2-template-dups.ts +0 -113
  126. package/scripts/cleanup-step3-stale-content.ts +0 -149
  127. package/scripts/cleanup-step4-orphan-scopes.ts +0 -131
  128. package/scripts/delete-distilled-junk.ts +0 -88
  129. package/scripts/diagnose-vector-search.ts +0 -132
  130. package/scripts/distill-facts.ts +0 -305
  131. package/scripts/health-check.ts +0 -343
  132. package/scripts/incremental-ingest.sh +0 -71
  133. package/scripts/migrate-language.ts +0 -75
  134. package/scripts/mlp-health-check.ts +0 -382
  135. package/scripts/pull-claude-desktop.ts +0 -515
  136. package/scripts/re-ingest-cc.sh +0 -66
  137. package/scripts/rebalance-memory-health.ts +0 -181
  138. package/scripts/run-desktop-ingest.sh +0 -11
  139. package/scripts/start-server.sh +0 -12
  140. package/scripts/verify-emotion-decay.ts +0 -148
  141. package/scripts/viz-dashboard.html +0 -423
  142. package/scripts/viz-export.ts +0 -703
  143. package/src/__tests__/access-tracker-novelty.test.ts +0 -228
  144. package/src/__tests__/activity-counter.test.ts +0 -96
  145. package/src/__tests__/admission-control.test.ts +0 -206
  146. package/src/__tests__/anchor-generator.test.ts +0 -67
  147. package/src/__tests__/auto-consolidation.test.ts +0 -168
  148. package/src/__tests__/auto-recall.test.ts +0 -131
  149. package/src/__tests__/babel-integration.test.ts +0 -139
  150. package/src/__tests__/batch-dedup.test.ts +0 -65
  151. package/src/__tests__/capture-engine.test.ts +0 -1144
  152. package/src/__tests__/capture-heuristic.test.ts +0 -171
  153. package/src/__tests__/cascade-forget.test.ts +0 -210
  154. package/src/__tests__/category-min-scores.test.ts +0 -33
  155. package/src/__tests__/cc8-cc1-essential-context.test.ts +0 -298
  156. package/src/__tests__/circuit-breaker.test.ts +0 -99
  157. package/src/__tests__/cluster-consolidation.test.ts +0 -712
  158. package/src/__tests__/confidence-metadata.test.ts +0 -125
  159. package/src/__tests__/confidence-tracker.test.ts +0 -249
  160. package/src/__tests__/conflict-advisor.test.ts +0 -206
  161. package/src/__tests__/conflict-escalation.test.ts +0 -149
  162. package/src/__tests__/conflict-lifecycle.test.ts +0 -83
  163. package/src/__tests__/conflict-output.test.ts +0 -85
  164. package/src/__tests__/conflict-store.test.ts +0 -374
  165. package/src/__tests__/consolidation-engine.test.ts +0 -181
  166. package/src/__tests__/constructive-retrieval.test.ts +0 -509
  167. package/src/__tests__/context-collapse-renderer.test.ts +0 -214
  168. package/src/__tests__/context-composer-pins.test.ts +0 -64
  169. package/src/__tests__/context-composer-task-selection.test.ts +0 -24
  170. package/src/__tests__/context-reconstructor.test.ts +0 -65
  171. package/src/__tests__/context-renderer.test.ts +0 -91
  172. package/src/__tests__/continuity-eval.test.ts +0 -275
  173. package/src/__tests__/continuity-schema.test.ts +0 -97
  174. package/src/__tests__/conversation-importer.test.ts +0 -692
  175. package/src/__tests__/core-recall-eval.test.ts +0 -235
  176. package/src/__tests__/core-summary.test.ts +0 -109
  177. package/src/__tests__/data-checkup.test.ts +0 -225
  178. package/src/__tests__/decay-exemption.test.ts +0 -84
  179. package/src/__tests__/dedup-actions.test.ts +0 -58
  180. package/src/__tests__/dedup-guard.test.ts +0 -39
  181. package/src/__tests__/deterministic-id.test.ts +0 -39
  182. package/src/__tests__/distill-lock.test.ts +0 -176
  183. package/src/__tests__/doctor.test.ts +0 -303
  184. package/src/__tests__/dream-pipeline.test.ts +0 -232
  185. package/src/__tests__/drill-down.test.ts +0 -108
  186. package/src/__tests__/embedder.test.ts +0 -122
  187. package/src/__tests__/emotion-decay.test.ts +0 -46
  188. package/src/__tests__/emotion-detector.test.ts +0 -56
  189. package/src/__tests__/emotion-phase1-integration.test.ts +0 -153
  190. package/src/__tests__/emotion-retrieval.test.ts +0 -56
  191. package/src/__tests__/entity-resolver.test.ts +0 -58
  192. package/src/__tests__/ethics-layer.test.ts +0 -476
  193. package/src/__tests__/event-segmenter.test.ts +0 -153
  194. package/src/__tests__/feature-flags-integration.test.ts +0 -54
  195. package/src/__tests__/frequency-tracker.test.ts +0 -113
  196. package/src/__tests__/graph-export.test.ts +0 -489
  197. package/src/__tests__/hotness-blend.test.ts +0 -76
  198. package/src/__tests__/ingest.test.ts +0 -360
  199. package/src/__tests__/interference-detector.test.ts +0 -203
  200. package/src/__tests__/kg-extractor.test.ts +0 -184
  201. package/src/__tests__/kg-store.test.ts +0 -198
  202. package/src/__tests__/llm-consolidation.test.ts +0 -226
  203. package/src/__tests__/mcp-efficiency.test.ts +0 -288
  204. package/src/__tests__/memory-boundaries.test.ts +0 -237
  205. package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +0 -243
  206. package/src/__tests__/memory-evolution.test.ts +0 -271
  207. package/src/__tests__/memory-health-rebalance.test.ts +0 -144
  208. package/src/__tests__/memory-lint.test.ts +0 -271
  209. package/src/__tests__/memory-output.test.ts +0 -215
  210. package/src/__tests__/multi-vector.test.ts +0 -242
  211. package/src/__tests__/narrative-architecture.test.ts +0 -456
  212. package/src/__tests__/pending-review.test.ts +0 -77
  213. package/src/__tests__/post-retrieval-filter.test.ts +0 -178
  214. package/src/__tests__/ppr-traversal.test.ts +0 -256
  215. package/src/__tests__/prediction-engine.test.ts +0 -349
  216. package/src/__tests__/predictive-prospective-memory.test.ts +0 -416
  217. package/src/__tests__/preference-guard-smoke.test.ts +0 -211
  218. package/src/__tests__/preference-matcher.test.ts +0 -230
  219. package/src/__tests__/preference-slots.test.ts +0 -205
  220. package/src/__tests__/prospective-memory.test.ts +0 -283
  221. package/src/__tests__/query-entity-detector.test.ts +0 -171
  222. package/src/__tests__/query-expander-alias.test.ts +0 -89
  223. package/src/__tests__/query-expander.test.ts +0 -34
  224. package/src/__tests__/recall-governor.test.ts +0 -227
  225. package/src/__tests__/recall-mode.test.ts +0 -64
  226. package/src/__tests__/result-synthesizer.test.ts +0 -198
  227. package/src/__tests__/resume-context.test.ts +0 -4898
  228. package/src/__tests__/retrieval-trace.test.ts +0 -213
  229. package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
  230. package/src/__tests__/retroactive-boost.test.ts +0 -223
  231. package/src/__tests__/salience-scoring.test.ts +0 -106
  232. package/src/__tests__/scope-inventory.test.ts +0 -200
  233. package/src/__tests__/scope-policy.test.ts +0 -69
  234. package/src/__tests__/session-checkpoint.test.ts +0 -259
  235. package/src/__tests__/session-distiller.test.ts +0 -611
  236. package/src/__tests__/session-gc.test.ts +0 -215
  237. package/src/__tests__/skill-engine.test.ts +0 -546
  238. package/src/__tests__/skill-promotion.test.ts +0 -349
  239. package/src/__tests__/store-scope-audit.test.ts +0 -81
  240. package/src/__tests__/supersede-chain.test.ts +0 -154
  241. package/src/__tests__/temporal-parser.test.ts +0 -241
  242. package/src/__tests__/temporal-validity.test.ts +0 -160
  243. package/src/__tests__/term-registry.test.ts +0 -121
  244. package/src/__tests__/tool-output-compressor.test.ts +0 -133
  245. package/src/__tests__/topic-tag.test.ts +0 -113
  246. package/src/__tests__/trusted-memory.test.ts +0 -828
  247. package/src/__tests__/version-manager.test.ts +0 -213
  248. package/src/__tests__/workflow-observation.test.ts +0 -400
  249. package/src/__tests__/write-verifier.test.ts +0 -122
@@ -1,243 +0,0 @@
1
- /**
2
- * Tests for Memory Evolution Phase B-2 (Archive Strategy),
3
- * B-3 (LLM Importance Assessment), and E-1 (Multi-factor Retrieval Scoring).
4
- */
5
- import { describe, expect, test } from "bun:test";
6
- import {
7
- parseEvolution,
8
- computeDecayScore,
9
- buildArchivedMetadata,
10
- isActiveMemory,
11
- patchEvolution,
12
- type EvolutionMetadata,
13
- } from "../memory-evolution.js";
14
- import {
15
- maybeRunGc,
16
- resetGcTimestamp,
17
- DEFAULT_AUTO_GC_CONFIG,
18
- type AutoGcConfig,
19
- } from "../auto-gc.js";
20
-
21
- // ---------------------------------------------------------------------------
22
- // B-2: Archive Strategy Tests
23
- // ---------------------------------------------------------------------------
24
-
25
- describe("B-2: Archive Strategy", () => {
26
- test("buildArchivedMetadata sets status to archived", () => {
27
- const meta = JSON.stringify({ evolution: { status: "active", version: 1 } });
28
- const archived = buildArchivedMetadata(meta);
29
- const evo = parseEvolution(archived);
30
- expect(evo.status).toBe("archived");
31
- });
32
-
33
- test("archived memory is not active", () => {
34
- const meta = JSON.stringify({ evolution: { status: "archived", version: 1 } });
35
- expect(isActiveMemory(meta)).toBe(false);
36
- });
37
-
38
- test("active memory is active", () => {
39
- const meta = JSON.stringify({ evolution: { status: "active", version: 1 } });
40
- expect(isActiveMemory(meta)).toBe(true);
41
- });
42
-
43
- describe("auto-gc with evolution system", () => {
44
- function makeStore(entries: Array<{
45
- id: string;
46
- importance: number;
47
- timestamp: number;
48
- metadata: string;
49
- }>) {
50
- const data = new Map(entries.map(e => [e.id, {
51
- ...e,
52
- text: "test",
53
- vector: [1, 0, 0],
54
- category: "events",
55
- scope: "project:test",
56
- }]));
57
- const updates: Array<{ id: string; metadata: string }> = [];
58
- return {
59
- store: {
60
- stats: async () => ({ total: data.size }),
61
- list: async () => Array.from(data.values()),
62
- update: async (id: string, patch: { metadata: string }) => {
63
- updates.push({ id, metadata: patch.metadata });
64
- const entry = data.get(id);
65
- if (!entry) return null;
66
- entry.metadata = patch.metadata;
67
- return entry;
68
- },
69
- },
70
- updates,
71
- };
72
- }
73
-
74
- test("archives low-decay-score memories", async () => {
75
- resetGcTimestamp();
76
- const now = Date.now();
77
- const oldTimestamp = now - 120 * 86_400_000; // 120 days ago
78
- const activeMeta = JSON.stringify({
79
- evolution: {
80
- status: "active",
81
- version: 1,
82
- accessCount: 0,
83
- lastAccessedAt: null,
84
- validFrom: oldTimestamp,
85
- validUntil: null,
86
- },
87
- });
88
-
89
- const { store, updates } = makeStore([
90
- { id: "old-low", importance: 0.1, timestamp: oldTimestamp, metadata: activeMeta },
91
- ]);
92
-
93
- const config: AutoGcConfig = {
94
- ...DEFAULT_AUTO_GC_CONFIG,
95
- minMemoryCount: 1,
96
- minHoursSinceLastGc: 0,
97
- decayScoreThreshold: 0.2,
98
- minAgeDays: 30,
99
- };
100
-
101
- const result = await maybeRunGc(store as any, config);
102
- expect(result.triggered).toBe(true);
103
- expect(result.archivedCount).toBe(1);
104
- expect(updates.length).toBe(1);
105
-
106
- const archivedEvo = parseEvolution(updates[0].metadata);
107
- expect(archivedEvo.status).toBe("archived");
108
- });
109
-
110
- test("skips pinned memories (importance >= 0.95)", async () => {
111
- resetGcTimestamp();
112
- const now = Date.now();
113
- const oldTimestamp = now - 120 * 86_400_000;
114
- const activeMeta = JSON.stringify({
115
- evolution: {
116
- status: "active",
117
- version: 1,
118
- accessCount: 0,
119
- lastAccessedAt: null,
120
- validFrom: oldTimestamp,
121
- validUntil: null,
122
- },
123
- });
124
-
125
- const { store, updates } = makeStore([
126
- { id: "pinned", importance: 0.95, timestamp: oldTimestamp, metadata: activeMeta },
127
- ]);
128
-
129
- const config: AutoGcConfig = {
130
- ...DEFAULT_AUTO_GC_CONFIG,
131
- minMemoryCount: 1,
132
- minHoursSinceLastGc: 0,
133
- };
134
-
135
- const result = await maybeRunGc(store as any, config);
136
- expect(result.triggered).toBe(true);
137
- expect(result.archivedCount).toBe(0);
138
- expect(updates.length).toBe(0);
139
- });
140
-
141
- test("skips recently created memories", async () => {
142
- resetGcTimestamp();
143
- const recentMeta = JSON.stringify({
144
- evolution: {
145
- status: "active",
146
- version: 1,
147
- accessCount: 0,
148
- lastAccessedAt: null,
149
- validFrom: Date.now(),
150
- validUntil: null,
151
- },
152
- });
153
-
154
- const { store, updates } = makeStore([
155
- { id: "recent", importance: 0.1, timestamp: Date.now(), metadata: recentMeta },
156
- ]);
157
-
158
- const config: AutoGcConfig = {
159
- ...DEFAULT_AUTO_GC_CONFIG,
160
- minMemoryCount: 1,
161
- minHoursSinceLastGc: 0,
162
- minAgeDays: 30,
163
- };
164
-
165
- const result = await maybeRunGc(store as any, config);
166
- expect(result.triggered).toBe(true);
167
- expect(result.archivedCount).toBe(0);
168
- });
169
-
170
- test("does not trigger when below memory threshold", async () => {
171
- resetGcTimestamp();
172
- const { store } = makeStore([
173
- { id: "one", importance: 0.1, timestamp: Date.now() - 90 * 86_400_000, metadata: "{}" },
174
- ]);
175
-
176
- const result = await maybeRunGc(store as any, {
177
- ...DEFAULT_AUTO_GC_CONFIG,
178
- minMemoryCount: 1000,
179
- });
180
- expect(result.triggered).toBe(false);
181
- expect(result.reason).toBe("below_memory_threshold");
182
- });
183
- });
184
- });
185
-
186
- // ---------------------------------------------------------------------------
187
- // E-1: Access Count Boost Tests (via computeDecayScore)
188
- // ---------------------------------------------------------------------------
189
-
190
- describe("E-1: Multi-factor Retrieval Scoring", () => {
191
- test("higher accessCount produces higher decay score", () => {
192
- const base: EvolutionMetadata = {
193
- status: "active",
194
- version: 1,
195
- accessCount: 0,
196
- lastAccessedAt: null,
197
- supersededBy: null,
198
- consolidatedInto: null,
199
- sourceMemories: [],
200
- validFrom: Date.now() - 30 * 86_400_000,
201
- validUntil: null,
202
- };
203
- const lowAccess = computeDecayScore(base, 0.5);
204
- const highAccess = computeDecayScore({ ...base, accessCount: 10, lastAccessedAt: Date.now() }, 0.5);
205
- expect(highAccess).toBeGreaterThan(lowAccess);
206
- });
207
-
208
- test("higher importance produces higher decay score", () => {
209
- const base: EvolutionMetadata = {
210
- status: "active",
211
- version: 1,
212
- accessCount: 2,
213
- lastAccessedAt: Date.now() - 86_400_000,
214
- supersededBy: null,
215
- consolidatedInto: null,
216
- sourceMemories: [],
217
- validFrom: Date.now() - 30 * 86_400_000,
218
- validUntil: null,
219
- };
220
- const lowImportance = computeDecayScore(base, 0.3);
221
- const highImportance = computeDecayScore(base, 0.9);
222
- expect(highImportance).toBeGreaterThan(lowImportance);
223
- });
224
-
225
- test("older memories without access have lower decay scores", () => {
226
- const recent: EvolutionMetadata = {
227
- status: "active",
228
- version: 1,
229
- accessCount: 0,
230
- lastAccessedAt: null,
231
- supersededBy: null,
232
- consolidatedInto: null,
233
- sourceMemories: [],
234
- validFrom: Date.now() - 7 * 86_400_000,
235
- validUntil: null,
236
- };
237
- const old: EvolutionMetadata = {
238
- ...recent,
239
- validFrom: Date.now() - 180 * 86_400_000,
240
- };
241
- expect(computeDecayScore(recent, 0.5)).toBeGreaterThan(computeDecayScore(old, 0.5));
242
- });
243
- });
@@ -1,271 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
- import {
3
- defaultEvolution,
4
- parseEvolution,
5
- patchEvolution,
6
- isActiveMemory,
7
- recordAccess,
8
- buildSupersedeMetadata,
9
- buildConsolidatedMetadata,
10
- buildArchivedMetadata,
11
- computeDecayScore,
12
- type EvolutionMetadata,
13
- } from "../memory-evolution.js";
14
-
15
- describe("memory-evolution", () => {
16
- // -----------------------------------------------------------------------
17
- // defaultEvolution
18
- // -----------------------------------------------------------------------
19
- describe("defaultEvolution", () => {
20
- test("returns active status with version 1", () => {
21
- const evo = defaultEvolution(1000);
22
- expect(evo.status).toBe("active");
23
- expect(evo.version).toBe(1);
24
- expect(evo.accessCount).toBe(0);
25
- expect(evo.lastAccessedAt).toBeNull();
26
- expect(evo.supersededBy).toBeNull();
27
- expect(evo.consolidatedInto).toBeNull();
28
- expect(evo.sourceMemories).toEqual([]);
29
- expect(evo.validFrom).toBe(1000);
30
- expect(evo.validUntil).toBeNull();
31
- });
32
-
33
- test("uses Date.now() when no timestamp provided", () => {
34
- const before = Date.now();
35
- const evo = defaultEvolution();
36
- expect(evo.validFrom).toBeGreaterThanOrEqual(before);
37
- expect(evo.validFrom).toBeLessThanOrEqual(Date.now());
38
- });
39
- });
40
-
41
- // -----------------------------------------------------------------------
42
- // parseEvolution
43
- // -----------------------------------------------------------------------
44
- describe("parseEvolution", () => {
45
- test("returns defaults for undefined metadata", () => {
46
- const evo = parseEvolution(undefined, 2000);
47
- expect(evo.status).toBe("active");
48
- expect(evo.validFrom).toBe(2000);
49
- });
50
-
51
- test("returns defaults for empty string metadata", () => {
52
- const evo = parseEvolution("", 2000);
53
- expect(evo.status).toBe("active");
54
- });
55
-
56
- test("returns defaults for metadata without evolution field", () => {
57
- const meta = JSON.stringify({ source: "manual", tags: [] });
58
- const evo = parseEvolution(meta, 3000);
59
- expect(evo.status).toBe("active");
60
- expect(evo.validFrom).toBe(3000);
61
- });
62
-
63
- test("returns defaults for invalid JSON", () => {
64
- const evo = parseEvolution("not json", 4000);
65
- expect(evo.status).toBe("active");
66
- expect(evo.validFrom).toBe(4000);
67
- });
68
-
69
- test("parses valid evolution metadata", () => {
70
- const meta = JSON.stringify({
71
- source: "agent",
72
- evolution: {
73
- status: "superseded",
74
- version: 3,
75
- accessCount: 42,
76
- lastAccessedAt: 5000,
77
- supersededBy: "abc-123",
78
- consolidatedInto: null,
79
- sourceMemories: ["x", "y"],
80
- validFrom: 1000,
81
- validUntil: 4000,
82
- },
83
- });
84
- const evo = parseEvolution(meta);
85
- expect(evo.status).toBe("superseded");
86
- expect(evo.version).toBe(3);
87
- expect(evo.accessCount).toBe(42);
88
- expect(evo.lastAccessedAt).toBe(5000);
89
- expect(evo.supersededBy).toBe("abc-123");
90
- expect(evo.sourceMemories).toEqual(["x", "y"]);
91
- expect(evo.validFrom).toBe(1000);
92
- expect(evo.validUntil).toBe(4000);
93
- });
94
-
95
- test("fills missing fields with defaults", () => {
96
- const meta = JSON.stringify({ evolution: { status: "archived" } });
97
- const evo = parseEvolution(meta, 6000);
98
- expect(evo.status).toBe("archived");
99
- expect(evo.version).toBe(1);
100
- expect(evo.accessCount).toBe(0);
101
- expect(evo.validFrom).toBe(6000);
102
- });
103
- });
104
-
105
- // -----------------------------------------------------------------------
106
- // patchEvolution
107
- // -----------------------------------------------------------------------
108
- describe("patchEvolution", () => {
109
- test("creates evolution on empty metadata", () => {
110
- const patched = patchEvolution(undefined, { status: "archived" });
111
- const parsed = JSON.parse(patched);
112
- expect(parsed.evolution.status).toBe("archived");
113
- });
114
-
115
- test("merges into existing evolution", () => {
116
- const original = JSON.stringify({
117
- source: "manual",
118
- evolution: { status: "active", version: 1, accessCount: 5 },
119
- });
120
- const patched = patchEvolution(original, { accessCount: 6, lastAccessedAt: 9000 });
121
- const parsed = JSON.parse(patched);
122
- expect(parsed.source).toBe("manual");
123
- expect(parsed.evolution.status).toBe("active");
124
- expect(parsed.evolution.version).toBe(1);
125
- expect(parsed.evolution.accessCount).toBe(6);
126
- expect(parsed.evolution.lastAccessedAt).toBe(9000);
127
- });
128
-
129
- test("preserves non-evolution fields", () => {
130
- const original = JSON.stringify({ source: "agent", tags: ["a"], canonicalKey: "k1" });
131
- const patched = patchEvolution(original, { status: "superseded" });
132
- const parsed = JSON.parse(patched);
133
- expect(parsed.source).toBe("agent");
134
- expect(parsed.tags).toEqual(["a"]);
135
- expect(parsed.canonicalKey).toBe("k1");
136
- });
137
- });
138
-
139
- // -----------------------------------------------------------------------
140
- // isActiveMemory
141
- // -----------------------------------------------------------------------
142
- describe("isActiveMemory", () => {
143
- test("true for undefined metadata (backward compat)", () => {
144
- expect(isActiveMemory(undefined)).toBe(true);
145
- });
146
-
147
- test("true for metadata without evolution", () => {
148
- expect(isActiveMemory(JSON.stringify({ source: "manual" }))).toBe(true);
149
- });
150
-
151
- test("true for active status", () => {
152
- const meta = JSON.stringify({ evolution: { status: "active" } });
153
- expect(isActiveMemory(meta)).toBe(true);
154
- });
155
-
156
- test("false for superseded", () => {
157
- const meta = JSON.stringify({ evolution: { status: "superseded" } });
158
- expect(isActiveMemory(meta)).toBe(false);
159
- });
160
-
161
- test("false for archived", () => {
162
- const meta = JSON.stringify({ evolution: { status: "archived" } });
163
- expect(isActiveMemory(meta)).toBe(false);
164
- });
165
-
166
- test("false for consolidated", () => {
167
- const meta = JSON.stringify({ evolution: { status: "consolidated" } });
168
- expect(isActiveMemory(meta)).toBe(false);
169
- });
170
- });
171
-
172
- // -----------------------------------------------------------------------
173
- // recordAccess
174
- // -----------------------------------------------------------------------
175
- describe("recordAccess", () => {
176
- test("increments count from 0 on undefined metadata", () => {
177
- const updated = recordAccess(undefined);
178
- const evo = parseEvolution(updated);
179
- expect(evo.accessCount).toBe(1);
180
- expect(evo.lastAccessedAt).toBeGreaterThan(0);
181
- });
182
-
183
- test("increments existing count", () => {
184
- const original = JSON.stringify({
185
- evolution: { accessCount: 5, lastAccessedAt: 1000 },
186
- });
187
- const updated = recordAccess(original);
188
- const evo = parseEvolution(updated);
189
- expect(evo.accessCount).toBe(6);
190
- expect(evo.lastAccessedAt!).toBeGreaterThan(1000);
191
- });
192
- });
193
-
194
- // -----------------------------------------------------------------------
195
- // buildSupersedeMetadata / buildConsolidatedMetadata / buildArchivedMetadata
196
- // -----------------------------------------------------------------------
197
- describe("supersede/consolidate/archive helpers", () => {
198
- test("buildSupersedeMetadata sets status and links", () => {
199
- const original = JSON.stringify({ source: "manual", evolution: defaultEvolution(1000) });
200
- const result = buildSupersedeMetadata(original, "new-id-123");
201
- const evo = parseEvolution(result);
202
- expect(evo.status).toBe("superseded");
203
- expect(evo.supersededBy).toBe("new-id-123");
204
- expect(evo.validUntil).toBeGreaterThan(0);
205
- });
206
-
207
- test("buildConsolidatedMetadata sets status and link", () => {
208
- const result = buildConsolidatedMetadata(undefined, "consolidated-id");
209
- const evo = parseEvolution(result);
210
- expect(evo.status).toBe("consolidated");
211
- expect(evo.consolidatedInto).toBe("consolidated-id");
212
- });
213
-
214
- test("buildArchivedMetadata sets status", () => {
215
- const result = buildArchivedMetadata(undefined);
216
- const evo = parseEvolution(result);
217
- expect(evo.status).toBe("archived");
218
- });
219
- });
220
-
221
- // -----------------------------------------------------------------------
222
- // computeDecayScore
223
- // -----------------------------------------------------------------------
224
- describe("computeDecayScore", () => {
225
- test("brand new high-importance memory scores high", () => {
226
- const now = Date.now();
227
- const evo: EvolutionMetadata = {
228
- ...defaultEvolution(now),
229
- accessCount: 0,
230
- };
231
- const score = computeDecayScore(evo, 1.0, now);
232
- // 0.2 * 1.0 (fresh) + 0.3 * 0 (no access) * 0.5 + 0.5 * 1.0 = 0.7 + small freq
233
- expect(score).toBeGreaterThan(0.6);
234
- expect(score).toBeLessThanOrEqual(1.0);
235
- });
236
-
237
- test("old unaccessed low-importance memory scores low", () => {
238
- const now = Date.now();
239
- const evo: EvolutionMetadata = {
240
- ...defaultEvolution(now - 365 * 86_400_000), // 1 year old
241
- accessCount: 0,
242
- };
243
- const score = computeDecayScore(evo, 0.1, now);
244
- expect(score).toBeLessThan(0.2);
245
- });
246
-
247
- test("frequently accessed memory gets frequency boost", () => {
248
- const now = Date.now();
249
- const evoNoAccess: EvolutionMetadata = {
250
- ...defaultEvolution(now - 30 * 86_400_000),
251
- accessCount: 0,
252
- };
253
- const evoHighAccess: EvolutionMetadata = {
254
- ...defaultEvolution(now - 30 * 86_400_000),
255
- accessCount: 100,
256
- lastAccessedAt: now - 86_400_000, // yesterday
257
- };
258
- const scoreNo = computeDecayScore(evoNoAccess, 0.5, now);
259
- const scoreHigh = computeDecayScore(evoHighAccess, 0.5, now);
260
- expect(scoreHigh).toBeGreaterThan(scoreNo);
261
- });
262
-
263
- test("importance dominates scoring (0.5 weight)", () => {
264
- const now = Date.now();
265
- const evo = defaultEvolution(now);
266
- const lowImp = computeDecayScore(evo, 0.1, now);
267
- const highImp = computeDecayScore(evo, 1.0, now);
268
- expect(highImp - lowImp).toBeGreaterThan(0.3); // 0.5 * (1.0 - 0.1) = 0.45
269
- });
270
- });
271
- });
@@ -1,144 +0,0 @@
1
- import { describe, expect, it } from "bun:test";
2
-
3
- import {
4
- buildMemoryHealthRebalancePlan,
5
- computeRebalancedImportance,
6
- getMemoryHealthAccessCount,
7
- getStoredMemoryTier,
8
- parseMemoryHealthMetadata,
9
- resolveRebalancedTier,
10
- summarizeMemoryHealthPlans,
11
- } from "../memory-health-rebalance.js";
12
-
13
- const datasetStats = {
14
- maxAccessCount: 19,
15
- minTimestamp: Date.parse("2026-03-02T00:00:00.000Z"),
16
- maxTimestamp: Date.parse("2026-03-19T00:00:00.000Z"),
17
- };
18
-
19
- describe("memory health rebalance", () => {
20
- it("parses metadata safely and supports both accessCount key styles", () => {
21
- expect(parseMemoryHealthMetadata("{")).toEqual({});
22
- expect(getMemoryHealthAccessCount({ accessCount: 3 })).toBe(3);
23
- expect(getMemoryHealthAccessCount({ access_count: 4 })).toBe(4);
24
- expect(getStoredMemoryTier({ tier: "working" })).toBe("working");
25
- expect(getStoredMemoryTier({ tier: "unknown" })).toBe("unknown");
26
- });
27
-
28
- it("demotes dead memories to peripheral even when they already had a hotter tier", () => {
29
- const plan = buildMemoryHealthRebalancePlan({
30
- id: "dead-memory",
31
- importance: 0.8,
32
- timestamp: datasetStats.minTimestamp,
33
- metadata: JSON.stringify({ tier: "working", accessCount: 0 }),
34
- }, datasetStats);
35
-
36
- expect(resolveRebalancedTier("working", 0)).toBe("peripheral");
37
- expect(plan.targetTier).toBe("peripheral");
38
- expect(plan.deadMemoryRow).toBe(true);
39
- expect(plan.deadMemoryDemoted).toBe(true);
40
- expect(plan.nextImportance).toBeGreaterThanOrEqual(0.3);
41
- expect(plan.nextImportance).toBeLessThanOrEqual(0.5);
42
- expect(plan.nextMetadata.tier).toBe("peripheral");
43
- expect(plan.nextMetadata.importance).toBe(plan.nextImportance);
44
- });
45
-
46
- it("backfills unknown tiers from access counts", () => {
47
- const corePlan = buildMemoryHealthRebalancePlan({
48
- id: "unknown-core",
49
- importance: 0.7,
50
- timestamp: datasetStats.maxTimestamp,
51
- metadata: JSON.stringify({ accessCount: 6 }),
52
- }, datasetStats);
53
- const workingPlan = buildMemoryHealthRebalancePlan({
54
- id: "unknown-working",
55
- importance: 0.7,
56
- timestamp: datasetStats.maxTimestamp,
57
- metadata: JSON.stringify({ accessCount: 3 }),
58
- }, datasetStats);
59
-
60
- expect(corePlan.currentTier).toBe("unknown");
61
- expect(corePlan.targetTier).toBe("core");
62
- expect(corePlan.tierBackfilled).toBe(true);
63
- expect(corePlan.nextImportance).toBeGreaterThanOrEqual(0.85);
64
- expect(corePlan.nextImportance).toBeLessThanOrEqual(0.95);
65
-
66
- expect(workingPlan.targetTier).toBe("working");
67
- expect(workingPlan.nextImportance).toBeGreaterThanOrEqual(0.6);
68
- expect(workingPlan.nextImportance).toBeLessThanOrEqual(0.8);
69
- });
70
-
71
- it("keeps existing non-dead tiers and only reshapes importance within the tier band", () => {
72
- const lowPlan = buildMemoryHealthRebalancePlan({
73
- id: "working-low",
74
- importance: 0.6,
75
- timestamp: datasetStats.minTimestamp,
76
- metadata: JSON.stringify({ tier: "working", accessCount: 2 }),
77
- }, datasetStats);
78
- const highPlan = buildMemoryHealthRebalancePlan({
79
- id: "working-high",
80
- importance: 0.8,
81
- timestamp: datasetStats.maxTimestamp,
82
- metadata: JSON.stringify({ tier: "working", accessCount: 5 }),
83
- }, datasetStats);
84
-
85
- expect(lowPlan.targetTier).toBe("working");
86
- expect(highPlan.targetTier).toBe("working");
87
- expect(lowPlan.nextImportance).toBeLessThan(highPlan.nextImportance);
88
- expect(lowPlan.nextImportance).toBeGreaterThanOrEqual(0.6);
89
- expect(highPlan.nextImportance).toBeLessThanOrEqual(0.8);
90
- });
91
-
92
- it("uses access_count and existing importance together instead of hard-overwriting values", () => {
93
- const cooler = computeRebalancedImportance(0.6, "core", 6, 19, 0.2);
94
- const hotter = computeRebalancedImportance(0.9, "core", 19, 19, 0.9);
95
-
96
- expect(cooler).toBeGreaterThanOrEqual(0.85);
97
- expect(hotter).toBeLessThanOrEqual(0.95);
98
- expect(hotter).toBeGreaterThan(cooler);
99
- });
100
-
101
- it("uses recency to spread dead peripheral memories within the peripheral band", () => {
102
- const older = buildMemoryHealthRebalancePlan({
103
- id: "dead-old",
104
- importance: 0.35,
105
- timestamp: datasetStats.minTimestamp,
106
- metadata: JSON.stringify({ accessCount: 0 }),
107
- }, datasetStats);
108
- const newer = buildMemoryHealthRebalancePlan({
109
- id: "dead-new",
110
- importance: 0.35,
111
- timestamp: datasetStats.maxTimestamp,
112
- metadata: JSON.stringify({ accessCount: 0 }),
113
- }, datasetStats);
114
-
115
- expect(older.targetTier).toBe("peripheral");
116
- expect(newer.targetTier).toBe("peripheral");
117
- expect(older.nextImportance).toBeGreaterThanOrEqual(0.3);
118
- expect(newer.nextImportance).toBeLessThanOrEqual(0.5);
119
- expect(newer.nextImportance).toBeGreaterThan(older.nextImportance);
120
- });
121
-
122
- it("summarizes rebalance plans for reporting", () => {
123
- const summary = summarizeMemoryHealthPlans([
124
- buildMemoryHealthRebalancePlan({
125
- id: "a",
126
- importance: 0.7,
127
- timestamp: datasetStats.minTimestamp,
128
- metadata: JSON.stringify({ accessCount: 0 }),
129
- }, datasetStats),
130
- buildMemoryHealthRebalancePlan({
131
- id: "b",
132
- importance: 0.7,
133
- timestamp: datasetStats.maxTimestamp,
134
- metadata: JSON.stringify({ tier: "working", accessCount: 4 }),
135
- }, datasetStats),
136
- ]);
137
-
138
- expect(summary.totalRows).toBe(2);
139
- expect(summary.changedRows).toBe(2);
140
- expect(summary.deadMemoryRows).toBe(1);
141
- expect(summary.tierBackfills).toBe(1);
142
- expect(summary.importanceChanges).toBe(2);
143
- });
144
- });