memento-mcp-server 0.1.0 → 1.7.1

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 (560) hide show
  1. package/INSTALL.en.md +303 -303
  2. package/INSTALL.md +303 -303
  3. package/README.en.md +331 -330
  4. package/README.md +432 -427
  5. package/dist/algorithms/hybrid-search-engine.d.ts +114 -44
  6. package/dist/algorithms/hybrid-search-engine.d.ts.map +1 -1
  7. package/dist/algorithms/hybrid-search-engine.js +261 -235
  8. package/dist/algorithms/hybrid-search-engine.js.map +1 -1
  9. package/dist/algorithms/search-engine.d.ts +2 -14
  10. package/dist/algorithms/search-engine.d.ts.map +1 -1
  11. package/dist/algorithms/search-engine.js +43 -35
  12. package/dist/algorithms/search-engine.js.map +1 -1
  13. package/dist/algorithms/vector-search-engine-migration.d.ts +67 -0
  14. package/dist/algorithms/vector-search-engine-migration.d.ts.map +1 -0
  15. package/dist/algorithms/vector-search-engine-migration.js +196 -0
  16. package/dist/algorithms/vector-search-engine-migration.js.map +1 -0
  17. package/dist/algorithms/vector-search-engine-refactored.d.ts +56 -0
  18. package/dist/algorithms/vector-search-engine-refactored.d.ts.map +1 -0
  19. package/dist/algorithms/vector-search-engine-refactored.js +101 -0
  20. package/dist/algorithms/vector-search-engine-refactored.js.map +1 -0
  21. package/dist/algorithms/vector-search-engine.d.ts +9 -2
  22. package/dist/algorithms/vector-search-engine.d.ts.map +1 -1
  23. package/dist/algorithms/vector-search-engine.js +245 -121
  24. package/dist/algorithms/vector-search-engine.js.map +1 -1
  25. package/dist/client/index.d.ts.map +1 -1
  26. package/dist/client/index.js +34 -11
  27. package/dist/client/index.js.map +1 -1
  28. package/dist/config/environment.d.ts +26 -0
  29. package/dist/config/environment.d.ts.map +1 -0
  30. package/dist/config/environment.js +103 -0
  31. package/dist/config/environment.js.map +1 -0
  32. package/dist/config/index.d.ts.map +1 -1
  33. package/dist/config/index.js +29 -50
  34. package/dist/config/index.js.map +1 -1
  35. package/dist/config/vector-search.config.d.ts +25 -0
  36. package/dist/config/vector-search.config.d.ts.map +1 -0
  37. package/dist/config/vector-search.config.js +40 -0
  38. package/dist/config/vector-search.config.js.map +1 -0
  39. package/dist/database/init.d.ts.map +1 -1
  40. package/dist/database/init.js +154 -17
  41. package/dist/database/init.js.map +1 -1
  42. package/dist/database/migrate.d.ts +2 -1
  43. package/dist/database/migrate.d.ts.map +1 -1
  44. package/dist/database/migrate.js +191 -18
  45. package/dist/database/migrate.js.map +1 -1
  46. package/dist/database/schema.sql +234 -159
  47. package/dist/factories/hybrid-search.factory.d.ts +20 -0
  48. package/dist/factories/hybrid-search.factory.d.ts.map +1 -0
  49. package/dist/factories/hybrid-search.factory.js +57 -0
  50. package/dist/factories/hybrid-search.factory.js.map +1 -0
  51. package/dist/factories/spaced-repetition.factory.d.ts +48 -0
  52. package/dist/factories/spaced-repetition.factory.d.ts.map +1 -0
  53. package/dist/factories/spaced-repetition.factory.js +187 -0
  54. package/dist/factories/spaced-repetition.factory.js.map +1 -0
  55. package/dist/factories/vector-search.factory.d.ts +25 -0
  56. package/dist/factories/vector-search.factory.d.ts.map +1 -0
  57. package/dist/factories/vector-search.factory.js +47 -0
  58. package/dist/factories/vector-search.factory.js.map +1 -0
  59. package/dist/interfaces/database.interface.d.ts +36 -0
  60. package/dist/interfaces/database.interface.d.ts.map +1 -0
  61. package/dist/interfaces/database.interface.js +6 -0
  62. package/dist/interfaces/database.interface.js.map +1 -0
  63. package/dist/interfaces/spaced-repetition.interface.d.ts +63 -0
  64. package/dist/interfaces/spaced-repetition.interface.d.ts.map +1 -0
  65. package/dist/interfaces/spaced-repetition.interface.js +6 -0
  66. package/dist/interfaces/spaced-repetition.interface.js.map +1 -0
  67. package/dist/repositories/vector-performance.repository.d.ts +25 -0
  68. package/dist/repositories/vector-performance.repository.d.ts.map +1 -0
  69. package/dist/repositories/vector-performance.repository.js +134 -0
  70. package/dist/repositories/vector-performance.repository.js.map +1 -0
  71. package/dist/repositories/vector-search.repository.d.ts +43 -0
  72. package/dist/repositories/vector-search.repository.d.ts.map +1 -0
  73. package/dist/repositories/vector-search.repository.js +377 -0
  74. package/dist/repositories/vector-search.repository.js.map +1 -0
  75. package/dist/server/http-server.d.ts.map +1 -1
  76. package/dist/server/http-server.js +25 -24
  77. package/dist/server/http-server.js.map +1 -1
  78. package/dist/server/index.d.ts +1 -0
  79. package/dist/server/index.d.ts.map +1 -1
  80. package/dist/server/index.js +3 -1
  81. package/dist/server/index.js.map +1 -1
  82. package/dist/services/alert-notification-service.d.ts +16 -0
  83. package/dist/services/alert-notification-service.d.ts.map +1 -0
  84. package/dist/services/alert-notification-service.js +44 -0
  85. package/dist/services/alert-notification-service.js.map +1 -0
  86. package/dist/services/async-optimizer.d.ts +62 -8
  87. package/dist/services/async-optimizer.d.ts.map +1 -1
  88. package/dist/services/async-optimizer.js +137 -8
  89. package/dist/services/async-optimizer.js.map +1 -1
  90. package/dist/services/batch-scheduler.d.ts +6 -0
  91. package/dist/services/batch-scheduler.d.ts.map +1 -1
  92. package/dist/services/batch-scheduler.js +59 -19
  93. package/dist/services/batch-scheduler.js.map +1 -1
  94. package/dist/services/cache-service.d.ts +32 -0
  95. package/dist/services/cache-service.d.ts.map +1 -1
  96. package/dist/services/cache-service.js +81 -6
  97. package/dist/services/cache-service.js.map +1 -1
  98. package/dist/services/database-optimizer.js +63 -63
  99. package/dist/services/database-optimizer.js.map +1 -1
  100. package/dist/services/embedding-migration-service.d.ts +24 -0
  101. package/dist/services/embedding-migration-service.d.ts.map +1 -0
  102. package/dist/services/embedding-migration-service.js +360 -0
  103. package/dist/services/embedding-migration-service.js.map +1 -0
  104. package/dist/services/embedding-provider-factory.d.ts +12 -5
  105. package/dist/services/embedding-provider-factory.d.ts.map +1 -1
  106. package/dist/services/embedding-provider-factory.js +107 -26
  107. package/dist/services/embedding-provider-factory.js.map +1 -1
  108. package/dist/services/forgetting-policy-service.js +17 -17
  109. package/dist/services/gemini-embedding-service.d.ts +1 -1
  110. package/dist/services/gemini-embedding-service.d.ts.map +1 -1
  111. package/dist/services/gemini-embedding-service.js +25 -18
  112. package/dist/services/gemini-embedding-service.js.map +1 -1
  113. package/dist/services/memory-embedding-service.d.ts +8 -0
  114. package/dist/services/memory-embedding-service.d.ts.map +1 -1
  115. package/dist/services/memory-embedding-service.js +180 -71
  116. package/dist/services/memory-embedding-service.js.map +1 -1
  117. package/dist/services/migration-history-service.d.ts +14 -0
  118. package/dist/services/migration-history-service.d.ts.map +1 -0
  119. package/dist/services/migration-history-service.js +270 -0
  120. package/dist/services/migration-history-service.js.map +1 -0
  121. package/dist/services/migration-monitor-service.d.ts +24 -0
  122. package/dist/services/migration-monitor-service.d.ts.map +1 -0
  123. package/dist/services/migration-monitor-service.js +93 -0
  124. package/dist/services/migration-monitor-service.js.map +1 -0
  125. package/dist/services/model-availability-service.d.ts +22 -0
  126. package/dist/services/model-availability-service.d.ts.map +1 -0
  127. package/dist/services/model-availability-service.js +140 -0
  128. package/dist/services/model-availability-service.js.map +1 -0
  129. package/dist/services/openai-embedding-service.d.ts +36 -0
  130. package/dist/services/openai-embedding-service.d.ts.map +1 -0
  131. package/dist/services/openai-embedding-service.js +192 -0
  132. package/dist/services/openai-embedding-service.js.map +1 -0
  133. package/dist/services/performance-monitor.d.ts +154 -10
  134. package/dist/services/performance-monitor.d.ts.map +1 -1
  135. package/dist/services/performance-monitor.js +446 -60
  136. package/dist/services/performance-monitor.js.map +1 -1
  137. package/dist/services/spaced-repetition/interval-calculation.service.d.ts +38 -0
  138. package/dist/services/spaced-repetition/interval-calculation.service.d.ts.map +1 -0
  139. package/dist/services/spaced-repetition/interval-calculation.service.js +105 -0
  140. package/dist/services/spaced-repetition/interval-calculation.service.js.map +1 -0
  141. package/dist/services/spaced-repetition/optimal-interval.service.d.ts +56 -0
  142. package/dist/services/spaced-repetition/optimal-interval.service.d.ts.map +1 -0
  143. package/dist/services/spaced-repetition/optimal-interval.service.js +163 -0
  144. package/dist/services/spaced-repetition/optimal-interval.service.js.map +1 -0
  145. package/dist/services/spaced-repetition/performance-analysis.service.d.ts +48 -0
  146. package/dist/services/spaced-repetition/performance-analysis.service.d.ts.map +1 -0
  147. package/dist/services/spaced-repetition/performance-analysis.service.js +174 -0
  148. package/dist/services/spaced-repetition/performance-analysis.service.js.map +1 -0
  149. package/dist/services/spaced-repetition/priority-calculation.service.d.ts +53 -0
  150. package/dist/services/spaced-repetition/priority-calculation.service.d.ts.map +1 -0
  151. package/dist/services/spaced-repetition/priority-calculation.service.js +161 -0
  152. package/dist/services/spaced-repetition/priority-calculation.service.js.map +1 -0
  153. package/dist/services/spaced-repetition/recall-probability.service.d.ts +36 -0
  154. package/dist/services/spaced-repetition/recall-probability.service.d.ts.map +1 -0
  155. package/dist/services/spaced-repetition/recall-probability.service.js +88 -0
  156. package/dist/services/spaced-repetition/recall-probability.service.js.map +1 -0
  157. package/dist/services/spaced-repetition/review-scheduling.service.d.ts +43 -0
  158. package/dist/services/spaced-repetition/review-scheduling.service.d.ts.map +1 -0
  159. package/dist/services/spaced-repetition/review-scheduling.service.js +130 -0
  160. package/dist/services/spaced-repetition/review-scheduling.service.js.map +1 -0
  161. package/dist/services/spaced-repetition/spaced-repetition-container.d.ts +69 -0
  162. package/dist/services/spaced-repetition/spaced-repetition-container.d.ts.map +1 -0
  163. package/dist/services/spaced-repetition/spaced-repetition-container.js +136 -0
  164. package/dist/services/spaced-repetition/spaced-repetition-container.js.map +1 -0
  165. package/dist/services/unified-embedding-service.d.ts +3 -0
  166. package/dist/services/unified-embedding-service.d.ts.map +1 -1
  167. package/dist/services/unified-embedding-service.js +58 -62
  168. package/dist/services/unified-embedding-service.js.map +1 -1
  169. package/dist/services/vector-compatibility-service.d.ts +68 -0
  170. package/dist/services/vector-compatibility-service.d.ts.map +1 -0
  171. package/dist/services/vector-compatibility-service.js +373 -0
  172. package/dist/services/vector-compatibility-service.js.map +1 -0
  173. package/dist/services/vector-search/vector-index-manager.d.ts +27 -0
  174. package/dist/services/vector-search/vector-index-manager.d.ts.map +1 -0
  175. package/dist/services/vector-search/vector-index-manager.js +66 -0
  176. package/dist/services/vector-search/vector-index-manager.js.map +1 -0
  177. package/dist/services/vector-search/vector-performance-tester.d.ts +30 -0
  178. package/dist/services/vector-search/vector-performance-tester.d.ts.map +1 -0
  179. package/dist/services/vector-search/vector-performance-tester.js +87 -0
  180. package/dist/services/vector-search/vector-performance-tester.js.map +1 -0
  181. package/dist/services/vector-search/vector-search-container.d.ts +41 -0
  182. package/dist/services/vector-search/vector-search-container.d.ts.map +1 -0
  183. package/dist/services/vector-search/vector-search-container.js +74 -0
  184. package/dist/services/vector-search/vector-search-container.js.map +1 -0
  185. package/dist/services/vector-search/vector-search-facade.d.ts +63 -0
  186. package/dist/services/vector-search/vector-search-facade.d.ts.map +1 -0
  187. package/dist/services/vector-search/vector-search-facade.js +91 -0
  188. package/dist/services/vector-search/vector-search-facade.js.map +1 -0
  189. package/dist/services/vector-search/vector-search-result-normalizer.d.ts +6 -0
  190. package/dist/services/vector-search/vector-search-result-normalizer.d.ts.map +1 -0
  191. package/dist/services/vector-search/vector-search-result-normalizer.js +65 -0
  192. package/dist/services/vector-search/vector-search-result-normalizer.js.map +1 -0
  193. package/dist/services/vector-search/vector-search.service.d.ts +33 -0
  194. package/dist/services/vector-search/vector-search.service.d.ts.map +1 -0
  195. package/dist/services/vector-search/vector-search.service.js +149 -0
  196. package/dist/services/vector-search/vector-search.service.js.map +1 -0
  197. package/dist/tools/forget-tool.js +14 -14
  198. package/dist/tools/pin-tool.js +14 -14
  199. package/dist/tools/unpin-tool.js +21 -21
  200. package/dist/types/alerts.types.d.ts +26 -0
  201. package/dist/types/alerts.types.d.ts.map +1 -0
  202. package/dist/types/alerts.types.js +2 -0
  203. package/dist/types/alerts.types.js.map +1 -0
  204. package/dist/types/embedding-provider-monitoring.types.d.ts +24 -0
  205. package/dist/types/embedding-provider-monitoring.types.d.ts.map +1 -0
  206. package/dist/types/embedding-provider-monitoring.types.js +2 -0
  207. package/dist/types/embedding-provider-monitoring.types.js.map +1 -0
  208. package/dist/types/embedding.types.d.ts +36 -1
  209. package/dist/types/embedding.types.d.ts.map +1 -1
  210. package/dist/types/migration.types.d.ts +131 -0
  211. package/dist/types/migration.types.d.ts.map +1 -0
  212. package/dist/types/migration.types.js +6 -0
  213. package/dist/types/migration.types.js.map +1 -0
  214. package/dist/types/spaced-repetition.types.d.ts +61 -0
  215. package/dist/types/spaced-repetition.types.d.ts.map +1 -0
  216. package/dist/types/spaced-repetition.types.js +6 -0
  217. package/dist/types/spaced-repetition.types.js.map +1 -0
  218. package/dist/types/vector-search.types.d.ts +96 -0
  219. package/dist/types/vector-search.types.d.ts.map +1 -0
  220. package/dist/types/vector-search.types.js +2 -0
  221. package/dist/types/vector-search.types.js.map +1 -0
  222. package/dist/utils/configuration-validator.d.ts +23 -0
  223. package/dist/utils/configuration-validator.d.ts.map +1 -0
  224. package/dist/utils/configuration-validator.js +102 -0
  225. package/dist/utils/configuration-validator.js.map +1 -0
  226. package/dist/utils/database.d.ts.map +1 -1
  227. package/dist/utils/database.js +101 -95
  228. package/dist/utils/database.js.map +1 -1
  229. package/dist/utils/environment-check.d.ts +8 -0
  230. package/dist/utils/environment-check.d.ts.map +1 -0
  231. package/dist/utils/environment-check.js +25 -0
  232. package/dist/utils/environment-check.js.map +1 -0
  233. package/dist/utils/logger.d.ts +8 -0
  234. package/dist/utils/logger.d.ts.map +1 -0
  235. package/dist/utils/logger.js +33 -0
  236. package/dist/utils/logger.js.map +1 -0
  237. package/package.json +139 -125
  238. package/scripts/auto-setup.js +234 -234
  239. package/scripts/backup-daily.bat +28 -28
  240. package/scripts/backup-embeddings.js +108 -108
  241. package/scripts/check-db-integrity.js +93 -93
  242. package/scripts/debug-embeddings.js +184 -184
  243. package/scripts/direct-sql-migration.sql +36 -36
  244. package/scripts/docker-migration.sh +105 -105
  245. package/scripts/fix-migration.js +93 -93
  246. package/scripts/fix-vector-dimensions.js +206 -206
  247. package/scripts/migrate-embedding-data.js +307 -307
  248. package/scripts/regenerate-embeddings.js +144 -144
  249. package/scripts/restore-legacy.ps1 +60 -60
  250. package/scripts/run-migration.js +122 -122
  251. package/scripts/safe-migration.js +150 -150
  252. package/scripts/simple-migrate.js +41 -41
  253. package/scripts/simple-update.js +123 -123
  254. package/src/database/schema.sql +234 -159
  255. package/.cursor/rules/cache-management.mdc +0 -171
  256. package/.cursor/rules/database-schema.mdc +0 -344
  257. package/.cursor/rules/deployment.mdc +0 -596
  258. package/.cursor/rules/error-logging.mdc +0 -298
  259. package/.cursor/rules/forgetting-algorithms.mdc +0 -426
  260. package/.cursor/rules/http-server.mdc +0 -432
  261. package/.cursor/rules/hybrid-search.mdc +0 -424
  262. package/.cursor/rules/implementation.mdc +0 -369
  263. package/.cursor/rules/lightweight-embedding.mdc +0 -178
  264. package/.cursor/rules/mcp-client-development.mdc +0 -0
  265. package/.cursor/rules/mcp-server-development.mdc +0 -0
  266. package/.cursor/rules/mcp-tools-architecture.mdc +0 -205
  267. package/.cursor/rules/memento-memory-rule.mdc +0 -8
  268. package/.cursor/rules/memento-project-overview.mdc +0 -0
  269. package/.cursor/rules/memory-algorithms.mdc +0 -502
  270. package/.cursor/rules/monitoring.mdc +0 -622
  271. package/.cursor/rules/performance-alerts.mdc +0 -537
  272. package/.cursor/rules/performance-monitoring.mdc +0 -345
  273. package/.cursor/rules/performance-optimization.mdc +0 -563
  274. package/.cursor/rules/project-structure.mdc +0 -310
  275. package/.cursor/rules/testing.mdc +0 -473
  276. package/.dockerignore +0 -15
  277. package/.eslintrc.json +0 -34
  278. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -51
  279. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -45
  280. package/.github/ISSUE_TEMPLATE/question.md +0 -31
  281. package/.github/PULL_REQUEST_TEMPLATE.md +0 -97
  282. package/AGENTS.md +0 -28
  283. package/CHANGELOG.md +0 -416
  284. package/CODE_OF_CONDUCT.md +0 -62
  285. package/CONTRIBUTING.md +0 -165
  286. package/DOCKER_SETUP_GUIDE.md +0 -84
  287. package/Dockerfile +0 -90
  288. package/backup/legacy-removal-20250930-201816/http-server-legacy.ts +0 -1068
  289. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.ps1 +0 -46
  290. package/backup/legacy-removal-20250930-201816/rollback-to-legacy.sh +0 -48
  291. package/dist/server/index-backup.d.ts +0 -5
  292. package/dist/server/index-backup.d.ts.map +0 -1
  293. package/dist/server/index-backup.js +0 -793
  294. package/dist/server/index-backup.js.map +0 -1
  295. package/dist/server/index-refactored.d.ts +0 -6
  296. package/dist/server/index-refactored.d.ts.map +0 -1
  297. package/dist/server/index-refactored.js +0 -206
  298. package/dist/server/index-refactored.js.map +0 -1
  299. package/dist/services/performance-monitoring-integration.d.ts +0 -77
  300. package/dist/services/performance-monitoring-integration.d.ts.map +0 -1
  301. package/dist/services/performance-monitoring-integration.js +0 -177
  302. package/dist/services/performance-monitoring-integration.js.map +0 -1
  303. package/dist/test/debug-http-v2.d.ts +0 -5
  304. package/dist/test/debug-http-v2.d.ts.map +0 -1
  305. package/dist/test/debug-http-v2.js +0 -28
  306. package/dist/test/debug-http-v2.js.map +0 -1
  307. package/dist/test/performance-benchmark.d.ts +0 -57
  308. package/dist/test/performance-benchmark.d.ts.map +0 -1
  309. package/dist/test/performance-benchmark.js +0 -427
  310. package/dist/test/performance-benchmark.js.map +0 -1
  311. package/dist/test/test-alerts-direct.d.ts +0 -7
  312. package/dist/test/test-alerts-direct.d.ts.map +0 -1
  313. package/dist/test/test-alerts-direct.js +0 -101
  314. package/dist/test/test-alerts-direct.js.map +0 -1
  315. package/dist/test/test-batch-scheduler.d.ts +0 -2
  316. package/dist/test/test-batch-scheduler.d.ts.map +0 -1
  317. package/dist/test/test-batch-scheduler.js +0 -156
  318. package/dist/test/test-batch-scheduler.js.map +0 -1
  319. package/dist/test/test-client.d.ts +0 -5
  320. package/dist/test/test-client.d.ts.map +0 -1
  321. package/dist/test/test-client.js +0 -86
  322. package/dist/test/test-client.js.map +0 -1
  323. package/dist/test/test-embedding.d.ts +0 -6
  324. package/dist/test/test-embedding.d.ts.map +0 -1
  325. package/dist/test/test-embedding.js +0 -142
  326. package/dist/test/test-embedding.js.map +0 -1
  327. package/dist/test/test-error-logging.d.ts +0 -7
  328. package/dist/test/test-error-logging.d.ts.map +0 -1
  329. package/dist/test/test-error-logging.js +0 -105
  330. package/dist/test/test-error-logging.js.map +0 -1
  331. package/dist/test/test-forgetting.d.ts +0 -6
  332. package/dist/test/test-forgetting.d.ts.map +0 -1
  333. package/dist/test/test-forgetting.js +0 -154
  334. package/dist/test/test-forgetting.js.map +0 -1
  335. package/dist/test/test-gemini-embedding.d.ts +0 -7
  336. package/dist/test/test-gemini-embedding.d.ts.map +0 -1
  337. package/dist/test/test-gemini-embedding.js +0 -134
  338. package/dist/test/test-gemini-embedding.js.map +0 -1
  339. package/dist/test/test-http-server-v2-simple.d.ts +0 -6
  340. package/dist/test/test-http-server-v2-simple.d.ts.map +0 -1
  341. package/dist/test/test-http-server-v2-simple.js +0 -131
  342. package/dist/test/test-http-server-v2-simple.js.map +0 -1
  343. package/dist/test/test-http-server-v2.d.ts +0 -7
  344. package/dist/test/test-http-server-v2.d.ts.map +0 -1
  345. package/dist/test/test-http-server-v2.js +0 -529
  346. package/dist/test/test-http-server-v2.js.map +0 -1
  347. package/dist/test/test-lightweight-embedding.d.ts +0 -6
  348. package/dist/test/test-lightweight-embedding.d.ts.map +0 -1
  349. package/dist/test/test-lightweight-embedding.js +0 -189
  350. package/dist/test/test-lightweight-embedding.js.map +0 -1
  351. package/dist/test/test-m1-completion.d.ts +0 -7
  352. package/dist/test/test-m1-completion.d.ts.map +0 -1
  353. package/dist/test/test-m1-completion.js +0 -124
  354. package/dist/test/test-m1-completion.js.map +0 -1
  355. package/dist/test/test-memory-injection-prompt.d.ts +0 -2
  356. package/dist/test/test-memory-injection-prompt.d.ts.map +0 -1
  357. package/dist/test/test-memory-injection-prompt.js +0 -299
  358. package/dist/test/test-memory-injection-prompt.js.map +0 -1
  359. package/dist/test/test-performance-alerts.d.ts +0 -7
  360. package/dist/test/test-performance-alerts.d.ts.map +0 -1
  361. package/dist/test/test-performance-alerts.js +0 -109
  362. package/dist/test/test-performance-alerts.js.map +0 -1
  363. package/dist/test/test-performance-monitor.d.ts +0 -2
  364. package/dist/test/test-performance-monitor.d.ts.map +0 -1
  365. package/dist/test/test-performance-monitor.js +0 -182
  366. package/dist/test/test-performance-monitor.js.map +0 -1
  367. package/dist/test/test-performance-monitoring.d.ts +0 -6
  368. package/dist/test/test-performance-monitoring.d.ts.map +0 -1
  369. package/dist/test/test-performance-monitoring.js +0 -156
  370. package/dist/test/test-performance-monitoring.js.map +0 -1
  371. package/dist/test/test-search.d.ts +0 -5
  372. package/dist/test/test-search.d.ts.map +0 -1
  373. package/dist/test/test-search.js +0 -141
  374. package/dist/test/test-search.js.map +0 -1
  375. package/dist/test/test-simple-alerts.d.ts +0 -6
  376. package/dist/test/test-simple-alerts.d.ts.map +0 -1
  377. package/dist/test/test-simple-alerts.js +0 -106
  378. package/dist/test/test-simple-alerts.js.map +0 -1
  379. package/dist/test/test-vector-search-engine.d.ts +0 -2
  380. package/dist/test/test-vector-search-engine.d.ts.map +0 -1
  381. package/dist/test/test-vector-search-engine.js +0 -225
  382. package/dist/test/test-vector-search-engine.js.map +0 -1
  383. package/docker-compose.dev.yml +0 -50
  384. package/docker-compose.prod.yml +0 -77
  385. package/docker-compose.yml +0 -43
  386. package/docs/en/Memento-Goals.md +0 -217
  387. package/docs/en/Memento-M1-DetailSpecs.md +0 -130
  388. package/docs/en/Memento-Milestones.md +0 -135
  389. package/docs/en/Search-Ranking-Memory-Decay-Formulas.md +0 -177
  390. package/docs/en/api-reference.md +0 -658
  391. package/docs/en/architecture.md +0 -1302
  392. package/docs/en/developer-guide.md +0 -1005
  393. package/docs/en/user-manual.md +0 -595
  394. package/docs/ko/Memento-Goals.md +0 -217
  395. package/docs/ko/Memento-M1-DetailSpecs.md +0 -130
  396. package/docs/ko/Memento-Milestones.md +0 -134
  397. package/docs/ko/Search-Ranking-Memory-Decay-Formulas.md +0 -177
  398. package/docs/ko/api-reference.md +0 -658
  399. package/docs/ko/architecture.md +0 -1302
  400. package/docs/ko/developer-guide.md +0 -1006
  401. package/docs/ko/embedding-api-reference.md +0 -122
  402. package/docs/ko/embedding-configuration.md +0 -62
  403. package/docs/ko/embedding-performance-benchmark.md +0 -62
  404. package/docs/ko/embedding-service-guide.md +0 -314
  405. package/docs/ko/user-manual.md +0 -595
  406. package/env.example +0 -49
  407. package/install.sh +0 -191
  408. package/mcp-http-client.js +0 -218
  409. package/mcp.json +0 -0
  410. package/packages/mcp-client/docs/API-REFERENCE.md +0 -560
  411. package/packages/mcp-client/docs/BEST-PRACTICES.md +0 -564
  412. package/packages/mcp-client/docs/MIGRATION-GUIDE.md +0 -344
  413. package/packages/mcp-client/docs/PERFORMANCE-GUIDE.md +0 -476
  414. package/packages/mcp-client/docs/TROUBLESHOOTING.md +0 -564
  415. package/packages/mcp-client/package-lock.json +0 -907
  416. package/packages/mcp-client/package.json +0 -58
  417. package/packages/mcp-client/performance-optimizer.js +0 -428
  418. package/packages/mcp-client/test-basic.js +0 -65
  419. package/packages/mcp-client/test-integration.js +0 -366
  420. package/src/algorithms/forgetting-algorithm.spec.ts +0 -538
  421. package/src/algorithms/forgetting-algorithm.ts +0 -243
  422. package/src/algorithms/hybrid-search-engine.spec.ts +0 -484
  423. package/src/algorithms/hybrid-search-engine.ts +0 -489
  424. package/src/algorithms/search-engine.spec.ts +0 -429
  425. package/src/algorithms/search-engine.ts +0 -392
  426. package/src/algorithms/search-ranking.spec.ts +0 -293
  427. package/src/algorithms/search-ranking.ts +0 -407
  428. package/src/algorithms/spaced-repetition.spec.ts +0 -510
  429. package/src/algorithms/spaced-repetition.ts +0 -238
  430. package/src/algorithms/vector-search-engine.ts +0 -505
  431. package/src/client/index.spec.ts +0 -427
  432. package/src/client/index.ts +0 -222
  433. package/src/config/index.spec.ts +0 -339
  434. package/src/config/index.ts +0 -106
  435. package/src/database/init.spec.ts +0 -239
  436. package/src/database/init.ts +0 -130
  437. package/src/database/migrate.spec.ts +0 -293
  438. package/src/database/migrate.ts +0 -94
  439. package/src/database/migrations/001_add_embedding_metadata.sql +0 -29
  440. package/src/npm-client/context-injector.spec.ts +0 -335
  441. package/src/npm-client/context-injector.ts +0 -412
  442. package/src/npm-client/index.spec.ts +0 -108
  443. package/src/npm-client/index.ts +0 -96
  444. package/src/npm-client/memento-client.spec.ts +0 -549
  445. package/src/npm-client/memento-client.ts +0 -501
  446. package/src/npm-client/memory-manager.spec.ts +0 -374
  447. package/src/npm-client/memory-manager.ts +0 -414
  448. package/src/npm-client/types.spec.ts +0 -427
  449. package/src/npm-client/types.ts +0 -296
  450. package/src/npm-client/utils.spec.ts +0 -355
  451. package/src/npm-client/utils.ts +0 -423
  452. package/src/scripts/copy-assets.js +0 -37
  453. package/src/server/http-server.spec.ts +0 -648
  454. package/src/server/http-server.ts +0 -1030
  455. package/src/server/index-backup.ts +0 -875
  456. package/src/server/index-refactored.ts +0 -237
  457. package/src/server/index.spec.ts +0 -281
  458. package/src/server/index.ts +0 -347
  459. package/src/server/simple-mcp-server.spec.ts +0 -207
  460. package/src/server/simple-mcp-server.ts +0 -173
  461. package/src/services/async-optimizer.spec.ts +0 -569
  462. package/src/services/async-optimizer.ts +0 -484
  463. package/src/services/batch-scheduler.ts +0 -759
  464. package/src/services/cache-service.spec.ts +0 -372
  465. package/src/services/cache-service.ts +0 -434
  466. package/src/services/database-optimizer.spec.ts +0 -344
  467. package/src/services/database-optimizer.ts +0 -450
  468. package/src/services/embedding-provider-factory.ts +0 -173
  469. package/src/services/embedding-service.spec.ts +0 -342
  470. package/src/services/embedding-service.ts +0 -333
  471. package/src/services/error-logging-service.spec.ts +0 -416
  472. package/src/services/error-logging-service.ts +0 -383
  473. package/src/services/forgetting-policy-service.spec.ts +0 -140
  474. package/src/services/forgetting-policy-service.ts +0 -334
  475. package/src/services/gemini-embedding-service.spec.ts +0 -463
  476. package/src/services/gemini-embedding-service.ts +0 -283
  477. package/src/services/lightweight-embedding-service.spec.ts +0 -458
  478. package/src/services/lightweight-embedding-service.ts +0 -324
  479. package/src/services/memory-embedding-service.spec.ts +0 -417
  480. package/src/services/memory-embedding-service.ts +0 -289
  481. package/src/services/minilm-embedding-service.spec.ts +0 -104
  482. package/src/services/minilm-embedding-service.ts +0 -262
  483. package/src/services/performance-alert-service.spec.ts +0 -517
  484. package/src/services/performance-alert-service.ts +0 -477
  485. package/src/services/performance-monitor.spec.ts +0 -401
  486. package/src/services/performance-monitor.ts +0 -532
  487. package/src/services/performance-monitoring-integration.spec.ts +0 -478
  488. package/src/services/performance-monitoring-integration.ts.bak +0 -276
  489. package/src/services/unified-embedding-service.spec.ts +0 -224
  490. package/src/services/unified-embedding-service.ts +0 -255
  491. package/src/test/debug-http-v2.ts +0 -30
  492. package/src/test/embedding-integration-test.spec.ts +0 -295
  493. package/src/test/embedding-integration-test.ts +0 -295
  494. package/src/test/embedding-performance-benchmark.spec.ts +0 -354
  495. package/src/test/embedding-performance-benchmark.ts +0 -312
  496. package/src/test/performance-benchmark.ts +0 -565
  497. package/src/test/test-alerts-direct.ts +0 -136
  498. package/src/test/test-batch-scheduler-simple.spec.ts +0 -122
  499. package/src/test/test-batch-scheduler.spec.ts +0 -453
  500. package/src/test/test-batch-scheduler.ts +0 -182
  501. package/src/test/test-client.ts +0 -97
  502. package/src/test/test-embedding.ts +0 -153
  503. package/src/test/test-error-handling.spec.ts +0 -575
  504. package/src/test/test-error-logging.ts +0 -117
  505. package/src/test/test-forgetting.ts +0 -162
  506. package/src/test/test-gemini-embedding.ts +0 -159
  507. package/src/test/test-http-server-v2-simple.ts +0 -147
  508. package/src/test/test-http-server-v2.ts +0 -586
  509. package/src/test/test-hybrid-search-engine.spec.ts +0 -521
  510. package/src/test/test-integration-fixed.spec.ts +0 -612
  511. package/src/test/test-integration.spec.ts +0 -463
  512. package/src/test/test-lightweight-embedding.ts +0 -208
  513. package/src/test/test-m1-completion.spec.ts +0 -614
  514. package/src/test/test-m1-completion.ts +0 -141
  515. package/src/test/test-m1-integration.spec.ts +0 -514
  516. package/src/test/test-memory-injection-prompt.spec.ts +0 -650
  517. package/src/test/test-memory-injection-prompt.ts +0 -391
  518. package/src/test/test-performance-alerts.ts +0 -125
  519. package/src/test/test-performance-monitor-updates.spec.ts +0 -490
  520. package/src/test/test-performance-monitor.spec.ts +0 -284
  521. package/src/test/test-performance-monitor.ts +0 -228
  522. package/src/test/test-performance-monitoring.ts +0 -171
  523. package/src/test/test-search.ts +0 -151
  524. package/src/test/test-simple-alerts.ts +0 -136
  525. package/src/test/test-vector-search-engine.spec.ts +0 -408
  526. package/src/test/test-vector-search-engine.ts +0 -303
  527. package/src/tools/base-tool.ts +0 -189
  528. package/src/tools/cleanup-memory-tool.ts +0 -77
  529. package/src/tools/database-optimize-tool.ts +0 -79
  530. package/src/tools/error-stats.ts +0 -119
  531. package/src/tools/forget-tool.spec.ts +0 -613
  532. package/src/tools/forget-tool.ts +0 -454
  533. package/src/tools/forgetting-stats-tool.ts +0 -47
  534. package/src/tools/index.ts +0 -71
  535. package/src/tools/memory-injection-prompt.ts +0 -257
  536. package/src/tools/performance-alerts.ts +0 -226
  537. package/src/tools/performance-stats-tool.ts +0 -48
  538. package/src/tools/pin-tool.spec.ts +0 -497
  539. package/src/tools/pin-tool.ts +0 -277
  540. package/src/tools/recall-tool.spec.ts +0 -475
  541. package/src/tools/recall-tool.ts +0 -389
  542. package/src/tools/remember-tool.spec.ts +0 -469
  543. package/src/tools/remember-tool.ts +0 -112
  544. package/src/tools/resolve-error.ts +0 -69
  545. package/src/tools/tool-registry.ts +0 -417
  546. package/src/tools/types.ts +0 -63
  547. package/src/tools/unpin-tool.spec.ts +0 -549
  548. package/src/tools/unpin-tool.ts +0 -306
  549. package/src/types/embedding.types.ts +0 -78
  550. package/src/types/index.spec.ts +0 -420
  551. package/src/types/index.ts +0 -117
  552. package/src/utils/database.spec.ts +0 -77
  553. package/src/utils/database.ts +0 -458
  554. package/src/utils/stopwords.ts +0 -128
  555. package/start-docker-setup.bat +0 -38
  556. package/static/logo.png +0 -0
  557. package/static/memento_logo.svg +0 -2
  558. package/test-docker.js +0 -103
  559. package/tsconfig.json +0 -46
  560. package/vitest.config.ts +0 -23
@@ -1,392 +0,0 @@
1
- /**
2
- * 개선된 검색 엔진 구현
3
- * FTS5 + 랭킹 알고리즘 + 필터링 결합
4
- */
5
-
6
- import { SearchRanking } from './search-ranking.js';
7
- import type { MemorySearchResult, MemorySearchFilters } from '../types/index.js';
8
- import { getStopWords } from '../utils/stopwords.js';
9
-
10
- export interface SearchQuery {
11
- query: string;
12
- filters?: MemorySearchFilters | undefined;
13
- limit?: number | undefined;
14
- }
15
-
16
- export interface SearchResult {
17
- id: string;
18
- content: string;
19
- type: string;
20
- importance: number;
21
- created_at: string;
22
- last_accessed?: string;
23
- pinned: boolean;
24
- tags?: string[];
25
- score: number;
26
- recall_reason: string;
27
- }
28
-
29
- export class SearchEngine {
30
- private ranking: SearchRanking;
31
-
32
- constructor() {
33
- this.ranking = new SearchRanking();
34
- }
35
-
36
- /**
37
- * 개선된 검색 구현 - FTS5 최적화
38
- */
39
- async search(
40
- db: any,
41
- query: SearchQuery
42
- ): Promise<{ items: SearchResult[], total_count: number, query_time: number }> {
43
- const startTime = process.hrtime.bigint();
44
- const { query: searchQuery, filters, limit = 10 } = query;
45
-
46
- // 1. ID 필터가 있으면 내용 검색 조건을 건너뛰기
47
- const hasIdFilter = filters?.id && filters.id.length > 0;
48
-
49
- let sql: string;
50
- const params: any[] = [];
51
-
52
- // 2. FTS5 검색 사용 (ID 필터가 없고 검색어가 있을 때)
53
- if (!hasIdFilter && searchQuery.trim().length > 0) {
54
- // FTS5 사용 가능 여부 확인
55
- const ftsAvailable = await this.checkFTS5Availability(db);
56
-
57
- if (ftsAvailable) {
58
- const ftsQuery = this.buildFTSQuery(searchQuery);
59
- sql = `
60
- SELECT
61
- m.id, m.content, m.type, m.importance, m.created_at,
62
- m.last_accessed, m.pinned, m.tags, m.source,
63
- memory_item_fts.rank as fts_rank
64
- FROM memory_item_fts
65
- JOIN memory_item m ON memory_item_fts.rowid = m.rowid
66
- WHERE memory_item_fts MATCH ?
67
- `;
68
- params.push(ftsQuery);
69
- } else {
70
- // FTS5가 없으면 기본 LIKE 검색 사용
71
- const likeQuery = `%${searchQuery}%`;
72
- sql = `
73
- SELECT
74
- m.id, m.content, m.type, m.importance, m.created_at,
75
- m.last_accessed, m.pinned, m.tags, m.source,
76
- 0 as fts_rank
77
- FROM memory_item m
78
- WHERE m.content LIKE ? OR m.tags LIKE ? OR m.source LIKE ?
79
- `;
80
- params.push(likeQuery, likeQuery, likeQuery);
81
- }
82
- } else {
83
- // 3. 기본 SQL 쿼리 구성 (ID 필터가 있거나 검색어가 없을 때)
84
- sql = `
85
- SELECT
86
- m.id, m.content, m.type, m.importance, m.created_at,
87
- m.last_accessed, m.pinned, m.tags, m.source,
88
- 0 as fts_rank
89
- FROM memory_item m
90
- `;
91
-
92
- // 내용 검색 조건 (검색어가 있을 때만)
93
- if (!hasIdFilter && searchQuery.trim().length > 0) {
94
- const likeQuery = `%${searchQuery}%`;
95
- sql += ` WHERE m.content LIKE ?`;
96
- params.push(likeQuery);
97
- }
98
- }
99
-
100
- // 4. 필터 조건 추가
101
- const conditions: string[] = [];
102
-
103
- if (filters?.id && filters.id.length > 0) {
104
- conditions.push(`m.id IN (${filters.id.map(() => '?').join(',')})`);
105
- params.push(...filters.id);
106
- }
107
-
108
- if (filters?.type && filters.type.length > 0) {
109
- conditions.push(`m.type IN (${filters.type.map(() => '?').join(',')})`);
110
- params.push(...filters.type);
111
- }
112
-
113
- if (filters?.privacy_scope && filters.privacy_scope.length > 0) {
114
- conditions.push(`m.privacy_scope IN (${filters.privacy_scope.map(() => '?').join(',')})`);
115
- params.push(...filters.privacy_scope);
116
- }
117
-
118
- if (filters?.pinned !== undefined) {
119
- conditions.push(`m.pinned = ?`);
120
- params.push(filters.pinned ? 1 : 0); // boolean을 숫자로 변환
121
- }
122
-
123
- if (filters?.time_from) {
124
- conditions.push(`m.created_at >= ?`);
125
- params.push(filters.time_from);
126
- }
127
-
128
- if (filters?.time_to) {
129
- conditions.push(`m.created_at <= ?`);
130
- params.push(filters.time_to);
131
- }
132
-
133
- // WHERE 절 추가
134
- if (conditions.length > 0) {
135
- const whereClause = sql.includes('WHERE') ? ' AND ' : ' WHERE ';
136
- sql += whereClause + conditions.join(' AND ');
137
- }
138
-
139
- // 5. 결과 제한 및 정렬 최적화
140
- sql += ` ORDER BY fts_rank DESC, m.created_at DESC LIMIT ?`;
141
- params.push(limit * 3); // FTS5 랭킹을 고려하여 더 많은 후보 가져오기
142
-
143
- // 6. 데이터베이스 쿼리 실행
144
- console.log('🔍 검색 쿼리:', sql);
145
- console.log('🔍 검색 파라미터:', params);
146
- const results = await this.executeQuery(db, sql, params);
147
- console.log('🔍 검색 결과 개수:', results.length);
148
-
149
- // 7. 랭킹 알고리즘 적용 (FTS5 랭킹 활용)
150
- const rankedResults = this.applyRanking(results, searchQuery);
151
-
152
- // 8. 최종 결과 반환 (limit 적용)
153
- const finalResults = rankedResults.slice(0, limit);
154
-
155
- // 9. 쿼리 시간 측정
156
- const endTime = process.hrtime.bigint();
157
- const queryTime = Number(endTime - startTime) / 1_000_000; // 밀리초로 변환
158
-
159
- return {
160
- items: finalResults,
161
- total_count: finalResults.length,
162
- query_time: queryTime
163
- };
164
- }
165
-
166
- /**
167
- * FTS5 검색 쿼리 구성
168
- * 아키텍처 문서에 따른 쿼리 전처리 구현
169
- */
170
- private buildFTSQuery(query: string): string {
171
- console.log('🔍 원본 쿼리:', `"${query}"`);
172
-
173
- // 1. 쿼리 전처리
174
- const preprocessedQuery = this.preprocessQuery(query);
175
- console.log('🔍 전처리 후:', `"${preprocessedQuery}"`);
176
-
177
- if (preprocessedQuery.length === 0) {
178
- console.log('🔍 빈 쿼리, 모든 문서 검색');
179
- return '*'; // 빈 쿼리인 경우 모든 문서 검색
180
- }
181
-
182
- // 2. FTS5 안전 쿼리 생성
183
- const safeQuery = this.makeFTSSafe(preprocessedQuery);
184
- console.log('🔍 FTS5 안전 쿼리:', `"${safeQuery}"`);
185
-
186
- if (safeQuery.length === 0) {
187
- console.log('🔍 안전 쿼리 빈 문자열, 모든 문서 검색');
188
- return '*';
189
- }
190
-
191
- return safeQuery;
192
- }
193
-
194
- /**
195
- * 쿼리 전처리 - 아키텍처 문서의 전처리 과정 구현
196
- */
197
- private preprocessQuery(query: string): string {
198
- // 1. 공백 정규화
199
- let processed = query.trim().replace(/\s+/g, ' ');
200
-
201
- // 2. 한글과 영문, 숫자, 공백만 유지 (특수문자 제거)
202
- processed = processed.replace(/[^a-zA-Z0-9가-힣\s]/g, ' ');
203
-
204
- // 3. 연속된 공백 제거
205
- processed = processed.replace(/\s+/g, ' ');
206
-
207
- // 4. 불용어 제거 (한국어/영어 불용어)
208
- const stopWords = getStopWords();
209
- const words = processed.split(' ').filter(word =>
210
- word.length > 0 && !stopWords.has(word.toLowerCase())
211
- );
212
-
213
- // 5. FTS5를 위한 공백으로 구분된 쿼리 반환
214
- return words.join(' ');
215
- }
216
-
217
- /**
218
- * FTS5 안전 쿼리 생성
219
- */
220
- private makeFTSSafe(query: string): string {
221
- // FTS5에서 특수문자 이스케이프
222
- return query
223
- .replace(/"/g, '""') // 따옴표 이스케이프
224
- .replace(/'/g, "''") // 작은따옴표 이스케이프
225
- .replace(/[\[\]{}()]/g, ' ') // 대괄호, 중괄호, 소괄호 제거
226
- .replace(/\s+/g, ' ') // 연속 공백 정리
227
- .trim();
228
- }
229
-
230
- /**
231
- * 데이터베이스 쿼리 실행
232
- */
233
- private async executeQuery(db: any, sql: string, params: any[]): Promise<any[]> {
234
- // better-sqlite3는 동기적이므로 직접 실행
235
- try {
236
- return db.prepare(sql).all(params);
237
- } catch (error) {
238
- throw error;
239
- }
240
- }
241
-
242
- /**
243
- * 랭킹 알고리즘 적용 - FTS5 랭킹 활용
244
- */
245
- private applyRanking(results: any[], query: string): SearchResult[] {
246
- const selectedContents: string[] = [];
247
-
248
- return results
249
- .map((row: any) => {
250
- // FTS5 랭킹이 있으면 활용, 없으면 기본 관련성 계산
251
- const ftsRank = row.fts_rank || 0;
252
- const relevance = ftsRank > 0 ?
253
- Math.min(ftsRank / 100, 1.0) : // FTS5 랭킹을 0-1 범위로 정규화
254
- this.ranking.calculateRelevance({
255
- query,
256
- content: row.content,
257
- tags: row.tags ? JSON.parse(row.tags) : []
258
- });
259
-
260
- // 최근성 계산
261
- const recency = this.ranking.calculateRecency(
262
- new Date(row.created_at),
263
- row.type
264
- );
265
-
266
- // 중요도 계산
267
- const importance = this.ranking.calculateImportance(
268
- row.importance,
269
- row.pinned,
270
- row.type
271
- );
272
-
273
- // 사용성 계산 (기본 메트릭 사용)
274
- const usage = this.ranking.calculateUsage({
275
- viewCount: 1, // 기본값
276
- citeCount: 0,
277
- editCount: 0
278
- });
279
-
280
- // 중복 패널티 계산
281
- const duplicationPenalty = this.ranking.calculateDuplicationPenalty(
282
- row.content,
283
- selectedContents
284
- );
285
-
286
- // 최종 점수 계산 (FTS5 랭킹 가중치 적용)
287
- const finalScore = ftsRank > 0 ?
288
- ftsRank * 0.7 + this.ranking.calculateFinalScore({
289
- relevance: 0.3,
290
- recency,
291
- importance,
292
- usage,
293
- duplication_penalty: duplicationPenalty
294
- }) * 0.3 :
295
- this.ranking.calculateFinalScore({
296
- relevance,
297
- recency,
298
- importance,
299
- usage,
300
- duplication_penalty: duplicationPenalty
301
- });
302
-
303
- // 선택된 콘텐츠에 추가 (다양성 확보)
304
- selectedContents.push(row.content);
305
-
306
- return {
307
- id: row.id,
308
- content: row.content,
309
- type: row.type,
310
- importance: row.importance,
311
- created_at: row.created_at,
312
- last_accessed: row.last_accessed,
313
- pinned: row.pinned,
314
- tags: row.tags ? JSON.parse(row.tags) : [],
315
- score: finalScore,
316
- recall_reason: this.generateRecallReason(relevance, recency, importance, finalScore, ftsRank > 0)
317
- };
318
- })
319
- .sort((a, b) => b.score - a.score); // 점수 내림차순 정렬
320
- }
321
-
322
- /**
323
- * FTS5 사용 가능 여부 확인
324
- */
325
- private async checkFTS5Availability(db: any): Promise<boolean> {
326
- try {
327
- // FTS5 테이블 존재 여부 확인
328
- const result = db.prepare(`
329
- SELECT name FROM sqlite_master
330
- WHERE type='table' AND name='memory_item_fts'
331
- `).get();
332
-
333
- if (!result) {
334
- console.log('⚠️ FTS5 테이블이 존재하지 않음, 기본 검색으로 전환');
335
- return false;
336
- }
337
-
338
- // FTS5 테이블에 데이터가 있는지 확인
339
- const count = db.prepare('SELECT COUNT(*) as count FROM memory_item_fts').get();
340
- const hasData = count && count.count > 0;
341
-
342
- if (!hasData) {
343
- console.log('⚠️ FTS5 테이블에 데이터가 없음, 기본 검색으로 전환');
344
- return false;
345
- }
346
-
347
- // FTS5 쿼리 테스트
348
- try {
349
- db.prepare('SELECT * FROM memory_item_fts LIMIT 1').get();
350
- console.log('✅ FTS5 사용 가능');
351
- return true;
352
- } catch (ftsError) {
353
- console.log('⚠️ FTS5 쿼리 실패, 기본 검색으로 전환:', ftsError);
354
- return false;
355
- }
356
- } catch (error) {
357
- console.log('⚠️ FTS5 사용 불가능, 기본 검색으로 전환:', error);
358
- return false;
359
- }
360
- }
361
-
362
- /**
363
- * 검색 이유 생성
364
- */
365
- private generateRecallReason(
366
- relevance: number,
367
- recency: number,
368
- importance: number,
369
- finalScore: number,
370
- isFTS: boolean = false
371
- ): string {
372
- const reasons: string[] = [];
373
-
374
- if (isFTS) {
375
- reasons.push('FTS5 전문 검색');
376
- }
377
- if (relevance > 0.7) {
378
- reasons.push('높은 관련성');
379
- }
380
- if (recency > 0.8) {
381
- reasons.push('최근 생성');
382
- }
383
- if (importance > 0.8) {
384
- reasons.push('높은 중요도');
385
- }
386
- if (finalScore > 0.9) {
387
- reasons.push('종합 점수 우수');
388
- }
389
-
390
- return reasons.length > 0 ? reasons.join(', ') : '일반 검색 결과';
391
- }
392
- }
@@ -1,293 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { SearchRanking } from './search-ranking.js';
3
-
4
- describe('SearchRanking', () => {
5
- const ranking = new SearchRanking();
6
-
7
- describe('calculateFinalScore', () => {
8
- it('가중치에 따라 최종 점수를 계산한다', () => {
9
- const score = ranking.calculateFinalScore({
10
- relevance: 0.9,
11
- recency: 0.8,
12
- importance: 0.6,
13
- usage: 0.4,
14
- duplication_penalty: 0.2,
15
- });
16
-
17
- const expected = 0.5 * 0.9 + 0.2 * 0.8 + 0.2 * 0.6 + 0.1 * 0.4 - 0.15 * 0.2;
18
- expect(score).toBeCloseTo(expected, 5);
19
- });
20
-
21
- it('음수 점수가 나올 수 있다', () => {
22
- const score = ranking.calculateFinalScore({
23
- relevance: 0.1,
24
- recency: 0.1,
25
- importance: 0.1,
26
- usage: 0.1,
27
- duplication_penalty: 0.9,
28
- });
29
-
30
- expect(score).toBeLessThan(0);
31
- });
32
- });
33
-
34
- describe('calculateRelevance', () => {
35
- it('기본 관련성 점수를 계산한다', () => {
36
- const relevance = ranking.calculateRelevance({
37
- query: 'React Hook',
38
- content: 'React Hook에 대해 설명한 문서입니다. Hook API 예시 포함.',
39
- tags: ['frontend', 'react']
40
- });
41
-
42
- expect(relevance).toBeLessThanOrEqual(1);
43
- expect(relevance).toBeGreaterThan(0);
44
- });
45
-
46
- it('임베딩 유사도가 제공된 경우 관련성 점수를 계산한다', () => {
47
- const relevance = ranking.calculateRelevance({
48
- query: 'React Hook',
49
- content: 'React Hook에 대한 내용',
50
- tags: ['react'],
51
- embeddingSimilarity: {
52
- queryEmbedding: [0.1, 0.2, 0.3, 0.4],
53
- docEmbedding: [0.1, 0.2, 0.3, 0.4]
54
- }
55
- });
56
- expect(relevance).toBeGreaterThan(0);
57
- });
58
-
59
- it('BM25 결과가 제공된 경우 관련성 점수를 계산한다', () => {
60
- const relevance = ranking.calculateRelevance({
61
- query: 'React Hook',
62
- content: 'React Hook에 대한 내용',
63
- tags: ['react'],
64
- bm25Result: { score: 2.5, normalizedScore: 0.8 }
65
- });
66
- expect(relevance).toBeGreaterThan(0);
67
- });
68
-
69
- it('타이틀이 있는 경우 타이틀 히트 점수를 반영한다', () => {
70
- const relevance = ranking.calculateRelevance({
71
- query: 'React Hook',
72
- content: 'React Hook에 대한 내용',
73
- title: 'React Hook Guide',
74
- tags: ['react']
75
- });
76
- expect(relevance).toBeGreaterThan(0);
77
- });
78
-
79
- it('빈 문자열 입력에 대해 안전하게 처리한다', () => {
80
- const relevance = ranking.calculateRelevance({
81
- query: '',
82
- content: '',
83
- tags: []
84
- });
85
- expect(relevance).toBe(0);
86
- });
87
-
88
- it('null/undefined 입력에 대해 안전하게 처리한다', () => {
89
- const relevance = ranking.calculateRelevance({
90
- query: null as any,
91
- content: undefined as any,
92
- tags: []
93
- });
94
- expect(relevance).toBe(0);
95
- });
96
- });
97
-
98
- describe('calculateRecency', () => {
99
- it('최근성이 높은 기억은 더 높은 점수를 받는다', () => {
100
- const recent = ranking.calculateRecency(
101
- new Date(Date.now() - 1 * 24 * 60 * 60 * 1000),
102
- 'semantic'
103
- );
104
- const old = ranking.calculateRecency(
105
- new Date(Date.now() - 200 * 24 * 60 * 60 * 1000),
106
- 'semantic'
107
- );
108
-
109
- expect(recent).toBeGreaterThan(old);
110
- expect(recent).toBeLessThanOrEqual(1);
111
- });
112
-
113
- it('타입별로 다른 반감기를 적용한다', () => {
114
- const working = ranking.calculateRecency(
115
- new Date(Date.now() - 1 * 24 * 60 * 60 * 1000),
116
- 'working'
117
- );
118
- const episodic = ranking.calculateRecency(
119
- new Date(Date.now() - 1 * 24 * 60 * 60 * 1000),
120
- 'episodic'
121
- );
122
- const semantic = ranking.calculateRecency(
123
- new Date(Date.now() - 1 * 24 * 60 * 60 * 1000),
124
- 'semantic'
125
- );
126
-
127
- expect(working).toBeLessThan(episodic);
128
- expect(episodic).toBeLessThan(semantic);
129
- });
130
-
131
- it('매우 오래된 기억은 낮은 점수를 받는다', () => {
132
- const veryOld = ranking.calculateRecency(
133
- new Date(Date.now() - 1000 * 24 * 60 * 60 * 1000),
134
- 'semantic'
135
- );
136
- expect(veryOld).toBeLessThan(0.1); // 1000일 전의 기억은 0.1보다 작은 점수
137
- });
138
- });
139
-
140
- describe('calculateImportance', () => {
141
- it('고정된 중요 기억은 부스트를 받아 점수가 상승한다', () => {
142
- const base = ranking.calculateImportance(0.4, false, 'episodic');
143
- const pinned = ranking.calculateImportance(0.4, true, 'episodic');
144
- const semantic = ranking.calculateImportance(0.4, false, 'semantic');
145
-
146
- expect(pinned).toBeGreaterThan(base);
147
- expect(semantic).toBeGreaterThan(base);
148
- expect(pinned).toBeLessThanOrEqual(1);
149
- });
150
-
151
- it('타입별로 다른 부스트를 적용한다', () => {
152
- const working = ranking.calculateImportance(0.5, false, 'working');
153
- const episodic = ranking.calculateImportance(0.5, false, 'episodic');
154
- const semantic = ranking.calculateImportance(0.5, false, 'semantic');
155
- const procedural = ranking.calculateImportance(0.5, false, 'procedural');
156
-
157
- expect(working).toBeLessThan(episodic);
158
- expect(episodic).toBeLessThan(procedural);
159
- expect(procedural).toBeLessThan(semantic);
160
- });
161
-
162
- it('중요도는 0과 1 사이로 제한된다', () => {
163
- const low = ranking.calculateImportance(-0.5, false, 'episodic');
164
- const high = ranking.calculateImportance(1.5, false, 'episodic');
165
-
166
- expect(low).toBeGreaterThanOrEqual(0);
167
- expect(high).toBeLessThanOrEqual(1);
168
- });
169
- });
170
-
171
- describe('calculateUsage', () => {
172
- it('접근 이력이 없는 경우 기본 사용성 점수를 적용한다', () => {
173
- const metrics = { viewCount: 0, citeCount: 0, editCount: 0 };
174
- expect(ranking.calculateUsage(metrics)).toBeCloseTo(0.1, 5);
175
- });
176
-
177
- it('다양한 사용성 메트릭을 올바르게 계산한다', () => {
178
- const metrics = { viewCount: 10, citeCount: 5, editCount: 2 };
179
- const usage = ranking.calculateUsage(metrics);
180
- expect(usage).toBeGreaterThan(0.1);
181
- expect(usage).toBeLessThanOrEqual(1);
182
- });
183
-
184
- it('배치 정규화가 적용된 사용성 점수를 계산한다', () => {
185
- const metrics = { viewCount: 10, citeCount: 5, editCount: 2 };
186
- const usage = ranking.calculateUsage(metrics, 0, 20);
187
- expect(usage).toBeGreaterThanOrEqual(0);
188
- expect(usage).toBeLessThanOrEqual(1);
189
- });
190
-
191
- it('null 입력에 대해 안전하게 처리한다', () => {
192
- const usage = ranking.calculateUsage(null as any);
193
- expect(usage).toBe(0);
194
- });
195
-
196
- it('모든 메트릭이 0인 경우 기본값을 반환한다', () => {
197
- const metrics = { viewCount: 0, citeCount: 0, editCount: 0 };
198
- const usage = ranking.calculateUsage(metrics);
199
- expect(usage).toBeCloseTo(0.1, 5);
200
- });
201
- });
202
-
203
- describe('calculateBatchUsage', () => {
204
- it('여러 메모리에 대한 배치 사용성 점수를 계산한다', () => {
205
- const metricsList = [
206
- { viewCount: 10, citeCount: 5, editCount: 2 },
207
- { viewCount: 20, citeCount: 10, editCount: 4 },
208
- { viewCount: 5, citeCount: 2, editCount: 1 }
209
- ];
210
-
211
- const result = ranking.calculateBatchUsage(metricsList);
212
- expect(result.normalized).toHaveLength(3);
213
- expect(result.min).toBeLessThanOrEqual(result.max);
214
- expect(result.normalized.every(score => score >= 0 && score <= 1)).toBe(true);
215
- });
216
-
217
- it('빈 배열에 대해 안전하게 처리한다', () => {
218
- const result = ranking.calculateBatchUsage([]);
219
- expect(result.normalized).toHaveLength(0);
220
- });
221
- });
222
-
223
- describe('calculateDuplicationPenalty', () => {
224
- it('중복 패널티는 선택된 콘텐츠와의 최대 유사도를 반영한다', () => {
225
- const penalty = ranking.calculateDuplicationPenalty(
226
- 'TypeScript Generic Tutorial',
227
- ['React Hook Guide', 'TypeScript Advanced Generic Tutorial']
228
- );
229
-
230
- expect(penalty).toBeGreaterThan(0);
231
- expect(penalty).toBeLessThan(1);
232
- });
233
-
234
- it('선택된 콘텐츠가 없으면 패널티가 0이다', () => {
235
- const penalty = ranking.calculateDuplicationPenalty(
236
- 'TypeScript Generic Tutorial',
237
- []
238
- );
239
- expect(penalty).toBe(0);
240
- });
241
-
242
- it('완전히 다른 콘텐츠는 낮은 패널티를 받는다', () => {
243
- const penalty = ranking.calculateDuplicationPenalty(
244
- 'React Hook Guide',
245
- ['Python Machine Learning', 'Database Design Patterns']
246
- );
247
- expect(penalty).toBeLessThan(0.5);
248
- });
249
- });
250
-
251
- describe('하위 호환성 메서드들', () => {
252
- it('calculateRelevanceSimple이 올바르게 작동한다', () => {
253
- const relevance = ranking.calculateRelevanceSimple(
254
- 'React Hook',
255
- 'React Hook에 대한 내용',
256
- ['react', 'hook']
257
- );
258
- expect(relevance).toBeGreaterThan(0);
259
- });
260
-
261
- it('calculateUsageSimple이 올바르게 작동한다', () => {
262
- const recentDate = new Date(Date.now() - 1 * 24 * 60 * 60 * 1000);
263
- const usage = ranking.calculateUsageSimple(recentDate);
264
- expect(usage).toBeGreaterThan(0);
265
- });
266
-
267
- it('calculateUsageSimple에서 lastAccessed가 없으면 기본값을 반환한다', () => {
268
- const usage = ranking.calculateUsageSimple(undefined);
269
- expect(usage).toBeCloseTo(0.1, 5);
270
- });
271
- });
272
-
273
- describe('엣지 케이스들', () => {
274
- it('0으로 나누기 상황을 안전하게 처리한다', () => {
275
- const usage = ranking.calculateUsage(
276
- { viewCount: 0, citeCount: 0, editCount: 0 },
277
- 0, 0 // min과 max가 같을 때
278
- );
279
- // rawUsage가 0이므로 기본값 0.1을 반환
280
- expect(usage).toBe(0.1);
281
- });
282
-
283
- it('매우 큰 값들에 대해 안전하게 처리한다', () => {
284
- const relevance = ranking.calculateRelevance({
285
- query: 'a'.repeat(10000),
286
- content: 'b'.repeat(10000),
287
- tags: Array(1000).fill('tag')
288
- });
289
- expect(relevance).toBeGreaterThanOrEqual(0);
290
- expect(relevance).toBeLessThanOrEqual(1);
291
- });
292
- });
293
- });