memento-mcp-server 1.6.0 → 1.7.2

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 (560) hide show
  1. package/INSTALL.en.md +303 -303
  2. package/INSTALL.md +303 -303
  3. package/README.en.md +331 -330
  4. package/README.md +432 -432
  5. package/dist/algorithms/hybrid-search-engine.d.ts +114 -44
  6. package/dist/algorithms/hybrid-search-engine.d.ts.map +1 -1
  7. package/dist/algorithms/hybrid-search-engine.js +261 -235
  8. package/dist/algorithms/hybrid-search-engine.js.map +1 -1
  9. package/dist/algorithms/search-engine.d.ts +2 -14
  10. package/dist/algorithms/search-engine.d.ts.map +1 -1
  11. package/dist/algorithms/search-engine.js +43 -35
  12. package/dist/algorithms/search-engine.js.map +1 -1
  13. package/dist/algorithms/vector-search-engine-migration.d.ts +67 -0
  14. package/dist/algorithms/vector-search-engine-migration.d.ts.map +1 -0
  15. package/dist/algorithms/vector-search-engine-migration.js +196 -0
  16. package/dist/algorithms/vector-search-engine-migration.js.map +1 -0
  17. package/dist/algorithms/vector-search-engine-refactored.d.ts +56 -0
  18. package/dist/algorithms/vector-search-engine-refactored.d.ts.map +1 -0
  19. package/dist/algorithms/vector-search-engine-refactored.js +101 -0
  20. package/dist/algorithms/vector-search-engine-refactored.js.map +1 -0
  21. package/dist/algorithms/vector-search-engine.d.ts +9 -2
  22. package/dist/algorithms/vector-search-engine.d.ts.map +1 -1
  23. package/dist/algorithms/vector-search-engine.js +245 -121
  24. package/dist/algorithms/vector-search-engine.js.map +1 -1
  25. package/dist/client/index.d.ts.map +1 -1
  26. package/dist/client/index.js +34 -11
  27. package/dist/client/index.js.map +1 -1
  28. package/dist/config/environment.d.ts +26 -0
  29. package/dist/config/environment.d.ts.map +1 -0
  30. package/dist/config/environment.js +103 -0
  31. package/dist/config/environment.js.map +1 -0
  32. package/dist/config/index.d.ts.map +1 -1
  33. package/dist/config/index.js +29 -50
  34. package/dist/config/index.js.map +1 -1
  35. package/dist/config/vector-search.config.d.ts +25 -0
  36. package/dist/config/vector-search.config.d.ts.map +1 -0
  37. package/dist/config/vector-search.config.js +40 -0
  38. package/dist/config/vector-search.config.js.map +1 -0
  39. package/dist/database/init.d.ts.map +1 -1
  40. package/dist/database/init.js +154 -17
  41. package/dist/database/init.js.map +1 -1
  42. package/dist/database/migrate.d.ts +2 -1
  43. package/dist/database/migrate.d.ts.map +1 -1
  44. package/dist/database/migrate.js +191 -18
  45. package/dist/database/migrate.js.map +1 -1
  46. package/dist/database/schema.sql +234 -159
  47. package/dist/factories/hybrid-search.factory.d.ts +20 -0
  48. package/dist/factories/hybrid-search.factory.d.ts.map +1 -0
  49. package/dist/factories/hybrid-search.factory.js +57 -0
  50. package/dist/factories/hybrid-search.factory.js.map +1 -0
  51. package/dist/factories/spaced-repetition.factory.d.ts +48 -0
  52. package/dist/factories/spaced-repetition.factory.d.ts.map +1 -0
  53. package/dist/factories/spaced-repetition.factory.js +187 -0
  54. package/dist/factories/spaced-repetition.factory.js.map +1 -0
  55. package/dist/factories/vector-search.factory.d.ts +25 -0
  56. package/dist/factories/vector-search.factory.d.ts.map +1 -0
  57. package/dist/factories/vector-search.factory.js +47 -0
  58. package/dist/factories/vector-search.factory.js.map +1 -0
  59. package/dist/interfaces/database.interface.d.ts +36 -0
  60. package/dist/interfaces/database.interface.d.ts.map +1 -0
  61. package/dist/interfaces/database.interface.js +6 -0
  62. package/dist/interfaces/database.interface.js.map +1 -0
  63. package/dist/interfaces/spaced-repetition.interface.d.ts +63 -0
  64. package/dist/interfaces/spaced-repetition.interface.d.ts.map +1 -0
  65. package/dist/interfaces/spaced-repetition.interface.js +6 -0
  66. package/dist/interfaces/spaced-repetition.interface.js.map +1 -0
  67. package/dist/repositories/vector-performance.repository.d.ts +25 -0
  68. package/dist/repositories/vector-performance.repository.d.ts.map +1 -0
  69. package/dist/repositories/vector-performance.repository.js +134 -0
  70. package/dist/repositories/vector-performance.repository.js.map +1 -0
  71. package/dist/repositories/vector-search.repository.d.ts +43 -0
  72. package/dist/repositories/vector-search.repository.d.ts.map +1 -0
  73. package/dist/repositories/vector-search.repository.js +377 -0
  74. package/dist/repositories/vector-search.repository.js.map +1 -0
  75. package/dist/server/http-server.d.ts.map +1 -1
  76. package/dist/server/http-server.js +25 -24
  77. package/dist/server/http-server.js.map +1 -1
  78. package/dist/server/index.d.ts +1 -0
  79. package/dist/server/index.d.ts.map +1 -1
  80. package/dist/server/index.js +7 -7
  81. package/dist/server/index.js.map +1 -1
  82. package/dist/services/alert-notification-service.d.ts +16 -0
  83. package/dist/services/alert-notification-service.d.ts.map +1 -0
  84. package/dist/services/alert-notification-service.js +44 -0
  85. package/dist/services/alert-notification-service.js.map +1 -0
  86. package/dist/services/async-optimizer.d.ts +62 -8
  87. package/dist/services/async-optimizer.d.ts.map +1 -1
  88. package/dist/services/async-optimizer.js +137 -8
  89. package/dist/services/async-optimizer.js.map +1 -1
  90. package/dist/services/batch-scheduler.d.ts +6 -0
  91. package/dist/services/batch-scheduler.d.ts.map +1 -1
  92. package/dist/services/batch-scheduler.js +59 -19
  93. package/dist/services/batch-scheduler.js.map +1 -1
  94. package/dist/services/cache-service.d.ts +32 -0
  95. package/dist/services/cache-service.d.ts.map +1 -1
  96. package/dist/services/cache-service.js +81 -6
  97. package/dist/services/cache-service.js.map +1 -1
  98. package/dist/services/database-optimizer.js +63 -63
  99. package/dist/services/database-optimizer.js.map +1 -1
  100. package/dist/services/embedding-migration-service.d.ts +24 -0
  101. package/dist/services/embedding-migration-service.d.ts.map +1 -0
  102. package/dist/services/embedding-migration-service.js +360 -0
  103. package/dist/services/embedding-migration-service.js.map +1 -0
  104. package/dist/services/embedding-provider-factory.d.ts +12 -5
  105. package/dist/services/embedding-provider-factory.d.ts.map +1 -1
  106. package/dist/services/embedding-provider-factory.js +107 -26
  107. package/dist/services/embedding-provider-factory.js.map +1 -1
  108. package/dist/services/forgetting-policy-service.js +17 -17
  109. package/dist/services/gemini-embedding-service.d.ts +1 -1
  110. package/dist/services/gemini-embedding-service.d.ts.map +1 -1
  111. package/dist/services/gemini-embedding-service.js +25 -18
  112. package/dist/services/gemini-embedding-service.js.map +1 -1
  113. package/dist/services/memory-embedding-service.d.ts +8 -0
  114. package/dist/services/memory-embedding-service.d.ts.map +1 -1
  115. package/dist/services/memory-embedding-service.js +180 -71
  116. package/dist/services/memory-embedding-service.js.map +1 -1
  117. package/dist/services/migration-history-service.d.ts +14 -0
  118. package/dist/services/migration-history-service.d.ts.map +1 -0
  119. package/dist/services/migration-history-service.js +270 -0
  120. package/dist/services/migration-history-service.js.map +1 -0
  121. package/dist/services/migration-monitor-service.d.ts +24 -0
  122. package/dist/services/migration-monitor-service.d.ts.map +1 -0
  123. package/dist/services/migration-monitor-service.js +93 -0
  124. package/dist/services/migration-monitor-service.js.map +1 -0
  125. package/dist/services/model-availability-service.d.ts +22 -0
  126. package/dist/services/model-availability-service.d.ts.map +1 -0
  127. package/dist/services/model-availability-service.js +140 -0
  128. package/dist/services/model-availability-service.js.map +1 -0
  129. package/dist/services/openai-embedding-service.d.ts +36 -0
  130. package/dist/services/openai-embedding-service.d.ts.map +1 -0
  131. package/dist/services/openai-embedding-service.js +192 -0
  132. package/dist/services/openai-embedding-service.js.map +1 -0
  133. package/dist/services/performance-monitor.d.ts +154 -10
  134. package/dist/services/performance-monitor.d.ts.map +1 -1
  135. package/dist/services/performance-monitor.js +446 -60
  136. package/dist/services/performance-monitor.js.map +1 -1
  137. package/dist/services/spaced-repetition/interval-calculation.service.d.ts +38 -0
  138. package/dist/services/spaced-repetition/interval-calculation.service.d.ts.map +1 -0
  139. package/dist/services/spaced-repetition/interval-calculation.service.js +105 -0
  140. package/dist/services/spaced-repetition/interval-calculation.service.js.map +1 -0
  141. package/dist/services/spaced-repetition/optimal-interval.service.d.ts +56 -0
  142. package/dist/services/spaced-repetition/optimal-interval.service.d.ts.map +1 -0
  143. package/dist/services/spaced-repetition/optimal-interval.service.js +163 -0
  144. package/dist/services/spaced-repetition/optimal-interval.service.js.map +1 -0
  145. package/dist/services/spaced-repetition/performance-analysis.service.d.ts +48 -0
  146. package/dist/services/spaced-repetition/performance-analysis.service.d.ts.map +1 -0
  147. package/dist/services/spaced-repetition/performance-analysis.service.js +174 -0
  148. package/dist/services/spaced-repetition/performance-analysis.service.js.map +1 -0
  149. package/dist/services/spaced-repetition/priority-calculation.service.d.ts +53 -0
  150. package/dist/services/spaced-repetition/priority-calculation.service.d.ts.map +1 -0
  151. package/dist/services/spaced-repetition/priority-calculation.service.js +161 -0
  152. package/dist/services/spaced-repetition/priority-calculation.service.js.map +1 -0
  153. package/dist/services/spaced-repetition/recall-probability.service.d.ts +36 -0
  154. package/dist/services/spaced-repetition/recall-probability.service.d.ts.map +1 -0
  155. package/dist/services/spaced-repetition/recall-probability.service.js +88 -0
  156. package/dist/services/spaced-repetition/recall-probability.service.js.map +1 -0
  157. package/dist/services/spaced-repetition/review-scheduling.service.d.ts +43 -0
  158. package/dist/services/spaced-repetition/review-scheduling.service.d.ts.map +1 -0
  159. package/dist/services/spaced-repetition/review-scheduling.service.js +130 -0
  160. package/dist/services/spaced-repetition/review-scheduling.service.js.map +1 -0
  161. package/dist/services/spaced-repetition/spaced-repetition-container.d.ts +69 -0
  162. package/dist/services/spaced-repetition/spaced-repetition-container.d.ts.map +1 -0
  163. package/dist/services/spaced-repetition/spaced-repetition-container.js +136 -0
  164. package/dist/services/spaced-repetition/spaced-repetition-container.js.map +1 -0
  165. package/dist/services/unified-embedding-service.d.ts +3 -0
  166. package/dist/services/unified-embedding-service.d.ts.map +1 -1
  167. package/dist/services/unified-embedding-service.js +58 -62
  168. package/dist/services/unified-embedding-service.js.map +1 -1
  169. package/dist/services/vector-compatibility-service.d.ts +68 -0
  170. package/dist/services/vector-compatibility-service.d.ts.map +1 -0
  171. package/dist/services/vector-compatibility-service.js +373 -0
  172. package/dist/services/vector-compatibility-service.js.map +1 -0
  173. package/dist/services/vector-search/vector-index-manager.d.ts +27 -0
  174. package/dist/services/vector-search/vector-index-manager.d.ts.map +1 -0
  175. package/dist/services/vector-search/vector-index-manager.js +66 -0
  176. package/dist/services/vector-search/vector-index-manager.js.map +1 -0
  177. package/dist/services/vector-search/vector-performance-tester.d.ts +30 -0
  178. package/dist/services/vector-search/vector-performance-tester.d.ts.map +1 -0
  179. package/dist/services/vector-search/vector-performance-tester.js +87 -0
  180. package/dist/services/vector-search/vector-performance-tester.js.map +1 -0
  181. package/dist/services/vector-search/vector-search-container.d.ts +41 -0
  182. package/dist/services/vector-search/vector-search-container.d.ts.map +1 -0
  183. package/dist/services/vector-search/vector-search-container.js +74 -0
  184. package/dist/services/vector-search/vector-search-container.js.map +1 -0
  185. package/dist/services/vector-search/vector-search-facade.d.ts +63 -0
  186. package/dist/services/vector-search/vector-search-facade.d.ts.map +1 -0
  187. package/dist/services/vector-search/vector-search-facade.js +91 -0
  188. package/dist/services/vector-search/vector-search-facade.js.map +1 -0
  189. package/dist/services/vector-search/vector-search-result-normalizer.d.ts +6 -0
  190. package/dist/services/vector-search/vector-search-result-normalizer.d.ts.map +1 -0
  191. package/dist/services/vector-search/vector-search-result-normalizer.js +65 -0
  192. package/dist/services/vector-search/vector-search-result-normalizer.js.map +1 -0
  193. package/dist/services/vector-search/vector-search.service.d.ts +33 -0
  194. package/dist/services/vector-search/vector-search.service.d.ts.map +1 -0
  195. package/dist/services/vector-search/vector-search.service.js +149 -0
  196. package/dist/services/vector-search/vector-search.service.js.map +1 -0
  197. package/dist/tools/forget-tool.js +14 -14
  198. package/dist/tools/pin-tool.js +14 -14
  199. package/dist/tools/unpin-tool.js +21 -21
  200. package/dist/types/alerts.types.d.ts +26 -0
  201. package/dist/types/alerts.types.d.ts.map +1 -0
  202. package/dist/types/alerts.types.js +2 -0
  203. package/dist/types/alerts.types.js.map +1 -0
  204. package/dist/types/embedding-provider-monitoring.types.d.ts +24 -0
  205. package/dist/types/embedding-provider-monitoring.types.d.ts.map +1 -0
  206. package/dist/types/embedding-provider-monitoring.types.js +2 -0
  207. package/dist/types/embedding-provider-monitoring.types.js.map +1 -0
  208. package/dist/types/embedding.types.d.ts +36 -1
  209. package/dist/types/embedding.types.d.ts.map +1 -1
  210. package/dist/types/migration.types.d.ts +131 -0
  211. package/dist/types/migration.types.d.ts.map +1 -0
  212. package/dist/types/migration.types.js +6 -0
  213. package/dist/types/migration.types.js.map +1 -0
  214. package/dist/types/spaced-repetition.types.d.ts +61 -0
  215. package/dist/types/spaced-repetition.types.d.ts.map +1 -0
  216. package/dist/types/spaced-repetition.types.js +6 -0
  217. package/dist/types/spaced-repetition.types.js.map +1 -0
  218. package/dist/types/vector-search.types.d.ts +96 -0
  219. package/dist/types/vector-search.types.d.ts.map +1 -0
  220. package/dist/types/vector-search.types.js +2 -0
  221. package/dist/types/vector-search.types.js.map +1 -0
  222. package/dist/utils/configuration-validator.d.ts +23 -0
  223. package/dist/utils/configuration-validator.d.ts.map +1 -0
  224. package/dist/utils/configuration-validator.js +102 -0
  225. package/dist/utils/configuration-validator.js.map +1 -0
  226. package/dist/utils/database.d.ts.map +1 -1
  227. package/dist/utils/database.js +101 -95
  228. package/dist/utils/database.js.map +1 -1
  229. package/dist/utils/environment-check.d.ts +8 -0
  230. package/dist/utils/environment-check.d.ts.map +1 -0
  231. package/dist/utils/environment-check.js +25 -0
  232. package/dist/utils/environment-check.js.map +1 -0
  233. package/dist/utils/logger.d.ts +8 -0
  234. package/dist/utils/logger.d.ts.map +1 -0
  235. package/dist/utils/logger.js +33 -0
  236. package/dist/utils/logger.js.map +1 -0
  237. package/package.json +139 -125
  238. package/scripts/auto-setup.js +233 -233
  239. package/scripts/backup-daily.bat +28 -28
  240. package/scripts/backup-embeddings.js +108 -108
  241. package/scripts/check-db-integrity.js +93 -93
  242. package/scripts/debug-embeddings.js +184 -184
  243. package/scripts/direct-sql-migration.sql +36 -36
  244. package/scripts/docker-migration.sh +105 -105
  245. package/scripts/fix-migration.js +93 -93
  246. package/scripts/fix-vector-dimensions.js +206 -206
  247. package/scripts/migrate-embedding-data.js +307 -307
  248. package/scripts/regenerate-embeddings.js +144 -144
  249. package/scripts/restore-legacy.ps1 +60 -60
  250. package/scripts/run-migration.js +122 -122
  251. package/scripts/safe-migration.js +150 -150
  252. package/scripts/simple-migrate.js +41 -41
  253. package/scripts/simple-update.js +123 -123
  254. package/src/database/schema.sql +234 -159
  255. package/.cursor/rules/cache-management.mdc +0 -171
  256. package/.cursor/rules/database-schema.mdc +0 -344
  257. package/.cursor/rules/deployment.mdc +0 -596
  258. package/.cursor/rules/error-logging.mdc +0 -298
  259. package/.cursor/rules/forgetting-algorithms.mdc +0 -426
  260. package/.cursor/rules/http-server.mdc +0 -432
  261. package/.cursor/rules/hybrid-search.mdc +0 -424
  262. package/.cursor/rules/implementation.mdc +0 -369
  263. package/.cursor/rules/lightweight-embedding.mdc +0 -178
  264. package/.cursor/rules/mcp-client-development.mdc +0 -0
  265. package/.cursor/rules/mcp-server-development.mdc +0 -0
  266. package/.cursor/rules/mcp-tools-architecture.mdc +0 -205
  267. package/.cursor/rules/memento-memory-rule.mdc +0 -8
  268. package/.cursor/rules/memento-project-overview.mdc +0 -0
  269. package/.cursor/rules/memory-algorithms.mdc +0 -502
  270. package/.cursor/rules/monitoring.mdc +0 -622
  271. package/.cursor/rules/performance-alerts.mdc +0 -537
  272. package/.cursor/rules/performance-monitoring.mdc +0 -345
  273. package/.cursor/rules/performance-optimization.mdc +0 -563
  274. package/.cursor/rules/project-structure.mdc +0 -310
  275. package/.cursor/rules/testing.mdc +0 -473
  276. package/.dockerignore +0 -15
  277. package/.eslintrc.json +0 -34
  278. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -51
  279. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -45
  280. package/.github/ISSUE_TEMPLATE/question.md +0 -31
  281. package/.github/PULL_REQUEST_TEMPLATE.md +0 -97
  282. package/AGENTS.md +0 -28
  283. package/CHANGELOG.md +0 -416
  284. package/CODE_OF_CONDUCT.md +0 -62
  285. package/CONTRIBUTING.md +0 -165
  286. package/DOCKER_SETUP_GUIDE.md +0 -84
  287. package/Dockerfile +0 -90
  288. package/backup/legacy-removal-20250930-201816/http-server-legacy.ts +0 -1068
  289. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.ps1 +0 -46
  290. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.sh +0 -48
  291. package/dist/server/index-backup.d.ts +0 -5
  292. package/dist/server/index-backup.d.ts.map +0 -1
  293. package/dist/server/index-backup.js +0 -793
  294. package/dist/server/index-backup.js.map +0 -1
  295. package/dist/server/index-refactored.d.ts +0 -6
  296. package/dist/server/index-refactored.d.ts.map +0 -1
  297. package/dist/server/index-refactored.js +0 -206
  298. package/dist/server/index-refactored.js.map +0 -1
  299. package/dist/services/performance-monitoring-integration.d.ts +0 -77
  300. package/dist/services/performance-monitoring-integration.d.ts.map +0 -1
  301. package/dist/services/performance-monitoring-integration.js +0 -177
  302. package/dist/services/performance-monitoring-integration.js.map +0 -1
  303. package/dist/test/debug-http-v2.d.ts +0 -5
  304. package/dist/test/debug-http-v2.d.ts.map +0 -1
  305. package/dist/test/debug-http-v2.js +0 -28
  306. package/dist/test/debug-http-v2.js.map +0 -1
  307. package/dist/test/performance-benchmark.d.ts +0 -57
  308. package/dist/test/performance-benchmark.d.ts.map +0 -1
  309. package/dist/test/performance-benchmark.js +0 -427
  310. package/dist/test/performance-benchmark.js.map +0 -1
  311. package/dist/test/test-alerts-direct.d.ts +0 -7
  312. package/dist/test/test-alerts-direct.d.ts.map +0 -1
  313. package/dist/test/test-alerts-direct.js +0 -101
  314. package/dist/test/test-alerts-direct.js.map +0 -1
  315. package/dist/test/test-batch-scheduler.d.ts +0 -2
  316. package/dist/test/test-batch-scheduler.d.ts.map +0 -1
  317. package/dist/test/test-batch-scheduler.js +0 -156
  318. package/dist/test/test-batch-scheduler.js.map +0 -1
  319. package/dist/test/test-client.d.ts +0 -5
  320. package/dist/test/test-client.d.ts.map +0 -1
  321. package/dist/test/test-client.js +0 -86
  322. package/dist/test/test-client.js.map +0 -1
  323. package/dist/test/test-embedding.d.ts +0 -6
  324. package/dist/test/test-embedding.d.ts.map +0 -1
  325. package/dist/test/test-embedding.js +0 -142
  326. package/dist/test/test-embedding.js.map +0 -1
  327. package/dist/test/test-error-logging.d.ts +0 -7
  328. package/dist/test/test-error-logging.d.ts.map +0 -1
  329. package/dist/test/test-error-logging.js +0 -105
  330. package/dist/test/test-error-logging.js.map +0 -1
  331. package/dist/test/test-forgetting.d.ts +0 -6
  332. package/dist/test/test-forgetting.d.ts.map +0 -1
  333. package/dist/test/test-forgetting.js +0 -154
  334. package/dist/test/test-forgetting.js.map +0 -1
  335. package/dist/test/test-gemini-embedding.d.ts +0 -7
  336. package/dist/test/test-gemini-embedding.d.ts.map +0 -1
  337. package/dist/test/test-gemini-embedding.js +0 -134
  338. package/dist/test/test-gemini-embedding.js.map +0 -1
  339. package/dist/test/test-http-server-v2-simple.d.ts +0 -6
  340. package/dist/test/test-http-server-v2-simple.d.ts.map +0 -1
  341. package/dist/test/test-http-server-v2-simple.js +0 -131
  342. package/dist/test/test-http-server-v2-simple.js.map +0 -1
  343. package/dist/test/test-http-server-v2.d.ts +0 -7
  344. package/dist/test/test-http-server-v2.d.ts.map +0 -1
  345. package/dist/test/test-http-server-v2.js +0 -529
  346. package/dist/test/test-http-server-v2.js.map +0 -1
  347. package/dist/test/test-lightweight-embedding.d.ts +0 -6
  348. package/dist/test/test-lightweight-embedding.d.ts.map +0 -1
  349. package/dist/test/test-lightweight-embedding.js +0 -189
  350. package/dist/test/test-lightweight-embedding.js.map +0 -1
  351. package/dist/test/test-m1-completion.d.ts +0 -7
  352. package/dist/test/test-m1-completion.d.ts.map +0 -1
  353. package/dist/test/test-m1-completion.js +0 -124
  354. package/dist/test/test-m1-completion.js.map +0 -1
  355. package/dist/test/test-memory-injection-prompt.d.ts +0 -2
  356. package/dist/test/test-memory-injection-prompt.d.ts.map +0 -1
  357. package/dist/test/test-memory-injection-prompt.js +0 -299
  358. package/dist/test/test-memory-injection-prompt.js.map +0 -1
  359. package/dist/test/test-performance-alerts.d.ts +0 -7
  360. package/dist/test/test-performance-alerts.d.ts.map +0 -1
  361. package/dist/test/test-performance-alerts.js +0 -109
  362. package/dist/test/test-performance-alerts.js.map +0 -1
  363. package/dist/test/test-performance-monitor.d.ts +0 -2
  364. package/dist/test/test-performance-monitor.d.ts.map +0 -1
  365. package/dist/test/test-performance-monitor.js +0 -182
  366. package/dist/test/test-performance-monitor.js.map +0 -1
  367. package/dist/test/test-performance-monitoring.d.ts +0 -6
  368. package/dist/test/test-performance-monitoring.d.ts.map +0 -1
  369. package/dist/test/test-performance-monitoring.js +0 -156
  370. package/dist/test/test-performance-monitoring.js.map +0 -1
  371. package/dist/test/test-search.d.ts +0 -5
  372. package/dist/test/test-search.d.ts.map +0 -1
  373. package/dist/test/test-search.js +0 -141
  374. package/dist/test/test-search.js.map +0 -1
  375. package/dist/test/test-simple-alerts.d.ts +0 -6
  376. package/dist/test/test-simple-alerts.d.ts.map +0 -1
  377. package/dist/test/test-simple-alerts.js +0 -106
  378. package/dist/test/test-simple-alerts.js.map +0 -1
  379. package/dist/test/test-vector-search-engine.d.ts +0 -2
  380. package/dist/test/test-vector-search-engine.d.ts.map +0 -1
  381. package/dist/test/test-vector-search-engine.js +0 -225
  382. package/dist/test/test-vector-search-engine.js.map +0 -1
  383. package/docker-compose.dev.yml +0 -50
  384. package/docker-compose.prod.yml +0 -77
  385. package/docker-compose.yml +0 -43
  386. package/docs/en/Memento-Goals.md +0 -217
  387. package/docs/en/Memento-M1-DetailSpecs.md +0 -130
  388. package/docs/en/Memento-Milestones.md +0 -135
  389. package/docs/en/Search-Ranking-Memory-Decay-Formulas.md +0 -177
  390. package/docs/en/api-reference.md +0 -658
  391. package/docs/en/architecture.md +0 -1302
  392. package/docs/en/developer-guide.md +0 -1005
  393. package/docs/en/user-manual.md +0 -595
  394. package/docs/ko/Memento-Goals.md +0 -217
  395. package/docs/ko/Memento-M1-DetailSpecs.md +0 -130
  396. package/docs/ko/Memento-Milestones.md +0 -134
  397. package/docs/ko/Search-Ranking-Memory-Decay-Formulas.md +0 -177
  398. package/docs/ko/api-reference.md +0 -658
  399. package/docs/ko/architecture.md +0 -1302
  400. package/docs/ko/developer-guide.md +0 -1006
  401. package/docs/ko/embedding-api-reference.md +0 -122
  402. package/docs/ko/embedding-configuration.md +0 -62
  403. package/docs/ko/embedding-performance-benchmark.md +0 -62
  404. package/docs/ko/embedding-service-guide.md +0 -314
  405. package/docs/ko/user-manual.md +0 -595
  406. package/env.example +0 -49
  407. package/install.sh +0 -191
  408. package/mcp-http-client.js +0 -218
  409. package/mcp.json +0 -0
  410. package/packages/mcp-client/docs/API-REFERENCE.md +0 -560
  411. package/packages/mcp-client/docs/BEST-PRACTICES.md +0 -564
  412. package/packages/mcp-client/docs/MIGRATION-GUIDE.md +0 -344
  413. package/packages/mcp-client/docs/PERFORMANCE-GUIDE.md +0 -476
  414. package/packages/mcp-client/docs/TROUBLESHOOTING.md +0 -564
  415. package/packages/mcp-client/package-lock.json +0 -907
  416. package/packages/mcp-client/package.json +0 -58
  417. package/packages/mcp-client/performance-optimizer.js +0 -428
  418. package/packages/mcp-client/test-basic.js +0 -65
  419. package/packages/mcp-client/test-integration.js +0 -366
  420. package/src/algorithms/forgetting-algorithm.spec.ts +0 -538
  421. package/src/algorithms/forgetting-algorithm.ts +0 -243
  422. package/src/algorithms/hybrid-search-engine.spec.ts +0 -484
  423. package/src/algorithms/hybrid-search-engine.ts +0 -489
  424. package/src/algorithms/search-engine.spec.ts +0 -429
  425. package/src/algorithms/search-engine.ts +0 -392
  426. package/src/algorithms/search-ranking.spec.ts +0 -293
  427. package/src/algorithms/search-ranking.ts +0 -407
  428. package/src/algorithms/spaced-repetition.spec.ts +0 -510
  429. package/src/algorithms/spaced-repetition.ts +0 -238
  430. package/src/algorithms/vector-search-engine.ts +0 -505
  431. package/src/client/index.spec.ts +0 -427
  432. package/src/client/index.ts +0 -222
  433. package/src/config/index.spec.ts +0 -339
  434. package/src/config/index.ts +0 -106
  435. package/src/database/init.spec.ts +0 -239
  436. package/src/database/init.ts +0 -130
  437. package/src/database/migrate.spec.ts +0 -293
  438. package/src/database/migrate.ts +0 -94
  439. package/src/database/migrations/001_add_embedding_metadata.sql +0 -29
  440. package/src/npm-client/context-injector.spec.ts +0 -335
  441. package/src/npm-client/context-injector.ts +0 -412
  442. package/src/npm-client/index.spec.ts +0 -108
  443. package/src/npm-client/index.ts +0 -96
  444. package/src/npm-client/memento-client.spec.ts +0 -549
  445. package/src/npm-client/memento-client.ts +0 -501
  446. package/src/npm-client/memory-manager.spec.ts +0 -374
  447. package/src/npm-client/memory-manager.ts +0 -414
  448. package/src/npm-client/types.spec.ts +0 -427
  449. package/src/npm-client/types.ts +0 -296
  450. package/src/npm-client/utils.spec.ts +0 -355
  451. package/src/npm-client/utils.ts +0 -423
  452. package/src/scripts/copy-assets.js +0 -37
  453. package/src/server/http-server.spec.ts +0 -648
  454. package/src/server/http-server.ts +0 -1030
  455. package/src/server/index-backup.ts +0 -875
  456. package/src/server/index-refactored.ts +0 -237
  457. package/src/server/index.spec.ts +0 -281
  458. package/src/server/index.ts +0 -347
  459. package/src/server/simple-mcp-server.spec.ts +0 -207
  460. package/src/server/simple-mcp-server.ts +0 -173
  461. package/src/services/async-optimizer.spec.ts +0 -569
  462. package/src/services/async-optimizer.ts +0 -484
  463. package/src/services/batch-scheduler.ts +0 -759
  464. package/src/services/cache-service.spec.ts +0 -372
  465. package/src/services/cache-service.ts +0 -434
  466. package/src/services/database-optimizer.spec.ts +0 -344
  467. package/src/services/database-optimizer.ts +0 -450
  468. package/src/services/embedding-provider-factory.ts +0 -173
  469. package/src/services/embedding-service.spec.ts +0 -342
  470. package/src/services/embedding-service.ts +0 -333
  471. package/src/services/error-logging-service.spec.ts +0 -416
  472. package/src/services/error-logging-service.ts +0 -383
  473. package/src/services/forgetting-policy-service.spec.ts +0 -140
  474. package/src/services/forgetting-policy-service.ts +0 -334
  475. package/src/services/gemini-embedding-service.spec.ts +0 -463
  476. package/src/services/gemini-embedding-service.ts +0 -283
  477. package/src/services/lightweight-embedding-service.spec.ts +0 -458
  478. package/src/services/lightweight-embedding-service.ts +0 -324
  479. package/src/services/memory-embedding-service.spec.ts +0 -417
  480. package/src/services/memory-embedding-service.ts +0 -289
  481. package/src/services/minilm-embedding-service.spec.ts +0 -104
  482. package/src/services/minilm-embedding-service.ts +0 -262
  483. package/src/services/performance-alert-service.spec.ts +0 -517
  484. package/src/services/performance-alert-service.ts +0 -477
  485. package/src/services/performance-monitor.spec.ts +0 -401
  486. package/src/services/performance-monitor.ts +0 -532
  487. package/src/services/performance-monitoring-integration.spec.ts +0 -478
  488. package/src/services/performance-monitoring-integration.ts.bak +0 -276
  489. package/src/services/unified-embedding-service.spec.ts +0 -224
  490. package/src/services/unified-embedding-service.ts +0 -255
  491. package/src/test/debug-http-v2.ts +0 -30
  492. package/src/test/embedding-integration-test.spec.ts +0 -295
  493. package/src/test/embedding-integration-test.ts +0 -295
  494. package/src/test/embedding-performance-benchmark.spec.ts +0 -354
  495. package/src/test/embedding-performance-benchmark.ts +0 -312
  496. package/src/test/performance-benchmark.ts +0 -565
  497. package/src/test/test-alerts-direct.ts +0 -136
  498. package/src/test/test-batch-scheduler-simple.spec.ts +0 -122
  499. package/src/test/test-batch-scheduler.spec.ts +0 -453
  500. package/src/test/test-batch-scheduler.ts +0 -182
  501. package/src/test/test-client.ts +0 -97
  502. package/src/test/test-embedding.ts +0 -153
  503. package/src/test/test-error-handling.spec.ts +0 -575
  504. package/src/test/test-error-logging.ts +0 -117
  505. package/src/test/test-forgetting.ts +0 -162
  506. package/src/test/test-gemini-embedding.ts +0 -159
  507. package/src/test/test-http-server-v2-simple.ts +0 -147
  508. package/src/test/test-http-server-v2.ts +0 -586
  509. package/src/test/test-hybrid-search-engine.spec.ts +0 -521
  510. package/src/test/test-integration-fixed.spec.ts +0 -612
  511. package/src/test/test-integration.spec.ts +0 -463
  512. package/src/test/test-lightweight-embedding.ts +0 -208
  513. package/src/test/test-m1-completion.spec.ts +0 -614
  514. package/src/test/test-m1-completion.ts +0 -141
  515. package/src/test/test-m1-integration.spec.ts +0 -514
  516. package/src/test/test-memory-injection-prompt.spec.ts +0 -650
  517. package/src/test/test-memory-injection-prompt.ts +0 -391
  518. package/src/test/test-performance-alerts.ts +0 -125
  519. package/src/test/test-performance-monitor-updates.spec.ts +0 -490
  520. package/src/test/test-performance-monitor.spec.ts +0 -284
  521. package/src/test/test-performance-monitor.ts +0 -228
  522. package/src/test/test-performance-monitoring.ts +0 -171
  523. package/src/test/test-search.ts +0 -151
  524. package/src/test/test-simple-alerts.ts +0 -136
  525. package/src/test/test-vector-search-engine.spec.ts +0 -408
  526. package/src/test/test-vector-search-engine.ts +0 -303
  527. package/src/tools/base-tool.ts +0 -189
  528. package/src/tools/cleanup-memory-tool.ts +0 -77
  529. package/src/tools/database-optimize-tool.ts +0 -79
  530. package/src/tools/error-stats.ts +0 -119
  531. package/src/tools/forget-tool.spec.ts +0 -613
  532. package/src/tools/forget-tool.ts +0 -454
  533. package/src/tools/forgetting-stats-tool.ts +0 -47
  534. package/src/tools/index.ts +0 -71
  535. package/src/tools/memory-injection-prompt.ts +0 -257
  536. package/src/tools/performance-alerts.ts +0 -226
  537. package/src/tools/performance-stats-tool.ts +0 -48
  538. package/src/tools/pin-tool.spec.ts +0 -497
  539. package/src/tools/pin-tool.ts +0 -277
  540. package/src/tools/recall-tool.spec.ts +0 -475
  541. package/src/tools/recall-tool.ts +0 -389
  542. package/src/tools/remember-tool.spec.ts +0 -469
  543. package/src/tools/remember-tool.ts +0 -112
  544. package/src/tools/resolve-error.ts +0 -69
  545. package/src/tools/tool-registry.ts +0 -417
  546. package/src/tools/types.ts +0 -63
  547. package/src/tools/unpin-tool.spec.ts +0 -549
  548. package/src/tools/unpin-tool.ts +0 -306
  549. package/src/types/embedding.types.ts +0 -78
  550. package/src/types/index.spec.ts +0 -420
  551. package/src/types/index.ts +0 -117
  552. package/src/utils/database.spec.ts +0 -77
  553. package/src/utils/database.ts +0 -458
  554. package/src/utils/stopwords.ts +0 -128
  555. package/start-docker-setup.bat +0 -38
  556. package/static/logo.png +0 -0
  557. package/static/memento_logo.svg +0 -2
  558. package/test-docker.js +0 -103
  559. package/tsconfig.json +0 -46
  560. package/vitest.config.ts +0 -23
@@ -1,463 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
2
- import Database from 'better-sqlite3';
3
- import { DatabaseUtils } from '../utils/database.js';
4
- import { getHybridSearchEngine } from '../algorithms/hybrid-search-engine.js';
5
- import { getVectorSearchEngine } from '../algorithms/vector-search-engine.js';
6
- import { getPerformanceMonitor } from '../services/performance-monitor.js';
7
- import { getBatchScheduler } from '../services/batch-scheduler.js';
8
- import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
9
- import { ForgettingPolicyService } from '../services/forgetting-policy-service.js';
10
- import { MemoryInjectionPrompt } from '../tools/memory-injection-prompt.js';
11
-
12
- // Mock external dependencies
13
- vi.mock('../services/memory-embedding-service.js');
14
- vi.mock('../services/forgetting-policy-service.js');
15
-
16
- describe('Memento M1 통합 테스트', () => {
17
- let db: Database.Database;
18
- let hybridSearchEngine: any;
19
- let vectorSearchEngine: any;
20
- let performanceMonitor: any;
21
- let batchScheduler: any;
22
- let embeddingService: any;
23
- let forgettingService: any;
24
- let memoryInjectionPrompt: MemoryInjectionPrompt;
25
-
26
- beforeEach(async () => {
27
- // Create in-memory database for testing
28
- db = new Database(':memory:');
29
-
30
- // Initialize database schema
31
- await DatabaseUtils.initializeDatabase(db);
32
-
33
- // Initialize services
34
- hybridSearchEngine = getHybridSearchEngine();
35
- vectorSearchEngine = getVectorSearchEngine();
36
- performanceMonitor = getPerformanceMonitor();
37
- batchScheduler = getBatchScheduler({
38
- cleanupInterval: 1000, // 1초 for testing
39
- monitoringInterval: 500, // 0.5초 for testing
40
- enableLogging: false
41
- });
42
- memoryInjectionPrompt = new MemoryInjectionPrompt();
43
-
44
- // Mock embedding service
45
- embeddingService = {
46
- isAvailable: vi.fn().mockReturnValue(true),
47
- generateEmbedding: vi.fn().mockResolvedValue(Array(1536).fill(0.1)),
48
- searchBySimilarity: vi.fn().mockResolvedValue([]),
49
- getEmbeddingStats: vi.fn().mockResolvedValue({ totalEmbeddings: 0, averageSimilarity: 0 })
50
- };
51
- vi.mocked(MemoryEmbeddingService).mockImplementation(() => embeddingService);
52
-
53
- // Mock forgetting service
54
- forgettingService = {
55
- executeMemoryCleanup: vi.fn().mockResolvedValue({
56
- softDeleted: [],
57
- hardDeleted: [],
58
- reviewed: [],
59
- totalProcessed: 0
60
- })
61
- };
62
- vi.mocked(ForgettingPolicyService).mockImplementation(() => forgettingService);
63
-
64
- // Initialize vector search engine
65
- vectorSearchEngine.initialize(db);
66
-
67
- // Initialize performance monitor
68
- performanceMonitor.initialize(db);
69
- });
70
-
71
- afterEach(() => {
72
- if (db) {
73
- db.close();
74
- }
75
- batchScheduler.stop();
76
- vi.clearAllMocks();
77
- });
78
-
79
- describe('데이터베이스 초기화', () => {
80
- it('should initialize database with all required tables', () => {
81
- const tables = db.prepare(`
82
- SELECT name FROM sqlite_master
83
- WHERE type='table' AND name NOT LIKE 'sqlite_%'
84
- `).all() as { name: string }[];
85
-
86
- const tableNames = tables.map(t => t.name);
87
-
88
- expect(tableNames).toContain('memory_item');
89
- expect(tableNames).toContain('memory_embedding');
90
- expect(tableNames).toContain('memory_tag');
91
- expect(tableNames).toContain('memory_item_tag');
92
- expect(tableNames).toContain('memory_link');
93
- expect(tableNames).toContain('feedback_event');
94
- expect(tableNames).toContain('wm_buffer');
95
- });
96
-
97
- it('should create FTS5 virtual table', () => {
98
- const ftsTables = db.prepare(`
99
- SELECT name FROM sqlite_master
100
- WHERE type='table' AND name LIKE '%_fts'
101
- `).all() as { name: string }[];
102
-
103
- expect(ftsTables.some(t => t.name === 'memory_item_fts')).toBe(true);
104
- });
105
-
106
- it('should create VSS virtual table', () => {
107
- const vssTables = db.prepare(`
108
- SELECT name FROM sqlite_master
109
- WHERE type='table' AND name LIKE '%_vss'
110
- `).all() as { name: string }[];
111
-
112
- expect(vssTables.some(t => t.name === 'memory_item_vec')).toBe(true);
113
- });
114
- });
115
-
116
- describe('메모리 저장 및 검색 통합', () => {
117
- it('should store and retrieve memories through hybrid search', async () => {
118
- // 1. 메모리 저장
119
- const memoryData = {
120
- id: 'test-memory-1',
121
- type: 'episodic',
122
- content: 'React Hook을 사용한 상태 관리 방법',
123
- importance: 0.8,
124
- privacy_scope: 'private',
125
- created_at: new Date().toISOString(),
126
- pinned: false,
127
- source: 'test',
128
- agent_id: 'test-agent',
129
- user_id: 'test-user',
130
- project_id: 'test-project'
131
- };
132
-
133
- db.prepare(`
134
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned, source, agent_id, user_id, project_id)
135
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
136
- `).run(
137
- memoryData.id,
138
- memoryData.type,
139
- memoryData.content,
140
- memoryData.importance,
141
- memoryData.privacy_scope,
142
- memoryData.created_at,
143
- memoryData.pinned ? 1 : 0,
144
- memoryData.source,
145
- memoryData.agent_id,
146
- memoryData.user_id,
147
- memoryData.project_id
148
- );
149
-
150
- // 2. 하이브리드 검색으로 메모리 검색
151
- const searchResult = await hybridSearchEngine.search(db, {
152
- query: 'React Hook 상태 관리',
153
- limit: 10
154
- });
155
-
156
- expect(searchResult.items).toHaveLength(1);
157
- expect(searchResult.items[0].content).toContain('React Hook');
158
- expect(searchResult.items[0].type).toBe('episodic');
159
- });
160
-
161
- it('should handle multiple memory types in search', async () => {
162
- // 다양한 타입의 메모리 저장
163
- const memories = [
164
- {
165
- id: 'working-1',
166
- type: 'working',
167
- content: '현재 작업 중인 React 컴포넌트',
168
- importance: 0.6
169
- },
170
- {
171
- id: 'episodic-1',
172
- type: 'episodic',
173
- content: 'React 프로젝트에서 발생한 버그 해결 경험',
174
- importance: 0.8
175
- },
176
- {
177
- id: 'semantic-1',
178
- type: 'semantic',
179
- content: 'React Hook의 기본 개념과 사용법',
180
- importance: 0.9
181
- },
182
- {
183
- id: 'procedural-1',
184
- type: 'procedural',
185
- content: 'React 컴포넌트 개발 절차',
186
- importance: 0.7
187
- }
188
- ];
189
-
190
- for (const memory of memories) {
191
- db.prepare(`
192
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
193
- VALUES (?, ?, ?, ?, 'private', datetime('now'), 0)
194
- `).run(memory.id, memory.type, memory.content, memory.importance);
195
- }
196
-
197
- // 검색 실행
198
- const searchResult = await hybridSearchEngine.search(db, {
199
- query: 'React',
200
- limit: 10
201
- });
202
-
203
- expect(searchResult.items.length).toBeGreaterThan(0);
204
-
205
- // 모든 메모리 타입이 검색 결과에 포함되는지 확인
206
- const resultTypes = searchResult.items.map(item => item.type);
207
- expect(resultTypes).toContain('working');
208
- expect(resultTypes).toContain('episodic');
209
- expect(resultTypes).toContain('semantic');
210
- expect(resultTypes).toContain('procedural');
211
- });
212
- });
213
-
214
- describe('성능 모니터링 통합', () => {
215
- it('should collect performance metrics', async () => {
216
- const metrics = await performanceMonitor.collectMetrics();
217
-
218
- expect(metrics).toHaveProperty('timestamp');
219
- expect(metrics).toHaveProperty('memory');
220
- expect(metrics).toHaveProperty('cpu');
221
- expect(metrics).toHaveProperty('database');
222
- expect(metrics).toHaveProperty('uptime');
223
-
224
- expect(metrics.memory).toHaveProperty('rss');
225
- expect(metrics.memory).toHaveProperty('heapTotal');
226
- expect(metrics.memory).toHaveProperty('heapUsed');
227
- expect(metrics.database).toHaveProperty('size');
228
- expect(metrics.database).toHaveProperty('memoryCount');
229
- });
230
-
231
- it('should detect performance alerts', async () => {
232
- // 고메모리 사용량 시뮬레이션
233
- const originalMemoryUsage = process.memoryUsage;
234
- process.memoryUsage = vi.fn().mockReturnValue({
235
- rss: 0,
236
- heapTotal: 1000,
237
- heapUsed: 900, // 90% 사용률
238
- external: 0,
239
- arrayBuffers: 0
240
- });
241
-
242
- await performanceMonitor.collectMetrics();
243
-
244
- const alerts = performanceMonitor.getActiveAlerts();
245
- expect(alerts.length).toBeGreaterThan(0);
246
-
247
- const memoryAlert = alerts.find(alert => alert.type === 'memory');
248
- expect(memoryAlert).toBeDefined();
249
- expect(memoryAlert?.severity).toBe('critical');
250
-
251
- // 원래 함수 복원
252
- process.memoryUsage = originalMemoryUsage;
253
- });
254
- });
255
-
256
- describe('배치 스케줄러 통합', () => {
257
- it('should start and stop scheduler correctly', async () => {
258
- await batchScheduler.start(db);
259
-
260
- const status = batchScheduler.getStatus();
261
- expect(status.isRunning).toBe(true);
262
- expect(status.activeJobs).toContain('cleanup');
263
- expect(status.activeJobs).toContain('monitoring');
264
-
265
- batchScheduler.stop();
266
-
267
- const stoppedStatus = batchScheduler.getStatus();
268
- expect(stoppedStatus.isRunning).toBe(false);
269
- expect(stoppedStatus.activeJobs).toEqual([]);
270
- });
271
-
272
- it('should execute cleanup job', async () => {
273
- await batchScheduler.start(db);
274
-
275
- const result = await batchScheduler.runJob('cleanup');
276
-
277
- expect(result.jobType).toBe('memory_cleanup');
278
- expect(result.success).toBe(true);
279
- expect(forgettingService.executeMemoryCleanup).toHaveBeenCalledWith(db);
280
- });
281
-
282
- it('should execute monitoring job', async () => {
283
- await batchScheduler.start(db);
284
-
285
- const result = await batchScheduler.runJob('monitoring');
286
-
287
- expect(result.jobType).toBe('monitoring');
288
- expect(result.success).toBe(true);
289
- expect(result.details).toHaveProperty('metrics');
290
- expect(result.details).toHaveProperty('stats');
291
- });
292
- });
293
-
294
- describe('메모리 주입 프롬프트 통합', () => {
295
- it('should inject memories into prompt', async () => {
296
- // 테스트 메모리 저장
297
- db.prepare(`
298
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
299
- VALUES ('test-1', 'episodic', 'React Hook 사용법', 0.8, 'private', datetime('now'), 0)
300
- `).run();
301
-
302
- const result = await memoryInjectionPrompt.execute(
303
- {
304
- query: 'React Hook',
305
- token_budget: 1000,
306
- max_memories: 5
307
- },
308
- {
309
- db,
310
- services: { hybridSearchEngine }
311
- }
312
- );
313
-
314
- expect(result).toHaveProperty('content');
315
- expect(result.content[0].type).toBe('text');
316
- expect(result.content[0].text).toContain('React Hook');
317
- });
318
-
319
- it('should handle empty search results in memory injection', async () => {
320
- const result = await memoryInjectionPrompt.execute(
321
- {
322
- query: 'nonexistent query',
323
- token_budget: 1000,
324
- max_memories: 5
325
- },
326
- {
327
- db,
328
- services: { hybridSearchEngine }
329
- }
330
- );
331
-
332
- expect(result.content[0].text).toBe('관련 기억을 찾을 수 없습니다.');
333
- });
334
- });
335
-
336
- describe('벡터 검색 통합', () => {
337
- it('should initialize vector search engine', () => {
338
- const status = vectorSearchEngine.getIndexStatus();
339
- expect(status).toHaveProperty('available');
340
- expect(status).toHaveProperty('tableExists');
341
- expect(status).toHaveProperty('recordCount');
342
- });
343
-
344
- it('should perform vector search when VSS is available', async () => {
345
- // VSS 사용 가능하도록 모킹
346
- vectorSearchEngine.getIndexStatus = vi.fn().mockReturnValue({
347
- available: true,
348
- tableExists: true,
349
- recordCount: 0
350
- });
351
-
352
- const queryVector = Array(1536).fill(0.1);
353
- const results = await vectorSearchEngine.search(queryVector, {
354
- limit: 10,
355
- threshold: 0.5
356
- });
357
-
358
- expect(Array.isArray(results)).toBe(true);
359
- });
360
- });
361
-
362
- describe('에러 처리 통합', () => {
363
- it('should handle database connection errors gracefully', async () => {
364
- // 데이터베이스 연결 끊기
365
- db.close();
366
-
367
- // 성능 모니터링에서 에러 처리 확인
368
- const metrics = await performanceMonitor.collectMetrics();
369
- expect(metrics.database.memoryCount).toBe(0);
370
- expect(metrics.database.size).toBe(0);
371
- });
372
-
373
- it('should handle service unavailability', async () => {
374
- // 임베딩 서비스 비활성화
375
- embeddingService.isAvailable.mockReturnValue(false);
376
-
377
- const searchResult = await hybridSearchEngine.search(db, {
378
- query: 'test query',
379
- limit: 10
380
- });
381
-
382
- // 텍스트 검색만으로도 결과가 나와야 함
383
- expect(searchResult).toHaveProperty('items');
384
- expect(searchResult).toHaveProperty('total_count');
385
- });
386
- });
387
-
388
- describe('전체 워크플로우', () => {
389
- it('should complete full memory lifecycle', async () => {
390
- // 1. 메모리 저장
391
- const memoryId = 'workflow-test-1';
392
- db.prepare(`
393
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
394
- VALUES (?, 'episodic', '전체 워크플로우 테스트 메모리', 0.9, 'private', datetime('now'), 0)
395
- `).run(memoryId);
396
-
397
- // 2. 성능 모니터링 시작
398
- performanceMonitor.initialize(db);
399
- const metrics = await performanceMonitor.collectMetrics();
400
- expect(metrics.database.memoryCount).toBe(1);
401
-
402
- // 3. 배치 스케줄러 시작
403
- await batchScheduler.start(db);
404
- const status = batchScheduler.getStatus();
405
- expect(status.isRunning).toBe(true);
406
-
407
- // 4. 하이브리드 검색
408
- const searchResult = await hybridSearchEngine.search(db, {
409
- query: '워크플로우 테스트',
410
- limit: 10
411
- });
412
- expect(searchResult.items.length).toBeGreaterThan(0);
413
-
414
- // 5. 메모리 주입
415
- const injectionResult = await memoryInjectionPrompt.execute(
416
- {
417
- query: '워크플로우',
418
- token_budget: 500,
419
- max_memories: 3
420
- },
421
- {
422
- db,
423
- services: { hybridSearchEngine }
424
- }
425
- );
426
- expect(injectionResult.content[0].text).toContain('워크플로우');
427
-
428
- // 6. 정리
429
- batchScheduler.stop();
430
- expect(batchScheduler.getStatus().isRunning).toBe(false);
431
- });
432
- });
433
-
434
- describe('동시성 테스트', () => {
435
- it('should handle concurrent searches', async () => {
436
- // 여러 메모리 저장
437
- for (let i = 0; i < 10; i++) {
438
- db.prepare(`
439
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
440
- VALUES (?, 'episodic', '동시성 테스트 메모리 ' + ?, 0.5, 'private', datetime('now'), 0)
441
- `).run(`concurrent-${i}`, i);
442
- }
443
-
444
- // 동시 검색 실행
445
- const searchPromises = Array.from({ length: 5 }, (_, i) =>
446
- hybridSearchEngine.search(db, {
447
- query: `테스트 ${i}`,
448
- limit: 5
449
- })
450
- );
451
-
452
- const results = await Promise.all(searchPromises);
453
-
454
- // 모든 검색이 성공해야 함
455
- results.forEach(result => {
456
- expect(result).toHaveProperty('items');
457
- expect(result).toHaveProperty('total_count');
458
- expect(Array.isArray(result.items)).toBe(true);
459
- });
460
- });
461
- });
462
- });
463
-
@@ -1,208 +0,0 @@
1
- /**
2
- * 경량 하이브리드 임베딩 기능 테스트
3
- * OpenAI 없이도 임베딩 기능이 동작하는지 확인
4
- */
5
-
6
- import { createMementoClient } from '../client/index.js';
7
-
8
- async function testLightweightEmbeddingFunctionality() {
9
- console.log('🧠 경량 하이브리드 임베딩 기능 테스트 시작');
10
-
11
- const client = createMementoClient();
12
-
13
- try {
14
- // 1. 서버 연결
15
- console.log('\n1️⃣ 서버 연결 중...');
16
- await client.connect();
17
-
18
- // 2. 임베딩 서비스 상태 확인
19
- console.log('\n2️⃣ 임베딩 서비스 상태 확인');
20
- try {
21
- const testResult = await client.recall({ query: "test", limit: 1 });
22
- console.log(' ✅ 임베딩 서비스 사용 가능');
23
- } catch (error) {
24
- console.log(' ⚠️ 임베딩 서비스 상태 확인 중 오류:', error);
25
- }
26
-
27
- // 3. 다양한 기억 저장 (경량 임베딩 생성 테스트)
28
- console.log('\n3️⃣ 경량 임베딩이 포함된 기억 저장');
29
- const memories = [
30
- {
31
- content: "사용자가 React의 useState Hook에 대해 질문했습니다. 상태 관리를 위한 기본 Hook으로, 함수형 컴포넌트에서 상태를 선언하고 업데이트할 수 있습니다.",
32
- type: 'episodic' as const,
33
- tags: ['react', 'hooks', 'useState', 'javascript'],
34
- importance: 0.9
35
- },
36
- {
37
- content: "TypeScript의 인터페이스와 타입 별칭의 차이점을 설명했습니다. 인터페이스는 확장 가능하고, 타입 별칭은 유니온 타입을 표현할 수 있습니다.",
38
- type: 'semantic' as const,
39
- tags: ['typescript', 'types', 'interface', 'type-alias'],
40
- importance: 0.8
41
- },
42
- {
43
- content: "데이터베이스 인덱싱에 대한 질문을 받았습니다. B-tree 인덱스의 작동 원리와 쿼리 성능에 미치는 영향을 설명했습니다.",
44
- type: 'episodic' as const,
45
- tags: ['database', 'indexing', 'b-tree', 'performance'],
46
- importance: 0.7
47
- },
48
- {
49
- content: "MCP(Model Context Protocol)에 대해 학습했습니다. AI 에이전트와 도구 간의 표준화된 통신 프로토콜로, 확장 가능한 아키텍처를 제공합니다.",
50
- type: 'semantic' as const,
51
- tags: ['mcp', 'protocol', 'ai', 'architecture'],
52
- importance: 0.85
53
- },
54
- {
55
- content: "사용자가 Docker 컨테이너화에 대해 질문했습니다. 이미지 빌드, 레이어 캐싱, 멀티스테이지 빌드 등의 개념을 설명했습니다.",
56
- type: 'episodic' as const,
57
- tags: ['docker', 'containerization', 'devops', 'deployment'],
58
- importance: 0.75
59
- }
60
- ];
61
-
62
- const memoryIds: string[] = [];
63
- for (const memory of memories) {
64
- const id = await client.remember(memory);
65
- memoryIds.push(id);
66
- console.log(`✅ 저장됨: ${id.substring(0, 20)}... - ${memory.content.substring(0, 50)}...`);
67
-
68
- // 임베딩 생성 시간을 위해 잠시 대기
69
- await new Promise(resolve => setTimeout(resolve, 500));
70
- }
71
-
72
- // 4. 경량 하이브리드 검색 테스트
73
- console.log('\n4️⃣ 경량 하이브리드 검색 테스트');
74
-
75
- const searchQueries = [
76
- { query: "React Hook", description: "React Hook 관련 검색" },
77
- { query: "타입 시스템", description: "타입 시스템 관련 검색" },
78
- { query: "데이터베이스 성능", description: "데이터베이스 성능 관련 검색" },
79
- { query: "AI 프로토콜", description: "AI 프로토콜 관련 검색" },
80
- { query: "컨테이너 배포", description: "컨테이너 배포 관련 검색" },
81
- { query: "상태 관리", description: "상태 관리 관련 검색" },
82
- { query: "확장 가능한 아키텍처", description: "아키텍처 관련 검색" }
83
- ];
84
-
85
- for (const { query, description } of searchQueries) {
86
- console.log(`\n🔍 ${description}: "${query}"`);
87
- try {
88
- const startTime = Date.now();
89
- const results = await client.recall({ query, limit: 3 });
90
- const endTime = Date.now();
91
-
92
- console.log(` 결과: ${results.length}개 (${endTime - startTime}ms)`);
93
- results.forEach((result, index) => {
94
- console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 60)}...`);
95
- const score = (result as any).finalScore || (result as any).score || 'N/A';
96
- console.log(` 점수: ${typeof score === 'number' ? score.toFixed(3) : score}`);
97
- if ((result as any).textScore !== undefined && (result as any).vectorScore !== undefined) {
98
- console.log(` 텍스트: ${(result as any).textScore.toFixed(3)}, 벡터: ${(result as any).vectorScore.toFixed(3)}`);
99
- }
100
- });
101
- } catch (error) {
102
- console.error(` ❌ 검색 실패: ${error}`);
103
- }
104
- }
105
-
106
- // 5. 의미적 유사성 검색 테스트
107
- console.log('\n5️⃣ 의미적 유사성 검색 테스트');
108
-
109
- const semanticQueries = [
110
- { query: "프론트엔드 개발", description: "프론트엔드 관련 검색" },
111
- { query: "타입 안전성", description: "타입 안전성 관련 검색" },
112
- { query: "쿼리 최적화", description: "쿼리 최적화 관련 검색" },
113
- { query: "마이크로서비스", description: "마이크로서비스 관련 검색" },
114
- { query: "개발 도구", description: "개발 도구 관련 검색" }
115
- ];
116
-
117
- for (const { query, description } of semanticQueries) {
118
- console.log(`\n🔍 ${description}: "${query}"`);
119
- try {
120
- const startTime = Date.now();
121
- const results = await client.recall({ query, limit: 2 });
122
- const endTime = Date.now();
123
-
124
- console.log(` 결과: ${results.length}개 (${endTime - startTime}ms)`);
125
- results.forEach((result, index) => {
126
- console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 60)}...`);
127
- const score = (result as any).finalScore || (result as any).score || 'N/A';
128
- console.log(` 점수: ${typeof score === 'number' ? score.toFixed(3) : score}`);
129
- });
130
- } catch (error) {
131
- console.error(` ❌ 검색 실패: ${error}`);
132
- }
133
- }
134
-
135
- // 6. 성능 측정
136
- console.log('\n6️⃣ 성능 측정');
137
-
138
- const performanceTests = [
139
- "React useState Hook 상태 관리",
140
- "TypeScript 인터페이스 타입 시스템",
141
- "데이터베이스 B-tree 인덱스 성능",
142
- "Docker 컨테이너 이미지 빌드",
143
- "MCP 프로토콜 AI 에이전트 통신"
144
- ];
145
-
146
- let totalTime = 0;
147
- let successCount = 0;
148
-
149
- for (const testQuery of performanceTests) {
150
- try {
151
- const startTime = Date.now();
152
- const results = await client.recall({ query: testQuery, limit: 1 });
153
- const endTime = Date.now();
154
-
155
- const duration = endTime - startTime;
156
- totalTime += duration;
157
- successCount++;
158
-
159
- console.log(` "${testQuery}": ${duration}ms (${results.length}개 결과)`);
160
- } catch (error) {
161
- console.error(` ❌ "${testQuery}" 실패: ${error}`);
162
- }
163
- }
164
-
165
- if (successCount > 0) {
166
- const averageTime = totalTime / successCount;
167
- console.log(`\n 📊 평균 검색 시간: ${averageTime.toFixed(2)}ms`);
168
- console.log(` 📊 성공률: ${(successCount / performanceTests.length * 100).toFixed(1)}%`);
169
- }
170
-
171
- // 7. 임베딩 통계 확인
172
- console.log('\n7️⃣ 임베딩 통계 확인');
173
- try {
174
- const statsResult = await client.recall({ query: "test", limit: 1 });
175
- if (statsResult.length > 0 && (statsResult[0] as any).search_type === 'hybrid') {
176
- console.log(' ✅ 하이브리드 검색 활성화됨');
177
- console.log(` 📊 벡터 검색 사용 가능: ${(statsResult[0] as any).vector_search_available || false}`);
178
- }
179
- } catch (error) {
180
- console.error(` ❌ 통계 확인 실패: ${error}`);
181
- }
182
-
183
- console.log('\n🎉 경량 하이브리드 임베딩 기능 테스트 완료!');
184
- console.log('\n📋 테스트 요약:');
185
- console.log(' ✅ 경량 하이브리드 임베딩 서비스 동작 확인');
186
- console.log(' ✅ OpenAI 없이도 임베딩 기능 사용 가능');
187
- console.log(' ✅ 하이브리드 검색 (텍스트 + 벡터) 동작 확인');
188
- console.log(' ✅ 성능 측정 및 통계 수집 완료');
189
-
190
- } catch (error) {
191
- console.error('❌ 테스트 실패:', error);
192
- } finally {
193
- await client.disconnect();
194
- }
195
- }
196
-
197
- // 테스트 실행
198
- if (process.argv[1] && process.argv[1].endsWith('test-lightweight-embedding.ts')) {
199
- testLightweightEmbeddingFunctionality()
200
- .then(() => {
201
- console.log('✅ 경량 임베딩 테스트 완료');
202
- process.exit(0);
203
- })
204
- .catch((error) => {
205
- console.error('❌ 경량 임베딩 테스트 실패:', error);
206
- process.exit(1);
207
- });
208
- }