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
@@ -0,0 +1,68 @@
1
+ /**
2
+ * 벡터 호환성 유틸리티
3
+ * - 차원이 다른 임베딩 벡터를 안전하게 변환
4
+ * - 패딩/축소 전략과 정규화를 일관되게 적용
5
+ */
6
+ import type { EmbeddingProvider, ProjectionType, VectorCompatibilityAssessment, VectorExpansionStrategy, VectorProjectionOptions, VectorProjectionResult, VectorReductionStrategy } from '../types/embedding.types.js';
7
+ interface ProjectionInternalResult {
8
+ vector: number[];
9
+ projectionType: ProjectionType;
10
+ expansionStrategy?: VectorExpansionStrategy;
11
+ reductionStrategy?: VectorReductionStrategy;
12
+ }
13
+ export declare class VectorCompatibilityService {
14
+ private readonly defaultExpansion;
15
+ private readonly defaultReduction;
16
+ private readonly epsilon;
17
+ private readonly defaultDimensions;
18
+ private providerDimensionMap;
19
+ /**
20
+ * 목표 차원에 맞게 벡터를 변환
21
+ */
22
+ project(vector: number[], options: VectorProjectionOptions): VectorProjectionResult;
23
+ /**
24
+ * 벡터 호환성을 분석하고 필요한 투영 정보를 제공
25
+ */
26
+ assessCompatibility(vector: number[], options: VectorProjectionOptions): VectorCompatibilityAssessment;
27
+ /**
28
+ * 호환성 검증 (필요 시 예외 발생)
29
+ */
30
+ validateCompatibility(vector: number[], options: VectorProjectionOptions, allowProjection?: boolean): VectorCompatibilityAssessment;
31
+ /**
32
+ * 제공자별 기본 차원을 적용한 호환성 분석
33
+ */
34
+ assessProviderCompatibility(vector: number[], provider: EmbeddingProvider, overrides?: Partial<VectorProjectionOptions>): VectorCompatibilityAssessment;
35
+ /**
36
+ * 제공자별 차원 검증
37
+ */
38
+ validateProviderCompatibility(vector: number[], provider: EmbeddingProvider, overrides?: Partial<VectorProjectionOptions>, allowProjection?: boolean): VectorCompatibilityAssessment;
39
+ /**
40
+ * 제공자의 기본 차원을 조회
41
+ */
42
+ getNativeDimensions(provider: EmbeddingProvider): number;
43
+ /**
44
+ * 제공자의 기본 차원을 갱신
45
+ */
46
+ setNativeDimensions(provider: EmbeddingProvider, dimensions: number): void;
47
+ private performProjection;
48
+ /**
49
+ * 지정한 전략으로 벡터 차원을 확장
50
+ */
51
+ expandVector(vector: number[], targetDim: number, strategy: VectorExpansionStrategy): ProjectionInternalResult;
52
+ /**
53
+ * 지정한 전략으로 벡터 차원을 축소
54
+ */
55
+ reduceVector(vector: number[], targetDim: number, strategy: VectorReductionStrategy): ProjectionInternalResult;
56
+ private zeroPad;
57
+ private repeatUpsample;
58
+ private interpolate;
59
+ private averagePool;
60
+ private applyNormalization;
61
+ private l2Normalize;
62
+ private minMaxNormalize;
63
+ private sanitizeVector;
64
+ private assertValidOptions;
65
+ }
66
+ export declare const vectorCompatibilityService: VectorCompatibilityService;
67
+ export {};
68
+ //# sourceMappingURL=vector-compatibility-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vector-compatibility-service.d.ts","sourceRoot":"","sources":["../../src/services/vector-compatibility-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,6BAA6B,EAE7B,uBAAuB,EAEvB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAErC,UAAU,wBAAwB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAC5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IACzC,OAAO,CAAC,oBAAoB,CAM1B;IAEF;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,sBAAsB;IAMnF;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,uBAAuB,GAAG,6BAA6B;IAgEtG;;OAEG;IACH,qBAAqB,CACnB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,uBAAuB,EAChC,eAAe,GAAE,OAAc,GAC9B,6BAA6B;IAqBhC;;OAEG;IACH,2BAA2B,CACzB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,6BAA6B;IAiBhC;;OAEG;IACH,6BAA6B,CAC3B,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,EAChD,eAAe,GAAE,OAAc,GAC9B,6BAA6B;IAiBhC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM;IAIxD;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAO1E,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,GAChC,wBAAwB;IA+B3B;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,GAChC,wBAAwB;IAyB3B,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,WAAW;IAwCnB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,kBAAkB;CAW3B;AAED,eAAO,MAAM,0BAA0B,4BAAmC,CAAC"}
@@ -0,0 +1,373 @@
1
+ /**
2
+ * 벡터 호환성 유틸리티
3
+ * - 차원이 다른 임베딩 벡터를 안전하게 변환
4
+ * - 패딩/축소 전략과 정규화를 일관되게 적용
5
+ */
6
+ export class VectorCompatibilityService {
7
+ defaultExpansion = 'zero-pad';
8
+ defaultReduction = 'average-pool';
9
+ epsilon = 1e-9;
10
+ defaultDimensions = 384;
11
+ providerDimensionMap = {
12
+ tfidf: 384,
13
+ lightweight: 384,
14
+ minilm: 384,
15
+ openai: 1536,
16
+ gemini: 768
17
+ };
18
+ /**
19
+ * 목표 차원에 맞게 벡터를 변환
20
+ */
21
+ project(vector, options) {
22
+ this.assertValidOptions(vector, options);
23
+ const sanitized = this.sanitizeVector(vector);
24
+ return this.performProjection(sanitized, options);
25
+ }
26
+ /**
27
+ * 벡터 호환성을 분석하고 필요한 투영 정보를 제공
28
+ */
29
+ assessCompatibility(vector, options) {
30
+ this.assertValidOptions(vector, options);
31
+ const sanitized = this.sanitizeVector(vector);
32
+ const expectedDimensions = options.targetDimensions;
33
+ const issues = [];
34
+ if (sanitized.length === 0) {
35
+ issues.push({
36
+ code: 'empty_vector',
37
+ message: '벡터가 비어 있습니다',
38
+ severity: 'error'
39
+ });
40
+ }
41
+ const hasNonFinite = vector.some(value => !Number.isFinite(value));
42
+ if (hasNonFinite) {
43
+ issues.push({
44
+ code: 'non_finite_values',
45
+ message: '비유한 값이 포함되어 0으로 보정되었습니다',
46
+ severity: 'warning'
47
+ });
48
+ }
49
+ const projection = this.performProjection(sanitized, options);
50
+ const needsProjection = projection.projectionType !== 'native' ||
51
+ projection.sourceDimensions !== projection.targetDimensions;
52
+ if (needsProjection) {
53
+ issues.push({
54
+ code: 'dimension_mismatch',
55
+ message: `벡터 차원(${projection.sourceDimensions})이 기대 차원(${expectedDimensions})과 일치하지 않습니다`,
56
+ severity: 'error'
57
+ });
58
+ }
59
+ const isZeroVector = projection.vector.every(value => Math.abs(value) <= this.epsilon);
60
+ if (!needsProjection && sanitized.length > 0 && isZeroVector) {
61
+ issues.push({
62
+ code: 'zero_vector',
63
+ message: '모든 요소가 0에 가까워 유사도 계산에 영향을 줄 수 있습니다',
64
+ severity: 'warning'
65
+ });
66
+ }
67
+ const blockingIssues = issues.filter(issue => {
68
+ if (issue.severity !== 'error') {
69
+ return false;
70
+ }
71
+ return issue.code !== 'dimension_mismatch';
72
+ });
73
+ const isCompatible = !needsProjection && blockingIssues.length === 0;
74
+ return {
75
+ isCompatible,
76
+ needsProjection,
77
+ issues,
78
+ actualDimensions: projection.sourceDimensions,
79
+ expectedDimensions,
80
+ projection
81
+ };
82
+ }
83
+ /**
84
+ * 호환성 검증 (필요 시 예외 발생)
85
+ */
86
+ validateCompatibility(vector, options, allowProjection = true) {
87
+ const assessment = this.assessCompatibility(vector, options);
88
+ const blockingIssues = assessment.issues.filter(issue => {
89
+ if (issue.severity !== 'error') {
90
+ return false;
91
+ }
92
+ if (issue.code === 'dimension_mismatch') {
93
+ return !allowProjection;
94
+ }
95
+ return true;
96
+ });
97
+ if (blockingIssues.length > 0) {
98
+ const messages = blockingIssues.map(issue => issue.message).join(', ');
99
+ throw new Error(`벡터 호환성 검증 실패: ${messages}`);
100
+ }
101
+ return assessment;
102
+ }
103
+ /**
104
+ * 제공자별 기본 차원을 적용한 호환성 분석
105
+ */
106
+ assessProviderCompatibility(vector, provider, overrides = {}) {
107
+ const targetDimensions = overrides.targetDimensions ?? this.getNativeDimensions(provider);
108
+ const options = {
109
+ targetDimensions,
110
+ expansionStrategy: overrides.expansionStrategy,
111
+ reductionStrategy: overrides.reductionStrategy,
112
+ normalization: overrides.normalization
113
+ };
114
+ const assessment = this.assessCompatibility(vector, options);
115
+ return {
116
+ ...assessment,
117
+ provider
118
+ };
119
+ }
120
+ /**
121
+ * 제공자별 차원 검증
122
+ */
123
+ validateProviderCompatibility(vector, provider, overrides = {}, allowProjection = true) {
124
+ const targetDimensions = overrides.targetDimensions ?? this.getNativeDimensions(provider);
125
+ const options = {
126
+ targetDimensions,
127
+ expansionStrategy: overrides.expansionStrategy,
128
+ reductionStrategy: overrides.reductionStrategy,
129
+ normalization: overrides.normalization
130
+ };
131
+ const assessment = this.validateCompatibility(vector, options, allowProjection);
132
+ return {
133
+ ...assessment,
134
+ provider
135
+ };
136
+ }
137
+ /**
138
+ * 제공자의 기본 차원을 조회
139
+ */
140
+ getNativeDimensions(provider) {
141
+ return this.providerDimensionMap[provider] ?? this.defaultDimensions;
142
+ }
143
+ /**
144
+ * 제공자의 기본 차원을 갱신
145
+ */
146
+ setNativeDimensions(provider, dimensions) {
147
+ if (!Number.isInteger(dimensions) || dimensions <= 0) {
148
+ throw new Error('차원은 0보다 큰 정수여야 합니다');
149
+ }
150
+ this.providerDimensionMap[provider] = dimensions;
151
+ }
152
+ performProjection(sanitized, options) {
153
+ const targetDim = options.targetDimensions;
154
+ const sourceDim = sanitized.length;
155
+ let transformed = {
156
+ vector: sanitized.slice(),
157
+ projectionType: 'native'
158
+ };
159
+ if (sourceDim < targetDim) {
160
+ transformed = this.expandVector(sanitized, targetDim, options.expansionStrategy ?? this.defaultExpansion);
161
+ }
162
+ else if (sourceDim > targetDim) {
163
+ transformed = this.reduceVector(sanitized, targetDim, options.reductionStrategy ?? this.defaultReduction);
164
+ }
165
+ const normalizedVector = this.applyNormalization(transformed.vector, options.normalization ?? 'none');
166
+ return {
167
+ vector: normalizedVector,
168
+ sourceDimensions: sourceDim,
169
+ targetDimensions: targetDim,
170
+ projectionType: transformed.projectionType,
171
+ normalized: (options.normalization ?? 'none') !== 'none',
172
+ expansionStrategy: transformed.expansionStrategy,
173
+ reductionStrategy: transformed.reductionStrategy
174
+ };
175
+ }
176
+ /**
177
+ * 지정한 전략으로 벡터 차원을 확장
178
+ */
179
+ expandVector(vector, targetDim, strategy) {
180
+ if (vector.length >= targetDim) {
181
+ return {
182
+ vector: vector.slice(0, targetDim),
183
+ projectionType: vector.length === targetDim ? 'native' : 'truncate'
184
+ };
185
+ }
186
+ switch (strategy) {
187
+ case 'repeat':
188
+ return {
189
+ vector: this.repeatUpsample(vector, targetDim),
190
+ projectionType: 'repeat_upsample',
191
+ expansionStrategy: strategy
192
+ };
193
+ case 'interpolate':
194
+ return {
195
+ vector: this.interpolate(vector, targetDim),
196
+ projectionType: 'interpolate',
197
+ expansionStrategy: strategy
198
+ };
199
+ case 'zero-pad':
200
+ default:
201
+ return {
202
+ vector: this.zeroPad(vector, targetDim),
203
+ projectionType: 'zero_pad',
204
+ expansionStrategy: 'zero-pad'
205
+ };
206
+ }
207
+ }
208
+ /**
209
+ * 지정한 전략으로 벡터 차원을 축소
210
+ */
211
+ reduceVector(vector, targetDim, strategy) {
212
+ if (vector.length <= targetDim) {
213
+ return {
214
+ vector: vector.slice(),
215
+ projectionType: vector.length === targetDim ? 'native' : 'zero_pad'
216
+ };
217
+ }
218
+ switch (strategy) {
219
+ case 'truncate':
220
+ return {
221
+ vector: vector.slice(0, targetDim),
222
+ projectionType: 'truncate',
223
+ reductionStrategy: strategy
224
+ };
225
+ case 'average-pool':
226
+ default:
227
+ return {
228
+ vector: this.averagePool(vector, targetDim),
229
+ projectionType: 'average_pool',
230
+ reductionStrategy: 'average-pool'
231
+ };
232
+ }
233
+ }
234
+ zeroPad(vector, targetDim) {
235
+ if (targetDim <= 0) {
236
+ return [];
237
+ }
238
+ const result = new Array(targetDim);
239
+ for (let i = 0; i < targetDim; i++) {
240
+ result[i] = i < vector.length ? (vector[i] ?? 0) : 0;
241
+ }
242
+ return result;
243
+ }
244
+ repeatUpsample(vector, targetDim) {
245
+ if (targetDim <= 0) {
246
+ return [];
247
+ }
248
+ if (vector.length === 0) {
249
+ return new Array(targetDim).fill(0);
250
+ }
251
+ const result = new Array(targetDim);
252
+ for (let i = 0; i < targetDim; i++) {
253
+ const value = vector[i % vector.length];
254
+ result[i] = value !== undefined ? value : 0;
255
+ }
256
+ return result;
257
+ }
258
+ interpolate(vector, targetDim) {
259
+ if (vector.length === 0) {
260
+ return new Array(targetDim).fill(0);
261
+ }
262
+ if (vector.length === 1) {
263
+ return new Array(targetDim).fill(vector[0] ?? 0);
264
+ }
265
+ const result = new Array(targetDim);
266
+ const lastIndex = vector.length - 1;
267
+ for (let i = 0; i < targetDim; i++) {
268
+ if (targetDim === 1) {
269
+ result[i] = vector[0] ?? 0;
270
+ continue;
271
+ }
272
+ const position = (i * lastIndex) / (targetDim - 1);
273
+ const leftIndex = Math.floor(position);
274
+ const rightIndex = Math.min(leftIndex + 1, lastIndex);
275
+ const ratio = position - leftIndex;
276
+ if (rightIndex === leftIndex) {
277
+ result[i] = vector[leftIndex] ?? 0;
278
+ }
279
+ else {
280
+ const left = vector[leftIndex] ?? 0;
281
+ const right = vector[rightIndex] ?? 0;
282
+ result[i] = left + (right - left) * ratio;
283
+ }
284
+ }
285
+ return result;
286
+ }
287
+ averagePool(vector, targetDim) {
288
+ if (targetDim <= 0) {
289
+ return [];
290
+ }
291
+ if (vector.length === 0) {
292
+ return new Array(targetDim).fill(0);
293
+ }
294
+ const result = new Array(targetDim);
295
+ const ratio = vector.length / targetDim;
296
+ for (let i = 0; i < targetDim; i++) {
297
+ const start = i * ratio;
298
+ const end = (i + 1) * ratio;
299
+ const startIndex = Math.floor(start);
300
+ const endIndex = Math.min(Math.ceil(end), vector.length);
301
+ if (endIndex <= startIndex) {
302
+ result[i] = vector[Math.min(startIndex, vector.length - 1)] ?? 0;
303
+ continue;
304
+ }
305
+ let sum = 0;
306
+ let weight = 0;
307
+ for (let idx = startIndex; idx < endIndex; idx++) {
308
+ const segmentStart = Math.max(start, idx);
309
+ const segmentEnd = Math.min(end, idx + 1);
310
+ const segmentWeight = segmentEnd - segmentStart;
311
+ const value = vector[idx] ?? 0;
312
+ sum += value * segmentWeight;
313
+ weight += segmentWeight;
314
+ }
315
+ result[i] = weight > this.epsilon ? sum / weight : 0;
316
+ }
317
+ return result;
318
+ }
319
+ applyNormalization(vector, mode) {
320
+ switch (mode) {
321
+ case 'l2':
322
+ return this.l2Normalize(vector);
323
+ case 'min-max':
324
+ return this.minMaxNormalize(vector);
325
+ case 'none':
326
+ default:
327
+ return vector.slice();
328
+ }
329
+ }
330
+ l2Normalize(vector) {
331
+ const norm = Math.sqrt(vector.reduce((sum, value) => sum + value * value, 0));
332
+ if (norm <= this.epsilon) {
333
+ return vector.slice();
334
+ }
335
+ return vector.map(value => value / norm);
336
+ }
337
+ minMaxNormalize(vector) {
338
+ let min = Number.POSITIVE_INFINITY;
339
+ let max = Number.NEGATIVE_INFINITY;
340
+ for (const value of vector) {
341
+ if (value < min) {
342
+ min = value;
343
+ }
344
+ if (value > max) {
345
+ max = value;
346
+ }
347
+ }
348
+ const range = max - min;
349
+ if (Math.abs(range) <= this.epsilon) {
350
+ return new Array(vector.length).fill(0);
351
+ }
352
+ return vector.map(value => (value - min) / range);
353
+ }
354
+ sanitizeVector(vector) {
355
+ if (!Array.isArray(vector)) {
356
+ throw new Error('벡터는 배열이어야 합니다');
357
+ }
358
+ return vector.map(value => (Number.isFinite(value) ? value : 0));
359
+ }
360
+ assertValidOptions(vector, options) {
361
+ if (!Array.isArray(vector)) {
362
+ throw new Error('벡터는 배열이어야 합니다');
363
+ }
364
+ if (!options || !Number.isInteger(options.targetDimensions)) {
365
+ throw new Error('targetDimensions는 정수여야 합니다');
366
+ }
367
+ if (options.targetDimensions <= 0) {
368
+ throw new Error('targetDimensions는 0보다 커야 합니다');
369
+ }
370
+ }
371
+ }
372
+ export const vectorCompatibilityService = new VectorCompatibilityService();
373
+ //# sourceMappingURL=vector-compatibility-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vector-compatibility-service.js","sourceRoot":"","sources":["../../src/services/vector-compatibility-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * 벡터 인덱스 관리 서비스
3
+ * 단일 책임 원칙(SRP) 적용 - 인덱스 관리만 담당
4
+ */
5
+ import type { VectorIndexStatus } from '../../types/vector-search.types';
6
+ import type { VectorIndexRepository } from '../../interfaces/database.interface';
7
+ export declare class VectorIndexManager {
8
+ private repository;
9
+ constructor(repository: VectorIndexRepository);
10
+ /**
11
+ * 인덱스 상태 확인
12
+ */
13
+ getIndexStatus(): VectorIndexStatus;
14
+ /**
15
+ * 인덱스 재구성
16
+ */
17
+ rebuildIndex(): Promise<boolean>;
18
+ /**
19
+ * VEC 사용 가능 여부 확인
20
+ */
21
+ isAvailable(): boolean;
22
+ /**
23
+ * 인덱스 상태 요약
24
+ */
25
+ getStatusSummary(): string;
26
+ }
27
+ //# sourceMappingURL=vector-index-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vector-index-manager.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-index-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,qBAAa,kBAAkB;IACjB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,qBAAqB;IAErD;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAenC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAYtC;;OAEG;IACH,WAAW,IAAI,OAAO;IAStB;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAO3B"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * 벡터 인덱스 관리 서비스
3
+ * 단일 책임 원칙(SRP) 적용 - 인덱스 관리만 담당
4
+ */
5
+ export class VectorIndexManager {
6
+ repository;
7
+ constructor(repository) {
8
+ this.repository = repository;
9
+ }
10
+ /**
11
+ * 인덱스 상태 확인
12
+ */
13
+ getIndexStatus() {
14
+ try {
15
+ return this.repository.getIndexStatus();
16
+ }
17
+ catch (error) {
18
+ console.error('인덱스 상태 확인 실패:', error);
19
+ return {
20
+ available: false,
21
+ tableExists: false,
22
+ recordCount: 0,
23
+ dimensions: 384,
24
+ vecExtensionLoaded: false
25
+ };
26
+ }
27
+ }
28
+ /**
29
+ * 인덱스 재구성
30
+ */
31
+ async rebuildIndex() {
32
+ try {
33
+ console.log('🔄 벡터 인덱스 재구성 시작...');
34
+ const result = await this.repository.rebuildIndex();
35
+ console.log('✅ 벡터 인덱스 재구성 완료');
36
+ return result;
37
+ }
38
+ catch (error) {
39
+ console.error('❌ 벡터 인덱스 재구성 실패:', error);
40
+ return false;
41
+ }
42
+ }
43
+ /**
44
+ * VEC 사용 가능 여부 확인
45
+ */
46
+ isAvailable() {
47
+ try {
48
+ return this.repository.checkAvailability();
49
+ }
50
+ catch (error) {
51
+ console.error('VEC 가용성 확인 실패:', error);
52
+ return false;
53
+ }
54
+ }
55
+ /**
56
+ * 인덱스 상태 요약
57
+ */
58
+ getStatusSummary() {
59
+ const status = this.getIndexStatus();
60
+ return `VEC 상태: ${status.available ? '사용가능' : '사용불가'} | ` +
61
+ `테이블: ${status.tableExists ? '존재' : '없음'} | ` +
62
+ `레코드: ${status.recordCount}개 | ` +
63
+ `차원: ${status.dimensions}`;
64
+ }
65
+ }
66
+ //# sourceMappingURL=vector-index-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vector-index-manager.js","sourceRoot":"","sources":["../../../src/services/vector-search/vector-index-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,UAAiC;QAAjC,eAAU,GAAV,UAAU,CAAuB;IAAG,CAAC;IAEzD;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACtC,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,KAAK;gBAClB,WAAW,EAAE,CAAC;gBACd,UAAU,EAAE,GAAG;gBACf,kBAAkB,EAAE,KAAK;aAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACrC,OAAO,WAAW,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK;YAClD,QAAQ,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK;YAC7C,QAAQ,MAAM,CAAC,WAAW,MAAM;YAChC,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IACpC,CAAC;CACF"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * 벡터 성능 테스트 서비스
3
+ * 단일 책임 원칙(SRP) 적용 - 성능 테스트만 담당
4
+ */
5
+ import type { PerformanceTestResult } from '../../types/vector-search.types';
6
+ import type { VectorPerformanceRepository } from '../../interfaces/database.interface';
7
+ export declare class VectorPerformanceTester {
8
+ private repository;
9
+ constructor(repository: VectorPerformanceRepository);
10
+ /**
11
+ * 성능 테스트 실행
12
+ */
13
+ runPerformanceTest(queryVector: number[], iterations?: number): Promise<PerformanceTestResult>;
14
+ /**
15
+ * 벡터 차원 검증
16
+ */
17
+ private validateTestParameters;
18
+ /**
19
+ * 성능 테스트 결과 분석
20
+ */
21
+ analyzeResults(result: PerformanceTestResult): {
22
+ performance: 'excellent' | 'good' | 'fair' | 'poor';
23
+ recommendations: string[];
24
+ };
25
+ /**
26
+ * 성능 테스트 리포트 생성
27
+ */
28
+ generateReport(result: PerformanceTestResult): string;
29
+ }
30
+ //# sourceMappingURL=vector-performance-tester.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vector-performance-tester.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-performance-tester.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGvF,qBAAa,uBAAuB;IACtB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,2BAA2B;IAE3D;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,GAAE,MAAsD,GACjE,OAAO,CAAC,qBAAqB,CAAC;IAiBjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG;QAC7C,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;QACpD,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAwBD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;CAiBtD"}