memento-mcp-server 0.1.0

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 (555) hide show
  1. package/.cursor/rules/cache-management.mdc +171 -0
  2. package/.cursor/rules/database-schema.mdc +344 -0
  3. package/.cursor/rules/deployment.mdc +596 -0
  4. package/.cursor/rules/error-logging.mdc +298 -0
  5. package/.cursor/rules/forgetting-algorithms.mdc +426 -0
  6. package/.cursor/rules/http-server.mdc +432 -0
  7. package/.cursor/rules/hybrid-search.mdc +424 -0
  8. package/.cursor/rules/implementation.mdc +369 -0
  9. package/.cursor/rules/lightweight-embedding.mdc +178 -0
  10. package/.cursor/rules/mcp-client-development.mdc +0 -0
  11. package/.cursor/rules/mcp-server-development.mdc +0 -0
  12. package/.cursor/rules/mcp-tools-architecture.mdc +205 -0
  13. package/.cursor/rules/memento-memory-rule.mdc +8 -0
  14. package/.cursor/rules/memento-project-overview.mdc +0 -0
  15. package/.cursor/rules/memory-algorithms.mdc +502 -0
  16. package/.cursor/rules/monitoring.mdc +622 -0
  17. package/.cursor/rules/performance-alerts.mdc +537 -0
  18. package/.cursor/rules/performance-monitoring.mdc +345 -0
  19. package/.cursor/rules/performance-optimization.mdc +563 -0
  20. package/.cursor/rules/project-structure.mdc +310 -0
  21. package/.cursor/rules/testing.mdc +473 -0
  22. package/.dockerignore +15 -0
  23. package/.eslintrc.json +34 -0
  24. package/.github/ISSUE_TEMPLATE/bug_report.md +51 -0
  25. package/.github/ISSUE_TEMPLATE/feature_request.md +45 -0
  26. package/.github/ISSUE_TEMPLATE/question.md +31 -0
  27. package/.github/PULL_REQUEST_TEMPLATE.md +97 -0
  28. package/AGENTS.md +28 -0
  29. package/CHANGELOG.md +416 -0
  30. package/CODE_OF_CONDUCT.md +62 -0
  31. package/CONTRIBUTING.md +165 -0
  32. package/DOCKER_SETUP_GUIDE.md +84 -0
  33. package/Dockerfile +90 -0
  34. package/INSTALL.en.md +303 -0
  35. package/INSTALL.md +303 -0
  36. package/README.en.md +330 -0
  37. package/README.md +427 -0
  38. package/backup/legacy-removal-20250930-201816/http-server-legacy.ts +1068 -0
  39. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.ps1 +46 -0
  40. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.sh +48 -0
  41. package/dist/algorithms/forgetting-algorithm.d.ts +90 -0
  42. package/dist/algorithms/forgetting-algorithm.d.ts.map +1 -0
  43. package/dist/algorithms/forgetting-algorithm.js +160 -0
  44. package/dist/algorithms/forgetting-algorithm.js.map +1 -0
  45. package/dist/algorithms/hybrid-search-engine.d.ts +108 -0
  46. package/dist/algorithms/hybrid-search-engine.d.ts.map +1 -0
  47. package/dist/algorithms/hybrid-search-engine.js +384 -0
  48. package/dist/algorithms/hybrid-search-engine.js.map +1 -0
  49. package/dist/algorithms/search-engine.d.ts +64 -0
  50. package/dist/algorithms/search-engine.d.ts.map +1 -0
  51. package/dist/algorithms/search-engine.js +304 -0
  52. package/dist/algorithms/search-engine.js.map +1 -0
  53. package/dist/algorithms/search-ranking.d.ts +145 -0
  54. package/dist/algorithms/search-ranking.d.ts.map +1 -0
  55. package/dist/algorithms/search-ranking.js +311 -0
  56. package/dist/algorithms/search-ranking.js.map +1 -0
  57. package/dist/algorithms/spaced-repetition.d.ts +83 -0
  58. package/dist/algorithms/spaced-repetition.d.ts.map +1 -0
  59. package/dist/algorithms/spaced-repetition.js +153 -0
  60. package/dist/algorithms/spaced-repetition.js.map +1 -0
  61. package/dist/algorithms/vector-search-engine.d.ts +96 -0
  62. package/dist/algorithms/vector-search-engine.d.ts.map +1 -0
  63. package/dist/algorithms/vector-search-engine.js +410 -0
  64. package/dist/algorithms/vector-search-engine.js.map +1 -0
  65. package/dist/client/index.d.ts +55 -0
  66. package/dist/client/index.d.ts.map +1 -0
  67. package/dist/client/index.js +179 -0
  68. package/dist/client/index.js.map +1 -0
  69. package/dist/config/index.d.ts +20 -0
  70. package/dist/config/index.d.ts.map +1 -0
  71. package/dist/config/index.js +87 -0
  72. package/dist/config/index.js.map +1 -0
  73. package/dist/database/init.d.ts +7 -0
  74. package/dist/database/init.d.ts.map +1 -0
  75. package/dist/database/init.js +117 -0
  76. package/dist/database/init.js.map +1 -0
  77. package/dist/database/migrate.d.ts +6 -0
  78. package/dist/database/migrate.d.ts.map +1 -0
  79. package/dist/database/migrate.js +84 -0
  80. package/dist/database/migrate.js.map +1 -0
  81. package/dist/database/schema.sql +159 -0
  82. package/dist/npm-client/context-injector.d.ts +106 -0
  83. package/dist/npm-client/context-injector.d.ts.map +1 -0
  84. package/dist/npm-client/context-injector.js +296 -0
  85. package/dist/npm-client/context-injector.js.map +1 -0
  86. package/dist/npm-client/index.d.ts +42 -0
  87. package/dist/npm-client/index.d.ts.map +1 -0
  88. package/dist/npm-client/index.js +43 -0
  89. package/dist/npm-client/index.js.map +1 -0
  90. package/dist/npm-client/memento-client.d.ts +114 -0
  91. package/dist/npm-client/memento-client.d.ts.map +1 -0
  92. package/dist/npm-client/memento-client.js +391 -0
  93. package/dist/npm-client/memento-client.js.map +1 -0
  94. package/dist/npm-client/memory-manager.d.ts +137 -0
  95. package/dist/npm-client/memory-manager.d.ts.map +1 -0
  96. package/dist/npm-client/memory-manager.js +341 -0
  97. package/dist/npm-client/memory-manager.js.map +1 -0
  98. package/dist/npm-client/types.d.ts +216 -0
  99. package/dist/npm-client/types.d.ts.map +1 -0
  100. package/dist/npm-client/types.js +44 -0
  101. package/dist/npm-client/types.js.map +1 -0
  102. package/dist/npm-client/utils.d.ts +91 -0
  103. package/dist/npm-client/utils.d.ts.map +1 -0
  104. package/dist/npm-client/utils.js +351 -0
  105. package/dist/npm-client/utils.js.map +1 -0
  106. package/dist/scripts/copy-assets.d.ts +3 -0
  107. package/dist/scripts/copy-assets.d.ts.map +1 -0
  108. package/dist/scripts/copy-assets.js +31 -0
  109. package/dist/scripts/copy-assets.js.map +1 -0
  110. package/dist/server/http-server.d.ts +28 -0
  111. package/dist/server/http-server.d.ts.map +1 -0
  112. package/dist/server/http-server.js +930 -0
  113. package/dist/server/http-server.js.map +1 -0
  114. package/dist/server/index-backup.d.ts +5 -0
  115. package/dist/server/index-backup.d.ts.map +1 -0
  116. package/dist/server/index-backup.js +793 -0
  117. package/dist/server/index-backup.js.map +1 -0
  118. package/dist/server/index-refactored.d.ts +6 -0
  119. package/dist/server/index-refactored.d.ts.map +1 -0
  120. package/dist/server/index-refactored.js +206 -0
  121. package/dist/server/index-refactored.js.map +1 -0
  122. package/dist/server/index.d.ts +12 -0
  123. package/dist/server/index.d.ts.map +1 -0
  124. package/dist/server/index.js +301 -0
  125. package/dist/server/index.js.map +1 -0
  126. package/dist/server/simple-mcp-server.d.ts +8 -0
  127. package/dist/server/simple-mcp-server.d.ts.map +1 -0
  128. package/dist/server/simple-mcp-server.js +152 -0
  129. package/dist/server/simple-mcp-server.js.map +1 -0
  130. package/dist/services/async-optimizer.d.ts +136 -0
  131. package/dist/services/async-optimizer.d.ts.map +1 -0
  132. package/dist/services/async-optimizer.js +406 -0
  133. package/dist/services/async-optimizer.js.map +1 -0
  134. package/dist/services/batch-scheduler.d.ts +156 -0
  135. package/dist/services/batch-scheduler.d.ts.map +1 -0
  136. package/dist/services/batch-scheduler.js +612 -0
  137. package/dist/services/batch-scheduler.js.map +1 -0
  138. package/dist/services/cache-service.d.ts +168 -0
  139. package/dist/services/cache-service.d.ts.map +1 -0
  140. package/dist/services/cache-service.js +360 -0
  141. package/dist/services/cache-service.js.map +1 -0
  142. package/dist/services/database-optimizer.d.ts +110 -0
  143. package/dist/services/database-optimizer.d.ts.map +1 -0
  144. package/dist/services/database-optimizer.js +369 -0
  145. package/dist/services/database-optimizer.js.map +1 -0
  146. package/dist/services/embedding-provider-factory.d.ts +62 -0
  147. package/dist/services/embedding-provider-factory.d.ts.map +1 -0
  148. package/dist/services/embedding-provider-factory.js +152 -0
  149. package/dist/services/embedding-provider-factory.js.map +1 -0
  150. package/dist/services/embedding-service.d.ts +95 -0
  151. package/dist/services/embedding-service.d.ts.map +1 -0
  152. package/dist/services/embedding-service.js +276 -0
  153. package/dist/services/embedding-service.js.map +1 -0
  154. package/dist/services/error-logging-service.d.ts +134 -0
  155. package/dist/services/error-logging-service.d.ts.map +1 -0
  156. package/dist/services/error-logging-service.js +271 -0
  157. package/dist/services/error-logging-service.js.map +1 -0
  158. package/dist/services/forgetting-policy-service.d.ts +94 -0
  159. package/dist/services/forgetting-policy-service.d.ts.map +1 -0
  160. package/dist/services/forgetting-policy-service.js +233 -0
  161. package/dist/services/forgetting-policy-service.js.map +1 -0
  162. package/dist/services/gemini-embedding-service.d.ts +82 -0
  163. package/dist/services/gemini-embedding-service.d.ts.map +1 -0
  164. package/dist/services/gemini-embedding-service.js +232 -0
  165. package/dist/services/gemini-embedding-service.js.map +1 -0
  166. package/dist/services/lightweight-embedding-service.d.ts +95 -0
  167. package/dist/services/lightweight-embedding-service.d.ts.map +1 -0
  168. package/dist/services/lightweight-embedding-service.js +263 -0
  169. package/dist/services/lightweight-embedding-service.js.map +1 -0
  170. package/dist/services/memory-embedding-service.d.ts +69 -0
  171. package/dist/services/memory-embedding-service.d.ts.map +1 -0
  172. package/dist/services/memory-embedding-service.js +223 -0
  173. package/dist/services/memory-embedding-service.js.map +1 -0
  174. package/dist/services/minilm-embedding-service.d.ts +92 -0
  175. package/dist/services/minilm-embedding-service.d.ts.map +1 -0
  176. package/dist/services/minilm-embedding-service.js +216 -0
  177. package/dist/services/minilm-embedding-service.js.map +1 -0
  178. package/dist/services/performance-alert-service.d.ts +142 -0
  179. package/dist/services/performance-alert-service.d.ts.map +1 -0
  180. package/dist/services/performance-alert-service.js +366 -0
  181. package/dist/services/performance-alert-service.js.map +1 -0
  182. package/dist/services/performance-monitor.d.ts +144 -0
  183. package/dist/services/performance-monitor.d.ts.map +1 -0
  184. package/dist/services/performance-monitor.js +416 -0
  185. package/dist/services/performance-monitor.js.map +1 -0
  186. package/dist/services/performance-monitoring-integration.d.ts +77 -0
  187. package/dist/services/performance-monitoring-integration.d.ts.map +1 -0
  188. package/dist/services/performance-monitoring-integration.js +177 -0
  189. package/dist/services/performance-monitoring-integration.js.map +1 -0
  190. package/dist/services/unified-embedding-service.d.ts +75 -0
  191. package/dist/services/unified-embedding-service.d.ts.map +1 -0
  192. package/dist/services/unified-embedding-service.js +211 -0
  193. package/dist/services/unified-embedding-service.js.map +1 -0
  194. package/dist/test/debug-http-v2.d.ts +5 -0
  195. package/dist/test/debug-http-v2.d.ts.map +1 -0
  196. package/dist/test/debug-http-v2.js +28 -0
  197. package/dist/test/debug-http-v2.js.map +1 -0
  198. package/dist/test/performance-benchmark.d.ts +57 -0
  199. package/dist/test/performance-benchmark.d.ts.map +1 -0
  200. package/dist/test/performance-benchmark.js +427 -0
  201. package/dist/test/performance-benchmark.js.map +1 -0
  202. package/dist/test/test-alerts-direct.d.ts +7 -0
  203. package/dist/test/test-alerts-direct.d.ts.map +1 -0
  204. package/dist/test/test-alerts-direct.js +101 -0
  205. package/dist/test/test-alerts-direct.js.map +1 -0
  206. package/dist/test/test-batch-scheduler.d.ts +2 -0
  207. package/dist/test/test-batch-scheduler.d.ts.map +1 -0
  208. package/dist/test/test-batch-scheduler.js +156 -0
  209. package/dist/test/test-batch-scheduler.js.map +1 -0
  210. package/dist/test/test-client.d.ts +5 -0
  211. package/dist/test/test-client.d.ts.map +1 -0
  212. package/dist/test/test-client.js +86 -0
  213. package/dist/test/test-client.js.map +1 -0
  214. package/dist/test/test-embedding.d.ts +6 -0
  215. package/dist/test/test-embedding.d.ts.map +1 -0
  216. package/dist/test/test-embedding.js +142 -0
  217. package/dist/test/test-embedding.js.map +1 -0
  218. package/dist/test/test-error-logging.d.ts +7 -0
  219. package/dist/test/test-error-logging.d.ts.map +1 -0
  220. package/dist/test/test-error-logging.js +105 -0
  221. package/dist/test/test-error-logging.js.map +1 -0
  222. package/dist/test/test-forgetting.d.ts +6 -0
  223. package/dist/test/test-forgetting.d.ts.map +1 -0
  224. package/dist/test/test-forgetting.js +154 -0
  225. package/dist/test/test-forgetting.js.map +1 -0
  226. package/dist/test/test-gemini-embedding.d.ts +7 -0
  227. package/dist/test/test-gemini-embedding.d.ts.map +1 -0
  228. package/dist/test/test-gemini-embedding.js +134 -0
  229. package/dist/test/test-gemini-embedding.js.map +1 -0
  230. package/dist/test/test-http-server-v2-simple.d.ts +6 -0
  231. package/dist/test/test-http-server-v2-simple.d.ts.map +1 -0
  232. package/dist/test/test-http-server-v2-simple.js +131 -0
  233. package/dist/test/test-http-server-v2-simple.js.map +1 -0
  234. package/dist/test/test-http-server-v2.d.ts +7 -0
  235. package/dist/test/test-http-server-v2.d.ts.map +1 -0
  236. package/dist/test/test-http-server-v2.js +529 -0
  237. package/dist/test/test-http-server-v2.js.map +1 -0
  238. package/dist/test/test-lightweight-embedding.d.ts +6 -0
  239. package/dist/test/test-lightweight-embedding.d.ts.map +1 -0
  240. package/dist/test/test-lightweight-embedding.js +189 -0
  241. package/dist/test/test-lightweight-embedding.js.map +1 -0
  242. package/dist/test/test-m1-completion.d.ts +7 -0
  243. package/dist/test/test-m1-completion.d.ts.map +1 -0
  244. package/dist/test/test-m1-completion.js +124 -0
  245. package/dist/test/test-m1-completion.js.map +1 -0
  246. package/dist/test/test-memory-injection-prompt.d.ts +2 -0
  247. package/dist/test/test-memory-injection-prompt.d.ts.map +1 -0
  248. package/dist/test/test-memory-injection-prompt.js +299 -0
  249. package/dist/test/test-memory-injection-prompt.js.map +1 -0
  250. package/dist/test/test-performance-alerts.d.ts +7 -0
  251. package/dist/test/test-performance-alerts.d.ts.map +1 -0
  252. package/dist/test/test-performance-alerts.js +109 -0
  253. package/dist/test/test-performance-alerts.js.map +1 -0
  254. package/dist/test/test-performance-monitor.d.ts +2 -0
  255. package/dist/test/test-performance-monitor.d.ts.map +1 -0
  256. package/dist/test/test-performance-monitor.js +182 -0
  257. package/dist/test/test-performance-monitor.js.map +1 -0
  258. package/dist/test/test-performance-monitoring.d.ts +6 -0
  259. package/dist/test/test-performance-monitoring.d.ts.map +1 -0
  260. package/dist/test/test-performance-monitoring.js +156 -0
  261. package/dist/test/test-performance-monitoring.js.map +1 -0
  262. package/dist/test/test-search.d.ts +5 -0
  263. package/dist/test/test-search.d.ts.map +1 -0
  264. package/dist/test/test-search.js +141 -0
  265. package/dist/test/test-search.js.map +1 -0
  266. package/dist/test/test-simple-alerts.d.ts +6 -0
  267. package/dist/test/test-simple-alerts.d.ts.map +1 -0
  268. package/dist/test/test-simple-alerts.js +106 -0
  269. package/dist/test/test-simple-alerts.js.map +1 -0
  270. package/dist/test/test-vector-search-engine.d.ts +2 -0
  271. package/dist/test/test-vector-search-engine.d.ts.map +1 -0
  272. package/dist/test/test-vector-search-engine.js +225 -0
  273. package/dist/test/test-vector-search-engine.js.map +1 -0
  274. package/dist/tools/base-tool.d.ts +64 -0
  275. package/dist/tools/base-tool.d.ts.map +1 -0
  276. package/dist/tools/base-tool.js +158 -0
  277. package/dist/tools/base-tool.js.map +1 -0
  278. package/dist/tools/cleanup-memory-tool.d.ts +10 -0
  279. package/dist/tools/cleanup-memory-tool.d.ts.map +1 -0
  280. package/dist/tools/cleanup-memory-tool.js +66 -0
  281. package/dist/tools/cleanup-memory-tool.js.map +1 -0
  282. package/dist/tools/database-optimize-tool.d.ts +10 -0
  283. package/dist/tools/database-optimize-tool.d.ts.map +1 -0
  284. package/dist/tools/database-optimize-tool.js +64 -0
  285. package/dist/tools/database-optimize-tool.js.map +1 -0
  286. package/dist/tools/error-stats.d.ts +93 -0
  287. package/dist/tools/error-stats.d.ts.map +1 -0
  288. package/dist/tools/error-stats.js +115 -0
  289. package/dist/tools/error-stats.js.map +1 -0
  290. package/dist/tools/forget-tool.d.ts +63 -0
  291. package/dist/tools/forget-tool.d.ts.map +1 -0
  292. package/dist/tools/forget-tool.js +340 -0
  293. package/dist/tools/forget-tool.js.map +1 -0
  294. package/dist/tools/forgetting-stats-tool.d.ts +10 -0
  295. package/dist/tools/forgetting-stats-tool.d.ts.map +1 -0
  296. package/dist/tools/forgetting-stats-tool.js +37 -0
  297. package/dist/tools/forgetting-stats-tool.js.map +1 -0
  298. package/dist/tools/index.d.ts +33 -0
  299. package/dist/tools/index.d.ts.map +1 -0
  300. package/dist/tools/index.js +55 -0
  301. package/dist/tools/index.js.map +1 -0
  302. package/dist/tools/memory-injection-prompt.d.ts +31 -0
  303. package/dist/tools/memory-injection-prompt.d.ts.map +1 -0
  304. package/dist/tools/memory-injection-prompt.js +203 -0
  305. package/dist/tools/memory-injection-prompt.js.map +1 -0
  306. package/dist/tools/performance-alerts.d.ts +127 -0
  307. package/dist/tools/performance-alerts.d.ts.map +1 -0
  308. package/dist/tools/performance-alerts.js +208 -0
  309. package/dist/tools/performance-alerts.js.map +1 -0
  310. package/dist/tools/performance-stats-tool.d.ts +10 -0
  311. package/dist/tools/performance-stats-tool.d.ts.map +1 -0
  312. package/dist/tools/performance-stats-tool.js +38 -0
  313. package/dist/tools/performance-stats-tool.js.map +1 -0
  314. package/dist/tools/pin-tool.d.ts +39 -0
  315. package/dist/tools/pin-tool.d.ts.map +1 -0
  316. package/dist/tools/pin-tool.js +211 -0
  317. package/dist/tools/pin-tool.js.map +1 -0
  318. package/dist/tools/recall-tool.d.ts +27 -0
  319. package/dist/tools/recall-tool.d.ts.map +1 -0
  320. package/dist/tools/recall-tool.js +335 -0
  321. package/dist/tools/recall-tool.js.map +1 -0
  322. package/dist/tools/remember-tool.d.ts +10 -0
  323. package/dist/tools/remember-tool.d.ts.map +1 -0
  324. package/dist/tools/remember-tool.js +101 -0
  325. package/dist/tools/remember-tool.js.map +1 -0
  326. package/dist/tools/resolve-error.d.ts +54 -0
  327. package/dist/tools/resolve-error.d.ts.map +1 -0
  328. package/dist/tools/resolve-error.js +63 -0
  329. package/dist/tools/resolve-error.js.map +1 -0
  330. package/dist/tools/tool-registry.d.ts +134 -0
  331. package/dist/tools/tool-registry.d.ts.map +1 -0
  332. package/dist/tools/tool-registry.js +337 -0
  333. package/dist/tools/tool-registry.js.map +1 -0
  334. package/dist/tools/types.d.ts +56 -0
  335. package/dist/tools/types.d.ts.map +1 -0
  336. package/dist/tools/types.js +23 -0
  337. package/dist/tools/types.js.map +1 -0
  338. package/dist/tools/unpin-tool.d.ts +43 -0
  339. package/dist/tools/unpin-tool.d.ts.map +1 -0
  340. package/dist/tools/unpin-tool.js +233 -0
  341. package/dist/tools/unpin-tool.js.map +1 -0
  342. package/dist/types/embedding.types.d.ts +65 -0
  343. package/dist/types/embedding.types.d.ts.map +1 -0
  344. package/dist/types/embedding.types.js +6 -0
  345. package/dist/types/embedding.types.js.map +1 -0
  346. package/dist/types/index.d.ts +103 -0
  347. package/dist/types/index.d.ts.map +1 -0
  348. package/dist/types/index.js +5 -0
  349. package/dist/types/index.js.map +1 -0
  350. package/dist/utils/database.d.ts +62 -0
  351. package/dist/utils/database.d.ts.map +1 -0
  352. package/dist/utils/database.js +399 -0
  353. package/dist/utils/database.js.map +1 -0
  354. package/dist/utils/stopwords.d.ts +18 -0
  355. package/dist/utils/stopwords.d.ts.map +1 -0
  356. package/dist/utils/stopwords.js +117 -0
  357. package/dist/utils/stopwords.js.map +1 -0
  358. package/docker-compose.dev.yml +50 -0
  359. package/docker-compose.prod.yml +77 -0
  360. package/docker-compose.yml +43 -0
  361. package/docs/en/Memento-Goals.md +217 -0
  362. package/docs/en/Memento-M1-DetailSpecs.md +130 -0
  363. package/docs/en/Memento-Milestones.md +135 -0
  364. package/docs/en/Search-Ranking-Memory-Decay-Formulas.md +177 -0
  365. package/docs/en/api-reference.md +658 -0
  366. package/docs/en/architecture.md +1302 -0
  367. package/docs/en/developer-guide.md +1005 -0
  368. package/docs/en/user-manual.md +595 -0
  369. package/docs/ko/Memento-Goals.md +217 -0
  370. package/docs/ko/Memento-M1-DetailSpecs.md +130 -0
  371. package/docs/ko/Memento-Milestones.md +134 -0
  372. package/docs/ko/Search-Ranking-Memory-Decay-Formulas.md +177 -0
  373. package/docs/ko/api-reference.md +658 -0
  374. package/docs/ko/architecture.md +1302 -0
  375. package/docs/ko/developer-guide.md +1006 -0
  376. package/docs/ko/embedding-api-reference.md +122 -0
  377. package/docs/ko/embedding-configuration.md +62 -0
  378. package/docs/ko/embedding-performance-benchmark.md +62 -0
  379. package/docs/ko/embedding-service-guide.md +314 -0
  380. package/docs/ko/user-manual.md +595 -0
  381. package/env.example +49 -0
  382. package/install.sh +191 -0
  383. package/mcp-http-client.js +218 -0
  384. package/mcp.json +0 -0
  385. package/package.json +125 -0
  386. package/packages/mcp-client/docs/API-REFERENCE.md +560 -0
  387. package/packages/mcp-client/docs/BEST-PRACTICES.md +564 -0
  388. package/packages/mcp-client/docs/MIGRATION-GUIDE.md +344 -0
  389. package/packages/mcp-client/docs/PERFORMANCE-GUIDE.md +476 -0
  390. package/packages/mcp-client/docs/TROUBLESHOOTING.md +564 -0
  391. package/packages/mcp-client/package-lock.json +907 -0
  392. package/packages/mcp-client/package.json +58 -0
  393. package/packages/mcp-client/performance-optimizer.js +428 -0
  394. package/packages/mcp-client/test-basic.js +65 -0
  395. package/packages/mcp-client/test-integration.js +366 -0
  396. package/scripts/auto-setup.js +234 -0
  397. package/scripts/backup-daily.bat +28 -0
  398. package/scripts/backup-embeddings.js +108 -0
  399. package/scripts/check-db-integrity.js +93 -0
  400. package/scripts/debug-embeddings.js +184 -0
  401. package/scripts/direct-sql-migration.sql +36 -0
  402. package/scripts/docker-migration.sh +105 -0
  403. package/scripts/fix-migration.js +93 -0
  404. package/scripts/fix-vector-dimensions.js +206 -0
  405. package/scripts/migrate-embedding-data.js +307 -0
  406. package/scripts/regenerate-embeddings.js +144 -0
  407. package/scripts/restore-legacy.ps1 +60 -0
  408. package/scripts/restore-legacy.sh +62 -0
  409. package/scripts/run-migration.js +122 -0
  410. package/scripts/safe-migration.js +150 -0
  411. package/scripts/simple-migrate.js +41 -0
  412. package/scripts/simple-update.js +123 -0
  413. package/scripts/start-container.sh +10 -0
  414. package/src/algorithms/forgetting-algorithm.spec.ts +538 -0
  415. package/src/algorithms/forgetting-algorithm.ts +243 -0
  416. package/src/algorithms/hybrid-search-engine.spec.ts +484 -0
  417. package/src/algorithms/hybrid-search-engine.ts +489 -0
  418. package/src/algorithms/search-engine.spec.ts +429 -0
  419. package/src/algorithms/search-engine.ts +392 -0
  420. package/src/algorithms/search-ranking.spec.ts +293 -0
  421. package/src/algorithms/search-ranking.ts +407 -0
  422. package/src/algorithms/spaced-repetition.spec.ts +510 -0
  423. package/src/algorithms/spaced-repetition.ts +238 -0
  424. package/src/algorithms/vector-search-engine.ts +505 -0
  425. package/src/client/index.spec.ts +427 -0
  426. package/src/client/index.ts +222 -0
  427. package/src/config/index.spec.ts +339 -0
  428. package/src/config/index.ts +106 -0
  429. package/src/database/init.spec.ts +239 -0
  430. package/src/database/init.ts +130 -0
  431. package/src/database/migrate.spec.ts +293 -0
  432. package/src/database/migrate.ts +94 -0
  433. package/src/database/migrations/001_add_embedding_metadata.sql +29 -0
  434. package/src/database/schema.sql +159 -0
  435. package/src/npm-client/context-injector.spec.ts +335 -0
  436. package/src/npm-client/context-injector.ts +412 -0
  437. package/src/npm-client/index.spec.ts +108 -0
  438. package/src/npm-client/index.ts +96 -0
  439. package/src/npm-client/memento-client.spec.ts +549 -0
  440. package/src/npm-client/memento-client.ts +501 -0
  441. package/src/npm-client/memory-manager.spec.ts +374 -0
  442. package/src/npm-client/memory-manager.ts +414 -0
  443. package/src/npm-client/types.spec.ts +427 -0
  444. package/src/npm-client/types.ts +296 -0
  445. package/src/npm-client/utils.spec.ts +355 -0
  446. package/src/npm-client/utils.ts +423 -0
  447. package/src/scripts/copy-assets.js +37 -0
  448. package/src/server/http-server.spec.ts +648 -0
  449. package/src/server/http-server.ts +1030 -0
  450. package/src/server/index-backup.ts +875 -0
  451. package/src/server/index-refactored.ts +237 -0
  452. package/src/server/index.spec.ts +281 -0
  453. package/src/server/index.ts +347 -0
  454. package/src/server/simple-mcp-server.spec.ts +207 -0
  455. package/src/server/simple-mcp-server.ts +173 -0
  456. package/src/services/async-optimizer.spec.ts +569 -0
  457. package/src/services/async-optimizer.ts +484 -0
  458. package/src/services/batch-scheduler.ts +759 -0
  459. package/src/services/cache-service.spec.ts +372 -0
  460. package/src/services/cache-service.ts +434 -0
  461. package/src/services/database-optimizer.spec.ts +344 -0
  462. package/src/services/database-optimizer.ts +450 -0
  463. package/src/services/embedding-provider-factory.ts +173 -0
  464. package/src/services/embedding-service.spec.ts +342 -0
  465. package/src/services/embedding-service.ts +333 -0
  466. package/src/services/error-logging-service.spec.ts +416 -0
  467. package/src/services/error-logging-service.ts +383 -0
  468. package/src/services/forgetting-policy-service.spec.ts +140 -0
  469. package/src/services/forgetting-policy-service.ts +334 -0
  470. package/src/services/gemini-embedding-service.spec.ts +463 -0
  471. package/src/services/gemini-embedding-service.ts +283 -0
  472. package/src/services/lightweight-embedding-service.spec.ts +458 -0
  473. package/src/services/lightweight-embedding-service.ts +324 -0
  474. package/src/services/memory-embedding-service.spec.ts +417 -0
  475. package/src/services/memory-embedding-service.ts +289 -0
  476. package/src/services/minilm-embedding-service.spec.ts +104 -0
  477. package/src/services/minilm-embedding-service.ts +262 -0
  478. package/src/services/performance-alert-service.spec.ts +517 -0
  479. package/src/services/performance-alert-service.ts +477 -0
  480. package/src/services/performance-monitor.spec.ts +401 -0
  481. package/src/services/performance-monitor.ts +532 -0
  482. package/src/services/performance-monitoring-integration.spec.ts +478 -0
  483. package/src/services/performance-monitoring-integration.ts.bak +276 -0
  484. package/src/services/unified-embedding-service.spec.ts +224 -0
  485. package/src/services/unified-embedding-service.ts +255 -0
  486. package/src/test/debug-http-v2.ts +30 -0
  487. package/src/test/embedding-integration-test.spec.ts +295 -0
  488. package/src/test/embedding-integration-test.ts +295 -0
  489. package/src/test/embedding-performance-benchmark.spec.ts +354 -0
  490. package/src/test/embedding-performance-benchmark.ts +312 -0
  491. package/src/test/performance-benchmark.ts +565 -0
  492. package/src/test/test-alerts-direct.ts +136 -0
  493. package/src/test/test-batch-scheduler-simple.spec.ts +122 -0
  494. package/src/test/test-batch-scheduler.spec.ts +453 -0
  495. package/src/test/test-batch-scheduler.ts +182 -0
  496. package/src/test/test-client.ts +97 -0
  497. package/src/test/test-embedding.ts +153 -0
  498. package/src/test/test-error-handling.spec.ts +575 -0
  499. package/src/test/test-error-logging.ts +117 -0
  500. package/src/test/test-forgetting.ts +162 -0
  501. package/src/test/test-gemini-embedding.ts +159 -0
  502. package/src/test/test-http-server-v2-simple.ts +147 -0
  503. package/src/test/test-http-server-v2.ts +586 -0
  504. package/src/test/test-hybrid-search-engine.spec.ts +521 -0
  505. package/src/test/test-integration-fixed.spec.ts +612 -0
  506. package/src/test/test-integration.spec.ts +463 -0
  507. package/src/test/test-lightweight-embedding.ts +208 -0
  508. package/src/test/test-m1-completion.spec.ts +614 -0
  509. package/src/test/test-m1-completion.ts +141 -0
  510. package/src/test/test-m1-integration.spec.ts +514 -0
  511. package/src/test/test-memory-injection-prompt.spec.ts +650 -0
  512. package/src/test/test-memory-injection-prompt.ts +391 -0
  513. package/src/test/test-performance-alerts.ts +125 -0
  514. package/src/test/test-performance-monitor-updates.spec.ts +490 -0
  515. package/src/test/test-performance-monitor.spec.ts +284 -0
  516. package/src/test/test-performance-monitor.ts +228 -0
  517. package/src/test/test-performance-monitoring.ts +171 -0
  518. package/src/test/test-search.ts +151 -0
  519. package/src/test/test-simple-alerts.ts +136 -0
  520. package/src/test/test-vector-search-engine.spec.ts +408 -0
  521. package/src/test/test-vector-search-engine.ts +303 -0
  522. package/src/tools/base-tool.ts +189 -0
  523. package/src/tools/cleanup-memory-tool.ts +77 -0
  524. package/src/tools/database-optimize-tool.ts +79 -0
  525. package/src/tools/error-stats.ts +119 -0
  526. package/src/tools/forget-tool.spec.ts +613 -0
  527. package/src/tools/forget-tool.ts +454 -0
  528. package/src/tools/forgetting-stats-tool.ts +47 -0
  529. package/src/tools/index.ts +71 -0
  530. package/src/tools/memory-injection-prompt.ts +257 -0
  531. package/src/tools/performance-alerts.ts +226 -0
  532. package/src/tools/performance-stats-tool.ts +48 -0
  533. package/src/tools/pin-tool.spec.ts +497 -0
  534. package/src/tools/pin-tool.ts +277 -0
  535. package/src/tools/recall-tool.spec.ts +475 -0
  536. package/src/tools/recall-tool.ts +389 -0
  537. package/src/tools/remember-tool.spec.ts +469 -0
  538. package/src/tools/remember-tool.ts +112 -0
  539. package/src/tools/resolve-error.ts +69 -0
  540. package/src/tools/tool-registry.ts +417 -0
  541. package/src/tools/types.ts +63 -0
  542. package/src/tools/unpin-tool.spec.ts +549 -0
  543. package/src/tools/unpin-tool.ts +306 -0
  544. package/src/types/embedding.types.ts +78 -0
  545. package/src/types/index.spec.ts +420 -0
  546. package/src/types/index.ts +117 -0
  547. package/src/utils/database.spec.ts +77 -0
  548. package/src/utils/database.ts +458 -0
  549. package/src/utils/stopwords.ts +128 -0
  550. package/start-docker-setup.bat +38 -0
  551. package/static/logo.png +0 -0
  552. package/static/memento_logo.svg +2 -0
  553. package/test-docker.js +103 -0
  554. package/tsconfig.json +46 -0
  555. package/vitest.config.ts +23 -0
@@ -0,0 +1,141 @@
1
+ /**
2
+ * 검색 기능 상세 테스트
3
+ */
4
+ import { createMementoClient } from '../client/index.js';
5
+ async function testSearchFunctionality() {
6
+ console.log('🔍 검색 기능 상세 테스트 시작');
7
+ const client = createMementoClient();
8
+ try {
9
+ // 1. 서버 연결
10
+ console.log('\n1️⃣ 서버 연결 중...');
11
+ await client.connect();
12
+ // 2. 다양한 기억 저장
13
+ console.log('\n2️⃣ 다양한 기억 저장');
14
+ const memories = [
15
+ {
16
+ content: "React Hook에 대해 설명했다. useState는 상태를 관리하고, useEffect는 사이드 이펙트를 처리한다.",
17
+ type: 'episodic',
18
+ tags: ['react', 'hooks', 'javascript'],
19
+ importance: 0.8
20
+ },
21
+ {
22
+ content: "TypeScript의 타입 시스템에 대해 설명했다. 인터페이스와 타입 별칭의 차이점을 다뤘다.",
23
+ type: 'semantic',
24
+ tags: ['typescript', 'types', 'programming'],
25
+ importance: 0.9
26
+ },
27
+ {
28
+ content: "데이터베이스 최적화에 대해 질문받았다. 인덱싱과 쿼리 최적화 방법을 설명했다.",
29
+ type: 'episodic',
30
+ tags: ['database', 'optimization', 'sql'],
31
+ importance: 0.7
32
+ },
33
+ {
34
+ content: "MCP 프로토콜에 대해 학습했다. Model Context Protocol은 AI 에이전트와 도구 간 통신을 위한 표준이다.",
35
+ type: 'semantic',
36
+ tags: ['mcp', 'protocol', 'ai'],
37
+ importance: 0.85
38
+ }
39
+ ];
40
+ const memoryIds = [];
41
+ for (const memory of memories) {
42
+ const id = await client.remember(memory);
43
+ memoryIds.push(id);
44
+ console.log(`✅ 저장됨: ${id.substring(0, 20)}... - ${memory.content.substring(0, 30)}...`);
45
+ }
46
+ // 3. 다양한 검색 테스트
47
+ console.log('\n3️⃣ 다양한 검색 테스트');
48
+ const searchQueries = [
49
+ { query: "React", description: "React 관련 검색" },
50
+ { query: "TypeScript", description: "TypeScript 관련 검색" },
51
+ { query: "데이터베이스", description: "데이터베이스 관련 검색" },
52
+ { query: "MCP", description: "MCP 관련 검색" },
53
+ { query: "Hook", description: "Hook 관련 검색" },
54
+ { query: "타입", description: "타입 관련 검색" }
55
+ ];
56
+ for (const { query, description } of searchQueries) {
57
+ console.log(`\n🔍 ${description}: "${query}"`);
58
+ try {
59
+ const results = await client.recall({ query, limit: 5 });
60
+ console.log(` 결과: ${results.length}개`);
61
+ results.forEach((result, index) => {
62
+ console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 50)}... (점수: ${result.score || 'N/A'})`);
63
+ });
64
+ }
65
+ catch (error) {
66
+ console.error(` ❌ 검색 실패: ${error}`);
67
+ }
68
+ }
69
+ // 4. 필터 검색 테스트
70
+ console.log('\n4️⃣ 필터 검색 테스트');
71
+ console.log('\n🔍 episodic 타입만 검색:');
72
+ try {
73
+ const episodicResults = await client.recall({
74
+ query: "설명",
75
+ filters: { type: ['episodic'] },
76
+ limit: 5
77
+ });
78
+ console.log(` 결과: ${episodicResults.length}개`);
79
+ episodicResults.forEach((result, index) => {
80
+ console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 50)}...`);
81
+ });
82
+ }
83
+ catch (error) {
84
+ console.error(` ❌ 필터 검색 실패: ${error}`);
85
+ }
86
+ console.log('\n🔍 semantic 타입만 검색:');
87
+ try {
88
+ const semanticResults = await client.recall({
89
+ query: "학습",
90
+ filters: { type: ['semantic'] },
91
+ limit: 5
92
+ });
93
+ console.log(` 결과: ${semanticResults.length}개`);
94
+ semanticResults.forEach((result, index) => {
95
+ console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 50)}...`);
96
+ });
97
+ }
98
+ catch (error) {
99
+ console.error(` ❌ 필터 검색 실패: ${error}`);
100
+ }
101
+ // 5. 태그 검색 테스트
102
+ console.log('\n5️⃣ 태그 검색 테스트');
103
+ const tagQueries = ['react', 'typescript', 'database', 'mcp'];
104
+ for (const tag of tagQueries) {
105
+ console.log(`\n🔍 "${tag}" 태그 검색:`);
106
+ try {
107
+ const results = await client.recall({
108
+ query: tag,
109
+ limit: 5
110
+ });
111
+ console.log(` 결과: ${results.length}개`);
112
+ results.forEach((result, index) => {
113
+ console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 50)}... (태그: ${result.tags?.join(', ') || '없음'})`);
114
+ });
115
+ }
116
+ catch (error) {
117
+ console.error(` ❌ 태그 검색 실패: ${error}`);
118
+ }
119
+ }
120
+ console.log('\n🎉 검색 기능 테스트 완료!');
121
+ }
122
+ catch (error) {
123
+ console.error('❌ 테스트 실패:', error);
124
+ }
125
+ finally {
126
+ await client.disconnect();
127
+ }
128
+ }
129
+ // 테스트 실행
130
+ if (process.argv[1] && process.argv[1].endsWith('test-search.ts')) {
131
+ testSearchFunctionality()
132
+ .then(() => {
133
+ console.log('✅ 검색 테스트 완료');
134
+ process.exit(0);
135
+ })
136
+ .catch((error) => {
137
+ console.error('❌ 검색 테스트 실패:', error);
138
+ process.exit(1);
139
+ });
140
+ }
141
+ //# sourceMappingURL=test-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-search.js","sourceRoot":"","sources":["../../src/test/test-search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * 간단한 성능 알림 테스트
3
+ * console.log 차단을 우회하여 테스트
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=test-simple-alerts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-simple-alerts.d.ts","sourceRoot":"","sources":["../../src/test/test-simple-alerts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * 간단한 성능 알림 테스트
3
+ * console.log 차단을 우회하여 테스트
4
+ */
5
+ import { PerformanceAlertService, AlertType, AlertLevel } from '../services/performance-alert-service.js';
6
+ // console.log 복원
7
+ const originalLog = console.log;
8
+ const originalError = console.error;
9
+ function testSimpleAlerts() {
10
+ // console 메서드 복원
11
+ console.log = originalLog;
12
+ console.error = originalError;
13
+ console.log('🚨 간단한 성능 알림 테스트 시작');
14
+ try {
15
+ // 성능 알림 서비스 생성
16
+ const alertService = new PerformanceAlertService('./logs');
17
+ console.log('✅ 성능 알림 서비스 생성 완료');
18
+ // 1. 응답시간 알림 테스트
19
+ console.log('\n📊 응답시간 알림 테스트:');
20
+ const responseTimeAlerts = alertService.checkPerformanceMetric(AlertType.RESPONSE_TIME, 150, // WARNING 임계값(100ms) 초과
21
+ { component: 'search_engine', operation: 'search' });
22
+ console.log(`생성된 알림 수: ${responseTimeAlerts.length}`);
23
+ // 2. 메모리 사용량 알림 테스트
24
+ console.log('\n📊 메모리 사용량 알림 테스트:');
25
+ const memoryAlerts = alertService.checkPerformanceMetric(AlertType.MEMORY_USAGE, 150, // WARNING 임계값(100MB) 초과
26
+ { component: 'memory_manager', heapTotal: 200 });
27
+ console.log(`생성된 알림 수: ${memoryAlerts.length}`);
28
+ // 3. 에러율 알림 테스트
29
+ console.log('\n📊 에러율 알림 테스트:');
30
+ const errorRateAlerts = alertService.checkPerformanceMetric(AlertType.ERROR_RATE, 7, // WARNING 임계값(5%) 초과
31
+ { component: 'system', totalOperations: 100 });
32
+ console.log(`생성된 알림 수: ${errorRateAlerts.length}`);
33
+ // 4. 알림 통계 조회
34
+ console.log('\n📈 알림 통계:');
35
+ const stats = alertService.getAlertStats(1);
36
+ console.log(`총 알림 수: ${stats.totalAlerts}`);
37
+ console.log(`활성 알림 수: ${stats.activeAlerts}`);
38
+ console.log(`WARNING 알림: ${stats.alertsByLevel.warning}`);
39
+ console.log(`CRITICAL 알림: ${stats.alertsByLevel.critical}`);
40
+ // 5. 활성 알림 조회
41
+ console.log('\n🔍 활성 알림:');
42
+ const activeAlerts = alertService.getActiveAlerts();
43
+ console.log(`활성 알림 수: ${activeAlerts.length}`);
44
+ activeAlerts.forEach((alert, index) => {
45
+ console.log(`${index + 1}. [${alert.level.toUpperCase()}] ${alert.metric}: ${alert.value} (임계값: ${alert.threshold})`);
46
+ console.log(` 메시지: ${alert.message}`);
47
+ console.log(` 시간: ${alert.timestamp.toISOString()}`);
48
+ });
49
+ // 6. 알림 해결 테스트
50
+ if (activeAlerts.length > 0) {
51
+ const firstAlert = activeAlerts[0];
52
+ if (firstAlert) {
53
+ console.log(`\n🔧 알림 해결 테스트: ${firstAlert.id}`);
54
+ const resolved = alertService.resolveAlert(firstAlert.id, 'test_user', '테스트용 해결');
55
+ if (resolved) {
56
+ console.log('✅ 알림 해결 성공');
57
+ }
58
+ else {
59
+ console.log('❌ 알림 해결 실패');
60
+ }
61
+ }
62
+ }
63
+ // 7. 해결 후 통계
64
+ console.log('\n📊 해결 후 통계:');
65
+ const finalStats = alertService.getAlertStats(1);
66
+ console.log(`총 알림 수: ${finalStats.totalAlerts}`);
67
+ console.log(`활성 알림 수: ${finalStats.activeAlerts}`);
68
+ console.log(`해결된 알림 수: ${finalStats.totalAlerts - finalStats.activeAlerts}`);
69
+ // 8. 로그 파일 확인
70
+ console.log('\n📁 로그 파일 확인:');
71
+ const fs = require('fs');
72
+ const logDir = './logs';
73
+ if (fs.existsSync(logDir)) {
74
+ const files = fs.readdirSync(logDir);
75
+ console.log(`로그 파일 수: ${files.length}`);
76
+ files.forEach((file) => {
77
+ const filePath = `${logDir}/${file}`;
78
+ const content = fs.readFileSync(filePath, 'utf8');
79
+ const lines = content.trim().split('\n');
80
+ console.log(`- ${file}: ${lines.length}개 알림 로그`);
81
+ // 첫 번째 로그 내용 출력
82
+ if (lines.length > 0) {
83
+ try {
84
+ const firstLog = JSON.parse(lines[0]);
85
+ console.log(` 첫 번째 로그: ${firstLog.level} - ${firstLog.message}`);
86
+ }
87
+ catch (e) {
88
+ console.log(` 첫 번째 로그: ${lines[0]}`);
89
+ }
90
+ }
91
+ });
92
+ }
93
+ else {
94
+ console.log('❌ 로그 디렉토리가 존재하지 않습니다.');
95
+ }
96
+ // 정리
97
+ alertService.cleanup();
98
+ console.log('\n🎉 간단한 성능 알림 테스트 완료');
99
+ }
100
+ catch (error) {
101
+ console.error('❌ 테스트 실패:', error);
102
+ }
103
+ }
104
+ // 직접 실행
105
+ testSimpleAlerts();
106
+ //# sourceMappingURL=test-simple-alerts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-simple-alerts.js","sourceRoot":"","sources":["../../src/test/test-simple-alerts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=test-vector-search-engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-vector-search-engine.d.ts","sourceRoot":"","sources":["../../src/test/test-vector-search-engine.ts"],"names":[],"mappings":""}
@@ -0,0 +1,225 @@
1
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
2
+ import { getVectorSearchEngine, VectorSearchEngine } from '../algorithms/vector-search-engine.js';
3
+ import Database from 'better-sqlite3';
4
+ import { DatabaseUtils } from '../utils/database.js';
5
+ // Mock sqlite-vss functions
6
+ const mockVssSearchRbf = vi.fn();
7
+ const mockVssSearch = vi.fn();
8
+ // Mock sqlite-vss extension
9
+ vi.mock('better-sqlite3', async () => {
10
+ const actual = await vi.importActual('better-sqlite3');
11
+ return {
12
+ ...actual,
13
+ default: class MockDatabase extends actual.default {
14
+ constructor(...args) {
15
+ super(...args);
16
+ // Mock sqlite-vss functions
17
+ this.function('vss_search_rbf', mockVssSearchRbf);
18
+ this.function('vss_search', mockVssSearch);
19
+ }
20
+ }
21
+ };
22
+ });
23
+ describe('VectorSearchEngine', () => {
24
+ let db;
25
+ let vectorSearchEngine;
26
+ beforeEach(() => {
27
+ // Create in-memory database for testing
28
+ db = new Database(':memory:');
29
+ DatabaseUtils.initializeDatabase(db);
30
+ vectorSearchEngine = getVectorSearchEngine();
31
+ vectorSearchEngine.initialize(db);
32
+ });
33
+ afterEach(() => {
34
+ if (db) {
35
+ db.close();
36
+ }
37
+ vi.clearAllMocks();
38
+ });
39
+ describe('초기화', () => {
40
+ it('should initialize successfully', () => {
41
+ expect(() => vectorSearchEngine.initialize(db)).not.toThrow();
42
+ });
43
+ it('should check VSS availability', () => {
44
+ const status = vectorSearchEngine.getIndexStatus();
45
+ expect(status).toHaveProperty('available');
46
+ expect(status).toHaveProperty('dimensions');
47
+ expect(typeof status.available).toBe('boolean');
48
+ expect(typeof status.dimensions).toBe('number');
49
+ });
50
+ });
51
+ describe('인덱스 상태', () => {
52
+ it('should return correct dimensions', () => {
53
+ const status = vectorSearchEngine.getIndexStatus();
54
+ expect(status.dimensions).toBe(1536); // Default embedding dimensions
55
+ });
56
+ });
57
+ describe('벡터 검색', () => {
58
+ const testQueryVector = Array(1536).fill(0.1);
59
+ const mockSearchResults = [
60
+ { memory_id: 'test1', similarity: 0.95 },
61
+ { memory_id: 'test2', similarity: 0.87 },
62
+ { memory_id: 'test3', similarity: 0.76 }
63
+ ];
64
+ beforeEach(() => {
65
+ // Setup mock VSS search results
66
+ mockVssSearchRbf.mockReturnValue(0.95);
67
+ mockVssSearch.mockReturnValue(0.95);
68
+ });
69
+ it('should return empty array when not initialized', async () => {
70
+ const newEngine = getVectorSearchEngine();
71
+ const results = await newEngine.search(testQueryVector);
72
+ expect(results).toEqual([]);
73
+ });
74
+ it('should return empty array when VSS not available', async () => {
75
+ // Mock VSS not available
76
+ const mockDb = {
77
+ prepare: vi.fn().mockReturnValue({
78
+ get: vi.fn().mockReturnValue(null)
79
+ })
80
+ };
81
+ const newEngine = getVectorSearchEngine();
82
+ newEngine.initialize(mockDb);
83
+ const results = await newEngine.search(testQueryVector);
84
+ expect(results).toEqual([]);
85
+ });
86
+ it('should perform basic vector search', async () => {
87
+ // Mock database query results
88
+ const mockQuery = vi.fn().mockReturnValue({
89
+ all: vi.fn().mockReturnValue(mockSearchResults)
90
+ });
91
+ const mockDb = {
92
+ prepare: vi.fn().mockReturnValue(mockQuery)
93
+ };
94
+ const newEngine = getVectorSearchEngine();
95
+ newEngine.initialize(mockDb);
96
+ const results = await newEngine.search(testQueryVector);
97
+ expect(mockQuery).toHaveBeenCalled();
98
+ expect(results).toHaveLength(3);
99
+ expect(results[0]).toHaveProperty('memory_id');
100
+ expect(results[0]).toHaveProperty('similarity');
101
+ });
102
+ it('should apply similarity threshold', async () => {
103
+ const mockQuery = vi.fn().mockReturnValue({
104
+ all: vi.fn().mockReturnValue(mockSearchResults)
105
+ });
106
+ const mockDb = {
107
+ prepare: vi.fn().mockReturnValue(mockQuery)
108
+ };
109
+ const newEngine = getVectorSearchEngine();
110
+ newEngine.initialize(mockDb);
111
+ const results = await newEngine.search(testQueryVector, { threshold: 0.8 });
112
+ expect(mockQuery).toHaveBeenCalledWith(expect.stringContaining('WHERE similarity >= ?'), expect.any(String), 0.8, expect.any(Number));
113
+ });
114
+ it('should apply limit', async () => {
115
+ const mockQuery = vi.fn().mockReturnValue({
116
+ all: vi.fn().mockReturnValue(mockSearchResults)
117
+ });
118
+ const mockDb = {
119
+ prepare: vi.fn().mockReturnValue(mockQuery)
120
+ };
121
+ const newEngine = getVectorSearchEngine();
122
+ newEngine.initialize(mockDb);
123
+ const results = await newEngine.search(testQueryVector, { limit: 5 });
124
+ expect(mockQuery).toHaveBeenCalledWith(expect.stringContaining('LIMIT ?'), expect.any(String), expect.any(Number), 5);
125
+ });
126
+ it('should filter by type', async () => {
127
+ const mockQuery = vi.fn().mockReturnValue({
128
+ all: vi.fn().mockReturnValue(mockSearchResults)
129
+ });
130
+ const mockDb = {
131
+ prepare: vi.fn().mockReturnValue(mockQuery)
132
+ };
133
+ const newEngine = getVectorSearchEngine();
134
+ newEngine.initialize(mockDb);
135
+ const results = await newEngine.search(testQueryVector, {
136
+ type: ['episodic', 'semantic']
137
+ });
138
+ expect(mockQuery).toHaveBeenCalledWith(expect.stringContaining('AND vss.rowid IN'), expect.any(String), expect.any(Number), 'episodic', 'semantic', expect.any(Number));
139
+ });
140
+ it('should include content when requested', async () => {
141
+ const mockSearchQuery = vi.fn().mockReturnValue({
142
+ all: vi.fn().mockReturnValue(mockSearchResults)
143
+ });
144
+ const mockContentQuery = vi.fn().mockReturnValue({
145
+ all: vi.fn().mockReturnValue([
146
+ { id: 'test1', content: 'Test content 1', type: 'episodic', importance: 0.5, created_at: '2024-01-01' },
147
+ { id: 'test2', content: 'Test content 2', type: 'semantic', importance: 0.7, created_at: '2024-01-02' }
148
+ ])
149
+ });
150
+ const mockDb = {
151
+ prepare: vi.fn()
152
+ .mockReturnValueOnce(mockSearchQuery)
153
+ .mockReturnValueOnce(mockContentQuery)
154
+ };
155
+ const newEngine = getVectorSearchEngine();
156
+ newEngine.initialize(mockDb);
157
+ const results = await newEngine.search(testQueryVector, {
158
+ includeContent: true
159
+ });
160
+ expect(results[0]).toHaveProperty('content');
161
+ expect(results[0]).toHaveProperty('type');
162
+ expect(results[0]).toHaveProperty('importance');
163
+ expect(results[0]).toHaveProperty('created_at');
164
+ });
165
+ it('should handle empty search results', async () => {
166
+ const mockQuery = vi.fn().mockReturnValue({
167
+ all: vi.fn().mockReturnValue([])
168
+ });
169
+ const mockDb = {
170
+ prepare: vi.fn().mockReturnValue(mockQuery)
171
+ };
172
+ const newEngine = getVectorSearchEngine();
173
+ newEngine.initialize(mockDb);
174
+ const results = await newEngine.search(testQueryVector);
175
+ expect(results).toEqual([]);
176
+ });
177
+ it('should handle database errors gracefully', async () => {
178
+ const mockQuery = vi.fn().mockReturnValue({
179
+ all: vi.fn().mockImplementation(() => {
180
+ throw new Error('Database error');
181
+ })
182
+ });
183
+ const mockDb = {
184
+ prepare: vi.fn().mockReturnValue(mockQuery)
185
+ };
186
+ const newEngine = getVectorSearchEngine();
187
+ newEngine.initialize(mockDb);
188
+ const results = await newEngine.search(testQueryVector);
189
+ expect(results).toEqual([]);
190
+ });
191
+ });
192
+ describe('기본값 처리', () => {
193
+ it('should use default options when none provided', async () => {
194
+ const mockQuery = vi.fn().mockReturnValue({
195
+ all: vi.fn().mockReturnValue([])
196
+ });
197
+ const mockDb = {
198
+ prepare: vi.fn().mockReturnValue(mockQuery)
199
+ };
200
+ const newEngine = getVectorSearchEngine();
201
+ newEngine.initialize(mockDb);
202
+ await newEngine.search(testQueryVector);
203
+ expect(mockQuery).toHaveBeenCalledWith(expect.stringContaining('LIMIT ?'), expect.any(String), 0.7, // default threshold
204
+ 10 // default limit
205
+ );
206
+ });
207
+ });
208
+ describe('JSON 직렬화', () => {
209
+ it('should serialize query vector to JSON', async () => {
210
+ const mockQuery = vi.fn().mockReturnValue({
211
+ all: vi.fn().mockReturnValue([])
212
+ });
213
+ const mockDb = {
214
+ prepare: vi.fn().mockReturnValue(mockQuery)
215
+ };
216
+ const newEngine = getVectorSearchEngine();
217
+ newEngine.initialize(mockDb);
218
+ await newEngine.search(testQueryVector);
219
+ const callArgs = mockQuery.mock.calls[0];
220
+ const queryVectorJson = callArgs[0];
221
+ expect(queryVectorJson).toBe(JSON.stringify(testQueryVector));
222
+ });
223
+ });
224
+ });
225
+ //# sourceMappingURL=test-vector-search-engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-vector-search-engine.js","sourceRoot":"","sources":["../../src/test/test-vector-search-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * 기본 도구 클래스
3
+ * 모든 MCP 도구의 기본 구조를 제공
4
+ */
5
+ import type { ToolDefinition, ToolContext, ToolResult, ToolError } from './types.js';
6
+ export declare abstract class BaseTool {
7
+ protected name: string;
8
+ protected description: string;
9
+ protected inputSchema: any;
10
+ constructor(name: string, description: string, inputSchema: any);
11
+ /**
12
+ * 도구 정의 반환
13
+ */
14
+ getDefinition(): ToolDefinition;
15
+ /**
16
+ * 도구 실행 (추상 메서드)
17
+ */
18
+ abstract handle(params: any, context: ToolContext): Promise<ToolResult>;
19
+ /**
20
+ * 성공 결과 생성
21
+ */
22
+ protected createSuccessResult(data: any): ToolResult;
23
+ /**
24
+ * 에러 결과 생성
25
+ */
26
+ protected createErrorResult(error: string, message?: string, details?: string): ToolError;
27
+ /**
28
+ * 안전한 JSON 파싱
29
+ */
30
+ protected safeJsonParse(jsonString: string, fallback?: any): any;
31
+ /**
32
+ * 안전한 문자열 검증
33
+ */
34
+ protected validateString(value: any, fieldName: string, maxLength?: number): string;
35
+ /**
36
+ * 안전한 숫자 검증
37
+ */
38
+ protected validateNumber(value: any, fieldName: string, min?: number, max?: number): number;
39
+ /**
40
+ * 안전한 배열 검증
41
+ */
42
+ protected validateArray(value: any, fieldName: string, maxLength?: number): any[];
43
+ /**
44
+ * 에러 로깅
45
+ */
46
+ protected logError(error: Error, context: string, additionalData?: any): void;
47
+ /**
48
+ * 경고 로깅
49
+ */
50
+ protected logWarning(message: string, additionalData?: any): void;
51
+ /**
52
+ * 정보 로깅
53
+ */
54
+ protected logInfo(message: string, additionalData?: any): void;
55
+ /**
56
+ * 데이터베이스 연결 확인
57
+ */
58
+ protected validateDatabase(context: ToolContext): void;
59
+ /**
60
+ * 서비스 확인
61
+ */
62
+ protected validateService(service: any, serviceName: string): void;
63
+ }
64
+ //# sourceMappingURL=base-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base-tool.d.ts","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAElG,8BAAsB,QAAQ;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG;IAM/D;;OAEG;IACH,aAAa,IAAI,cAAc;IAS/B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAEvE;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU;IAWpD;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQzF;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,GAAU,GAAG,GAAG;IAStE;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM;IAgBzF;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAkB3F;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,GAAG,EAAE;IAYtF;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,IAAI;IAa7E;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,IAAI;IAWjE;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,IAAI;IAW9D;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMtD;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAKnE"}