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,369 @@
1
+ /**
2
+ * 데이터베이스 성능 최적화 서비스
3
+ * 인덱스 최적화, 쿼리 분석, 성능 튜닝
4
+ */
5
+ import { DatabaseUtils } from '../utils/database.js';
6
+ import Database from 'better-sqlite3';
7
+ export class DatabaseOptimizer {
8
+ db;
9
+ queryHistory = new Map();
10
+ constructor(db) {
11
+ this.db = db;
12
+ }
13
+ /**
14
+ * 데이터베이스 성능 분석
15
+ */
16
+ async analyzePerformance() {
17
+ const tableStats = await this.analyzeTables();
18
+ const indexStats = await this.analyzeIndexes();
19
+ const queryStats = await this.analyzeQueries();
20
+ return {
21
+ tableStats,
22
+ indexStats,
23
+ queryStats
24
+ };
25
+ }
26
+ /**
27
+ * 테이블 분석
28
+ */
29
+ async analyzeTables() {
30
+ const tables = await DatabaseUtils.all(this.db, `
31
+ SELECT name FROM sqlite_master
32
+ WHERE type = 'table' AND name NOT LIKE 'sqlite_%'
33
+ `);
34
+ const stats = {};
35
+ for (const table of tables) {
36
+ const tableName = table.name;
37
+ // 행 수
38
+ const rowCount = await DatabaseUtils.all(this.db, `SELECT COUNT(*) as count FROM ${tableName}`);
39
+ // 테이블 크기 (간단한 추정)
40
+ const size = await DatabaseUtils.all(this.db, `
41
+ SELECT page_count * page_size as size
42
+ FROM pragma_page_count(), pragma_page_size()
43
+ `);
44
+ // 인덱스 수
45
+ const indexCount = await DatabaseUtils.all(this.db, `
46
+ SELECT COUNT(*) as count
47
+ FROM sqlite_master
48
+ WHERE type = 'index' AND tbl_name = '${tableName}' AND name NOT LIKE 'sqlite_%'
49
+ `);
50
+ stats[tableName] = {
51
+ rowCount: rowCount[0].count,
52
+ size: size[0].size,
53
+ indexCount: indexCount[0].count,
54
+ lastAnalyzed: new Date()
55
+ };
56
+ }
57
+ return stats;
58
+ }
59
+ /**
60
+ * 인덱스 분석
61
+ */
62
+ async analyzeIndexes() {
63
+ const indexes = await DatabaseUtils.all(this.db, `
64
+ SELECT name, tbl_name, sql
65
+ FROM sqlite_master
66
+ WHERE type = 'index' AND name NOT LIKE 'sqlite_%'
67
+ `);
68
+ const stats = {};
69
+ for (const index of indexes) {
70
+ // 인덱스 크기 (간단한 추정 - 인덱스는 테이블이 아니므로 페이지 정보를 직접 가져올 수 없음)
71
+ const size = await DatabaseUtils.all(this.db, `
72
+ SELECT page_count * page_size as size
73
+ FROM pragma_page_count(), pragma_page_size()
74
+ `);
75
+ // 컬럼 추출 (간단한 파싱)
76
+ const columns = this.extractColumnsFromIndexSQL(index.sql);
77
+ stats[index.name] = {
78
+ name: index.name,
79
+ table: index.tbl_name,
80
+ columns,
81
+ size: size[0].size, // 전체 데이터베이스 크기로 추정
82
+ usage: 0 // 실제로는 SQLite 통계에서 가져와야 함
83
+ };
84
+ }
85
+ return stats;
86
+ }
87
+ /**
88
+ * 쿼리 분석
89
+ */
90
+ async analyzeQueries() {
91
+ const totalQueries = Array.from(this.queryHistory.values())
92
+ .reduce((sum, q) => sum + q.count, 0);
93
+ const averageTime = Array.from(this.queryHistory.values())
94
+ .reduce((sum, q) => sum + q.totalTime, 0) / totalQueries || 0;
95
+ const slowQueries = Array.from(this.queryHistory.entries())
96
+ .map(([query, stats]) => ({
97
+ query,
98
+ executionTime: stats.totalTime / stats.count,
99
+ explainPlan: [], // 실제로는 EXPLAIN QUERY PLAN 실행
100
+ recommendations: this.generateQueryRecommendations(query),
101
+ complexity: this.assessQueryComplexity(query)
102
+ }))
103
+ .filter(q => q.executionTime > 50) // 50ms 이상
104
+ .sort((a, b) => b.executionTime - a.executionTime)
105
+ .slice(0, 10);
106
+ return {
107
+ totalQueries,
108
+ averageTime,
109
+ slowQueries
110
+ };
111
+ }
112
+ /**
113
+ * 인덱스 추천 생성
114
+ */
115
+ async generateIndexRecommendations() {
116
+ const recommendations = [];
117
+ // 자주 사용되는 쿼리 패턴 분석
118
+ const commonPatterns = this.analyzeQueryPatterns();
119
+ for (const pattern of commonPatterns) {
120
+ if (pattern.type === 'filter' && pattern.frequency > 10) {
121
+ recommendations.push({
122
+ table: pattern.table,
123
+ columns: pattern.columns,
124
+ type: 'btree',
125
+ priority: pattern.frequency > 50 ? 'high' : 'medium',
126
+ reason: `자주 사용되는 필터 조건 (${pattern.frequency}회)`,
127
+ estimatedImprovement: '50-80% 쿼리 성능 향상 예상'
128
+ });
129
+ }
130
+ }
131
+ // 복합 쿼리 최적화
132
+ const complexQueries = Array.from(this.queryHistory.entries())
133
+ .filter(([, stats]) => stats.totalTime > 1000)
134
+ .map(([query]) => query);
135
+ for (const query of complexQueries) {
136
+ const tableMatch = query.match(/FROM\s+(\w+)/i);
137
+ if (!tableMatch || !tableMatch[1])
138
+ continue;
139
+ const tableName = tableMatch[1];
140
+ const columns = this.extractColumnsFromQuery(query);
141
+ if (columns.length > 1) {
142
+ recommendations.push({
143
+ table: tableName,
144
+ columns,
145
+ type: 'btree',
146
+ priority: 'high',
147
+ reason: '복합 쿼리 최적화',
148
+ estimatedImprovement: '30-60% 쿼리 성능 향상 예상'
149
+ });
150
+ }
151
+ }
152
+ return recommendations;
153
+ }
154
+ /**
155
+ * 쿼리 패턴 분석
156
+ */
157
+ analyzeQueryPatterns() {
158
+ const patterns = [];
159
+ for (const [query, stats] of this.queryHistory) {
160
+ // 쿼리에서 테이블명 추출
161
+ const tableMatch = query.match(/FROM\s+(\w+)/i);
162
+ if (!tableMatch || !tableMatch[1])
163
+ continue;
164
+ const tableName = tableMatch[1];
165
+ if (query.includes('WHERE')) {
166
+ const whereClause = query.match(/WHERE\s+(.+?)(?:\s+ORDER|\s+GROUP|\s+LIMIT|$)/i);
167
+ if (whereClause && whereClause[1]) {
168
+ const conditions = whereClause[1].split('AND').map(c => c.trim());
169
+ for (const condition of conditions) {
170
+ const column = this.extractColumnFromCondition(condition);
171
+ if (column) {
172
+ const existing = patterns.find(p => p.table === tableName && p.columns.includes(column));
173
+ if (existing) {
174
+ existing.frequency += stats.count;
175
+ }
176
+ else {
177
+ patterns.push({
178
+ type: 'filter',
179
+ table: tableName,
180
+ columns: [column],
181
+ frequency: stats.count
182
+ });
183
+ }
184
+ }
185
+ }
186
+ }
187
+ }
188
+ }
189
+ return patterns;
190
+ }
191
+ /**
192
+ * 쿼리 추천 생성
193
+ */
194
+ generateQueryRecommendations(query) {
195
+ const recommendations = [];
196
+ // SELECT * 사용 검사
197
+ if (query.includes('SELECT *')) {
198
+ recommendations.push('SELECT * 대신 필요한 컬럼만 명시하세요');
199
+ }
200
+ // 인덱스 힌트 검사
201
+ if (query.includes('ORDER BY') && !query.includes('INDEXED BY')) {
202
+ recommendations.push('ORDER BY 절에 인덱스 힌트를 추가하세요');
203
+ }
204
+ // LIKE 패턴 검사
205
+ if (query.includes('LIKE \'%')) {
206
+ recommendations.push('LIKE \'%...\' 패턴은 인덱스를 사용할 수 없습니다. FTS5를 고려하세요');
207
+ }
208
+ // 서브쿼리 검사
209
+ if (query.includes('SELECT') && (query.match(/SELECT/g) || []).length > 1) {
210
+ recommendations.push('서브쿼리를 JOIN으로 변경하는 것을 고려하세요');
211
+ }
212
+ return recommendations;
213
+ }
214
+ /**
215
+ * 쿼리 복잡도 평가
216
+ */
217
+ assessQueryComplexity(query) {
218
+ let complexity = 0;
219
+ if (query.includes('JOIN'))
220
+ complexity += 2;
221
+ if (query.includes('GROUP BY'))
222
+ complexity += 1;
223
+ if (query.includes('ORDER BY'))
224
+ complexity += 1;
225
+ if (query.includes('HAVING'))
226
+ complexity += 1;
227
+ if (query.includes('UNION'))
228
+ complexity += 2;
229
+ if (query.includes('SELECT') && (query.match(/SELECT/g) || []).length > 1)
230
+ complexity += 2;
231
+ if (complexity <= 1)
232
+ return 'simple';
233
+ if (complexity <= 3)
234
+ return 'medium';
235
+ return 'complex';
236
+ }
237
+ /**
238
+ * 쿼리 실행 통계 기록
239
+ */
240
+ recordQuery(query, executionTime) {
241
+ const existing = this.queryHistory.get(query);
242
+ if (existing) {
243
+ existing.count++;
244
+ existing.totalTime += executionTime;
245
+ existing.lastUsed = new Date();
246
+ }
247
+ else {
248
+ this.queryHistory.set(query, {
249
+ count: 1,
250
+ totalTime: executionTime,
251
+ lastUsed: new Date()
252
+ });
253
+ }
254
+ }
255
+ /**
256
+ * 인덱스 생성
257
+ */
258
+ async createIndex(name, table, columns, unique = false) {
259
+ const uniqueKeyword = unique ? 'UNIQUE' : '';
260
+ const columnsStr = columns.join(', ');
261
+ const sql = `CREATE ${uniqueKeyword} INDEX IF NOT EXISTS ${name} ON ${table} (${columnsStr})`;
262
+ await DatabaseUtils.run(this.db, sql);
263
+ }
264
+ /**
265
+ * 인덱스 삭제
266
+ */
267
+ async dropIndex(name) {
268
+ await DatabaseUtils.run(this.db, `DROP INDEX IF EXISTS ${name}`);
269
+ }
270
+ /**
271
+ * 데이터베이스 분석 실행
272
+ */
273
+ async analyzeDatabase() {
274
+ await DatabaseUtils.run(this.db, 'ANALYZE');
275
+ }
276
+ /**
277
+ * 쿼리에서 컬럼 추출
278
+ */
279
+ extractColumnsFromQuery(query) {
280
+ const columns = [];
281
+ // WHERE 절에서 컬럼 추출
282
+ const whereMatch = query.match(/WHERE\s+(.+?)(?:\s+ORDER|\s+GROUP|\s+LIMIT|$)/i);
283
+ if (whereMatch && whereMatch[1]) {
284
+ const conditions = whereMatch[1].split(/AND|OR/).map(c => c.trim());
285
+ for (const condition of conditions) {
286
+ const column = this.extractColumnFromCondition(condition);
287
+ if (column)
288
+ columns.push(column);
289
+ }
290
+ }
291
+ // ORDER BY 절에서 컬럼 추출
292
+ const orderMatch = query.match(/ORDER BY\s+(.+?)(?:\s+LIMIT|$)/i);
293
+ if (orderMatch && orderMatch[1]) {
294
+ const orderColumns = orderMatch[1].split(',').map(c => c.trim().split(' ')[0]).filter((c) => Boolean(c));
295
+ columns.push(...orderColumns);
296
+ }
297
+ return [...new Set(columns)]; // 중복 제거
298
+ }
299
+ /**
300
+ * 조건에서 컬럼 추출
301
+ */
302
+ extractColumnFromCondition(condition) {
303
+ const match = condition.match(/(\w+)\s*[=<>!]/);
304
+ return match && match[1] ? match[1] : null;
305
+ }
306
+ /**
307
+ * 인덱스 SQL에서 컬럼 추출
308
+ */
309
+ extractColumnsFromIndexSQL(sql) {
310
+ const match = sql.match(/\((.+?)\)/);
311
+ if (match && match[1]) {
312
+ return match[1].split(',').map(c => c.trim());
313
+ }
314
+ return [];
315
+ }
316
+ /**
317
+ * 성능 최적화 리포트 생성
318
+ */
319
+ async generateOptimizationReport() {
320
+ const stats = await this.analyzePerformance();
321
+ const recommendations = await this.generateIndexRecommendations();
322
+ const report = `
323
+ # 데이터베이스 성능 최적화 리포트
324
+ 생성 시간: ${new Date().toISOString()}
325
+
326
+ ## 테이블 통계
327
+ ${Object.entries(stats.tableStats)
328
+ .map(([table, stat]) => `
329
+ ### ${table}
330
+ - 행 수: ${stat.rowCount.toLocaleString()}
331
+ - 크기: ${(stat.size / 1024 / 1024).toFixed(2)} MB
332
+ - 인덱스 수: ${stat.indexCount}개
333
+ `).join('')}
334
+
335
+ ## 인덱스 통계
336
+ ${Object.entries(stats.indexStats)
337
+ .map(([name, stat]) => `
338
+ ### ${name}
339
+ - 테이블: ${stat.table}
340
+ - 컬럼: ${stat.columns.join(', ')}
341
+ - 크기: ${(stat.size / 1024).toFixed(2)} KB
342
+ `).join('')}
343
+
344
+ ## 쿼리 성능
345
+ - 총 쿼리: ${stats.queryStats.totalQueries}회
346
+ - 평균 실행 시간: ${stats.queryStats.averageTime.toFixed(2)}ms
347
+
348
+ ## 느린 쿼리 (상위 5개)
349
+ ${stats.queryStats.slowQueries.slice(0, 5)
350
+ .map((q, i) => `
351
+ ${i + 1}. **${q.complexity.toUpperCase()}** (${q.executionTime.toFixed(2)}ms)
352
+ \`\`\`sql
353
+ ${q.query}
354
+ \`\`\`
355
+ **추천사항:**
356
+ ${q.recommendations.map(r => `- ${r}`).join('\n ')}
357
+ `).join('')}
358
+
359
+ ## 인덱스 추천
360
+ ${recommendations.map((rec, i) => `
361
+ ${i + 1}. **${rec.priority.toUpperCase()}** - ${rec.table}.${rec.columns.join(', ')}
362
+ - 이유: ${rec.reason}
363
+ - 예상 개선: ${rec.estimatedImprovement}
364
+ `).join('')}
365
+ `;
366
+ return report;
367
+ }
368
+ }
369
+ //# sourceMappingURL=database-optimizer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"database-optimizer.js","sourceRoot":"","sources":["../../src/services/database-optimizer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * 임베딩 제공자 팩토리
3
+ * 전략 패턴을 사용하여 순환 의존성 방지
4
+ *
5
+ * 클린코드 원칙:
6
+ * - 단일 책임 원칙: 제공자 생성만 담당
7
+ * - 의존성 역전: 인터페이스에 의존
8
+ * - 개방-폐쇄: 새로운 제공자 추가 용이
9
+ */
10
+ import type { EmbeddingServiceInterface, EmbeddingProvider, ProviderInfo } from '../types/embedding.types.js';
11
+ /**
12
+ * 임베딩 제공자 팩토리
13
+ * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
14
+ */
15
+ export declare class EmbeddingProviderFactory {
16
+ private static instance;
17
+ private providers;
18
+ private constructor();
19
+ /**
20
+ * 싱글톤 인스턴스 반환
21
+ */
22
+ static getInstance(): EmbeddingProviderFactory;
23
+ /**
24
+ * 제공자 초기화
25
+ * 클린코드: 단일 책임 원칙 - 초기화만 담당
26
+ */
27
+ private initializeProviders;
28
+ /**
29
+ * 제공자 반환
30
+ * 클린코드: 단일 책임 원칙 - 제공자 반환만 담당
31
+ */
32
+ getProvider(provider: EmbeddingProvider): EmbeddingServiceInterface | null;
33
+ /**
34
+ * 사용 가능한 제공자 목록 반환
35
+ * TDD: 각 제공자의 사용 가능 여부 확인
36
+ */
37
+ getAvailableProviders(): ProviderInfo[];
38
+ /**
39
+ * 우선순위에 따른 제공자 선택
40
+ * TDD: 사용 가능한 제공자 중 우선순위가 높은 것 선택
41
+ */
42
+ selectProvider(preferredProvider?: EmbeddingProvider): EmbeddingServiceInterface | null;
43
+ /**
44
+ * OpenAI 사용 가능 여부 확인
45
+ * 클린코드: 단일 책임 원칙 - OpenAI 상태 확인만 담당
46
+ */
47
+ private isOpenAIAvailable;
48
+ /**
49
+ * 제공자 등록 (확장성)
50
+ * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
51
+ */
52
+ registerProvider(provider: EmbeddingProvider, service: EmbeddingServiceInterface): void;
53
+ /**
54
+ * 제공자 제거
55
+ */
56
+ unregisterProvider(provider: EmbeddingProvider): boolean;
57
+ /**
58
+ * 모든 제공자 초기화
59
+ */
60
+ reset(): void;
61
+ }
62
+ //# sourceMappingURL=embedding-provider-factory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"embedding-provider-factory.d.ts","sourceRoot":"","sources":["../../src/services/embedding-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM9G;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAgE;IAEjF,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAI1E;;;OAGG;IACH,qBAAqB,IAAI,YAAY,EAAE;IA6CvC;;;OAGG;IACH,cAAc,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IA+BvF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAIvF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAIxD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
@@ -0,0 +1,152 @@
1
+ /**
2
+ * 임베딩 제공자 팩토리
3
+ * 전략 패턴을 사용하여 순환 의존성 방지
4
+ *
5
+ * 클린코드 원칙:
6
+ * - 단일 책임 원칙: 제공자 생성만 담당
7
+ * - 의존성 역전: 인터페이스에 의존
8
+ * - 개방-폐쇄: 새로운 제공자 추가 용이
9
+ */
10
+ import { mementoConfig } from '../config/index.js';
11
+ import { MiniLMEmbeddingService } from './minilm-embedding-service.js';
12
+ import { LightweightEmbeddingService } from './lightweight-embedding-service.js';
13
+ import { GeminiEmbeddingService } from './gemini-embedding-service.js';
14
+ /**
15
+ * 임베딩 제공자 팩토리
16
+ * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
17
+ */
18
+ export class EmbeddingProviderFactory {
19
+ static instance;
20
+ providers = new Map();
21
+ constructor() {
22
+ this.initializeProviders();
23
+ }
24
+ /**
25
+ * 싱글톤 인스턴스 반환
26
+ */
27
+ static getInstance() {
28
+ if (!EmbeddingProviderFactory.instance) {
29
+ EmbeddingProviderFactory.instance = new EmbeddingProviderFactory();
30
+ }
31
+ return EmbeddingProviderFactory.instance;
32
+ }
33
+ /**
34
+ * 제공자 초기화
35
+ * 클린코드: 단일 책임 원칙 - 초기화만 담당
36
+ */
37
+ initializeProviders() {
38
+ this.providers.set('minilm', new MiniLMEmbeddingService());
39
+ this.providers.set('tfidf', new LightweightEmbeddingService());
40
+ this.providers.set('gemini', new GeminiEmbeddingService());
41
+ // OpenAI는 설정에 따라 동적 생성
42
+ }
43
+ /**
44
+ * 제공자 반환
45
+ * 클린코드: 단일 책임 원칙 - 제공자 반환만 담당
46
+ */
47
+ getProvider(provider) {
48
+ return this.providers.get(provider) || null;
49
+ }
50
+ /**
51
+ * 사용 가능한 제공자 목록 반환
52
+ * TDD: 각 제공자의 사용 가능 여부 확인
53
+ */
54
+ getAvailableProviders() {
55
+ const providerInfos = [];
56
+ // MiniLM
57
+ const minilm = this.providers.get('minilm');
58
+ providerInfos.push({
59
+ name: 'minilm',
60
+ available: minilm?.isAvailable() || false,
61
+ priority: 1,
62
+ cost: 'free',
63
+ performance: 'high'
64
+ });
65
+ // TF-IDF (항상 사용 가능)
66
+ const tfidf = this.providers.get('tfidf');
67
+ providerInfos.push({
68
+ name: 'tfidf',
69
+ available: tfidf?.isAvailable() || false,
70
+ priority: 4,
71
+ cost: 'free',
72
+ performance: 'low'
73
+ });
74
+ // Gemini
75
+ const gemini = this.providers.get('gemini');
76
+ providerInfos.push({
77
+ name: 'gemini',
78
+ available: gemini?.isAvailable() || false,
79
+ priority: 2,
80
+ cost: 'paid',
81
+ performance: 'high'
82
+ });
83
+ // OpenAI (동적 생성)
84
+ providerInfos.push({
85
+ name: 'openai',
86
+ available: this.isOpenAIAvailable(),
87
+ priority: 3,
88
+ cost: 'paid',
89
+ performance: 'high'
90
+ });
91
+ return providerInfos.sort((a, b) => a.priority - b.priority);
92
+ }
93
+ /**
94
+ * 우선순위에 따른 제공자 선택
95
+ * TDD: 사용 가능한 제공자 중 우선순위가 높은 것 선택
96
+ */
97
+ selectProvider(preferredProvider) {
98
+ const availableProviders = this.getAvailableProviders();
99
+ // 1. 명시적으로 요청된 제공자 우선
100
+ if (preferredProvider) {
101
+ const preferred = availableProviders.find(p => p.name === preferredProvider && p.available);
102
+ if (preferred) {
103
+ console.log(`🎯 요청된 제공자 사용: ${preferredProvider}`);
104
+ return this.getProvider(preferred.name);
105
+ }
106
+ }
107
+ // 2. 설정에서 기본 제공자 사용
108
+ const defaultProvider = mementoConfig.embeddingProvider;
109
+ const defaultAvailable = availableProviders.find(p => p.name === defaultProvider && p.available);
110
+ if (defaultAvailable) {
111
+ console.log(`⚙️ 설정된 기본 제공자 사용: ${defaultProvider}`);
112
+ return this.getProvider(defaultAvailable.name);
113
+ }
114
+ // 3. 사용 가능한 첫 번째 제공자 반환
115
+ const firstAvailable = availableProviders.find(p => p.available);
116
+ if (firstAvailable) {
117
+ console.log(`🔄 사용 가능한 첫 번째 제공자 사용: ${firstAvailable.name}`);
118
+ return this.getProvider(firstAvailable.name);
119
+ }
120
+ console.log('❌ 사용 가능한 제공자가 없습니다');
121
+ return null;
122
+ }
123
+ /**
124
+ * OpenAI 사용 가능 여부 확인
125
+ * 클린코드: 단일 책임 원칙 - OpenAI 상태 확인만 담당
126
+ */
127
+ isOpenAIAvailable() {
128
+ // 환경 변수나 설정 확인
129
+ return process.env.OPENAI_API_KEY !== undefined;
130
+ }
131
+ /**
132
+ * 제공자 등록 (확장성)
133
+ * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
134
+ */
135
+ registerProvider(provider, service) {
136
+ this.providers.set(provider, service);
137
+ }
138
+ /**
139
+ * 제공자 제거
140
+ */
141
+ unregisterProvider(provider) {
142
+ return this.providers.delete(provider);
143
+ }
144
+ /**
145
+ * 모든 제공자 초기화
146
+ */
147
+ reset() {
148
+ this.providers.clear();
149
+ this.initializeProviders();
150
+ }
151
+ }
152
+ //# sourceMappingURL=embedding-provider-factory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"embedding-provider-factory.js","sourceRoot":"","sources":["../../src/services/embedding-provider-factory.ts"],"names":[],"mappings":"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"}