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,384 @@
1
+ /**
2
+ * 하이브리드 검색 엔진
3
+ * FTS5 텍스트 검색 + 벡터 검색 결합
4
+ */
5
+ import { SearchEngine } from './search-engine.js';
6
+ import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
7
+ import { EmbeddingService } from '../services/embedding-service.js';
8
+ import { getVectorSearchEngine } from './vector-search-engine.js';
9
+ export class HybridSearchEngine {
10
+ textSearchEngine;
11
+ embeddingService;
12
+ vectorSearchEngine;
13
+ defaultVectorWeight = 0.6; // 벡터 검색 60%
14
+ defaultTextWeight = 0.4; // 텍스트 검색 40%
15
+ searchStats = new Map();
16
+ adaptiveWeights = new Map();
17
+ constructor() {
18
+ this.textSearchEngine = new SearchEngine();
19
+ this.embeddingService = new MemoryEmbeddingService();
20
+ this.vectorSearchEngine = getVectorSearchEngine();
21
+ }
22
+ /**
23
+ * 하이브리드 검색 실행 - 적응형 가중치 적용
24
+ */
25
+ async search(db, query) {
26
+ const searchId = `search_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
27
+ const startTime = process.hrtime.bigint();
28
+ try {
29
+ this.logSearchStart(searchId, query);
30
+ const { query: searchQuery, filters, limit = 10, vectorWeight = this.defaultVectorWeight, textWeight = this.defaultTextWeight, } = query;
31
+ // 1. 적응형 가중치 계산
32
+ const adaptiveWeights = this.calculateAdaptiveWeights(searchQuery, vectorWeight, textWeight);
33
+ const normalizedVectorWeight = adaptiveWeights.vectorWeight;
34
+ const normalizedTextWeight = adaptiveWeights.textWeight;
35
+ this.logSearchStep(searchId, '적응형 가중치 계산 완료', {
36
+ vectorWeight: normalizedVectorWeight.toFixed(3),
37
+ textWeight: normalizedTextWeight.toFixed(3),
38
+ originalVector: vectorWeight,
39
+ originalText: textWeight
40
+ });
41
+ // 2. 텍스트 검색 실행
42
+ const textSearchStart = process.hrtime.bigint();
43
+ this.logSearchStep(searchId, '텍스트 검색 시작', { query: searchQuery });
44
+ const textSearchResult = await this.textSearchEngine.search(db, {
45
+ query: searchQuery,
46
+ filters,
47
+ limit: limit * 2, // 더 많은 후보를 가져와서 결합
48
+ });
49
+ const textSearchTime = Number(process.hrtime.bigint() - textSearchStart) / 1_000_000;
50
+ const textResults = textSearchResult.items;
51
+ this.logSearchStep(searchId, '텍스트 검색 완료', {
52
+ resultCount: textResults.length,
53
+ searchTime: `${textSearchTime.toFixed(2)}ms`
54
+ });
55
+ // 3. 벡터 검색 실행 (VEC 사용 가능한 경우)
56
+ let vectorResults = [];
57
+ const vectorSearchStart = process.hrtime.bigint();
58
+ this.logSearchStep(searchId, '벡터 검색 시작', {
59
+ query: searchQuery,
60
+ embeddingAvailable: this.embeddingService.isAvailable()
61
+ });
62
+ // VectorSearchEngine 초기화
63
+ this.vectorSearchEngine.initialize(db);
64
+ if (this.vectorSearchEngine.getIndexStatus().available) {
65
+ try {
66
+ // 쿼리를 벡터로 변환
67
+ const embeddingStart = process.hrtime.bigint();
68
+ const embeddingService = new EmbeddingService();
69
+ const embeddingResult = await embeddingService.generateEmbedding(searchQuery);
70
+ if (!embeddingResult) {
71
+ throw new Error('임베딩 생성에 실패했습니다');
72
+ }
73
+ const queryVector = embeddingResult.embedding;
74
+ const embeddingTime = Number(process.hrtime.bigint() - embeddingStart) / 1_000_000;
75
+ this.logSearchStep(searchId, '임베딩 생성 완료', {
76
+ embeddingTime: `${embeddingTime.toFixed(2)}ms`,
77
+ vectorLength: queryVector.length
78
+ });
79
+ // VEC를 사용한 벡터 검색
80
+ const vecStart = process.hrtime.bigint();
81
+ const vecResults = await this.vectorSearchEngine.search(queryVector, {
82
+ limit: limit * 2,
83
+ threshold: 0.5,
84
+ type: filters?.type?.join(','),
85
+ includeContent: true
86
+ });
87
+ const vecTime = Number(process.hrtime.bigint() - vecStart) / 1_000_000;
88
+ // VectorSearchResult 형식으로 변환
89
+ vectorResults = vecResults.map(result => ({
90
+ id: result.memory_id,
91
+ content: result.content,
92
+ type: result.type,
93
+ importance: result.importance,
94
+ created_at: result.created_at,
95
+ pinned: false,
96
+ score: result.similarity,
97
+ similarity: result.similarity
98
+ }));
99
+ this.logSearchStep(searchId, 'VEC 벡터 검색 완료', {
100
+ resultCount: vectorResults.length,
101
+ vecTime: `${vecTime.toFixed(2)}ms`,
102
+ totalVectorTime: `${(Number(process.hrtime.bigint() - vectorSearchStart) / 1_000_000).toFixed(2)}ms`
103
+ });
104
+ }
105
+ catch (error) {
106
+ this.logSearchStep(searchId, 'VEC 벡터 검색 실패, fallback 사용', {
107
+ error: error instanceof Error ? error.message : String(error)
108
+ });
109
+ // Fallback: 기존 임베딩 서비스 사용
110
+ if (this.embeddingService.isAvailable()) {
111
+ const fallbackStart = process.hrtime.bigint();
112
+ vectorResults = await this.embeddingService.searchBySimilarity(db, searchQuery, {
113
+ type: filters?.type,
114
+ limit: limit * 2,
115
+ threshold: 0.5,
116
+ });
117
+ const fallbackTime = Number(process.hrtime.bigint() - fallbackStart) / 1_000_000;
118
+ this.logSearchStep(searchId, 'Fallback 벡터 검색 완료', {
119
+ resultCount: vectorResults.length,
120
+ fallbackTime: `${fallbackTime.toFixed(2)}ms`
121
+ });
122
+ }
123
+ }
124
+ }
125
+ else {
126
+ this.logSearchStep(searchId, 'VEC 사용 불가, 기존 임베딩 서비스 사용', {});
127
+ // Fallback: 기존 임베딩 서비스 사용
128
+ if (this.embeddingService.isAvailable()) {
129
+ const fallbackStart = process.hrtime.bigint();
130
+ vectorResults = await this.embeddingService.searchBySimilarity(db, searchQuery, {
131
+ type: filters?.type,
132
+ limit: limit * 2,
133
+ threshold: 0.5,
134
+ });
135
+ const fallbackTime = Number(process.hrtime.bigint() - fallbackStart) / 1_000_000;
136
+ this.logSearchStep(searchId, 'Fallback 벡터 검색 완료', {
137
+ resultCount: vectorResults.length,
138
+ fallbackTime: `${fallbackTime.toFixed(2)}ms`
139
+ });
140
+ }
141
+ }
142
+ // 4. 결과 결합 및 점수 계산
143
+ const combineStart = process.hrtime.bigint();
144
+ const combinedResults = this.combineResults(textResults, vectorResults, normalizedTextWeight, normalizedVectorWeight);
145
+ const combineTime = Number(process.hrtime.bigint() - combineStart) / 1_000_000;
146
+ this.logSearchStep(searchId, '결과 결합 완료', {
147
+ combinedCount: combinedResults.length,
148
+ combineTime: `${combineTime.toFixed(2)}ms`,
149
+ textWeight: normalizedTextWeight.toFixed(3),
150
+ vectorWeight: normalizedVectorWeight.toFixed(3)
151
+ });
152
+ // 5. 최종 점수로 정렬하고 제한
153
+ const sortStart = process.hrtime.bigint();
154
+ const finalResults = combinedResults
155
+ .sort((a, b) => b.finalScore - a.finalScore)
156
+ .slice(0, limit);
157
+ const sortTime = Number(process.hrtime.bigint() - sortStart) / 1_000_000;
158
+ // 6. 검색 통계 업데이트
159
+ this.updateSearchStats(searchQuery, textResults.length, vectorResults.length);
160
+ // 7. 쿼리 시간 계산
161
+ const endTime = process.hrtime.bigint();
162
+ const queryTime = Number(endTime - startTime) / 1_000_000; // 밀리초로 변환
163
+ // 최종 결과 로깅
164
+ this.logSearchComplete(searchId, {
165
+ items: finalResults,
166
+ total_count: finalResults.length,
167
+ query_time: queryTime
168
+ }, queryTime);
169
+ return {
170
+ items: finalResults,
171
+ total_count: finalResults.length,
172
+ query_time: queryTime
173
+ };
174
+ }
175
+ catch (error) {
176
+ this.logSearchError(searchId, error, query);
177
+ throw error;
178
+ }
179
+ }
180
+ /**
181
+ * 검색 시작 로깅
182
+ */
183
+ logSearchStart(searchId, query) {
184
+ console.log(`🔍 [${searchId}] 하이브리드 검색 시작`, {
185
+ query: query.query,
186
+ limit: query.limit,
187
+ vectorWeight: query.vectorWeight,
188
+ textWeight: query.textWeight,
189
+ filters: query.filters
190
+ });
191
+ }
192
+ /**
193
+ * 검색 완료 로깅
194
+ */
195
+ logSearchComplete(searchId, result, queryTime) {
196
+ console.log(`✅ [${searchId}] 하이브리드 검색 완료`, {
197
+ resultCount: result.items.length,
198
+ totalCount: result.total_count,
199
+ queryTime: `${queryTime.toFixed(2)}ms`,
200
+ searchType: 'hybrid'
201
+ });
202
+ }
203
+ /**
204
+ * 검색 에러 로깅
205
+ */
206
+ logSearchError(searchId, error, query) {
207
+ console.error(`❌ [${searchId}] 하이브리드 검색 에러`, {
208
+ error: error instanceof Error ? error.message : String(error),
209
+ stack: error instanceof Error ? error.stack : undefined,
210
+ query: query.query,
211
+ limit: query.limit
212
+ });
213
+ }
214
+ /**
215
+ * 검색 단계 로깅
216
+ */
217
+ logSearchStep(searchId, step, data) {
218
+ console.log(`🔍 [${searchId}] ${step}`, data);
219
+ }
220
+ /**
221
+ * 텍스트 검색과 벡터 검색 결과 결합
222
+ */
223
+ combineResults(textResults, vectorResults, textWeight, vectorWeight) {
224
+ const resultMap = new Map();
225
+ // 텍스트 검색 결과 추가
226
+ textResults.forEach(result => {
227
+ const textScore = typeof result.score === 'number' ? result.score : 0; // 안전한 점수 처리
228
+ resultMap.set(result.id, {
229
+ id: result.id,
230
+ content: result.content,
231
+ type: result.type,
232
+ importance: result.importance,
233
+ created_at: result.created_at,
234
+ last_accessed: result.last_accessed,
235
+ pinned: result.pinned,
236
+ tags: result.tags,
237
+ textScore: textScore,
238
+ vectorScore: 0,
239
+ finalScore: textScore * textWeight,
240
+ recall_reason: result.recall_reason || '텍스트 검색 결과',
241
+ });
242
+ });
243
+ // 벡터 검색 결과 추가/업데이트
244
+ vectorResults.forEach(result => {
245
+ const existing = resultMap.get(result.id);
246
+ if (existing) {
247
+ // 기존 결과 업데이트
248
+ existing.vectorScore = result.similarity;
249
+ existing.finalScore = (existing.textScore * textWeight) + (result.similarity * vectorWeight);
250
+ existing.recall_reason = this.generateHybridReason(existing.textScore, result.similarity);
251
+ }
252
+ else {
253
+ // 새로운 결과 추가
254
+ resultMap.set(result.id, {
255
+ id: result.id,
256
+ content: result.content,
257
+ type: result.type,
258
+ importance: result.importance,
259
+ created_at: result.created_at,
260
+ last_accessed: result.last_accessed,
261
+ pinned: result.pinned,
262
+ tags: result.tags,
263
+ textScore: 0,
264
+ vectorScore: result.similarity,
265
+ finalScore: result.similarity * vectorWeight,
266
+ recall_reason: `벡터 유사도: ${result.similarity.toFixed(3)}`,
267
+ });
268
+ }
269
+ });
270
+ return Array.from(resultMap.values());
271
+ }
272
+ /**
273
+ * 하이브리드 검색 이유 생성
274
+ */
275
+ generateHybridReason(textScore, vectorScore) {
276
+ const reasons = [];
277
+ if (textScore > 0.7) {
278
+ reasons.push('텍스트 매칭 우수');
279
+ }
280
+ if (vectorScore > 0.8) {
281
+ reasons.push('의미적 유사도 높음');
282
+ }
283
+ if (textScore > 0.5 && vectorScore > 0.5) {
284
+ reasons.push('텍스트+벡터 결합');
285
+ }
286
+ return reasons.length > 0 ? reasons.join(', ') : '하이브리드 검색';
287
+ }
288
+ /**
289
+ * 적응형 가중치 계산
290
+ */
291
+ calculateAdaptiveWeights(query, vectorWeight, textWeight) {
292
+ const queryKey = this.normalizeQuery(query);
293
+ // 기존 적응형 가중치가 있으면 사용
294
+ if (this.adaptiveWeights.has(queryKey)) {
295
+ return this.adaptiveWeights.get(queryKey);
296
+ }
297
+ // 쿼리 특성 분석
298
+ const queryAnalysis = this.analyzeQuery(query);
299
+ // 쿼리 특성에 따른 가중치 조정
300
+ let adjustedVectorWeight = vectorWeight;
301
+ let adjustedTextWeight = textWeight;
302
+ if (queryAnalysis.isTechnicalTerm) {
303
+ // 기술 용어는 벡터 검색에 더 의존
304
+ adjustedVectorWeight = Math.min(0.8, vectorWeight + 0.2);
305
+ adjustedTextWeight = Math.max(0.2, textWeight - 0.2);
306
+ }
307
+ else if (queryAnalysis.isPhrase) {
308
+ // 구문 검색은 텍스트 검색에 더 의존
309
+ adjustedVectorWeight = Math.max(0.2, vectorWeight - 0.2);
310
+ adjustedTextWeight = Math.min(0.8, textWeight + 0.2);
311
+ }
312
+ else if (queryAnalysis.isShortQuery) {
313
+ // 짧은 쿼리는 벡터 검색에 더 의존
314
+ adjustedVectorWeight = Math.min(0.7, vectorWeight + 0.1);
315
+ adjustedTextWeight = Math.max(0.3, textWeight - 0.1);
316
+ }
317
+ // 가중치 정규화
318
+ const totalWeight = adjustedVectorWeight + adjustedTextWeight;
319
+ const normalizedVectorWeight = adjustedVectorWeight / totalWeight;
320
+ const normalizedTextWeight = adjustedTextWeight / totalWeight;
321
+ const weights = { vectorWeight: normalizedVectorWeight, textWeight: normalizedTextWeight };
322
+ this.adaptiveWeights.set(queryKey, weights);
323
+ return weights;
324
+ }
325
+ /**
326
+ * 쿼리 특성 분석
327
+ */
328
+ analyzeQuery(query) {
329
+ const normalizedQuery = query.toLowerCase().trim();
330
+ return {
331
+ isTechnicalTerm: /^(api|sql|http|json|xml|css|html|js|ts|react|vue|angular|node|python|java|c\+\+|go|rust|docker|kubernetes|aws|azure|gcp)$/i.test(normalizedQuery),
332
+ isPhrase: normalizedQuery.includes(' ') && normalizedQuery.split(' ').length >= 3,
333
+ isShortQuery: normalizedQuery.length <= 10
334
+ };
335
+ }
336
+ /**
337
+ * 쿼리 정규화
338
+ */
339
+ normalizeQuery(query) {
340
+ return query.toLowerCase().trim().replace(/\s+/g, ' ');
341
+ }
342
+ /**
343
+ * 검색 통계 업데이트
344
+ */
345
+ updateSearchStats(query, textHits, vectorHits) {
346
+ const queryKey = this.normalizeQuery(query);
347
+ const stats = this.searchStats.get(queryKey) || { textHits: 0, vectorHits: 0, totalSearches: 0 };
348
+ stats.textHits += textHits;
349
+ stats.vectorHits += vectorHits;
350
+ stats.totalSearches += 1;
351
+ this.searchStats.set(queryKey, stats);
352
+ }
353
+ /**
354
+ * 검색 통계 정보
355
+ */
356
+ async getSearchStats(db) {
357
+ const embeddingStats = await this.embeddingService.getEmbeddingStats(db);
358
+ return {
359
+ textSearchAvailable: true,
360
+ vectorSearchAvailable: this.embeddingService.isAvailable(),
361
+ embeddingStats,
362
+ searchStats: this.searchStats,
363
+ adaptiveWeights: this.adaptiveWeights,
364
+ };
365
+ }
366
+ /**
367
+ * 임베딩 서비스 사용 가능 여부 확인
368
+ */
369
+ isEmbeddingAvailable() {
370
+ return this.embeddingService.isAvailable();
371
+ }
372
+ }
373
+ // 싱글톤 인스턴스
374
+ let hybridSearchEngineInstance = null;
375
+ export function getHybridSearchEngine() {
376
+ if (!hybridSearchEngineInstance) {
377
+ hybridSearchEngineInstance = new HybridSearchEngine();
378
+ }
379
+ return hybridSearchEngineInstance;
380
+ }
381
+ export function createHybridSearchEngine() {
382
+ return new HybridSearchEngine();
383
+ }
384
+ //# sourceMappingURL=hybrid-search-engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hybrid-search-engine.js","sourceRoot":"","sources":["../../src/algorithms/hybrid-search-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * 개선된 검색 엔진 구현
3
+ * FTS5 + 랭킹 알고리즘 + 필터링 결합
4
+ */
5
+ import type { MemorySearchFilters } from '../types/index.js';
6
+ export interface SearchQuery {
7
+ query: string;
8
+ filters?: MemorySearchFilters | undefined;
9
+ limit?: number | undefined;
10
+ }
11
+ export interface SearchResult {
12
+ id: string;
13
+ content: string;
14
+ type: string;
15
+ importance: number;
16
+ created_at: string;
17
+ last_accessed?: string;
18
+ pinned: boolean;
19
+ tags?: string[];
20
+ score: number;
21
+ recall_reason: string;
22
+ }
23
+ export declare class SearchEngine {
24
+ private ranking;
25
+ constructor();
26
+ /**
27
+ * 개선된 검색 구현 - FTS5 최적화
28
+ */
29
+ search(db: any, query: SearchQuery): Promise<{
30
+ items: SearchResult[];
31
+ total_count: number;
32
+ query_time: number;
33
+ }>;
34
+ /**
35
+ * FTS5 검색 쿼리 구성
36
+ * 아키텍처 문서에 따른 쿼리 전처리 구현
37
+ */
38
+ private buildFTSQuery;
39
+ /**
40
+ * 쿼리 전처리 - 아키텍처 문서의 전처리 과정 구현
41
+ */
42
+ private preprocessQuery;
43
+ /**
44
+ * FTS5 안전 쿼리 생성
45
+ */
46
+ private makeFTSSafe;
47
+ /**
48
+ * 데이터베이스 쿼리 실행
49
+ */
50
+ private executeQuery;
51
+ /**
52
+ * 랭킹 알고리즘 적용 - FTS5 랭킹 활용
53
+ */
54
+ private applyRanking;
55
+ /**
56
+ * FTS5 사용 가능 여부 확인
57
+ */
58
+ private checkFTS5Availability;
59
+ /**
60
+ * 검색 이유 생성
61
+ */
62
+ private generateRecallReason;
63
+ }
64
+ //# sourceMappingURL=search-engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-engine.d.ts","sourceRoot":"","sources":["../../src/algorithms/search-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAsB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;;IAM/B;;OAEG;IACG,MAAM,CACV,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA4H9E;;;OAGG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;YACW,YAAY;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA6EpB;;OAEG;YACW,qBAAqB;IAqCnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA2B7B"}