spectra-cli 4.1.1 → 4.2.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 (422) hide show
  1. package/README.md +1 -1
  2. package/dist/adapters/go-adapter.d.ts.map +1 -1
  3. package/dist/adapters/go-adapter.js +2 -0
  4. package/dist/adapters/go-adapter.js.map +1 -1
  5. package/dist/adapters/index.d.ts +1 -1
  6. package/dist/adapters/index.d.ts.map +1 -1
  7. package/dist/adapters/java-adapter.d.ts.map +1 -1
  8. package/dist/adapters/java-adapter.js +2 -0
  9. package/dist/adapters/java-adapter.js.map +1 -1
  10. package/dist/adapters/language-adapter.d.ts +47 -9
  11. package/dist/adapters/language-adapter.d.ts.map +1 -1
  12. package/dist/adapters/python-adapter.d.ts +34 -6
  13. package/dist/adapters/python-adapter.d.ts.map +1 -1
  14. package/dist/adapters/python-adapter.js +157 -59
  15. package/dist/adapters/python-adapter.js.map +1 -1
  16. package/dist/adapters/ts-js-adapter.d.ts +13 -5
  17. package/dist/adapters/ts-js-adapter.d.ts.map +1 -1
  18. package/dist/adapters/ts-js-adapter.js +55 -14
  19. package/dist/adapters/ts-js-adapter.js.map +1 -1
  20. package/dist/batch/batch-orchestrator.d.ts +30 -4
  21. package/dist/batch/batch-orchestrator.d.ts.map +1 -1
  22. package/dist/batch/batch-orchestrator.js +284 -7
  23. package/dist/batch/batch-orchestrator.js.map +1 -1
  24. package/dist/batch/delta-regenerator.d.ts +2 -2
  25. package/dist/batch/delta-regenerator.d.ts.map +1 -1
  26. package/dist/batch/delta-regenerator.js.map +1 -1
  27. package/dist/batch/module-grouper.d.ts +2 -2
  28. package/dist/batch/module-grouper.d.ts.map +1 -1
  29. package/dist/batch/module-grouper.js +1 -1
  30. package/dist/batch/module-grouper.js.map +1 -1
  31. package/dist/cli/commands/graph.js +1 -1
  32. package/dist/cli/commands/graph.js.map +1 -1
  33. package/dist/cli/commands/index.d.ts +8 -0
  34. package/dist/cli/commands/index.d.ts.map +1 -0
  35. package/dist/cli/commands/index.js +274 -0
  36. package/dist/cli/commands/index.js.map +1 -0
  37. package/dist/cli/commands/query.d.ts.map +1 -1
  38. package/dist/cli/commands/query.js +3 -1
  39. package/dist/cli/commands/query.js.map +1 -1
  40. package/dist/cli/index.js +9 -9
  41. package/dist/cli/index.js.map +1 -1
  42. package/dist/cli/utils/parse-args.d.ts +13 -1
  43. package/dist/cli/utils/parse-args.d.ts.map +1 -1
  44. package/dist/cli/utils/parse-args.js +79 -2
  45. package/dist/cli/utils/parse-args.js.map +1 -1
  46. package/dist/core/ast-analyzer.d.ts.map +1 -1
  47. package/dist/core/ast-analyzer.js +79 -5
  48. package/dist/core/ast-analyzer.js.map +1 -1
  49. package/dist/core/import-resolver.d.ts +90 -0
  50. package/dist/core/import-resolver.d.ts.map +1 -0
  51. package/dist/core/import-resolver.js +273 -0
  52. package/dist/core/import-resolver.js.map +1 -0
  53. package/dist/core/query-mappers/base-mapper.d.ts +13 -0
  54. package/dist/core/query-mappers/base-mapper.d.ts.map +1 -1
  55. package/dist/core/query-mappers/go-mapper.d.ts +68 -0
  56. package/dist/core/query-mappers/go-mapper.d.ts.map +1 -1
  57. package/dist/core/query-mappers/go-mapper.js +421 -0
  58. package/dist/core/query-mappers/go-mapper.js.map +1 -1
  59. package/dist/core/query-mappers/java-mapper.d.ts +196 -0
  60. package/dist/core/query-mappers/java-mapper.d.ts.map +1 -1
  61. package/dist/core/query-mappers/java-mapper.js +600 -0
  62. package/dist/core/query-mappers/java-mapper.js.map +1 -1
  63. package/dist/core/query-mappers/python-mapper.d.ts +55 -0
  64. package/dist/core/query-mappers/python-mapper.d.ts.map +1 -1
  65. package/dist/core/query-mappers/python-mapper.js +273 -0
  66. package/dist/core/query-mappers/python-mapper.js.map +1 -1
  67. package/dist/core/query-mappers/typescript-mapper.d.ts +102 -0
  68. package/dist/core/query-mappers/typescript-mapper.d.ts.map +1 -1
  69. package/dist/core/query-mappers/typescript-mapper.js +470 -0
  70. package/dist/core/query-mappers/typescript-mapper.js.map +1 -1
  71. package/dist/core/single-spec-orchestrator.d.ts.map +1 -1
  72. package/dist/core/single-spec-orchestrator.js +146 -9
  73. package/dist/core/single-spec-orchestrator.js.map +1 -1
  74. package/dist/core/tree-sitter-analyzer.d.ts +6 -0
  75. package/dist/core/tree-sitter-analyzer.d.ts.map +1 -1
  76. package/dist/core/tree-sitter-analyzer.js +33 -1
  77. package/dist/core/tree-sitter-analyzer.js.map +1 -1
  78. package/dist/core/tree-sitter-fallback.d.ts +7 -4
  79. package/dist/core/tree-sitter-fallback.d.ts.map +1 -1
  80. package/dist/core/tree-sitter-fallback.js +157 -12
  81. package/dist/core/tree-sitter-fallback.js.map +1 -1
  82. package/dist/extraction/extraction-types.d.ts +25 -25
  83. package/dist/generator/index-generator.d.ts +3 -3
  84. package/dist/generator/index-generator.d.ts.map +1 -1
  85. package/dist/generator/index-generator.js +1 -1
  86. package/dist/generator/index-generator.js.map +1 -1
  87. package/dist/graph/directory-graph.d.ts +14 -4
  88. package/dist/graph/directory-graph.d.ts.map +1 -1
  89. package/dist/graph/directory-graph.js +71 -128
  90. package/dist/graph/directory-graph.js.map +1 -1
  91. package/dist/graph/mermaid-renderer.d.ts +8 -5
  92. package/dist/graph/mermaid-renderer.d.ts.map +1 -1
  93. package/dist/graph/mermaid-renderer.js +3 -3
  94. package/dist/graph/mermaid-renderer.js.map +1 -1
  95. package/dist/graph/topological-sort.d.ts +13 -6
  96. package/dist/graph/topological-sort.d.ts.map +1 -1
  97. package/dist/graph/topological-sort.js +2 -2
  98. package/dist/graph/topological-sort.js.map +1 -1
  99. package/dist/knowledge-graph/call-resolver.d.ts +64 -0
  100. package/dist/knowledge-graph/call-resolver.d.ts.map +1 -0
  101. package/dist/knowledge-graph/call-resolver.js +323 -0
  102. package/dist/knowledge-graph/call-resolver.js.map +1 -0
  103. package/dist/knowledge-graph/import-resolver.d.ts +114 -0
  104. package/dist/knowledge-graph/import-resolver.d.ts.map +1 -0
  105. package/dist/knowledge-graph/import-resolver.js +537 -0
  106. package/dist/knowledge-graph/import-resolver.js.map +1 -0
  107. package/dist/knowledge-graph/incremental.d.ts +110 -0
  108. package/dist/knowledge-graph/incremental.d.ts.map +1 -0
  109. package/dist/knowledge-graph/incremental.js +410 -0
  110. package/dist/knowledge-graph/incremental.js.map +1 -0
  111. package/dist/knowledge-graph/index.d.ts +74 -0
  112. package/dist/knowledge-graph/index.d.ts.map +1 -0
  113. package/dist/knowledge-graph/index.js +156 -0
  114. package/dist/knowledge-graph/index.js.map +1 -0
  115. package/dist/knowledge-graph/module-derivation.d.ts +238 -0
  116. package/dist/knowledge-graph/module-derivation.d.ts.map +1 -0
  117. package/dist/knowledge-graph/module-derivation.js +418 -0
  118. package/dist/knowledge-graph/module-derivation.js.map +1 -0
  119. package/dist/knowledge-graph/persistence.d.ts +270 -0
  120. package/dist/knowledge-graph/persistence.d.ts.map +1 -0
  121. package/dist/knowledge-graph/persistence.js +226 -0
  122. package/dist/knowledge-graph/persistence.js.map +1 -0
  123. package/dist/knowledge-graph/query-helpers.d.ts +164 -0
  124. package/dist/knowledge-graph/query-helpers.d.ts.map +1 -0
  125. package/dist/knowledge-graph/query-helpers.js +394 -0
  126. package/dist/knowledge-graph/query-helpers.js.map +1 -0
  127. package/dist/knowledge-graph/unified-graph.d.ts +310 -0
  128. package/dist/knowledge-graph/unified-graph.d.ts.map +1 -0
  129. package/dist/knowledge-graph/unified-graph.js +182 -0
  130. package/dist/knowledge-graph/unified-graph.js.map +1 -0
  131. package/dist/mcp/agent-context-tools.d.ts +104 -0
  132. package/dist/mcp/agent-context-tools.d.ts.map +1 -0
  133. package/dist/mcp/agent-context-tools.js +854 -0
  134. package/dist/mcp/agent-context-tools.js.map +1 -0
  135. package/dist/mcp/graph-tools.d.ts +20 -0
  136. package/dist/mcp/graph-tools.d.ts.map +1 -1
  137. package/dist/mcp/graph-tools.js +71 -11
  138. package/dist/mcp/graph-tools.js.map +1 -1
  139. package/dist/mcp/lib/response-helpers.d.ts +67 -0
  140. package/dist/mcp/lib/response-helpers.d.ts.map +1 -0
  141. package/dist/mcp/lib/response-helpers.js +103 -0
  142. package/dist/mcp/lib/response-helpers.js.map +1 -0
  143. package/dist/mcp/server.d.ts +3 -1
  144. package/dist/mcp/server.d.ts.map +1 -1
  145. package/dist/mcp/server.js +9 -10
  146. package/dist/mcp/server.js.map +1 -1
  147. package/dist/models/call-site.d.ts +68 -0
  148. package/dist/models/call-site.d.ts.map +1 -0
  149. package/dist/models/call-site.js +60 -0
  150. package/dist/models/call-site.js.map +1 -0
  151. package/dist/models/code-skeleton.d.ts +78 -6
  152. package/dist/models/code-skeleton.d.ts.map +1 -1
  153. package/dist/models/code-skeleton.js +29 -0
  154. package/dist/models/code-skeleton.js.map +1 -1
  155. package/dist/models/drift-item.d.ts +4 -4
  156. package/dist/models/module-spec.d.ts +155 -94
  157. package/dist/models/module-spec.d.ts.map +1 -1
  158. package/dist/panoramic/adr-decision-pipeline.d.ts +53 -0
  159. package/dist/panoramic/adr-decision-pipeline.d.ts.map +1 -0
  160. package/dist/panoramic/adr-decision-pipeline.js +685 -0
  161. package/dist/panoramic/adr-decision-pipeline.js.map +1 -0
  162. package/dist/panoramic/api-surface-generator.d.ts +56 -0
  163. package/dist/panoramic/api-surface-generator.d.ts.map +1 -0
  164. package/dist/panoramic/api-surface-generator.js +1671 -0
  165. package/dist/panoramic/api-surface-generator.js.map +1 -0
  166. package/dist/panoramic/architecture-ir-builder.d.ts +19 -0
  167. package/dist/panoramic/architecture-ir-builder.d.ts.map +1 -0
  168. package/dist/panoramic/architecture-ir-builder.js +561 -0
  169. package/dist/panoramic/architecture-ir-builder.js.map +1 -0
  170. package/dist/panoramic/architecture-ir-exporters.d.ts +7 -0
  171. package/dist/panoramic/architecture-ir-exporters.d.ts.map +1 -0
  172. package/dist/panoramic/architecture-ir-exporters.js +183 -0
  173. package/dist/panoramic/architecture-ir-exporters.js.map +1 -0
  174. package/dist/panoramic/architecture-ir-generator.d.ts +36 -0
  175. package/dist/panoramic/architecture-ir-generator.d.ts.map +1 -0
  176. package/dist/panoramic/architecture-ir-generator.js +51 -0
  177. package/dist/panoramic/architecture-ir-generator.js.map +1 -0
  178. package/dist/panoramic/architecture-ir-mermaid-adapter.d.ts +6 -0
  179. package/dist/panoramic/architecture-ir-mermaid-adapter.d.ts.map +1 -0
  180. package/dist/panoramic/architecture-ir-mermaid-adapter.js +98 -0
  181. package/dist/panoramic/architecture-ir-mermaid-adapter.js.map +1 -0
  182. package/dist/panoramic/architecture-ir-model.d.ts +87 -0
  183. package/dist/panoramic/architecture-ir-model.d.ts.map +1 -0
  184. package/dist/panoramic/architecture-ir-model.js +20 -0
  185. package/dist/panoramic/architecture-ir-model.js.map +1 -0
  186. package/dist/panoramic/architecture-narrative.d.ts +68 -0
  187. package/dist/panoramic/architecture-narrative.d.ts.map +1 -0
  188. package/dist/panoramic/architecture-narrative.js +401 -0
  189. package/dist/panoramic/architecture-narrative.js.map +1 -0
  190. package/dist/panoramic/architecture-overview-generator.d.ts +31 -0
  191. package/dist/panoramic/architecture-overview-generator.d.ts.map +1 -0
  192. package/dist/panoramic/architecture-overview-generator.js +454 -0
  193. package/dist/panoramic/architecture-overview-generator.js.map +1 -0
  194. package/dist/panoramic/architecture-overview-model.d.ts +77 -0
  195. package/dist/panoramic/architecture-overview-model.d.ts.map +1 -0
  196. package/dist/panoramic/architecture-overview-model.js +31 -0
  197. package/dist/panoramic/architecture-overview-model.js.map +1 -0
  198. package/dist/panoramic/batch-project-docs.d.ts.map +1 -1
  199. package/dist/panoramic/batch-project-docs.js +4 -2
  200. package/dist/panoramic/batch-project-docs.js.map +1 -1
  201. package/dist/panoramic/builders/component-view-builder.d.ts +25 -1
  202. package/dist/panoramic/builders/component-view-builder.d.ts.map +1 -1
  203. package/dist/panoramic/builders/component-view-builder.js +83 -3
  204. package/dist/panoramic/builders/component-view-builder.js.map +1 -1
  205. package/dist/panoramic/builders/doc-graph-builder.d.ts +2 -2
  206. package/dist/panoramic/builders/doc-graph-builder.d.ts.map +1 -1
  207. package/dist/panoramic/builders/doc-graph-builder.js.map +1 -1
  208. package/dist/panoramic/component-view-builder.d.ts +17 -0
  209. package/dist/panoramic/component-view-builder.d.ts.map +1 -0
  210. package/dist/panoramic/component-view-builder.js +652 -0
  211. package/dist/panoramic/component-view-builder.js.map +1 -0
  212. package/dist/panoramic/component-view-model.d.ts +127 -0
  213. package/dist/panoramic/component-view-model.d.ts.map +1 -0
  214. package/dist/panoramic/component-view-model.js +65 -0
  215. package/dist/panoramic/component-view-model.js.map +1 -0
  216. package/dist/panoramic/config-reference-generator.d.ts +78 -0
  217. package/dist/panoramic/config-reference-generator.d.ts.map +1 -0
  218. package/dist/panoramic/config-reference-generator.js +199 -0
  219. package/dist/panoramic/config-reference-generator.js.map +1 -0
  220. package/dist/panoramic/coverage-auditor.d.ts +95 -0
  221. package/dist/panoramic/coverage-auditor.d.ts.map +1 -0
  222. package/dist/panoramic/coverage-auditor.js +290 -0
  223. package/dist/panoramic/coverage-auditor.js.map +1 -0
  224. package/dist/panoramic/cross-package-analyzer.d.ts +112 -0
  225. package/dist/panoramic/cross-package-analyzer.d.ts.map +1 -0
  226. package/dist/panoramic/cross-package-analyzer.js +258 -0
  227. package/dist/panoramic/cross-package-analyzer.js.map +1 -0
  228. package/dist/panoramic/data-model-generator.d.ts +528 -0
  229. package/dist/panoramic/data-model-generator.d.ts.map +1 -0
  230. package/dist/panoramic/data-model-generator.js +647 -0
  231. package/dist/panoramic/data-model-generator.js.map +1 -0
  232. package/dist/panoramic/doc-graph-builder.d.ts +80 -0
  233. package/dist/panoramic/doc-graph-builder.d.ts.map +1 -0
  234. package/dist/panoramic/doc-graph-builder.js +352 -0
  235. package/dist/panoramic/doc-graph-builder.js.map +1 -0
  236. package/dist/panoramic/docs-bundle-manifest-reader.d.ts +26 -0
  237. package/dist/panoramic/docs-bundle-manifest-reader.d.ts.map +1 -0
  238. package/dist/panoramic/docs-bundle-manifest-reader.js +106 -0
  239. package/dist/panoramic/docs-bundle-manifest-reader.js.map +1 -0
  240. package/dist/panoramic/docs-bundle-orchestrator.d.ts +14 -0
  241. package/dist/panoramic/docs-bundle-orchestrator.d.ts.map +1 -0
  242. package/dist/panoramic/docs-bundle-orchestrator.js +538 -0
  243. package/dist/panoramic/docs-bundle-orchestrator.js.map +1 -0
  244. package/dist/panoramic/docs-bundle-profiles.d.ts +4 -0
  245. package/dist/panoramic/docs-bundle-profiles.d.ts.map +1 -0
  246. package/dist/panoramic/docs-bundle-profiles.js +82 -0
  247. package/dist/panoramic/docs-bundle-profiles.js.map +1 -0
  248. package/dist/panoramic/docs-bundle-types.d.ts +94 -0
  249. package/dist/panoramic/docs-bundle-types.d.ts.map +1 -0
  250. package/dist/panoramic/docs-bundle-types.js +10 -0
  251. package/dist/panoramic/docs-bundle-types.js.map +1 -0
  252. package/dist/panoramic/docs-quality-evaluator.d.ts +31 -0
  253. package/dist/panoramic/docs-quality-evaluator.d.ts.map +1 -0
  254. package/dist/panoramic/docs-quality-evaluator.js +941 -0
  255. package/dist/panoramic/docs-quality-evaluator.js.map +1 -0
  256. package/dist/panoramic/docs-quality-model.d.ts +125 -0
  257. package/dist/panoramic/docs-quality-model.d.ts.map +1 -0
  258. package/dist/panoramic/docs-quality-model.js +166 -0
  259. package/dist/panoramic/docs-quality-model.js.map +1 -0
  260. package/dist/panoramic/dynamic-scenarios-builder.d.ts +18 -0
  261. package/dist/panoramic/dynamic-scenarios-builder.d.ts.map +1 -0
  262. package/dist/panoramic/dynamic-scenarios-builder.js +316 -0
  263. package/dist/panoramic/dynamic-scenarios-builder.js.map +1 -0
  264. package/dist/panoramic/event-surface-generator.d.ts +52 -0
  265. package/dist/panoramic/event-surface-generator.d.ts.map +1 -0
  266. package/dist/panoramic/event-surface-generator.js +507 -0
  267. package/dist/panoramic/event-surface-generator.js.map +1 -0
  268. package/dist/panoramic/generator-registry.d.ts +1 -1
  269. package/dist/panoramic/generator-registry.d.ts.map +1 -1
  270. package/dist/panoramic/generator-registry.js +5 -2
  271. package/dist/panoramic/generator-registry.js.map +1 -1
  272. package/dist/panoramic/generators/cross-package-analyzer.d.ts +5 -5
  273. package/dist/panoramic/generators/cross-package-analyzer.d.ts.map +1 -1
  274. package/dist/panoramic/generators/cross-package-analyzer.js +1 -1
  275. package/dist/panoramic/generators/cross-package-analyzer.js.map +1 -1
  276. package/dist/panoramic/generators/data-model-generator.d.ts +27 -27
  277. package/dist/panoramic/graph/confidence-mapper.d.ts +18 -0
  278. package/dist/panoramic/graph/confidence-mapper.d.ts.map +1 -1
  279. package/dist/panoramic/graph/confidence-mapper.js +26 -0
  280. package/dist/panoramic/graph/confidence-mapper.js.map +1 -1
  281. package/dist/panoramic/graph/graph-builder.d.ts.map +1 -1
  282. package/dist/panoramic/graph/graph-builder.js +78 -0
  283. package/dist/panoramic/graph/graph-builder.js.map +1 -1
  284. package/dist/panoramic/graph/graph-paths.d.ts +8 -0
  285. package/dist/panoramic/graph/graph-paths.d.ts.map +1 -1
  286. package/dist/panoramic/graph/graph-paths.js +10 -0
  287. package/dist/panoramic/graph/graph-paths.js.map +1 -1
  288. package/dist/panoramic/graph/graph-query.d.ts +33 -2
  289. package/dist/panoramic/graph/graph-query.d.ts.map +1 -1
  290. package/dist/panoramic/graph/graph-query.js +69 -19
  291. package/dist/panoramic/graph/graph-query.js.map +1 -1
  292. package/dist/panoramic/graph/graph-types.d.ts +32 -3
  293. package/dist/panoramic/graph/graph-types.d.ts.map +1 -1
  294. package/dist/panoramic/hyperedges/schema.d.ts +6 -6
  295. package/dist/panoramic/interface-surface-generator.d.ts +50 -0
  296. package/dist/panoramic/interface-surface-generator.d.ts.map +1 -0
  297. package/dist/panoramic/interface-surface-generator.js +388 -0
  298. package/dist/panoramic/interface-surface-generator.js.map +1 -0
  299. package/dist/panoramic/interfaces.d.ts +2 -2
  300. package/dist/panoramic/mock-readme-generator.d.ts +90 -0
  301. package/dist/panoramic/mock-readme-generator.d.ts.map +1 -0
  302. package/dist/panoramic/mock-readme-generator.js +111 -0
  303. package/dist/panoramic/mock-readme-generator.js.map +1 -0
  304. package/dist/panoramic/models/component-view-model.d.ts +1 -1
  305. package/dist/panoramic/models/component-view-model.d.ts.map +1 -1
  306. package/dist/panoramic/models/component-view-model.js.map +1 -1
  307. package/dist/panoramic/narrative-provenance-adapter.d.ts +8 -0
  308. package/dist/panoramic/narrative-provenance-adapter.d.ts.map +1 -0
  309. package/dist/panoramic/narrative-provenance-adapter.js +99 -0
  310. package/dist/panoramic/narrative-provenance-adapter.js.map +1 -0
  311. package/dist/panoramic/parser-registry.d.ts +1 -1
  312. package/dist/panoramic/parser-registry.js +1 -1
  313. package/dist/panoramic/parsers/types.d.ts +6 -6
  314. package/dist/panoramic/pattern-hints-generator.d.ts +28 -0
  315. package/dist/panoramic/pattern-hints-generator.d.ts.map +1 -0
  316. package/dist/panoramic/pattern-hints-generator.js +218 -0
  317. package/dist/panoramic/pattern-hints-generator.js.map +1 -0
  318. package/dist/panoramic/pattern-hints-model.d.ts +89 -0
  319. package/dist/panoramic/pattern-hints-model.d.ts.map +1 -0
  320. package/dist/panoramic/pattern-hints-model.js +61 -0
  321. package/dist/panoramic/pattern-hints-model.js.map +1 -0
  322. package/dist/panoramic/pattern-knowledge-base.d.ts +31 -0
  323. package/dist/panoramic/pattern-knowledge-base.d.ts.map +1 -0
  324. package/dist/panoramic/pattern-knowledge-base.js +407 -0
  325. package/dist/panoramic/pattern-knowledge-base.js.map +1 -0
  326. package/dist/panoramic/pipelines/coverage-auditor.d.ts.map +1 -1
  327. package/dist/panoramic/pipelines/coverage-auditor.js +4 -2
  328. package/dist/panoramic/pipelines/coverage-auditor.js.map +1 -1
  329. package/dist/panoramic/pipelines/docs-bundle-orchestrator.js +13 -6
  330. package/dist/panoramic/pipelines/docs-bundle-orchestrator.js.map +1 -1
  331. package/dist/panoramic/pipelines/product-ux-docs.d.ts +5 -0
  332. package/dist/panoramic/pipelines/product-ux-docs.d.ts.map +1 -1
  333. package/dist/panoramic/pipelines/product-ux-docs.js +34 -6
  334. package/dist/panoramic/pipelines/product-ux-docs.js.map +1 -1
  335. package/dist/panoramic/product-ux-docs.d.ts +104 -0
  336. package/dist/panoramic/product-ux-docs.d.ts.map +1 -0
  337. package/dist/panoramic/product-ux-docs.js +817 -0
  338. package/dist/panoramic/product-ux-docs.js.map +1 -0
  339. package/dist/panoramic/qa/__tests__/citation.test.d.ts +2 -0
  340. package/dist/panoramic/qa/__tests__/citation.test.d.ts.map +1 -0
  341. package/dist/panoramic/qa/__tests__/citation.test.js +193 -0
  342. package/dist/panoramic/qa/__tests__/citation.test.js.map +1 -0
  343. package/dist/panoramic/qa/__tests__/debt-context.test.d.ts +2 -0
  344. package/dist/panoramic/qa/__tests__/debt-context.test.d.ts.map +1 -0
  345. package/dist/panoramic/qa/__tests__/debt-context.test.js +154 -0
  346. package/dist/panoramic/qa/__tests__/debt-context.test.js.map +1 -0
  347. package/dist/panoramic/qa/__tests__/graph-retriever.test.d.ts +2 -0
  348. package/dist/panoramic/qa/__tests__/graph-retriever.test.d.ts.map +1 -0
  349. package/dist/panoramic/qa/__tests__/graph-retriever.test.js +148 -0
  350. package/dist/panoramic/qa/__tests__/graph-retriever.test.js.map +1 -0
  351. package/dist/panoramic/qa/__tests__/index.test.d.ts +2 -0
  352. package/dist/panoramic/qa/__tests__/index.test.d.ts.map +1 -0
  353. package/dist/panoramic/qa/__tests__/index.test.js +246 -0
  354. package/dist/panoramic/qa/__tests__/index.test.js.map +1 -0
  355. package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts +2 -0
  356. package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts.map +1 -0
  357. package/dist/panoramic/qa/__tests__/llm-caller.test.js +168 -0
  358. package/dist/panoramic/qa/__tests__/llm-caller.test.js.map +1 -0
  359. package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts +2 -0
  360. package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts.map +1 -0
  361. package/dist/panoramic/qa/__tests__/prompt-builder.test.js +150 -0
  362. package/dist/panoramic/qa/__tests__/prompt-builder.test.js.map +1 -0
  363. package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts +2 -0
  364. package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts.map +1 -0
  365. package/dist/panoramic/qa/__tests__/qa-integration.test.js +296 -0
  366. package/dist/panoramic/qa/__tests__/qa-integration.test.js.map +1 -0
  367. package/dist/panoramic/qa/__tests__/rag-reranker.test.d.ts +2 -0
  368. package/dist/panoramic/qa/__tests__/rag-reranker.test.d.ts.map +1 -0
  369. package/dist/panoramic/qa/__tests__/rag-reranker.test.js +136 -0
  370. package/dist/panoramic/qa/__tests__/rag-reranker.test.js.map +1 -0
  371. package/dist/panoramic/qa/index.d.ts.map +1 -1
  372. package/dist/panoramic/qa/index.js +10 -3
  373. package/dist/panoramic/qa/index.js.map +1 -1
  374. package/dist/panoramic/runtime-topology-generator.d.ts +77 -0
  375. package/dist/panoramic/runtime-topology-generator.d.ts.map +1 -0
  376. package/dist/panoramic/runtime-topology-generator.js +676 -0
  377. package/dist/panoramic/runtime-topology-generator.js.map +1 -0
  378. package/dist/panoramic/runtime-topology-model.d.ts +145 -0
  379. package/dist/panoramic/runtime-topology-model.d.ts.map +1 -0
  380. package/dist/panoramic/runtime-topology-model.js +300 -0
  381. package/dist/panoramic/runtime-topology-model.js.map +1 -0
  382. package/dist/panoramic/troubleshooting-generator.d.ts +51 -0
  383. package/dist/panoramic/troubleshooting-generator.d.ts.map +1 -0
  384. package/dist/panoramic/troubleshooting-generator.js +451 -0
  385. package/dist/panoramic/troubleshooting-generator.js.map +1 -0
  386. package/dist/panoramic/utils/text-segmenter.d.ts +15 -0
  387. package/dist/panoramic/utils/text-segmenter.d.ts.map +1 -1
  388. package/dist/panoramic/utils/text-segmenter.js +38 -0
  389. package/dist/panoramic/utils/text-segmenter.js.map +1 -1
  390. package/dist/panoramic/workspace-index-generator.d.ts +148 -0
  391. package/dist/panoramic/workspace-index-generator.d.ts.map +1 -0
  392. package/dist/panoramic/workspace-index-generator.js +497 -0
  393. package/dist/panoramic/workspace-index-generator.js.map +1 -0
  394. package/dist/runtime-bootstrap.d.ts +9 -0
  395. package/dist/runtime-bootstrap.d.ts.map +1 -0
  396. package/dist/runtime-bootstrap.js +33 -0
  397. package/dist/runtime-bootstrap.js.map +1 -0
  398. package/dist/utils/file-scanner.js +1 -1
  399. package/dist/utils/file-scanner.js.map +1 -1
  400. package/package.json +12 -2
  401. package/plugins/spec-driver/.claude-plugin/plugin.json +1 -1
  402. package/plugins/spec-driver/README.md +18 -1
  403. package/plugins/spec-driver/agents/implement.md +20 -1
  404. package/plugins/spec-driver/agents/plan.md +20 -1
  405. package/plugins/spec-driver/agents/quality-review.md +20 -1
  406. package/plugins/spec-driver/agents/spec-review.md +20 -1
  407. package/plugins/spec-driver/agents/verify.md +20 -1
  408. package/plugins/spec-driver/docs/customization.md +134 -0
  409. package/plugins/spec-driver/docs/spectra-mcp-integration.md +165 -0
  410. package/plugins/spec-driver/lib/preference-rules.mjs +96 -0
  411. package/plugins/spec-driver/scripts/postinstall.sh +1 -1
  412. package/plugins/spec-driver/scripts/sync-preference-rules.mjs +148 -0
  413. package/plugins/spec-driver/skills/spec-driver-feature/SKILL.md +10 -0
  414. package/plugins/spec-driver/skills/spec-driver-fix/SKILL.md +10 -0
  415. package/plugins/spec-driver/skills/spec-driver-implement/SKILL.md +10 -0
  416. package/plugins/spec-driver/skills/spec-driver-refactor/SKILL.md +10 -0
  417. package/plugins/spec-driver/skills/spec-driver-story/SKILL.md +10 -0
  418. package/plugins/spec-driver/templates/preference-rules.md +39 -0
  419. package/plugins/spectra/.claude-plugin/plugin.json +1 -1
  420. package/plugins/spectra/README.md +48 -1
  421. package/plugins/spectra/hooks/post-commit.sh +40 -0
  422. package/templates/product-overview.hbs +1 -1
@@ -0,0 +1,296 @@
1
+ /**
2
+ * qa-integration.test.ts
3
+ * T-021 集成测试:5 类问题 × mock 数据,验证 Citation 覆盖率 + 溯源正确性
4
+ *
5
+ * 测试策略:
6
+ * - 使用 mock graphify 小图谱(无真实 graph.json 依赖)
7
+ * - mock Anthropic SDK(不真实调用 API)
8
+ * - 验证每类问题都返回至少 1 条 Citation
9
+ * - 验证 Citation 的 specPath 和 lineRange 字段格式合法(R6 缓解测试)
10
+ *
11
+ * 5 类问题:
12
+ * 1. 调用关系("什么调用了 X")
13
+ * 2. 调用路径("从 A 到 B 的调用路径")
14
+ * 3. 设计决策映射("X 的设计决策")
15
+ * 4. 技术债("最老的 TODO")
16
+ * 5. 流程归属("Y 流程涉及哪些模块")
17
+ */
18
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
19
+ import { answerQuestion, clearEngineCache } from '../index.js';
20
+ // ============================================================
21
+ // Mock 所有外部依赖(集成测试不调用真实 API)
22
+ // ============================================================
23
+ vi.mock('../../graph/graph-query.js', () => ({
24
+ GraphQueryEngine: {
25
+ loadFromFile: vi.fn(),
26
+ },
27
+ }));
28
+ vi.mock('../../graph/graph-paths.js', () => ({
29
+ resolveGraphJsonPath: vi.fn().mockReturnValue('/mock/project/specs/_meta/graph.json'),
30
+ }));
31
+ vi.mock('../../core/token-counter.js', () => ({
32
+ estimateFast: vi.fn().mockReturnValue(100),
33
+ }));
34
+ vi.mock('../../batch/budget-gate.js', () => ({
35
+ runBudgetGate: vi.fn().mockResolvedValue({
36
+ finalPolicy: 'continue',
37
+ finalEstimate: 100,
38
+ skipEnrichmentApplied: false,
39
+ cheaperModelApplied: false,
40
+ attempts: [],
41
+ }),
42
+ }));
43
+ vi.mock('../../core/model-selection.js', () => ({
44
+ resolveReverseSpecModel: vi.fn().mockReturnValue({ model: 'claude-test-model' }),
45
+ }));
46
+ vi.mock('@anthropic-ai/sdk', () => {
47
+ const mockCreate = vi.fn();
48
+ const Anthropic = vi.fn(() => ({
49
+ messages: { create: mockCreate },
50
+ }));
51
+ Anthropic._mockCreate = mockCreate;
52
+ return { default: Anthropic };
53
+ });
54
+ vi.mock('../../../debt-scanner/index.js', () => ({
55
+ scanProjectDebt: vi.fn().mockResolvedValue({
56
+ codeEntries: [
57
+ {
58
+ kind: 'TODO',
59
+ severity: 'warning',
60
+ text: '最老的技术债,需要重构认证逻辑',
61
+ filePath: 'src/auth/login.ts',
62
+ line: 42,
63
+ symbol: 'loginUser',
64
+ author: 'dev',
65
+ ageDays: 365,
66
+ },
67
+ ],
68
+ openQuestions: [],
69
+ diagnostics: { filesScanned: 5, filesSkipped: 0, totalLoc: 1000, llmCalls: 0, docsScanned: 0, ruleCandidates: 1, llmCandidates: 0, messages: [] },
70
+ metrics: { totalEntries: 1, byKind: { TODO: 1, FIXME: 0, HACK: 0, XXX: 0, NOTE: 0 }, densityPerKloc: 1, oldestAgeDays: 365, openQuestionsCount: 0 },
71
+ tokenUsage: { input: 0, output: 0 },
72
+ durationMs: 10,
73
+ }),
74
+ }));
75
+ // Mock anchoring 模块
76
+ vi.mock('../../anchoring/chunker.js', () => ({
77
+ chunkMarkdownFiles: vi.fn().mockReturnValue([
78
+ {
79
+ filePath: 'specs/auth.md',
80
+ startLine: 1,
81
+ endLine: 20,
82
+ headingPath: '## Overview',
83
+ text: '认证模块的核心设计文档,LoginService 调用该模块进行用户验证',
84
+ tokenCount: 40,
85
+ },
86
+ {
87
+ filePath: 'specs/session.md',
88
+ startLine: 5,
89
+ endLine: 15,
90
+ headingPath: '## Session Management',
91
+ text: '会话管理模块,用于跨请求维护用户状态',
92
+ tokenCount: 30,
93
+ },
94
+ ]),
95
+ }));
96
+ vi.mock('../../anchoring/providers/factory.js', () => ({
97
+ createEmbeddingProvider: vi.fn().mockReturnValue({
98
+ providerName: 'local',
99
+ llmModelLabel: 'mock-embedding',
100
+ dimensions: 4,
101
+ embed: vi.fn().mockResolvedValue({
102
+ vectors: Array.from({ length: 3 }, () => {
103
+ const v = new Float32Array(4);
104
+ const val = 1 / Math.sqrt(4);
105
+ v[0] = val;
106
+ v[1] = val;
107
+ v[2] = val;
108
+ v[3] = val;
109
+ return v;
110
+ }),
111
+ tokenUsage: { llmModel: 'mock', durationMs: 1 },
112
+ }),
113
+ }),
114
+ }));
115
+ vi.mock('../../anchoring/edge-builder.js', () => ({
116
+ buildEvidenceText: vi.fn().mockImplementation((text, nodeName) => text.slice(0, 200)),
117
+ }));
118
+ // Mock fs 模块(避免真实文件 IO,模拟文件有 50 行)
119
+ vi.mock('node:fs', () => ({
120
+ readFileSync: vi.fn().mockReturnValue('line\n'.repeat(50)),
121
+ }));
122
+ import { GraphQueryEngine } from '../../graph/graph-query.js';
123
+ import Anthropic from '@anthropic-ai/sdk';
124
+ // ============================================================
125
+ // Mock 图谱数据
126
+ // ============================================================
127
+ const mockGraphNodes = [
128
+ { id: 'auth-module', label: '认证模块', kind: 'module', metadata: { specPath: 'specs/auth.md' } },
129
+ { id: 'session-module', label: '会话管理', kind: 'module', metadata: {} },
130
+ { id: 'db-module', label: '数据库层', kind: 'module', metadata: { specPath: 'specs/db.md' } },
131
+ { id: 'api-gateway', label: 'API 网关', kind: 'module', metadata: {} },
132
+ { id: 'login-service', label: '登录服务', kind: 'module', metadata: { specPath: 'specs/login.md' } },
133
+ ];
134
+ const mockHyperedges = [
135
+ {
136
+ id: 'he-login-flow',
137
+ label: '登录流程',
138
+ nodes: ['auth-module', 'session-module', 'db-module'],
139
+ rationale: '用户登录时依次调用认证、数据库验证和会话创建',
140
+ confidence: 'INFERRED',
141
+ },
142
+ ];
143
+ const mockEngine = {
144
+ query: vi.fn().mockReturnValue({
145
+ nodes: mockGraphNodes.slice(0, 3),
146
+ edges: [],
147
+ summary: '找到 3 个相关节点',
148
+ truncated: false,
149
+ totalMatches: 3,
150
+ }),
151
+ getHyperedges: vi.fn().mockReturnValue(mockHyperedges),
152
+ };
153
+ // ============================================================
154
+ // 构建 LLM 响应(含 citations)
155
+ // ============================================================
156
+ function buildLlmResponseWithCitations(questionType) {
157
+ const citationsMap = {
158
+ call: [{ specPath: 'specs/auth.md', startLine: 5, endLine: 15, excerpt: '认证模块被 LoginService 调用' }],
159
+ path: [{ specPath: 'specs/auth.md', startLine: 1, endLine: 10, excerpt: '从 API 网关到认证的路径' }],
160
+ design: [{ specPath: 'specs/auth.md', startLine: 10, endLine: 20, excerpt: '认证模块的设计决策说明' }],
161
+ debt: [{ specPath: 'src/auth/login.ts', startLine: 42, endLine: 42, excerpt: '最老的技术债,需要重构认证逻辑' }],
162
+ flow: [{ specPath: '[graph hyperedge]', startLine: 0, endLine: 0, excerpt: '登录流程跨模块协作' }],
163
+ };
164
+ const citations = citationsMap[questionType] ?? [
165
+ { specPath: 'specs/auth.md', startLine: 1, endLine: 5, excerpt: '默认 citation' },
166
+ ];
167
+ return {
168
+ id: 'msg-001',
169
+ type: 'message',
170
+ role: 'assistant',
171
+ model: 'claude-test-model',
172
+ content: [
173
+ {
174
+ type: 'text',
175
+ text: JSON.stringify({
176
+ answer: `${questionType} 类型问题的回答`,
177
+ citations,
178
+ }),
179
+ },
180
+ ],
181
+ stop_reason: 'end_turn',
182
+ usage: { input_tokens: 200, output_tokens: 100 },
183
+ };
184
+ }
185
+ // ============================================================
186
+ // 测试选项
187
+ // ============================================================
188
+ const testOptions = {
189
+ projectRoot: '/mock/project',
190
+ };
191
+ // ============================================================
192
+ // 测试套件
193
+ // ============================================================
194
+ describe('qa 集成测试 — 5 类问题 × Citation 覆盖', () => {
195
+ beforeEach(() => {
196
+ vi.clearAllMocks();
197
+ clearEngineCache();
198
+ // 设置 GraphQueryEngine mock
199
+ vi.mocked(GraphQueryEngine.loadFromFile).mockReturnValue(mockEngine);
200
+ });
201
+ afterEach(() => {
202
+ clearEngineCache();
203
+ });
204
+ /** 辅助:设置 Anthropic mock 返回指定响应 */
205
+ function setupAnthropicMock(questionType) {
206
+ const response = buildLlmResponseWithCitations(questionType);
207
+ vi.mocked(Anthropic).mockImplementation(() => ({ messages: { create: vi.fn().mockResolvedValue(response) } }));
208
+ }
209
+ describe('类型 1:调用关系查询("什么调用了 X")', () => {
210
+ it('应返回至少 1 条 Citation', async () => {
211
+ setupAnthropicMock('call');
212
+ const result = await answerQuestion({ text: '什么调用了认证模块' }, testOptions);
213
+ expect(result.citations.length).toBeGreaterThanOrEqual(1);
214
+ expect(result.text).toBeTruthy();
215
+ });
216
+ it('Citation 应包含合法的 specPath', async () => {
217
+ setupAnthropicMock('call');
218
+ const result = await answerQuestion({ text: '什么调用了认证模块' }, testOptions);
219
+ for (const citation of result.citations) {
220
+ expect(typeof citation.specPath).toBe('string');
221
+ expect(citation.specPath.length).toBeGreaterThan(0);
222
+ }
223
+ });
224
+ });
225
+ describe('类型 2:调用路径查询("从 A 到 B 的路径")', () => {
226
+ it('应返回至少 1 条 Citation', async () => {
227
+ setupAnthropicMock('path');
228
+ const result = await answerQuestion({ text: '从 API 网关到数据库层的调用路径是什么' }, testOptions);
229
+ expect(result.citations.length).toBeGreaterThanOrEqual(1);
230
+ });
231
+ it('Citation 的 lineRange 字段应合法', async () => {
232
+ setupAnthropicMock('path');
233
+ const result = await answerQuestion({ text: 'API 网关到认证模块的路径' }, testOptions);
234
+ for (const citation of result.citations) {
235
+ if (citation.specPath !== '[graph hyperedge]') {
236
+ expect(typeof citation.lineRange.startLine).toBe('number');
237
+ expect(typeof citation.lineRange.endLine).toBe('number');
238
+ }
239
+ }
240
+ });
241
+ });
242
+ describe('类型 3:设计决策映射("X 的设计决策")', () => {
243
+ it('应返回至少 1 条 Citation', async () => {
244
+ setupAnthropicMock('design');
245
+ const result = await answerQuestion({ text: '认证模块的设计决策是什么' }, testOptions);
246
+ expect(result.citations.length).toBeGreaterThanOrEqual(1);
247
+ });
248
+ });
249
+ describe('类型 4:技术债("最老的 TODO")', () => {
250
+ it('应返回至少 1 条 Citation', async () => {
251
+ setupAnthropicMock('debt');
252
+ const result = await answerQuestion({ text: '最老的 TODO 在哪里' }, testOptions);
253
+ expect(result.citations.length).toBeGreaterThanOrEqual(1);
254
+ });
255
+ it('技术债 Citation 的 specPath 应指向源码文件', async () => {
256
+ setupAnthropicMock('debt');
257
+ const result = await answerQuestion({ text: '最老的 TODO 是什么' }, testOptions);
258
+ // 至少有一条 citation 的 specPath 看起来是代码文件路径
259
+ const hasCodeFileCitation = result.citations.some((c) => c.specPath.endsWith('.ts') || c.specPath.endsWith('.js') || c.specPath.endsWith('.py'));
260
+ // 注意:可能全部是 LLM 解析的 citations,这里不强制要求 ts 后缀
261
+ expect(result.citations.length).toBeGreaterThan(0);
262
+ });
263
+ });
264
+ describe('类型 5:流程归属("Y 流程涉及哪些模块")', () => {
265
+ it('应返回至少 1 条 Citation', async () => {
266
+ setupAnthropicMock('flow');
267
+ const result = await answerQuestion({ text: '登录流程涉及哪些模块' }, testOptions);
268
+ expect(result.citations.length).toBeGreaterThanOrEqual(1);
269
+ });
270
+ it('流程类问题可能包含 hyperedge citation', async () => {
271
+ setupAnthropicMock('flow');
272
+ const result = await answerQuestion({ text: '登录流程涉及哪些模块' }, testOptions);
273
+ // 验证 [graph hyperedge] 格式的 citation 是合法的
274
+ for (const citation of result.citations) {
275
+ if (citation.specPath === '[graph hyperedge]') {
276
+ expect(citation.lineRange.startLine).toBe(0);
277
+ expect(citation.lineRange.endLine).toBe(0);
278
+ }
279
+ }
280
+ });
281
+ });
282
+ describe('溯源正确性验证(R6 缓解)', () => {
283
+ it('所有 Citation 应包含 specPath、lineRange、excerpt 三个必填字段', async () => {
284
+ setupAnthropicMock('call');
285
+ const result = await answerQuestion({ text: '什么调用了认证模块' }, testOptions);
286
+ for (const citation of result.citations) {
287
+ expect(citation.specPath).toBeDefined();
288
+ expect(citation.lineRange).toBeDefined();
289
+ expect(typeof citation.lineRange.startLine).toBe('number');
290
+ expect(typeof citation.lineRange.endLine).toBe('number');
291
+ expect(citation.excerpt).toBeDefined();
292
+ }
293
+ });
294
+ });
295
+ });
296
+ //# sourceMappingURL=qa-integration.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"qa-integration.test.js","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/qa-integration.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rag-reranker.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rag-reranker.test.d.ts","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/rag-reranker.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,136 @@
1
+ /**
2
+ * rag-reranker.test.ts
3
+ * T-015 单元测试:chunk 精排 + embedding 降级 + Top-K 截断
4
+ */
5
+ import { describe, it, expect, vi, afterEach } from 'vitest';
6
+ import { rerankWithEmbedding, setEmbeddingProviderForTesting } from '../rag-reranker.js';
7
+ // ============================================================
8
+ // Mock 辅助函数
9
+ // ============================================================
10
+ /**
11
+ * 创建一个简单的 EmbeddingProvider mock
12
+ * 对每段文本返回一个确定性的 Float32Array(用文本长度作伪向量)
13
+ */
14
+ function createMockProvider(options) {
15
+ return {
16
+ providerName: 'local',
17
+ llmModelLabel: 'mock-embedding',
18
+ dimensions: 4,
19
+ embed: vi.fn().mockImplementation(async (texts) => {
20
+ if (options?.failOnEmbed) {
21
+ throw new Error('模拟 embedding 计算失败');
22
+ }
23
+ // 每段文本生成一个 4 维向量(归一化,值相同以确保高相似度)
24
+ const vectors = texts.map(() => {
25
+ const v = new Float32Array(4);
26
+ const val = 1 / Math.sqrt(4); // 归一化
27
+ v[0] = val;
28
+ v[1] = val;
29
+ v[2] = val;
30
+ v[3] = val;
31
+ return v;
32
+ });
33
+ return {
34
+ vectors,
35
+ tokenUsage: { llmModel: 'mock', durationMs: 1 },
36
+ };
37
+ }),
38
+ };
39
+ }
40
+ /** 构造一个最小化的 GraphContext */
41
+ function makeGraphCtx(nodeCount = 3) {
42
+ return {
43
+ bfsNodes: Array.from({ length: nodeCount }, (_, i) => ({
44
+ id: `node-${i}`,
45
+ label: `Node${i}`,
46
+ kind: 'module',
47
+ })),
48
+ topChunks: [],
49
+ hyperedges: [],
50
+ };
51
+ }
52
+ // ============================================================
53
+ // Mock chunkMarkdownFiles(避免真实文件 IO)
54
+ // ============================================================
55
+ vi.mock('../../anchoring/chunker.js', () => ({
56
+ chunkMarkdownFiles: vi.fn().mockReturnValue([
57
+ {
58
+ filePath: 'specs/module-a.md',
59
+ startLine: 1,
60
+ endLine: 10,
61
+ headingPath: '## Overview',
62
+ text: '这是模块 A 的概述',
63
+ tokenCount: 20,
64
+ },
65
+ {
66
+ filePath: 'specs/module-b.md',
67
+ startLine: 1,
68
+ endLine: 8,
69
+ headingPath: '## Design',
70
+ text: '这是模块 B 的设计说明',
71
+ tokenCount: 18,
72
+ },
73
+ ]),
74
+ }));
75
+ // ============================================================
76
+ // 测试套件
77
+ // ============================================================
78
+ describe('rerankWithEmbedding', () => {
79
+ afterEach(() => {
80
+ // 重置 singleton,避免测试间相互影响
81
+ setEmbeddingProviderForTesting(null);
82
+ });
83
+ describe('正常精排路径', () => {
84
+ it('应返回 rankedChunks 列表', async () => {
85
+ setEmbeddingProviderForTesting(createMockProvider());
86
+ const ctx = makeGraphCtx(3);
87
+ const result = await rerankWithEmbedding(ctx, ['/abs/specs/module-a.md', '/abs/specs/module-b.md'], '什么是模块 A?', '/project');
88
+ expect(result.fallbackMode).toBeUndefined();
89
+ expect(result.rankedChunks.length).toBeGreaterThan(0);
90
+ });
91
+ it('Top-K 参数应截断结果', async () => {
92
+ setEmbeddingProviderForTesting(createMockProvider());
93
+ const ctx = makeGraphCtx(3);
94
+ const result = await rerankWithEmbedding(ctx, ['/abs/specs/module-a.md'], '问题', '/project', { topK: 1 });
95
+ expect(result.rankedChunks.length).toBeLessThanOrEqual(1);
96
+ });
97
+ it('rankedChunks 应包含 chunk、similarity、nodeId 字段', async () => {
98
+ setEmbeddingProviderForTesting(createMockProvider());
99
+ const ctx = makeGraphCtx(3);
100
+ const result = await rerankWithEmbedding(ctx, ['/abs/specs/module-a.md'], '模块设计', '/project');
101
+ if (result.rankedChunks.length > 0) {
102
+ const first = result.rankedChunks[0];
103
+ expect(first.chunk).toBeDefined();
104
+ expect(first.chunk.filePath).toBeDefined();
105
+ expect(typeof first.similarity).toBe('number');
106
+ expect(typeof first.nodeId).toBe('string');
107
+ }
108
+ });
109
+ });
110
+ describe('embedding 加载失败降级', () => {
111
+ it('embed() 失败时应降级为 bfs-only,不抛出异常', async () => {
112
+ setEmbeddingProviderForTesting(createMockProvider({ failOnEmbed: true }));
113
+ const ctx = makeGraphCtx(3);
114
+ const result = await rerankWithEmbedding(ctx, ['/abs/specs/module-a.md'], '测试问题', '/project');
115
+ expect(result.fallbackMode).toBe('bfs-only');
116
+ expect(result.rankedChunks).toEqual([]);
117
+ });
118
+ });
119
+ describe('边界条件', () => {
120
+ it('specPaths 为空时应直接返回空结果', async () => {
121
+ setEmbeddingProviderForTesting(createMockProvider());
122
+ const ctx = makeGraphCtx(3);
123
+ const result = await rerankWithEmbedding(ctx, [], '问题', '/project');
124
+ expect(result.rankedChunks).toEqual([]);
125
+ expect(result.fallbackMode).toBeUndefined();
126
+ });
127
+ it('低相似度阈值(0.0)时应返回所有 chunks', async () => {
128
+ setEmbeddingProviderForTesting(createMockProvider());
129
+ const ctx = makeGraphCtx(3);
130
+ const result = await rerankWithEmbedding(ctx, ['/abs/specs/module-a.md'], '模块', '/project', { similarityThreshold: 0.0 });
131
+ // 所有 chunks 都应满足阈值 0.0
132
+ expect(result.rankedChunks.length).toBeGreaterThan(0);
133
+ });
134
+ });
135
+ });
136
+ //# sourceMappingURL=rag-reranker.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rag-reranker.test.js","sourceRoot":"","sources":["../../../../src/panoramic/qa/__tests__/rag-reranker.test.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panoramic/qa/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA+BlE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CA8KpB"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panoramic/qa/index.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAqClE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CA8KpB"}
@@ -14,6 +14,7 @@
14
14
  * Step 7:llm-caller(budget-gate + Anthropic SDK 调用)
15
15
  * - 结构化日志(F-015 LOW):BFS 命中数、fallbackMode、各步耗时、总 durationMs
16
16
  */
17
+ import { resolve } from 'node:path';
17
18
  import { GraphQueryEngine } from '../graph/graph-query.js';
18
19
  import { resolveGraphJsonPath } from '../graph/graph-paths.js';
19
20
  import { retrieveGraphContext } from './graph-retriever.js';
@@ -36,11 +37,17 @@ const engineCache = new Map();
36
37
  * 图谱文件不存在时抛出 Error(明确告知用户需要先生成图谱)
37
38
  */
38
39
  function getEngine(projectRoot, graphJsonPath) {
39
- const graphPath = graphJsonPath ?? resolveGraphJsonPath(projectRoot);
40
- const cacheKey = graphPath;
40
+ // F170e:规范化 projectRoot,并把它纳入 cache key。否则当显式 graphJsonPath 相同
41
+ // projectRoot 不同时,会复用首次请求的 engine(projectRoot 已固化)→ 读错
42
+ // GRAPH_REPORT.md。
43
+ const resolvedRoot = resolve(projectRoot);
44
+ const graphPath = graphJsonPath ?? resolveGraphJsonPath(resolvedRoot);
45
+ // 用 NUL(\0)作分隔符:合法文件路径不含 \0,杜绝 "graphPath::root" 拼接在
46
+ // 路径含 :: 时的 key 碰撞(Codex 复审 WARNING)。
47
+ const cacheKey = `${graphPath}\0${resolvedRoot}`;
41
48
  let engine = engineCache.get(cacheKey);
42
49
  if (!engine) {
43
- engine = GraphQueryEngine.loadFromFile(graphPath);
50
+ engine = GraphQueryEngine.loadFromFile(graphPath, resolvedRoot);
44
51
  engineCache.set(cacheKey, engine);
45
52
  }
46
53
  return engine;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/panoramic/qa/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/panoramic/qa/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,77 @@
1
+ import type { DocumentGenerator, GenerateOptions, ProjectContext } from './interfaces.js';
2
+ import type { DockerfileInfo } from './parsers/types.js';
3
+ import type { YamlArray, YamlValue } from './parsers/yaml-config-parser.js';
4
+ import { type RuntimeConfigHint, type RuntimeDependency, type RuntimeEnvironmentVariable, type RuntimePortBinding, type RuntimeTopology, type RuntimeTopologyStats, type RuntimeVolumeMount } from './runtime-topology-model.js';
5
+ interface ComposeBuildDefinition {
6
+ context: string;
7
+ dockerfilePath?: string;
8
+ targetStage?: string;
9
+ }
10
+ interface ComposeServiceDefinition {
11
+ name: string;
12
+ sourceFile: string;
13
+ image?: string;
14
+ build?: ComposeBuildDefinition;
15
+ containerName: string;
16
+ command?: string;
17
+ entrypoint?: string;
18
+ environment: RuntimeEnvironmentVariable[];
19
+ envFiles: string[];
20
+ ports: RuntimePortBinding[];
21
+ volumes: RuntimeVolumeMount[];
22
+ dependsOn: RuntimeDependency[];
23
+ }
24
+ interface ComposeFileDefinition {
25
+ filePath: string;
26
+ services: ComposeServiceDefinition[];
27
+ }
28
+ interface DockerfileArtifact {
29
+ filePath: string;
30
+ relativePath: string;
31
+ parsed: DockerfileInfo;
32
+ serviceNames: string[];
33
+ runtimeTargets: string[];
34
+ }
35
+ interface RuntimeEnvFile {
36
+ filePath: string;
37
+ entries: RuntimeEnvironmentVariable[];
38
+ }
39
+ export interface RuntimeTopologyInput {
40
+ projectName: string;
41
+ composeFiles: ComposeFileDefinition[];
42
+ dockerfiles: DockerfileArtifact[];
43
+ envFiles: RuntimeEnvFile[];
44
+ configHints: RuntimeConfigHint[];
45
+ warnings: string[];
46
+ }
47
+ export interface RuntimeTopologyOutput {
48
+ title: string;
49
+ generatedAt: string;
50
+ topology: RuntimeTopology;
51
+ stats: RuntimeTopologyStats;
52
+ warnings: string[];
53
+ }
54
+ /**
55
+ * 运行时拓扑生成器。
56
+ */
57
+ export declare class RuntimeTopologyGenerator implements DocumentGenerator<RuntimeTopologyInput, RuntimeTopologyOutput> {
58
+ readonly id: "runtime-topology";
59
+ readonly name: "\u8FD0\u884C\u65F6\u62D3\u6251\u751F\u6210\u5668";
60
+ readonly description = "\u8054\u5408\u89E3\u6790 Compose\u3001Dockerfile\u3001.env \u548C\u914D\u7F6E\u63D0\u793A\uFF0C\u751F\u6210\u7EDF\u4E00\u8FD0\u884C\u65F6\u62D3\u6251\u6A21\u578B";
61
+ isApplicable(context: ProjectContext): boolean;
62
+ extract(context: ProjectContext): Promise<RuntimeTopologyInput>;
63
+ generate(input: RuntimeTopologyInput, _options?: GenerateOptions): Promise<RuntimeTopologyOutput>;
64
+ render(output: RuntimeTopologyOutput): string;
65
+ private extractComposeFiles;
66
+ private extractDockerfiles;
67
+ private extractEnvFiles;
68
+ private extractRuntimeConfigHints;
69
+ }
70
+ declare function parseComposeFile(projectRoot: string, composePath: string, content: string): ComposeFileDefinition;
71
+ declare function parseComposeShortPort(rawPort: string, sourceFile: string): RuntimePortBinding;
72
+ declare function parseComposeShortVolume(rawVolume: string, sourceFile: string): RuntimeVolumeMount;
73
+ declare function discoverComposeFiles(projectRoot: string, configFiles: Map<string, string>): string[];
74
+ declare function dedupeConfigHints(configHints: RuntimeConfigHint[]): RuntimeConfigHint[];
75
+ declare function _isYamlArray(value: YamlValue | undefined): value is YamlArray;
76
+ export { discoverComposeFiles as _discoverComposeFiles, parseComposeFile as _parseComposeFile, parseComposeShortPort as _parseComposeShortPort, parseComposeShortVolume as _parseComposeShortVolume, dedupeConfigHints as _dedupeConfigHints, _isYamlArray, };
77
+ //# sourceMappingURL=runtime-topology-generator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-topology-generator.d.ts","sourceRoot":"","sources":["../../src/panoramic/runtime-topology-generator.ts"],"names":[],"mappings":"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"}