@ninebix/nmt-system 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (639) hide show
  1. package/LICENSE +70 -0
  2. package/README.md +465 -0
  3. package/dist/api/cli-server.d.ts +83 -0
  4. package/dist/api/cli-server.d.ts.map +1 -0
  5. package/dist/api/cli-server.js +597 -0
  6. package/dist/api/cli-server.js.map +1 -0
  7. package/dist/api/index.d.ts +6 -0
  8. package/dist/api/index.d.ts.map +1 -0
  9. package/dist/api/index.js +6 -0
  10. package/dist/api/index.js.map +1 -0
  11. package/dist/api/middleware/index.d.ts +12 -0
  12. package/dist/api/middleware/index.d.ts.map +1 -0
  13. package/dist/api/middleware/index.js +13 -0
  14. package/dist/api/middleware/index.js.map +1 -0
  15. package/dist/api/middleware/logger.d.ts +21 -0
  16. package/dist/api/middleware/logger.d.ts.map +1 -0
  17. package/dist/api/middleware/logger.js +134 -0
  18. package/dist/api/middleware/logger.js.map +1 -0
  19. package/dist/api/middleware/rate-limit.d.ts +26 -0
  20. package/dist/api/middleware/rate-limit.d.ts.map +1 -0
  21. package/dist/api/middleware/rate-limit.js +107 -0
  22. package/dist/api/middleware/rate-limit.js.map +1 -0
  23. package/dist/api/middleware/response.d.ts +61 -0
  24. package/dist/api/middleware/response.d.ts.map +1 -0
  25. package/dist/api/middleware/response.js +86 -0
  26. package/dist/api/middleware/response.js.map +1 -0
  27. package/dist/api/middleware/validation.d.ts +43 -0
  28. package/dist/api/middleware/validation.d.ts.map +1 -0
  29. package/dist/api/middleware/validation.js +257 -0
  30. package/dist/api/middleware/validation.js.map +1 -0
  31. package/dist/api/server.d.ts +79 -0
  32. package/dist/api/server.d.ts.map +1 -0
  33. package/dist/api/server.js +2011 -0
  34. package/dist/api/server.js.map +1 -0
  35. package/dist/bin/nmt.d.ts +9 -0
  36. package/dist/bin/nmt.d.ts.map +1 -0
  37. package/dist/bin/nmt.js +1142 -0
  38. package/dist/bin/nmt.js.map +1 -0
  39. package/dist/cli/commands/attractor.d.ts +6 -0
  40. package/dist/cli/commands/attractor.d.ts.map +1 -0
  41. package/dist/cli/commands/attractor.js +167 -0
  42. package/dist/cli/commands/attractor.js.map +1 -0
  43. package/dist/cli/commands/dimension.d.ts +6 -0
  44. package/dist/cli/commands/dimension.d.ts.map +1 -0
  45. package/dist/cli/commands/dimension.js +85 -0
  46. package/dist/cli/commands/dimension.js.map +1 -0
  47. package/dist/cli/commands/index.d.ts +11 -0
  48. package/dist/cli/commands/index.d.ts.map +1 -0
  49. package/dist/cli/commands/index.js +11 -0
  50. package/dist/cli/commands/index.js.map +1 -0
  51. package/dist/cli/commands/infer.d.ts +6 -0
  52. package/dist/cli/commands/infer.d.ts.map +1 -0
  53. package/dist/cli/commands/infer.js +139 -0
  54. package/dist/cli/commands/infer.js.map +1 -0
  55. package/dist/cli/commands/learn.d.ts +6 -0
  56. package/dist/cli/commands/learn.d.ts.map +1 -0
  57. package/dist/cli/commands/learn.js +87 -0
  58. package/dist/cli/commands/learn.js.map +1 -0
  59. package/dist/cli/commands/orchestrate.d.ts +6 -0
  60. package/dist/cli/commands/orchestrate.d.ts.map +1 -0
  61. package/dist/cli/commands/orchestrate.js +279 -0
  62. package/dist/cli/commands/orchestrate.js.map +1 -0
  63. package/dist/cli/commands/prob.d.ts +6 -0
  64. package/dist/cli/commands/prob.d.ts.map +1 -0
  65. package/dist/cli/commands/prob.js +256 -0
  66. package/dist/cli/commands/prob.js.map +1 -0
  67. package/dist/cli/commands/quantum.d.ts +6 -0
  68. package/dist/cli/commands/quantum.d.ts.map +1 -0
  69. package/dist/cli/commands/quantum.js +150 -0
  70. package/dist/cli/commands/quantum.js.map +1 -0
  71. package/dist/cli/commands/sync.d.ts +65 -0
  72. package/dist/cli/commands/sync.d.ts.map +1 -0
  73. package/dist/cli/commands/sync.js +338 -0
  74. package/dist/cli/commands/sync.js.map +1 -0
  75. package/dist/cli/index.d.ts +9 -0
  76. package/dist/cli/index.d.ts.map +1 -0
  77. package/dist/cli/index.js +9 -0
  78. package/dist/cli/index.js.map +1 -0
  79. package/dist/cli/probabilistic-commands.d.ts +39 -0
  80. package/dist/cli/probabilistic-commands.d.ts.map +1 -0
  81. package/dist/cli/probabilistic-commands.js +112 -0
  82. package/dist/cli/probabilistic-commands.js.map +1 -0
  83. package/dist/cli/types.d.ts +69 -0
  84. package/dist/cli/types.d.ts.map +1 -0
  85. package/dist/cli/types.js +5 -0
  86. package/dist/cli/types.js.map +1 -0
  87. package/dist/cli/utils/formatters.d.ts +51 -0
  88. package/dist/cli/utils/formatters.d.ts.map +1 -0
  89. package/dist/cli/utils/formatters.js +79 -0
  90. package/dist/cli/utils/formatters.js.map +1 -0
  91. package/dist/cli/utils/helpers.d.ts +21 -0
  92. package/dist/cli/utils/helpers.d.ts.map +1 -0
  93. package/dist/cli/utils/helpers.js +51 -0
  94. package/dist/cli/utils/helpers.js.map +1 -0
  95. package/dist/cli/utils/index.d.ts +7 -0
  96. package/dist/cli/utils/index.d.ts.map +1 -0
  97. package/dist/cli/utils/index.js +13 -0
  98. package/dist/cli/utils/index.js.map +1 -0
  99. package/dist/cli/utils/validators.d.ts +162 -0
  100. package/dist/cli/utils/validators.d.ts.map +1 -0
  101. package/dist/cli/utils/validators.js +351 -0
  102. package/dist/cli/utils/validators.js.map +1 -0
  103. package/dist/core/advanced-embedding.d.ts +154 -0
  104. package/dist/core/advanced-embedding.d.ts.map +1 -0
  105. package/dist/core/advanced-embedding.js +367 -0
  106. package/dist/core/advanced-embedding.js.map +1 -0
  107. package/dist/core/attractor-model.d.ts +381 -0
  108. package/dist/core/attractor-model.d.ts.map +1 -0
  109. package/dist/core/attractor-model.js +821 -0
  110. package/dist/core/attractor-model.js.map +1 -0
  111. package/dist/core/bidirectional-inference.d.ts +143 -0
  112. package/dist/core/bidirectional-inference.d.ts.map +1 -0
  113. package/dist/core/bidirectional-inference.js +501 -0
  114. package/dist/core/bidirectional-inference.js.map +1 -0
  115. package/dist/core/chunk-engine.d.ts +78 -0
  116. package/dist/core/chunk-engine.d.ts.map +1 -0
  117. package/dist/core/chunk-engine.js +192 -0
  118. package/dist/core/chunk-engine.js.map +1 -0
  119. package/dist/core/dynamic-embedding.d.ts +327 -0
  120. package/dist/core/dynamic-embedding.d.ts.map +1 -0
  121. package/dist/core/dynamic-embedding.js +527 -0
  122. package/dist/core/dynamic-embedding.js.map +1 -0
  123. package/dist/core/embedding-similarity.d.ts +68 -0
  124. package/dist/core/embedding-similarity.d.ts.map +1 -0
  125. package/dist/core/embedding-similarity.js +291 -0
  126. package/dist/core/embedding-similarity.js.map +1 -0
  127. package/dist/core/evolution-scheduler.d.ts +101 -0
  128. package/dist/core/evolution-scheduler.d.ts.map +1 -0
  129. package/dist/core/evolution-scheduler.js +235 -0
  130. package/dist/core/evolution-scheduler.js.map +1 -0
  131. package/dist/core/hierarchical-chunker.d.ts +108 -0
  132. package/dist/core/hierarchical-chunker.d.ts.map +1 -0
  133. package/dist/core/hierarchical-chunker.js +296 -0
  134. package/dist/core/hierarchical-chunker.js.map +1 -0
  135. package/dist/core/hnsw-index.d.ts +111 -0
  136. package/dist/core/hnsw-index.d.ts.map +1 -0
  137. package/dist/core/hnsw-index.js +466 -0
  138. package/dist/core/hnsw-index.js.map +1 -0
  139. package/dist/core/index.d.ts +23 -0
  140. package/dist/core/index.d.ts.map +1 -0
  141. package/dist/core/index.js +25 -0
  142. package/dist/core/index.js.map +1 -0
  143. package/dist/core/language-analyzers.d.ts +124 -0
  144. package/dist/core/language-analyzers.d.ts.map +1 -0
  145. package/dist/core/language-analyzers.js +365 -0
  146. package/dist/core/language-analyzers.js.map +1 -0
  147. package/dist/core/local-embedding.d.ts +109 -0
  148. package/dist/core/local-embedding.d.ts.map +1 -0
  149. package/dist/core/local-embedding.js +222 -0
  150. package/dist/core/local-embedding.js.map +1 -0
  151. package/dist/core/merkle-engine.d.ts +263 -0
  152. package/dist/core/merkle-engine.d.ts.map +1 -0
  153. package/dist/core/merkle-engine.js +528 -0
  154. package/dist/core/merkle-engine.js.map +1 -0
  155. package/dist/core/multi-layer-reasoning.d.ts +178 -0
  156. package/dist/core/multi-layer-reasoning.d.ts.map +1 -0
  157. package/dist/core/multi-layer-reasoning.js +607 -0
  158. package/dist/core/multi-layer-reasoning.js.map +1 -0
  159. package/dist/core/neuron-graph.d.ts +134 -0
  160. package/dist/core/neuron-graph.d.ts.map +1 -0
  161. package/dist/core/neuron-graph.js +436 -0
  162. package/dist/core/neuron-graph.js.map +1 -0
  163. package/dist/core/probabilistic-neuron.d.ts +251 -0
  164. package/dist/core/probabilistic-neuron.d.ts.map +1 -0
  165. package/dist/core/probabilistic-neuron.js +618 -0
  166. package/dist/core/probabilistic-neuron.js.map +1 -0
  167. package/dist/core/probabilistic-orchestrator.d.ts +408 -0
  168. package/dist/core/probabilistic-orchestrator.d.ts.map +1 -0
  169. package/dist/core/probabilistic-orchestrator.js +798 -0
  170. package/dist/core/probabilistic-orchestrator.js.map +1 -0
  171. package/dist/core/semantic-chunker.d.ts +117 -0
  172. package/dist/core/semantic-chunker.d.ts.map +1 -0
  173. package/dist/core/semantic-chunker.js +464 -0
  174. package/dist/core/semantic-chunker.js.map +1 -0
  175. package/dist/events/event-bus.d.ts +166 -0
  176. package/dist/events/event-bus.d.ts.map +1 -0
  177. package/dist/events/event-bus.js +228 -0
  178. package/dist/events/event-bus.js.map +1 -0
  179. package/dist/events/index.d.ts +7 -0
  180. package/dist/events/index.d.ts.map +1 -0
  181. package/dist/events/index.js +7 -0
  182. package/dist/events/index.js.map +1 -0
  183. package/dist/events/progress-tracker.d.ts +150 -0
  184. package/dist/events/progress-tracker.d.ts.map +1 -0
  185. package/dist/events/progress-tracker.js +290 -0
  186. package/dist/events/progress-tracker.js.map +1 -0
  187. package/dist/extensions/clustering/community-detection.d.ts +90 -0
  188. package/dist/extensions/clustering/community-detection.d.ts.map +1 -0
  189. package/dist/extensions/clustering/community-detection.js +470 -0
  190. package/dist/extensions/clustering/community-detection.js.map +1 -0
  191. package/dist/extensions/clustering/index.d.ts +114 -0
  192. package/dist/extensions/clustering/index.d.ts.map +1 -0
  193. package/dist/extensions/clustering/index.js +468 -0
  194. package/dist/extensions/clustering/index.js.map +1 -0
  195. package/dist/extensions/clustering/topic-modeling.d.ts +86 -0
  196. package/dist/extensions/clustering/topic-modeling.d.ts.map +1 -0
  197. package/dist/extensions/clustering/topic-modeling.js +355 -0
  198. package/dist/extensions/clustering/topic-modeling.js.map +1 -0
  199. package/dist/extensions/distributed/coordinator.d.ts +114 -0
  200. package/dist/extensions/distributed/coordinator.d.ts.map +1 -0
  201. package/dist/extensions/distributed/coordinator.js +319 -0
  202. package/dist/extensions/distributed/coordinator.js.map +1 -0
  203. package/dist/extensions/distributed/index.d.ts +10 -0
  204. package/dist/extensions/distributed/index.d.ts.map +1 -0
  205. package/dist/extensions/distributed/index.js +10 -0
  206. package/dist/extensions/distributed/index.js.map +1 -0
  207. package/dist/extensions/distributed/queue.d.ts +157 -0
  208. package/dist/extensions/distributed/queue.d.ts.map +1 -0
  209. package/dist/extensions/distributed/queue.js +326 -0
  210. package/dist/extensions/distributed/queue.js.map +1 -0
  211. package/dist/extensions/distributed/scheduler.d.ts +107 -0
  212. package/dist/extensions/distributed/scheduler.d.ts.map +1 -0
  213. package/dist/extensions/distributed/scheduler.js +301 -0
  214. package/dist/extensions/distributed/scheduler.js.map +1 -0
  215. package/dist/extensions/distributed/worker.d.ts +112 -0
  216. package/dist/extensions/distributed/worker.d.ts.map +1 -0
  217. package/dist/extensions/distributed/worker.js +260 -0
  218. package/dist/extensions/distributed/worker.js.map +1 -0
  219. package/dist/index.d.ts +14 -0
  220. package/dist/index.d.ts.map +1 -0
  221. package/dist/index.js +20 -0
  222. package/dist/index.js.map +1 -0
  223. package/dist/mcp/server.d.ts +43 -0
  224. package/dist/mcp/server.d.ts.map +1 -0
  225. package/dist/mcp/server.js +494 -0
  226. package/dist/mcp/server.js.map +1 -0
  227. package/dist/services/adaptive-fallback.d.ts +140 -0
  228. package/dist/services/adaptive-fallback.d.ts.map +1 -0
  229. package/dist/services/adaptive-fallback.js +273 -0
  230. package/dist/services/adaptive-fallback.js.map +1 -0
  231. package/dist/services/answer-gate.d.ts +112 -0
  232. package/dist/services/answer-gate.d.ts.map +1 -0
  233. package/dist/services/answer-gate.js +299 -0
  234. package/dist/services/answer-gate.js.map +1 -0
  235. package/dist/services/auto-learning.d.ts +135 -0
  236. package/dist/services/auto-learning.d.ts.map +1 -0
  237. package/dist/services/auto-learning.js +413 -0
  238. package/dist/services/auto-learning.js.map +1 -0
  239. package/dist/services/context-compressor.d.ts +77 -0
  240. package/dist/services/context-compressor.d.ts.map +1 -0
  241. package/dist/services/context-compressor.js +234 -0
  242. package/dist/services/context-compressor.js.map +1 -0
  243. package/dist/services/efficient-rag.d.ts +140 -0
  244. package/dist/services/efficient-rag.d.ts.map +1 -0
  245. package/dist/services/efficient-rag.js +311 -0
  246. package/dist/services/efficient-rag.js.map +1 -0
  247. package/dist/services/embedding-provider.d.ts +72 -0
  248. package/dist/services/embedding-provider.d.ts.map +1 -0
  249. package/dist/services/embedding-provider.js +176 -0
  250. package/dist/services/embedding-provider.js.map +1 -0
  251. package/dist/services/file-ingestion.d.ts +72 -0
  252. package/dist/services/file-ingestion.d.ts.map +1 -0
  253. package/dist/services/file-ingestion.js +237 -0
  254. package/dist/services/file-ingestion.js.map +1 -0
  255. package/dist/services/four-stage-learning.d.ts +552 -0
  256. package/dist/services/four-stage-learning.d.ts.map +1 -0
  257. package/dist/services/four-stage-learning.js +1110 -0
  258. package/dist/services/four-stage-learning.js.map +1 -0
  259. package/dist/services/graph.d.ts +94 -0
  260. package/dist/services/graph.d.ts.map +1 -0
  261. package/dist/services/graph.js +292 -0
  262. package/dist/services/graph.js.map +1 -0
  263. package/dist/services/index.d.ts +15 -0
  264. package/dist/services/index.d.ts.map +1 -0
  265. package/dist/services/index.js +18 -0
  266. package/dist/services/index.js.map +1 -0
  267. package/dist/services/ingestion.d.ts +98 -0
  268. package/dist/services/ingestion.d.ts.map +1 -0
  269. package/dist/services/ingestion.js +259 -0
  270. package/dist/services/ingestion.js.map +1 -0
  271. package/dist/services/learning.d.ts +67 -0
  272. package/dist/services/learning.d.ts.map +1 -0
  273. package/dist/services/learning.js +262 -0
  274. package/dist/services/learning.js.map +1 -0
  275. package/dist/services/llm-router.d.ts +143 -0
  276. package/dist/services/llm-router.d.ts.map +1 -0
  277. package/dist/services/llm-router.js +284 -0
  278. package/dist/services/llm-router.js.map +1 -0
  279. package/dist/services/llm.d.ts +86 -0
  280. package/dist/services/llm.d.ts.map +1 -0
  281. package/dist/services/llm.js +283 -0
  282. package/dist/services/llm.js.map +1 -0
  283. package/dist/services/metrics-dashboard.d.ts +262 -0
  284. package/dist/services/metrics-dashboard.d.ts.map +1 -0
  285. package/dist/services/metrics-dashboard.js +417 -0
  286. package/dist/services/metrics-dashboard.js.map +1 -0
  287. package/dist/services/neuron-lifecycle.d.ts +137 -0
  288. package/dist/services/neuron-lifecycle.d.ts.map +1 -0
  289. package/dist/services/neuron-lifecycle.js +422 -0
  290. package/dist/services/neuron-lifecycle.js.map +1 -0
  291. package/dist/services/nmt-pipeline.d.ts +219 -0
  292. package/dist/services/nmt-pipeline.d.ts.map +1 -0
  293. package/dist/services/nmt-pipeline.js +449 -0
  294. package/dist/services/nmt-pipeline.js.map +1 -0
  295. package/dist/services/query-cache.d.ts +136 -0
  296. package/dist/services/query-cache.d.ts.map +1 -0
  297. package/dist/services/query-cache.js +255 -0
  298. package/dist/services/query-cache.js.map +1 -0
  299. package/dist/services/query-normalize.d.ts +107 -0
  300. package/dist/services/query-normalize.d.ts.map +1 -0
  301. package/dist/services/query-normalize.js +366 -0
  302. package/dist/services/query-normalize.js.map +1 -0
  303. package/dist/services/query.d.ts +102 -0
  304. package/dist/services/query.d.ts.map +1 -0
  305. package/dist/services/query.js +227 -0
  306. package/dist/services/query.js.map +1 -0
  307. package/dist/services/text-embedding.d.ts +183 -0
  308. package/dist/services/text-embedding.d.ts.map +1 -0
  309. package/dist/services/text-embedding.js +633 -0
  310. package/dist/services/text-embedding.js.map +1 -0
  311. package/dist/services/verification-gate.d.ts +147 -0
  312. package/dist/services/verification-gate.d.ts.map +1 -0
  313. package/dist/services/verification-gate.js +344 -0
  314. package/dist/services/verification-gate.js.map +1 -0
  315. package/dist/services/verify.d.ts +114 -0
  316. package/dist/services/verify.d.ts.map +1 -0
  317. package/dist/services/verify.js +237 -0
  318. package/dist/services/verify.js.map +1 -0
  319. package/dist/services/web-search.d.ts +145 -0
  320. package/dist/services/web-search.d.ts.map +1 -0
  321. package/dist/services/web-search.js +534 -0
  322. package/dist/services/web-search.js.map +1 -0
  323. package/dist/src/api/cli-server.d.ts +83 -0
  324. package/dist/src/api/cli-server.d.ts.map +1 -0
  325. package/dist/src/api/cli-server.js +597 -0
  326. package/dist/src/api/cli-server.js.map +1 -0
  327. package/dist/src/api/index.d.ts +6 -0
  328. package/dist/src/api/index.d.ts.map +1 -0
  329. package/dist/src/api/index.js +6 -0
  330. package/dist/src/api/index.js.map +1 -0
  331. package/dist/src/cli/commands/attractor.d.ts +6 -0
  332. package/dist/src/cli/commands/attractor.d.ts.map +1 -0
  333. package/dist/src/cli/commands/attractor.js +167 -0
  334. package/dist/src/cli/commands/attractor.js.map +1 -0
  335. package/dist/src/cli/commands/dimension.d.ts +6 -0
  336. package/dist/src/cli/commands/dimension.d.ts.map +1 -0
  337. package/dist/src/cli/commands/dimension.js +85 -0
  338. package/dist/src/cli/commands/dimension.js.map +1 -0
  339. package/dist/src/cli/commands/index.d.ts +11 -0
  340. package/dist/src/cli/commands/index.d.ts.map +1 -0
  341. package/dist/src/cli/commands/index.js +11 -0
  342. package/dist/src/cli/commands/index.js.map +1 -0
  343. package/dist/src/cli/commands/infer.d.ts +6 -0
  344. package/dist/src/cli/commands/infer.d.ts.map +1 -0
  345. package/dist/src/cli/commands/infer.js +139 -0
  346. package/dist/src/cli/commands/infer.js.map +1 -0
  347. package/dist/src/cli/commands/learn.d.ts +6 -0
  348. package/dist/src/cli/commands/learn.d.ts.map +1 -0
  349. package/dist/src/cli/commands/learn.js +87 -0
  350. package/dist/src/cli/commands/learn.js.map +1 -0
  351. package/dist/src/cli/commands/orchestrate.d.ts +6 -0
  352. package/dist/src/cli/commands/orchestrate.d.ts.map +1 -0
  353. package/dist/src/cli/commands/orchestrate.js +279 -0
  354. package/dist/src/cli/commands/orchestrate.js.map +1 -0
  355. package/dist/src/cli/commands/prob.d.ts +6 -0
  356. package/dist/src/cli/commands/prob.d.ts.map +1 -0
  357. package/dist/src/cli/commands/prob.js +256 -0
  358. package/dist/src/cli/commands/prob.js.map +1 -0
  359. package/dist/src/cli/commands/sync.d.ts +65 -0
  360. package/dist/src/cli/commands/sync.d.ts.map +1 -0
  361. package/dist/src/cli/commands/sync.js +338 -0
  362. package/dist/src/cli/commands/sync.js.map +1 -0
  363. package/dist/src/cli/index.d.ts +9 -0
  364. package/dist/src/cli/index.d.ts.map +1 -0
  365. package/dist/src/cli/index.js +9 -0
  366. package/dist/src/cli/index.js.map +1 -0
  367. package/dist/src/cli/probabilistic-commands.d.ts +39 -0
  368. package/dist/src/cli/probabilistic-commands.d.ts.map +1 -0
  369. package/dist/src/cli/probabilistic-commands.js +112 -0
  370. package/dist/src/cli/probabilistic-commands.js.map +1 -0
  371. package/dist/src/cli/types.d.ts +69 -0
  372. package/dist/src/cli/types.d.ts.map +1 -0
  373. package/dist/src/cli/types.js +5 -0
  374. package/dist/src/cli/types.js.map +1 -0
  375. package/dist/src/cli/utils/formatters.d.ts +51 -0
  376. package/dist/src/cli/utils/formatters.d.ts.map +1 -0
  377. package/dist/src/cli/utils/formatters.js +79 -0
  378. package/dist/src/cli/utils/formatters.js.map +1 -0
  379. package/dist/src/cli/utils/helpers.d.ts +21 -0
  380. package/dist/src/cli/utils/helpers.d.ts.map +1 -0
  381. package/dist/src/cli/utils/helpers.js +51 -0
  382. package/dist/src/cli/utils/helpers.js.map +1 -0
  383. package/dist/src/cli/utils/index.d.ts +7 -0
  384. package/dist/src/cli/utils/index.d.ts.map +1 -0
  385. package/dist/src/cli/utils/index.js +13 -0
  386. package/dist/src/cli/utils/index.js.map +1 -0
  387. package/dist/src/cli/utils/validators.d.ts +162 -0
  388. package/dist/src/cli/utils/validators.d.ts.map +1 -0
  389. package/dist/src/cli/utils/validators.js +351 -0
  390. package/dist/src/cli/utils/validators.js.map +1 -0
  391. package/dist/src/core/attractor-model.d.ts +381 -0
  392. package/dist/src/core/attractor-model.d.ts.map +1 -0
  393. package/dist/src/core/attractor-model.js +821 -0
  394. package/dist/src/core/attractor-model.js.map +1 -0
  395. package/dist/src/core/bidirectional-inference.d.ts +143 -0
  396. package/dist/src/core/bidirectional-inference.d.ts.map +1 -0
  397. package/dist/src/core/bidirectional-inference.js +501 -0
  398. package/dist/src/core/bidirectional-inference.js.map +1 -0
  399. package/dist/src/core/chunk-engine.d.ts +78 -0
  400. package/dist/src/core/chunk-engine.d.ts.map +1 -0
  401. package/dist/src/core/chunk-engine.js +192 -0
  402. package/dist/src/core/chunk-engine.js.map +1 -0
  403. package/dist/src/core/dynamic-embedding.d.ts +327 -0
  404. package/dist/src/core/dynamic-embedding.d.ts.map +1 -0
  405. package/dist/src/core/dynamic-embedding.js +527 -0
  406. package/dist/src/core/dynamic-embedding.js.map +1 -0
  407. package/dist/src/core/evolution-scheduler.d.ts +101 -0
  408. package/dist/src/core/evolution-scheduler.d.ts.map +1 -0
  409. package/dist/src/core/evolution-scheduler.js +235 -0
  410. package/dist/src/core/evolution-scheduler.js.map +1 -0
  411. package/dist/src/core/hnsw-index.d.ts +111 -0
  412. package/dist/src/core/hnsw-index.d.ts.map +1 -0
  413. package/dist/src/core/hnsw-index.js +466 -0
  414. package/dist/src/core/hnsw-index.js.map +1 -0
  415. package/dist/src/core/index.d.ts +23 -0
  416. package/dist/src/core/index.d.ts.map +1 -0
  417. package/dist/src/core/index.js +25 -0
  418. package/dist/src/core/index.js.map +1 -0
  419. package/dist/src/core/merkle-engine.d.ts +263 -0
  420. package/dist/src/core/merkle-engine.d.ts.map +1 -0
  421. package/dist/src/core/merkle-engine.js +528 -0
  422. package/dist/src/core/merkle-engine.js.map +1 -0
  423. package/dist/src/core/neuron-graph.d.ts +134 -0
  424. package/dist/src/core/neuron-graph.d.ts.map +1 -0
  425. package/dist/src/core/neuron-graph.js +436 -0
  426. package/dist/src/core/neuron-graph.js.map +1 -0
  427. package/dist/src/core/probabilistic-neuron.d.ts +251 -0
  428. package/dist/src/core/probabilistic-neuron.d.ts.map +1 -0
  429. package/dist/src/core/probabilistic-neuron.js +618 -0
  430. package/dist/src/core/probabilistic-neuron.js.map +1 -0
  431. package/dist/src/core/probabilistic-orchestrator.d.ts +408 -0
  432. package/dist/src/core/probabilistic-orchestrator.d.ts.map +1 -0
  433. package/dist/src/core/probabilistic-orchestrator.js +798 -0
  434. package/dist/src/core/probabilistic-orchestrator.js.map +1 -0
  435. package/dist/src/events/event-bus.d.ts +166 -0
  436. package/dist/src/events/event-bus.d.ts.map +1 -0
  437. package/dist/src/events/event-bus.js +228 -0
  438. package/dist/src/events/event-bus.js.map +1 -0
  439. package/dist/src/events/index.d.ts +7 -0
  440. package/dist/src/events/index.d.ts.map +1 -0
  441. package/dist/src/events/index.js +7 -0
  442. package/dist/src/events/index.js.map +1 -0
  443. package/dist/src/events/progress-tracker.d.ts +150 -0
  444. package/dist/src/events/progress-tracker.d.ts.map +1 -0
  445. package/dist/src/events/progress-tracker.js +290 -0
  446. package/dist/src/events/progress-tracker.js.map +1 -0
  447. package/dist/src/extensions/clustering/index.d.ts +114 -0
  448. package/dist/src/extensions/clustering/index.d.ts.map +1 -0
  449. package/dist/src/extensions/clustering/index.js +468 -0
  450. package/dist/src/extensions/clustering/index.js.map +1 -0
  451. package/dist/src/index.d.ts +14 -0
  452. package/dist/src/index.d.ts.map +1 -0
  453. package/dist/src/index.js +20 -0
  454. package/dist/src/index.js.map +1 -0
  455. package/dist/src/mcp/server.d.ts +43 -0
  456. package/dist/src/mcp/server.d.ts.map +1 -0
  457. package/dist/src/mcp/server.js +494 -0
  458. package/dist/src/mcp/server.js.map +1 -0
  459. package/dist/src/services/embedding-provider.d.ts +72 -0
  460. package/dist/src/services/embedding-provider.d.ts.map +1 -0
  461. package/dist/src/services/embedding-provider.js +176 -0
  462. package/dist/src/services/embedding-provider.js.map +1 -0
  463. package/dist/src/services/four-stage-learning.d.ts +552 -0
  464. package/dist/src/services/four-stage-learning.d.ts.map +1 -0
  465. package/dist/src/services/four-stage-learning.js +1110 -0
  466. package/dist/src/services/four-stage-learning.js.map +1 -0
  467. package/dist/src/services/index.d.ts +15 -0
  468. package/dist/src/services/index.d.ts.map +1 -0
  469. package/dist/src/services/index.js +18 -0
  470. package/dist/src/services/index.js.map +1 -0
  471. package/dist/src/services/ingestion.d.ts +98 -0
  472. package/dist/src/services/ingestion.d.ts.map +1 -0
  473. package/dist/src/services/ingestion.js +259 -0
  474. package/dist/src/services/ingestion.js.map +1 -0
  475. package/dist/src/services/query.d.ts +102 -0
  476. package/dist/src/services/query.d.ts.map +1 -0
  477. package/dist/src/services/query.js +227 -0
  478. package/dist/src/services/query.js.map +1 -0
  479. package/dist/src/services/text-embedding.d.ts +183 -0
  480. package/dist/src/services/text-embedding.d.ts.map +1 -0
  481. package/dist/src/services/text-embedding.js +633 -0
  482. package/dist/src/services/text-embedding.js.map +1 -0
  483. package/dist/src/services/verify.d.ts +114 -0
  484. package/dist/src/services/verify.d.ts.map +1 -0
  485. package/dist/src/services/verify.js +237 -0
  486. package/dist/src/services/verify.js.map +1 -0
  487. package/dist/src/storage/chunk-store.d.ts +107 -0
  488. package/dist/src/storage/chunk-store.d.ts.map +1 -0
  489. package/dist/src/storage/chunk-store.js +293 -0
  490. package/dist/src/storage/chunk-store.js.map +1 -0
  491. package/dist/src/storage/index-store.d.ts +126 -0
  492. package/dist/src/storage/index-store.d.ts.map +1 -0
  493. package/dist/src/storage/index-store.js +316 -0
  494. package/dist/src/storage/index-store.js.map +1 -0
  495. package/dist/src/storage/index.d.ts +45 -0
  496. package/dist/src/storage/index.d.ts.map +1 -0
  497. package/dist/src/storage/index.js +52 -0
  498. package/dist/src/storage/index.js.map +1 -0
  499. package/dist/src/storage/neuron-store.d.ts +121 -0
  500. package/dist/src/storage/neuron-store.d.ts.map +1 -0
  501. package/dist/src/storage/neuron-store.js +466 -0
  502. package/dist/src/storage/neuron-store.js.map +1 -0
  503. package/dist/src/storage/probabilistic-store.d.ts +104 -0
  504. package/dist/src/storage/probabilistic-store.d.ts.map +1 -0
  505. package/dist/src/storage/probabilistic-store.js +257 -0
  506. package/dist/src/storage/probabilistic-store.js.map +1 -0
  507. package/dist/src/sync/change-journal.d.ts +171 -0
  508. package/dist/src/sync/change-journal.d.ts.map +1 -0
  509. package/dist/src/sync/change-journal.js +362 -0
  510. package/dist/src/sync/change-journal.js.map +1 -0
  511. package/dist/src/sync/index.d.ts +8 -0
  512. package/dist/src/sync/index.d.ts.map +1 -0
  513. package/dist/src/sync/index.js +8 -0
  514. package/dist/src/sync/index.js.map +1 -0
  515. package/dist/src/sync/state-sync.d.ts +241 -0
  516. package/dist/src/sync/state-sync.d.ts.map +1 -0
  517. package/dist/src/sync/state-sync.js +396 -0
  518. package/dist/src/sync/state-sync.js.map +1 -0
  519. package/dist/src/sync/vector-clock.d.ts +144 -0
  520. package/dist/src/sync/vector-clock.d.ts.map +1 -0
  521. package/dist/src/sync/vector-clock.js +266 -0
  522. package/dist/src/sync/vector-clock.js.map +1 -0
  523. package/dist/src/types/index.d.ts +224 -0
  524. package/dist/src/types/index.d.ts.map +1 -0
  525. package/dist/src/types/index.js +24 -0
  526. package/dist/src/types/index.js.map +1 -0
  527. package/dist/src/utils/hash.d.ts +39 -0
  528. package/dist/src/utils/hash.d.ts.map +1 -0
  529. package/dist/src/utils/hash.js +56 -0
  530. package/dist/src/utils/hash.js.map +1 -0
  531. package/dist/src/utils/index.d.ts +26 -0
  532. package/dist/src/utils/index.d.ts.map +1 -0
  533. package/dist/src/utils/index.js +50 -0
  534. package/dist/src/utils/index.js.map +1 -0
  535. package/dist/src/utils/logger.d.ts +88 -0
  536. package/dist/src/utils/logger.d.ts.map +1 -0
  537. package/dist/src/utils/logger.js +157 -0
  538. package/dist/src/utils/logger.js.map +1 -0
  539. package/dist/src/utils/metrics.d.ts +232 -0
  540. package/dist/src/utils/metrics.d.ts.map +1 -0
  541. package/dist/src/utils/metrics.js +387 -0
  542. package/dist/src/utils/metrics.js.map +1 -0
  543. package/dist/src/utils/similarity.d.ts +64 -0
  544. package/dist/src/utils/similarity.d.ts.map +1 -0
  545. package/dist/src/utils/similarity.js +151 -0
  546. package/dist/src/utils/similarity.js.map +1 -0
  547. package/dist/src/utils/uuid.d.ts +23 -0
  548. package/dist/src/utils/uuid.d.ts.map +1 -0
  549. package/dist/src/utils/uuid.js +29 -0
  550. package/dist/src/utils/uuid.js.map +1 -0
  551. package/dist/storage/chunk-store.d.ts +107 -0
  552. package/dist/storage/chunk-store.d.ts.map +1 -0
  553. package/dist/storage/chunk-store.js +293 -0
  554. package/dist/storage/chunk-store.js.map +1 -0
  555. package/dist/storage/hybrid-adapters.d.ts +111 -0
  556. package/dist/storage/hybrid-adapters.d.ts.map +1 -0
  557. package/dist/storage/hybrid-adapters.js +223 -0
  558. package/dist/storage/hybrid-adapters.js.map +1 -0
  559. package/dist/storage/hybrid-store.d.ts +125 -0
  560. package/dist/storage/hybrid-store.d.ts.map +1 -0
  561. package/dist/storage/hybrid-store.js +655 -0
  562. package/dist/storage/hybrid-store.js.map +1 -0
  563. package/dist/storage/index-store.d.ts +126 -0
  564. package/dist/storage/index-store.d.ts.map +1 -0
  565. package/dist/storage/index-store.js +316 -0
  566. package/dist/storage/index-store.js.map +1 -0
  567. package/dist/storage/index.d.ts +45 -0
  568. package/dist/storage/index.d.ts.map +1 -0
  569. package/dist/storage/index.js +52 -0
  570. package/dist/storage/index.js.map +1 -0
  571. package/dist/storage/neuron-store.d.ts +121 -0
  572. package/dist/storage/neuron-store.d.ts.map +1 -0
  573. package/dist/storage/neuron-store.js +466 -0
  574. package/dist/storage/neuron-store.js.map +1 -0
  575. package/dist/storage/ontology-store.d.ts +132 -0
  576. package/dist/storage/ontology-store.d.ts.map +1 -0
  577. package/dist/storage/ontology-store.js +319 -0
  578. package/dist/storage/ontology-store.js.map +1 -0
  579. package/dist/storage/probabilistic-store.d.ts +104 -0
  580. package/dist/storage/probabilistic-store.d.ts.map +1 -0
  581. package/dist/storage/probabilistic-store.js +257 -0
  582. package/dist/storage/probabilistic-store.js.map +1 -0
  583. package/dist/storage/redis-adapters.d.ts +102 -0
  584. package/dist/storage/redis-adapters.d.ts.map +1 -0
  585. package/dist/storage/redis-adapters.js +205 -0
  586. package/dist/storage/redis-adapters.js.map +1 -0
  587. package/dist/storage/redis-ontology-store.d.ts +146 -0
  588. package/dist/storage/redis-ontology-store.d.ts.map +1 -0
  589. package/dist/storage/redis-ontology-store.js +384 -0
  590. package/dist/storage/redis-ontology-store.js.map +1 -0
  591. package/dist/storage/redis-store.d.ts +174 -0
  592. package/dist/storage/redis-store.d.ts.map +1 -0
  593. package/dist/storage/redis-store.js +506 -0
  594. package/dist/storage/redis-store.js.map +1 -0
  595. package/dist/sync/change-journal.d.ts +171 -0
  596. package/dist/sync/change-journal.d.ts.map +1 -0
  597. package/dist/sync/change-journal.js +362 -0
  598. package/dist/sync/change-journal.js.map +1 -0
  599. package/dist/sync/index.d.ts +8 -0
  600. package/dist/sync/index.d.ts.map +1 -0
  601. package/dist/sync/index.js +8 -0
  602. package/dist/sync/index.js.map +1 -0
  603. package/dist/sync/state-sync.d.ts +241 -0
  604. package/dist/sync/state-sync.d.ts.map +1 -0
  605. package/dist/sync/state-sync.js +396 -0
  606. package/dist/sync/state-sync.js.map +1 -0
  607. package/dist/sync/vector-clock.d.ts +144 -0
  608. package/dist/sync/vector-clock.d.ts.map +1 -0
  609. package/dist/sync/vector-clock.js +266 -0
  610. package/dist/sync/vector-clock.js.map +1 -0
  611. package/dist/types/index.d.ts +224 -0
  612. package/dist/types/index.d.ts.map +1 -0
  613. package/dist/types/index.js +24 -0
  614. package/dist/types/index.js.map +1 -0
  615. package/dist/utils/hash.d.ts +39 -0
  616. package/dist/utils/hash.d.ts.map +1 -0
  617. package/dist/utils/hash.js +56 -0
  618. package/dist/utils/hash.js.map +1 -0
  619. package/dist/utils/index.d.ts +26 -0
  620. package/dist/utils/index.d.ts.map +1 -0
  621. package/dist/utils/index.js +50 -0
  622. package/dist/utils/index.js.map +1 -0
  623. package/dist/utils/logger.d.ts +88 -0
  624. package/dist/utils/logger.d.ts.map +1 -0
  625. package/dist/utils/logger.js +157 -0
  626. package/dist/utils/logger.js.map +1 -0
  627. package/dist/utils/metrics.d.ts +232 -0
  628. package/dist/utils/metrics.d.ts.map +1 -0
  629. package/dist/utils/metrics.js +387 -0
  630. package/dist/utils/metrics.js.map +1 -0
  631. package/dist/utils/similarity.d.ts +64 -0
  632. package/dist/utils/similarity.d.ts.map +1 -0
  633. package/dist/utils/similarity.js +151 -0
  634. package/dist/utils/similarity.js.map +1 -0
  635. package/dist/utils/uuid.d.ts +23 -0
  636. package/dist/utils/uuid.d.ts.map +1 -0
  637. package/dist/utils/uuid.js +29 -0
  638. package/dist/utils/uuid.js.map +1 -0
  639. package/package.json +72 -0
@@ -0,0 +1,422 @@
1
+ /**
2
+ * Neuron Lifecycle Service
3
+ * Fact vs Transient 분류 및 TTL 기반 생명주기 관리
4
+ *
5
+ * 설계 문서: NMT_Updated.md 4.1절
6
+ * - Fact Neuron: 장기 재사용 지식 (정책/스펙/규칙/검증된 해결책/템플릿)
7
+ * - Transient Neuron: 일회성 대화/시도 로그/잡담/임시 상태
8
+ * - Transient는 TTL(만료) 또는 저장 금지/요약 저장만 허용
9
+ *
10
+ * @module services/neuron-lifecycle
11
+ */
12
+ /**
13
+ * Fact 분류 키워드 패턴
14
+ */
15
+ const FACT_PATTERNS = [
16
+ // 정책/규칙
17
+ /정책|규칙|규정|지침|가이드|policy|rule|guideline/gi,
18
+ // 스펙/문서
19
+ /스펙|명세|문서|도큐먼트|spec|documentation/gi,
20
+ // 정의/개념
21
+ /정의|개념|원리|이론|definition|concept|principle/gi,
22
+ // 해결책/솔루션
23
+ /해결|솔루션|solution|fix|workaround/gi,
24
+ // 템플릿/패턴
25
+ /템플릿|패턴|boilerplate|template|pattern/gi,
26
+ // API/인터페이스
27
+ /api|인터페이스|endpoint|interface/gi,
28
+ // 설정/구성
29
+ /설정|구성|config|configuration/gi,
30
+ ];
31
+ /**
32
+ * Transient 분류 키워드 패턴
33
+ */
34
+ const TRANSIENT_PATTERNS = [
35
+ // 대화/잡담
36
+ /안녕|반가워|감사|고마워|hello|hi|thanks|bye/gi,
37
+ // 일시적 상태
38
+ /지금|현재|오늘|방금|임시|temp|now|current|today/gi,
39
+ // 디버깅/로그
40
+ /디버그|로그|테스트|debug|log|test/gi,
41
+ // 질문/확인
42
+ /맞나요|인가요|할까요|어때요|\?$/gi,
43
+ // 시도/실험
44
+ /시도|실험|해보|try|experiment/gi,
45
+ ];
46
+ /**
47
+ * Fact 소스 타입
48
+ */
49
+ const FACT_SOURCE_TYPES = new Set([
50
+ 'document',
51
+ 'specification',
52
+ 'policy',
53
+ 'api_doc',
54
+ 'tutorial',
55
+ 'reference',
56
+ 'code',
57
+ 'template'
58
+ ]);
59
+ /**
60
+ * Transient 소스 타입
61
+ */
62
+ const TRANSIENT_SOURCE_TYPES = new Set([
63
+ 'conversation',
64
+ 'chat',
65
+ 'debug',
66
+ 'log',
67
+ 'temp',
68
+ 'experiment',
69
+ 'draft'
70
+ ]);
71
+ /**
72
+ * Neuron Lifecycle Manager
73
+ */
74
+ export class NeuronLifecycleManager {
75
+ policy;
76
+ gcTimer = null;
77
+ // 콜백 함수들 (외부에서 주입)
78
+ getNeuron = null;
79
+ updateNeuron = null;
80
+ deleteNeuron = null;
81
+ getAllNeuronIds = null;
82
+ // 통계
83
+ stats = {
84
+ totalClassifications: 0,
85
+ factCount: 0,
86
+ transientCount: 0,
87
+ promotions: 0,
88
+ demotions: 0,
89
+ gcRuns: 0,
90
+ totalExpired: 0
91
+ };
92
+ constructor(policy = {}) {
93
+ this.policy = {
94
+ defaultTransientTTL: policy.defaultTransientTTL ?? 24 * 60 * 60 * 1000, // 24시간
95
+ minFactAccessCount: policy.minFactAccessCount ?? 3,
96
+ inactivityThreshold: policy.inactivityThreshold ?? 7 * 24 * 60 * 60 * 1000, // 7일
97
+ autoPromoteAccessCount: policy.autoPromoteAccessCount ?? 5,
98
+ gcInterval: policy.gcInterval ?? 60 * 60 * 1000, // 1시간
99
+ maxTransientRatio: policy.maxTransientRatio ?? 0.3
100
+ };
101
+ }
102
+ /**
103
+ * 스토어 콜백 설정
104
+ */
105
+ setStoreCallbacks(callbacks) {
106
+ this.getNeuron = callbacks.getNeuron;
107
+ this.updateNeuron = callbacks.updateNeuron;
108
+ this.deleteNeuron = callbacks.deleteNeuron;
109
+ this.getAllNeuronIds = callbacks.getAllNeuronIds;
110
+ }
111
+ /**
112
+ * 콘텐츠 기반 자동 분류
113
+ */
114
+ classify(content, sourceType, tags) {
115
+ this.stats.totalClassifications++;
116
+ let factScore = 0;
117
+ let transientScore = 0;
118
+ const reasons = [];
119
+ // 1. 소스 타입 체크
120
+ if (sourceType) {
121
+ if (FACT_SOURCE_TYPES.has(sourceType.toLowerCase())) {
122
+ factScore += 0.4;
123
+ reasons.push(`소스 타입: ${sourceType} (Fact)`);
124
+ }
125
+ if (TRANSIENT_SOURCE_TYPES.has(sourceType.toLowerCase())) {
126
+ transientScore += 0.4;
127
+ reasons.push(`소스 타입: ${sourceType} (Transient)`);
128
+ }
129
+ }
130
+ // 2. 태그 체크
131
+ if (tags) {
132
+ const factTags = tags.filter(t => /정책|규칙|스펙|문서|api|설정|fact|permanent/.test(t.toLowerCase()));
133
+ const transientTags = tags.filter(t => /임시|temp|draft|test|chat|log/.test(t.toLowerCase()));
134
+ if (factTags.length > 0) {
135
+ factScore += 0.2 * factTags.length;
136
+ reasons.push(`Fact 태그: ${factTags.join(', ')}`);
137
+ }
138
+ if (transientTags.length > 0) {
139
+ transientScore += 0.2 * transientTags.length;
140
+ reasons.push(`Transient 태그: ${transientTags.join(', ')}`);
141
+ }
142
+ }
143
+ // 3. 콘텐츠 패턴 분석
144
+ for (const pattern of FACT_PATTERNS) {
145
+ if (pattern.test(content)) {
146
+ factScore += 0.1;
147
+ }
148
+ }
149
+ for (const pattern of TRANSIENT_PATTERNS) {
150
+ if (pattern.test(content)) {
151
+ transientScore += 0.1;
152
+ }
153
+ }
154
+ // 4. 콘텐츠 길이 고려
155
+ const contentLength = content.length;
156
+ if (contentLength > 500) {
157
+ factScore += 0.1;
158
+ reasons.push('긴 콘텐츠 (>500자)');
159
+ }
160
+ if (contentLength < 50) {
161
+ transientScore += 0.1;
162
+ reasons.push('짧은 콘텐츠 (<50자)');
163
+ }
164
+ // 5. 최종 결정
165
+ const totalScore = factScore + transientScore;
166
+ const confidence = totalScore > 0
167
+ ? Math.max(factScore, transientScore) / totalScore
168
+ : 0.5;
169
+ const type = factScore >= transientScore ? 'fact' : 'transient';
170
+ if (type === 'fact') {
171
+ this.stats.factCount++;
172
+ }
173
+ else {
174
+ this.stats.transientCount++;
175
+ }
176
+ return {
177
+ type,
178
+ confidence,
179
+ reason: reasons.join('; ') || '기본 분류',
180
+ suggestedTTL: type === 'transient' ? this.policy.defaultTransientTTL : undefined,
181
+ suggestedImportance: type === 'fact' ? 0.7 : 0.3
182
+ };
183
+ }
184
+ /**
185
+ * 뉴런 메타데이터에 분류 적용
186
+ */
187
+ applyClassification(metadata, classification) {
188
+ const now = Date.now();
189
+ return {
190
+ ...metadata,
191
+ neuronType: classification.type,
192
+ importance: classification.suggestedImportance,
193
+ ttl: classification.suggestedTTL,
194
+ expiresAt: classification.type === 'transient' && classification.suggestedTTL
195
+ ? now + classification.suggestedTTL
196
+ : undefined
197
+ };
198
+ }
199
+ /**
200
+ * Transient → Fact 승격
201
+ */
202
+ async promoteToFact(neuronId) {
203
+ if (!this.getNeuron || !this.updateNeuron) {
204
+ throw new Error('Store callbacks not set');
205
+ }
206
+ const neuron = await this.getNeuron(neuronId);
207
+ if (!neuron)
208
+ return false;
209
+ await this.updateNeuron(neuronId, {
210
+ metadata: {
211
+ ...neuron.metadata,
212
+ neuronType: 'fact',
213
+ ttl: undefined,
214
+ expiresAt: undefined,
215
+ importance: Math.max(neuron.metadata.importance ?? 0.5, 0.7),
216
+ updatedAt: new Date().toISOString()
217
+ }
218
+ });
219
+ this.stats.promotions++;
220
+ return true;
221
+ }
222
+ /**
223
+ * Fact → Transient 강등
224
+ */
225
+ async demoteToTransient(neuronId, ttl) {
226
+ if (!this.getNeuron || !this.updateNeuron) {
227
+ throw new Error('Store callbacks not set');
228
+ }
229
+ const neuron = await this.getNeuron(neuronId);
230
+ if (!neuron)
231
+ return false;
232
+ const effectiveTTL = ttl ?? this.policy.defaultTransientTTL;
233
+ const now = Date.now();
234
+ await this.updateNeuron(neuronId, {
235
+ metadata: {
236
+ ...neuron.metadata,
237
+ neuronType: 'transient',
238
+ ttl: effectiveTTL,
239
+ expiresAt: now + effectiveTTL,
240
+ importance: Math.min(neuron.metadata.importance ?? 0.5, 0.3),
241
+ updatedAt: new Date().toISOString()
242
+ }
243
+ });
244
+ this.stats.demotions++;
245
+ return true;
246
+ }
247
+ /**
248
+ * TTL 연장
249
+ */
250
+ async extendTTL(neuronId, additionalTTL) {
251
+ if (!this.getNeuron || !this.updateNeuron) {
252
+ throw new Error('Store callbacks not set');
253
+ }
254
+ const neuron = await this.getNeuron(neuronId);
255
+ if (!neuron || neuron.metadata.neuronType !== 'transient')
256
+ return false;
257
+ const currentExpiry = neuron.metadata.expiresAt ?? Date.now();
258
+ const newExpiry = currentExpiry + additionalTTL;
259
+ await this.updateNeuron(neuronId, {
260
+ metadata: {
261
+ ...neuron.metadata,
262
+ expiresAt: newExpiry,
263
+ ttl: (neuron.metadata.ttl ?? 0) + additionalTTL,
264
+ updatedAt: new Date().toISOString()
265
+ }
266
+ });
267
+ return true;
268
+ }
269
+ /**
270
+ * 만료 확인
271
+ */
272
+ isExpired(neuron) {
273
+ if (neuron.metadata.neuronType !== 'transient')
274
+ return false;
275
+ if (!neuron.metadata.expiresAt)
276
+ return false;
277
+ return Date.now() > neuron.metadata.expiresAt;
278
+ }
279
+ /**
280
+ * 자동 승격 체크
281
+ */
282
+ shouldAutoPromote(neuron) {
283
+ if (neuron.metadata.neuronType !== 'transient')
284
+ return false;
285
+ return neuron.metadata.accessCount >= this.policy.autoPromoteAccessCount;
286
+ }
287
+ /**
288
+ * 비활성 체크 (Fact 강등 후보)
289
+ */
290
+ isInactive(neuron) {
291
+ if (neuron.metadata.neuronType !== 'fact')
292
+ return false;
293
+ if (neuron.metadata.accessCount >= this.policy.minFactAccessCount)
294
+ return false;
295
+ const lastAccessed = new Date(neuron.metadata.lastAccessed).getTime();
296
+ return Date.now() - lastAccessed > this.policy.inactivityThreshold;
297
+ }
298
+ /**
299
+ * GC 실행
300
+ */
301
+ async runGC() {
302
+ if (!this.getAllNeuronIds || !this.getNeuron || !this.deleteNeuron || !this.updateNeuron) {
303
+ throw new Error('Store callbacks not set');
304
+ }
305
+ const startTime = Date.now();
306
+ this.stats.gcRuns++;
307
+ const result = {
308
+ scannedCount: 0,
309
+ expiredCount: 0,
310
+ promotedCount: 0,
311
+ demotedCount: 0,
312
+ freedBytes: 0,
313
+ durationMs: 0
314
+ };
315
+ try {
316
+ const allIds = await this.getAllNeuronIds();
317
+ result.scannedCount = allIds.length;
318
+ for (const id of allIds) {
319
+ const neuron = await this.getNeuron(id);
320
+ if (!neuron)
321
+ continue;
322
+ // 1. 만료된 Transient 삭제
323
+ if (this.isExpired(neuron)) {
324
+ await this.deleteNeuron(id);
325
+ result.expiredCount++;
326
+ result.freedBytes += this.estimateNeuronSize(neuron);
327
+ this.stats.totalExpired++;
328
+ continue;
329
+ }
330
+ // 2. 자동 승격 체크
331
+ if (this.shouldAutoPromote(neuron)) {
332
+ await this.promoteToFact(id);
333
+ result.promotedCount++;
334
+ continue;
335
+ }
336
+ // 3. 비활성 Fact 강등 체크
337
+ if (this.isInactive(neuron)) {
338
+ await this.demoteToTransient(id);
339
+ result.demotedCount++;
340
+ }
341
+ }
342
+ }
343
+ catch (error) {
344
+ console.error('[NeuronLifecycle] GC error:', error);
345
+ }
346
+ result.durationMs = Date.now() - startTime;
347
+ return result;
348
+ }
349
+ /**
350
+ * 뉴런 크기 추정
351
+ */
352
+ estimateNeuronSize(neuron) {
353
+ let size = 0;
354
+ // Embedding (384 * 4 bytes)
355
+ size += neuron.embedding.byteLength;
356
+ // Chunk hashes
357
+ size += neuron.chunkHashes.join('').length * 2;
358
+ // Merkle root
359
+ size += neuron.merkleRoot.length * 2;
360
+ // Metadata (JSON 추정)
361
+ size += JSON.stringify(neuron.metadata).length;
362
+ return size;
363
+ }
364
+ /**
365
+ * 자동 GC 시작
366
+ */
367
+ startAutoGC() {
368
+ if (this.gcTimer)
369
+ return;
370
+ this.gcTimer = setInterval(async () => {
371
+ try {
372
+ const result = await this.runGC();
373
+ console.log(`[NeuronLifecycle] GC completed: ${result.expiredCount} expired, ${result.promotedCount} promoted, ${result.demotedCount} demoted`);
374
+ }
375
+ catch (error) {
376
+ console.error('[NeuronLifecycle] Auto GC failed:', error);
377
+ }
378
+ }, this.policy.gcInterval);
379
+ }
380
+ /**
381
+ * 자동 GC 중지
382
+ */
383
+ stopAutoGC() {
384
+ if (this.gcTimer) {
385
+ clearInterval(this.gcTimer);
386
+ this.gcTimer = null;
387
+ }
388
+ }
389
+ /**
390
+ * 통계 조회
391
+ */
392
+ getStats() {
393
+ const total = this.stats.factCount + this.stats.transientCount;
394
+ return {
395
+ ...this.stats,
396
+ factRatio: total > 0 ? this.stats.factCount / total : 0
397
+ };
398
+ }
399
+ /**
400
+ * 통계 초기화
401
+ */
402
+ resetStats() {
403
+ this.stats = {
404
+ totalClassifications: 0,
405
+ factCount: 0,
406
+ transientCount: 0,
407
+ promotions: 0,
408
+ demotions: 0,
409
+ gcRuns: 0,
410
+ totalExpired: 0
411
+ };
412
+ }
413
+ /**
414
+ * 정책 업데이트
415
+ */
416
+ updatePolicy(policy) {
417
+ this.policy = { ...this.policy, ...policy };
418
+ }
419
+ }
420
+ // 싱글톤 인스턴스
421
+ export const neuronLifecycle = new NeuronLifecycleManager();
422
+ //# sourceMappingURL=neuron-lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"neuron-lifecycle.js","sourceRoot":"","sources":["../../src/services/neuron-lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,219 @@
1
+ /**
2
+ * NMT Complete Pipeline
3
+ * 설계 문서(NMT_Updated.md) 기반 완전한 파이프라인
4
+ *
5
+ * 파이프라인 단계:
6
+ * Step 0: Query Normalize (저비용 정제)
7
+ * Step 1: Semantic Cache Check (LLM 호출 0회 기회)
8
+ * Step 2: Retrieve Top-K (NMT 영속 메모리에서 검색)
9
+ * Step 3: Verification Gate (머클 기반 무결성/근거 필터)
10
+ * Step 4: Context Compression (토큰 상한 고정)
11
+ * Step 5: LLM Routing (cheap-first)
12
+ * Step 6: Answer Gate (근거 기반 응답 강제)
13
+ *
14
+ * 추가 기능:
15
+ * - Adaptive Fallback (품질 저하 시 자동 복구)
16
+ * - KPI 메트릭 수집
17
+ *
18
+ * @module services/nmt-pipeline
19
+ */
20
+ import { QueryService } from './query.js';
21
+ import { NormalizedQuery } from './query-normalize.js';
22
+ import { NeuronVerificationResult } from './verification-gate.js';
23
+ import { ComplexityLevel } from './llm-router.js';
24
+ import { SourceReference } from './answer-gate.js';
25
+ import { QualityAssessment } from './adaptive-fallback.js';
26
+ import { LLMProvider } from './llm.js';
27
+ import type { Embedding384 } from '../types/index.js';
28
+ /**
29
+ * 파이프라인 요청
30
+ */
31
+ export interface NMTPipelineRequest {
32
+ query: string;
33
+ options?: {
34
+ k?: number;
35
+ maxTokens?: number;
36
+ forceComplexity?: ComplexityLevel;
37
+ skipCache?: boolean;
38
+ skipVerification?: boolean;
39
+ includeProof?: boolean;
40
+ systemPrompt?: string;
41
+ tags?: string[];
42
+ enableFallback?: boolean;
43
+ };
44
+ }
45
+ /**
46
+ * 파이프라인 응답
47
+ */
48
+ export interface NMTPipelineResponse {
49
+ answer: string;
50
+ grounded: boolean;
51
+ sources: SourceReference[];
52
+ metrics: PipelineMetrics;
53
+ debug?: PipelineDebugInfo;
54
+ }
55
+ /**
56
+ * 파이프라인 메트릭
57
+ */
58
+ export interface PipelineMetrics {
59
+ normalizeTimeMs: number;
60
+ cacheCheckTimeMs: number;
61
+ searchTimeMs: number;
62
+ verifyTimeMs: number;
63
+ compressionTimeMs: number;
64
+ llmTimeMs: number;
65
+ answerGateTimeMs: number;
66
+ totalTimeMs: number;
67
+ cacheHit: boolean;
68
+ cacheType?: 'exact' | 'semantic';
69
+ searchResultCount: number;
70
+ verifiedResultCount: number;
71
+ compressionRatio: number;
72
+ tokensUsed: number;
73
+ complexity: ComplexityLevel;
74
+ model: string;
75
+ estimatedCost: number;
76
+ savedCost: number;
77
+ groundingScore: number;
78
+ abstained: boolean;
79
+ fallbackApplied: boolean;
80
+ fallbackAttempts: number;
81
+ }
82
+ /**
83
+ * 디버그 정보
84
+ */
85
+ export interface PipelineDebugInfo {
86
+ normalizedQuery: NormalizedQuery;
87
+ searchResults: Array<{
88
+ id: string;
89
+ score: number;
90
+ }>;
91
+ verificationResults: NeuronVerificationResult[];
92
+ compressedChunks: number;
93
+ qualityAssessment?: QualityAssessment;
94
+ routingDecision: {
95
+ level: ComplexityLevel;
96
+ score: number;
97
+ factors: Record<string, number>;
98
+ };
99
+ warnings: string[];
100
+ }
101
+ /**
102
+ * 파이프라인 설정
103
+ */
104
+ export interface NMTPipelineConfig {
105
+ enableCache: boolean;
106
+ enableNormalization: boolean;
107
+ enableVerification: boolean;
108
+ enableCompression: boolean;
109
+ enableSmartRouting: boolean;
110
+ enableAnswerGate: boolean;
111
+ enableFallback: boolean;
112
+ enableMetrics: boolean;
113
+ defaultK: number;
114
+ defaultMaxTokens: number;
115
+ defaultEfSearch: number;
116
+ apiKeys: Partial<Record<LLMProvider, string>>;
117
+ enableDebug: boolean;
118
+ }
119
+ /**
120
+ * NMT Complete Pipeline 클래스
121
+ */
122
+ export declare class NMTPipeline {
123
+ private queryService;
124
+ private queryNormalizer;
125
+ private queryCache;
126
+ private verificationGate;
127
+ private contextCompressor;
128
+ private llmRouter;
129
+ private answerGate;
130
+ private fallbackManager;
131
+ private metricsDashboard;
132
+ private config;
133
+ private embedFn;
134
+ constructor(queryService: QueryService, config?: Partial<NMTPipelineConfig>);
135
+ /**
136
+ * 임베딩 함수 설정
137
+ */
138
+ setEmbeddingFunction(fn: (text: string) => Promise<Embedding384>): void;
139
+ /**
140
+ * API 키 설정
141
+ */
142
+ setApiKey(provider: LLMProvider, apiKey: string): void;
143
+ /**
144
+ * 메인 파이프라인 실행
145
+ */
146
+ query(request: NMTPipelineRequest): Promise<NMTPipelineResponse>;
147
+ /**
148
+ * 빠른 쿼리 (캐시 우선)
149
+ */
150
+ quickQuery(query: string): Promise<NMTPipelineResponse>;
151
+ /**
152
+ * 정밀 쿼리 (품질 우선)
153
+ */
154
+ preciseQuery(query: string, tags?: string[]): Promise<NMTPipelineResponse>;
155
+ /**
156
+ * 통계 조회
157
+ */
158
+ getStats(): {
159
+ dashboard: import("./metrics-dashboard.js").KPIDashboard;
160
+ cache: import("./query-cache.js").CacheStats;
161
+ router: {
162
+ totalRequests: number;
163
+ byComplexity: {
164
+ simple: number;
165
+ medium: number;
166
+ complex: number;
167
+ };
168
+ totalCost: number;
169
+ savedCost: number;
170
+ } & {
171
+ avgCostPerRequest: number;
172
+ savingsRate: number;
173
+ };
174
+ answerGate: {
175
+ totalResponses: number;
176
+ groundedRate: number;
177
+ abstainRate: number;
178
+ avgSourcesPerResponse: number;
179
+ avgGroundingScore: number;
180
+ };
181
+ verification: {
182
+ totalVerifications: number;
183
+ successRate: number;
184
+ failureRate: number;
185
+ cacheHitRate: number;
186
+ avgVerificationTimeMs: number;
187
+ failuresByReason: Record<string, number>;
188
+ };
189
+ fallback: {
190
+ totalAssessments: number;
191
+ fallbackRate: number;
192
+ recoveryRate: number;
193
+ actionDistribution: Record<string, number>;
194
+ };
195
+ normalizer: {
196
+ totalQueries: number;
197
+ avgFillerRemoved: number;
198
+ avgReductionRatio: number;
199
+ intentDistribution: Record<string, number>;
200
+ };
201
+ };
202
+ /**
203
+ * 캐시 클리어
204
+ */
205
+ clearCache(): void;
206
+ /**
207
+ * 전체 초기화
208
+ */
209
+ reset(): void;
210
+ /**
211
+ * 설정 업데이트
212
+ */
213
+ updateConfig(config: Partial<NMTPipelineConfig>): void;
214
+ }
215
+ /**
216
+ * 파이프라인 팩토리 함수
217
+ */
218
+ export declare function createNMTPipeline(queryService: QueryService, config?: Partial<NMTPipelineConfig>): NMTPipeline;
219
+ //# sourceMappingURL=nmt-pipeline.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nmt-pipeline.d.ts","sourceRoot":"","sources":["../../src/services/nmt-pipeline.ts"],"names":[],"mappings":"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"}