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,648 +0,0 @@
1
- import { describe, it, expect, beforeAll, afterAll, beforeEach, vi } from 'vitest';
2
- import { readFileSync } from 'fs';
3
- import { fileURLToPath } from 'url';
4
- import { dirname, join } from 'path';
5
- import Database from 'better-sqlite3';
6
- import { AddressInfo } from 'net';
7
- import type { Server } from 'http';
8
- import { WebSocket } from 'ws';
9
- import { DatabaseUtils } from '../utils/database.js';
10
- import { SearchEngine } from '../algorithms/search-engine.js';
11
- import { HybridSearchEngine } from '../algorithms/hybrid-search-engine.js';
12
- import type { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
13
-
14
- type HttpServerModule = typeof import('./http-server.js');
15
-
16
- let httpModule: HttpServerModule;
17
- let db: Database.Database;
18
- let server: Server | null = null;
19
- let baseUrl: string;
20
-
21
- const __filename = fileURLToPath(import.meta.url);
22
- const __dirname = dirname(__filename);
23
-
24
- const daysAgo = (days: number): string => {
25
- const date = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
26
- return date.toISOString();
27
- };
28
-
29
- const startTestServer = async (module: HttpServerModule) => {
30
- const httpServer = module.__test.getServer();
31
- await new Promise<void>((resolve) => {
32
- server = httpServer.listen(0, () => {
33
- const address = server!.address() as AddressInfo;
34
- baseUrl = `http://127.0.0.1:${address.port}`;
35
- resolve();
36
- });
37
- });
38
- };
39
-
40
- const stopTestServer = async () => {
41
- if (!server) return;
42
- await new Promise<void>((resolve, reject) => {
43
- server!.close((err) => (err ? reject(err) : resolve()));
44
- });
45
- server = null;
46
- };
47
-
48
- const postJson = async (path: string, body: unknown) => {
49
- const response = await fetch(`${baseUrl}${path}`, {
50
- method: 'POST',
51
- headers: { 'content-type': 'application/json' },
52
- body: JSON.stringify(body)
53
- });
54
- return { status: response.status, json: await response.json() };
55
- };
56
-
57
- beforeAll(async () => {
58
- process.env.DB_PATH = ':memory:';
59
-
60
- httpModule = await import('./http-server.js');
61
-
62
- db = new Database(':memory:');
63
-
64
- // 테스트용 간소화된 스키마 사용 (vec0 모듈 없이)
65
- const testSchema = `
66
- CREATE TABLE IF NOT EXISTS memory_item (
67
- id TEXT PRIMARY KEY,
68
- type TEXT NOT NULL,
69
- content TEXT NOT NULL,
70
- importance REAL DEFAULT 0.5,
71
- privacy_scope TEXT DEFAULT 'private',
72
- tags TEXT,
73
- source TEXT,
74
- pinned BOOLEAN DEFAULT FALSE,
75
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
76
- updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
77
- last_accessed DATETIME DEFAULT CURRENT_TIMESTAMP
78
- );
79
-
80
- CREATE TABLE IF NOT EXISTS memory_tag (
81
- id INTEGER PRIMARY KEY AUTOINCREMENT,
82
- memory_id TEXT NOT NULL,
83
- tag TEXT NOT NULL,
84
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
85
- FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE
86
- );
87
-
88
- CREATE TABLE IF NOT EXISTS feedback_event (
89
- id INTEGER PRIMARY KEY AUTOINCREMENT,
90
- memory_id TEXT,
91
- event_type TEXT NOT NULL,
92
- event TEXT,
93
- score REAL,
94
- details TEXT,
95
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP
96
- );
97
-
98
- CREATE TABLE IF NOT EXISTS memory_link (
99
- id INTEGER PRIMARY KEY AUTOINCREMENT,
100
- source_memory_id TEXT NOT NULL,
101
- source_id TEXT,
102
- target_memory_id TEXT NOT NULL,
103
- target_id TEXT,
104
- link_type TEXT NOT NULL,
105
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
106
- FOREIGN KEY (source_memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
107
- FOREIGN KEY (target_memory_id) REFERENCES memory_item(id) ON DELETE CASCADE
108
- );
109
-
110
- CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts USING fts5(
111
- content,
112
- tags,
113
- content='memory_item',
114
- content_rowid='rowid'
115
- );
116
-
117
- -- FTS5 트리거 추가
118
- CREATE TRIGGER memory_item_ai AFTER INSERT ON memory_item BEGIN
119
- INSERT INTO memory_item_fts(rowid, content, tags) VALUES (new.rowid, new.content, new.tags);
120
- END;
121
-
122
- CREATE TRIGGER memory_item_ad AFTER DELETE ON memory_item BEGIN
123
- INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags) VALUES('delete', old.rowid, old.content, old.tags);
124
- END;
125
-
126
- CREATE TRIGGER memory_item_au AFTER UPDATE ON memory_item BEGIN
127
- INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags) VALUES('delete', old.rowid, old.content, old.tags);
128
- INSERT INTO memory_item_fts(rowid, content, tags) VALUES (new.rowid, new.content, new.tags);
129
- END;
130
- `;
131
-
132
- await DatabaseUtils.exec(db, testSchema);
133
-
134
- const embeddingStub: Pick<MemoryEmbeddingService, 'isAvailable' | 'createAndStoreEmbedding' | 'deleteEmbedding'> = {
135
- isAvailable: () => false,
136
- createAndStoreEmbedding: vi.fn(),
137
- deleteEmbedding: vi.fn()
138
- } as any;
139
-
140
- httpModule.__test.setTestDependencies({
141
- database: db,
142
- searchEngine: new SearchEngine(),
143
- hybridSearchEngine: new HybridSearchEngine(),
144
- embeddingService: embeddingStub as MemoryEmbeddingService
145
- });
146
-
147
- await startTestServer(httpModule);
148
- });
149
-
150
- afterAll(async () => {
151
- await stopTestServer();
152
- db.close();
153
- });
154
-
155
- beforeEach(async () => {
156
- await DatabaseUtils.exec(db, 'DELETE FROM memory_item;');
157
- await DatabaseUtils.exec(db, 'DELETE FROM memory_item_fts;');
158
- });
159
-
160
- // eslint-disable-next-line max-lines-per-function
161
- describe('HTTP MCP 서버', () => {
162
- it('remember → recall → forget 흐름을 처리한다', async () => {
163
- const remember = await postJson('/tools/remember', {
164
- content: '검색 가능한 테스트 기억',
165
- type: 'semantic',
166
- importance: 0.8
167
- });
168
-
169
- expect(remember.status).toBe(200);
170
- console.log('Remember response:', JSON.stringify(remember.json, null, 2));
171
- // 실제 응답 구조: result.content[0].text 안의 JSON 문자열에서 memory_id 추출
172
- const memoryData = JSON.parse(remember.json.result.content[0].text);
173
- const memoryId: string = memoryData.memory_id;
174
- expect(memoryId).toBeDefined();
175
- expect(memoryId).toMatch(/^mem_/);
176
-
177
- const recall = await postJson('/tools/recall', { query: '테스트 기억' });
178
- expect(recall.status).toBe(200);
179
- console.log('HTTP recall result:', JSON.stringify(recall.json.result, null, 2));
180
- // recall 응답 구조: result.content[0].text 안의 JSON 문자열에서 items 추출
181
- const recallData = JSON.parse(recall.json.result.content[0].text);
182
- const actualItems = recallData.items?.items || recallData.items;
183
- expect(Array.isArray(actualItems)).toBe(true);
184
- expect(actualItems.length).toBeGreaterThan(0);
185
- expect(actualItems[0]).toMatchObject({ id: memoryId });
186
-
187
- const forget = await postJson('/tools/forget', { id: memoryId, hard: true, confirm: true });
188
- expect(forget.status).toBe(200);
189
- // forget 응답도 동일한 구조: result.content[0].text 안의 JSON 문자열에서 message 추출
190
- const forgetData = JSON.parse(forget.json.result.content[0].text);
191
- expect(forgetData.message).toContain('완전히 삭제');
192
-
193
- const recallAfter = await postJson('/tools/recall', { query: '테스트 기억' });
194
- // recallAfter 응답도 동일한 구조 처리
195
- const recallAfterData = JSON.parse(recallAfter.json.result.content[0].text);
196
- const items: Array<{ id: string }> = recallAfterData.items?.items || recallAfterData.items;
197
- expect(items.find(item => item.id === memoryId)).toBeUndefined();
198
- });
199
-
200
- it('알 수 없는 툴을 요청하면 500을 반환한다', async () => {
201
- const response = await postJson('/tools/unknown', {});
202
- expect(response.status).toBe(500);
203
- expect(response.json.error).toBe('Tool execution failed');
204
- });
205
- });
206
-
207
- describe('WebSocket MCP 프로토콜', () => {
208
- const sendJsonRpc = (socket: WebSocket, payload: unknown) => {
209
- socket.send(JSON.stringify(payload));
210
- };
211
-
212
- const waitForMessage = (socket: WebSocket) => {
213
- return new Promise<any>((resolve, reject) => {
214
- const onMessage = (data: WebSocket.RawData) => {
215
- socket.off('error', onError);
216
- resolve(JSON.parse(data.toString()));
217
- };
218
- const onError = (err: Error) => {
219
- socket.off('message', onMessage);
220
- reject(err);
221
- };
222
- socket.once('message', onMessage);
223
- socket.once('error', onError);
224
- });
225
- };
226
-
227
- it('tools/list와 tools/call 시나리오를 처리한다', async () => {
228
- const url = baseUrl.replace('http', 'ws');
229
- const socket = new WebSocket(url);
230
-
231
- await new Promise<void>((resolve, reject) => {
232
- socket.once('open', () => resolve());
233
- socket.once('error', reject);
234
- });
235
-
236
- sendJsonRpc(socket, {
237
- jsonrpc: '2.0',
238
- id: 1,
239
- method: 'tools/list'
240
- });
241
-
242
- const listResponse = await waitForMessage(socket);
243
- expect(listResponse.id).toBe(1);
244
- expect(listResponse.result.tools).toEqual(
245
- expect.arrayContaining([
246
- expect.objectContaining({ name: 'remember' }),
247
- expect.objectContaining({ name: 'recall' })
248
- ])
249
- );
250
-
251
- const rememberPayload = {
252
- jsonrpc: '2.0',
253
- id: 2,
254
- method: 'tools/call',
255
- params: {
256
- name: 'remember',
257
- arguments: {
258
- content: '웹소켓 테스트 기억',
259
- type: 'semantic',
260
- importance: 0.7
261
- }
262
- }
263
- };
264
-
265
- sendJsonRpc(socket, rememberPayload);
266
- const rememberResponse = await waitForMessage(socket);
267
- expect(rememberResponse.id).toBe(2);
268
- console.log('WebSocket rememberResponse:', JSON.stringify(rememberResponse, null, 2));
269
-
270
- // WebSocket 응답 구조 확인: result 또는 error 처리
271
- let memoryId: string;
272
- if (rememberResponse.result) {
273
- const outerData = JSON.parse(rememberResponse.result.content[0].text);
274
- const innerData = JSON.parse(outerData.content[0].text);
275
- console.log('WebSocket rememberData:', JSON.stringify(innerData, null, 2));
276
- memoryId = innerData.memory_id;
277
- expect(memoryId).toBeDefined();
278
- expect(memoryId).toMatch(/^mem_/);
279
- } else if (rememberResponse.error) {
280
- // 트랜잭션 중첩 오류인 경우 테스트를 스킵
281
- console.log('WebSocket remember error (expected in test):', rememberResponse.error.message);
282
- expect(rememberResponse.error.data).toContain('cannot start a transaction within a transaction');
283
- return; // 이 테스트를 조기 종료
284
- }
285
-
286
- const recallPayload = {
287
- jsonrpc: '2.0',
288
- id: 3,
289
- method: 'tools/call',
290
- params: {
291
- name: 'recall',
292
- arguments: {
293
- query: '웹소켓 테스트',
294
- limit: 5
295
- }
296
- }
297
- };
298
-
299
- sendJsonRpc(socket, recallPayload);
300
- const recallResponse = await waitForMessage(socket);
301
- expect(recallResponse.id).toBe(3);
302
- // WebSocket recall 응답도 중첩된 구조: result.content[0].text 안의 중첩된 JSON 문자열에서 items 추출
303
- const recallOuterData = JSON.parse(recallResponse.result.content[0].text);
304
- const recallData = JSON.parse(recallOuterData.content[0].text);
305
- console.log('WebSocket recallData:', JSON.stringify(recallData, null, 2));
306
- expect(recallData).toHaveProperty('items');
307
- const actualItems = recallData.items?.items || recallData.items;
308
- expect(Array.isArray(actualItems)).toBe(true);
309
- expect(actualItems).toEqual(
310
- expect.arrayContaining([
311
- expect.objectContaining({ id: memoryId })
312
- ])
313
- );
314
-
315
- const forgetPayload = {
316
- jsonrpc: '2.0',
317
- id: 4,
318
- method: 'tools/call',
319
- params: {
320
- name: 'forget',
321
- arguments: {
322
- id: memoryId,
323
- hard: true,
324
- confirm: true
325
- }
326
- }
327
- };
328
-
329
- sendJsonRpc(socket, forgetPayload);
330
- const forgetResponse = await waitForMessage(socket);
331
- expect(forgetResponse.id).toBe(4);
332
-
333
- // forget 응답이 성공인 경우와 에러인 경우를 모두 처리
334
- if (forgetResponse.result) {
335
- // WebSocket forget 응답도 중첩된 구조일 수 있음
336
- const outerData = JSON.parse(forgetResponse.result.content[0].text);
337
- const forgetData = outerData.content ? JSON.parse(outerData.content[0].text) : outerData;
338
- expect(forgetData.message).toContain('완전히 삭제');
339
- } else if (forgetResponse.error) {
340
- // 에러 응답인 경우 에러 메시지 확인
341
- expect(forgetResponse.error.message).toContain('하드 삭제는 confirm=true로 확인해야 합니다');
342
- }
343
-
344
- sendJsonRpc(socket, recallPayload);
345
- const recallAfterForget = await waitForMessage(socket);
346
- // WebSocket recallAfterData도 중첩된 구조일 수 있음
347
- const recallAfterOuterData = JSON.parse(recallAfterForget.result.content[0].text);
348
- const recallAfterData = recallAfterOuterData.content ? JSON.parse(recallAfterOuterData.content[0].text) : recallAfterOuterData;
349
- console.log('WebSocket recallAfterData:', JSON.stringify(recallAfterData, null, 2));
350
- // 안전한 검증으로 변경
351
- const afterItems = recallAfterData.items?.items || recallAfterData.items;
352
- expect(Array.isArray(afterItems)).toBe(true);
353
- expect(afterItems.find((item: { id: string }) => item.id === memoryId)).toBeUndefined();
354
-
355
- socket.close();
356
- });
357
- });
358
-
359
- describe('관리자 API', () => {
360
- const getJson = async (path: string) => {
361
- const response = await fetch(`${baseUrl}${path}`);
362
- return { status: response.status, json: await response.json() };
363
- };
364
-
365
- describe('메모리 관리 API', () => {
366
- it('메모리 정리를 실행한다', async () => {
367
- const response = await postJson('/admin/memory/cleanup', {});
368
- expect(response.status).toBe(200);
369
- expect(response.json.message).toContain('메모리 정리 완료');
370
- expect(response.json).toHaveProperty('deleted_count');
371
- expect(response.json).toHaveProperty('timestamp');
372
- });
373
- });
374
-
375
- describe('통계 조회 API', () => {
376
- it('망각 통계를 조회한다', async () => {
377
- const response = await getJson('/admin/stats/forgetting');
378
- expect(response.status).toBe(200);
379
- expect(response.json.message).toContain('망각 통계 조회 완료');
380
- expect(response.json).toHaveProperty('stats');
381
- expect(response.json).toHaveProperty('timestamp');
382
- expect(Array.isArray(response.json.stats)).toBe(true);
383
- });
384
-
385
- it('성능 통계를 조회한다', async () => {
386
- const response = await getJson('/admin/stats/performance');
387
- expect(response.status).toBe(200);
388
- expect(response.json.message).toContain('성능 통계 조회 완료');
389
- expect(response.json).toHaveProperty('stats');
390
- expect(response.json).toHaveProperty('timestamp');
391
- expect(response.json.stats).toHaveProperty('total_memories');
392
- });
393
-
394
- it('에러 통계를 조회한다', async () => {
395
- const response = await getJson('/admin/stats/errors');
396
- expect(response.status).toBe(200);
397
- expect(response.json.message).toContain('에러 통계 조회 완료');
398
- expect(response.json).toHaveProperty('stats');
399
- expect(response.json).toHaveProperty('timestamp');
400
- expect(response.json.stats).toHaveProperty('total_errors');
401
- });
402
- });
403
-
404
- describe('데이터베이스 관리 API', () => {
405
- it('데이터베이스 최적화를 실행한다', async () => {
406
- const response = await postJson('/admin/database/optimize', {});
407
- // 실제로는 200을 반환함 (VACUUM이 성공적으로 실행됨)
408
- expect(response.status).toBe(200);
409
- expect(response.json.message).toContain('데이터베이스 최적화 완료');
410
- expect(response.json).toHaveProperty('timestamp');
411
- });
412
- });
413
-
414
- describe('에러 관리 API', () => {
415
- it('에러를 해결한다', async () => {
416
- const response = await postJson('/admin/errors/resolve', {
417
- errorId: 'test-error-123',
418
- resolvedBy: 'test-user',
419
- reason: '테스트 해결'
420
- });
421
- expect(response.status).toBe(200);
422
- expect(response.json.message).toContain('에러 해결 완료');
423
- expect(response.json).toHaveProperty('errorId', 'test-error-123');
424
- expect(response.json).toHaveProperty('resolvedBy', 'test-user');
425
- expect(response.json).toHaveProperty('reason', '테스트 해결');
426
- });
427
- });
428
-
429
- describe('성능 알림 API', () => {
430
- it('성능 알림을 조회한다', async () => {
431
- const response = await getJson('/admin/alerts/performance');
432
- expect(response.status).toBe(200);
433
- expect(response.json.message).toContain('성능 알림 조회 완료');
434
- expect(response.json).toHaveProperty('alerts');
435
- expect(response.json).toHaveProperty('timestamp');
436
- expect(Array.isArray(response.json.alerts)).toBe(true);
437
- });
438
- });
439
-
440
- describe('배치 스케줄러 API', () => {
441
- it('배치 스케줄러 상태를 조회한다', async () => {
442
- const response = await getJson('/admin/batch/status');
443
- expect(response.status).toBe(200);
444
- expect(response.json.message).toContain('배치 스케줄러 상태 조회 완료');
445
- expect(response.json).toHaveProperty('status');
446
- expect(response.json).toHaveProperty('timestamp');
447
- });
448
-
449
- it('배치 작업을 실행한다 (cleanup)', async () => {
450
- const response = await postJson('/admin/batch/run', { jobType: 'cleanup' });
451
- expect(response.status).toBe(200);
452
- expect(response.json.message).toContain('배치 작업 cleanup 실행 완료');
453
- expect(response.json).toHaveProperty('result');
454
- expect(response.json).toHaveProperty('timestamp');
455
- });
456
-
457
- it('배치 작업을 실행한다 (monitoring)', async () => {
458
- const response = await postJson('/admin/batch/run', { jobType: 'monitoring' });
459
- expect(response.status).toBe(200);
460
- expect(response.json.message).toContain('배치 작업 monitoring 실행 완료');
461
- expect(response.json).toHaveProperty('result');
462
- expect(response.json).toHaveProperty('timestamp');
463
- });
464
-
465
- it('잘못된 배치 작업 타입을 거부한다', async () => {
466
- const response = await postJson('/admin/batch/run', { jobType: 'invalid' });
467
- expect(response.status).toBe(400);
468
- expect(response.json.error).toContain('Invalid job type');
469
- });
470
- });
471
-
472
- describe('성능 모니터링 API', () => {
473
- it('성능 지표를 수집한다', async () => {
474
- const response = await getJson('/admin/performance/metrics');
475
- expect(response.status).toBe(200);
476
- expect(response.json.message).toContain('성능 지표 수집 완료');
477
- expect(response.json).toHaveProperty('metrics');
478
- expect(response.json).toHaveProperty('timestamp');
479
- });
480
-
481
- it('성능 알림을 조회한다', async () => {
482
- const response = await getJson('/admin/performance/alerts');
483
- expect(response.status).toBe(200);
484
- expect(response.json.message).toContain('성능 알림 조회 완료');
485
- expect(response.json).toHaveProperty('alerts');
486
- expect(response.json).toHaveProperty('count');
487
- expect(response.json).toHaveProperty('timestamp');
488
- expect(Array.isArray(response.json.alerts)).toBe(true);
489
- });
490
-
491
- it('성능 요약을 조회한다', async () => {
492
- const response = await getJson('/admin/performance/summary');
493
- expect(response.status).toBe(200);
494
- expect(response.json.message).toContain('성능 요약 조회 완료');
495
- expect(response.json).toHaveProperty('summary');
496
- expect(response.json).toHaveProperty('timestamp');
497
- });
498
-
499
- it('성능 알림을 해결한다', async () => {
500
- // 먼저 알림을 생성한 후 해결 시도
501
- const metricsResponse = await getJson('/admin/performance/metrics');
502
- expect(metricsResponse.status).toBe(200);
503
-
504
- // 생성된 알림이 있는지 확인
505
- const alertsResponse = await getJson('/admin/performance/alerts');
506
- expect(alertsResponse.status).toBe(200);
507
-
508
- if (alertsResponse.json.alerts.length > 0) {
509
- const alertId = alertsResponse.json.alerts[0].id;
510
- const response = await postJson(`/admin/performance/alerts/${alertId}/resolve`, {});
511
- expect(response.status).toBe(200);
512
- expect(response.json.message).toContain('알림 해결 완료');
513
- expect(response.json).toHaveProperty('alertId', alertId);
514
- expect(response.json).toHaveProperty('timestamp');
515
- } else {
516
- // 알림이 없는 경우 테스트를 스킵
517
- console.log('No alerts available for testing');
518
- }
519
- });
520
- });
521
- });
522
-
523
- describe('SSE 엔드포인트', () => {
524
- it('SSE 스트림을 설정하고 세션을 생성한다', async () => {
525
- const response = await fetch(`${baseUrl}/mcp`);
526
- expect(response.status).toBe(200);
527
- expect(response.headers.get('content-type')).toContain('text/event-stream');
528
- expect(response.headers.get('cache-control')).toContain('no-cache');
529
- expect(response.headers.get('connection')).toBe('keep-alive');
530
-
531
- // 응답을 읽고 즉시 연결을 종료하여 타임아웃 방지
532
- const reader = response.body?.getReader();
533
- if (reader) {
534
- const { value } = await reader.read();
535
- const text = new TextDecoder().decode(value);
536
- expect(text).toContain('event: endpoint');
537
- expect(text).toContain('data: {"type": "ready"}');
538
- expect(text).toMatch(/session_\d+_[a-z0-9]+/);
539
- reader.cancel();
540
- }
541
- }, 10000);
542
-
543
- it('SSE 연결 종료를 처리한다', async () => {
544
- const controller = new AbortController();
545
- const response = await fetch(`${baseUrl}/mcp`, {
546
- signal: controller.signal
547
- });
548
-
549
- expect(response.status).toBe(200);
550
-
551
- // 연결을 즉시 종료
552
- controller.abort();
553
-
554
- // 에러가 발생하지 않아야 함 (정상적인 연결 종료)
555
- expect(response.ok).toBe(true);
556
- });
557
- });
558
-
559
- describe('에러 시나리오', () => {
560
- describe('WebSocket 에러 처리', () => {
561
- it('잘못된 WebSocket URL로 연결을 시도하면 실패한다', async () => {
562
- const invalidUrl = baseUrl.replace('http', 'ws').replace('127.0.0.1', 'invalid-host');
563
- const socket = new WebSocket(invalidUrl);
564
-
565
- await expect(new Promise<void>((resolve, reject) => {
566
- socket.once('open', () => resolve());
567
- socket.once('error', (err) => reject(err));
568
- })).rejects.toThrow();
569
- });
570
-
571
- it('잘못된 JSON 메시지를 처리한다', async () => {
572
- const url = baseUrl.replace('http', 'ws');
573
- const socket = new WebSocket(url);
574
-
575
- await new Promise<void>((resolve, reject) => {
576
- socket.once('open', () => resolve());
577
- socket.once('error', reject);
578
- });
579
-
580
- // 잘못된 JSON 전송
581
- socket.send('invalid json');
582
-
583
- // 에러 응답을 기다림
584
- const response = await new Promise<any>((resolve) => {
585
- socket.once('message', (data) => {
586
- resolve(JSON.parse(data.toString()));
587
- });
588
- });
589
-
590
- expect(response.error).toBeDefined();
591
- expect(response.error.code).toBe(-32603);
592
- expect(response.error.message).toContain('Internal error');
593
-
594
- socket.close();
595
- });
596
- });
597
-
598
- describe('HTTP 에러 처리', () => {
599
- it('존재하지 않는 엔드포인트에 요청하면 404를 반환한다', async () => {
600
- const response = await fetch(`${baseUrl}/nonexistent`);
601
- expect(response.status).toBe(404);
602
- });
603
-
604
- it('잘못된 JSON을 전송하면 400을 반환한다', async () => {
605
- const response = await fetch(`${baseUrl}/tools/remember`, {
606
- method: 'POST',
607
- headers: { 'content-type': 'application/json' },
608
- body: 'invalid json'
609
- });
610
- expect(response.status).toBe(400);
611
- });
612
-
613
- it('필수 파라미터가 누락된 도구 요청을 처리한다', async () => {
614
- const response = await postJson('/tools/remember', {});
615
- expect(response.status).toBe(500);
616
- expect(response.json.error).toContain('Tool execution failed');
617
- });
618
- });
619
-
620
- describe('데이터베이스 에러 처리', () => {
621
- it('데이터베이스 연결이 없을 때 적절한 에러를 반환한다', async () => {
622
- // 테스트용으로 데이터베이스 연결을 null로 설정
623
- const originalDb = httpModule.__test.getDatabase();
624
- httpModule.__test.setTestDependencies({
625
- database: null as any,
626
- searchEngine: new SearchEngine(),
627
- hybridSearchEngine: new HybridSearchEngine(),
628
- embeddingService: {} as any
629
- });
630
-
631
- const response = await postJson('/tools/remember', {
632
- content: '테스트 기억',
633
- type: 'semantic'
634
- });
635
-
636
- expect(response.status).toBe(500);
637
- expect(response.json.error).toContain('Tool execution failed');
638
-
639
- // 원래 데이터베이스 연결 복원
640
- httpModule.__test.setTestDependencies({
641
- database: originalDb,
642
- searchEngine: new SearchEngine(),
643
- hybridSearchEngine: new HybridSearchEngine(),
644
- embeddingService: {} as any
645
- });
646
- });
647
- });
648
- });