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,122 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { createBatchScheduler, BatchScheduler } from '../services/batch-scheduler.js';
3
+ import Database from 'better-sqlite3';
4
+
5
+ describe('BatchScheduler (Simple)', () => {
6
+ let db: Database.Database;
7
+ let batchScheduler: BatchScheduler;
8
+
9
+ beforeEach(() => {
10
+ // Create in-memory database for testing
11
+ db = new Database(':memory:');
12
+ // Initialize database schema
13
+ db.exec(`
14
+ CREATE TABLE memory_item (
15
+ id TEXT PRIMARY KEY,
16
+ type TEXT CHECK (type IN ('working','episodic','semantic','procedural')),
17
+ content TEXT NOT NULL,
18
+ importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
19
+ privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
20
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
21
+ last_accessed TIMESTAMP,
22
+ pinned BOOLEAN DEFAULT FALSE,
23
+ source TEXT,
24
+ agent_id TEXT,
25
+ user_id TEXT,
26
+ project_id TEXT,
27
+ origin_trace TEXT
28
+ );
29
+ `);
30
+
31
+ batchScheduler = createBatchScheduler({
32
+ cleanupInterval: 1000, // 1초 for testing
33
+ monitoringInterval: 500, // 0.5초 for testing
34
+ enableLogging: false
35
+ });
36
+ });
37
+
38
+ afterEach(() => {
39
+ if (db) {
40
+ db.close();
41
+ }
42
+ batchScheduler.stop();
43
+ });
44
+
45
+ describe('초기화', () => {
46
+ it('should initialize successfully', async () => {
47
+ await expect(batchScheduler.start(db)).resolves.not.toThrow();
48
+ });
49
+
50
+ it('should not start if already running', async () => {
51
+ await batchScheduler.start(db);
52
+ await expect(batchScheduler.start(db)).rejects.toThrow('BatchScheduler is already running');
53
+ });
54
+ });
55
+
56
+ describe('상태 관리', () => {
57
+ it('should return correct status when not running', () => {
58
+ const status = batchScheduler.getStatus();
59
+ expect(status.isRunning).toBe(false);
60
+ expect(status.activeJobs).toEqual([]);
61
+ });
62
+
63
+ it('should return correct status when running', async () => {
64
+ await batchScheduler.start(db);
65
+ const status = batchScheduler.getStatus();
66
+ expect(status.isRunning).toBe(true);
67
+ expect(status.activeJobs).toContain('cleanup');
68
+ expect(status.activeJobs).toContain('monitoring');
69
+ });
70
+ });
71
+
72
+ describe('작업 실행', () => {
73
+ beforeEach(async () => {
74
+ await batchScheduler.start(db);
75
+ });
76
+
77
+ it('should run cleanup job successfully', async () => {
78
+ const result = await batchScheduler.runJob('cleanup');
79
+ expect(result.jobType).toBe('memory_cleanup');
80
+ expect(result.success).toBe(true);
81
+ });
82
+
83
+ it('should run monitoring job successfully', async () => {
84
+ const result = await batchScheduler.runJob('monitoring');
85
+ expect(result.jobType).toBe('monitoring');
86
+ expect(result.success).toBe(true);
87
+ });
88
+
89
+ it('should handle unknown job type', async () => {
90
+ await expect(batchScheduler.runJob('unknown' as any)).rejects.toThrow('Unknown job type: unknown');
91
+ });
92
+ });
93
+
94
+ describe('중지', () => {
95
+ it('should stop all jobs', async () => {
96
+ await batchScheduler.start(db);
97
+ batchScheduler.stop();
98
+
99
+ const status = batchScheduler.getStatus();
100
+ expect(status.isRunning).toBe(false);
101
+ expect(status.activeJobs).toEqual([]);
102
+ });
103
+ });
104
+
105
+ describe('데이터베이스 통계', () => {
106
+ beforeEach(async () => {
107
+ await batchScheduler.start(db);
108
+
109
+ // Add some test data
110
+ db.prepare(`
111
+ INSERT INTO memory_item (id, type, content, importance, created_at)
112
+ VALUES ('test1', 'episodic', 'Test memory 1', 0.5, datetime('now'))
113
+ `).run();
114
+ });
115
+
116
+ it('should collect database statistics', async () => {
117
+ const result = await batchScheduler.runJob('monitoring');
118
+ expect(result.success).toBe(true);
119
+ expect(result.details?.stats).toBeDefined();
120
+ });
121
+ });
122
+ });
@@ -0,0 +1,453 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { getBatchScheduler, BatchScheduler } from '../services/batch-scheduler.js';
3
+ import { getPerformanceMonitor } from '../services/performance-monitor.js';
4
+ import { ForgettingPolicyService } from '../services/forgetting-policy-service.js';
5
+ import Database from 'better-sqlite3';
6
+ import { DatabaseUtils } from '../utils/database.js';
7
+
8
+ // Mock dependencies
9
+ import { vi } from 'vitest';
10
+ vi.mock('../services/performance-monitor.js');
11
+ vi.mock('../services/forgetting-policy-service.js');
12
+
13
+ describe('BatchScheduler', () => {
14
+ let db: Database.Database;
15
+ let batchScheduler: BatchScheduler;
16
+ let mockPerformanceMonitor: any;
17
+ let mockForgettingService: any;
18
+
19
+ beforeEach(() => {
20
+ // Create in-memory database for testing
21
+ db = new Database(':memory:');
22
+ // Initialize database schema
23
+ db.exec(`
24
+ CREATE TABLE memory_item (
25
+ id TEXT PRIMARY KEY,
26
+ type TEXT CHECK (type IN ('working','episodic','semantic','procedural')),
27
+ content TEXT NOT NULL,
28
+ importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
29
+ privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
30
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
31
+ last_accessed TIMESTAMP,
32
+ pinned BOOLEAN DEFAULT FALSE,
33
+ source TEXT,
34
+ agent_id TEXT,
35
+ user_id TEXT,
36
+ project_id TEXT,
37
+ origin_trace TEXT
38
+ );
39
+ `);
40
+
41
+ // Mock performance monitor
42
+ mockPerformanceMonitor = {
43
+ initialize: vi.fn(),
44
+ collectMetrics: vi.fn().mockResolvedValue({
45
+ timestamp: new Date(),
46
+ cpu: { user: 0, system: 0 },
47
+ memory: { rss: 0, heapTotal: 0, heapUsed: 0, external: 0 },
48
+ database: { size: 0, memoryCount: 0, queryTime: 0 },
49
+ uptime: 0
50
+ }),
51
+ getActiveAlerts: vi.fn().mockReturnValue([])
52
+ };
53
+
54
+ // Mock forgetting service
55
+ mockForgettingService = {
56
+ executeMemoryCleanup: vi.fn().mockResolvedValue({
57
+ softDeleted: [],
58
+ hardDeleted: [],
59
+ reviewed: []
60
+ })
61
+ };
62
+
63
+ // Setup mocks
64
+ vi.mocked(getPerformanceMonitor).mockReturnValue(mockPerformanceMonitor);
65
+ vi.mocked(ForgettingPolicyService).mockImplementation(() => mockForgettingService);
66
+
67
+ batchScheduler = getBatchScheduler({
68
+ cleanupInterval: 1000, // 1초 for testing
69
+ monitoringInterval: 500, // 0.5초 for testing
70
+ enableLogging: false
71
+ });
72
+ });
73
+
74
+ afterEach(() => {
75
+ if (db) {
76
+ db.close();
77
+ }
78
+ batchScheduler.stop();
79
+ });
80
+
81
+ describe('초기화', () => {
82
+ it('should initialize successfully', async () => {
83
+ await expect(batchScheduler.start(db)).resolves.not.toThrow();
84
+ expect(mockPerformanceMonitor.initialize).toHaveBeenCalledWith(db);
85
+ });
86
+
87
+ it('should not start if already running', async () => {
88
+ await batchScheduler.start(db);
89
+ await expect(batchScheduler.start(db)).rejects.toThrow('BatchScheduler is already running');
90
+ });
91
+ });
92
+
93
+ describe('상태 관리', () => {
94
+ it('should return correct status when not running', () => {
95
+ const status = batchScheduler.getStatus();
96
+ expect(status.isRunning).toBe(false);
97
+ expect(status.activeJobs).toEqual([]);
98
+ });
99
+
100
+ it('should return correct status when running', async () => {
101
+ await batchScheduler.start(db);
102
+ const status = batchScheduler.getStatus();
103
+ expect(status.isRunning).toBe(true);
104
+ expect(status.activeJobs).toContain('cleanup');
105
+ expect(status.activeJobs).toContain('monitoring');
106
+ });
107
+ });
108
+
109
+ describe('작업 실행', () => {
110
+ beforeEach(async () => {
111
+ await batchScheduler.start(db);
112
+ });
113
+
114
+ it('should run cleanup job successfully', async () => {
115
+ const result = await batchScheduler.runJob('cleanup');
116
+ expect(result.jobType).toBe('memory_cleanup');
117
+ expect(result.success).toBe(true);
118
+ expect(mockForgettingService.executeMemoryCleanup).toHaveBeenCalledWith(db);
119
+ });
120
+
121
+ it('should run monitoring job successfully', async () => {
122
+ const result = await batchScheduler.runJob('monitoring');
123
+ expect(result.jobType).toBe('monitoring');
124
+ expect(result.success).toBe(true);
125
+ expect(mockPerformanceMonitor.collectMetrics).toHaveBeenCalled();
126
+ });
127
+
128
+ it('should handle unknown job type', async () => {
129
+ await expect(batchScheduler.runJob('unknown' as any)).rejects.toThrow('Unknown job type: unknown');
130
+ });
131
+ });
132
+
133
+ describe('메모리 정리', () => {
134
+ beforeEach(async () => {
135
+ await batchScheduler.start(db);
136
+ });
137
+
138
+ it('should execute memory cleanup with correct parameters', async () => {
139
+ const result = await batchScheduler.runJob('cleanup');
140
+ expect(result.success).toBe(true);
141
+ expect(mockForgettingService.executeMemoryCleanup).toHaveBeenCalledWith(db);
142
+ });
143
+
144
+ it('should handle cleanup errors gracefully', async () => {
145
+ mockForgettingService.executeMemoryCleanup.mockRejectedValueOnce(new Error('Cleanup failed'));
146
+ const result = await batchScheduler.runJob('cleanup');
147
+ expect(result.success).toBe(false);
148
+ expect(result.errors).toContain('Cleanup failed');
149
+ });
150
+ });
151
+
152
+ describe('성능 모니터링', () => {
153
+ beforeEach(async () => {
154
+ await batchScheduler.start(db);
155
+ });
156
+
157
+ it('should collect performance metrics', async () => {
158
+ const result = await batchScheduler.runJob('monitoring');
159
+ expect(mockPerformanceMonitor.collectMetrics).toHaveBeenCalled();
160
+ expect(result.success).toBe(true);
161
+ });
162
+
163
+ it('should handle monitoring errors gracefully', async () => {
164
+ mockPerformanceMonitor.collectMetrics.mockRejectedValueOnce(new Error('Monitoring failed'));
165
+ const result = await batchScheduler.runJob('monitoring');
166
+ expect(result.success).toBe(false);
167
+ expect(result.errors).toContain('Monitoring failed');
168
+ });
169
+ });
170
+
171
+ describe('중지', () => {
172
+ it('should stop all jobs', async () => {
173
+ await batchScheduler.start(db);
174
+ batchScheduler.stop();
175
+
176
+ const status = batchScheduler.getStatus();
177
+ expect(status.isRunning).toBe(false);
178
+ expect(status.activeJobs).toEqual([]);
179
+ });
180
+
181
+ it('should handle multiple stop calls gracefully', async () => {
182
+ await batchScheduler.start(db);
183
+ batchScheduler.stop();
184
+ batchScheduler.stop(); // Should not throw
185
+
186
+ const status = batchScheduler.getStatus();
187
+ expect(status.isRunning).toBe(false);
188
+ });
189
+
190
+ it('should stop when not running', () => {
191
+ expect(() => batchScheduler.stop()).not.toThrow();
192
+ });
193
+ });
194
+
195
+ describe('데이터베이스 통계', () => {
196
+ beforeEach(async () => {
197
+ await batchScheduler.start(db);
198
+
199
+ // Add some test data
200
+ db.prepare(`
201
+ INSERT INTO memory_item (id, type, content, importance, created_at, pinned)
202
+ VALUES
203
+ ('test1', 'episodic', 'Test memory 1', 0.5, datetime('now'), FALSE),
204
+ ('test2', 'semantic', 'Test memory 2', 0.7, datetime('now', '-35 days'), TRUE),
205
+ ('test3', 'working', 'Test memory 3', 0.3, datetime('now', '-1 day'), FALSE)
206
+ `).run();
207
+ });
208
+
209
+ it('should collect database statistics', async () => {
210
+ const result = await batchScheduler.runJob('monitoring');
211
+ expect(result.success).toBe(true);
212
+ expect(result.details?.stats).toBeDefined();
213
+ });
214
+
215
+ it('should collect memory statistics by type', async () => {
216
+ const result = await batchScheduler.runJob('monitoring');
217
+ const stats = result.details?.stats;
218
+
219
+ expect(stats.memoryStats).toBeDefined();
220
+ expect(Array.isArray(stats.memoryStats)).toBe(true);
221
+
222
+ const episodicStats = stats.memoryStats.find((s: any) => s.type === 'episodic');
223
+ expect(episodicStats).toBeDefined();
224
+ expect(episodicStats.count).toBe(1);
225
+ expect(episodicStats.pinned_count).toBe(0);
226
+ });
227
+
228
+ it('should calculate total memories count', async () => {
229
+ const result = await batchScheduler.runJob('monitoring');
230
+ const stats = result.details?.stats;
231
+
232
+ expect(stats.totalMemories).toBe(3);
233
+ });
234
+
235
+ it('should estimate database size', async () => {
236
+ const result = await batchScheduler.runJob('monitoring');
237
+ const stats = result.details?.stats;
238
+
239
+ expect(stats.estimatedSize).toBeGreaterThan(0);
240
+ expect(typeof stats.estimatedSize).toBe('number');
241
+ });
242
+
243
+ it('should handle empty database gracefully', async () => {
244
+ // Clear database
245
+ db.prepare('DELETE FROM memory_item').run();
246
+
247
+ const result = await batchScheduler.runJob('monitoring');
248
+ const stats = result.details?.stats;
249
+
250
+ expect(stats.totalMemories).toBe(0);
251
+ expect(stats.memoryStats).toEqual([]);
252
+ });
253
+ });
254
+
255
+ describe('메트릭 수집', () => {
256
+ beforeEach(async () => {
257
+ await batchScheduler.start(db);
258
+ });
259
+
260
+ it('should collect basic metrics', async () => {
261
+ const result = await batchScheduler.runJob('monitoring');
262
+ const metrics = result.details?.metrics;
263
+
264
+ expect(metrics).toBeDefined();
265
+ expect(metrics.memory).toBeDefined();
266
+ expect(metrics.cpu).toBeDefined();
267
+ expect(metrics.uptime).toBeDefined();
268
+
269
+ expect(metrics.memory).toHaveProperty('rss');
270
+ expect(metrics.memory).toHaveProperty('heapTotal');
271
+ expect(metrics.memory).toHaveProperty('heapUsed');
272
+ expect(metrics.memory).toHaveProperty('external');
273
+
274
+ expect(metrics.cpu).toHaveProperty('user');
275
+ expect(metrics.cpu).toHaveProperty('system');
276
+
277
+ expect(typeof metrics.uptime).toBe('number');
278
+ expect(metrics.uptime).toBeGreaterThan(0);
279
+ });
280
+
281
+ it('should collect memory usage metrics', async () => {
282
+ const result = await batchScheduler.runJob('monitoring');
283
+ const metrics = result.details?.metrics;
284
+
285
+ expect(metrics.memory.rss).toBeGreaterThan(0);
286
+ expect(metrics.memory.heapTotal).toBeGreaterThan(0);
287
+ expect(metrics.memory.heapUsed).toBeGreaterThan(0);
288
+ expect(metrics.memory.heapUsed).toBeLessThanOrEqual(metrics.memory.heapTotal);
289
+ });
290
+
291
+ it('should collect CPU usage metrics', async () => {
292
+ const result = await batchScheduler.runJob('monitoring');
293
+ const metrics = result.details?.metrics;
294
+
295
+ expect(typeof metrics.cpu.user).toBe('number');
296
+ expect(typeof metrics.cpu.system).toBe('number');
297
+ expect(metrics.cpu.user).toBeGreaterThanOrEqual(0);
298
+ expect(metrics.cpu.system).toBeGreaterThanOrEqual(0);
299
+ });
300
+
301
+ it('should collect uptime metrics', async () => {
302
+ const result = await batchScheduler.runJob('monitoring');
303
+ const metrics = result.details?.metrics;
304
+
305
+ expect(metrics.uptime).toBeGreaterThan(0);
306
+ expect(typeof metrics.uptime).toBe('number');
307
+ });
308
+ });
309
+
310
+ describe('설정 관리', () => {
311
+ it('should create scheduler with custom config', () => {
312
+ const customConfig = {
313
+ cleanupInterval: 2000,
314
+ monitoringInterval: 1000,
315
+ maxBatchSize: 500,
316
+ enableLogging: false,
317
+ enableNotifications: true
318
+ };
319
+
320
+ const customScheduler = new BatchScheduler(customConfig);
321
+ expect(customScheduler).toBeDefined();
322
+ });
323
+
324
+ it('should use default config when none provided', () => {
325
+ const defaultScheduler = new BatchScheduler();
326
+ expect(defaultScheduler).toBeDefined();
327
+ });
328
+ });
329
+
330
+ describe('에러 처리', () => {
331
+ it('should handle database connection failure', async () => {
332
+ const nullDb = null as any;
333
+
334
+ const result = await batchScheduler.runJob('cleanup');
335
+ expect(result.success).toBe(false);
336
+ expect(result.errors).toContain('Database not initialized');
337
+ });
338
+
339
+ it('should handle forgetting service errors', async () => {
340
+ mockForgettingService.executeMemoryCleanup.mockRejectedValueOnce(
341
+ new Error('Database connection lost')
342
+ );
343
+
344
+ const result = await batchScheduler.runJob('cleanup');
345
+ expect(result.success).toBe(false);
346
+ expect(result.errors).toContain('Database connection lost');
347
+ });
348
+
349
+ it('should handle performance monitor errors', async () => {
350
+ mockPerformanceMonitor.collectMetrics.mockRejectedValueOnce(
351
+ new Error('Memory allocation failed')
352
+ );
353
+
354
+ const result = await batchScheduler.runJob('monitoring');
355
+ expect(result.success).toBe(false);
356
+ expect(result.errors).toContain('Memory allocation failed');
357
+ });
358
+
359
+ it('should continue running after job errors', async () => {
360
+ await batchScheduler.start(db);
361
+
362
+ // First job fails
363
+ mockForgettingService.executeMemoryCleanup.mockRejectedValueOnce(
364
+ new Error('Temporary failure')
365
+ );
366
+
367
+ const result1 = await batchScheduler.runJob('cleanup');
368
+ expect(result1.success).toBe(false);
369
+
370
+ // Second job should still work
371
+ mockForgettingService.executeMemoryCleanup.mockResolvedValueOnce({
372
+ softDeleted: [],
373
+ hardDeleted: [],
374
+ reviewed: []
375
+ });
376
+
377
+ const result2 = await batchScheduler.runJob('cleanup');
378
+ expect(result2.success).toBe(true);
379
+ });
380
+ });
381
+
382
+ describe('작업 스케줄링', () => {
383
+ it('should schedule jobs with correct intervals', async () => {
384
+ const customScheduler = new BatchScheduler({
385
+ cleanupInterval: 100,
386
+ monitoringInterval: 50,
387
+ enableLogging: false
388
+ });
389
+
390
+ await customScheduler.start(db);
391
+
392
+ const status = customScheduler.getStatus();
393
+ expect(status.isRunning).toBe(true);
394
+ expect(status.activeJobs).toContain('cleanup');
395
+ expect(status.activeJobs).toContain('monitoring');
396
+
397
+ customScheduler.stop();
398
+ });
399
+
400
+ it('should handle job execution errors gracefully', async () => {
401
+ await batchScheduler.start(db);
402
+
403
+ // Mock job to throw error
404
+ const originalRunJob = batchScheduler.runJob;
405
+ batchScheduler.runJob = vi.fn().mockRejectedValue(new Error('Job execution failed'));
406
+
407
+ // Should throw the expected error (비동기 함수이므로 await와 rejects 사용)
408
+ await expect(batchScheduler.runJob('cleanup')).rejects.toThrow('Job execution failed');
409
+
410
+ // Restore original method
411
+ batchScheduler.runJob = originalRunJob;
412
+ });
413
+ });
414
+
415
+ describe('로깅', () => {
416
+ it('should log when logging enabled', async () => {
417
+ const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
418
+
419
+ const loggingScheduler = new BatchScheduler({
420
+ enableLogging: true,
421
+ cleanupInterval: 100,
422
+ monitoringInterval: 50
423
+ });
424
+
425
+ await loggingScheduler.start(db);
426
+ await new Promise(resolve => setTimeout(resolve, 150)); // Wait for jobs to run
427
+
428
+ expect(consoleSpy).toHaveBeenCalled();
429
+
430
+ loggingScheduler.stop();
431
+ consoleSpy.mockRestore();
432
+ });
433
+
434
+ it('should not log when logging disabled', async () => {
435
+ const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
436
+
437
+ const noLoggingScheduler = new BatchScheduler({
438
+ enableLogging: false,
439
+ cleanupInterval: 100,
440
+ monitoringInterval: 50
441
+ });
442
+
443
+ await noLoggingScheduler.start(db);
444
+ await new Promise(resolve => setTimeout(resolve, 150)); // Wait for jobs to run
445
+
446
+ // Should not log anything
447
+ expect(consoleSpy).not.toHaveBeenCalled();
448
+
449
+ noLoggingScheduler.stop();
450
+ consoleSpy.mockRestore();
451
+ });
452
+ });
453
+ });