memento-mcp-server 1.6.0 → 1.7.1

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 +3 -1
  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,339 +0,0 @@
1
- import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
2
- import { mementoConfig, searchRankingWeights, defaultTags, validateConfig } from './index.js';
3
-
4
- // Mock dotenv
5
- vi.mock('dotenv', () => ({
6
- config: vi.fn()
7
- }));
8
-
9
- describe('Config', () => {
10
- let originalEnv: NodeJS.ProcessEnv;
11
-
12
- beforeEach(() => {
13
- originalEnv = { ...process.env };
14
- vi.clearAllMocks();
15
- });
16
-
17
- afterEach(() => {
18
- process.env = originalEnv;
19
- });
20
-
21
- describe('mementoConfig', () => {
22
- it('기본 설정값을 가져야 함', () => {
23
- // 환경 변수 초기화
24
- process.env = {};
25
-
26
- // 모듈을 다시 로드하여 기본값 테스트
27
- vi.resetModules();
28
- const { mementoConfig: config } = require('./index.js');
29
-
30
- expect(config.dbPath).toBe('./data/memory.db');
31
- expect(config.serverName).toBe('memento-memory');
32
- expect(config.serverVersion).toBe('0.1.0');
33
- expect(config.port).toBe(3000);
34
- expect(config.embeddingProvider).toBe('openai');
35
- expect(config.embeddingDimensions).toBe(1536);
36
- expect(config.searchDefaultLimit).toBe(10);
37
- expect(config.searchMaxLimit).toBe(50);
38
- expect(config.logLevel).toBe('info');
39
- expect(config.nodeEnv).toBe('development');
40
- });
41
-
42
- it('환경 변수에서 설정값을 읽어야 함', () => {
43
- process.env = {
44
- DB_PATH: '/custom/db/path',
45
- MCP_SERVER_NAME: 'custom-server',
46
- MCP_SERVER_VERSION: '1.0.0',
47
- MCP_SERVER_PORT: '8080',
48
- EMBEDDING_PROVIDER: 'gemini',
49
- OPENAI_API_KEY: 'test-openai-key',
50
- GEMINI_API_KEY: 'test-gemini-key',
51
- EMBEDDING_DIMENSIONS: '768',
52
- SEARCH_DEFAULT_LIMIT: '20',
53
- SEARCH_MAX_LIMIT: '100',
54
- LOG_LEVEL: 'debug',
55
- NODE_ENV: 'production'
56
- };
57
-
58
- vi.resetModules();
59
- const { mementoConfig: config } = require('./index.js');
60
-
61
- expect(config.dbPath).toBe('/custom/db/path');
62
- expect(config.serverName).toBe('custom-server');
63
- expect(config.serverVersion).toBe('1.0.0');
64
- expect(config.port).toBe(8080);
65
- expect(config.embeddingProvider).toBe('gemini');
66
- expect(config.openaiApiKey).toBe('test-openai-key');
67
- expect(config.geminiApiKey).toBe('test-gemini-key');
68
- expect(config.embeddingDimensions).toBe(768);
69
- expect(config.searchDefaultLimit).toBe(20);
70
- expect(config.searchMaxLimit).toBe(100);
71
- expect(config.logLevel).toBe('debug');
72
- expect(config.nodeEnv).toBe('production');
73
- });
74
-
75
- it('망각 TTL 설정을 올바르게 가져야 함', () => {
76
- process.env = {
77
- FORGET_WORKING_TTL: '24',
78
- FORGET_EPISODIC_TTL: '720', // 30일
79
- FORGET_SEMANTIC_TTL: '-1',
80
- FORGET_PROCEDURAL_TTL: '-1'
81
- };
82
-
83
- vi.resetModules();
84
- const { mementoConfig: config } = require('./index.js');
85
-
86
- expect(config.forgetTTL.working).toBe(24);
87
- expect(config.forgetTTL.episodic).toBe(720);
88
- expect(config.forgetTTL.semantic).toBe(-1);
89
- expect(config.forgetTTL.procedural).toBe(-1);
90
- });
91
-
92
- it('기본 망각 TTL 설정을 가져야 함', () => {
93
- process.env = {};
94
-
95
- vi.resetModules();
96
- const { mementoConfig: config } = require('./index.js');
97
-
98
- expect(config.forgetTTL.working).toBe(48);
99
- expect(config.forgetTTL.episodic).toBe(2160); // 90일
100
- expect(config.forgetTTL.semantic).toBe(-1);
101
- expect(config.forgetTTL.procedural).toBe(-1);
102
- });
103
- });
104
-
105
- describe('searchRankingWeights', () => {
106
- it('올바른 검색 랭킹 가중치를 가져야 함', () => {
107
- expect(searchRankingWeights.relevance).toBe(0.50);
108
- expect(searchRankingWeights.recency).toBe(0.20);
109
- expect(searchRankingWeights.importance).toBe(0.20);
110
- expect(searchRankingWeights.usage).toBe(0.10);
111
- expect(searchRankingWeights.duplication_penalty).toBe(0.15);
112
- });
113
-
114
- it('가중치의 합이 1에 가까워야 함', () => {
115
- const sum = Object.values(searchRankingWeights).reduce((a, b) => a + b, 0);
116
- expect(sum).toBeCloseTo(1, 2);
117
- });
118
- });
119
-
120
- describe('defaultTags', () => {
121
- it('기본 태그 분류를 가져야 함', () => {
122
- expect(defaultTags.tech).toContain('javascript');
123
- expect(defaultTags.tech).toContain('typescript');
124
- expect(defaultTags.tech).toContain('react');
125
- expect(defaultTags.pref).toContain('coffee');
126
- expect(defaultTags.pref).toContain('tea');
127
- expect(defaultTags.task).toContain('bug-fix');
128
- expect(defaultTags.task).toContain('feature');
129
- expect(defaultTags.project).toContain('memento');
130
- });
131
-
132
- it('각 카테고리가 배열이어야 함', () => {
133
- expect(Array.isArray(defaultTags.tech)).toBe(true);
134
- expect(Array.isArray(defaultTags.pref)).toBe(true);
135
- expect(Array.isArray(defaultTags.task)).toBe(true);
136
- expect(Array.isArray(defaultTags.project)).toBe(true);
137
- });
138
- });
139
-
140
- describe('validateConfig', () => {
141
- it('유효한 설정에 대해 에러를 던지지 않아야 함', () => {
142
- process.env = {
143
- EMBEDDING_PROVIDER: 'openai',
144
- OPENAI_API_KEY: 'test-key',
145
- EMBEDDING_DIMENSIONS: '1536',
146
- SEARCH_DEFAULT_LIMIT: '10',
147
- SEARCH_MAX_LIMIT: '50'
148
- };
149
-
150
- vi.resetModules();
151
- const { validateConfig: validate } = require('./index.js');
152
-
153
- expect(() => validate()).not.toThrow();
154
- });
155
-
156
- it('OpenAI 제공자에 API 키가 없으면 에러를 던져야 함', () => {
157
- process.env = {
158
- EMBEDDING_PROVIDER: 'openai',
159
- OPENAI_API_KEY: '',
160
- EMBEDDING_DIMENSIONS: '1536',
161
- SEARCH_DEFAULT_LIMIT: '10',
162
- SEARCH_MAX_LIMIT: '50'
163
- };
164
-
165
- vi.resetModules();
166
- const { validateConfig: validate } = require('./index.js');
167
-
168
- expect(() => validate()).toThrow('OPENAI_API_KEY is required when using OpenAI embedding provider');
169
- });
170
-
171
- it('Gemini 제공자에 API 키가 없으면 에러를 던져야 함', () => {
172
- process.env = {
173
- EMBEDDING_PROVIDER: 'gemini',
174
- GEMINI_API_KEY: '',
175
- EMBEDDING_DIMENSIONS: '768',
176
- SEARCH_DEFAULT_LIMIT: '10',
177
- SEARCH_MAX_LIMIT: '50'
178
- };
179
-
180
- vi.resetModules();
181
- const { validateConfig: validate } = require('./index.js');
182
-
183
- expect(() => validate()).toThrow('GEMINI_API_KEY is required when using Gemini embedding provider');
184
- });
185
-
186
- it('프로덕션 환경에서 OpenAI API 키가 없으면 에러를 던져야 함', () => {
187
- process.env = {
188
- EMBEDDING_PROVIDER: 'openai',
189
- OPENAI_API_KEY: '',
190
- NODE_ENV: 'production',
191
- EMBEDDING_DIMENSIONS: '1536',
192
- SEARCH_DEFAULT_LIMIT: '10',
193
- SEARCH_MAX_LIMIT: '50'
194
- };
195
-
196
- vi.resetModules();
197
- const { validateConfig: validate } = require('./index.js');
198
-
199
- expect(() => validate()).toThrow('OPENAI_API_KEY is required in production environment');
200
- });
201
-
202
- it('임베딩 차원이 0 이하면 에러를 던져야 함', () => {
203
- process.env = {
204
- EMBEDDING_PROVIDER: 'openai',
205
- OPENAI_API_KEY: 'test-key',
206
- EMBEDDING_DIMENSIONS: '0',
207
- SEARCH_DEFAULT_LIMIT: '10',
208
- SEARCH_MAX_LIMIT: '50'
209
- };
210
-
211
- vi.resetModules();
212
- const { validateConfig: validate } = require('./index.js');
213
-
214
- expect(() => validate()).toThrow('EMBEDDING_DIMENSIONS must be a positive number');
215
- });
216
-
217
- it('검색 제한이 0 이하면 에러를 던져야 함', () => {
218
- process.env = {
219
- EMBEDDING_PROVIDER: 'openai',
220
- OPENAI_API_KEY: 'test-key',
221
- EMBEDDING_DIMENSIONS: '1536',
222
- SEARCH_DEFAULT_LIMIT: '0',
223
- SEARCH_MAX_LIMIT: '50'
224
- };
225
-
226
- vi.resetModules();
227
- const { validateConfig: validate } = require('./index.js');
228
-
229
- expect(() => validate()).toThrow('Search limits must be positive numbers');
230
- });
231
-
232
- it('기본 검색 제한이 최대 검색 제한보다 크면 에러를 던져야 함', () => {
233
- process.env = {
234
- EMBEDDING_PROVIDER: 'openai',
235
- OPENAI_API_KEY: 'test-key',
236
- EMBEDDING_DIMENSIONS: '1536',
237
- SEARCH_DEFAULT_LIMIT: '100',
238
- SEARCH_MAX_LIMIT: '50'
239
- };
240
-
241
- vi.resetModules();
242
- const { validateConfig: validate } = require('./index.js');
243
-
244
- expect(() => validate()).toThrow('SEARCH_DEFAULT_LIMIT cannot be greater than SEARCH_MAX_LIMIT');
245
- });
246
-
247
- it('경량 임베딩 제공자는 API 키 없이도 통과해야 함', () => {
248
- process.env = {
249
- EMBEDDING_PROVIDER: 'lightweight',
250
- EMBEDDING_DIMENSIONS: '512',
251
- SEARCH_DEFAULT_LIMIT: '10',
252
- SEARCH_MAX_LIMIT: '50'
253
- };
254
-
255
- vi.resetModules();
256
- const { validateConfig: validate } = require('./index.js');
257
-
258
- expect(() => validate()).not.toThrow();
259
- });
260
- });
261
-
262
- describe('환경 변수 파싱', () => {
263
- it('포트 번호를 올바르게 파싱해야 함', () => {
264
- process.env.MCP_SERVER_PORT = '8080';
265
-
266
- vi.resetModules();
267
- const { mementoConfig: config } = require('./index.js');
268
-
269
- expect(config.port).toBe(8080);
270
- expect(typeof config.port).toBe('number');
271
- });
272
-
273
- it('잘못된 포트 번호에 대해 NaN을 처리해야 함', () => {
274
- process.env.MCP_SERVER_PORT = 'invalid';
275
-
276
- vi.resetModules();
277
- const { mementoConfig: config } = require('./index.js');
278
-
279
- expect(Number.isNaN(config.port)).toBe(true);
280
- });
281
-
282
- it('숫자 설정값들을 올바르게 파싱해야 함', () => {
283
- process.env = {
284
- EMBEDDING_DIMENSIONS: '768',
285
- SEARCH_DEFAULT_LIMIT: '20',
286
- SEARCH_MAX_LIMIT: '100',
287
- FORGET_WORKING_TTL: '24'
288
- };
289
-
290
- vi.resetModules();
291
- const { mementoConfig: config } = require('./index.js');
292
-
293
- expect(config.embeddingDimensions).toBe(768);
294
- expect(config.searchDefaultLimit).toBe(20);
295
- expect(config.searchMaxLimit).toBe(100);
296
- expect(config.forgetTTL.working).toBe(24);
297
- });
298
-
299
- it('빈 문자열에 대해 기본값을 사용해야 함', () => {
300
- process.env = {
301
- DB_PATH: '',
302
- MCP_SERVER_NAME: '',
303
- LOG_LEVEL: ''
304
- };
305
-
306
- vi.resetModules();
307
- const { mementoConfig: config } = require('./index.js');
308
-
309
- expect(config.dbPath).toBe('./data/memory.db');
310
- expect(config.serverName).toBe('memento-memory');
311
- expect(config.logLevel).toBe('info');
312
- });
313
- });
314
-
315
- describe('설정 객체 구조', () => {
316
- it('mementoConfig가 올바른 구조를 가져야 함', () => {
317
- expect(mementoConfig).toHaveProperty('dbPath');
318
- expect(mementoConfig).toHaveProperty('serverName');
319
- expect(mementoConfig).toHaveProperty('serverVersion');
320
- expect(mementoConfig).toHaveProperty('port');
321
- expect(mementoConfig).toHaveProperty('embeddingProvider');
322
- expect(mementoConfig).toHaveProperty('openaiApiKey');
323
- expect(mementoConfig).toHaveProperty('geminiApiKey');
324
- expect(mementoConfig).toHaveProperty('embeddingDimensions');
325
- expect(mementoConfig).toHaveProperty('searchDefaultLimit');
326
- expect(mementoConfig).toHaveProperty('searchMaxLimit');
327
- expect(mementoConfig).toHaveProperty('forgetTTL');
328
- expect(mementoConfig).toHaveProperty('logLevel');
329
- expect(mementoConfig).toHaveProperty('nodeEnv');
330
- });
331
-
332
- it('forgetTTL이 올바른 구조를 가져야 함', () => {
333
- expect(mementoConfig.forgetTTL).toHaveProperty('working');
334
- expect(mementoConfig.forgetTTL).toHaveProperty('episodic');
335
- expect(mementoConfig.forgetTTL).toHaveProperty('semantic');
336
- expect(mementoConfig.forgetTTL).toHaveProperty('procedural');
337
- });
338
- });
339
- });
@@ -1,106 +0,0 @@
1
- /**
2
- * Memento MCP Server 설정 관리
3
- */
4
-
5
- import { config } from 'dotenv';
6
- import type { MementoConfig, EmbeddingProvider } from '../types/index.js';
7
-
8
- // 환경 변수 로드
9
- config();
10
-
11
- export const mementoConfig: MementoConfig = {
12
- // 데이터베이스 설정
13
- dbPath: process.env.DB_PATH || './data/memory.db',
14
-
15
- // MCP 서버 설정
16
- serverName: process.env.MCP_SERVER_NAME || 'memento-memory',
17
- serverVersion: process.env.MCP_SERVER_VERSION || '0.1.0',
18
- port: parseInt(process.env.MCP_SERVER_PORT || '3000', 10),
19
-
20
- // 임베딩 설정
21
- embeddingProvider: (process.env.EMBEDDING_PROVIDER as EmbeddingProvider) || 'minilm',
22
- openaiApiKey: process.env.OPENAI_API_KEY || undefined,
23
- openaiModel: process.env.OPENAI_MODEL || 'text-embedding-3-small',
24
- geminiApiKey: process.env.GEMINI_API_KEY || undefined,
25
- geminiModel: process.env.GEMINI_MODEL || 'text-embedding-004',
26
- embeddingDimensions: parseInt(process.env.EMBEDDING_DIMENSIONS || '384', 10), // MiniLM 기본값
27
-
28
- // 검색 설정
29
- searchDefaultLimit: parseInt(process.env.SEARCH_DEFAULT_LIMIT || '10', 10),
30
- searchMaxLimit: parseInt(process.env.SEARCH_MAX_LIMIT || '50', 10),
31
-
32
- // 망각 정책 설정 (시간 단위: 시간)
33
- forgetTTL: {
34
- working: parseInt(process.env.FORGET_WORKING_TTL || '48', 10),
35
- episodic: parseInt(process.env.FORGET_EPISODIC_TTL || '2160', 10), // 90일
36
- semantic: parseInt(process.env.FORGET_SEMANTIC_TTL || '-1', 10), // 무기한
37
- procedural: parseInt(process.env.FORGET_PROCEDURAL_TTL || '-1', 10) // 무기한
38
- },
39
-
40
- // 로깅 설정
41
- logLevel: process.env.LOG_LEVEL || 'info',
42
- logFile: process.env.LOG_FILE || undefined,
43
-
44
- // 개발 설정
45
- nodeEnv: process.env.NODE_ENV || 'development'
46
- };
47
-
48
- // 검색 랭킹 가중치 (Memento-Goals.md 참조)
49
- export const searchRankingWeights = {
50
- relevance: 0.50,
51
- recency: 0.20,
52
- importance: 0.20,
53
- usage: 0.10,
54
- duplication_penalty: 0.15
55
- };
56
-
57
- // 기본 태그 분류
58
- export const defaultTags = {
59
- tech: ['javascript', 'typescript', 'react', 'node', 'sqlite', 'mcp'],
60
- pref: ['coffee', 'tea', 'morning', 'evening'],
61
- task: ['ads-settlement', 'bug-fix', 'feature', 'refactor'],
62
- project: ['memento', 'mcp-server', 'ai-agent']
63
- };
64
-
65
- // 유효성 검사
66
- export function validateConfig(): void {
67
- // 임베딩 제공자별 API 키 검증
68
- if (mementoConfig.embeddingProvider === 'openai' && !mementoConfig.openaiApiKey) {
69
- throw new Error('OPENAI_API_KEY is required when using OpenAI embedding provider');
70
- }
71
-
72
- if (mementoConfig.embeddingProvider === 'gemini' && !mementoConfig.geminiApiKey) {
73
- throw new Error('GEMINI_API_KEY is required when using Gemini embedding provider');
74
- }
75
-
76
- // 유효한 임베딩 제공자 확인
77
- const validProviders = ['tfidf', 'lightweight', 'minilm', 'openai', 'gemini'];
78
- if (!validProviders.includes(mementoConfig.embeddingProvider)) {
79
- throw new Error(`Invalid embedding provider: ${mementoConfig.embeddingProvider}. Must be one of: ${validProviders.join(', ')}`);
80
- }
81
-
82
- // 차원 수 검증 (제공자별 권장값)
83
- const providerDimensions = {
84
- tfidf: 512,
85
- minilm: 384,
86
- openai: 1536,
87
- gemini: 768
88
- };
89
-
90
- const expectedDimensions = providerDimensions[mementoConfig.embeddingProvider as keyof typeof providerDimensions];
91
- if (mementoConfig.embeddingDimensions !== expectedDimensions) {
92
- console.warn(`⚠️ 권장 차원 수와 다릅니다. ${mementoConfig.embeddingProvider}는 ${expectedDimensions}차원을 권장합니다.`);
93
- }
94
-
95
- if (mementoConfig.embeddingDimensions <= 0) {
96
- throw new Error('EMBEDDING_DIMENSIONS must be a positive number');
97
- }
98
-
99
- if (mementoConfig.searchDefaultLimit <= 0 || mementoConfig.searchMaxLimit <= 0) {
100
- throw new Error('Search limits must be positive numbers');
101
- }
102
-
103
- if (mementoConfig.searchDefaultLimit > mementoConfig.searchMaxLimit) {
104
- throw new Error('SEARCH_DEFAULT_LIMIT cannot be greater than SEARCH_MAX_LIMIT');
105
- }
106
- }
@@ -1,239 +0,0 @@
1
- import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
2
- import { initializeDatabase } from './init.js';
3
- import Database from 'better-sqlite3';
4
- import { readFileSync } from 'fs';
5
- import { mementoConfig } from '../config/index.js';
6
-
7
- // Mock dependencies
8
- vi.mock('better-sqlite3');
9
- vi.mock('fs');
10
- vi.mock('../config/index.js', () => ({
11
- mementoConfig: {
12
- dbPath: './test-data/test.db'
13
- }
14
- }));
15
-
16
- // Mock file system
17
- const mockMkdirSync = vi.fn();
18
- const mockExistsSync = vi.fn();
19
-
20
- vi.mock('fs', () => ({
21
- readFileSync: vi.fn(),
22
- existsSync: mockExistsSync,
23
- mkdirSync: mockMkdirSync
24
- }));
25
-
26
- // Mock path and url modules
27
- vi.mock('path', () => ({
28
- join: vi.fn((...args) => args.join('/')),
29
- dirname: vi.fn((path) => path.split('/').slice(0, -1).join('/'))
30
- }));
31
-
32
- vi.mock('url', () => ({
33
- fileURLToPath: vi.fn(() => '/test/path/init.js')
34
- }));
35
-
36
- describe('Database Init', () => {
37
- let mockDb: any;
38
-
39
- beforeEach(() => {
40
- vi.clearAllMocks();
41
-
42
- // Mock database instance
43
- mockDb = {
44
- pragma: vi.fn(),
45
- loadExtension: vi.fn(),
46
- exec: vi.fn(),
47
- close: vi.fn(),
48
- prepare: vi.fn().mockReturnValue({
49
- run: vi.fn(),
50
- all: vi.fn(),
51
- get: vi.fn()
52
- })
53
- };
54
-
55
- vi.mocked(Database).mockImplementation(() => mockDb);
56
- mockExistsSync.mockReturnValue(false);
57
- mockMkdirSync.mockImplementation(() => {});
58
- vi.mocked(readFileSync).mockReturnValue('CREATE TABLE test (id INTEGER PRIMARY KEY);');
59
- });
60
-
61
- afterEach(() => {
62
- vi.restoreAllMocks();
63
- });
64
-
65
- describe('initializeDatabase', () => {
66
- it('데이터베이스를 성공적으로 초기화해야 함', () => {
67
- const result = initializeDatabase();
68
-
69
- expect(result).toBe(mockDb);
70
- expect(Database).toHaveBeenCalledWith('./test-data/test.db');
71
- });
72
-
73
- it('데이터 디렉토리를 생성해야 함', () => {
74
- mockExistsSync.mockReturnValue(false);
75
-
76
- initializeDatabase();
77
-
78
- expect(mockMkdirSync).toHaveBeenCalledWith('./test-data', { recursive: true });
79
- });
80
-
81
- it('디렉토리가 이미 존재하면 생성하지 않아야 함', () => {
82
- mockExistsSync.mockReturnValue(true);
83
-
84
- initializeDatabase();
85
-
86
- expect(mockMkdirSync).not.toHaveBeenCalled();
87
- });
88
-
89
- it('WAL 모드를 활성화해야 함', () => {
90
- initializeDatabase();
91
-
92
- expect(mockDb.pragma).toHaveBeenCalledWith('journal_mode = WAL');
93
- });
94
-
95
- it('외래키 제약 조건을 활성화해야 함', () => {
96
- initializeDatabase();
97
-
98
- expect(mockDb.pragma).toHaveBeenCalledWith('foreign_keys = ON');
99
- });
100
-
101
- it('프로덕션 환경에서 FTS5 확장을 로드하지 않아야 함', () => {
102
- process.env.NODE_ENV = 'production';
103
-
104
- initializeDatabase();
105
-
106
- expect(mockDb.loadExtension).not.toHaveBeenCalled();
107
- });
108
-
109
- it('Docker 환경에서 FTS5 확장을 로드하지 않아야 함', () => {
110
- process.env.DOCKER = 'true';
111
-
112
- initializeDatabase();
113
-
114
- expect(mockDb.loadExtension).not.toHaveBeenCalled();
115
- });
116
-
117
- it('로컬 환경에서 FTS5 확장을 로드해야 함', () => {
118
- process.env.NODE_ENV = 'development';
119
- process.env.DOCKER = 'false';
120
-
121
- initializeDatabase();
122
-
123
- expect(mockDb.loadExtension).toHaveBeenCalledWith('fts5');
124
- });
125
-
126
- it('FTS5 로드 실패 시 경고를 출력해야 함', () => {
127
- const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
128
- mockDb.loadExtension.mockImplementation(() => {
129
- throw new Error('FTS5 not available');
130
- });
131
-
132
- initializeDatabase();
133
-
134
- expect(consoleSpy).toHaveBeenCalledWith('⚠️ FTS5 확장을 로드할 수 없습니다. 텍스트 검색 기능이 제한될 수 있습니다.');
135
- });
136
-
137
- it('스키마 파일을 읽고 실행해야 함', () => {
138
- initializeDatabase();
139
-
140
- expect(readFileSync).toHaveBeenCalled();
141
- expect(mockDb.exec).toHaveBeenCalledWith('CREATE TABLE test (id INTEGER PRIMARY KEY);');
142
- });
143
-
144
- it('스키마 파일 읽기 실패 시 에러를 던져야 함', () => {
145
- vi.mocked(readFileSync).mockImplementation(() => {
146
- throw new Error('File not found');
147
- });
148
-
149
- expect(() => initializeDatabase()).toThrow('스키마 파일을 읽을 수 없습니다');
150
- });
151
-
152
- it('데이터베이스 초기화 실패 시 에러를 던져야 함', () => {
153
- vi.mocked(Database).mockImplementation(() => {
154
- throw new Error('Database connection failed');
155
- });
156
-
157
- expect(() => initializeDatabase()).toThrow('Database connection failed');
158
- });
159
-
160
- it('디렉토리 생성 실패 시 에러를 무시해야 함', () => {
161
- mockExistsSync.mockReturnValue(false);
162
- mockMkdirSync.mockImplementation(() => {
163
- throw new Error('Permission denied');
164
- });
165
-
166
- // 에러가 발생하지 않아야 함
167
- expect(() => initializeDatabase()).not.toThrow();
168
- });
169
-
170
- it('환경 변수에 따라 다른 동작을 해야 함', () => {
171
- process.env.NODE_ENV = 'test';
172
- process.env.DOCKER = 'false';
173
-
174
- initializeDatabase();
175
-
176
- expect(mockDb.loadExtension).toHaveBeenCalledWith('fts5');
177
- });
178
- });
179
-
180
- describe('데이터베이스 설정', () => {
181
- it('올바른 데이터베이스 경로를 사용해야 함', () => {
182
- initializeDatabase();
183
-
184
- expect(Database).toHaveBeenCalledWith('./test-data/test.db');
185
- });
186
-
187
- it('데이터베이스 연결 후 설정을 적용해야 함', () => {
188
- initializeDatabase();
189
-
190
- expect(mockDb.pragma).toHaveBeenCalledWith('journal_mode = WAL');
191
- expect(mockDb.pragma).toHaveBeenCalledWith('foreign_keys = ON');
192
- });
193
- });
194
-
195
- describe('에러 처리', () => {
196
- it('스키마 실행 실패 시 에러를 던져야 함', () => {
197
- mockDb.exec.mockImplementation(() => {
198
- throw new Error('SQL execution failed');
199
- });
200
-
201
- expect(() => initializeDatabase()).toThrow('데이터베이스 초기화에 실패했습니다');
202
- });
203
-
204
- it('데이터베이스 연결 실패 시 적절한 에러를 던져야 함', () => {
205
- vi.mocked(Database).mockImplementation(() => {
206
- throw new Error('Connection failed');
207
- });
208
-
209
- expect(() => initializeDatabase()).toThrow('Connection failed');
210
- });
211
- });
212
-
213
- describe('환경별 동작', () => {
214
- it('개발 환경에서 FTS5를 로드해야 함', () => {
215
- process.env.NODE_ENV = 'development';
216
- delete process.env.DOCKER;
217
-
218
- initializeDatabase();
219
-
220
- expect(mockDb.loadExtension).toHaveBeenCalledWith('fts5');
221
- });
222
-
223
- it('프로덕션 환경에서 FTS5를 로드하지 않아야 함', () => {
224
- process.env.NODE_ENV = 'production';
225
-
226
- initializeDatabase();
227
-
228
- expect(mockDb.loadExtension).not.toHaveBeenCalled();
229
- });
230
-
231
- it('Docker 환경에서 FTS5를 로드하지 않아야 함', () => {
232
- process.env.DOCKER = 'true';
233
-
234
- initializeDatabase();
235
-
236
- expect(mockDb.loadExtension).not.toHaveBeenCalled();
237
- });
238
- });
239
- });