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,162 @@
1
+ /**
2
+ * 망각 정책 기능 테스트
3
+ * 망각 알고리즘과 간격 반복 테스트
4
+ */
5
+
6
+ import { createMementoClient } from '../client/index.js';
7
+
8
+ async function testForgettingFunctionality() {
9
+ console.log('🧠 망각 정책 기능 테스트 시작');
10
+
11
+ const client = createMementoClient();
12
+
13
+ try {
14
+ // 1. 서버 연결
15
+ console.log('\n1️⃣ 서버 연결 중...');
16
+ await client.connect();
17
+
18
+ // 2. 다양한 기억 저장 (망각 테스트용)
19
+ console.log('\n2️⃣ 망각 테스트용 기억 저장');
20
+ const memories = [
21
+ {
22
+ content: "오래된 작업 기억: 프로젝트 초기 설정 작업을 완료했습니다.",
23
+ type: 'working' as const,
24
+ tags: ['old', 'setup', 'completed'],
25
+ importance: 0.3, // 낮은 중요도
26
+ source: 'test'
27
+ },
28
+ {
29
+ content: "중요한 에피소드 기억: 사용자가 중요한 질문을 했고, 상세히 답변했습니다.",
30
+ type: 'episodic' as const,
31
+ tags: ['important', 'user', 'question'],
32
+ importance: 0.9, // 높은 중요도
33
+ source: 'test'
34
+ },
35
+ {
36
+ content: "최근 학습 내용: 새로운 기술 스택에 대해 학습했습니다.",
37
+ type: 'semantic' as const,
38
+ tags: ['learning', 'technology', 'recent'],
39
+ importance: 0.7,
40
+ source: 'test'
41
+ },
42
+ {
43
+ content: "오래된 프로시저: 특정 작업을 수행하는 방법을 기록했습니다.",
44
+ type: 'procedural' as const,
45
+ tags: ['procedure', 'old', 'method'],
46
+ importance: 0.4, // 중간 중요도
47
+ source: 'test'
48
+ },
49
+ {
50
+ content: "중복된 내용: 이미 저장된 내용과 유사한 정보입니다.",
51
+ type: 'episodic' as const,
52
+ tags: ['duplicate', 'similar'],
53
+ importance: 0.2, // 낮은 중요도
54
+ source: 'test'
55
+ }
56
+ ];
57
+
58
+ const memoryIds: string[] = [];
59
+ for (const memory of memories) {
60
+ const id = await client.remember(memory);
61
+ memoryIds.push(id);
62
+ console.log(`✅ 저장됨: ${id.substring(0, 20)}... - ${memory.content.substring(0, 40)}...`);
63
+
64
+ // 시간 간격을 두고 저장 (망각 알고리즘 테스트용)
65
+ await new Promise(resolve => setTimeout(resolve, 500));
66
+ }
67
+
68
+ // 3. 망각 통계 조회
69
+ console.log('\n3️⃣ 망각 통계 조회');
70
+ try {
71
+ const stats = await client.callTool('forgetting_stats', {});
72
+ console.log('📊 망각 통계:');
73
+ console.log(` 총 메모리: ${stats.stats?.totalMemories || 0}개`);
74
+ console.log(` 망각 후보: ${stats.stats?.forgetCandidates || 0}개`);
75
+ console.log(` 리뷰 후보: ${stats.stats?.reviewCandidates || 0}개`);
76
+ console.log(` 평균 망각 점수: ${stats.stats?.averageForgetScore?.toFixed(3) || 'N/A'}`);
77
+ console.log(` 메모리 분포:`, stats.stats?.memoryDistribution || {});
78
+ } catch (error) {
79
+ console.error(` ❌ 망각 통계 조회 실패: ${error}`);
80
+ }
81
+
82
+ // 4. 드라이런 모드로 메모리 정리 테스트
83
+ console.log('\n4️⃣ 드라이런 모드 메모리 정리 테스트');
84
+ try {
85
+ const dryRunResult = await client.callTool('cleanup_memory', { dry_run: true });
86
+ console.log('🔍 드라이런 분석 결과:');
87
+ console.log(` 모드: ${dryRunResult.mode}`);
88
+ console.log(` 총 메모리: ${dryRunResult.stats?.totalMemories || 0}개`);
89
+ console.log(` 망각 후보: ${dryRunResult.stats?.forgetCandidates || 0}개`);
90
+ console.log(` 리뷰 후보: ${dryRunResult.stats?.reviewCandidates || 0}개`);
91
+ console.log(` 평균 망각 점수: ${dryRunResult.stats?.averageForgetScore?.toFixed(3) || 'N/A'}`);
92
+ console.log(` 메모리 분포:`, dryRunResult.stats?.memoryDistribution || {});
93
+ } catch (error) {
94
+ console.error(` ❌ 드라이런 테스트 실패: ${error}`);
95
+ }
96
+
97
+ // 5. 실제 메모리 정리 실행 (선택적)
98
+ console.log('\n5️⃣ 실제 메모리 정리 실행');
99
+ try {
100
+ const cleanupResult = await client.callTool('cleanup_memory', { dry_run: false });
101
+ console.log('🧹 메모리 정리 결과:');
102
+ console.log(` 모드: ${cleanupResult.mode}`);
103
+ console.log(` 소프트 삭제: ${cleanupResult.result?.summary?.actualSoftDeletes || 0}개`);
104
+ console.log(` 하드 삭제: ${cleanupResult.result?.summary?.actualHardDeletes || 0}개`);
105
+ console.log(` 리뷰 처리: ${cleanupResult.result?.summary?.actualReviews || 0}개`);
106
+ console.log(` 총 처리: ${cleanupResult.result?.totalProcessed || 0}개`);
107
+
108
+ if (cleanupResult.result?.softDeleted?.length > 0) {
109
+ console.log(` 소프트 삭제된 메모리: ${cleanupResult.result.softDeleted.join(', ')}`);
110
+ }
111
+ if (cleanupResult.result?.hardDeleted?.length > 0) {
112
+ console.log(` 하드 삭제된 메모리: ${cleanupResult.result.hardDeleted.join(', ')}`);
113
+ }
114
+ } catch (error) {
115
+ console.error(` ❌ 메모리 정리 실행 실패: ${error}`);
116
+ }
117
+
118
+ // 6. 정리 후 상태 확인
119
+ console.log('\n6️⃣ 정리 후 상태 확인');
120
+ try {
121
+ const finalStats = await client.callTool('forgetting_stats', {});
122
+ console.log('📊 정리 후 망각 통계:');
123
+ console.log(` 총 메모리: ${finalStats.stats?.totalMemories || 0}개`);
124
+ console.log(` 망각 후보: ${finalStats.stats?.forgetCandidates || 0}개`);
125
+ console.log(` 평균 망각 점수: ${finalStats.stats?.averageForgetScore?.toFixed(3) || 'N/A'}`);
126
+ } catch (error) {
127
+ console.error(` ❌ 정리 후 통계 조회 실패: ${error}`);
128
+ }
129
+
130
+ // 7. 남은 메모리 검색 테스트
131
+ console.log('\n7️⃣ 남은 메모리 검색 테스트');
132
+ try {
133
+ const searchResults = await client.recall({ query: "기억", limit: 10 });
134
+ console.log(`🔍 검색 결과: ${searchResults.length}개`);
135
+ searchResults.forEach((result, index) => {
136
+ console.log(` ${index + 1}. [${result.type}] ${result.content.substring(0, 50)}...`);
137
+ });
138
+ } catch (error) {
139
+ console.error(` ❌ 검색 테스트 실패: ${error}`);
140
+ }
141
+
142
+ console.log('\n🎉 망각 정책 기능 테스트 완료!');
143
+
144
+ } catch (error) {
145
+ console.error('❌ 테스트 실패:', error);
146
+ } finally {
147
+ await client.disconnect();
148
+ }
149
+ }
150
+
151
+ // 테스트 실행
152
+ if (process.argv[1] && process.argv[1].endsWith('test-forgetting.ts')) {
153
+ testForgettingFunctionality()
154
+ .then(() => {
155
+ console.log('✅ 망각 테스트 완료');
156
+ process.exit(0);
157
+ })
158
+ .catch((error) => {
159
+ console.error('❌ 망각 테스트 실패:', error);
160
+ process.exit(1);
161
+ });
162
+ }
@@ -0,0 +1,159 @@
1
+ /**
2
+ * Gemini 임베딩 서비스 테스트
3
+ * Gemini API를 사용한 임베딩 생성 및 검색 기능 테스트
4
+ */
5
+
6
+ import { GeminiEmbeddingService } from '../services/gemini-embedding-service.js';
7
+ import { EmbeddingService } from '../services/embedding-service.js';
8
+ import { mementoConfig } from '../config/index.js';
9
+
10
+ async function testGeminiEmbeddingService() {
11
+ console.log('🧪 Gemini 임베딩 서비스 테스트 시작\n');
12
+
13
+ // 1. Gemini 임베딩 서비스 직접 테스트
14
+ console.log('1️⃣ Gemini 임베딩 서비스 직접 테스트');
15
+ const geminiService = new GeminiEmbeddingService();
16
+
17
+ console.log(` - 서비스 사용 가능: ${geminiService.isAvailable()}`);
18
+ console.log(` - 모델 정보:`, geminiService.getModelInfo());
19
+
20
+ if (geminiService.isAvailable()) {
21
+ try {
22
+ const testText = '안녕하세요! 이것은 Gemini 임베딩 테스트입니다.';
23
+ console.log(` - 테스트 텍스트: "${testText}"`);
24
+
25
+ const startTime = Date.now();
26
+ const result = await geminiService.generateEmbedding(testText);
27
+ const endTime = Date.now();
28
+
29
+ if (result) {
30
+ console.log(` ✅ 임베딩 생성 성공 (${endTime - startTime}ms)`);
31
+ console.log(` - 모델: ${result.model}`);
32
+ console.log(` - 차원: ${result.embedding.length}`);
33
+ console.log(` - 토큰 사용량: ${result.usage.total_tokens}`);
34
+ console.log(` - 임베딩 샘플: [${result.embedding.slice(0, 5).map(x => x.toFixed(4)).join(', ')}...]`);
35
+ } else {
36
+ console.log(' ❌ 임베딩 생성 실패');
37
+ }
38
+ } catch (error) {
39
+ console.log(` ❌ Gemini 임베딩 테스트 실패:`, error);
40
+ }
41
+ } else {
42
+ console.log(' ⚠️ Gemini 서비스가 사용 불가능합니다 (API 키 확인 필요)');
43
+ }
44
+
45
+ console.log('\n' + '='.repeat(60) + '\n');
46
+
47
+ // 2. 통합 임베딩 서비스 테스트 (Gemini 제공자)
48
+ console.log('2️⃣ 통합 임베딩 서비스 테스트 (Gemini 제공자)');
49
+ console.log(` - 현재 임베딩 제공자: ${mementoConfig.embeddingProvider}`);
50
+
51
+ const embeddingService = new EmbeddingService();
52
+ console.log(` - 서비스 사용 가능: ${embeddingService.isAvailable()}`);
53
+ console.log(` - 모델 정보:`, embeddingService.getModelInfo());
54
+
55
+ if (embeddingService.isAvailable()) {
56
+ try {
57
+ const testTexts = [
58
+ 'React와 TypeScript를 사용한 웹 개발',
59
+ 'Node.js 백엔드 API 서버 구축',
60
+ 'SQLite 데이터베이스 설계 및 최적화',
61
+ 'MCP 프로토콜을 활용한 AI 에이전트 개발',
62
+ '머신러닝과 자연어 처리 기술'
63
+ ];
64
+
65
+ console.log(' - 여러 텍스트 임베딩 생성 테스트:');
66
+
67
+ for (let i = 0; i < testTexts.length; i++) {
68
+ const text = testTexts[i];
69
+ const startTime = Date.now();
70
+ const result = await embeddingService.generateEmbedding(text!);
71
+ const endTime = Date.now();
72
+
73
+ if (result) {
74
+ console.log(` ${i + 1}. "${text}"`);
75
+ console.log(` ✅ 성공 (${endTime - startTime}ms, ${result.embedding.length}차원)`);
76
+ } else {
77
+ console.log(` ${i + 1}. "${text}"`);
78
+ console.log(` ❌ 실패`);
79
+ }
80
+ }
81
+
82
+ // 3. 유사도 검색 테스트
83
+ console.log('\n - 유사도 검색 테스트:');
84
+ const query = '웹 개발 프레임워크';
85
+ console.log(` 쿼리: "${query}"`);
86
+
87
+ const embeddings = [];
88
+ for (let i = 0; i < testTexts.length; i++) {
89
+ const result = await embeddingService.generateEmbedding(testTexts[i]!);
90
+ if (result) {
91
+ embeddings.push({
92
+ id: `test-${i + 1}`,
93
+ content: testTexts[i]!,
94
+ embedding: result.embedding
95
+ });
96
+ }
97
+ }
98
+
99
+ if (embeddings.length > 0) {
100
+ const similarities = await embeddingService.searchSimilar(
101
+ query,
102
+ embeddings,
103
+ 3, // 상위 3개
104
+ 0.5 // 임계값 0.5
105
+ );
106
+
107
+ console.log(` 검색 결과 (${similarities.length}개):`);
108
+ similarities.forEach((item, index) => {
109
+ console.log(` ${index + 1}. "${item.content}" (유사도: ${item.similarity.toFixed(4)})`);
110
+ });
111
+ }
112
+
113
+ } catch (error) {
114
+ console.log(` ❌ 통합 임베딩 서비스 테스트 실패:`, error);
115
+ }
116
+ } else {
117
+ console.log(' ⚠️ 통합 임베딩 서비스가 사용 불가능합니다');
118
+ }
119
+
120
+ console.log('\n' + '='.repeat(60) + '\n');
121
+
122
+ // 4. 성능 테스트
123
+ console.log('3️⃣ 성능 테스트');
124
+
125
+ if (embeddingService.isAvailable()) {
126
+ const performanceTexts = [
127
+ '짧은 텍스트',
128
+ '이것은 좀 더 긴 텍스트입니다. 여러 문장으로 구성되어 있고, 다양한 단어들이 포함되어 있습니다.',
129
+ '매우 긴 텍스트입니다. ' + '반복되는 내용입니다. '.repeat(50) + '끝입니다.'
130
+ ];
131
+
132
+ for (const text of performanceTexts) {
133
+ console.log(` - 텍스트 길이: ${text.length}자`);
134
+
135
+ const times = [];
136
+ for (let i = 0; i < 3; i++) {
137
+ const startTime = Date.now();
138
+ await embeddingService.generateEmbedding(text);
139
+ const endTime = Date.now();
140
+ times.push(endTime - startTime);
141
+ }
142
+
143
+ const avgTime = times.reduce((a, b) => a + b, 0) / times.length;
144
+ const minTime = Math.min(...times);
145
+ const maxTime = Math.max(...times);
146
+
147
+ console.log(` 평균: ${avgTime.toFixed(2)}ms, 최소: ${minTime}ms, 최대: ${maxTime}ms`);
148
+ }
149
+ }
150
+
151
+ console.log('\n🎉 Gemini 임베딩 서비스 테스트 완료!');
152
+ }
153
+
154
+ // 테스트 실행
155
+ if (import.meta.url === `file://${process.argv[1]}`) {
156
+ testGeminiEmbeddingService().catch(console.error);
157
+ }
158
+
159
+ export { testGeminiEmbeddingService };
@@ -0,0 +1,147 @@
1
+ /**
2
+ * HTTP 서버 v2 간단한 테스트
3
+ */
4
+
5
+ import { startServer, cleanup, __test } from '../server/http-server.js';
6
+ import { initializeDatabase, closeDatabase } from '../database/init.js';
7
+ import { SearchEngine } from '../algorithms/search-engine.js';
8
+ import { HybridSearchEngine } from '../algorithms/hybrid-search-engine.js';
9
+ import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
10
+ import Database from 'better-sqlite3';
11
+
12
+ async function testBasicFunctionality() {
13
+ console.log('🧪 HTTP 서버 v2 간단한 테스트 시작');
14
+
15
+ let testDb: Database.Database | null = null;
16
+ let serverStarted = false;
17
+
18
+ try {
19
+ // 1. 테스트 데이터베이스 설정
20
+ console.log('🗄️ 테스트 데이터베이스 설정 중...');
21
+ testDb = new Database(':memory:'); // 메모리 데이터베이스 사용
22
+
23
+ // 기본 스키마 생성
24
+ testDb.exec(`
25
+ CREATE TABLE memory_item (
26
+ id TEXT PRIMARY KEY,
27
+ type TEXT CHECK (type IN ('working','episodic','semantic','procedural')),
28
+ content TEXT NOT NULL,
29
+ importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
30
+ privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
31
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
32
+ last_accessed TIMESTAMP,
33
+ pinned BOOLEAN DEFAULT FALSE,
34
+ source TEXT,
35
+ agent_id TEXT,
36
+ user_id TEXT,
37
+ project_id TEXT,
38
+ origin_trace TEXT,
39
+ tags TEXT
40
+ );
41
+ `);
42
+
43
+ // 2. 서버 의존성 설정
44
+ const searchEngine = new SearchEngine();
45
+ const hybridSearchEngine = new HybridSearchEngine();
46
+ const embeddingService = new MemoryEmbeddingService();
47
+
48
+ __test.setTestDependencies({
49
+ database: testDb,
50
+ searchEngine,
51
+ hybridSearchEngine,
52
+ embeddingService
53
+ });
54
+
55
+ // 3. 서버 시작
56
+ console.log('🚀 HTTP 서버 v2 시작 중...');
57
+ await startServer();
58
+ serverStarted = true;
59
+
60
+ // 서버 시작 대기
61
+ console.log('⏳ 서버 시작 대기 중...');
62
+ await new Promise(resolve => setTimeout(resolve, 2000));
63
+
64
+ // 4. 기본 테스트
65
+ console.log('📋 헬스 체크 테스트...');
66
+ const healthResponse = await fetch('http://localhost:9001/health');
67
+ const healthData = await healthResponse.json();
68
+
69
+ if (healthResponse.ok && healthData.status === 'healthy') {
70
+ console.log('✅ 헬스 체크 성공');
71
+ } else {
72
+ throw new Error('헬스 체크 실패');
73
+ }
74
+
75
+ // 5. 도구 목록 테스트
76
+ console.log('📋 도구 목록 테스트...');
77
+ const toolsResponse = await fetch('http://localhost:9001/tools');
78
+ const toolsData = await toolsResponse.json();
79
+
80
+ if (toolsResponse.ok && toolsData.tools && toolsData.tools.length === 5) {
81
+ console.log(`✅ 도구 목록 성공 (${toolsData.tools.length}개 도구)`);
82
+ } else {
83
+ throw new Error('도구 목록 조회 실패');
84
+ }
85
+
86
+ // 6. remember 도구 테스트
87
+ console.log('📝 remember 도구 테스트...');
88
+ const rememberResponse = await fetch('http://localhost:9001/tools/remember', {
89
+ method: 'POST',
90
+ headers: { 'Content-Type': 'application/json' },
91
+ body: JSON.stringify({
92
+ content: 'HTTP 서버 v2 간단한 테스트를 위한 기억입니다.',
93
+ type: 'episodic',
94
+ importance: 0.8
95
+ })
96
+ });
97
+
98
+ const rememberData = await rememberResponse.json();
99
+ if (rememberResponse.ok && rememberData.result && rememberData.result.memory_id) {
100
+ console.log(`✅ remember 성공: ${rememberData.result.memory_id}`);
101
+ } else {
102
+ throw new Error('remember 테스트 실패');
103
+ }
104
+
105
+ // 7. recall 도구 테스트
106
+ console.log('🔍 recall 도구 테스트...');
107
+ const recallResponse = await fetch('http://localhost:9001/tools/recall', {
108
+ method: 'POST',
109
+ headers: { 'Content-Type': 'application/json' },
110
+ body: JSON.stringify({
111
+ query: 'HTTP 서버 v2',
112
+ limit: 5
113
+ })
114
+ });
115
+
116
+ const recallData = await recallResponse.json();
117
+ if (recallResponse.ok && recallData.result && recallData.result.items) {
118
+ console.log(`✅ recall 성공: ${recallData.result.items.length}개 결과`);
119
+ } else {
120
+ throw new Error('recall 테스트 실패');
121
+ }
122
+
123
+ console.log('\n🎉 모든 기본 테스트 통과!');
124
+
125
+ } catch (error) {
126
+ console.error('\n❌ 테스트 실패:', error);
127
+ throw error;
128
+ } finally {
129
+ // 정리
130
+ if (serverStarted) {
131
+ console.log('\n🧹 서버 정리 중...');
132
+ await cleanup();
133
+ }
134
+
135
+ if (testDb) {
136
+ console.log('🗄️ 테스트 데이터베이스 정리 중...');
137
+ closeDatabase(testDb);
138
+ }
139
+
140
+ console.log('✅ 테스트 완료');
141
+ }
142
+ }
143
+
144
+ // 테스트 실행
145
+ testBasicFunctionality().catch(console.error);
146
+
147
+ export { testBasicFunctionality };