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,614 @@
1
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
2
+ import Database from 'better-sqlite3';
3
+ import { DatabaseUtils } from '../utils/database.js';
4
+ import { getHybridSearchEngine } from '../algorithms/hybrid-search-engine.js';
5
+ import { getVectorSearchEngine } from '../algorithms/vector-search-engine.js';
6
+ import { getPerformanceMonitor } from '../services/performance-monitor.js';
7
+ import { getBatchScheduler } from '../services/batch-scheduler.js';
8
+ import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
9
+ import { ForgettingPolicyService } from '../services/forgetting-policy-service.js';
10
+ import { MemoryInjectionPrompt } from '../tools/memory-injection-prompt.js';
11
+
12
+ // Mock external dependencies
13
+ vi.mock('../services/memory-embedding-service.js');
14
+ vi.mock('../services/forgetting-policy-service.js');
15
+
16
+ describe('M1 완성도 테스트', () => {
17
+ let db: Database.Database;
18
+ let hybridSearchEngine: any;
19
+ let vectorSearchEngine: any;
20
+ let performanceMonitor: any;
21
+ let batchScheduler: any;
22
+ let embeddingService: any;
23
+ let forgettingService: any;
24
+ let memoryInjectionPrompt: MemoryInjectionPrompt;
25
+
26
+ beforeEach(async () => {
27
+ // Create in-memory database for testing
28
+ db = new Database(':memory:');
29
+
30
+ // Initialize database schema
31
+ await DatabaseUtils.initializeDatabase(db);
32
+
33
+ // Initialize services
34
+ hybridSearchEngine = getHybridSearchEngine();
35
+ vectorSearchEngine = getVectorSearchEngine();
36
+ performanceMonitor = getPerformanceMonitor();
37
+ batchScheduler = getBatchScheduler();
38
+ memoryInjectionPrompt = new MemoryInjectionPrompt();
39
+
40
+ // Mock embedding service
41
+ embeddingService = {
42
+ isAvailable: vi.fn().mockReturnValue(true),
43
+ generateEmbedding: vi.fn().mockResolvedValue(Array(1536).fill(0.1)),
44
+ searchBySimilarity: vi.fn().mockResolvedValue([]),
45
+ getEmbeddingStats: vi.fn().mockResolvedValue({ totalEmbeddings: 0, averageSimilarity: 0 })
46
+ };
47
+ vi.mocked(MemoryEmbeddingService).mockImplementation(() => embeddingService);
48
+
49
+ // Mock forgetting service
50
+ forgettingService = {
51
+ executeMemoryCleanup: vi.fn().mockResolvedValue({
52
+ softDeleted: [],
53
+ hardDeleted: [],
54
+ reviewed: [],
55
+ totalProcessed: 0
56
+ })
57
+ };
58
+ vi.mocked(ForgettingPolicyService).mockImplementation(() => forgettingService);
59
+
60
+ // Initialize services
61
+ vectorSearchEngine.initialize(db);
62
+ performanceMonitor.initialize(db);
63
+ });
64
+
65
+ afterEach(() => {
66
+ if (db) {
67
+ db.close();
68
+ }
69
+ batchScheduler.stop();
70
+ vi.clearAllMocks();
71
+ });
72
+
73
+ describe('M1 핵심 기능 완성도', () => {
74
+ it('should have all required database tables', () => {
75
+ const tables = db.prepare(`
76
+ SELECT name FROM sqlite_master
77
+ WHERE type='table' AND name NOT LIKE 'sqlite_%'
78
+ ORDER BY name
79
+ `).all() as { name: string }[];
80
+
81
+ const tableNames = tables.map(t => t.name);
82
+ const requiredTables = [
83
+ 'memory_item',
84
+ 'memory_embedding',
85
+ 'memory_tag',
86
+ 'memory_item_tag',
87
+ 'memory_link',
88
+ 'feedback_event',
89
+ 'wm_buffer'
90
+ ];
91
+
92
+ requiredTables.forEach(tableName => {
93
+ expect(tableNames).toContain(tableName);
94
+ });
95
+ });
96
+
97
+ it('should have all required virtual tables', () => {
98
+ const virtualTables = db.prepare(`
99
+ SELECT name FROM sqlite_master
100
+ WHERE type='table' AND (name LIKE '%_fts' OR name LIKE '%_vss')
101
+ ORDER BY name
102
+ `).all() as { name: string }[];
103
+
104
+ const virtualTableNames = virtualTables.map(t => t.name);
105
+
106
+ expect(virtualTableNames).toContain('memory_item_fts');
107
+ // memory_item_vec는 vec0 모듈이 필요하므로 테스트 환경에서는 선택사항
108
+ // expect(virtualTableNames).toContain('memory_item_vec');
109
+ });
110
+
111
+ it('should have all required indexes', () => {
112
+ const indexes = db.prepare(`
113
+ SELECT name FROM sqlite_master
114
+ WHERE type='index' AND name NOT LIKE 'sqlite_%'
115
+ ORDER BY name
116
+ `).all() as { name: string }[];
117
+
118
+ const indexNames = indexes.map(i => i.name);
119
+ const requiredIndexes = [
120
+ 'idx_memory_item_type',
121
+ 'idx_memory_item_created_at',
122
+ 'idx_memory_item_last_accessed',
123
+ 'idx_memory_item_importance',
124
+ 'idx_memory_item_pinned',
125
+ 'idx_memory_item_user_id',
126
+ 'idx_memory_item_project_id'
127
+ ];
128
+
129
+ requiredIndexes.forEach(indexName => {
130
+ expect(indexNames).toContain(indexName);
131
+ });
132
+ });
133
+ });
134
+
135
+ describe('M1 메모리 관리 기능', () => {
136
+ it('should support all memory types', () => {
137
+ const memoryTypes = ['working', 'episodic', 'semantic', 'procedural'];
138
+
139
+ memoryTypes.forEach(type => {
140
+ const result = db.prepare(`
141
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
142
+ VALUES (?, ?, ?, ?, 'private', datetime('now'))
143
+ `).run(`test-${type}`, type, `Test ${type} memory`, 0.5);
144
+
145
+ expect(result.changes).toBe(1);
146
+ });
147
+
148
+ // 검증
149
+ const count = db.prepare('SELECT COUNT(*) as count FROM memory_item').get() as { count: number };
150
+ expect(count.count).toBe(4);
151
+ });
152
+
153
+ it('should support all privacy scopes', () => {
154
+ const privacyScopes = ['private', 'team', 'public'];
155
+
156
+ privacyScopes.forEach(scope => {
157
+ const result = db.prepare(`
158
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
159
+ VALUES (?, 'episodic', 'Test memory', 0.5, ?, datetime('now'))
160
+ `).run(`test-${scope}`, scope);
161
+
162
+ expect(result.changes).toBe(1);
163
+ });
164
+
165
+ // 검증
166
+ const count = db.prepare('SELECT COUNT(*) as count FROM memory_item').get() as { count: number };
167
+ expect(count.count).toBe(3);
168
+ });
169
+
170
+ it('should support memory pinning', () => {
171
+ const result = db.prepare(`
172
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
173
+ VALUES (?, 'episodic', 'Pinned memory', 0.8, 'private', datetime('now'), 1)
174
+ `).run('pinned-test');
175
+
176
+ expect(result.changes).toBe(1);
177
+
178
+ // 검증
179
+ const memory = db.prepare('SELECT * FROM memory_item WHERE id = ?').get('pinned-test') as any;
180
+ expect(memory.pinned).toBe(1);
181
+ });
182
+
183
+ it('should support memory tags', () => {
184
+ // 메모리 저장
185
+ db.prepare(`
186
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
187
+ VALUES (?, 'episodic', 'Tagged memory', 0.5, 'private', datetime('now'))
188
+ `).run('tagged-test');
189
+
190
+ // 태그 저장
191
+ const tagResult = db.prepare(`
192
+ INSERT INTO memory_tag (name) VALUES (?)
193
+ `).run('test-tag');
194
+
195
+ // 메모리-태그 관계 저장
196
+ const relationResult = db.prepare(`
197
+ INSERT INTO memory_item_tag (memory_id, tag_id) VALUES (?, ?)
198
+ `).run('tagged-test', tagResult.lastInsertRowid);
199
+
200
+ expect(relationResult.changes).toBe(1);
201
+ });
202
+
203
+ it('should support memory links', () => {
204
+ // 두 메모리 저장
205
+ db.prepare(`
206
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
207
+ VALUES (?, 'episodic', 'Source memory', 0.5, 'private', datetime('now'))
208
+ `).run('source-memory');
209
+
210
+ db.prepare(`
211
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
212
+ VALUES (?, 'semantic', 'Target memory', 0.7, 'private', datetime('now'))
213
+ `).run('target-memory');
214
+
215
+ // 메모리 링크 저장
216
+ const linkResult = db.prepare(`
217
+ INSERT INTO memory_link (source_id, target_id, relation_type)
218
+ VALUES (?, ?, ?)
219
+ `).run('source-memory', 'target-memory', 'derived_from');
220
+
221
+ expect(linkResult.changes).toBe(1);
222
+ });
223
+ });
224
+
225
+ describe('M1 검색 기능 완성도', () => {
226
+ beforeEach(() => {
227
+ // 테스트 데이터 준비
228
+ const testMemories = [
229
+ {
230
+ id: 'search-test-1',
231
+ type: 'episodic',
232
+ content: 'React Hook을 사용한 상태 관리 방법',
233
+ importance: 0.8,
234
+ created_at: '2024-01-01T00:00:00Z'
235
+ },
236
+ {
237
+ id: 'search-test-2',
238
+ type: 'semantic',
239
+ content: 'JavaScript 클로저의 개념과 활용',
240
+ importance: 0.9,
241
+ created_at: '2024-01-02T00:00:00Z'
242
+ },
243
+ {
244
+ id: 'search-test-3',
245
+ type: 'procedural',
246
+ content: 'TypeScript 프로젝트 설정 절차',
247
+ importance: 0.7,
248
+ created_at: '2024-01-03T00:00:00Z'
249
+ }
250
+ ];
251
+
252
+ testMemories.forEach(memory => {
253
+ db.prepare(`
254
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
255
+ VALUES (?, ?, ?, ?, 'private', ?, 0)
256
+ `).run(
257
+ memory.id,
258
+ memory.type,
259
+ memory.content,
260
+ memory.importance,
261
+ memory.created_at
262
+ );
263
+ });
264
+ });
265
+
266
+ it('should perform text search', async () => {
267
+ const searchResult = await hybridSearchEngine.search(db, {
268
+ query: 'React Hook',
269
+ limit: 10
270
+ });
271
+
272
+ expect(searchResult).toHaveProperty('items');
273
+ expect(searchResult).toHaveProperty('total_count');
274
+ expect(searchResult).toHaveProperty('query_time');
275
+ expect(Array.isArray(searchResult.items)).toBe(true);
276
+ });
277
+
278
+ it('should perform vector search', async () => {
279
+ const queryVector = Array(1536).fill(0.1);
280
+ const searchResult = await vectorSearchEngine.search(queryVector, {
281
+ limit: 10,
282
+ threshold: 0.5
283
+ });
284
+
285
+ expect(Array.isArray(searchResult)).toBe(true);
286
+ });
287
+
288
+ it('should perform hybrid search with filters', async () => {
289
+ const searchResult = await hybridSearchEngine.search(db, {
290
+ query: 'JavaScript',
291
+ filters: {
292
+ type: ['semantic', 'procedural']
293
+ },
294
+ limit: 10
295
+ });
296
+
297
+ expect(searchResult.items.length).toBeGreaterThan(0);
298
+ searchResult.items.forEach(item => {
299
+ expect(['semantic', 'procedural']).toContain(item.type);
300
+ });
301
+ });
302
+
303
+ it('should support memory injection prompt', async () => {
304
+ const result = await memoryInjectionPrompt.handle(
305
+ {
306
+ query: 'React',
307
+ token_budget: 1000,
308
+ max_memories: 5
309
+ },
310
+ {
311
+ db,
312
+ services: { hybridSearchEngine }
313
+ }
314
+ );
315
+
316
+ expect(result).toHaveProperty('content');
317
+ expect(Array.isArray(result.content)).toBe(true);
318
+ expect(result.content[0]).toHaveProperty('type');
319
+ expect(result.content[0]).toHaveProperty('text');
320
+ });
321
+ });
322
+
323
+ describe('M1 성능 모니터링 완성도', () => {
324
+ it('should collect all required metrics', async () => {
325
+ const metrics = await performanceMonitor.collectMetrics();
326
+
327
+ // 기본 메트릭
328
+ expect(metrics).toHaveProperty('timestamp');
329
+ expect(metrics).toHaveProperty('uptime');
330
+
331
+ // 메모리 메트릭
332
+ expect(metrics.memory).toHaveProperty('rss');
333
+ expect(metrics.memory).toHaveProperty('heapTotal');
334
+ expect(metrics.memory).toHaveProperty('heapUsed');
335
+ expect(metrics.memory).toHaveProperty('external');
336
+
337
+ // CPU 메트릭
338
+ expect(metrics.cpu).toHaveProperty('user');
339
+ expect(metrics.cpu).toHaveProperty('system');
340
+
341
+ // 데이터베이스 메트릭
342
+ expect(metrics.database).toHaveProperty('size');
343
+ expect(metrics.database).toHaveProperty('memoryCount');
344
+ expect(metrics.database).toHaveProperty('queryTime');
345
+ });
346
+
347
+ it('should generate performance alerts', async () => {
348
+ // 고메모리 사용량 시뮬레이션
349
+ const originalMemoryUsage = process.memoryUsage;
350
+ process.memoryUsage = vi.fn().mockReturnValue({
351
+ rss: 0,
352
+ heapTotal: 1000,
353
+ heapUsed: 950, // 95% 사용률 (critical 임계값 90% 초과)
354
+ external: 0,
355
+ arrayBuffers: 0
356
+ });
357
+
358
+ await performanceMonitor.collectMetrics();
359
+
360
+ const alerts = performanceMonitor.getActiveAlerts();
361
+ expect(alerts.length).toBeGreaterThan(0);
362
+
363
+ const memoryAlert = alerts.find(alert => alert.type === 'memory');
364
+ expect(memoryAlert).toBeDefined();
365
+ expect(memoryAlert?.severity).toBe('critical');
366
+
367
+ // 원래 함수 복원
368
+ process.memoryUsage = originalMemoryUsage;
369
+ });
370
+
371
+ it('should provide performance summary', () => {
372
+ const summary = performanceMonitor.getPerformanceSummary();
373
+
374
+ expect(summary).toHaveProperty('current');
375
+ expect(summary).toHaveProperty('alerts');
376
+ expect(summary).toHaveProperty('trends');
377
+
378
+ expect(summary.alerts).toHaveProperty('active');
379
+ expect(summary.alerts).toHaveProperty('total');
380
+ expect(summary.trends).toHaveProperty('memoryTrend');
381
+ expect(summary.trends).toHaveProperty('dbSizeTrend');
382
+ });
383
+ });
384
+
385
+ describe('M1 배치 처리 완성도', () => {
386
+ it('should start and stop scheduler', async () => {
387
+ await batchScheduler.start(db);
388
+
389
+ const status = batchScheduler.getStatus();
390
+ expect(status.isRunning).toBe(true);
391
+ expect(status.activeJobs).toContain('cleanup');
392
+ expect(status.activeJobs).toContain('monitoring');
393
+
394
+ batchScheduler.stop();
395
+
396
+ const stoppedStatus = batchScheduler.getStatus();
397
+ expect(stoppedStatus.isRunning).toBe(false);
398
+ expect(stoppedStatus.activeJobs).toEqual([]);
399
+ });
400
+
401
+ it('should execute memory cleanup job', async () => {
402
+ await batchScheduler.start(db);
403
+
404
+ const result = await batchScheduler.runJob('cleanup');
405
+
406
+ expect(result.jobType).toBe('memory_cleanup');
407
+ expect(result.success).toBe(true);
408
+ expect(result).toHaveProperty('startTime');
409
+ expect(result).toHaveProperty('endTime');
410
+ expect(result).toHaveProperty('duration');
411
+ expect(result).toHaveProperty('processed');
412
+ expect(result).toHaveProperty('errors');
413
+ });
414
+
415
+ it('should execute monitoring job', async () => {
416
+ await batchScheduler.start(db);
417
+
418
+ const result = await batchScheduler.runJob('monitoring');
419
+
420
+ expect(result.jobType).toBe('monitoring');
421
+ expect(result.success).toBe(true);
422
+ expect(result.details).toHaveProperty('metrics');
423
+ expect(result.details).toHaveProperty('stats');
424
+ expect(result.details).toHaveProperty('alerts');
425
+ });
426
+ });
427
+
428
+ describe('M1 벡터 검색 완성도', () => {
429
+ it('should initialize vector search engine', () => {
430
+ const status = vectorSearchEngine.getIndexStatus();
431
+
432
+ expect(status).toHaveProperty('available');
433
+ expect(status).toHaveProperty('tableExists');
434
+ expect(status).toHaveProperty('recordCount');
435
+ expect(typeof status.available).toBe('boolean');
436
+ expect(typeof status.tableExists).toBe('boolean');
437
+ expect(typeof status.recordCount).toBe('number');
438
+ });
439
+
440
+ it('should perform vector search', async () => {
441
+ const queryVector = Array(1536).fill(0.1);
442
+ const results = await vectorSearchEngine.search(queryVector, {
443
+ limit: 10,
444
+ threshold: 0.5
445
+ });
446
+
447
+ expect(Array.isArray(results)).toBe(true);
448
+ results.forEach(result => {
449
+ expect(result).toHaveProperty('memory_id');
450
+ expect(result).toHaveProperty('similarity');
451
+ expect(result).toHaveProperty('content');
452
+ expect(result).toHaveProperty('type');
453
+ expect(result).toHaveProperty('importance');
454
+ expect(result).toHaveProperty('created_at');
455
+ });
456
+ });
457
+
458
+ it('should perform hybrid search', async () => {
459
+ const queryVector = Array(1536).fill(0.1);
460
+ const textQuery = 'test query';
461
+ const results = await vectorSearchEngine.hybridSearch(queryVector, textQuery, {
462
+ limit: 10,
463
+ threshold: 0.5
464
+ });
465
+
466
+ expect(Array.isArray(results)).toBe(true);
467
+ });
468
+
469
+ it('should rebuild index', async () => {
470
+ const result = await vectorSearchEngine.rebuildIndex();
471
+ expect(typeof result).toBe('boolean');
472
+ });
473
+
474
+ it('should perform performance test', async () => {
475
+ const queryVector = Array(1536).fill(0.1);
476
+ const result = await vectorSearchEngine.performanceTest(queryVector, 3);
477
+
478
+ expect(result).toHaveProperty('averageTime');
479
+ expect(result).toHaveProperty('minTime');
480
+ expect(result).toHaveProperty('maxTime');
481
+ expect(result).toHaveProperty('results');
482
+ expect(typeof result.averageTime).toBe('number');
483
+ expect(typeof result.minTime).toBe('number');
484
+ expect(typeof result.maxTime).toBe('number');
485
+ expect(typeof result.results).toBe('number');
486
+ });
487
+ });
488
+
489
+ describe('M1 전체 시스템 완성도', () => {
490
+ it('should complete full M1 workflow', async () => {
491
+ // 1. 메모리 저장
492
+ const memoryId = 'm1-completion-test';
493
+ db.prepare(`
494
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at, pinned)
495
+ VALUES (?, 'episodic', 'M1 완성도 테스트 메모리', 0.9, 'private', datetime('now'), 0)
496
+ `).run(memoryId);
497
+
498
+ // 2. 성능 모니터링
499
+ const metrics = await performanceMonitor.collectMetrics();
500
+ expect(metrics.database.memoryCount).toBe(1);
501
+
502
+ // 3. 배치 스케줄러 시작
503
+ await batchScheduler.start(db);
504
+ expect(batchScheduler.getStatus().isRunning).toBe(true);
505
+
506
+ // 4. 하이브리드 검색
507
+ const searchResult = await hybridSearchEngine.search(db, {
508
+ query: 'M1 완성도',
509
+ limit: 10
510
+ });
511
+ expect(searchResult.items.length).toBeGreaterThan(0);
512
+
513
+ // 5. 메모리 주입
514
+ const injectionResult = await memoryInjectionPrompt.handle(
515
+ {
516
+ query: 'M1',
517
+ token_budget: 500,
518
+ max_memories: 3
519
+ },
520
+ {
521
+ db,
522
+ services: { hybridSearchEngine }
523
+ }
524
+ );
525
+ expect(injectionResult.content[0].text).toContain('M1');
526
+
527
+ // 6. 벡터 검색
528
+ const queryVector = Array(1536).fill(0.1);
529
+ const vectorResults = await vectorSearchEngine.search(queryVector, {
530
+ limit: 10,
531
+ threshold: 0.5
532
+ });
533
+ expect(Array.isArray(vectorResults)).toBe(true);
534
+
535
+ // 7. 정리
536
+ batchScheduler.stop();
537
+ expect(batchScheduler.getStatus().isRunning).toBe(false);
538
+ });
539
+
540
+ it('should handle all M1 error scenarios', async () => {
541
+ // 데이터베이스 연결 끊기
542
+ db.close();
543
+
544
+ // 성능 모니터링에서 에러 처리 확인
545
+ const metrics = await performanceMonitor.collectMetrics();
546
+ expect(metrics.database.memoryCount).toBe(0);
547
+ expect(metrics.database.size).toBe(0);
548
+
549
+ // 임베딩 서비스 비활성화
550
+ embeddingService.isAvailable.mockReturnValue(false);
551
+
552
+ // 새로운 데이터베이스로 재시작
553
+ const newDb = new Database(':memory:');
554
+ await DatabaseUtils.initializeDatabase(newDb);
555
+
556
+ const searchResult = await hybridSearchEngine.search(newDb, {
557
+ query: 'test query',
558
+ limit: 10
559
+ });
560
+
561
+ // 텍스트 검색만으로도 결과가 나와야 함
562
+ expect(searchResult).toHaveProperty('items');
563
+ expect(searchResult).toHaveProperty('total_count');
564
+
565
+ newDb.close();
566
+ });
567
+ });
568
+
569
+ describe('M1 성능 요구사항', () => {
570
+ it('should meet search performance requirements', async () => {
571
+ // 테스트 데이터 준비
572
+ for (let i = 0; i < 100; i++) {
573
+ db.prepare(`
574
+ INSERT INTO memory_item (id, type, content, importance, privacy_scope, created_at)
575
+ VALUES (?, 'episodic', ?, 0.5, 'private', datetime('now'))
576
+ `).run(`perf-test-${i}`, `Performance test memory ${i}`);
577
+ }
578
+
579
+ // FTS5 인덱스 업데이트를 위해 잠시 대기
580
+ await new Promise(resolve => setTimeout(resolve, 100));
581
+
582
+ const startTime = Date.now();
583
+ const searchResult = await hybridSearchEngine.search(db, {
584
+ query: 'Performance test',
585
+ limit: 10
586
+ });
587
+ const endTime = Date.now();
588
+
589
+ // 검색 결과가 있거나 성능 요구사항을 만족하면 통과
590
+ expect(searchResult.items.length).toBeGreaterThanOrEqual(0);
591
+ expect(endTime - startTime).toBeLessThan(1000); // 1초 이내
592
+ });
593
+
594
+ it('should handle concurrent operations', async () => {
595
+ // 동시 검색 실행
596
+ const searchPromises = Array.from({ length: 10 }, (_, i) =>
597
+ hybridSearchEngine.search(db, {
598
+ query: `concurrent test ${i}`,
599
+ limit: 5
600
+ })
601
+ );
602
+
603
+ const results = await Promise.all(searchPromises);
604
+
605
+ // 모든 검색이 성공해야 함
606
+ results.forEach(result => {
607
+ expect(result).toHaveProperty('items');
608
+ expect(result).toHaveProperty('total_count');
609
+ expect(Array.isArray(result.items)).toBe(true);
610
+ });
611
+ });
612
+ });
613
+ });
614
+