agentic-qe 2.5.9 → 2.6.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 (336) hide show
  1. package/.claude/agents/qe-code-intelligence.md +359 -0
  2. package/CHANGELOG.md +136 -0
  3. package/README.md +4 -3
  4. package/dist/agents/BaseAgent.d.ts +167 -0
  5. package/dist/agents/BaseAgent.d.ts.map +1 -1
  6. package/dist/agents/BaseAgent.js +414 -0
  7. package/dist/agents/BaseAgent.js.map +1 -1
  8. package/dist/agents/CodeIntelligenceAgent.d.ts +133 -0
  9. package/dist/agents/CodeIntelligenceAgent.d.ts.map +1 -0
  10. package/dist/agents/CodeIntelligenceAgent.js +473 -0
  11. package/dist/agents/CodeIntelligenceAgent.js.map +1 -0
  12. package/dist/agents/FlakyTestHunterAgent.d.ts +15 -0
  13. package/dist/agents/FlakyTestHunterAgent.d.ts.map +1 -1
  14. package/dist/agents/FlakyTestHunterAgent.js +93 -0
  15. package/dist/agents/FlakyTestHunterAgent.js.map +1 -1
  16. package/dist/agents/SecurityScannerAgent.d.ts +19 -0
  17. package/dist/agents/SecurityScannerAgent.d.ts.map +1 -1
  18. package/dist/agents/SecurityScannerAgent.js +137 -0
  19. package/dist/agents/SecurityScannerAgent.js.map +1 -1
  20. package/dist/agents/context/ContextCache.d.ts +105 -0
  21. package/dist/agents/context/ContextCache.d.ts.map +1 -0
  22. package/dist/agents/context/ContextCache.js +235 -0
  23. package/dist/agents/context/ContextCache.js.map +1 -0
  24. package/dist/agents/context/ContextFormatter.d.ts +92 -0
  25. package/dist/agents/context/ContextFormatter.d.ts.map +1 -0
  26. package/dist/agents/context/ContextFormatter.js +338 -0
  27. package/dist/agents/context/ContextFormatter.js.map +1 -0
  28. package/dist/agents/context/GraphExpander.d.ts +87 -0
  29. package/dist/agents/context/GraphExpander.d.ts.map +1 -0
  30. package/dist/agents/context/GraphExpander.js +215 -0
  31. package/dist/agents/context/GraphExpander.js.map +1 -0
  32. package/dist/agents/context/KnowledgeGraphContextBuilder.d.ts +160 -0
  33. package/dist/agents/context/KnowledgeGraphContextBuilder.d.ts.map +1 -0
  34. package/dist/agents/context/KnowledgeGraphContextBuilder.js +300 -0
  35. package/dist/agents/context/KnowledgeGraphContextBuilder.js.map +1 -0
  36. package/dist/agents/context/index.d.ts +15 -0
  37. package/dist/agents/context/index.d.ts.map +1 -0
  38. package/dist/agents/context/index.js +18 -0
  39. package/dist/agents/context/index.js.map +1 -0
  40. package/dist/agents/index.d.ts +1 -0
  41. package/dist/agents/index.d.ts.map +1 -1
  42. package/dist/agents/index.js +67 -3
  43. package/dist/agents/index.js.map +1 -1
  44. package/dist/cli/commands/knowledge-graph.d.ts +112 -0
  45. package/dist/cli/commands/knowledge-graph.d.ts.map +1 -0
  46. package/dist/cli/commands/knowledge-graph.js +466 -0
  47. package/dist/cli/commands/knowledge-graph.js.map +1 -0
  48. package/dist/cli/commands/ruvector/index.d.ts +13 -0
  49. package/dist/cli/commands/ruvector/index.d.ts.map +1 -0
  50. package/dist/cli/commands/ruvector/index.js +308 -0
  51. package/dist/cli/commands/ruvector/index.js.map +1 -0
  52. package/dist/cli/formatters/KGOutputFormatter.d.ts +50 -0
  53. package/dist/cli/formatters/KGOutputFormatter.d.ts.map +1 -0
  54. package/dist/cli/formatters/KGOutputFormatter.js +237 -0
  55. package/dist/cli/formatters/KGOutputFormatter.js.map +1 -0
  56. package/dist/cli/index-working.js +138 -0
  57. package/dist/cli/index-working.js.map +1 -1
  58. package/dist/cli/index.js +5 -0
  59. package/dist/cli/index.js.map +1 -1
  60. package/dist/cli/init/claude-config.d.ts +13 -1
  61. package/dist/cli/init/claude-config.d.ts.map +1 -1
  62. package/dist/cli/init/claude-config.js +70 -8
  63. package/dist/cli/init/claude-config.js.map +1 -1
  64. package/dist/cli/init/code-intelligence-init.d.ts +52 -0
  65. package/dist/cli/init/code-intelligence-init.d.ts.map +1 -0
  66. package/dist/cli/init/code-intelligence-init.js +250 -0
  67. package/dist/cli/init/code-intelligence-init.js.map +1 -0
  68. package/dist/cli/init/index.d.ts +2 -2
  69. package/dist/cli/init/index.d.ts.map +1 -1
  70. package/dist/cli/init/index.js +21 -1
  71. package/dist/cli/init/index.js.map +1 -1
  72. package/dist/code-intelligence/chunking/ASTChunker.d.ts +64 -0
  73. package/dist/code-intelligence/chunking/ASTChunker.d.ts.map +1 -0
  74. package/dist/code-intelligence/chunking/ASTChunker.js +344 -0
  75. package/dist/code-intelligence/chunking/ASTChunker.js.map +1 -0
  76. package/dist/code-intelligence/chunking/ChunkSplitter.d.ts +48 -0
  77. package/dist/code-intelligence/chunking/ChunkSplitter.d.ts.map +1 -0
  78. package/dist/code-intelligence/chunking/ChunkSplitter.js +278 -0
  79. package/dist/code-intelligence/chunking/ChunkSplitter.js.map +1 -0
  80. package/dist/code-intelligence/chunking/index.d.ts +8 -0
  81. package/dist/code-intelligence/chunking/index.d.ts.map +1 -0
  82. package/dist/code-intelligence/chunking/index.js +13 -0
  83. package/dist/code-intelligence/chunking/index.js.map +1 -0
  84. package/dist/code-intelligence/chunking/types.d.ts +52 -0
  85. package/dist/code-intelligence/chunking/types.d.ts.map +1 -0
  86. package/dist/code-intelligence/chunking/types.js +6 -0
  87. package/dist/code-intelligence/chunking/types.js.map +1 -0
  88. package/dist/code-intelligence/config/database-schema.d.ts +245 -0
  89. package/dist/code-intelligence/config/database-schema.d.ts.map +1 -0
  90. package/dist/code-intelligence/config/database-schema.js +110 -0
  91. package/dist/code-intelligence/config/database-schema.js.map +1 -0
  92. package/dist/code-intelligence/config/environment.d.ts +53 -0
  93. package/dist/code-intelligence/config/environment.d.ts.map +1 -0
  94. package/dist/code-intelligence/config/environment.js +86 -0
  95. package/dist/code-intelligence/config/environment.js.map +1 -0
  96. package/dist/code-intelligence/config/index.d.ts +10 -0
  97. package/dist/code-intelligence/config/index.d.ts.map +1 -0
  98. package/dist/code-intelligence/config/index.js +36 -0
  99. package/dist/code-intelligence/config/index.js.map +1 -0
  100. package/dist/code-intelligence/embeddings/EmbeddingCache.d.ts +81 -0
  101. package/dist/code-intelligence/embeddings/EmbeddingCache.d.ts.map +1 -0
  102. package/dist/code-intelligence/embeddings/EmbeddingCache.js +168 -0
  103. package/dist/code-intelligence/embeddings/EmbeddingCache.js.map +1 -0
  104. package/dist/code-intelligence/embeddings/NomicEmbedder.d.ts +82 -0
  105. package/dist/code-intelligence/embeddings/NomicEmbedder.d.ts.map +1 -0
  106. package/dist/code-intelligence/embeddings/NomicEmbedder.js +233 -0
  107. package/dist/code-intelligence/embeddings/NomicEmbedder.js.map +1 -0
  108. package/dist/code-intelligence/embeddings/OllamaClient.d.ts +42 -0
  109. package/dist/code-intelligence/embeddings/OllamaClient.d.ts.map +1 -0
  110. package/dist/code-intelligence/embeddings/OllamaClient.js +142 -0
  111. package/dist/code-intelligence/embeddings/OllamaClient.js.map +1 -0
  112. package/dist/code-intelligence/embeddings/index.d.ts +33 -0
  113. package/dist/code-intelligence/embeddings/index.d.ts.map +1 -0
  114. package/dist/code-intelligence/embeddings/index.js +39 -0
  115. package/dist/code-intelligence/embeddings/index.js.map +1 -0
  116. package/dist/code-intelligence/embeddings/types.d.ts +84 -0
  117. package/dist/code-intelligence/embeddings/types.d.ts.map +1 -0
  118. package/dist/code-intelligence/embeddings/types.js +19 -0
  119. package/dist/code-intelligence/embeddings/types.js.map +1 -0
  120. package/dist/code-intelligence/graph/GraphBuilder.d.ts +126 -0
  121. package/dist/code-intelligence/graph/GraphBuilder.d.ts.map +1 -0
  122. package/dist/code-intelligence/graph/GraphBuilder.js +416 -0
  123. package/dist/code-intelligence/graph/GraphBuilder.js.map +1 -0
  124. package/dist/code-intelligence/graph/ImportParser.d.ts +72 -0
  125. package/dist/code-intelligence/graph/ImportParser.d.ts.map +1 -0
  126. package/dist/code-intelligence/graph/ImportParser.js +422 -0
  127. package/dist/code-intelligence/graph/ImportParser.js.map +1 -0
  128. package/dist/code-intelligence/graph/RelationshipExtractor.d.ts +74 -0
  129. package/dist/code-intelligence/graph/RelationshipExtractor.d.ts.map +1 -0
  130. package/dist/code-intelligence/graph/RelationshipExtractor.js +310 -0
  131. package/dist/code-intelligence/graph/RelationshipExtractor.js.map +1 -0
  132. package/dist/code-intelligence/graph/TestMapper.d.ts +99 -0
  133. package/dist/code-intelligence/graph/TestMapper.d.ts.map +1 -0
  134. package/dist/code-intelligence/graph/TestMapper.js +335 -0
  135. package/dist/code-intelligence/graph/TestMapper.js.map +1 -0
  136. package/dist/code-intelligence/graph/index.d.ts +14 -0
  137. package/dist/code-intelligence/graph/index.d.ts.map +1 -0
  138. package/dist/code-intelligence/graph/index.js +19 -0
  139. package/dist/code-intelligence/graph/index.js.map +1 -0
  140. package/dist/code-intelligence/graph/types.d.ts +141 -0
  141. package/dist/code-intelligence/graph/types.d.ts.map +1 -0
  142. package/dist/code-intelligence/graph/types.js +18 -0
  143. package/dist/code-intelligence/graph/types.js.map +1 -0
  144. package/dist/code-intelligence/indexing/FileWatcher.d.ts +90 -0
  145. package/dist/code-intelligence/indexing/FileWatcher.d.ts.map +1 -0
  146. package/dist/code-intelligence/indexing/FileWatcher.js +304 -0
  147. package/dist/code-intelligence/indexing/FileWatcher.js.map +1 -0
  148. package/dist/code-intelligence/indexing/GitChangeDetector.d.ts +76 -0
  149. package/dist/code-intelligence/indexing/GitChangeDetector.d.ts.map +1 -0
  150. package/dist/code-intelligence/indexing/GitChangeDetector.js +347 -0
  151. package/dist/code-intelligence/indexing/GitChangeDetector.js.map +1 -0
  152. package/dist/code-intelligence/indexing/IncrementalIndexer.d.ts +108 -0
  153. package/dist/code-intelligence/indexing/IncrementalIndexer.d.ts.map +1 -0
  154. package/dist/code-intelligence/indexing/IncrementalIndexer.js +269 -0
  155. package/dist/code-intelligence/indexing/IncrementalIndexer.js.map +1 -0
  156. package/dist/code-intelligence/indexing/index.d.ts +11 -0
  157. package/dist/code-intelligence/indexing/index.d.ts.map +1 -0
  158. package/dist/code-intelligence/indexing/index.js +18 -0
  159. package/dist/code-intelligence/indexing/index.js.map +1 -0
  160. package/dist/code-intelligence/indexing/types.d.ts +133 -0
  161. package/dist/code-intelligence/indexing/types.d.ts.map +1 -0
  162. package/dist/code-intelligence/indexing/types.js +27 -0
  163. package/dist/code-intelligence/indexing/types.js.map +1 -0
  164. package/dist/code-intelligence/orchestrator/CodeIntelligenceOrchestrator.d.ts +150 -0
  165. package/dist/code-intelligence/orchestrator/CodeIntelligenceOrchestrator.d.ts.map +1 -0
  166. package/dist/code-intelligence/orchestrator/CodeIntelligenceOrchestrator.js +806 -0
  167. package/dist/code-intelligence/orchestrator/CodeIntelligenceOrchestrator.js.map +1 -0
  168. package/dist/code-intelligence/orchestrator/index.d.ts +8 -0
  169. package/dist/code-intelligence/orchestrator/index.d.ts.map +1 -0
  170. package/dist/code-intelligence/orchestrator/index.js +24 -0
  171. package/dist/code-intelligence/orchestrator/index.js.map +1 -0
  172. package/dist/code-intelligence/orchestrator/types.d.ts +164 -0
  173. package/dist/code-intelligence/orchestrator/types.d.ts.map +1 -0
  174. package/dist/code-intelligence/orchestrator/types.js +18 -0
  175. package/dist/code-intelligence/orchestrator/types.js.map +1 -0
  176. package/dist/code-intelligence/parser/LanguageRegistry.d.ts +13 -0
  177. package/dist/code-intelligence/parser/LanguageRegistry.d.ts.map +1 -0
  178. package/dist/code-intelligence/parser/LanguageRegistry.js +150 -0
  179. package/dist/code-intelligence/parser/LanguageRegistry.js.map +1 -0
  180. package/dist/code-intelligence/parser/TreeSitterParser.d.ts +98 -0
  181. package/dist/code-intelligence/parser/TreeSitterParser.d.ts.map +1 -0
  182. package/dist/code-intelligence/parser/TreeSitterParser.js +530 -0
  183. package/dist/code-intelligence/parser/TreeSitterParser.js.map +1 -0
  184. package/dist/code-intelligence/parser/extractors/BaseExtractor.d.ts +36 -0
  185. package/dist/code-intelligence/parser/extractors/BaseExtractor.d.ts.map +1 -0
  186. package/dist/code-intelligence/parser/extractors/BaseExtractor.js +31 -0
  187. package/dist/code-intelligence/parser/extractors/BaseExtractor.js.map +1 -0
  188. package/dist/code-intelligence/parser/extractors/GoExtractor.d.ts +21 -0
  189. package/dist/code-intelligence/parser/extractors/GoExtractor.d.ts.map +1 -0
  190. package/dist/code-intelligence/parser/extractors/GoExtractor.js +249 -0
  191. package/dist/code-intelligence/parser/extractors/GoExtractor.js.map +1 -0
  192. package/dist/code-intelligence/parser/extractors/JavaScriptExtractor.d.ts +21 -0
  193. package/dist/code-intelligence/parser/extractors/JavaScriptExtractor.d.ts.map +1 -0
  194. package/dist/code-intelligence/parser/extractors/JavaScriptExtractor.js +217 -0
  195. package/dist/code-intelligence/parser/extractors/JavaScriptExtractor.js.map +1 -0
  196. package/dist/code-intelligence/parser/extractors/PythonExtractor.d.ts +20 -0
  197. package/dist/code-intelligence/parser/extractors/PythonExtractor.d.ts.map +1 -0
  198. package/dist/code-intelligence/parser/extractors/PythonExtractor.js +237 -0
  199. package/dist/code-intelligence/parser/extractors/PythonExtractor.js.map +1 -0
  200. package/dist/code-intelligence/parser/extractors/RustExtractor.d.ts +21 -0
  201. package/dist/code-intelligence/parser/extractors/RustExtractor.d.ts.map +1 -0
  202. package/dist/code-intelligence/parser/extractors/RustExtractor.js +234 -0
  203. package/dist/code-intelligence/parser/extractors/RustExtractor.js.map +1 -0
  204. package/dist/code-intelligence/parser/extractors/TypeScriptExtractor.d.ts +23 -0
  205. package/dist/code-intelligence/parser/extractors/TypeScriptExtractor.d.ts.map +1 -0
  206. package/dist/code-intelligence/parser/extractors/TypeScriptExtractor.js +247 -0
  207. package/dist/code-intelligence/parser/extractors/TypeScriptExtractor.js.map +1 -0
  208. package/dist/code-intelligence/parser/extractors/index.d.ts +7 -0
  209. package/dist/code-intelligence/parser/extractors/index.d.ts.map +1 -0
  210. package/dist/code-intelligence/parser/extractors/index.js +16 -0
  211. package/dist/code-intelligence/parser/extractors/index.js.map +1 -0
  212. package/dist/code-intelligence/parser/index.d.ts +8 -0
  213. package/dist/code-intelligence/parser/index.d.ts.map +1 -0
  214. package/dist/code-intelligence/parser/index.js +12 -0
  215. package/dist/code-intelligence/parser/index.js.map +1 -0
  216. package/dist/code-intelligence/parser/types.d.ts +60 -0
  217. package/dist/code-intelligence/parser/types.d.ts.map +1 -0
  218. package/dist/code-intelligence/parser/types.js +6 -0
  219. package/dist/code-intelligence/parser/types.js.map +1 -0
  220. package/dist/code-intelligence/rag/ContextBuilder.d.ts +82 -0
  221. package/dist/code-intelligence/rag/ContextBuilder.d.ts.map +1 -0
  222. package/dist/code-intelligence/rag/ContextBuilder.js +242 -0
  223. package/dist/code-intelligence/rag/ContextBuilder.js.map +1 -0
  224. package/dist/code-intelligence/rag/GraphExpander.d.ts +95 -0
  225. package/dist/code-intelligence/rag/GraphExpander.d.ts.map +1 -0
  226. package/dist/code-intelligence/rag/GraphExpander.js +250 -0
  227. package/dist/code-intelligence/rag/GraphExpander.js.map +1 -0
  228. package/dist/code-intelligence/rag/index.d.ts +9 -0
  229. package/dist/code-intelligence/rag/index.d.ts.map +1 -0
  230. package/dist/code-intelligence/rag/index.js +25 -0
  231. package/dist/code-intelligence/rag/index.js.map +1 -0
  232. package/dist/code-intelligence/rag/types.d.ts +121 -0
  233. package/dist/code-intelligence/rag/types.d.ts.map +1 -0
  234. package/dist/code-intelligence/rag/types.js +50 -0
  235. package/dist/code-intelligence/rag/types.js.map +1 -0
  236. package/dist/code-intelligence/retrieval/SemanticRetriever.d.ts +62 -0
  237. package/dist/code-intelligence/retrieval/SemanticRetriever.d.ts.map +1 -0
  238. package/dist/code-intelligence/retrieval/SemanticRetriever.js +174 -0
  239. package/dist/code-intelligence/retrieval/SemanticRetriever.js.map +1 -0
  240. package/dist/code-intelligence/retrieval/index.d.ts +9 -0
  241. package/dist/code-intelligence/retrieval/index.d.ts.map +1 -0
  242. package/dist/code-intelligence/retrieval/index.js +16 -0
  243. package/dist/code-intelligence/retrieval/index.js.map +1 -0
  244. package/dist/code-intelligence/retrieval/types.d.ts +118 -0
  245. package/dist/code-intelligence/retrieval/types.d.ts.map +1 -0
  246. package/dist/code-intelligence/retrieval/types.js +46 -0
  247. package/dist/code-intelligence/retrieval/types.js.map +1 -0
  248. package/dist/code-intelligence/router/CodeIntelligenceHybridRouter.d.ts +167 -0
  249. package/dist/code-intelligence/router/CodeIntelligenceHybridRouter.d.ts.map +1 -0
  250. package/dist/code-intelligence/router/CodeIntelligenceHybridRouter.js +365 -0
  251. package/dist/code-intelligence/router/CodeIntelligenceHybridRouter.js.map +1 -0
  252. package/dist/code-intelligence/router/index.d.ts +7 -0
  253. package/dist/code-intelligence/router/index.d.ts.map +1 -0
  254. package/dist/code-intelligence/router/index.js +14 -0
  255. package/dist/code-intelligence/router/index.js.map +1 -0
  256. package/dist/code-intelligence/search/BM25Search.d.ts +74 -0
  257. package/dist/code-intelligence/search/BM25Search.d.ts.map +1 -0
  258. package/dist/code-intelligence/search/BM25Search.js +233 -0
  259. package/dist/code-intelligence/search/BM25Search.js.map +1 -0
  260. package/dist/code-intelligence/search/HybridSearchEngine.d.ts +94 -0
  261. package/dist/code-intelligence/search/HybridSearchEngine.d.ts.map +1 -0
  262. package/dist/code-intelligence/search/HybridSearchEngine.js +168 -0
  263. package/dist/code-intelligence/search/HybridSearchEngine.js.map +1 -0
  264. package/dist/code-intelligence/search/RRFFusion.d.ts +46 -0
  265. package/dist/code-intelligence/search/RRFFusion.d.ts.map +1 -0
  266. package/dist/code-intelligence/search/RRFFusion.js +223 -0
  267. package/dist/code-intelligence/search/RRFFusion.js.map +1 -0
  268. package/dist/code-intelligence/search/VectorSearch.d.ts +157 -0
  269. package/dist/code-intelligence/search/VectorSearch.d.ts.map +1 -0
  270. package/dist/code-intelligence/search/VectorSearch.js +301 -0
  271. package/dist/code-intelligence/search/VectorSearch.js.map +1 -0
  272. package/dist/code-intelligence/search/index.d.ts +14 -0
  273. package/dist/code-intelligence/search/index.d.ts.map +1 -0
  274. package/dist/code-intelligence/search/index.js +23 -0
  275. package/dist/code-intelligence/search/index.js.map +1 -0
  276. package/dist/code-intelligence/search/types.d.ts +201 -0
  277. package/dist/code-intelligence/search/types.d.ts.map +1 -0
  278. package/dist/code-intelligence/search/types.js +35 -0
  279. package/dist/code-intelligence/search/types.js.map +1 -0
  280. package/dist/code-intelligence/service/CodeIntelligenceService.d.ts +171 -0
  281. package/dist/code-intelligence/service/CodeIntelligenceService.d.ts.map +1 -0
  282. package/dist/code-intelligence/service/CodeIntelligenceService.js +325 -0
  283. package/dist/code-intelligence/service/CodeIntelligenceService.js.map +1 -0
  284. package/dist/code-intelligence/service/index.d.ts +7 -0
  285. package/dist/code-intelligence/service/index.d.ts.map +1 -0
  286. package/dist/code-intelligence/service/index.js +14 -0
  287. package/dist/code-intelligence/service/index.js.map +1 -0
  288. package/dist/code-intelligence/storage/CodeChunkStore.d.ts +213 -0
  289. package/dist/code-intelligence/storage/CodeChunkStore.d.ts.map +1 -0
  290. package/dist/code-intelligence/storage/CodeChunkStore.js +542 -0
  291. package/dist/code-intelligence/storage/CodeChunkStore.js.map +1 -0
  292. package/dist/code-intelligence/storage/index.d.ts +7 -0
  293. package/dist/code-intelligence/storage/index.d.ts.map +1 -0
  294. package/dist/code-intelligence/storage/index.js +13 -0
  295. package/dist/code-intelligence/storage/index.js.map +1 -0
  296. package/dist/code-intelligence/visualization/ClassDiagramBuilder.d.ts +51 -0
  297. package/dist/code-intelligence/visualization/ClassDiagramBuilder.d.ts.map +1 -0
  298. package/dist/code-intelligence/visualization/ClassDiagramBuilder.js +180 -0
  299. package/dist/code-intelligence/visualization/ClassDiagramBuilder.js.map +1 -0
  300. package/dist/code-intelligence/visualization/DependencyGraphBuilder.d.ts +66 -0
  301. package/dist/code-intelligence/visualization/DependencyGraphBuilder.d.ts.map +1 -0
  302. package/dist/code-intelligence/visualization/DependencyGraphBuilder.js +203 -0
  303. package/dist/code-intelligence/visualization/DependencyGraphBuilder.js.map +1 -0
  304. package/dist/code-intelligence/visualization/MermaidGenerator.d.ts +76 -0
  305. package/dist/code-intelligence/visualization/MermaidGenerator.d.ts.map +1 -0
  306. package/dist/code-intelligence/visualization/MermaidGenerator.js +368 -0
  307. package/dist/code-intelligence/visualization/MermaidGenerator.js.map +1 -0
  308. package/dist/code-intelligence/visualization/index.d.ts +9 -0
  309. package/dist/code-intelligence/visualization/index.d.ts.map +1 -0
  310. package/dist/code-intelligence/visualization/index.js +15 -0
  311. package/dist/code-intelligence/visualization/index.js.map +1 -0
  312. package/dist/core/FleetManager.d.ts +27 -0
  313. package/dist/core/FleetManager.d.ts.map +1 -1
  314. package/dist/core/FleetManager.js +84 -0
  315. package/dist/core/FleetManager.js.map +1 -1
  316. package/dist/core/memory/HNSWVectorMemory.js +1 -1
  317. package/dist/mcp/server-instructions.d.ts +1 -1
  318. package/dist/mcp/server-instructions.js +1 -1
  319. package/dist/memory/RuVectorPatternStore.d.ts +258 -0
  320. package/dist/memory/RuVectorPatternStore.d.ts.map +1 -0
  321. package/dist/memory/RuVectorPatternStore.js +525 -0
  322. package/dist/memory/RuVectorPatternStore.js.map +1 -0
  323. package/dist/providers/RuVectorPostgresAdapter.d.ts +134 -0
  324. package/dist/providers/RuVectorPostgresAdapter.d.ts.map +1 -0
  325. package/dist/providers/RuVectorPostgresAdapter.js +504 -0
  326. package/dist/providers/RuVectorPostgresAdapter.js.map +1 -0
  327. package/dist/providers/index.d.ts +2 -0
  328. package/dist/providers/index.d.ts.map +1 -1
  329. package/dist/providers/index.js +7 -1
  330. package/dist/providers/index.js.map +1 -1
  331. package/dist/types/index.d.ts +2 -1
  332. package/dist/types/index.d.ts.map +1 -1
  333. package/dist/types/index.js +2 -0
  334. package/dist/types/index.js.map +1 -1
  335. package/docs/reference/agents.md +44 -1
  336. package/package.json +15 -2
@@ -0,0 +1,338 @@
1
+ "use strict";
2
+ /**
3
+ * ContextFormatter
4
+ *
5
+ * Formats code context for optimal LLM consumption.
6
+ * Includes metadata, relationship context, and intelligent truncation.
7
+ *
8
+ * Goals:
9
+ * - Minimize tokens while preserving essential information
10
+ * - Include navigational metadata (file paths, line numbers)
11
+ * - Show relationship context (imports, calls, tests)
12
+ * - Smart truncation for large code blocks
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.ContextFormatter = void 0;
16
+ const DEFAULT_OPTIONS = {
17
+ includeFilePaths: true,
18
+ includeLineNumbers: true,
19
+ includeMetadata: true,
20
+ includeRelationships: true,
21
+ maxLinesPerBlock: 50,
22
+ truncationStrategy: 'middle',
23
+ useMarkdown: true,
24
+ };
25
+ class ContextFormatter {
26
+ constructor(options = {}) {
27
+ this.options = { ...DEFAULT_OPTIONS, ...options };
28
+ }
29
+ /**
30
+ * Format search results with graph context.
31
+ */
32
+ format(searchResults, expandedNodes, options) {
33
+ const opts = { ...this.options, ...options };
34
+ const sections = [];
35
+ let totalLines = 0;
36
+ let truncated = false;
37
+ // Primary results section
38
+ if (searchResults.length > 0) {
39
+ const primarySection = this.formatPrimaryResults(searchResults, opts);
40
+ sections.push(primarySection.content);
41
+ totalLines += primarySection.lines;
42
+ truncated = truncated || primarySection.truncated;
43
+ }
44
+ // Related code section
45
+ if (expandedNodes.length > 0 && opts.includeRelationships) {
46
+ const relatedSection = this.formatRelatedCode(expandedNodes, opts);
47
+ sections.push(relatedSection.content);
48
+ totalLines += relatedSection.lines;
49
+ truncated = truncated || relatedSection.truncated;
50
+ }
51
+ const content = sections.join('\n\n');
52
+ const totalTokensEstimate = this.estimateTokens(content);
53
+ return {
54
+ content,
55
+ metadata: {
56
+ totalChunks: searchResults.length + expandedNodes.length,
57
+ totalLines,
58
+ totalTokensEstimate,
59
+ truncated,
60
+ },
61
+ };
62
+ }
63
+ /**
64
+ * Format primary search results.
65
+ */
66
+ formatPrimaryResults(results, opts) {
67
+ const sections = [];
68
+ let totalLines = 0;
69
+ let truncated = false;
70
+ if (opts.useMarkdown) {
71
+ sections.push('## Relevant Code');
72
+ sections.push('');
73
+ }
74
+ for (let i = 0; i < results.length; i++) {
75
+ const result = results[i];
76
+ const formatted = this.formatCodeBlock(result, opts, `Result ${i + 1}`);
77
+ sections.push(formatted.content);
78
+ totalLines += formatted.lines;
79
+ truncated = truncated || formatted.truncated;
80
+ if (i < results.length - 1) {
81
+ sections.push('');
82
+ }
83
+ }
84
+ return {
85
+ content: sections.join('\n'),
86
+ lines: totalLines,
87
+ truncated,
88
+ };
89
+ }
90
+ /**
91
+ * Format related code from graph expansion.
92
+ */
93
+ formatRelatedCode(nodes, opts) {
94
+ const sections = [];
95
+ let totalLines = 0;
96
+ let truncated = false;
97
+ if (opts.useMarkdown) {
98
+ sections.push('## Related Code');
99
+ sections.push('');
100
+ }
101
+ // Group by relationship type
102
+ const grouped = new Map();
103
+ for (const node of nodes) {
104
+ const relationship = node.relationship;
105
+ if (!grouped.has(relationship)) {
106
+ grouped.set(relationship, []);
107
+ }
108
+ grouped.get(relationship).push(node);
109
+ }
110
+ // Format each group
111
+ for (const [relationship, relatedNodes] of grouped.entries()) {
112
+ if (opts.useMarkdown) {
113
+ sections.push(`### ${this.capitalizeRelationship(relationship)}`);
114
+ sections.push('');
115
+ }
116
+ for (let i = 0; i < relatedNodes.length; i++) {
117
+ const node = relatedNodes[i];
118
+ const formatted = this.formatGraphNode(node, opts);
119
+ sections.push(formatted.content);
120
+ totalLines += formatted.lines;
121
+ truncated = truncated || formatted.truncated;
122
+ if (i < relatedNodes.length - 1) {
123
+ sections.push('');
124
+ }
125
+ }
126
+ sections.push('');
127
+ }
128
+ return {
129
+ content: sections.join('\n'),
130
+ lines: totalLines,
131
+ truncated,
132
+ };
133
+ }
134
+ /**
135
+ * Format a code block from search result.
136
+ */
137
+ formatCodeBlock(result, opts, label) {
138
+ const lines = [];
139
+ // Header
140
+ if (label && opts.useMarkdown) {
141
+ lines.push(`### ${label}`);
142
+ }
143
+ // File path and line numbers
144
+ if (opts.includeFilePaths) {
145
+ const location = opts.includeLineNumbers
146
+ ? `${result.filePath}:${result.startLine}-${result.endLine}`
147
+ : result.filePath;
148
+ lines.push(opts.useMarkdown ? `**File:** \`${location}\`` : `File: ${location}`);
149
+ }
150
+ // Entity metadata
151
+ if (opts.includeMetadata && (result.entityType || result.entityName)) {
152
+ const metadata = [];
153
+ if (result.entityType)
154
+ metadata.push(`Type: ${result.entityType}`);
155
+ if (result.entityName)
156
+ metadata.push(`Name: ${result.entityName}`);
157
+ if (result.score !== undefined) {
158
+ metadata.push(`Relevance: ${(result.score * 100).toFixed(1)}%`);
159
+ }
160
+ lines.push(opts.useMarkdown ? `**${metadata.join(' | ')}**` : metadata.join(' | '));
161
+ }
162
+ lines.push('');
163
+ // Code content with truncation
164
+ const { content, truncated } = this.truncateContent(result.content, opts.maxLinesPerBlock, opts.truncationStrategy);
165
+ const language = this.detectLanguage(result.filePath);
166
+ if (opts.useMarkdown) {
167
+ lines.push(`\`\`\`${language}`);
168
+ lines.push(content);
169
+ lines.push('```');
170
+ }
171
+ else {
172
+ lines.push(content);
173
+ }
174
+ const totalLines = content.split('\n').length;
175
+ return {
176
+ content: lines.join('\n'),
177
+ lines: totalLines,
178
+ truncated,
179
+ };
180
+ }
181
+ /**
182
+ * Format a graph node.
183
+ */
184
+ formatGraphNode(expandedNode, opts) {
185
+ const node = expandedNode.node;
186
+ const lines = [];
187
+ // File path and line numbers
188
+ if (opts.includeFilePaths) {
189
+ const location = opts.includeLineNumbers
190
+ ? `${node.filePath}:${node.startLine}-${node.endLine}`
191
+ : node.filePath;
192
+ lines.push(opts.useMarkdown ? `**\`${location}\`**` : location);
193
+ }
194
+ // Node metadata
195
+ if (opts.includeMetadata) {
196
+ const metadata = [];
197
+ metadata.push(`Type: ${node.type}`);
198
+ metadata.push(`Label: ${node.label}`);
199
+ if (expandedNode.depth > 0) {
200
+ metadata.push(`Depth: ${expandedNode.depth}`);
201
+ }
202
+ lines.push(metadata.join(' | '));
203
+ }
204
+ // Note: Graph nodes don't have content - would need to read from file
205
+ // For now, just show metadata
206
+ lines.push('');
207
+ return {
208
+ content: lines.join('\n'),
209
+ lines: 3,
210
+ truncated: false,
211
+ };
212
+ }
213
+ /**
214
+ * Truncate content based on strategy.
215
+ */
216
+ truncateContent(content, maxLines, strategy) {
217
+ const lines = content.split('\n');
218
+ if (lines.length <= maxLines) {
219
+ return { content, truncated: false };
220
+ }
221
+ let truncatedLines;
222
+ switch (strategy) {
223
+ case 'start':
224
+ truncatedLines = lines.slice(0, maxLines);
225
+ truncatedLines.push('// ... (truncated)');
226
+ break;
227
+ case 'end':
228
+ truncatedLines = ['// ... (truncated)'];
229
+ truncatedLines.push(...lines.slice(-maxLines));
230
+ break;
231
+ case 'middle':
232
+ const half = Math.floor(maxLines / 2);
233
+ truncatedLines = lines.slice(0, half);
234
+ truncatedLines.push('// ... (truncated)');
235
+ truncatedLines.push(...lines.slice(-half));
236
+ break;
237
+ case 'smart':
238
+ // Keep important lines (function signatures, class definitions, etc.)
239
+ truncatedLines = this.smartTruncate(lines, maxLines);
240
+ break;
241
+ default:
242
+ truncatedLines = lines.slice(0, maxLines);
243
+ }
244
+ return {
245
+ content: truncatedLines.join('\n'),
246
+ truncated: true,
247
+ };
248
+ }
249
+ /**
250
+ * Smart truncation preserving important lines.
251
+ */
252
+ smartTruncate(lines, maxLines) {
253
+ const important = [];
254
+ const importantPatterns = [
255
+ /^\s*(export\s+)?(class|interface|function|const|let|var)\s+/,
256
+ /^\s*\/\*\*/, // JSDoc comments
257
+ /^\s*import\s+/,
258
+ /^\s*@\w+/, // Decorators
259
+ ];
260
+ // Find important lines
261
+ for (let i = 0; i < lines.length; i++) {
262
+ for (const pattern of importantPatterns) {
263
+ if (pattern.test(lines[i])) {
264
+ important.push(i);
265
+ break;
266
+ }
267
+ }
268
+ }
269
+ // If we have enough important lines, use those
270
+ if (important.length >= maxLines) {
271
+ return important.slice(0, maxLines).map(i => lines[i]);
272
+ }
273
+ // Otherwise, include important lines plus context
274
+ const result = [];
275
+ const included = new Set();
276
+ for (const idx of important) {
277
+ // Include important line and 2 lines of context
278
+ for (let i = Math.max(0, idx - 2); i <= Math.min(lines.length - 1, idx + 2); i++) {
279
+ if (!included.has(i) && result.length < maxLines) {
280
+ included.add(i);
281
+ result.push(lines[i]);
282
+ }
283
+ }
284
+ if (result.length >= maxLines)
285
+ break;
286
+ }
287
+ return result;
288
+ }
289
+ /**
290
+ * Detect programming language from file path.
291
+ */
292
+ detectLanguage(filePath) {
293
+ const ext = filePath.split('.').pop()?.toLowerCase();
294
+ const langMap = {
295
+ ts: 'typescript',
296
+ tsx: 'typescript',
297
+ js: 'javascript',
298
+ jsx: 'javascript',
299
+ py: 'python',
300
+ go: 'go',
301
+ rs: 'rust',
302
+ java: 'java',
303
+ c: 'c',
304
+ cpp: 'cpp',
305
+ h: 'c',
306
+ };
307
+ return langMap[ext || ''] || '';
308
+ }
309
+ /**
310
+ * Capitalize relationship name for display.
311
+ */
312
+ capitalizeRelationship(rel) {
313
+ return rel
314
+ .split('_')
315
+ .map(word => word.charAt(0).toUpperCase() + word.slice(1))
316
+ .join(' ');
317
+ }
318
+ /**
319
+ * Estimate token count (rough heuristic: ~4 chars per token).
320
+ */
321
+ estimateTokens(text) {
322
+ return Math.ceil(text.length / 4);
323
+ }
324
+ /**
325
+ * Update formatting options.
326
+ */
327
+ updateOptions(options) {
328
+ this.options = { ...this.options, ...options };
329
+ }
330
+ /**
331
+ * Get current options.
332
+ */
333
+ getOptions() {
334
+ return { ...this.options };
335
+ }
336
+ }
337
+ exports.ContextFormatter = ContextFormatter;
338
+ //# sourceMappingURL=ContextFormatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ContextFormatter.js","sourceRoot":"","sources":["../../../src/agents/context/ContextFormatter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * GraphExpander
3
+ *
4
+ * Traverses the code knowledge graph to find related entities.
5
+ * Implements depth-limited BFS to prevent context explosion.
6
+ *
7
+ * Key relationships:
8
+ * - IMPORTS: Module dependencies
9
+ * - TESTS: Test-to-source mapping
10
+ * - CALLS: Function call graph
11
+ * - EXTENDS: Inheritance hierarchy
12
+ * - DEFINES: File-to-entity definitions
13
+ */
14
+ import { GraphBuilder } from '../../code-intelligence/graph/GraphBuilder.js';
15
+ import type { GraphNode, EdgeType } from '../../code-intelligence/graph/types.js';
16
+ export interface ExpansionConfig {
17
+ /** Maximum traversal depth (default: 2) */
18
+ maxDepth: number;
19
+ /** Maximum nodes to return (default: 20) */
20
+ maxNodes: number;
21
+ /** Edge types to follow (default: all) */
22
+ edgeTypes?: EdgeType[];
23
+ /** Direction to traverse (default: 'both') */
24
+ direction?: 'incoming' | 'outgoing' | 'both';
25
+ /** Minimum edge weight threshold (default: 0) */
26
+ minWeight?: number;
27
+ }
28
+ export interface ExpandedNode {
29
+ node: GraphNode;
30
+ depth: number;
31
+ path: string[];
32
+ relationship: EdgeType;
33
+ relationshipPath: EdgeType[];
34
+ }
35
+ export interface ExpansionResult {
36
+ nodes: ExpandedNode[];
37
+ totalNodesVisited: number;
38
+ maxDepthReached: number;
39
+ truncated: boolean;
40
+ executionTimeMs: number;
41
+ }
42
+ export declare class GraphExpander {
43
+ private graphBuilder;
44
+ private config;
45
+ constructor(graphBuilder: GraphBuilder, config?: Partial<ExpansionConfig>);
46
+ /**
47
+ * Expand context from a starting node.
48
+ */
49
+ expand(startNodeId: string, config?: Partial<ExpansionConfig>): ExpansionResult;
50
+ /**
51
+ * Expand from multiple starting nodes.
52
+ */
53
+ expandMultiple(startNodeIds: string[], config?: Partial<ExpansionConfig>): ExpansionResult;
54
+ /**
55
+ * Find related entities by type and relationship.
56
+ */
57
+ findRelated(startNodeId: string, relationshipType: EdgeType, maxResults?: number): ExpandedNode[];
58
+ /**
59
+ * Get imports for a file node.
60
+ */
61
+ getImports(fileNodeId: string): ExpandedNode[];
62
+ /**
63
+ * Get tests for a source file.
64
+ */
65
+ getTests(fileNodeId: string): ExpandedNode[];
66
+ /**
67
+ * Get callers of a function.
68
+ */
69
+ getCallers(functionNodeId: string): ExpandedNode[];
70
+ /**
71
+ * Get inheritance chain.
72
+ */
73
+ getInheritanceChain(classNodeId: string): ExpandedNode[];
74
+ /**
75
+ * Update expansion configuration.
76
+ */
77
+ updateConfig(config: Partial<ExpansionConfig>): void;
78
+ /**
79
+ * Get current configuration.
80
+ */
81
+ getConfig(): ExpansionConfig;
82
+ /**
83
+ * Get filtered edges based on config.
84
+ */
85
+ private getFilteredEdges;
86
+ }
87
+ //# sourceMappingURL=GraphExpander.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GraphExpander.d.ts","sourceRoot":"","sources":["../../../src/agents/context/GraphExpander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAa,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAE7F,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,QAAQ,CAAC;IACvB,gBAAgB,EAAE,QAAQ,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AASD,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAK7E;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe;IAwF/E;;OAEG;IACH,cAAc,CACZ,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,eAAe;IAsClB;;OAEG;IACH,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,QAAQ,EAC1B,UAAU,GAAE,MAAW,GACtB,YAAY,EAAE;IAUjB;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAI9C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAI5C;;OAEG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,EAAE;IAIlD;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAIxD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAIpD;;OAEG;IACH,SAAS,IAAI,eAAe;IAM5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAsCzB"}
@@ -0,0 +1,215 @@
1
+ "use strict";
2
+ /**
3
+ * GraphExpander
4
+ *
5
+ * Traverses the code knowledge graph to find related entities.
6
+ * Implements depth-limited BFS to prevent context explosion.
7
+ *
8
+ * Key relationships:
9
+ * - IMPORTS: Module dependencies
10
+ * - TESTS: Test-to-source mapping
11
+ * - CALLS: Function call graph
12
+ * - EXTENDS: Inheritance hierarchy
13
+ * - DEFINES: File-to-entity definitions
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.GraphExpander = void 0;
17
+ const DEFAULT_CONFIG = {
18
+ maxDepth: 2,
19
+ maxNodes: 20,
20
+ direction: 'both',
21
+ minWeight: 0,
22
+ };
23
+ class GraphExpander {
24
+ constructor(graphBuilder, config = {}) {
25
+ this.graphBuilder = graphBuilder;
26
+ this.config = { ...DEFAULT_CONFIG, ...config };
27
+ }
28
+ /**
29
+ * Expand context from a starting node.
30
+ */
31
+ expand(startNodeId, config) {
32
+ const startTime = Date.now();
33
+ const expansionConfig = { ...this.config, ...config };
34
+ const startNode = this.graphBuilder.getNode(startNodeId);
35
+ if (!startNode) {
36
+ return {
37
+ nodes: [],
38
+ totalNodesVisited: 0,
39
+ maxDepthReached: 0,
40
+ truncated: false,
41
+ executionTimeMs: Date.now() - startTime,
42
+ };
43
+ }
44
+ const result = [];
45
+ const visited = new Set([startNodeId]);
46
+ const queue = [];
47
+ // Initialize queue with starting node's neighbors
48
+ const startEdges = this.getFilteredEdges(startNodeId, expansionConfig, 0);
49
+ for (const { edge, targetNode } of startEdges) {
50
+ queue.push({
51
+ node: targetNode,
52
+ depth: 1,
53
+ path: [startNodeId, targetNode.id],
54
+ relationshipPath: [edge.type],
55
+ });
56
+ }
57
+ let maxDepthReached = 0;
58
+ let totalNodesVisited = 1; // Start node
59
+ // BFS traversal
60
+ while (queue.length > 0 && result.length < expansionConfig.maxNodes) {
61
+ const current = queue.shift();
62
+ // Skip if already visited
63
+ if (visited.has(current.node.id))
64
+ continue;
65
+ visited.add(current.node.id);
66
+ totalNodesVisited++;
67
+ maxDepthReached = Math.max(maxDepthReached, current.depth);
68
+ // Add to results
69
+ result.push({
70
+ node: current.node,
71
+ depth: current.depth,
72
+ path: current.path,
73
+ relationship: current.relationshipPath[current.relationshipPath.length - 1],
74
+ relationshipPath: current.relationshipPath,
75
+ });
76
+ // Continue traversal if within depth limit
77
+ if (current.depth < expansionConfig.maxDepth) {
78
+ const edges = this.getFilteredEdges(current.node.id, expansionConfig, current.depth);
79
+ for (const { edge, targetNode } of edges) {
80
+ if (!visited.has(targetNode.id)) {
81
+ queue.push({
82
+ node: targetNode,
83
+ depth: current.depth + 1,
84
+ path: [...current.path, targetNode.id],
85
+ relationshipPath: [...current.relationshipPath, edge.type],
86
+ });
87
+ }
88
+ }
89
+ }
90
+ }
91
+ return {
92
+ nodes: result,
93
+ totalNodesVisited,
94
+ maxDepthReached,
95
+ truncated: queue.length > 0 || result.length >= expansionConfig.maxNodes,
96
+ executionTimeMs: Date.now() - startTime,
97
+ };
98
+ }
99
+ /**
100
+ * Expand from multiple starting nodes.
101
+ */
102
+ expandMultiple(startNodeIds, config) {
103
+ const startTime = Date.now();
104
+ const expansionConfig = { ...this.config, ...config };
105
+ const allNodes = [];
106
+ const globalVisited = new Set();
107
+ let totalNodesVisited = 0;
108
+ let maxDepthReached = 0;
109
+ for (const startNodeId of startNodeIds) {
110
+ if (allNodes.length >= expansionConfig.maxNodes)
111
+ break;
112
+ const result = this.expand(startNodeId, {
113
+ ...expansionConfig,
114
+ maxNodes: expansionConfig.maxNodes - allNodes.length,
115
+ });
116
+ // Add nodes not already in global visited
117
+ for (const expandedNode of result.nodes) {
118
+ if (!globalVisited.has(expandedNode.node.id)) {
119
+ allNodes.push(expandedNode);
120
+ globalVisited.add(expandedNode.node.id);
121
+ }
122
+ }
123
+ totalNodesVisited += result.totalNodesVisited;
124
+ maxDepthReached = Math.max(maxDepthReached, result.maxDepthReached);
125
+ }
126
+ return {
127
+ nodes: allNodes,
128
+ totalNodesVisited,
129
+ maxDepthReached,
130
+ truncated: allNodes.length >= expansionConfig.maxNodes,
131
+ executionTimeMs: Date.now() - startTime,
132
+ };
133
+ }
134
+ /**
135
+ * Find related entities by type and relationship.
136
+ */
137
+ findRelated(startNodeId, relationshipType, maxResults = 10) {
138
+ const result = this.expand(startNodeId, {
139
+ maxDepth: 2,
140
+ maxNodes: maxResults,
141
+ edgeTypes: [relationshipType],
142
+ });
143
+ return result.nodes;
144
+ }
145
+ /**
146
+ * Get imports for a file node.
147
+ */
148
+ getImports(fileNodeId) {
149
+ return this.findRelated(fileNodeId, 'imports', 50);
150
+ }
151
+ /**
152
+ * Get tests for a source file.
153
+ */
154
+ getTests(fileNodeId) {
155
+ return this.findRelated(fileNodeId, 'tests', 20);
156
+ }
157
+ /**
158
+ * Get callers of a function.
159
+ */
160
+ getCallers(functionNodeId) {
161
+ return this.findRelated(functionNodeId, 'calls', 20);
162
+ }
163
+ /**
164
+ * Get inheritance chain.
165
+ */
166
+ getInheritanceChain(classNodeId) {
167
+ return this.findRelated(classNodeId, 'extends', 10);
168
+ }
169
+ /**
170
+ * Update expansion configuration.
171
+ */
172
+ updateConfig(config) {
173
+ this.config = { ...this.config, ...config };
174
+ }
175
+ /**
176
+ * Get current configuration.
177
+ */
178
+ getConfig() {
179
+ return { ...this.config };
180
+ }
181
+ // === Private Methods ===
182
+ /**
183
+ * Get filtered edges based on config.
184
+ */
185
+ getFilteredEdges(nodeId, config, currentDepth) {
186
+ const results = [];
187
+ // Get edges based on direction
188
+ const edges = [];
189
+ if (config.direction === 'outgoing' || config.direction === 'both') {
190
+ edges.push(...this.graphBuilder.getOutgoingEdges(nodeId));
191
+ }
192
+ if (config.direction === 'incoming' || config.direction === 'both') {
193
+ edges.push(...this.graphBuilder.getIncomingEdges(nodeId));
194
+ }
195
+ for (const edge of edges) {
196
+ // Filter by edge type
197
+ if (config.edgeTypes && !config.edgeTypes.includes(edge.type)) {
198
+ continue;
199
+ }
200
+ // Filter by weight
201
+ if (config.minWeight && edge.weight < config.minWeight) {
202
+ continue;
203
+ }
204
+ // Get target node
205
+ const targetId = edge.source === nodeId ? edge.target : edge.source;
206
+ const targetNode = this.graphBuilder.getNode(targetId);
207
+ if (targetNode) {
208
+ results.push({ edge, targetNode });
209
+ }
210
+ }
211
+ return results;
212
+ }
213
+ }
214
+ exports.GraphExpander = GraphExpander;
215
+ //# sourceMappingURL=GraphExpander.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GraphExpander.js","sourceRoot":"","sources":["../../../src/agents/context/GraphExpander.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAkCH,MAAM,cAAc,GAAoB;IACtC,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,CAAC;CACb,CAAC;AAEF,MAAa,aAAa;IAIxB,YAAY,YAA0B,EAAE,SAAmC,EAAE;QAC3E,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAmB,EAAE,MAAiC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAEtD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,iBAAiB,EAAE,CAAC;gBACpB,eAAe,EAAE,CAAC;gBAClB,SAAS,EAAE,KAAK;gBAChB,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACxC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAKN,EAAE,CAAC;QAER,kDAAkD;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,UAAU,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;gBAClC,gBAAgB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,iBAAiB,GAAG,CAAC,CAAC,CAAC,aAAa;QAExC,gBAAgB;QAChB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;YACpE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAE/B,0BAA0B;YAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YAE3C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,iBAAiB,EAAE,CAAC;YACpB,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAE3D,iBAAiB;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC3E,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C,CAAC,CAAC;YAEH,2CAA2C;YAC3C,IAAI,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CACjC,OAAO,CAAC,IAAI,CAAC,EAAE,EACf,eAAe,EACf,OAAO,CAAC,KAAK,CACd,CAAC;gBAEF,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,KAAK,EAAE,CAAC;oBACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;wBAChC,KAAK,CAAC,IAAI,CAAC;4BACT,IAAI,EAAE,UAAU;4BAChB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;4BACxB,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC;4BACtC,gBAAgB,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC;yBAC3D,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM;YACb,iBAAiB;YACjB,eAAe;YACf,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,QAAQ;YACxE,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,YAAsB,EACtB,MAAiC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAEtD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,QAAQ;gBAAE,MAAM;YAEvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;gBACtC,GAAG,eAAe;gBAClB,QAAQ,EAAE,eAAe,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM;aACrD,CAAC,CAAC;YAEH,0CAA0C;YAC1C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC7C,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC5B,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAED,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,CAAC;YAC9C,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QACtE,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,iBAAiB;YACjB,eAAe;YACf,SAAS,EAAE,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,QAAQ;YACtD,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CACT,WAAmB,EACnB,gBAA0B,EAC1B,aAAqB,EAAE;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YACtC,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,CAAC,gBAAgB,CAAC;SAC9B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,cAAsB;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,WAAmB;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAgC;QAC3C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,0BAA0B;IAE1B;;OAEG;IACK,gBAAgB,CACtB,MAAc,EACd,MAAuB,EACvB,YAAoB;QAEpB,MAAM,OAAO,GAAsD,EAAE,CAAC;QAEtE,+BAA+B;QAC/B,MAAM,KAAK,GAAgB,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,SAAS,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,sBAAsB;YACtB,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,mBAAmB;YACnB,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,kBAAkB;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEvD,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAtPD,sCAsPC"}