claude-memory-layer 1.0.31 → 1.0.33

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 (343) hide show
  1. package/README.md +9 -2
  2. package/dist/cli/index.js +1110 -72
  3. package/dist/cli/index.js.map +4 -4
  4. package/dist/core/index.js +414 -25
  5. package/dist/core/index.js.map +2 -2
  6. package/dist/hooks/post-tool-use.js +416 -27
  7. package/dist/hooks/post-tool-use.js.map +2 -2
  8. package/dist/hooks/semantic-daemon.js +416 -27
  9. package/dist/hooks/semantic-daemon.js.map +2 -2
  10. package/dist/hooks/session-end.js +416 -27
  11. package/dist/hooks/session-end.js.map +2 -2
  12. package/dist/hooks/session-start.js +416 -27
  13. package/dist/hooks/session-start.js.map +2 -2
  14. package/dist/hooks/stop.js +416 -27
  15. package/dist/hooks/stop.js.map +2 -2
  16. package/dist/hooks/user-prompt-submit.js +504 -34
  17. package/dist/hooks/user-prompt-submit.js.map +2 -2
  18. package/dist/index.js +416 -27
  19. package/dist/index.js.map +2 -2
  20. package/dist/mcp/index.js +407 -32
  21. package/dist/mcp/index.js.map +2 -2
  22. package/dist/server/api/index.js +850 -44
  23. package/dist/server/api/index.js.map +3 -3
  24. package/dist/server/index.js +1073 -64
  25. package/dist/server/index.js.map +3 -3
  26. package/dist/services/memory-service.js +416 -27
  27. package/dist/services/memory-service.js.map +2 -2
  28. package/dist/ui/assets/js/bootstrap.js +2 -0
  29. package/dist/ui/assets/js/overview.js +166 -3
  30. package/dist/ui/assets/js/state.js +3 -0
  31. package/dist/ui/index.html +20 -0
  32. package/dist/ui/style.css +193 -0
  33. package/package.json +15 -2
  34. package/scripts/postinstall-embedding-backend.cjs +16 -12
  35. package/AGENTS.md +0 -71
  36. package/CLAUDE.md +0 -30
  37. package/HANDOFF.md +0 -92
  38. package/Memo.txt +0 -558
  39. package/benchmarks/replay/anonymized-real-sessions.json +0 -48
  40. package/config/kpi-thresholds.json +0 -7
  41. package/context.md +0 -636
  42. package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +0 -627
  43. package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +0 -440
  44. package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md +0 -271
  45. package/docs/MEMORY_USEFULNESS_AUDIT.md +0 -371
  46. package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +0 -80
  47. package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +0 -333
  48. package/docs/MEMU_ADOPTION.md +0 -40
  49. package/docs/OPERATIONS.md +0 -18
  50. package/docs/PRODUCT_VALIDATION_MATRIX.md +0 -82
  51. package/docs/PROJECT_STRUCTURE_ANALYSIS.md +0 -421
  52. package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +0 -501
  53. package/docs/REFACTORING_PLAN_THIN_CORE.md +0 -414
  54. package/docs/REFERENCE_PROJECT_ANALYSES.md +0 -25
  55. package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +0 -452
  56. package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +0 -446
  57. package/docs/architecture/comparison-index.md +0 -47
  58. package/docs/reports/codex-real-data-validation-20260505T040447Z.md +0 -46
  59. package/plan.md +0 -1642
  60. package/scripts/build.ts +0 -159
  61. package/scripts/bump-patch-version.sh +0 -18
  62. package/scripts/delete-unknown-projects.js +0 -154
  63. package/scripts/fix-sync-gap.js +0 -32
  64. package/scripts/generate-session-qrels.ts +0 -126
  65. package/scripts/heartbeat-memory-orchestrator.sh +0 -28
  66. package/scripts/replay-retrieval-benchmark.ts +0 -69
  67. package/scripts/report-sync-gap.js +0 -26
  68. package/scripts/review-queue-auto-resolve.js +0 -21
  69. package/scripts/sync-gap-auto-heal.sh +0 -17
  70. package/spec.md +0 -624
  71. package/specs/20260207-dashboard-upgrade/context.md +0 -38
  72. package/specs/20260207-dashboard-upgrade/spec.md +0 -96
  73. package/specs/citations-system/context.md +0 -243
  74. package/specs/citations-system/plan.md +0 -495
  75. package/specs/citations-system/spec.md +0 -371
  76. package/specs/endless-mode/context.md +0 -305
  77. package/specs/endless-mode/plan.md +0 -620
  78. package/specs/endless-mode/spec.md +0 -455
  79. package/specs/entity-edge-model/context.md +0 -401
  80. package/specs/entity-edge-model/plan.md +0 -459
  81. package/specs/entity-edge-model/spec.md +0 -391
  82. package/specs/evidence-aligner-v2/context.md +0 -401
  83. package/specs/evidence-aligner-v2/plan.md +0 -303
  84. package/specs/evidence-aligner-v2/spec.md +0 -312
  85. package/specs/mcp-desktop-integration/context.md +0 -278
  86. package/specs/mcp-desktop-integration/plan.md +0 -550
  87. package/specs/mcp-desktop-integration/spec.md +0 -494
  88. package/specs/memory-utilization-improvements/context.md +0 -145
  89. package/specs/memory-utilization-improvements/plan.md +0 -361
  90. package/specs/memory-utilization-improvements/spec.md +0 -361
  91. package/specs/post-tool-use-hook/context.md +0 -319
  92. package/specs/post-tool-use-hook/plan.md +0 -469
  93. package/specs/post-tool-use-hook/spec.md +0 -364
  94. package/specs/private-tags/context.md +0 -288
  95. package/specs/private-tags/plan.md +0 -412
  96. package/specs/private-tags/spec.md +0 -345
  97. package/specs/progressive-disclosure/context.md +0 -346
  98. package/specs/progressive-disclosure/plan.md +0 -663
  99. package/specs/progressive-disclosure/spec.md +0 -415
  100. package/specs/selective-tool-observation/context.md +0 -100
  101. package/specs/selective-tool-observation/plan.md +0 -158
  102. package/specs/selective-tool-observation/spec.md +0 -127
  103. package/specs/task-entity-system/context.md +0 -297
  104. package/specs/task-entity-system/plan.md +0 -301
  105. package/specs/task-entity-system/spec.md +0 -314
  106. package/specs/thin-core-refactor/context.md +0 -275
  107. package/specs/thin-core-refactor/plan.md +0 -536
  108. package/specs/thin-core-refactor/spec.md +0 -465
  109. package/specs/vector-outbox-v2/context.md +0 -470
  110. package/specs/vector-outbox-v2/plan.md +0 -562
  111. package/specs/vector-outbox-v2/spec.md +0 -466
  112. package/specs/web-viewer-ui/context.md +0 -384
  113. package/specs/web-viewer-ui/plan.md +0 -797
  114. package/specs/web-viewer-ui/spec.md +0 -516
  115. package/src/adapters/claude/capture/index.ts +0 -3
  116. package/src/adapters/claude/context/index.ts +0 -3
  117. package/src/adapters/claude/hooks/index.ts +0 -21
  118. package/src/adapters/claude/hooks/post-tool-use.ts +0 -239
  119. package/src/adapters/claude/hooks/prompt-injection-policy.ts +0 -104
  120. package/src/adapters/claude/hooks/semantic-daemon-client.ts +0 -209
  121. package/src/adapters/claude/hooks/semantic-daemon.ts +0 -283
  122. package/src/adapters/claude/hooks/session-end.ts +0 -59
  123. package/src/adapters/claude/hooks/session-start.ts +0 -73
  124. package/src/adapters/claude/hooks/stop.ts +0 -128
  125. package/src/adapters/claude/hooks/user-prompt-submit.ts +0 -361
  126. package/src/adapters/claude/index.ts +0 -4
  127. package/src/adapters/claude/transcript/index.ts +0 -4
  128. package/src/adapters/claude/transcript/transcript-reader.ts +0 -57
  129. package/src/adapters/claude/transcript/turn-reconstructor.ts +0 -65
  130. package/src/apps/cli/claude-settings-hooks.ts +0 -138
  131. package/src/apps/cli/codex-import-runner.ts +0 -125
  132. package/src/apps/cli/codex-validation-output.ts +0 -95
  133. package/src/apps/cli/hermes-import-runner.ts +0 -130
  134. package/src/apps/cli/hermes-validation-output.ts +0 -91
  135. package/src/apps/cli/index.ts +0 -1735
  136. package/src/apps/cli/mcp-install.ts +0 -106
  137. package/src/apps/cli/retrieval-disclosure-output.ts +0 -196
  138. package/src/apps/dashboard/assets/js/bootstrap.js +0 -244
  139. package/src/apps/dashboard/assets/js/chat.js +0 -373
  140. package/src/apps/dashboard/assets/js/disclosure.js +0 -232
  141. package/src/apps/dashboard/assets/js/modals.js +0 -298
  142. package/src/apps/dashboard/assets/js/overview.js +0 -655
  143. package/src/apps/dashboard/assets/js/state.js +0 -72
  144. package/src/apps/dashboard/assets/js/views.js +0 -468
  145. package/src/apps/dashboard/index.html +0 -543
  146. package/src/apps/dashboard/index.ts +0 -3
  147. package/src/apps/dashboard/style.css +0 -1750
  148. package/src/apps/index.ts +0 -5
  149. package/src/apps/server/api/chat.ts +0 -244
  150. package/src/apps/server/api/citations.ts +0 -105
  151. package/src/apps/server/api/events.ts +0 -137
  152. package/src/apps/server/api/health.ts +0 -53
  153. package/src/apps/server/api/index.ts +0 -26
  154. package/src/apps/server/api/projects.ts +0 -74
  155. package/src/apps/server/api/search.ts +0 -184
  156. package/src/apps/server/api/sessions.ts +0 -115
  157. package/src/apps/server/api/stats.ts +0 -723
  158. package/src/apps/server/api/turns.ts +0 -143
  159. package/src/apps/server/api/utils.ts +0 -65
  160. package/src/apps/server/index.ts +0 -111
  161. package/src/cli/index.ts +0 -3
  162. package/src/cli/retrieval-disclosure-output.ts +0 -2
  163. package/src/compat/index.ts +0 -5
  164. package/src/core/canonical-key.ts +0 -186
  165. package/src/core/citation-generator.ts +0 -63
  166. package/src/core/consolidated-store.ts +0 -356
  167. package/src/core/consolidation-worker.ts +0 -493
  168. package/src/core/context-formatter.ts +0 -276
  169. package/src/core/continuity-manager.ts +0 -341
  170. package/src/core/db-wrapper.ts +0 -64
  171. package/src/core/derive/fact-deriver.ts +0 -170
  172. package/src/core/derive/index.ts +0 -2
  173. package/src/core/derive/summary-deriver.ts +0 -76
  174. package/src/core/edge-repo.ts +0 -333
  175. package/src/core/embedder.ts +0 -4
  176. package/src/core/engine/embedding-maintenance-service.ts +0 -187
  177. package/src/core/engine/endless-memory-services.ts +0 -4
  178. package/src/core/engine/index.ts +0 -19
  179. package/src/core/engine/memory-engine-services.ts +0 -170
  180. package/src/core/engine/memory-ingest-service.ts +0 -317
  181. package/src/core/engine/memory-query-service.ts +0 -173
  182. package/src/core/engine/memory-runtime-service.ts +0 -162
  183. package/src/core/engine/memory-service-composition.ts +0 -231
  184. package/src/core/engine/retrieval-analytics-service.ts +0 -181
  185. package/src/core/engine/retrieval-disclosure-service.ts +0 -420
  186. package/src/core/engine/retrieval-orchestrator.ts +0 -377
  187. package/src/core/engine/retrieval-services.ts +0 -176
  188. package/src/core/engine/shared-memory-services.ts +0 -4
  189. package/src/core/entity-repo.ts +0 -349
  190. package/src/core/event-store.ts +0 -779
  191. package/src/core/evidence-aligner.ts +0 -635
  192. package/src/core/external-market-context.ts +0 -582
  193. package/src/core/graduation-worker.ts +0 -171
  194. package/src/core/graduation.ts +0 -377
  195. package/src/core/index.ts +0 -64
  196. package/src/core/ingest-interceptor.ts +0 -80
  197. package/src/core/markdown-mirror.ts +0 -70
  198. package/src/core/matcher.ts +0 -208
  199. package/src/core/md-mirror.ts +0 -92
  200. package/src/core/metadata-extractor.ts +0 -203
  201. package/src/core/model/memory-fact.ts +0 -30
  202. package/src/core/model/memory-rule.ts +0 -14
  203. package/src/core/model/memory-summary.ts +0 -21
  204. package/src/core/model/raw-event.ts +0 -28
  205. package/src/core/model/retrieval-result.ts +0 -35
  206. package/src/core/mongo-sync-config.ts +0 -165
  207. package/src/core/mongo-sync-worker.ts +0 -381
  208. package/src/core/privacy/filter.ts +0 -190
  209. package/src/core/privacy/index.ts +0 -20
  210. package/src/core/privacy/tag-parser.ts +0 -145
  211. package/src/core/product-validation-matrix.ts +0 -314
  212. package/src/core/progressive-retriever.ts +0 -414
  213. package/src/core/registry/project-path.ts +0 -54
  214. package/src/core/registry/session-registry.ts +0 -69
  215. package/src/core/replay-evaluator.ts +0 -625
  216. package/src/core/retrieval-benchmark.ts +0 -117
  217. package/src/core/retrieval-quality.ts +0 -109
  218. package/src/core/retriever.ts +0 -800
  219. package/src/core/session-qrels.ts +0 -360
  220. package/src/core/shared-event-store.ts +0 -114
  221. package/src/core/shared-promoter.ts +0 -249
  222. package/src/core/shared-store.ts +0 -289
  223. package/src/core/shared-vector-store.ts +0 -203
  224. package/src/core/sqlite-event-store.ts +0 -1846
  225. package/src/core/sqlite-wrapper.ts +0 -116
  226. package/src/core/sync-worker.ts +0 -228
  227. package/src/core/tag-taxonomy.ts +0 -51
  228. package/src/core/task/blocker-resolver.ts +0 -333
  229. package/src/core/task/index.ts +0 -9
  230. package/src/core/task/task-matcher.ts +0 -240
  231. package/src/core/task/task-projector.ts +0 -358
  232. package/src/core/task/task-resolver.ts +0 -421
  233. package/src/core/turn-state.ts +0 -207
  234. package/src/core/types.ts +0 -952
  235. package/src/core/vector-outbox.ts +0 -299
  236. package/src/core/vector-store.ts +0 -231
  237. package/src/core/vector-worker.ts +0 -521
  238. package/src/core/working-set-store.ts +0 -257
  239. package/src/extensions/endless-memory/endless-memory-services.ts +0 -350
  240. package/src/extensions/endless-memory/index.ts +0 -1
  241. package/src/extensions/index.ts +0 -5
  242. package/src/extensions/mcp/handlers.ts +0 -960
  243. package/src/extensions/mcp/index.ts +0 -48
  244. package/src/extensions/mcp/tools.ts +0 -252
  245. package/src/extensions/shared-memory/index.ts +0 -1
  246. package/src/extensions/shared-memory/shared-memory-services.ts +0 -211
  247. package/src/extensions/vector/embedder.ts +0 -234
  248. package/src/extensions/vector/index.ts +0 -1
  249. package/src/hooks/post-tool-use.ts +0 -9
  250. package/src/hooks/semantic-daemon-client.ts +0 -1
  251. package/src/hooks/semantic-daemon.ts +0 -11
  252. package/src/hooks/session-end.ts +0 -9
  253. package/src/hooks/session-start.ts +0 -9
  254. package/src/hooks/stop.ts +0 -9
  255. package/src/hooks/user-prompt-submit.ts +0 -9
  256. package/src/index.ts +0 -13
  257. package/src/mcp/handlers.ts +0 -2
  258. package/src/mcp/index.ts +0 -4
  259. package/src/mcp/tools.ts +0 -2
  260. package/src/server/api/chat.ts +0 -2
  261. package/src/server/api/citations.ts +0 -2
  262. package/src/server/api/events.ts +0 -2
  263. package/src/server/api/health.ts +0 -2
  264. package/src/server/api/index.ts +0 -2
  265. package/src/server/api/projects.ts +0 -2
  266. package/src/server/api/search.ts +0 -2
  267. package/src/server/api/sessions.ts +0 -2
  268. package/src/server/api/stats.ts +0 -2
  269. package/src/server/api/turns.ts +0 -2
  270. package/src/server/api/utils.ts +0 -2
  271. package/src/server/index.ts +0 -2
  272. package/src/services/bootstrap-organizer.ts +0 -463
  273. package/src/services/codex-session-history-importer.ts +0 -966
  274. package/src/services/hermes-session-history-importer.ts +0 -733
  275. package/src/services/memory-service-config.ts +0 -36
  276. package/src/services/memory-service-registry.ts +0 -150
  277. package/src/services/memory-service.ts +0 -688
  278. package/src/services/session-history-importer.ts +0 -629
  279. package/tests/README.md +0 -23
  280. package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +0 -54
  281. package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +0 -98
  282. package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +0 -99
  283. package/tests/apps/app-layer-boundary.test.ts +0 -48
  284. package/tests/apps/claude-settings-hooks.test.ts +0 -107
  285. package/tests/apps/cli-disclosure-output.test.ts +0 -212
  286. package/tests/apps/codex-import-runner.test.ts +0 -99
  287. package/tests/apps/codex-validation-output.test.ts +0 -100
  288. package/tests/apps/hermes-import-runner.test.ts +0 -99
  289. package/tests/apps/mcp-install-command.test.ts +0 -59
  290. package/tests/apps/package-build-entrypoints.test.ts +0 -30
  291. package/tests/apps/postinstall-embedding-backend.test.ts +0 -185
  292. package/tests/apps/search-api-disclosure.test.ts +0 -162
  293. package/tests/apps/stats-api-lightweight.test.ts +0 -67
  294. package/tests/apps/ui-disclosure-output.test.ts +0 -140
  295. package/tests/core/bootstrap-organizer.test.ts +0 -111
  296. package/tests/core/canonical-key.test.ts +0 -101
  297. package/tests/core/codex-session-history-importer-validation.test.ts +0 -185
  298. package/tests/core/consolidation-worker.test.ts +0 -75
  299. package/tests/core/embedding-maintenance-service.test.ts +0 -282
  300. package/tests/core/evidence-aligner.test.ts +0 -152
  301. package/tests/core/external-market-context.test.ts +0 -209
  302. package/tests/core/fact-deriver.test.ts +0 -79
  303. package/tests/core/hermes-session-history-importer-validation.test.ts +0 -609
  304. package/tests/core/ingest-interceptor.test.ts +0 -38
  305. package/tests/core/markdown-mirror.test.ts +0 -85
  306. package/tests/core/matcher.test.ts +0 -112
  307. package/tests/core/md-mirror.test.ts +0 -50
  308. package/tests/core/memory-engine-services.test.ts +0 -240
  309. package/tests/core/memory-ingest-service.test.ts +0 -296
  310. package/tests/core/memory-query-service.test.ts +0 -129
  311. package/tests/core/memory-runtime-service.test.ts +0 -201
  312. package/tests/core/memory-service-composition.test.ts +0 -192
  313. package/tests/core/memory-service-config.test.ts +0 -41
  314. package/tests/core/memory-service-facade.test.ts +0 -30
  315. package/tests/core/memory-service-registry.test.ts +0 -206
  316. package/tests/core/product-validation-matrix.test.ts +0 -61
  317. package/tests/core/project-registry.test.ts +0 -78
  318. package/tests/core/replay-evaluator.test.ts +0 -181
  319. package/tests/core/retrieval-analytics-service.test.ts +0 -210
  320. package/tests/core/retrieval-benchmark.test.ts +0 -93
  321. package/tests/core/retrieval-disclosure-service.test.ts +0 -264
  322. package/tests/core/retrieval-orchestrator.test.ts +0 -403
  323. package/tests/core/retrieval-quality.test.ts +0 -31
  324. package/tests/core/retrieval-services.test.ts +0 -185
  325. package/tests/core/retriever-fallback-chain.test.ts +0 -223
  326. package/tests/core/retriever-strategy-scope.test.ts +0 -164
  327. package/tests/core/retriever.memu-adoption.test.ts +0 -122
  328. package/tests/core/session-history-importer-filter.test.ts +0 -78
  329. package/tests/core/session-qrels.test.ts +0 -250
  330. package/tests/core/sqlite-event-store-replication.test.ts +0 -127
  331. package/tests/core/summary-deriver.test.ts +0 -66
  332. package/tests/extensions/embedder-warning-suppression.test.ts +0 -84
  333. package/tests/extensions/endless-memory-extension-boundary.test.ts +0 -17
  334. package/tests/extensions/endless-memory-services.test.ts +0 -325
  335. package/tests/extensions/mcp-context-tools.test.ts +0 -905
  336. package/tests/extensions/mcp-extension-boundary.test.ts +0 -21
  337. package/tests/extensions/mcp-package-build.test.ts +0 -22
  338. package/tests/extensions/mcp-project-aware-tools.test.ts +0 -102
  339. package/tests/extensions/shared-memory-extension-boundary.test.ts +0 -24
  340. package/tests/extensions/shared-memory-services.test.ts +0 -309
  341. package/tests/extensions/vector-extension-boundary.test.ts +0 -21
  342. package/tsconfig.json +0 -24
  343. package/vitest.config.ts +0 -15
@@ -1,296 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
-
3
- import { MemoryIngestService } from '../../src/core/engine/memory-ingest-service.js';
4
- import type { AppendResult, MemoryEvent, MemoryEventInput, ToolObservationPayload } from '../../src/core/types.js';
5
-
6
- function event(overrides: Partial<MemoryEvent>): MemoryEvent {
7
- return {
8
- id: '11111111-1111-4111-8111-111111111111',
9
- eventType: 'user_prompt',
10
- sessionId: 'session-1',
11
- timestamp: new Date('2026-04-30T00:00:00.000Z'),
12
- content: 'default content',
13
- canonicalKey: 'default-content',
14
- dedupeKey: 'session-1:default-content',
15
- metadata: {},
16
- ...overrides
17
- };
18
- }
19
-
20
- interface CreateServiceOptions {
21
- eventsBySession?: Record<string, MemoryEvent[]>;
22
- projectHash?: string | null;
23
- projectPath?: string | null;
24
- appendResult?: AppendResult;
25
- }
26
-
27
- function createService(options: CreateServiceOptions = {}) {
28
- const eventsBySession = options.eventsBySession ?? {};
29
- const appended: MemoryEventInput[] = [];
30
- const initialize = vi.fn(async () => {});
31
- const store = {
32
- upsertSession: vi.fn(async () => {}),
33
- getSessionEvents: vi.fn(async (sessionId: string) => eventsBySession[sessionId] ?? []),
34
- getSessionsWithoutSummary: vi.fn(async () => Object.keys(eventsBySession)),
35
- append: vi.fn(async (input: MemoryEventInput): Promise<AppendResult> => {
36
- appended.push(input);
37
- return options.appendResult ?? { success: true, eventId: `event-${appended.length}`, isDuplicate: false };
38
- }),
39
- enqueueForEmbedding: vi.fn(async (_eventId: string, _content: string) => {})
40
- };
41
- const markdownMirror = {
42
- append: vi.fn(async (_input: MemoryEventInput, _eventId?: string) => {})
43
- };
44
- const createToolEmbedding = vi.fn((payload: ToolObservationPayload) => `${payload.toolName}:${payload.success}`);
45
-
46
- return {
47
- service: new MemoryIngestService({
48
- initialize,
49
- eventStore: store,
50
- markdownMirror,
51
- createToolEmbedding,
52
- getProjectHash: () => options.projectHash ?? null,
53
- getProjectPath: () => options.projectPath ?? null
54
- }),
55
- initialize,
56
- store,
57
- markdownMirror,
58
- createToolEmbedding,
59
- appended
60
- };
61
- }
62
-
63
- describe('MemoryIngestService ingest pipeline', () => {
64
- it('normalizes metadata, runs interceptors, appends, enqueues embeddings, and mirrors successful events', async () => {
65
- const { service, store, markdownMirror, appended } = createService({
66
- projectHash: 'project-hash-1',
67
- projectPath: '/workspace/project'
68
- });
69
- const stages: string[] = [];
70
-
71
- service.registerIngestBefore((context) => {
72
- stages.push(`${context.stage}:${context.operation}`);
73
- expect(context.sessionId).toBe('session-1');
74
- expect(context.event.metadata).toMatchObject({
75
- ingest: { operation: 'user_prompt', pipeline: 'default' },
76
- scope: {
77
- project: { hash: 'project-hash-1', path: '/workspace/project' },
78
- turn: { id: 'turn-1' }
79
- },
80
- tags: ['user:alice', 'legacy', 'proj:project-hash-1']
81
- });
82
- });
83
- service.registerIngestAfter((context) => {
84
- stages.push(`${context.stage}:${context.operation}`);
85
- expect(context.event).toBe(appended[0]);
86
- });
87
-
88
- const result = await service.storeUserPrompt('session-1', 'remember this', {
89
- scope: { turn: { id: 'turn-1' } },
90
- tags: [' user:alice ', 'bad:tag', 'legacy']
91
- });
92
-
93
- expect(result).toEqual({ success: true, eventId: 'event-1', isDuplicate: false });
94
- expect(store.append).toHaveBeenCalledOnce();
95
- expect(appended[0]).toMatchObject({
96
- eventType: 'user_prompt',
97
- sessionId: 'session-1',
98
- content: 'remember this',
99
- metadata: {
100
- ingest: { operation: 'user_prompt', pipeline: 'default' },
101
- scope: {
102
- project: { hash: 'project-hash-1', path: '/workspace/project' },
103
- turn: { id: 'turn-1' }
104
- },
105
- tags: ['user:alice', 'legacy', 'proj:project-hash-1']
106
- }
107
- });
108
- expect((appended[0].metadata as Record<string, unknown>).ingest).toMatchObject({
109
- ts: expect.any(String)
110
- });
111
- expect(store.enqueueForEmbedding).toHaveBeenCalledWith('event-1', 'remember this');
112
- expect(markdownMirror.append).toHaveBeenCalledWith(appended[0], 'event-1');
113
- expect(stages).toEqual(['before:user_prompt', 'after:user_prompt']);
114
- });
115
-
116
- it('does not enqueue embeddings or mirror duplicate append results', async () => {
117
- const { service, store, markdownMirror } = createService({
118
- appendResult: { success: true, eventId: 'duplicate-event', isDuplicate: true }
119
- });
120
-
121
- await expect(service.storeAgentResponse('session-1', 'duplicate response')).resolves.toEqual({
122
- success: true,
123
- eventId: 'duplicate-event',
124
- isDuplicate: true
125
- });
126
-
127
- expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
128
- expect(markdownMirror.append).not.toHaveBeenCalled();
129
- });
130
-
131
- it('keeps markdown mirror failures non-breaking after a successful append', async () => {
132
- const { service, store, markdownMirror } = createService();
133
- markdownMirror.append.mockRejectedValueOnce(new Error('mirror is read-only'));
134
-
135
- await expect(service.storeSessionSummary('session-1', 'summary')).resolves.toEqual({
136
- success: true,
137
- eventId: 'event-1',
138
- isDuplicate: false
139
- });
140
-
141
- expect(store.enqueueForEmbedding).toHaveBeenCalledWith('event-1', 'summary');
142
- expect(markdownMirror.append).toHaveBeenCalledOnce();
143
- });
144
-
145
- it('runs error interceptors and skips side effects when append returns a failure result', async () => {
146
- const { service, store, markdownMirror } = createService({
147
- appendResult: { success: false, error: 'sqlite append failed' }
148
- });
149
- const stages: string[] = [];
150
- const errors: Error[] = [];
151
- service.registerIngestAfter((context) => {
152
- stages.push(context.stage);
153
- });
154
- service.registerIngestOnError((context) => {
155
- stages.push(context.stage);
156
- errors.push(context.error!);
157
- expect(context.operation).toBe('agent_response');
158
- expect(context.event.eventType).toBe('agent_response');
159
- });
160
-
161
- await expect(service.storeAgentResponse('session-1', 'failed append')).resolves.toEqual({
162
- success: false,
163
- error: 'sqlite append failed'
164
- });
165
-
166
- expect(errors.map((error) => error.message)).toEqual(['sqlite append failed']);
167
- expect(stages).toEqual(['error']);
168
- expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
169
- expect(markdownMirror.append).not.toHaveBeenCalled();
170
- });
171
-
172
- it('runs error interceptors and skips side effects when append throws', async () => {
173
- const { service, store, markdownMirror } = createService();
174
- const error = new Error('sqlite unavailable');
175
- store.append.mockRejectedValueOnce(error);
176
- const errors: Error[] = [];
177
- service.registerIngestOnError((context) => {
178
- errors.push(context.error!);
179
- expect(context.stage).toBe('error');
180
- expect(context.operation).toBe('tool_observation');
181
- expect(context.event.eventType).toBe('tool_observation');
182
- });
183
-
184
- await expect(service.storeToolObservation('session-1', {
185
- toolName: 'terminal',
186
- success: false,
187
- metadata: { turnId: 'turn-2' },
188
- output: 'failed'
189
- })).rejects.toThrow('sqlite unavailable');
190
-
191
- expect(errors).toEqual([error]);
192
- expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
193
- expect(markdownMirror.append).not.toHaveBeenCalled();
194
- });
195
- });
196
-
197
- describe('MemoryIngestService session summary generation', () => {
198
- it('generates the legacy rule-based summary and stores it through the ingest pipeline', async () => {
199
- const { service, initialize, store, appended } = createService({
200
- eventsBySession: {
201
- 'session-1': [
202
- event({ id: '11111111-1111-4111-8111-111111111111', eventType: 'user_prompt', content: '첫 번째 작업 요청\n자세한 설명', timestamp: new Date('2026-04-30T01:00:00.000Z') }),
203
- event({ id: '22222222-2222-4222-8222-222222222222', eventType: 'agent_response', content: '응답', timestamp: new Date('2026-04-30T01:01:00.000Z') }),
204
- event({ id: '33333333-3333-4333-8333-333333333333', eventType: 'tool_observation', content: '{}', timestamp: new Date('2026-04-30T01:02:00.000Z'), metadata: { toolName: 'terminal', exitCode: 1 } }),
205
- event({ id: '44444444-4444-4444-8444-444444444444', eventType: 'tool_observation', content: '{}', timestamp: new Date('2026-04-30T01:03:00.000Z'), metadata: { toolName: 'terminal', exitCode: 0 } }),
206
- event({ id: '55555555-5555-4555-8555-555555555555', eventType: 'user_prompt', content: '두 번째 요청', timestamp: new Date('2026-04-30T01:04:00.000Z') })
207
- ]
208
- }
209
- });
210
-
211
- await service.generateSessionSummary('session-1');
212
-
213
- expect(initialize).toHaveBeenCalledOnce();
214
- expect(store.getSessionEvents).toHaveBeenCalledWith('session-1');
215
- expect(appended).toHaveLength(1);
216
- expect(store.enqueueForEmbedding).toHaveBeenCalledWith(
217
- 'event-1',
218
- '[2026-04-30] 2턴 세션. 주요 작업: 첫 번째 작업 요청 자세한 설명. 사용 툴: terminal. 오류 1건 발생'
219
- );
220
- expect(appended[0]).toMatchObject({
221
- eventType: 'session_summary',
222
- sessionId: 'session-1',
223
- content: '[2026-04-30] 2턴 세션. 주요 작업: 첫 번째 작업 요청 자세한 설명. 사용 툴: terminal. 오류 1건 발생',
224
- metadata: {
225
- ingest: { operation: 'session_summary', pipeline: 'default' },
226
- generated: 'rule-based',
227
- eventCount: 5
228
- }
229
- });
230
- });
231
-
232
- it('does not create another summary for too-short or already summarized sessions', async () => {
233
- const { service, appended } = createService({
234
- eventsBySession: {
235
- short: [
236
- event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'short' }),
237
- event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'short', eventType: 'agent_response' })
238
- ],
239
- summarized: [
240
- event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'summarized' }),
241
- event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'summarized', eventType: 'agent_response' }),
242
- event({ id: '55555555-5555-4555-8555-555555555555', sessionId: 'summarized', eventType: 'session_summary', content: 'already summarized' })
243
- ]
244
- }
245
- });
246
-
247
- await service.generateSessionSummary('short');
248
- await service.generateSessionSummary('summarized');
249
-
250
- expect(appended).toEqual([]);
251
- });
252
-
253
- it('backfills only missing summary candidates and keeps failures non-critical', async () => {
254
- const { service, store, appended } = createService({
255
- eventsBySession: {
256
- candidate: [
257
- event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'candidate', eventType: 'user_prompt', content: '분석 작업' }),
258
- event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'candidate', eventType: 'agent_response', content: '응답' }),
259
- event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'candidate', eventType: 'tool_observation', content: '{}', metadata: { toolName: 'read_file' } })
260
- ],
261
- tooShort: [
262
- event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'tooShort', eventType: 'user_prompt' })
263
- ],
264
- broken: [
265
- event({ id: '55555555-5555-4555-8555-555555555555', sessionId: 'broken', eventType: 'user_prompt' }),
266
- event({ id: '66666666-6666-4666-8666-666666666666', sessionId: 'broken', eventType: 'agent_response' }),
267
- event({ id: '77777777-7777-4777-8777-777777777777', sessionId: 'broken', eventType: 'tool_observation' })
268
- ]
269
- }
270
- });
271
- store.getSessionsWithoutSummary.mockResolvedValueOnce(['candidate', 'tooShort', 'broken']);
272
- store.getSessionEvents.mockImplementation(async (sessionId: string) => {
273
- if (sessionId === 'broken') throw new Error('corrupt session');
274
- return (store as any).__eventsBySession?.[sessionId] ?? [];
275
- });
276
- (store as any).__eventsBySession = {
277
- candidate: [
278
- event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'candidate', eventType: 'user_prompt', content: '분석 작업' }),
279
- event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'candidate', eventType: 'agent_response', content: '응답' }),
280
- event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'candidate', eventType: 'tool_observation', content: '{}', metadata: { toolName: 'read_file' } })
281
- ],
282
- tooShort: [
283
- event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'tooShort', eventType: 'user_prompt' })
284
- ]
285
- };
286
-
287
- await expect(service.backfillMissingSummaries('current-session', 7)).resolves.toBeUndefined();
288
-
289
- expect(store.getSessionsWithoutSummary).toHaveBeenCalledWith('current-session', 7);
290
- expect(store.getSessionEvents).toHaveBeenCalledWith('candidate');
291
- expect(store.getSessionEvents).toHaveBeenCalledWith('tooShort');
292
- expect(store.getSessionEvents).toHaveBeenCalledWith('broken');
293
- expect(appended).toHaveLength(1);
294
- expect(appended[0].sessionId).toBe('candidate');
295
- });
296
- });
@@ -1,129 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
-
3
- import { MemoryQueryService } from '../../src/core/engine/memory-query-service.js';
4
- import type { MemoryEvent } from '../../src/core/types.js';
5
-
6
- function event(overrides: Partial<MemoryEvent> = {}): MemoryEvent {
7
- return {
8
- id: '11111111-1111-4111-8111-111111111111',
9
- eventType: 'user_prompt',
10
- sessionId: 'session-1',
11
- timestamp: new Date('2026-05-02T00:00:00.000Z'),
12
- content: 'default content',
13
- canonicalKey: 'default-content',
14
- dedupeKey: 'session-1:default-content',
15
- metadata: {},
16
- ...overrides
17
- };
18
- }
19
-
20
- function createService() {
21
- const initialize = vi.fn(async () => {});
22
- const events = [event()];
23
- const turn = {
24
- turnId: 'turn-1',
25
- events,
26
- startedAt: new Date('2026-05-02T00:00:00.000Z'),
27
- promptPreview: 'default content',
28
- eventCount: 1,
29
- toolCount: 0,
30
- hasResponse: false
31
- };
32
- const outboxStats = {
33
- embedding: { pending: 1, processing: 2, failed: 3, total: 6 },
34
- vector: { pending: 4, processing: 5, failed: 6, total: 15 }
35
- };
36
- const queryStore = {
37
- keywordSearch: vi.fn(async () => [{ event: events[0], rank: -0.5 }]),
38
- getSessionEvents: vi.fn(async () => events),
39
- getRecentEvents: vi.fn(async () => events),
40
- rebuildFtsIndex: vi.fn(async () => 7),
41
- getOutboxStats: vi.fn(async () => outboxStats),
42
- getEventsByLevel: vi.fn(async () => events),
43
- getEventLevel: vi.fn(async () => 'working'),
44
- getSessionTurns: vi.fn(async () => [turn]),
45
- getEventsByTurn: vi.fn(async () => events),
46
- countSessionTurns: vi.fn(async () => 11),
47
- backfillTurnIds: vi.fn(async () => 13),
48
- deleteSessionEvents: vi.fn(async () => 17)
49
- };
50
- const vectorStore = {
51
- count: vi.fn(async () => 19)
52
- };
53
- const graduation = {
54
- getStats: vi.fn(async () => [{ level: 'working', count: 23 }])
55
- };
56
-
57
- return {
58
- service: new MemoryQueryService(initialize, queryStore, { vectorStore, graduation }),
59
- initialize,
60
- queryStore,
61
- vectorStore,
62
- graduation,
63
- events,
64
- turn,
65
- outboxStats
66
- };
67
- }
68
-
69
- describe('MemoryQueryService', () => {
70
- it('delegates read and maintenance methods through the initialized store boundary', async () => {
71
- const { service, initialize, queryStore, events, turn, outboxStats } = createService();
72
-
73
- await expect(service.rebuildFtsIndex()).resolves.toBe(7);
74
- await expect(service.getOutboxStats()).resolves.toEqual(outboxStats);
75
- await expect(service.getEventsByLevel('working', { limit: 2, offset: 3 })).resolves.toEqual(events);
76
- await expect(service.getEventLevel('event-1')).resolves.toBe('working');
77
- await expect(service.getSessionTurns('session-1', { limit: 5, offset: 8 })).resolves.toEqual([turn]);
78
- await expect(service.getEventsByTurn('turn-1')).resolves.toEqual(events);
79
- await expect(service.countSessionTurns('session-1')).resolves.toBe(11);
80
- await expect(service.backfillTurnIds()).resolves.toBe(13);
81
- await expect(service.deleteSessionEvents('session-1')).resolves.toBe(17);
82
-
83
- expect(initialize).toHaveBeenCalledTimes(9);
84
- expect(queryStore.rebuildFtsIndex).toHaveBeenCalledOnce();
85
- expect(queryStore.getOutboxStats).toHaveBeenCalledOnce();
86
- expect(queryStore.getEventsByLevel).toHaveBeenCalledWith('working', { limit: 2, offset: 3 });
87
- expect(queryStore.getEventLevel).toHaveBeenCalledWith('event-1');
88
- expect(queryStore.getSessionTurns).toHaveBeenCalledWith('session-1', { limit: 5, offset: 8 });
89
- expect(queryStore.getEventsByTurn).toHaveBeenCalledWith('turn-1');
90
- expect(queryStore.countSessionTurns).toHaveBeenCalledWith('session-1');
91
- expect(queryStore.backfillTurnIds).toHaveBeenCalledOnce();
92
- expect(queryStore.deleteSessionEvents).toHaveBeenCalledWith('session-1');
93
- });
94
-
95
- it('composes memory statistics from event, vector, and graduation stores', async () => {
96
- const { service, initialize, queryStore, vectorStore, graduation } = createService();
97
-
98
- await expect(service.getStats()).resolves.toEqual({
99
- totalEvents: 1,
100
- vectorCount: 19,
101
- levelStats: [{ level: 'working', count: 23 }]
102
- });
103
-
104
- expect(initialize).toHaveBeenCalledOnce();
105
- expect(queryStore.getRecentEvents).toHaveBeenCalledWith(10000);
106
- expect(vectorStore.count).toHaveBeenCalledOnce();
107
- expect(graduation.getStats).toHaveBeenCalledOnce();
108
- });
109
-
110
- it('keeps lightweight read methods usable with only the narrow query store', async () => {
111
- const initialize = vi.fn(async () => {});
112
- const events = [event({ id: '22222222-2222-4222-8222-222222222222' })];
113
- const queryStore = {
114
- keywordSearch: vi.fn(async () => [{ event: events[0], rank: -0.5 }]),
115
- getSessionEvents: vi.fn(async () => events),
116
- getRecentEvents: vi.fn(async () => events)
117
- };
118
- const service = new MemoryQueryService(initialize, queryStore);
119
-
120
- await expect(service.keywordSearch('query', { topK: 3 })).resolves.toEqual([{ event: events[0], score: 1 }]);
121
- await expect(service.getSessionHistory('session-1')).resolves.toBe(events);
122
- await expect(service.getRecentEvents(2)).resolves.toBe(events);
123
-
124
- expect(initialize).toHaveBeenCalledTimes(3);
125
- expect(queryStore.keywordSearch).toHaveBeenCalledWith('query', 3);
126
- expect(queryStore.getSessionEvents).toHaveBeenCalledWith('session-1');
127
- expect(queryStore.getRecentEvents).toHaveBeenCalledWith(2);
128
- });
129
- });
@@ -1,201 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
-
3
- import {
4
- createMemoryRuntimeService,
5
- type MemoryRuntimeServicesFactories
6
- } from '../../src/core/engine/memory-runtime-service.js';
7
- import type { EventStore } from '../../src/core/event-store.js';
8
- import type { Embedder } from '../../src/core/embedder.js';
9
- import type { GraduationPipeline } from '../../src/core/graduation.js';
10
- import type { Retriever } from '../../src/core/retriever.js';
11
- import type { VectorStore } from '../../src/core/vector-store.js';
12
-
13
- function makeHarness(options?: { readOnly?: boolean; lightweightMode?: boolean; embeddingOnly?: boolean }) {
14
- const calls: string[] = [];
15
- const eventStore = { marker: 'event-store' } as unknown as EventStore;
16
- const vectorStore = {
17
- initialize: async () => { calls.push('vector.initialize'); }
18
- } as unknown as VectorStore;
19
- const embedder = {
20
- initialize: async () => { calls.push('embedder.initialize'); }
21
- } as unknown as Embedder;
22
- const graduation = {
23
- marker: 'graduation',
24
- recordAccess: (eventId: string, sessionId: string, confidence: number = 1.0) => {
25
- calls.push(`graduation.recordAccess:${eventId}:${sessionId}:${confidence}`);
26
- }
27
- } as unknown as GraduationPipeline;
28
- const retriever = {
29
- setGraduationPipeline: (pipeline: GraduationPipeline) => {
30
- calls.push(pipeline === graduation ? 'retriever.setGraduationPipeline' : 'retriever.setGraduationPipeline:unknown');
31
- }
32
- } as unknown as Retriever;
33
-
34
- const vectorWorker = {
35
- start: () => { calls.push('vectorWorker.start'); },
36
- stop: () => { calls.push('vectorWorker.stop'); },
37
- processAll: async () => {
38
- calls.push('vectorWorker.processAll');
39
- return 3;
40
- }
41
- };
42
- const graduationWorker = {
43
- start: () => { calls.push('graduationWorker.start'); },
44
- stop: () => { calls.push('graduationWorker.stop'); },
45
- forceRun: async () => {
46
- calls.push('graduationWorker.forceRun');
47
- return { evaluated: 2, graduated: 1, byLevel: { L0: 1 } };
48
- }
49
- };
50
-
51
- const factories: MemoryRuntimeServicesFactories = {
52
- createVectorWorker: (receivedEventStore, receivedVectorStore, receivedEmbedder) => {
53
- calls.push(
54
- receivedEventStore === eventStore && receivedVectorStore === vectorStore && receivedEmbedder === embedder
55
- ? 'createVectorWorker'
56
- : 'createVectorWorker:unknown'
57
- );
58
- return vectorWorker as unknown as ReturnType<NonNullable<MemoryRuntimeServicesFactories['createVectorWorker']>>;
59
- },
60
- createGraduationWorker: (receivedEventStore, receivedGraduation) => {
61
- calls.push(
62
- receivedEventStore === eventStore && receivedGraduation === graduation
63
- ? 'createGraduationWorker'
64
- : 'createGraduationWorker:unknown'
65
- );
66
- return graduationWorker as unknown as ReturnType<NonNullable<MemoryRuntimeServicesFactories['createGraduationWorker']>>;
67
- }
68
- };
69
-
70
- const service = createMemoryRuntimeService({
71
- sqliteStore: {
72
- initialize: async () => { calls.push('sqlite.initialize'); },
73
- close: async () => { calls.push('sqlite.close'); }
74
- },
75
- eventStore,
76
- vectorStore,
77
- embedder,
78
- retriever,
79
- graduation,
80
- endlessMemoryServices: {
81
- initializeFromSavedMode: async () => { calls.push('endless.initializeFromSavedMode'); },
82
- shutdown: () => { calls.push('endless.shutdown'); }
83
- },
84
- sharedMemoryServices: {
85
- initialize: async () => { calls.push('shared.initialize'); },
86
- close: async () => { calls.push('shared.close'); }
87
- },
88
- readOnly: options?.readOnly ?? false,
89
- lightweightMode: options?.lightweightMode ?? false,
90
- embeddingOnly: options?.embeddingOnly ?? false,
91
- factories
92
- });
93
-
94
- return { service, calls, vectorWorker };
95
- }
96
-
97
- describe('createMemoryRuntimeService', () => {
98
- it('initializes only sqlite in lightweight mode and keeps initialize idempotent', async () => {
99
- const harness = makeHarness({ lightweightMode: true });
100
-
101
- await harness.service.initialize();
102
- await harness.service.initialize();
103
-
104
- expect(harness.service.isInitialized()).toBe(true);
105
- expect(harness.calls).toEqual(['sqlite.initialize']);
106
- await expect(harness.service.processPendingEmbeddings()).resolves.toBe(0);
107
- await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
108
- });
109
-
110
- it('records memory access through the graduation pipeline without initializing runtime workers', () => {
111
- const harness = makeHarness();
112
-
113
- harness.service.recordMemoryAccess('event-1', 'session-2', 0.42);
114
-
115
- expect(harness.service.isInitialized()).toBe(false);
116
- expect(harness.calls).toEqual(['graduation.recordAccess:event-1:session-2:0.42']);
117
- });
118
-
119
- it('starts vector and graduation workers plus writable lifecycle services by default', async () => {
120
- const harness = makeHarness();
121
-
122
- await harness.service.initialize();
123
-
124
- expect(harness.calls).toEqual([
125
- 'sqlite.initialize',
126
- 'vector.initialize',
127
- 'embedder.initialize',
128
- 'createVectorWorker',
129
- 'vectorWorker.start',
130
- 'retriever.setGraduationPipeline',
131
- 'createGraduationWorker',
132
- 'graduationWorker.start',
133
- 'endless.initializeFromSavedMode',
134
- 'shared.initialize'
135
- ]);
136
- expect(harness.service.getVectorWorker()).toBe(harness.vectorWorker);
137
- await expect(harness.service.processPendingEmbeddings()).resolves.toBe(3);
138
- await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 2, graduated: 1, byLevel: { L0: 1 } });
139
- });
140
-
141
- it('skips workers and write lifecycle services in read-only mode', async () => {
142
- const harness = makeHarness({ readOnly: true });
143
-
144
- await harness.service.initialize();
145
-
146
- expect(harness.calls).toEqual([
147
- 'sqlite.initialize',
148
- 'vector.initialize',
149
- 'embedder.initialize'
150
- ]);
151
- expect(harness.service.getVectorWorker()).toBeNull();
152
- });
153
-
154
- it('embedding-only mode starts vector worker but skips graduation worker', async () => {
155
- const harness = makeHarness({ embeddingOnly: true });
156
-
157
- await harness.service.initialize();
158
-
159
- expect(harness.calls).toEqual([
160
- 'sqlite.initialize',
161
- 'vector.initialize',
162
- 'embedder.initialize',
163
- 'createVectorWorker',
164
- 'vectorWorker.start',
165
- 'endless.initializeFromSavedMode',
166
- 'shared.initialize'
167
- ]);
168
- await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
169
- });
170
-
171
- it('returns a fresh empty graduation result when no graduation worker exists', async () => {
172
- const harness = makeHarness({ embeddingOnly: true });
173
- await harness.service.initialize();
174
-
175
- const first = await harness.service.forceGraduation();
176
- first.byLevel.L0 = 99;
177
- first.evaluated = 99;
178
-
179
- const second = await harness.service.forceGraduation();
180
-
181
- expect(second).toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
182
- expect(second).not.toBe(first);
183
- expect(second.byLevel).not.toBe(first.byLevel);
184
- });
185
-
186
- it('shuts down workers and backing services in the historical MemoryService order', async () => {
187
- const harness = makeHarness();
188
- await harness.service.initialize();
189
- harness.calls.length = 0;
190
-
191
- await harness.service.shutdown();
192
-
193
- expect(harness.calls).toEqual([
194
- 'graduationWorker.stop',
195
- 'endless.shutdown',
196
- 'vectorWorker.stop',
197
- 'shared.close',
198
- 'sqlite.close'
199
- ]);
200
- });
201
- });