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,793 +0,0 @@
1
- /**
2
- * Memento MCP Server 메인 진입점
3
- */
4
- import { Server } from '@modelcontextprotocol/sdk/server/index.js';
5
- import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
6
- import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
7
- import { z } from 'zod';
8
- import { initializeDatabase, closeDatabase } from '../database/init.js';
9
- import { mementoConfig, validateConfig } from '../config/index.js';
10
- import { DatabaseUtils } from '../utils/database.js';
11
- import { SearchEngine } from '../algorithms/search-engine.js';
12
- import { HybridSearchEngine } from '../algorithms/hybrid-search-engine.js';
13
- import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
14
- import { ForgettingPolicyService } from '../services/forgetting-policy-service.js';
15
- import { PerformanceMonitor } from '../services/performance-monitor.js';
16
- import { SearchCacheService } from '../services/cache-service.js';
17
- import { DatabaseOptimizer } from '../services/database-optimizer.js';
18
- import Database from 'better-sqlite3';
19
- // MCP 서버 인스턴스
20
- let server;
21
- let db = null;
22
- let searchEngine;
23
- let hybridSearchEngine;
24
- let embeddingService;
25
- let forgettingPolicyService;
26
- let performanceMonitor;
27
- let searchCache;
28
- let databaseOptimizer;
29
- // MCP 서버에서는 모든 로그 출력을 완전히 차단
30
- // 모든 console 메서드를 빈 함수로 교체
31
- console.log = () => { };
32
- console.error = () => { };
33
- console.warn = () => { };
34
- console.info = () => { };
35
- console.debug = () => { };
36
- // MCP Tools 스키마 정의
37
- const RememberSchema = z.object({
38
- content: z.string().min(1, 'Content cannot be empty'),
39
- type: z.enum(['working', 'episodic', 'semantic', 'procedural']).default('episodic'),
40
- tags: z.array(z.string()).optional(),
41
- importance: z.number().min(0).max(1).default(0.5),
42
- source: z.string().optional(),
43
- privacy_scope: z.enum(['private', 'team', 'public']).default('private')
44
- });
45
- const RecallSchema = z.object({
46
- query: z.string().min(1, 'Query cannot be empty'),
47
- filters: z.object({
48
- type: z.array(z.enum(['working', 'episodic', 'semantic', 'procedural'])).optional(),
49
- tags: z.array(z.string()).optional(),
50
- privacy_scope: z.array(z.enum(['private', 'team', 'public'])).optional(),
51
- time_from: z.string().optional(),
52
- time_to: z.string().optional(),
53
- pinned: z.boolean().optional()
54
- }).optional(),
55
- limit: z.number().min(1).max(50).default(10)
56
- });
57
- const ForgetSchema = z.object({
58
- id: z.string().min(1, 'Memory ID cannot be empty'),
59
- hard: z.boolean().default(false)
60
- });
61
- const PinSchema = z.object({
62
- id: z.string().min(1, 'Memory ID cannot be empty')
63
- });
64
- const UnpinSchema = z.object({
65
- id: z.string().min(1, 'Memory ID cannot be empty')
66
- });
67
- // 망각 정책 관련 스키마
68
- const CleanupMemorySchema = z.object({
69
- dry_run: z.boolean().default(false).optional()
70
- });
71
- const ForgettingStatsSchema = z.object({});
72
- // 성능 모니터링 관련 스키마
73
- const PerformanceStatsSchema = z.object({});
74
- const DatabaseOptimizeSchema = z.object({
75
- analyze: z.boolean().default(false).optional(),
76
- create_indexes: z.boolean().default(false).optional()
77
- });
78
- // Tool 핸들러들 (개선된 구현)
79
- async function handleRemember(params) {
80
- const { content, type, tags, importance, source, privacy_scope } = params;
81
- // UUID 생성 (임시로 간단한 ID 사용)
82
- const id = `mem_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
83
- // 데이터베이스 연결 확인
84
- if (!db) {
85
- throw new Error('데이터베이스가 초기화되지 않았습니다');
86
- }
87
- try {
88
- // 개선된 트랜잭션 재시도 로직 사용
89
- const result = await DatabaseUtils.runTransaction(db, async () => {
90
- await DatabaseUtils.run(db, `
91
- INSERT INTO memory_item (id, type, content, importance, privacy_scope, tags, source, created_at)
92
- VALUES (?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP)
93
- `, [id, type, content, importance, privacy_scope,
94
- tags ? JSON.stringify(tags) : null, source]);
95
- return { id, type, content, importance, privacy_scope, tags, source };
96
- });
97
- // 임베딩 생성 (비동기, 실패해도 메모리 저장은 성공)
98
- if (embeddingService.isAvailable()) {
99
- embeddingService.createAndStoreEmbedding(db, id, content, type)
100
- .then(result => {
101
- if (result) {
102
- // 임베딩 생성 완료
103
- }
104
- })
105
- .catch(error => {
106
- console.warn(`⚠️ 임베딩 생성 실패 (${id}):`, error.message);
107
- });
108
- }
109
- return {
110
- content: [
111
- {
112
- type: 'text',
113
- text: JSON.stringify({
114
- memory_id: id,
115
- message: `기억이 저장되었습니다: ${id}`,
116
- embedding_created: embeddingService.isAvailable()
117
- })
118
- }
119
- ]
120
- };
121
- }
122
- catch (error) {
123
- // 데이터베이스 락 문제인 경우 WAL 체크포인트 시도
124
- if (error.code === 'SQLITE_BUSY') {
125
- // 데이터베이스 락 감지, WAL 체크포인트 시도
126
- try {
127
- await DatabaseUtils.checkpointWAL(db);
128
- // WAL 체크포인트 완료
129
- }
130
- catch (checkpointError) {
131
- // WAL 체크포인트 실패
132
- }
133
- }
134
- throw error;
135
- }
136
- }
137
- async function handleRecall(params) {
138
- const { query, filters, limit } = params;
139
- if (!db) {
140
- throw new Error('데이터베이스가 초기화되지 않았습니다');
141
- }
142
- if (!hybridSearchEngine) {
143
- throw new Error('하이브리드 검색 엔진이 초기화되지 않았습니다');
144
- }
145
- // 하이브리드 검색 엔진 사용 (텍스트 + 벡터 검색)
146
- const results = await hybridSearchEngine.search(db, {
147
- query,
148
- filters,
149
- limit,
150
- vectorWeight: 0.6, // 벡터 검색 60%
151
- textWeight: 0.4, // 텍스트 검색 40%
152
- });
153
- return {
154
- content: [
155
- {
156
- type: 'text',
157
- text: JSON.stringify({
158
- items: results,
159
- search_type: 'hybrid',
160
- vector_search_available: hybridSearchEngine.isEmbeddingAvailable()
161
- })
162
- }
163
- ]
164
- };
165
- }
166
- async function handleForget(params) {
167
- const { id, hard } = params;
168
- if (!db) {
169
- throw new Error('데이터베이스가 초기화되지 않았습니다');
170
- }
171
- try {
172
- // 개선된 트랜잭션 재시도 로직 사용
173
- const result = await DatabaseUtils.runTransaction(db, async () => {
174
- if (hard) {
175
- // 하드 삭제
176
- const deleteResult = await DatabaseUtils.run(db, 'DELETE FROM memory_item WHERE id = ?', [id]);
177
- if (deleteResult.changes === 0) {
178
- throw new Error(`Memory with ID ${id} not found`);
179
- }
180
- return { type: 'hard', changes: deleteResult.changes };
181
- }
182
- else {
183
- // 소프트 삭제 (pinned 해제 후 TTL에 의해 삭제)
184
- const updateResult = await DatabaseUtils.run(db, 'UPDATE memory_item SET pinned = FALSE WHERE id = ?', [id]);
185
- if (updateResult.changes === 0) {
186
- throw new Error(`Memory with ID ${id} not found`);
187
- }
188
- return { type: 'soft', changes: updateResult.changes };
189
- }
190
- });
191
- // 임베딩도 삭제 (하드 삭제인 경우)
192
- if (hard && embeddingService.isAvailable()) {
193
- try {
194
- await embeddingService.deleteEmbedding(db, id);
195
- }
196
- catch (embeddingError) {
197
- console.warn(`⚠️ 임베딩 삭제 실패 (${id}):`, embeddingError);
198
- }
199
- }
200
- return {
201
- content: [
202
- {
203
- type: 'text',
204
- text: JSON.stringify({
205
- memory_id: id,
206
- message: hard ? `기억이 완전히 삭제되었습니다: ${id}` : `기억이 삭제 대상으로 표시되었습니다: ${id}`
207
- })
208
- }
209
- ]
210
- };
211
- }
212
- catch (error) {
213
- // 데이터베이스 락 문제인 경우 WAL 체크포인트 시도
214
- if (error.code === 'SQLITE_BUSY') {
215
- // 데이터베이스 락 감지, WAL 체크포인트 시도
216
- try {
217
- await DatabaseUtils.checkpointWAL(db);
218
- // WAL 체크포인트 완료
219
- }
220
- catch (checkpointError) {
221
- // WAL 체크포인트 실패
222
- }
223
- }
224
- throw error;
225
- }
226
- }
227
- async function handlePin(params) {
228
- const { id } = params;
229
- if (!db) {
230
- throw new Error('데이터베이스가 초기화되지 않았습니다');
231
- }
232
- try {
233
- // 개선된 트랜잭션 재시도 로직 사용
234
- await DatabaseUtils.runTransaction(db, async () => {
235
- const result = await DatabaseUtils.run(db, 'UPDATE memory_item SET pinned = TRUE WHERE id = ?', [id]);
236
- if (result.changes === 0) {
237
- throw new Error(`Memory with ID ${id} not found`);
238
- }
239
- return result;
240
- });
241
- return {
242
- content: [
243
- {
244
- type: 'text',
245
- text: JSON.stringify({
246
- memory_id: id,
247
- message: `기억이 고정되었습니다: ${id}`
248
- })
249
- }
250
- ]
251
- };
252
- }
253
- catch (error) {
254
- // 데이터베이스 락 문제인 경우 WAL 체크포인트 시도
255
- if (error.code === 'SQLITE_BUSY') {
256
- // 데이터베이스 락 감지, WAL 체크포인트 시도
257
- try {
258
- await DatabaseUtils.checkpointWAL(db);
259
- // WAL 체크포인트 완료
260
- }
261
- catch (checkpointError) {
262
- // WAL 체크포인트 실패
263
- }
264
- }
265
- throw error;
266
- }
267
- }
268
- async function handleUnpin(params) {
269
- const { id } = params;
270
- if (!db) {
271
- throw new Error('데이터베이스가 초기화되지 않았습니다');
272
- }
273
- try {
274
- // 개선된 트랜잭션 재시도 로직 사용
275
- await DatabaseUtils.runTransaction(db, async () => {
276
- const result = await DatabaseUtils.run(db, 'UPDATE memory_item SET pinned = FALSE WHERE id = ?', [id]);
277
- if (result.changes === 0) {
278
- throw new Error(`Memory with ID ${id} not found`);
279
- }
280
- return result;
281
- });
282
- return {
283
- content: [
284
- {
285
- type: 'text',
286
- text: JSON.stringify({
287
- memory_id: id,
288
- message: `기억 고정이 해제되었습니다: ${id}`
289
- })
290
- }
291
- ]
292
- };
293
- }
294
- catch (error) {
295
- // 데이터베이스 락 문제인 경우 WAL 체크포인트 시도
296
- if (error.code === 'SQLITE_BUSY') {
297
- // 데이터베이스 락 감지, WAL 체크포인트 시도
298
- try {
299
- await DatabaseUtils.checkpointWAL(db);
300
- // WAL 체크포인트 완료
301
- }
302
- catch (checkpointError) {
303
- // WAL 체크포인트 실패
304
- }
305
- }
306
- throw error;
307
- }
308
- }
309
- // 망각 정책 핸들러들
310
- async function handleCleanupMemory(params) {
311
- const { dry_run } = params;
312
- if (!db) {
313
- throw new Error('데이터베이스가 초기화되지 않았습니다');
314
- }
315
- if (!forgettingPolicyService) {
316
- throw new Error('망각 정책 서비스가 초기화되지 않았습니다');
317
- }
318
- try {
319
- if (dry_run) {
320
- // 드라이런 모드: 실제 삭제 없이 분석만 수행
321
- const stats = await forgettingPolicyService.generateForgettingStats(db);
322
- return {
323
- content: [
324
- {
325
- type: 'text',
326
- text: JSON.stringify({
327
- mode: 'dry_run',
328
- stats: {
329
- totalMemories: stats.totalMemories,
330
- forgetCandidates: stats.forgetCandidates,
331
- reviewCandidates: stats.reviewCandidates,
332
- averageForgetScore: stats.averageForgetScore,
333
- memoryDistribution: stats.memoryDistribution
334
- },
335
- message: '망각 후보 분석 완료 (실제 삭제 없음)'
336
- })
337
- }
338
- ]
339
- };
340
- }
341
- else {
342
- // 실제 정리 실행
343
- const result = await forgettingPolicyService.executeMemoryCleanup(db);
344
- return {
345
- content: [
346
- {
347
- type: 'text',
348
- text: JSON.stringify({
349
- mode: 'execution',
350
- result: {
351
- softDeleted: result.softDeleted,
352
- hardDeleted: result.hardDeleted,
353
- reviewed: result.reviewed,
354
- totalProcessed: result.totalProcessed,
355
- summary: result.summary
356
- },
357
- message: `메모리 정리 완료: 소프트 삭제 ${result.summary.actualSoftDeletes}개, 하드 삭제 ${result.summary.actualHardDeletes}개, 리뷰 ${result.summary.actualReviews}개`
358
- })
359
- }
360
- ]
361
- };
362
- }
363
- }
364
- catch (error) {
365
- throw new Error(`메모리 정리 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
366
- }
367
- }
368
- async function handleForgettingStats(params) {
369
- if (!db) {
370
- throw new Error('데이터베이스가 초기화되지 않았습니다');
371
- }
372
- if (!forgettingPolicyService) {
373
- throw new Error('망각 정책 서비스가 초기화되지 않았습니다');
374
- }
375
- try {
376
- const stats = await forgettingPolicyService.generateForgettingStats(db);
377
- return {
378
- content: [
379
- {
380
- type: 'text',
381
- text: JSON.stringify({
382
- stats: {
383
- totalMemories: stats.totalMemories,
384
- forgetCandidates: stats.forgetCandidates,
385
- reviewCandidates: stats.reviewCandidates,
386
- averageForgetScore: stats.averageForgetScore,
387
- memoryDistribution: stats.memoryDistribution
388
- },
389
- message: '망각 통계 조회 완료'
390
- })
391
- }
392
- ]
393
- };
394
- }
395
- catch (error) {
396
- throw new Error(`망각 통계 조회 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
397
- }
398
- }
399
- // 성능 모니터링 핸들러들
400
- async function handlePerformanceStats(params) {
401
- if (!db) {
402
- throw new Error('데이터베이스가 초기화되지 않았습니다');
403
- }
404
- if (!performanceMonitor) {
405
- throw new Error('성능 모니터가 초기화되지 않았습니다');
406
- }
407
- try {
408
- const metrics = await performanceMonitor.collectMetrics();
409
- const report = await performanceMonitor.generateReport();
410
- return {
411
- content: [
412
- {
413
- type: 'text',
414
- text: JSON.stringify({
415
- metrics: {
416
- database: metrics.database,
417
- search: metrics.search,
418
- memory: metrics.memory,
419
- system: metrics.system
420
- },
421
- report: report,
422
- message: '성능 통계 조회 완료'
423
- })
424
- }
425
- ]
426
- };
427
- }
428
- catch (error) {
429
- throw new Error(`성능 통계 조회 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
430
- }
431
- }
432
- async function handleDatabaseOptimize(params) {
433
- const { analyze, create_indexes } = params;
434
- if (!db) {
435
- throw new Error('데이터베이스가 초기화되지 않았습니다');
436
- }
437
- if (!databaseOptimizer) {
438
- throw new Error('데이터베이스 최적화기가 초기화되지 않았습니다');
439
- }
440
- try {
441
- const results = {
442
- message: '데이터베이스 최적화 완료',
443
- operations: []
444
- };
445
- if (analyze) {
446
- await databaseOptimizer.analyzeDatabase();
447
- results.operations.push('데이터베이스 분석 완료');
448
- }
449
- if (create_indexes) {
450
- const recommendations = await databaseOptimizer.generateIndexRecommendations();
451
- const highPriorityRecs = recommendations.filter(r => r.priority === 'high');
452
- for (const rec of highPriorityRecs) {
453
- const indexName = `idx_${rec.table}_${rec.columns.join('_')}`;
454
- await databaseOptimizer.createIndex(indexName, rec.table, rec.columns);
455
- results.operations.push(`인덱스 생성: ${indexName}`);
456
- }
457
- }
458
- const report = await databaseOptimizer.generateOptimizationReport();
459
- return {
460
- content: [
461
- {
462
- type: 'text',
463
- text: JSON.stringify({
464
- ...results,
465
- report: report
466
- })
467
- }
468
- ]
469
- };
470
- }
471
- catch (error) {
472
- throw new Error(`데이터베이스 최적화 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
473
- }
474
- }
475
- // 데이터베이스 상태 모니터링
476
- async function monitorDatabaseStatus() {
477
- if (!db)
478
- return;
479
- try {
480
- const status = await DatabaseUtils.getDatabaseStatus(db);
481
- log('📊 데이터베이스 상태:', {
482
- journalMode: status.journalMode,
483
- walAutoCheckpoint: status.walAutoCheckpoint,
484
- busyTimeout: status.busyTimeout,
485
- isLocked: status.isLocked ? '🔒 잠김' : '🔓 정상'
486
- });
487
- // 락이 감지되면 WAL 체크포인트 실행
488
- if (status.isLocked) {
489
- log('⚠️ 데이터베이스 락 감지, WAL 체크포인트 실행...');
490
- await DatabaseUtils.checkpointWAL(db);
491
- }
492
- }
493
- catch (error) {
494
- // 데이터베이스 상태 모니터링 실패
495
- }
496
- }
497
- // MCP 모드 감지 (stdio를 통해 실행되는지 확인)
498
- const isMCPMode = process.stdin.isTTY === false && process.stdout.isTTY === false;
499
- // MCP 모드에서는 로그를 stderr로 출력
500
- const log = isMCPMode ? console.error : console.log;
501
- // MCP 서버 초기화
502
- async function initializeServer() {
503
- try {
504
- process.stderr.write('🚀 MCP 서버 초기화 시작...\n');
505
- // 설정 검증
506
- validateConfig();
507
- process.stderr.write('✅ 설정 검증 완료\n');
508
- // 데이터베이스 초기화
509
- db = await initializeDatabase();
510
- process.stderr.write('✅ 데이터베이스 초기화 완료\n');
511
- // 데이터베이스 상태 모니터링
512
- await monitorDatabaseStatus();
513
- process.stderr.write('✅ 데이터베이스 상태 모니터링 완료\n');
514
- // 검색 엔진 초기화
515
- searchEngine = new SearchEngine();
516
- hybridSearchEngine = new HybridSearchEngine();
517
- embeddingService = new MemoryEmbeddingService();
518
- forgettingPolicyService = new ForgettingPolicyService();
519
- performanceMonitor = new PerformanceMonitor(db);
520
- searchCache = new SearchCacheService(1000, 300000); // 5분 TTL
521
- databaseOptimizer = new DatabaseOptimizer(db);
522
- process.stderr.write('✅ 검색 엔진 초기화 완료\n');
523
- // MCP 서버 생성
524
- server = new Server({
525
- name: mementoConfig.serverName,
526
- version: mementoConfig.serverVersion,
527
- }, {
528
- capabilities: {
529
- tools: {},
530
- resources: {},
531
- prompts: {}
532
- }
533
- });
534
- process.stderr.write('✅ MCP 서버 생성 완료\n');
535
- // Tools 등록
536
- server.setRequestHandler(ListToolsRequestSchema, async () => {
537
- process.stderr.write('📋 도구 목록 요청 처리\n');
538
- return {
539
- tools: [
540
- {
541
- name: 'remember',
542
- description: '새로운 기억을 저장합니다',
543
- inputSchema: {
544
- type: 'object',
545
- properties: {
546
- content: { type: 'string', description: '저장할 내용' },
547
- type: {
548
- type: 'string',
549
- enum: ['working', 'episodic', 'semantic', 'procedural'],
550
- description: '기억 타입',
551
- default: 'episodic'
552
- },
553
- tags: {
554
- type: 'array',
555
- items: { type: 'string' },
556
- description: '태그 목록'
557
- },
558
- importance: {
559
- type: 'number',
560
- minimum: 0,
561
- maximum: 1,
562
- description: '중요도 (0-1)',
563
- default: 0.5
564
- },
565
- source: { type: 'string', description: '출처' },
566
- privacy_scope: {
567
- type: 'string',
568
- enum: ['private', 'team', 'public'],
569
- description: '프라이버시 범위',
570
- default: 'private'
571
- }
572
- },
573
- required: ['content']
574
- }
575
- },
576
- {
577
- name: 'recall',
578
- description: '관련 기억을 검색합니다',
579
- inputSchema: {
580
- type: 'object',
581
- properties: {
582
- query: { type: 'string', description: '검색 쿼리' },
583
- filters: {
584
- type: 'object',
585
- properties: {
586
- type: {
587
- type: 'array',
588
- items: { type: 'string', enum: ['working', 'episodic', 'semantic', 'procedural'] }
589
- },
590
- tags: { type: 'array', items: { type: 'string' } },
591
- privacy_scope: {
592
- type: 'array',
593
- items: { type: 'string', enum: ['private', 'team', 'public'] }
594
- },
595
- time_from: { type: 'string' },
596
- time_to: { type: 'string' },
597
- pinned: { type: 'boolean' }
598
- }
599
- },
600
- limit: { type: 'number', minimum: 1, maximum: 50, default: 10 }
601
- },
602
- required: ['query']
603
- }
604
- },
605
- {
606
- name: 'forget',
607
- description: '기억을 삭제합니다',
608
- inputSchema: {
609
- type: 'object',
610
- properties: {
611
- id: { type: 'string', description: '삭제할 기억의 ID' },
612
- hard: { type: 'boolean', description: '완전 삭제 여부', default: false }
613
- },
614
- required: ['id']
615
- }
616
- },
617
- {
618
- name: 'pin',
619
- description: '기억을 고정합니다',
620
- inputSchema: {
621
- type: 'object',
622
- properties: {
623
- id: { type: 'string', description: '고정할 기억의 ID' }
624
- },
625
- required: ['id']
626
- }
627
- },
628
- {
629
- name: 'unpin',
630
- description: '기억 고정을 해제합니다',
631
- inputSchema: {
632
- type: 'object',
633
- properties: {
634
- id: { type: 'string', description: '고정 해제할 기억의 ID' }
635
- },
636
- required: ['id']
637
- }
638
- },
639
- {
640
- name: 'cleanup_memory',
641
- description: '망각 정책에 따라 메모리를 정리합니다',
642
- inputSchema: {
643
- type: 'object',
644
- properties: {
645
- dry_run: {
646
- type: 'boolean',
647
- description: '드라이런 모드 (실제 삭제 없이 분석만)',
648
- default: false
649
- }
650
- }
651
- }
652
- },
653
- {
654
- name: 'forgetting_stats',
655
- description: '망각 통계를 조회합니다',
656
- inputSchema: {
657
- type: 'object',
658
- properties: {}
659
- }
660
- },
661
- {
662
- name: 'performance_stats',
663
- description: '성능 통계를 조회합니다',
664
- inputSchema: {
665
- type: 'object',
666
- properties: {}
667
- }
668
- },
669
- {
670
- name: 'database_optimize',
671
- description: '데이터베이스 최적화를 수행합니다',
672
- inputSchema: {
673
- type: 'object',
674
- properties: {
675
- analyze: {
676
- type: 'boolean',
677
- description: '데이터베이스 분석 실행',
678
- default: false
679
- },
680
- create_indexes: {
681
- type: 'boolean',
682
- description: '추천 인덱스 생성',
683
- default: false
684
- }
685
- }
686
- }
687
- }
688
- ]
689
- };
690
- });
691
- // Tool 실행 핸들러
692
- server.setRequestHandler(CallToolRequestSchema, async (request) => {
693
- const { name, arguments: args } = request.params;
694
- process.stderr.write(`🔧 도구 실행 요청: ${name}\n`);
695
- try {
696
- switch (name) {
697
- case 'remember':
698
- return await handleRemember(RememberSchema.parse(args));
699
- case 'recall':
700
- return await handleRecall(RecallSchema.parse(args));
701
- case 'forget':
702
- return await handleForget(ForgetSchema.parse(args));
703
- case 'pin':
704
- return await handlePin(PinSchema.parse(args));
705
- case 'unpin':
706
- return await handleUnpin(UnpinSchema.parse(args));
707
- case 'cleanup_memory':
708
- return await handleCleanupMemory(CleanupMemorySchema.parse(args));
709
- case 'forgetting_stats':
710
- return await handleForgettingStats(ForgettingStatsSchema.parse(args));
711
- case 'performance_stats':
712
- return await handlePerformanceStats(PerformanceStatsSchema.parse(args));
713
- case 'database_optimize':
714
- return await handleDatabaseOptimize(DatabaseOptimizeSchema.parse(args));
715
- default:
716
- throw new Error(`Unknown tool: ${name}`);
717
- }
718
- }
719
- catch (error) {
720
- if (error instanceof z.ZodError) {
721
- throw new Error(`Invalid parameters: ${error.errors.map(e => e.message).join(', ')}`);
722
- }
723
- throw error;
724
- }
725
- });
726
- process.stderr.write('✅ MCP 서버 초기화 완료\n');
727
- process.stderr.write('🚀 Memento MCP Server가 시작되었습니다!\n');
728
- }
729
- catch (error) {
730
- process.stderr.write(`❌ 서버 초기화 실패: ${error}\n`);
731
- process.exit(1);
732
- }
733
- }
734
- // 서버 시작
735
- async function startServer() {
736
- try {
737
- await initializeServer();
738
- process.stderr.write('✅ 서버 초기화 완료\n');
739
- // Stdio 전송 계층 사용
740
- const transport = new StdioServerTransport();
741
- await server.connect(transport);
742
- process.stderr.write('✅ MCP 전송 계층 연결 완료\n');
743
- // MCP 클라이언트 연결 대기 중
744
- process.stderr.write('🔗 MCP 클라이언트 연결 대기 중...\n');
745
- // 서버가 종료될 때까지 대기
746
- return new Promise((resolve) => {
747
- process.on('SIGINT', () => {
748
- process.stderr.write('👋 서버 종료 신호 수신\n');
749
- cleanup().then(() => {
750
- process.exit(0);
751
- });
752
- });
753
- process.on('SIGTERM', () => {
754
- process.stderr.write('👋 서버 종료 신호 수신\n');
755
- cleanup().then(() => {
756
- process.exit(0);
757
- });
758
- });
759
- });
760
- }
761
- catch (error) {
762
- process.stderr.write(`❌ 서버 시작 실패: ${error}\n`);
763
- process.exit(1);
764
- }
765
- }
766
- // 정리 함수
767
- let isCleaningUp = false;
768
- async function cleanup() {
769
- if (isCleaningUp) {
770
- return; // 이미 정리 중이면 중복 실행 방지
771
- }
772
- isCleaningUp = true;
773
- if (db) {
774
- closeDatabase(db);
775
- db = null; // 참조 제거
776
- }
777
- // Memento MCP Server 종료
778
- }
779
- // 프로세스 종료 시 정리
780
- process.on('SIGINT', cleanup);
781
- process.on('SIGTERM', cleanup);
782
- process.on('uncaughtException', (error) => {
783
- // 예상치 못한 오류
784
- cleanup();
785
- process.exit(1);
786
- });
787
- // 서버 시작
788
- if (process.argv[1] && process.argv[1].endsWith('index.js')) {
789
- startServer().catch(error => {
790
- process.exit(1);
791
- });
792
- }
793
- //# sourceMappingURL=index-backup.js.map