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,177 @@
1
+ /**
2
+ * μ„±λŠ₯ λͺ¨λ‹ˆν„°λ§ 톡합 μ„œλΉ„μŠ€
3
+ * κΈ°μ‘΄ μ„±λŠ₯ λͺ¨λ‹ˆν„°μ™€ μ•Œλ¦Ό μ„œλΉ„μŠ€λ₯Ό ν†΅ν•©ν•˜μ—¬ μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§ 제곡
4
+ */
5
+ import { PerformanceMonitor } from './performance-monitor.js';
6
+ import { PerformanceAlertService, AlertType, AlertLevel } from './performance-alert-service.js';
7
+ import Database from 'better-sqlite3';
8
+ export class PerformanceMonitoringIntegration {
9
+ performanceMonitor;
10
+ alertService;
11
+ config;
12
+ monitoringInterval = null;
13
+ isMonitoring = false;
14
+ constructor(db, alertService, config) {
15
+ this.performanceMonitor = new PerformanceMonitor();
16
+ this.performanceMonitor.initialize(db);
17
+ this.alertService = alertService;
18
+ this.config = config;
19
+ }
20
+ /**
21
+ * μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§ μ‹œμž‘
22
+ */
23
+ startRealTimeMonitoring() {
24
+ if (this.isMonitoring) {
25
+ console.warn('⚠️ μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§μ΄ 이미 μ‹€ν–‰ μ€‘μž…λ‹ˆλ‹€');
26
+ return;
27
+ }
28
+ if (!this.config.enableRealTimeMonitoring) {
29
+ console.log('ℹ️ μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§μ΄ λΉ„ν™œμ„±ν™”λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€');
30
+ return;
31
+ }
32
+ this.isMonitoring = true;
33
+ console.log('πŸš€ μ‹€μ‹œκ°„ μ„±λŠ₯ λͺ¨λ‹ˆν„°λ§ μ‹œμž‘');
34
+ this.monitoringInterval = setInterval(async () => {
35
+ await this.performMonitoringCycle();
36
+ }, this.config.monitoringInterval);
37
+ }
38
+ /**
39
+ * μ‹€μ‹œκ°„ λͺ¨λ‹ˆν„°λ§ 쀑지
40
+ */
41
+ stopRealTimeMonitoring() {
42
+ if (this.monitoringInterval) {
43
+ clearInterval(this.monitoringInterval);
44
+ this.monitoringInterval = null;
45
+ }
46
+ this.isMonitoring = false;
47
+ console.log('πŸ›‘ μ‹€μ‹œκ°„ μ„±λŠ₯ λͺ¨λ‹ˆν„°λ§ 쀑지');
48
+ }
49
+ /**
50
+ * λͺ¨λ‹ˆν„°λ§ 사이클 μ‹€ν–‰
51
+ */
52
+ async performMonitoringCycle() {
53
+ try {
54
+ const metrics = await this.performanceMonitor.collectMetrics();
55
+ // μ‘λ‹΅μ‹œκ°„ 체크
56
+ if (metrics.search.averageSearchTime > 0) {
57
+ this.alertService.checkPerformanceMetric(AlertType.RESPONSE_TIME, metrics.search.averageSearchTime, {
58
+ component: 'search_engine',
59
+ operation: 'search',
60
+ totalSearches: metrics.search.totalSearches
61
+ });
62
+ }
63
+ // λ©”λͺ¨λ¦¬ μ‚¬μš©λŸ‰ 체크
64
+ const memoryUsageMB = metrics.memory.heapUsed / 1024 / 1024;
65
+ this.alertService.checkPerformanceMetric(AlertType.MEMORY_USAGE, memoryUsageMB, {
66
+ component: 'memory_manager',
67
+ heapTotal: metrics.memory.heapTotal,
68
+ rss: metrics.memory.rss
69
+ });
70
+ // μ—λŸ¬μœ¨ 체크 (κ°„μ ‘μ μœΌλ‘œ)
71
+ const errorRate = this.calculateErrorRate(metrics);
72
+ if (errorRate > 0) {
73
+ this.alertService.checkPerformanceMetric(AlertType.ERROR_RATE, errorRate, {
74
+ component: 'system',
75
+ totalOperations: metrics.database.totalMemories + metrics.search.totalSearches
76
+ });
77
+ }
78
+ // μ²˜λ¦¬λŸ‰ 체크
79
+ const throughput = this.calculateThroughput(metrics);
80
+ if (throughput > 0) {
81
+ this.alertService.checkPerformanceMetric(AlertType.THROUGHPUT, throughput, {
82
+ component: 'system',
83
+ totalOperations: metrics.database.totalMemories + metrics.search.totalSearches
84
+ });
85
+ }
86
+ // λ°μ΄ν„°λ² μ΄μŠ€ μ„±λŠ₯ 체크
87
+ if (metrics.database.queryPerformance.averageQueryTime > 0) {
88
+ this.alertService.checkPerformanceMetric(AlertType.DATABASE_PERFORMANCE, metrics.database.queryPerformance.averageQueryTime, {
89
+ component: 'database',
90
+ operation: 'query',
91
+ totalMemories: metrics.database.totalMemories
92
+ });
93
+ }
94
+ // μΊμ‹œ μ„±λŠ₯ 체크
95
+ if (metrics.search.cacheHitRate > 0) {
96
+ this.alertService.checkPerformanceMetric(AlertType.CACHE_PERFORMANCE, metrics.search.cacheHitRate * 100, // λ°±λΆ„μœ¨λ‘œ λ³€ν™˜
97
+ {
98
+ component: 'cache',
99
+ operation: 'search',
100
+ totalSearches: metrics.search.totalSearches
101
+ });
102
+ }
103
+ }
104
+ catch (error) {
105
+ console.error('❌ λͺ¨λ‹ˆν„°λ§ 사이클 μ‹€ν–‰ 쀑 였λ₯˜:', error);
106
+ }
107
+ }
108
+ /**
109
+ * μ—λŸ¬μœ¨ 계산 (간접적)
110
+ */
111
+ calculateErrorRate(metrics) {
112
+ // μ‹€μ œ μ—λŸ¬μœ¨ 계산 둜직 (ν˜„μž¬λŠ” κ°„λ‹¨ν•œ μΆ”μ •)
113
+ const totalOperations = metrics.database.totalMemories + metrics.search.totalSearches;
114
+ if (totalOperations === 0)
115
+ return 0;
116
+ // 느린 쿼리 λΉ„μœ¨μ„ μ—λŸ¬μœ¨λ‘œ κ°„μ ‘ μΆ”μ •
117
+ const slowQueries = metrics.database.queryPerformance.slowQueries.length;
118
+ return (slowQueries / totalOperations) * 100;
119
+ }
120
+ /**
121
+ * μ²˜λ¦¬λŸ‰ 계산
122
+ */
123
+ calculateThroughput(metrics) {
124
+ const totalOperations = metrics.database.totalMemories + metrics.search.totalSearches;
125
+ const uptimeSeconds = metrics.system.uptime / 1000;
126
+ if (uptimeSeconds === 0)
127
+ return 0;
128
+ return totalOperations / uptimeSeconds; // ops/sec
129
+ }
130
+ /**
131
+ * μˆ˜λ™ μ„±λŠ₯ 체크
132
+ */
133
+ async performManualCheck() {
134
+ console.log('πŸ” μˆ˜λ™ μ„±λŠ₯ 체크 μ‹€ν–‰');
135
+ await this.performMonitoringCycle();
136
+ }
137
+ /**
138
+ * μ•Œλ¦Ό μž„κ³„κ°’ μ—…λ°μ΄νŠΈ
139
+ */
140
+ updateAlertThresholds(thresholds) {
141
+ if (thresholds.responseTime) {
142
+ this.alertService.updateThreshold(AlertType.RESPONSE_TIME, AlertLevel.WARNING, { threshold: thresholds.responseTime.warning, operator: 'gt' });
143
+ this.alertService.updateThreshold(AlertType.RESPONSE_TIME, AlertLevel.CRITICAL, { threshold: thresholds.responseTime.critical, operator: 'gt' });
144
+ }
145
+ if (thresholds.memoryUsage) {
146
+ this.alertService.updateThreshold(AlertType.MEMORY_USAGE, AlertLevel.WARNING, { threshold: thresholds.memoryUsage.warning, operator: 'gt' });
147
+ this.alertService.updateThreshold(AlertType.MEMORY_USAGE, AlertLevel.CRITICAL, { threshold: thresholds.memoryUsage.critical, operator: 'gt' });
148
+ }
149
+ if (thresholds.errorRate) {
150
+ this.alertService.updateThreshold(AlertType.ERROR_RATE, AlertLevel.WARNING, { threshold: thresholds.errorRate.warning, operator: 'gt' });
151
+ this.alertService.updateThreshold(AlertType.ERROR_RATE, AlertLevel.CRITICAL, { threshold: thresholds.errorRate.critical, operator: 'gt' });
152
+ }
153
+ if (thresholds.throughput) {
154
+ this.alertService.updateThreshold(AlertType.THROUGHPUT, AlertLevel.WARNING, { threshold: thresholds.throughput.warning, operator: 'lt' });
155
+ this.alertService.updateThreshold(AlertType.THROUGHPUT, AlertLevel.CRITICAL, { threshold: thresholds.throughput.critical, operator: 'lt' });
156
+ }
157
+ console.log('βœ… μ•Œλ¦Ό μž„κ³„κ°’ μ—…λ°μ΄νŠΈ μ™„λ£Œ');
158
+ }
159
+ /**
160
+ * λͺ¨λ‹ˆν„°λ§ μƒνƒœ 확인
161
+ */
162
+ getMonitoringStatus() {
163
+ return {
164
+ isMonitoring: this.isMonitoring,
165
+ config: this.config,
166
+ alertService: this.alertService
167
+ };
168
+ }
169
+ /**
170
+ * μ„œλΉ„μŠ€ 정리
171
+ */
172
+ cleanup() {
173
+ this.stopRealTimeMonitoring();
174
+ this.alertService.cleanup();
175
+ }
176
+ }
177
+ //# sourceMappingURL=performance-monitoring-integration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"performance-monitoring-integration.js","sourceRoot":"","sources":["../../src/services/performance-monitoring-integration.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * 톡합 μž„λ² λ”© μ„œλΉ„μŠ€
3
+ * 4κ°€μ§€ μž„λ² λ”© 제곡자 쀑 μ„ νƒν•˜μ—¬ μ‚¬μš©
4
+ *
5
+ * ν΄λ¦°μ½”λ“œ 원칙:
6
+ * - 단일 μ±…μž„ 원칙: μž„λ² λ”© μ„œλΉ„μŠ€ ν†΅ν•©λ§Œ λ‹΄λ‹Ή
7
+ * - μ˜μ‘΄μ„± μ—­μ „: νŒ©ν† λ¦¬μ— 의쑴
8
+ * - μ „λž΅ νŒ¨ν„΄: 제곡자 선택 둜직 뢄리
9
+ */
10
+ import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData, EmbeddingProvider } from '../types/embedding.types.js';
11
+ /**
12
+ * 톡합 μž„λ² λ”© μ„œλΉ„μŠ€
13
+ * μˆœν™˜ μ˜μ‘΄μ„±μ„ λ°©μ§€ν•˜κΈ° μœ„ν•΄ νŒ©ν† λ¦¬ νŒ¨ν„΄ μ‚¬μš©
14
+ */
15
+ export declare class UnifiedEmbeddingService implements EmbeddingServiceInterface {
16
+ private factory;
17
+ private currentProvider;
18
+ private fallbackProviders;
19
+ constructor();
20
+ /**
21
+ * ν…μŠ€νŠΈλ₯Ό μž„λ² λ”© λ²‘ν„°λ‘œ λ³€ν™˜
22
+ * TDD: 제곡자 선택, 폴백 처리, μ—λŸ¬ 핸듀링
23
+ */
24
+ generateEmbedding(text: string, preferredProvider?: EmbeddingProvider): Promise<EmbeddingResult | null>;
25
+ /**
26
+ * 쿼리와 μœ μ‚¬ν•œ μž„λ² λ”© 검색
27
+ * TDD: 제곡자 선택, 폴백 처리
28
+ */
29
+ searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number, preferredProvider?: EmbeddingProvider): Promise<SimilarityResult[]>;
30
+ /**
31
+ * μ„œλΉ„μŠ€ μ‚¬μš© κ°€λŠ₯ μ—¬λΆ€ 확인
32
+ * TDD: μ΅œμ†Œ ν•˜λ‚˜μ˜ μ œκ³΅μžλΌλ„ μ‚¬μš© κ°€λŠ₯ν•΄μ•Ό 함
33
+ */
34
+ isAvailable(): boolean;
35
+ /**
36
+ * ν˜„μž¬ μ‚¬μš© 쀑인 λͺ¨λΈ 정보 λ°˜ν™˜
37
+ */
38
+ getModelInfo(): {
39
+ model: string;
40
+ dimensions: number;
41
+ maxTokens: number;
42
+ };
43
+ /**
44
+ * μ‚¬μš© κ°€λŠ₯ν•œ 제곡자 λͺ©λ‘ λ°˜ν™˜
45
+ */
46
+ getAvailableProviders(): string[];
47
+ /**
48
+ * ν˜„μž¬ μ‚¬μš© 쀑인 제곡자 이름 λ°˜ν™˜
49
+ */
50
+ getCurrentProviderName(): string;
51
+ /**
52
+ * 폴백 제곡자 μ„€μ •
53
+ */
54
+ setFallbackProviders(providers: EmbeddingProvider[]): void;
55
+ /**
56
+ * μž…λ ₯ 검증
57
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - κ²€μ¦λ§Œ λ‹΄λ‹Ή
58
+ */
59
+ private validateInput;
60
+ /**
61
+ * 제곡자 선택
62
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - 선택 둜직만 λ‹΄λ‹Ή
63
+ */
64
+ private selectProvider;
65
+ /**
66
+ * 폴백 제곡자 μ‹œλ„
67
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - 폴백 처리만 λ‹΄λ‹Ή
68
+ */
69
+ private tryFallbackProviders;
70
+ /**
71
+ * 폴백 검색 μ‹œλ„
72
+ */
73
+ private tryFallbackSearch;
74
+ }
75
+ //# sourceMappingURL=unified-embedding-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unified-embedding-service.d.ts","sourceRoot":"","sources":["../../src/services/unified-embedding-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAGrC;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,yBAAyB;IACvE,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,iBAAiB,CAAgE;;IAQzF;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAmC7G;;;OAGG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,GAAE,MAAW,EAClB,SAAS,GAAE,MAAY,EACvB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAiC9B;;;OAGG;IACH,WAAW,IAAI,OAAO;IAKtB;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAaxE;;OAEG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAMjC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAsBhC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAI1D;;;OAGG;IACH,OAAO,CAAC,aAAa;IAMrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;YACW,oBAAoB;IAsBlC;;OAEG;YACW,iBAAiB;CAyBhC"}
@@ -0,0 +1,211 @@
1
+ /**
2
+ * 톡합 μž„λ² λ”© μ„œλΉ„μŠ€
3
+ * 4κ°€μ§€ μž„λ² λ”© 제곡자 쀑 μ„ νƒν•˜μ—¬ μ‚¬μš©
4
+ *
5
+ * ν΄λ¦°μ½”λ“œ 원칙:
6
+ * - 단일 μ±…μž„ 원칙: μž„λ² λ”© μ„œλΉ„μŠ€ ν†΅ν•©λ§Œ λ‹΄λ‹Ή
7
+ * - μ˜μ‘΄μ„± μ—­μ „: νŒ©ν† λ¦¬μ— 의쑴
8
+ * - μ „λž΅ νŒ¨ν„΄: 제곡자 선택 둜직 뢄리
9
+ */
10
+ import { EmbeddingProviderFactory } from './embedding-provider-factory.js';
11
+ /**
12
+ * 톡합 μž„λ² λ”© μ„œλΉ„μŠ€
13
+ * μˆœν™˜ μ˜μ‘΄μ„±μ„ λ°©μ§€ν•˜κΈ° μœ„ν•΄ νŒ©ν† λ¦¬ νŒ¨ν„΄ μ‚¬μš©
14
+ */
15
+ export class UnifiedEmbeddingService {
16
+ factory;
17
+ currentProvider = null;
18
+ fallbackProviders = ['minilm', 'openai', 'gemini', 'tfidf'];
19
+ constructor() {
20
+ this.factory = EmbeddingProviderFactory.getInstance();
21
+ console.log('βœ… 톡합 μž„λ² λ”© μ„œλΉ„μŠ€ μ΄ˆκΈ°ν™” μ™„λ£Œ');
22
+ console.log(`πŸ“‹ μ‚¬μš© κ°€λŠ₯ν•œ 제곡자: ${this.factory.getAvailableProviders().map(p => p.name).join(', ')}`);
23
+ }
24
+ /**
25
+ * ν…μŠ€νŠΈλ₯Ό μž„λ² λ”© λ²‘ν„°λ‘œ λ³€ν™˜
26
+ * TDD: 제곡자 선택, 폴백 처리, μ—λŸ¬ 핸듀링
27
+ */
28
+ async generateEmbedding(text, preferredProvider) {
29
+ this.validateInput(text);
30
+ try {
31
+ const provider = this.selectProvider(preferredProvider);
32
+ if (!provider) {
33
+ throw new Error('μ‚¬μš© κ°€λŠ₯ν•œ μž„λ² λ”© μ œκ³΅μžκ°€ μ—†μŠ΅λ‹ˆλ‹€');
34
+ }
35
+ this.currentProvider = provider;
36
+ const result = await provider.generateEmbedding(text);
37
+ if (result) {
38
+ // provider 정보 μΆ”κ°€
39
+ const providerName = this.getCurrentProviderName();
40
+ result.provider = providerName;
41
+ console.log(`βœ… μž„λ² λ”© 생성 μ™„λ£Œ (${providerName})`);
42
+ return result;
43
+ }
44
+ // 폴백 μ‹œλ„
45
+ return await this.tryFallbackProviders(text);
46
+ }
47
+ catch (error) {
48
+ console.error('❌ μž„λ² λ”© 생성 μ‹€νŒ¨:', error);
49
+ // 폴백 μ‹œλ„
50
+ try {
51
+ return await this.tryFallbackProviders(text);
52
+ }
53
+ catch (fallbackError) {
54
+ throw new Error(`λͺ¨λ“  μž„λ² λ”© 제곡자 μ‹€νŒ¨: ${error instanceof Error ? error.message : 'Unknown error'}`);
55
+ }
56
+ }
57
+ }
58
+ /**
59
+ * 쿼리와 μœ μ‚¬ν•œ μž„λ² λ”© 검색
60
+ * TDD: 제곡자 선택, 폴백 처리
61
+ */
62
+ async searchSimilar(query, embeddings, limit = 10, threshold = 0.7, preferredProvider) {
63
+ this.validateInput(query);
64
+ try {
65
+ const provider = this.selectProvider(preferredProvider);
66
+ if (!provider) {
67
+ throw new Error('μ‚¬μš© κ°€λŠ₯ν•œ μž„λ² λ”© μ œκ³΅μžκ°€ μ—†μŠ΅λ‹ˆλ‹€');
68
+ }
69
+ this.currentProvider = provider;
70
+ const results = await provider.searchSimilar(query, embeddings, limit, threshold);
71
+ if (results.length > 0) {
72
+ console.log(`βœ… μœ μ‚¬λ„ 검색 μ™„λ£Œ (${this.getCurrentProviderName()})`);
73
+ return results;
74
+ }
75
+ // 폴백 μ‹œλ„
76
+ return await this.tryFallbackSearch(query, embeddings, limit, threshold);
77
+ }
78
+ catch (error) {
79
+ console.error('❌ μœ μ‚¬λ„ 검색 μ‹€νŒ¨:', error);
80
+ // 폴백 μ‹œλ„
81
+ try {
82
+ return await this.tryFallbackSearch(query, embeddings, limit, threshold);
83
+ }
84
+ catch (fallbackError) {
85
+ console.warn('⚠️ λͺ¨λ“  제곡자 μ‹€νŒ¨, 빈 κ²°κ³Ό λ°˜ν™˜');
86
+ return [];
87
+ }
88
+ }
89
+ }
90
+ /**
91
+ * μ„œλΉ„μŠ€ μ‚¬μš© κ°€λŠ₯ μ—¬λΆ€ 확인
92
+ * TDD: μ΅œμ†Œ ν•˜λ‚˜μ˜ μ œκ³΅μžλΌλ„ μ‚¬μš© κ°€λŠ₯ν•΄μ•Ό 함
93
+ */
94
+ isAvailable() {
95
+ const availableProviders = this.factory.getAvailableProviders();
96
+ return availableProviders.some(p => p.available);
97
+ }
98
+ /**
99
+ * ν˜„μž¬ μ‚¬μš© 쀑인 λͺ¨λΈ 정보 λ°˜ν™˜
100
+ */
101
+ getModelInfo() {
102
+ if (this.currentProvider) {
103
+ return this.currentProvider.getModelInfo();
104
+ }
105
+ // κΈ°λ³Έκ°’ λ°˜ν™˜
106
+ return {
107
+ model: 'unified-embedding',
108
+ dimensions: 384,
109
+ maxTokens: 256
110
+ };
111
+ }
112
+ /**
113
+ * μ‚¬μš© κ°€λŠ₯ν•œ 제곡자 λͺ©λ‘ λ°˜ν™˜
114
+ */
115
+ getAvailableProviders() {
116
+ return this.factory.getAvailableProviders()
117
+ .filter(p => p.available)
118
+ .map(p => p.name);
119
+ }
120
+ /**
121
+ * ν˜„μž¬ μ‚¬μš© 쀑인 제곡자 이름 λ°˜ν™˜
122
+ */
123
+ getCurrentProviderName() {
124
+ if (!this.currentProvider) {
125
+ return 'none';
126
+ }
127
+ try {
128
+ const availableProviders = this.factory.getAvailableProviders();
129
+ if (!availableProviders) {
130
+ return 'unknown';
131
+ }
132
+ const current = availableProviders.find(p => this.factory.getProvider(p.name) === this.currentProvider);
133
+ return current?.name || 'unknown';
134
+ }
135
+ catch (error) {
136
+ console.error('❌ ν˜„μž¬ 제곡자 이름 쑰회 μ‹€νŒ¨:', error);
137
+ return 'unknown';
138
+ }
139
+ }
140
+ /**
141
+ * 폴백 제곡자 μ„€μ •
142
+ */
143
+ setFallbackProviders(providers) {
144
+ this.fallbackProviders = providers;
145
+ }
146
+ /**
147
+ * μž…λ ₯ 검증
148
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - κ²€μ¦λ§Œ λ‹΄λ‹Ή
149
+ */
150
+ validateInput(text) {
151
+ if (!text || text.trim().length === 0) {
152
+ throw new Error('ν…μŠ€νŠΈκ°€ λΉ„μ–΄μžˆμŠ΅λ‹ˆλ‹€');
153
+ }
154
+ }
155
+ /**
156
+ * 제곡자 선택
157
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - 선택 둜직만 λ‹΄λ‹Ή
158
+ */
159
+ selectProvider(preferredProvider) {
160
+ return this.factory.selectProvider(preferredProvider);
161
+ }
162
+ /**
163
+ * 폴백 제곡자 μ‹œλ„
164
+ * ν΄λ¦°μ½”λ“œ: 단일 μ±…μž„ 원칙 - 폴백 처리만 λ‹΄λ‹Ή
165
+ */
166
+ async tryFallbackProviders(text) {
167
+ for (const providerName of this.fallbackProviders) {
168
+ try {
169
+ const provider = this.factory.getProvider(providerName);
170
+ if (provider && provider.isAvailable()) {
171
+ console.log(`πŸ”„ 폴백 μ‹œλ„: ${providerName}`);
172
+ const result = await provider.generateEmbedding(text);
173
+ if (result) {
174
+ this.currentProvider = provider;
175
+ result.provider = providerName;
176
+ return result;
177
+ }
178
+ }
179
+ }
180
+ catch (error) {
181
+ console.warn(`⚠️ 폴백 제곡자 ${providerName} μ‹€νŒ¨:`, error);
182
+ continue;
183
+ }
184
+ }
185
+ throw new Error('λͺ¨λ“  폴백 제곡자 μ‹€νŒ¨');
186
+ }
187
+ /**
188
+ * 폴백 검색 μ‹œλ„
189
+ */
190
+ async tryFallbackSearch(query, embeddings, limit, threshold) {
191
+ for (const providerName of this.fallbackProviders) {
192
+ try {
193
+ const provider = this.factory.getProvider(providerName);
194
+ if (provider && provider.isAvailable()) {
195
+ console.log(`πŸ”„ 폴백 검색 μ‹œλ„: ${providerName}`);
196
+ const results = await provider.searchSimilar(query, embeddings, limit, threshold);
197
+ if (results.length > 0) {
198
+ this.currentProvider = provider;
199
+ return results;
200
+ }
201
+ }
202
+ }
203
+ catch (error) {
204
+ console.warn(`⚠️ 폴백 검색 제곡자 ${providerName} μ‹€νŒ¨:`, error);
205
+ continue;
206
+ }
207
+ }
208
+ return [];
209
+ }
210
+ }
211
+ //# sourceMappingURL=unified-embedding-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unified-embedding-service.js","sourceRoot":"","sources":["../../src/services/unified-embedding-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * HTTP μ„œλ²„ v2 디버그 ν…ŒμŠ€νŠΈ
3
+ */
4
+ declare function testFetch(): Promise<void>;
5
+ //# sourceMappingURL=debug-http-v2.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"debug-http-v2.d.ts","sourceRoot":"","sources":["../../src/test/debug-http-v2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,iBAAe,SAAS,kBAkBvB"}
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ /**
3
+ * HTTP μ„œλ²„ v2 디버그 ν…ŒμŠ€νŠΈ
4
+ */
5
+ console.log('πŸš€ HTTP μ„œλ²„ v2 디버그 ν…ŒμŠ€νŠΈ μ‹œμž‘');
6
+ async function testFetch() {
7
+ try {
8
+ console.log('πŸ“‘ HTTP μš”μ²­ ν…ŒμŠ€νŠΈ 쀑...');
9
+ const response = await fetch('http://localhost:9001/health');
10
+ console.log('πŸ“Š 응닡 μƒνƒœ:', response.status);
11
+ const data = await response.json();
12
+ console.log('πŸ“‹ 응닡 데이터:', data);
13
+ if (response.ok && data.status === 'healthy') {
14
+ console.log('βœ… HTTP μš”μ²­ 성곡');
15
+ }
16
+ else {
17
+ console.log('❌ HTTP μš”μ²­ μ‹€νŒ¨');
18
+ }
19
+ }
20
+ catch (error) {
21
+ console.error('❌ HTTP μš”μ²­ μ—λŸ¬:', error);
22
+ }
23
+ }
24
+ // ν…ŒμŠ€νŠΈ μ‹€ν–‰
25
+ testFetch().then(() => {
26
+ console.log('🏁 ν…ŒμŠ€νŠΈ μ™„λ£Œ');
27
+ }).catch(console.error);
28
+ //# sourceMappingURL=debug-http-v2.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"debug-http-v2.js","sourceRoot":"","sources":["../../src/test/debug-http-v2.ts"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAExC,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAEhC,IAAI,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS;AACT,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * μ„±λŠ₯ 벀치마크 ν…ŒμŠ€νŠΈ
3
+ * Memento MCP μ„œλ²„μ˜ μ„±λŠ₯ μΈ‘μ • 및 뢄석
4
+ */
5
+ export declare class PerformanceBenchmark {
6
+ private client;
7
+ private performanceMonitor;
8
+ private searchCache;
9
+ private taskQueue;
10
+ private results;
11
+ constructor();
12
+ /**
13
+ * 전체 벀치마크 μ‹€ν–‰
14
+ */
15
+ runFullBenchmark(): Promise<void>;
16
+ /**
17
+ * λ©”λͺ¨λ¦¬ μž‘μ—… 벀치마크
18
+ */
19
+ private benchmarkMemoryOperations;
20
+ /**
21
+ * 검색 μž‘μ—… 벀치마크
22
+ */
23
+ private benchmarkSearchOperations;
24
+ /**
25
+ * μΊμ‹œ μž‘μ—… 벀치마크
26
+ */
27
+ private benchmarkCacheOperations;
28
+ /**
29
+ * 비동기 μž‘μ—… 벀치마크 - μ΅œμ ν™”λœ 버전
30
+ */
31
+ private benchmarkAsyncOperations;
32
+ /**
33
+ * λ™μ‹œ μž‘μ—… 벀치마크 - 였λ₯˜ ν•΄κ²° 버전
34
+ */
35
+ private benchmarkConcurrentOperations;
36
+ /**
37
+ * μž‘μ—… μ™„λ£Œ λŒ€κΈ°
38
+ */
39
+ private waitForTaskCompletion;
40
+ /**
41
+ * μž¬μ‹œλ„ 둜직 - 였λ₯˜ 해결을 μœ„ν•œ 헬퍼 λ©”μ„œλ“œ
42
+ */
43
+ private retryOperation;
44
+ /**
45
+ * 벀치마크 κ²°κ³Ό 계산
46
+ */
47
+ private calculateBenchmarkResult;
48
+ /**
49
+ * κ²°κ³Ό 좜λ ₯
50
+ */
51
+ private printResult;
52
+ /**
53
+ * 전체 리포트 생성
54
+ */
55
+ private generateReport;
56
+ }
57
+ //# sourceMappingURL=performance-benchmark.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"performance-benchmark.d.ts","sourceRoot":"","sources":["../../src/test/performance-benchmark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAyB;;IAQxC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BvC;;OAEG;YACW,yBAAyB;IA0CvC;;OAEG;YACW,yBAAyB;IAsDvC;;OAEG;YACW,wBAAwB;IAqDtC;;OAEG;YACW,wBAAwB;IAsEtC;;OAEG;YACW,6BAA6B;IAmG3C;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,cAAc;IA4B5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4ChC;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,cAAc;CA6BvB"}