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,276 +0,0 @@
1
- /**
2
- * 성능 모니터링 통합 서비스
3
- * 기존 성능 모니터와 알림 서비스를 통합하여 실시간 모니터링 제공
4
- */
5
-
6
- import { PerformanceMonitor } from './performance-monitor.js';
7
- import { PerformanceAlertService, AlertType, AlertLevel } from './performance-alert-service.js';
8
- import Database from 'better-sqlite3';
9
-
10
- export interface MonitoringConfig {
11
- enableRealTimeMonitoring: boolean;
12
- monitoringInterval: number; // 밀리초
13
- alertThresholds: {
14
- responseTime: { warning: number; critical: number };
15
- memoryUsage: { warning: number; critical: number };
16
- errorRate: { warning: number; critical: number };
17
- throughput: { warning: number; critical: number };
18
- };
19
- }
20
-
21
- export class PerformanceMonitoringIntegration {
22
- private performanceMonitor: PerformanceMonitor;
23
- private alertService: PerformanceAlertService;
24
- private config: MonitoringConfig;
25
- private monitoringInterval: NodeJS.Timeout | null = null;
26
- private isMonitoring: boolean = false;
27
-
28
- constructor(
29
- db: Database.Database,
30
- alertService: PerformanceAlertService,
31
- config: MonitoringConfig
32
- ) {
33
- this.performanceMonitor = new PerformanceMonitor();
34
- this.performanceMonitor.initialize(db);
35
- this.alertService = alertService;
36
- this.config = config;
37
- }
38
-
39
- /**
40
- * 실시간 모니터링 시작
41
- */
42
- startRealTimeMonitoring(): void {
43
- if (this.isMonitoring) {
44
- console.warn('⚠️ 실시간 모니터링이 이미 실행 중입니다');
45
- return;
46
- }
47
-
48
- if (!this.config.enableRealTimeMonitoring) {
49
- console.log('ℹ️ 실시간 모니터링이 비활성화되어 있습니다');
50
- return;
51
- }
52
-
53
- this.isMonitoring = true;
54
- console.log('🚀 실시간 성능 모니터링 시작');
55
-
56
- this.monitoringInterval = setInterval(async () => {
57
- await this.performMonitoringCycle();
58
- }, this.config.monitoringInterval);
59
- }
60
-
61
- /**
62
- * 실시간 모니터링 중지
63
- */
64
- stopRealTimeMonitoring(): void {
65
- if (this.monitoringInterval) {
66
- clearInterval(this.monitoringInterval);
67
- this.monitoringInterval = null;
68
- }
69
- this.isMonitoring = false;
70
- console.log('🛑 실시간 성능 모니터링 중지');
71
- }
72
-
73
- /**
74
- * 모니터링 사이클 실행
75
- */
76
- private async performMonitoringCycle(): Promise<void> {
77
- try {
78
- const metrics = await this.performanceMonitor.collectMetrics();
79
-
80
- // 응답시간 체크
81
- if (metrics.search.averageSearchTime > 0) {
82
- this.alertService.checkPerformanceMetric(
83
- AlertType.RESPONSE_TIME,
84
- metrics.search.averageSearchTime,
85
- {
86
- component: 'search_engine',
87
- operation: 'search',
88
- totalSearches: metrics.search.totalSearches
89
- }
90
- );
91
- }
92
-
93
- // 메모리 사용량 체크
94
- const memoryUsageMB = metrics.memory.heapUsed / 1024 / 1024;
95
- this.alertService.checkPerformanceMetric(
96
- AlertType.MEMORY_USAGE,
97
- memoryUsageMB,
98
- {
99
- component: 'memory_manager',
100
- heapTotal: metrics.memory.heapTotal,
101
- rss: metrics.memory.rss
102
- }
103
- );
104
-
105
- // 에러율 체크 (간접적으로)
106
- const errorRate = this.calculateErrorRate(metrics);
107
- if (errorRate > 0) {
108
- this.alertService.checkPerformanceMetric(
109
- AlertType.ERROR_RATE,
110
- errorRate,
111
- {
112
- component: 'system',
113
- totalOperations: metrics.database.totalMemories + metrics.search.totalSearches
114
- }
115
- );
116
- }
117
-
118
- // 처리량 체크
119
- const throughput = this.calculateThroughput(metrics);
120
- if (throughput > 0) {
121
- this.alertService.checkPerformanceMetric(
122
- AlertType.THROUGHPUT,
123
- throughput,
124
- {
125
- component: 'system',
126
- totalOperations: metrics.database.totalMemories + metrics.search.totalSearches
127
- }
128
- );
129
- }
130
-
131
- // 데이터베이스 성능 체크
132
- if (metrics.database.queryPerformance.averageQueryTime > 0) {
133
- this.alertService.checkPerformanceMetric(
134
- AlertType.DATABASE_PERFORMANCE,
135
- metrics.database.queryPerformance.averageQueryTime,
136
- {
137
- component: 'database',
138
- operation: 'query',
139
- totalMemories: metrics.database.totalMemories
140
- }
141
- );
142
- }
143
-
144
- // 캐시 성능 체크
145
- if (metrics.search.cacheHitRate > 0) {
146
- this.alertService.checkPerformanceMetric(
147
- AlertType.CACHE_PERFORMANCE,
148
- metrics.search.cacheHitRate * 100, // 백분율로 변환
149
- {
150
- component: 'cache',
151
- operation: 'search',
152
- totalSearches: metrics.search.totalSearches
153
- }
154
- );
155
- }
156
-
157
- } catch (error) {
158
- console.error('❌ 모니터링 사이클 실행 중 오류:', error);
159
- }
160
- }
161
-
162
- /**
163
- * 에러율 계산 (간접적)
164
- */
165
- private calculateErrorRate(metrics: any): number {
166
- // 실제 에러율 계산 로직 (현재는 간단한 추정)
167
- const totalOperations = metrics.database.totalMemories + metrics.search.totalSearches;
168
- if (totalOperations === 0) return 0;
169
-
170
- // 느린 쿼리 비율을 에러율로 간접 추정
171
- const slowQueries = metrics.database.queryPerformance.slowQueries.length;
172
- return (slowQueries / totalOperations) * 100;
173
- }
174
-
175
- /**
176
- * 처리량 계산
177
- */
178
- private calculateThroughput(metrics: any): number {
179
- const totalOperations = metrics.database.totalMemories + metrics.search.totalSearches;
180
- const uptimeSeconds = metrics.system.uptime / 1000;
181
-
182
- if (uptimeSeconds === 0) return 0;
183
-
184
- return totalOperations / uptimeSeconds; // ops/sec
185
- }
186
-
187
- /**
188
- * 수동 성능 체크
189
- */
190
- async performManualCheck(): Promise<void> {
191
- console.log('🔍 수동 성능 체크 실행');
192
- await this.performMonitoringCycle();
193
- }
194
-
195
- /**
196
- * 알림 임계값 업데이트
197
- */
198
- updateAlertThresholds(thresholds: Partial<MonitoringConfig['alertThresholds']>): void {
199
- if (thresholds.responseTime) {
200
- this.alertService.updateThreshold(
201
- AlertType.RESPONSE_TIME,
202
- AlertLevel.WARNING,
203
- { threshold: thresholds.responseTime.warning, operator: 'gt' }
204
- );
205
- this.alertService.updateThreshold(
206
- AlertType.RESPONSE_TIME,
207
- AlertLevel.CRITICAL,
208
- { threshold: thresholds.responseTime.critical, operator: 'gt' }
209
- );
210
- }
211
-
212
- if (thresholds.memoryUsage) {
213
- this.alertService.updateThreshold(
214
- AlertType.MEMORY_USAGE,
215
- AlertLevel.WARNING,
216
- { threshold: thresholds.memoryUsage.warning, operator: 'gt' }
217
- );
218
- this.alertService.updateThreshold(
219
- AlertType.MEMORY_USAGE,
220
- AlertLevel.CRITICAL,
221
- { threshold: thresholds.memoryUsage.critical, operator: 'gt' }
222
- );
223
- }
224
-
225
- if (thresholds.errorRate) {
226
- this.alertService.updateThreshold(
227
- AlertType.ERROR_RATE,
228
- AlertLevel.WARNING,
229
- { threshold: thresholds.errorRate.warning, operator: 'gt' }
230
- );
231
- this.alertService.updateThreshold(
232
- AlertType.ERROR_RATE,
233
- AlertLevel.CRITICAL,
234
- { threshold: thresholds.errorRate.critical, operator: 'gt' }
235
- );
236
- }
237
-
238
- if (thresholds.throughput) {
239
- this.alertService.updateThreshold(
240
- AlertType.THROUGHPUT,
241
- AlertLevel.WARNING,
242
- { threshold: thresholds.throughput.warning, operator: 'lt' }
243
- );
244
- this.alertService.updateThreshold(
245
- AlertType.THROUGHPUT,
246
- AlertLevel.CRITICAL,
247
- { threshold: thresholds.throughput.critical, operator: 'lt' }
248
- );
249
- }
250
-
251
- console.log('✅ 알림 임계값 업데이트 완료');
252
- }
253
-
254
- /**
255
- * 모니터링 상태 확인
256
- */
257
- getMonitoringStatus(): {
258
- isMonitoring: boolean;
259
- config: MonitoringConfig;
260
- alertService: PerformanceAlertService;
261
- } {
262
- return {
263
- isMonitoring: this.isMonitoring,
264
- config: this.config,
265
- alertService: this.alertService
266
- };
267
- }
268
-
269
- /**
270
- * 서비스 정리
271
- */
272
- cleanup(): void {
273
- this.stopRealTimeMonitoring();
274
- this.alertService.cleanup();
275
- }
276
- }
@@ -1,224 +0,0 @@
1
- /**
2
- * 통합 임베딩 서비스 테스트
3
- * TDD 방식으로 구현
4
- */
5
-
6
- import { describe, it, expect, beforeEach, vi } from 'vitest';
7
- import { UnifiedEmbeddingService } from './unified-embedding-service.js';
8
- import { EmbeddingProviderFactory } from './embedding-provider-factory.js';
9
- import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData } from '../types/embedding.types.js';
10
-
11
- // 팩토리 모킹
12
- const mockFactory = {
13
- getProvider: vi.fn(),
14
- getAvailableProviders: vi.fn(),
15
- selectProvider: vi.fn()
16
- };
17
-
18
- vi.mock('./embedding-provider-factory.js', () => ({
19
- EmbeddingProviderFactory: {
20
- getInstance: vi.fn(() => mockFactory)
21
- }
22
- }));
23
-
24
- // Mock 제공자 클래스
25
- class MockEmbeddingService implements EmbeddingServiceInterface {
26
- constructor(private available: boolean = true, private shouldFail: boolean = false) {}
27
-
28
- async generateEmbedding(text: string): Promise<EmbeddingResult | null> {
29
- if (this.shouldFail) {
30
- throw new Error('Mock service failed');
31
- }
32
- return {
33
- embedding: [0.1, 0.2, 0.3],
34
- model: 'mock-model',
35
- usage: { prompt_tokens: 10, total_tokens: 10 }
36
- };
37
- }
38
-
39
- async searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number): Promise<SimilarityResult[]> {
40
- if (this.shouldFail) {
41
- throw new Error('Mock service failed');
42
- }
43
- return [
44
- { id: '1', content: 'test', similarity: 0.8, score: 0.8 }
45
- ];
46
- }
47
-
48
- isAvailable(): boolean {
49
- return this.available;
50
- }
51
-
52
- getModelInfo() {
53
- return { model: 'mock-model', dimensions: 384, maxTokens: 256 };
54
- }
55
- }
56
-
57
- describe('UnifiedEmbeddingService', () => {
58
- let service: UnifiedEmbeddingService;
59
- let mockProvider: MockEmbeddingService;
60
-
61
- beforeEach(() => {
62
- mockProvider = new MockEmbeddingService();
63
-
64
- // 팩토리 모킹 설정
65
- mockFactory.getProvider.mockReturnValue(mockProvider);
66
- mockFactory.getAvailableProviders.mockReturnValue([
67
- { name: 'minilm', available: true, priority: 1, cost: 'free', performance: 'high' },
68
- { name: 'openai', available: true, priority: 2, cost: 'paid', performance: 'high' },
69
- { name: 'gemini', available: true, priority: 3, cost: 'paid', performance: 'high' },
70
- { name: 'tfidf', available: true, priority: 4, cost: 'free', performance: 'low' }
71
- ]);
72
- mockFactory.selectProvider.mockReturnValue(mockProvider);
73
-
74
- service = new UnifiedEmbeddingService();
75
- });
76
-
77
- describe('생성자', () => {
78
- it('서비스가 올바르게 초기화되어야 한다', () => {
79
- expect(service).toBeDefined();
80
- expect(EmbeddingProviderFactory.getInstance).toHaveBeenCalled();
81
- });
82
- });
83
-
84
- describe('generateEmbedding', () => {
85
- it('빈 텍스트에 대해 에러를 던져야 한다', async () => {
86
- await expect(service.generateEmbedding('')).rejects.toThrow('텍스트가 비어있습니다');
87
- await expect(service.generateEmbedding(' ')).rejects.toThrow('텍스트가 비어있습니다');
88
- });
89
-
90
- it('유효한 텍스트에 대해 임베딩을 생성해야 한다', async () => {
91
- const mockProvider = new MockEmbeddingService();
92
- mockFactory.selectProvider.mockReturnValue(mockProvider);
93
-
94
- const result = await service.generateEmbedding('테스트 텍스트');
95
-
96
- expect(result).toBeDefined();
97
- expect(result?.embedding).toEqual([0.1, 0.2, 0.3]);
98
- expect(result?.model).toBe('mock-model');
99
- });
100
-
101
- it('제공자 실패 시 폴백을 시도해야 한다', async () => {
102
- const failingProvider = new MockEmbeddingService(true, true);
103
- const fallbackProvider = new MockEmbeddingService();
104
-
105
- mockFactory.selectProvider.mockReturnValue(failingProvider);
106
- mockFactory.getProvider
107
- .mockReturnValueOnce(failingProvider) // 첫 번째 시도
108
- .mockReturnValueOnce(fallbackProvider); // 폴백 시도
109
-
110
- const result = await service.generateEmbedding('테스트 텍스트');
111
-
112
- expect(result).toBeDefined();
113
- expect(result?.model).toBe('mock-model');
114
- });
115
-
116
- it('모든 제공자 실패 시 에러를 던져야 한다', async () => {
117
- const failingProvider = new MockEmbeddingService(true, true);
118
- mockFactory.selectProvider.mockReturnValue(failingProvider);
119
- mockFactory.getProvider.mockReturnValue(failingProvider);
120
-
121
- await expect(service.generateEmbedding('테스트 텍스트')).rejects.toThrow('모든 임베딩 제공자 실패');
122
- });
123
- });
124
-
125
- describe('searchSimilar', () => {
126
- const mockEmbeddings: EmbeddingData[] = [
127
- { id: '1', content: '테스트 내용', embedding: [0.1, 0.2, 0.3] }
128
- ];
129
-
130
- it('빈 쿼리에 대해 에러를 던져야 한다', async () => {
131
- await expect(service.searchSimilar('', mockEmbeddings)).rejects.toThrow('텍스트가 비어있습니다');
132
- });
133
-
134
- it('유효한 쿼리에 대해 검색 결과를 반환해야 한다', async () => {
135
- const mockProvider = new MockEmbeddingService();
136
- mockFactory.selectProvider.mockReturnValue(mockProvider);
137
-
138
- const results = await service.searchSimilar('쿼리', mockEmbeddings);
139
-
140
- expect(results).toHaveLength(1);
141
- expect(results[0].id).toBe('1');
142
- expect(results[0].similarity).toBe(0.8);
143
- });
144
-
145
- it('제공자 실패 시 폴백을 시도해야 한다', async () => {
146
- const failingProvider = new MockEmbeddingService(true, true);
147
- const fallbackProvider = new MockEmbeddingService();
148
-
149
- mockFactory.selectProvider.mockReturnValue(failingProvider);
150
- mockFactory.getProvider
151
- .mockReturnValueOnce(failingProvider)
152
- .mockReturnValueOnce(fallbackProvider);
153
-
154
- const results = await service.searchSimilar('쿼리', mockEmbeddings);
155
-
156
- expect(results).toHaveLength(1);
157
- });
158
- });
159
-
160
- describe('isAvailable', () => {
161
- it('사용 가능한 제공자가 있으면 true를 반환해야 한다', () => {
162
- mockFactory.getAvailableProviders.mockReturnValue([
163
- { name: 'minilm', available: true },
164
- { name: 'tfidf', available: false }
165
- ]);
166
-
167
- expect(service.isAvailable()).toBe(true);
168
- });
169
-
170
- it('사용 가능한 제공자가 없으면 false를 반환해야 한다', () => {
171
- mockFactory.getAvailableProviders.mockReturnValue([
172
- { name: 'minilm', available: false },
173
- { name: 'tfidf', available: false }
174
- ]);
175
-
176
- expect(service.isAvailable()).toBe(false);
177
- });
178
- });
179
-
180
- describe('getModelInfo', () => {
181
- it('현재 제공자가 있으면 해당 정보를 반환해야 한다', () => {
182
- const mockProvider = new MockEmbeddingService();
183
- mockFactory.selectProvider.mockReturnValue(mockProvider);
184
-
185
- // 임베딩 생성으로 현재 제공자 설정
186
- service.generateEmbedding('test');
187
-
188
- const info = service.getModelInfo();
189
- expect(info.model).toBe('mock-model');
190
- expect(info.dimensions).toBe(384);
191
- });
192
-
193
- it('현재 제공자가 없으면 기본값을 반환해야 한다', () => {
194
- const info = service.getModelInfo();
195
- expect(info.model).toBe('unified-embedding');
196
- expect(info.dimensions).toBe(384);
197
- });
198
- });
199
-
200
- describe('getCurrentProviderName', () => {
201
- it('현재 제공자 이름을 반환해야 한다', () => {
202
- const mockProvider = new MockEmbeddingService();
203
- mockFactory.selectProvider.mockReturnValue(mockProvider);
204
- mockFactory.getAvailableProviders.mockReturnValue([
205
- { name: 'minilm', available: true }
206
- ]);
207
- mockFactory.getProvider.mockReturnValue(mockProvider);
208
-
209
- service.generateEmbedding('test');
210
-
211
- expect(service.getCurrentProviderName()).toBe('minilm');
212
- });
213
- });
214
-
215
- describe('setFallbackProviders', () => {
216
- it('폴백 제공자를 설정해야 한다', () => {
217
- const newFallbacks = ['tfidf', 'minilm'];
218
- service.setFallbackProviders(newFallbacks);
219
-
220
- // 내부 상태 확인은 어려우므로, 에러 없이 실행되는지 확인
221
- expect(() => service.setFallbackProviders(newFallbacks)).not.toThrow();
222
- });
223
- });
224
- });