spectra-cli 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1147) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +350 -0
  3. package/dist/adapters/go-adapter.d.ts +38 -0
  4. package/dist/adapters/go-adapter.d.ts.map +1 -0
  5. package/dist/adapters/go-adapter.js +58 -0
  6. package/dist/adapters/go-adapter.js.map +1 -0
  7. package/dist/adapters/index.d.ts +21 -0
  8. package/dist/adapters/index.d.ts.map +1 -0
  9. package/dist/adapters/index.js +36 -0
  10. package/dist/adapters/index.js.map +1 -0
  11. package/dist/adapters/java-adapter.d.ts +39 -0
  12. package/dist/adapters/java-adapter.d.ts.map +1 -0
  13. package/dist/adapters/java-adapter.js +65 -0
  14. package/dist/adapters/java-adapter.js.map +1 -0
  15. package/dist/adapters/language-adapter-registry.d.ts +56 -0
  16. package/dist/adapters/language-adapter-registry.d.ts.map +1 -0
  17. package/dist/adapters/language-adapter-registry.js +110 -0
  18. package/dist/adapters/language-adapter-registry.js.map +1 -0
  19. package/dist/adapters/language-adapter.d.ts +127 -0
  20. package/dist/adapters/language-adapter.d.ts.map +1 -0
  21. package/dist/adapters/language-adapter.js +2 -0
  22. package/dist/adapters/language-adapter.js.map +1 -0
  23. package/dist/adapters/python-adapter.d.ts +61 -0
  24. package/dist/adapters/python-adapter.d.ts.map +1 -0
  25. package/dist/adapters/python-adapter.js +260 -0
  26. package/dist/adapters/python-adapter.js.map +1 -0
  27. package/dist/adapters/tree-sitter-comment-extractor.d.ts +15 -0
  28. package/dist/adapters/tree-sitter-comment-extractor.d.ts.map +1 -0
  29. package/dist/adapters/tree-sitter-comment-extractor.js +105 -0
  30. package/dist/adapters/tree-sitter-comment-extractor.js.map +1 -0
  31. package/dist/adapters/ts-js-adapter.d.ts +38 -0
  32. package/dist/adapters/ts-js-adapter.d.ts.map +1 -0
  33. package/dist/adapters/ts-js-adapter.js +164 -0
  34. package/dist/adapters/ts-js-adapter.js.map +1 -0
  35. package/dist/auth/auth-detector.d.ts +41 -0
  36. package/dist/auth/auth-detector.d.ts.map +1 -0
  37. package/dist/auth/auth-detector.js +324 -0
  38. package/dist/auth/auth-detector.js.map +1 -0
  39. package/dist/auth/cli-proxy.d.ts +35 -0
  40. package/dist/auth/cli-proxy.d.ts.map +1 -0
  41. package/dist/auth/cli-proxy.js +225 -0
  42. package/dist/auth/cli-proxy.js.map +1 -0
  43. package/dist/auth/codex-proxy.d.ts +22 -0
  44. package/dist/auth/codex-proxy.d.ts.map +1 -0
  45. package/dist/auth/codex-proxy.js +199 -0
  46. package/dist/auth/codex-proxy.js.map +1 -0
  47. package/dist/batch/batch-orchestrator.d.ts +214 -0
  48. package/dist/batch/batch-orchestrator.d.ts.map +1 -0
  49. package/dist/batch/batch-orchestrator.js +1552 -0
  50. package/dist/batch/batch-orchestrator.js.map +1 -0
  51. package/dist/batch/batch-readme-generator.d.ts +32 -0
  52. package/dist/batch/batch-readme-generator.d.ts.map +1 -0
  53. package/dist/batch/batch-readme-generator.js +153 -0
  54. package/dist/batch/batch-readme-generator.js.map +1 -0
  55. package/dist/batch/budget-gate.d.ts +107 -0
  56. package/dist/batch/budget-gate.d.ts.map +1 -0
  57. package/dist/batch/budget-gate.js +279 -0
  58. package/dist/batch/budget-gate.js.map +1 -0
  59. package/dist/batch/checkpoint.d.ts +25 -0
  60. package/dist/batch/checkpoint.d.ts.map +1 -0
  61. package/dist/batch/checkpoint.js +68 -0
  62. package/dist/batch/checkpoint.js.map +1 -0
  63. package/dist/batch/cost-summary.d.ts +78 -0
  64. package/dist/batch/cost-summary.d.ts.map +1 -0
  65. package/dist/batch/cost-summary.js +191 -0
  66. package/dist/batch/cost-summary.js.map +1 -0
  67. package/dist/batch/delta-regenerator.d.ts +41 -0
  68. package/dist/batch/delta-regenerator.d.ts.map +1 -0
  69. package/dist/batch/delta-regenerator.js +267 -0
  70. package/dist/batch/delta-regenerator.js.map +1 -0
  71. package/dist/batch/directory-classifier.d.ts +79 -0
  72. package/dist/batch/directory-classifier.d.ts.map +1 -0
  73. package/dist/batch/directory-classifier.js +270 -0
  74. package/dist/batch/directory-classifier.js.map +1 -0
  75. package/dist/batch/language-grouper.d.ts +28 -0
  76. package/dist/batch/language-grouper.d.ts.map +1 -0
  77. package/dist/batch/language-grouper.js +67 -0
  78. package/dist/batch/language-grouper.js.map +1 -0
  79. package/dist/batch/model-override-decision.d.ts +27 -0
  80. package/dist/batch/model-override-decision.d.ts.map +1 -0
  81. package/dist/batch/model-override-decision.js +14 -0
  82. package/dist/batch/model-override-decision.js.map +1 -0
  83. package/dist/batch/module-grouper.d.ts +59 -0
  84. package/dist/batch/module-grouper.d.ts.map +1 -0
  85. package/dist/batch/module-grouper.js +286 -0
  86. package/dist/batch/module-grouper.js.map +1 -0
  87. package/dist/batch/progress-reporter.d.ts +68 -0
  88. package/dist/batch/progress-reporter.d.ts.map +1 -0
  89. package/dist/batch/progress-reporter.js +273 -0
  90. package/dist/batch/progress-reporter.js.map +1 -0
  91. package/dist/batch/readme-graph-section.d.ts +53 -0
  92. package/dist/batch/readme-graph-section.d.ts.map +1 -0
  93. package/dist/batch/readme-graph-section.js +183 -0
  94. package/dist/batch/readme-graph-section.js.map +1 -0
  95. package/dist/cli/commands/auth-status.d.ts +10 -0
  96. package/dist/cli/commands/auth-status.d.ts.map +1 -0
  97. package/dist/cli/commands/auth-status.js +50 -0
  98. package/dist/cli/commands/auth-status.js.map +1 -0
  99. package/dist/cli/commands/batch.d.ts +10 -0
  100. package/dist/cli/commands/batch.d.ts.map +1 -0
  101. package/dist/cli/commands/batch.js +133 -0
  102. package/dist/cli/commands/batch.js.map +1 -0
  103. package/dist/cli/commands/cache.d.ts +13 -0
  104. package/dist/cli/commands/cache.d.ts.map +1 -0
  105. package/dist/cli/commands/cache.js +65 -0
  106. package/dist/cli/commands/cache.js.map +1 -0
  107. package/dist/cli/commands/community.d.ts +10 -0
  108. package/dist/cli/commands/community.d.ts.map +1 -0
  109. package/dist/cli/commands/community.js +92 -0
  110. package/dist/cli/commands/community.js.map +1 -0
  111. package/dist/cli/commands/diff.d.ts +10 -0
  112. package/dist/cli/commands/diff.d.ts.map +1 -0
  113. package/dist/cli/commands/diff.js +49 -0
  114. package/dist/cli/commands/diff.js.map +1 -0
  115. package/dist/cli/commands/direction-audit.d.ts +12 -0
  116. package/dist/cli/commands/direction-audit.d.ts.map +1 -0
  117. package/dist/cli/commands/direction-audit.js +458 -0
  118. package/dist/cli/commands/direction-audit.js.map +1 -0
  119. package/dist/cli/commands/export.d.ts +22 -0
  120. package/dist/cli/commands/export.d.ts.map +1 -0
  121. package/dist/cli/commands/export.js +123 -0
  122. package/dist/cli/commands/export.js.map +1 -0
  123. package/dist/cli/commands/generate.d.ts +10 -0
  124. package/dist/cli/commands/generate.d.ts.map +1 -0
  125. package/dist/cli/commands/generate.js +50 -0
  126. package/dist/cli/commands/generate.js.map +1 -0
  127. package/dist/cli/commands/graph.d.ts +20 -0
  128. package/dist/cli/commands/graph.d.ts.map +1 -0
  129. package/dist/cli/commands/graph.js +189 -0
  130. package/dist/cli/commands/graph.js.map +1 -0
  131. package/dist/cli/commands/init.d.ts +10 -0
  132. package/dist/cli/commands/init.d.ts.map +1 -0
  133. package/dist/cli/commands/init.js +33 -0
  134. package/dist/cli/commands/init.js.map +1 -0
  135. package/dist/cli/commands/install.d.ts +11 -0
  136. package/dist/cli/commands/install.d.ts.map +1 -0
  137. package/dist/cli/commands/install.js +52 -0
  138. package/dist/cli/commands/install.js.map +1 -0
  139. package/dist/cli/commands/mcp-server.d.ts +23 -0
  140. package/dist/cli/commands/mcp-server.d.ts.map +1 -0
  141. package/dist/cli/commands/mcp-server.js +90 -0
  142. package/dist/cli/commands/mcp-server.js.map +1 -0
  143. package/dist/cli/commands/panoramic.d.ts +7 -0
  144. package/dist/cli/commands/panoramic.d.ts.map +1 -0
  145. package/dist/cli/commands/panoramic.js +43 -0
  146. package/dist/cli/commands/panoramic.js.map +1 -0
  147. package/dist/cli/commands/prepare.d.ts +13 -0
  148. package/dist/cli/commands/prepare.d.ts.map +1 -0
  149. package/dist/cli/commands/prepare.js +148 -0
  150. package/dist/cli/commands/prepare.js.map +1 -0
  151. package/dist/cli/commands/query.d.ts +13 -0
  152. package/dist/cli/commands/query.d.ts.map +1 -0
  153. package/dist/cli/commands/query.js +116 -0
  154. package/dist/cli/commands/query.js.map +1 -0
  155. package/dist/cli/commands/watch.d.ts +16 -0
  156. package/dist/cli/commands/watch.d.ts.map +1 -0
  157. package/dist/cli/commands/watch.js +188 -0
  158. package/dist/cli/commands/watch.js.map +1 -0
  159. package/dist/cli/index.d.ts +7 -0
  160. package/dist/cli/index.d.ts.map +1 -0
  161. package/dist/cli/index.js +193 -0
  162. package/dist/cli/index.js.map +1 -0
  163. package/dist/cli/utils/error-handler.d.ts +41 -0
  164. package/dist/cli/utils/error-handler.d.ts.map +1 -0
  165. package/dist/cli/utils/error-handler.js +90 -0
  166. package/dist/cli/utils/error-handler.js.map +1 -0
  167. package/dist/cli/utils/parse-args.d.ts +111 -0
  168. package/dist/cli/utils/parse-args.d.ts.map +1 -0
  169. package/dist/cli/utils/parse-args.js +756 -0
  170. package/dist/cli/utils/parse-args.js.map +1 -0
  171. package/dist/config/project-config.d.ts +49 -0
  172. package/dist/config/project-config.d.ts.map +1 -0
  173. package/dist/config/project-config.js +118 -0
  174. package/dist/config/project-config.js.map +1 -0
  175. package/dist/config/spec-driver-config.d.ts +32 -0
  176. package/dist/config/spec-driver-config.d.ts.map +1 -0
  177. package/dist/config/spec-driver-config.js +91 -0
  178. package/dist/config/spec-driver-config.js.map +1 -0
  179. package/dist/core/ast-analyzer.d.ts +49 -0
  180. package/dist/core/ast-analyzer.d.ts.map +1 -0
  181. package/dist/core/ast-analyzer.js +439 -0
  182. package/dist/core/ast-analyzer.js.map +1 -0
  183. package/dist/core/code-slice-extractor.d.ts +47 -0
  184. package/dist/core/code-slice-extractor.d.ts.map +1 -0
  185. package/dist/core/code-slice-extractor.js +227 -0
  186. package/dist/core/code-slice-extractor.js.map +1 -0
  187. package/dist/core/context-assembler.d.ts +80 -0
  188. package/dist/core/context-assembler.d.ts.map +1 -0
  189. package/dist/core/context-assembler.js +262 -0
  190. package/dist/core/context-assembler.js.map +1 -0
  191. package/dist/core/grammar-manager.d.ts +79 -0
  192. package/dist/core/grammar-manager.d.ts.map +1 -0
  193. package/dist/core/grammar-manager.js +188 -0
  194. package/dist/core/grammar-manager.js.map +1 -0
  195. package/dist/core/llm-client.d.ts +120 -0
  196. package/dist/core/llm-client.d.ts.map +1 -0
  197. package/dist/core/llm-client.js +608 -0
  198. package/dist/core/llm-client.js.map +1 -0
  199. package/dist/core/model-selection.d.ts +50 -0
  200. package/dist/core/model-selection.d.ts.map +1 -0
  201. package/dist/core/model-selection.js +410 -0
  202. package/dist/core/model-selection.js.map +1 -0
  203. package/dist/core/query-mappers/base-mapper.d.ts +22 -0
  204. package/dist/core/query-mappers/base-mapper.d.ts.map +1 -0
  205. package/dist/core/query-mappers/base-mapper.js +2 -0
  206. package/dist/core/query-mappers/base-mapper.js.map +1 -0
  207. package/dist/core/query-mappers/go-mapper.d.ts +46 -0
  208. package/dist/core/query-mappers/go-mapper.d.ts.map +1 -0
  209. package/dist/core/query-mappers/go-mapper.js +477 -0
  210. package/dist/core/query-mappers/go-mapper.js.map +1 -0
  211. package/dist/core/query-mappers/index.d.ts +6 -0
  212. package/dist/core/query-mappers/index.d.ts.map +1 -0
  213. package/dist/core/query-mappers/index.js +5 -0
  214. package/dist/core/query-mappers/index.js.map +1 -0
  215. package/dist/core/query-mappers/java-mapper.d.ts +40 -0
  216. package/dist/core/query-mappers/java-mapper.d.ts.map +1 -0
  217. package/dist/core/query-mappers/java-mapper.js +405 -0
  218. package/dist/core/query-mappers/java-mapper.js.map +1 -0
  219. package/dist/core/query-mappers/python-mapper.d.ts +65 -0
  220. package/dist/core/query-mappers/python-mapper.d.ts.map +1 -0
  221. package/dist/core/query-mappers/python-mapper.js +673 -0
  222. package/dist/core/query-mappers/python-mapper.js.map +1 -0
  223. package/dist/core/query-mappers/typescript-mapper.d.ts +54 -0
  224. package/dist/core/query-mappers/typescript-mapper.d.ts.map +1 -0
  225. package/dist/core/query-mappers/typescript-mapper.js +706 -0
  226. package/dist/core/query-mappers/typescript-mapper.js.map +1 -0
  227. package/dist/core/secret-redactor.d.ts +10 -0
  228. package/dist/core/secret-redactor.d.ts.map +1 -0
  229. package/dist/core/secret-redactor.js +208 -0
  230. package/dist/core/secret-redactor.js.map +1 -0
  231. package/dist/core/single-spec-orchestrator.d.ts +103 -0
  232. package/dist/core/single-spec-orchestrator.d.ts.map +1 -0
  233. package/dist/core/single-spec-orchestrator.js +911 -0
  234. package/dist/core/single-spec-orchestrator.js.map +1 -0
  235. package/dist/core/token-counter.d.ts +48 -0
  236. package/dist/core/token-counter.d.ts.map +1 -0
  237. package/dist/core/token-counter.js +136 -0
  238. package/dist/core/token-counter.js.map +1 -0
  239. package/dist/core/tree-sitter-analyzer.d.ts +62 -0
  240. package/dist/core/tree-sitter-analyzer.d.ts.map +1 -0
  241. package/dist/core/tree-sitter-analyzer.js +229 -0
  242. package/dist/core/tree-sitter-analyzer.js.map +1 -0
  243. package/dist/core/tree-sitter-fallback.d.ts +14 -0
  244. package/dist/core/tree-sitter-fallback.d.ts.map +1 -0
  245. package/dist/core/tree-sitter-fallback.js +423 -0
  246. package/dist/core/tree-sitter-fallback.js.map +1 -0
  247. package/dist/debt-scanner/aggregator/quality-report-patcher.d.ts +22 -0
  248. package/dist/debt-scanner/aggregator/quality-report-patcher.d.ts.map +1 -0
  249. package/dist/debt-scanner/aggregator/quality-report-patcher.js +107 -0
  250. package/dist/debt-scanner/aggregator/quality-report-patcher.js.map +1 -0
  251. package/dist/debt-scanner/aggregator/readme-indexer.d.ts +6 -0
  252. package/dist/debt-scanner/aggregator/readme-indexer.d.ts.map +1 -0
  253. package/dist/debt-scanner/aggregator/readme-indexer.js +52 -0
  254. package/dist/debt-scanner/aggregator/readme-indexer.js.map +1 -0
  255. package/dist/debt-scanner/aggregator/report-builder.d.ts +25 -0
  256. package/dist/debt-scanner/aggregator/report-builder.d.ts.map +1 -0
  257. package/dist/debt-scanner/aggregator/report-builder.js +162 -0
  258. package/dist/debt-scanner/aggregator/report-builder.js.map +1 -0
  259. package/dist/debt-scanner/comments/debt-classifier.d.ts +28 -0
  260. package/dist/debt-scanner/comments/debt-classifier.d.ts.map +1 -0
  261. package/dist/debt-scanner/comments/debt-classifier.js +50 -0
  262. package/dist/debt-scanner/comments/debt-classifier.js.map +1 -0
  263. package/dist/debt-scanner/comments/index.d.ts +32 -0
  264. package/dist/debt-scanner/comments/index.d.ts.map +1 -0
  265. package/dist/debt-scanner/comments/index.js +103 -0
  266. package/dist/debt-scanner/comments/index.js.map +1 -0
  267. package/dist/debt-scanner/comments/symbol-resolver.d.ts +18 -0
  268. package/dist/debt-scanner/comments/symbol-resolver.d.ts.map +1 -0
  269. package/dist/debt-scanner/comments/symbol-resolver.js +18 -0
  270. package/dist/debt-scanner/comments/symbol-resolver.js.map +1 -0
  271. package/dist/debt-scanner/design-docs/doc-discoverer.d.ts +6 -0
  272. package/dist/debt-scanner/design-docs/doc-discoverer.d.ts.map +1 -0
  273. package/dist/debt-scanner/design-docs/doc-discoverer.js +62 -0
  274. package/dist/debt-scanner/design-docs/doc-discoverer.js.map +1 -0
  275. package/dist/debt-scanner/design-docs/index.d.ts +28 -0
  276. package/dist/debt-scanner/design-docs/index.d.ts.map +1 -0
  277. package/dist/debt-scanner/design-docs/index.js +60 -0
  278. package/dist/debt-scanner/design-docs/index.js.map +1 -0
  279. package/dist/debt-scanner/design-docs/llm-topic-inferrer.d.ts +68 -0
  280. package/dist/debt-scanner/design-docs/llm-topic-inferrer.d.ts.map +1 -0
  281. package/dist/debt-scanner/design-docs/llm-topic-inferrer.js +151 -0
  282. package/dist/debt-scanner/design-docs/llm-topic-inferrer.js.map +1 -0
  283. package/dist/debt-scanner/design-docs/markdown-sections.d.ts +24 -0
  284. package/dist/debt-scanner/design-docs/markdown-sections.d.ts.map +1 -0
  285. package/dist/debt-scanner/design-docs/markdown-sections.js +92 -0
  286. package/dist/debt-scanner/design-docs/markdown-sections.js.map +1 -0
  287. package/dist/debt-scanner/design-docs/rule-detector.d.ts +18 -0
  288. package/dist/debt-scanner/design-docs/rule-detector.d.ts.map +1 -0
  289. package/dist/debt-scanner/design-docs/rule-detector.js +46 -0
  290. package/dist/debt-scanner/design-docs/rule-detector.js.map +1 -0
  291. package/dist/debt-scanner/index.d.ts +43 -0
  292. package/dist/debt-scanner/index.d.ts.map +1 -0
  293. package/dist/debt-scanner/index.js +177 -0
  294. package/dist/debt-scanner/index.js.map +1 -0
  295. package/dist/debt-scanner/llm-clients.d.ts +33 -0
  296. package/dist/debt-scanner/llm-clients.d.ts.map +1 -0
  297. package/dist/debt-scanner/llm-clients.js +78 -0
  298. package/dist/debt-scanner/llm-clients.js.map +1 -0
  299. package/dist/debt-scanner/types.d.ts +97 -0
  300. package/dist/debt-scanner/types.d.ts.map +1 -0
  301. package/dist/debt-scanner/types.js +7 -0
  302. package/dist/debt-scanner/types.js.map +1 -0
  303. package/dist/diff/drift-orchestrator.d.ts +25 -0
  304. package/dist/diff/drift-orchestrator.d.ts.map +1 -0
  305. package/dist/diff/drift-orchestrator.js +248 -0
  306. package/dist/diff/drift-orchestrator.js.map +1 -0
  307. package/dist/diff/noise-filter.d.ts +27 -0
  308. package/dist/diff/noise-filter.d.ts.map +1 -0
  309. package/dist/diff/noise-filter.js +129 -0
  310. package/dist/diff/noise-filter.js.map +1 -0
  311. package/dist/diff/semantic-diff.d.ts +12 -0
  312. package/dist/diff/semantic-diff.d.ts.map +1 -0
  313. package/dist/diff/semantic-diff.js +94 -0
  314. package/dist/diff/semantic-diff.js.map +1 -0
  315. package/dist/diff/structural-diff.d.ts +16 -0
  316. package/dist/diff/structural-diff.d.ts.map +1 -0
  317. package/dist/diff/structural-diff.js +171 -0
  318. package/dist/diff/structural-diff.js.map +1 -0
  319. package/dist/extraction/artifact-classifier.d.ts +19 -0
  320. package/dist/extraction/artifact-classifier.d.ts.map +1 -0
  321. package/dist/extraction/artifact-classifier.js +104 -0
  322. package/dist/extraction/artifact-classifier.js.map +1 -0
  323. package/dist/extraction/extraction-cache.d.ts +32 -0
  324. package/dist/extraction/extraction-cache.d.ts.map +1 -0
  325. package/dist/extraction/extraction-cache.js +117 -0
  326. package/dist/extraction/extraction-cache.js.map +1 -0
  327. package/dist/extraction/extraction-pipeline.d.ts +44 -0
  328. package/dist/extraction/extraction-pipeline.d.ts.map +1 -0
  329. package/dist/extraction/extraction-pipeline.js +286 -0
  330. package/dist/extraction/extraction-pipeline.js.map +1 -0
  331. package/dist/extraction/extraction-types.d.ts +180 -0
  332. package/dist/extraction/extraction-types.d.ts.map +1 -0
  333. package/dist/extraction/extraction-types.js +63 -0
  334. package/dist/extraction/extraction-types.js.map +1 -0
  335. package/dist/extraction/image-extractor.d.ts +21 -0
  336. package/dist/extraction/image-extractor.d.ts.map +1 -0
  337. package/dist/extraction/image-extractor.js +211 -0
  338. package/dist/extraction/image-extractor.js.map +1 -0
  339. package/dist/extraction/index.d.ts +8 -0
  340. package/dist/extraction/index.d.ts.map +1 -0
  341. package/dist/extraction/index.js +6 -0
  342. package/dist/extraction/index.js.map +1 -0
  343. package/dist/extraction/markdown-extractor.d.ts +11 -0
  344. package/dist/extraction/markdown-extractor.d.ts.map +1 -0
  345. package/dist/extraction/markdown-extractor.js +212 -0
  346. package/dist/extraction/markdown-extractor.js.map +1 -0
  347. package/dist/extraction/openapi-extractor.d.ts +10 -0
  348. package/dist/extraction/openapi-extractor.d.ts.map +1 -0
  349. package/dist/extraction/openapi-extractor.js +449 -0
  350. package/dist/extraction/openapi-extractor.js.map +1 -0
  351. package/dist/generator/frontmatter.d.ts +58 -0
  352. package/dist/generator/frontmatter.d.ts.map +1 -0
  353. package/dist/generator/frontmatter.js +100 -0
  354. package/dist/generator/frontmatter.js.map +1 -0
  355. package/dist/generator/index-generator.d.ts +27 -0
  356. package/dist/generator/index-generator.d.ts.map +1 -0
  357. package/dist/generator/index-generator.js +129 -0
  358. package/dist/generator/index-generator.js.map +1 -0
  359. package/dist/generator/mermaid-class-diagram.d.ts +14 -0
  360. package/dist/generator/mermaid-class-diagram.d.ts.map +1 -0
  361. package/dist/generator/mermaid-class-diagram.js +115 -0
  362. package/dist/generator/mermaid-class-diagram.js.map +1 -0
  363. package/dist/generator/mermaid-dependency-graph.d.ts +15 -0
  364. package/dist/generator/mermaid-dependency-graph.d.ts.map +1 -0
  365. package/dist/generator/mermaid-dependency-graph.js +84 -0
  366. package/dist/generator/mermaid-dependency-graph.js.map +1 -0
  367. package/dist/generator/spec-renderer.d.ts +24 -0
  368. package/dist/generator/spec-renderer.d.ts.map +1 -0
  369. package/dist/generator/spec-renderer.js +110 -0
  370. package/dist/generator/spec-renderer.js.map +1 -0
  371. package/dist/graph/dependency-graph.d.ts +24 -0
  372. package/dist/graph/dependency-graph.d.ts.map +1 -0
  373. package/dist/graph/dependency-graph.js +206 -0
  374. package/dist/graph/dependency-graph.js.map +1 -0
  375. package/dist/graph/directory-graph.d.ts +16 -0
  376. package/dist/graph/directory-graph.d.ts.map +1 -0
  377. package/dist/graph/directory-graph.js +281 -0
  378. package/dist/graph/directory-graph.js.map +1 -0
  379. package/dist/graph/mermaid-renderer.d.ts +22 -0
  380. package/dist/graph/mermaid-renderer.d.ts.map +1 -0
  381. package/dist/graph/mermaid-renderer.js +133 -0
  382. package/dist/graph/mermaid-renderer.js.map +1 -0
  383. package/dist/graph/topological-sort.d.ts +31 -0
  384. package/dist/graph/topological-sort.d.ts.map +1 -0
  385. package/dist/graph/topological-sort.js +167 -0
  386. package/dist/graph/topological-sort.js.map +1 -0
  387. package/dist/hooks/git-hook-installer.d.ts +37 -0
  388. package/dist/hooks/git-hook-installer.d.ts.map +1 -0
  389. package/dist/hooks/git-hook-installer.js +136 -0
  390. package/dist/hooks/git-hook-installer.js.map +1 -0
  391. package/dist/hooks/hook-installer.d.ts +39 -0
  392. package/dist/hooks/hook-installer.d.ts.map +1 -0
  393. package/dist/hooks/hook-installer.js +164 -0
  394. package/dist/hooks/hook-installer.js.map +1 -0
  395. package/dist/installer/skill-installer.d.ts +63 -0
  396. package/dist/installer/skill-installer.d.ts.map +1 -0
  397. package/dist/installer/skill-installer.js +203 -0
  398. package/dist/installer/skill-installer.js.map +1 -0
  399. package/dist/installer/skill-templates.d.ts +19 -0
  400. package/dist/installer/skill-templates.d.ts.map +1 -0
  401. package/dist/installer/skill-templates.js +42 -0
  402. package/dist/installer/skill-templates.js.map +1 -0
  403. package/dist/mcp/graph-tools.d.ts +17 -0
  404. package/dist/mcp/graph-tools.d.ts.map +1 -0
  405. package/dist/mcp/graph-tools.js +269 -0
  406. package/dist/mcp/graph-tools.js.map +1 -0
  407. package/dist/mcp/index.d.ts +10 -0
  408. package/dist/mcp/index.d.ts.map +1 -0
  409. package/dist/mcp/index.js +18 -0
  410. package/dist/mcp/index.js.map +1 -0
  411. package/dist/mcp/server.d.ts +10 -0
  412. package/dist/mcp/server.d.ts.map +1 -0
  413. package/dist/mcp/server.js +235 -0
  414. package/dist/mcp/server.js.map +1 -0
  415. package/dist/models/code-skeleton.d.ts +394 -0
  416. package/dist/models/code-skeleton.d.ts.map +1 -0
  417. package/dist/models/code-skeleton.js +119 -0
  418. package/dist/models/code-skeleton.js.map +1 -0
  419. package/dist/models/dependency-graph.d.ts +172 -0
  420. package/dist/models/dependency-graph.d.ts.map +1 -0
  421. package/dist/models/dependency-graph.js +44 -0
  422. package/dist/models/dependency-graph.js.map +1 -0
  423. package/dist/models/drift-item.d.ts +104 -0
  424. package/dist/models/drift-item.d.ts.map +1 -0
  425. package/dist/models/drift-item.js +38 -0
  426. package/dist/models/drift-item.js.map +1 -0
  427. package/dist/models/module-spec.d.ts +1905 -0
  428. package/dist/models/module-spec.d.ts.map +1 -0
  429. package/dist/models/module-spec.js +272 -0
  430. package/dist/models/module-spec.js.map +1 -0
  431. package/dist/panoramic/abstract-registry.d.ts +87 -0
  432. package/dist/panoramic/abstract-registry.d.ts.map +1 -0
  433. package/dist/panoramic/abstract-registry.js +88 -0
  434. package/dist/panoramic/abstract-registry.js.map +1 -0
  435. package/dist/panoramic/anchoring/chunker.d.ts +34 -0
  436. package/dist/panoramic/anchoring/chunker.d.ts.map +1 -0
  437. package/dist/panoramic/anchoring/chunker.js +274 -0
  438. package/dist/panoramic/anchoring/chunker.js.map +1 -0
  439. package/dist/panoramic/anchoring/edge-builder.d.ts +53 -0
  440. package/dist/panoramic/anchoring/edge-builder.d.ts.map +1 -0
  441. package/dist/panoramic/anchoring/edge-builder.js +183 -0
  442. package/dist/panoramic/anchoring/edge-builder.js.map +1 -0
  443. package/dist/panoramic/anchoring/embedding-provider.d.ts +51 -0
  444. package/dist/panoramic/anchoring/embedding-provider.d.ts.map +1 -0
  445. package/dist/panoramic/anchoring/embedding-provider.js +7 -0
  446. package/dist/panoramic/anchoring/embedding-provider.js.map +1 -0
  447. package/dist/panoramic/anchoring/index.d.ts +73 -0
  448. package/dist/panoramic/anchoring/index.d.ts.map +1 -0
  449. package/dist/panoramic/anchoring/index.js +91 -0
  450. package/dist/panoramic/anchoring/index.js.map +1 -0
  451. package/dist/panoramic/anchoring/providers/factory.d.ts +35 -0
  452. package/dist/panoramic/anchoring/providers/factory.d.ts.map +1 -0
  453. package/dist/panoramic/anchoring/providers/factory.js +33 -0
  454. package/dist/panoramic/anchoring/providers/factory.js.map +1 -0
  455. package/dist/panoramic/anchoring/providers/local-provider.d.ts +48 -0
  456. package/dist/panoramic/anchoring/providers/local-provider.d.ts.map +1 -0
  457. package/dist/panoramic/anchoring/providers/local-provider.js +145 -0
  458. package/dist/panoramic/anchoring/providers/local-provider.js.map +1 -0
  459. package/dist/panoramic/anchoring/providers/openai-provider.d.ts +45 -0
  460. package/dist/panoramic/anchoring/providers/openai-provider.d.ts.map +1 -0
  461. package/dist/panoramic/anchoring/providers/openai-provider.js +78 -0
  462. package/dist/panoramic/anchoring/providers/openai-provider.js.map +1 -0
  463. package/dist/panoramic/anchoring/similarity.d.ts +37 -0
  464. package/dist/panoramic/anchoring/similarity.d.ts.map +1 -0
  465. package/dist/panoramic/anchoring/similarity.js +75 -0
  466. package/dist/panoramic/anchoring/similarity.js.map +1 -0
  467. package/dist/panoramic/api-surface/endpoint-utils.d.ts +15 -0
  468. package/dist/panoramic/api-surface/endpoint-utils.d.ts.map +1 -0
  469. package/dist/panoramic/api-surface/endpoint-utils.js +145 -0
  470. package/dist/panoramic/api-surface/endpoint-utils.js.map +1 -0
  471. package/dist/panoramic/api-surface/express-extractor.d.ts +3 -0
  472. package/dist/panoramic/api-surface/express-extractor.d.ts.map +1 -0
  473. package/dist/panoramic/api-surface/express-extractor.js +288 -0
  474. package/dist/panoramic/api-surface/express-extractor.js.map +1 -0
  475. package/dist/panoramic/api-surface/fastapi-extractor.d.ts +6 -0
  476. package/dist/panoramic/api-surface/fastapi-extractor.d.ts.map +1 -0
  477. package/dist/panoramic/api-surface/fastapi-extractor.js +287 -0
  478. package/dist/panoramic/api-surface/fastapi-extractor.js.map +1 -0
  479. package/dist/panoramic/api-surface/framework-introspection.d.ts +3 -0
  480. package/dist/panoramic/api-surface/framework-introspection.d.ts.map +1 -0
  481. package/dist/panoramic/api-surface/framework-introspection.js +189 -0
  482. package/dist/panoramic/api-surface/framework-introspection.js.map +1 -0
  483. package/dist/panoramic/api-surface/index.d.ts +13 -0
  484. package/dist/panoramic/api-surface/index.d.ts.map +1 -0
  485. package/dist/panoramic/api-surface/index.js +238 -0
  486. package/dist/panoramic/api-surface/index.js.map +1 -0
  487. package/dist/panoramic/api-surface/openapi-extractor.d.ts +3 -0
  488. package/dist/panoramic/api-surface/openapi-extractor.d.ts.map +1 -0
  489. package/dist/panoramic/api-surface/openapi-extractor.js +247 -0
  490. package/dist/panoramic/api-surface/openapi-extractor.js.map +1 -0
  491. package/dist/panoramic/api-surface/types.d.ts +140 -0
  492. package/dist/panoramic/api-surface/types.d.ts.map +1 -0
  493. package/dist/panoramic/api-surface/types.js +7 -0
  494. package/dist/panoramic/api-surface/types.js.map +1 -0
  495. package/dist/panoramic/api-surface/utils.d.ts +29 -0
  496. package/dist/panoramic/api-surface/utils.d.ts.map +1 -0
  497. package/dist/panoramic/api-surface/utils.js +340 -0
  498. package/dist/panoramic/api-surface/utils.js.map +1 -0
  499. package/dist/panoramic/batch-project-docs.d.ts +101 -0
  500. package/dist/panoramic/batch-project-docs.d.ts.map +1 -0
  501. package/dist/panoramic/batch-project-docs.js +616 -0
  502. package/dist/panoramic/batch-project-docs.js.map +1 -0
  503. package/dist/panoramic/builders/architecture-ir-builder.d.ts +19 -0
  504. package/dist/panoramic/builders/architecture-ir-builder.d.ts.map +1 -0
  505. package/dist/panoramic/builders/architecture-ir-builder.js +561 -0
  506. package/dist/panoramic/builders/architecture-ir-builder.js.map +1 -0
  507. package/dist/panoramic/builders/architecture-ir-mermaid-adapter.d.ts +6 -0
  508. package/dist/panoramic/builders/architecture-ir-mermaid-adapter.d.ts.map +1 -0
  509. package/dist/panoramic/builders/architecture-ir-mermaid-adapter.js +98 -0
  510. package/dist/panoramic/builders/architecture-ir-mermaid-adapter.js.map +1 -0
  511. package/dist/panoramic/builders/component-view-builder.d.ts +38 -0
  512. package/dist/panoramic/builders/component-view-builder.d.ts.map +1 -0
  513. package/dist/panoramic/builders/component-view-builder.js +694 -0
  514. package/dist/panoramic/builders/component-view-builder.js.map +1 -0
  515. package/dist/panoramic/builders/doc-graph-builder.d.ts +179 -0
  516. package/dist/panoramic/builders/doc-graph-builder.d.ts.map +1 -0
  517. package/dist/panoramic/builders/doc-graph-builder.js +546 -0
  518. package/dist/panoramic/builders/doc-graph-builder.js.map +1 -0
  519. package/dist/panoramic/builders/dynamic-scenarios-builder.d.ts +38 -0
  520. package/dist/panoramic/builders/dynamic-scenarios-builder.d.ts.map +1 -0
  521. package/dist/panoramic/builders/dynamic-scenarios-builder.js +361 -0
  522. package/dist/panoramic/builders/dynamic-scenarios-builder.js.map +1 -0
  523. package/dist/panoramic/cache/cache-key-builder.d.ts +25 -0
  524. package/dist/panoramic/cache/cache-key-builder.d.ts.map +1 -0
  525. package/dist/panoramic/cache/cache-key-builder.js +119 -0
  526. package/dist/panoramic/cache/cache-key-builder.js.map +1 -0
  527. package/dist/panoramic/cache/cache-manager.d.ts +58 -0
  528. package/dist/panoramic/cache/cache-manager.d.ts.map +1 -0
  529. package/dist/panoramic/cache/cache-manager.js +170 -0
  530. package/dist/panoramic/cache/cache-manager.js.map +1 -0
  531. package/dist/panoramic/cache/content-hasher.d.ts +47 -0
  532. package/dist/panoramic/cache/content-hasher.d.ts.map +1 -0
  533. package/dist/panoramic/cache/content-hasher.js +89 -0
  534. package/dist/panoramic/cache/content-hasher.js.map +1 -0
  535. package/dist/panoramic/cache/index.d.ts +10 -0
  536. package/dist/panoramic/cache/index.d.ts.map +1 -0
  537. package/dist/panoramic/cache/index.js +13 -0
  538. package/dist/panoramic/cache/index.js.map +1 -0
  539. package/dist/panoramic/cache/manifest-manager.d.ts +83 -0
  540. package/dist/panoramic/cache/manifest-manager.d.ts.map +1 -0
  541. package/dist/panoramic/cache/manifest-manager.js +119 -0
  542. package/dist/panoramic/cache/manifest-manager.js.map +1 -0
  543. package/dist/panoramic/cache/schemas.d.ts +199 -0
  544. package/dist/panoramic/cache/schemas.d.ts.map +1 -0
  545. package/dist/panoramic/cache/schemas.js +53 -0
  546. package/dist/panoramic/cache/schemas.js.map +1 -0
  547. package/dist/panoramic/cluster-orchestrator.d.ts +278 -0
  548. package/dist/panoramic/cluster-orchestrator.d.ts.map +1 -0
  549. package/dist/panoramic/cluster-orchestrator.js +531 -0
  550. package/dist/panoramic/cluster-orchestrator.js.map +1 -0
  551. package/dist/panoramic/community/community-detector.d.ts +41 -0
  552. package/dist/panoramic/community/community-detector.d.ts.map +1 -0
  553. package/dist/panoramic/community/community-detector.js +190 -0
  554. package/dist/panoramic/community/community-detector.js.map +1 -0
  555. package/dist/panoramic/community/god-node-analyzer.d.ts +28 -0
  556. package/dist/panoramic/community/god-node-analyzer.d.ts.map +1 -0
  557. package/dist/panoramic/community/god-node-analyzer.js +91 -0
  558. package/dist/panoramic/community/god-node-analyzer.js.map +1 -0
  559. package/dist/panoramic/community/graph-report-generator.d.ts +31 -0
  560. package/dist/panoramic/community/graph-report-generator.d.ts.map +1 -0
  561. package/dist/panoramic/community/graph-report-generator.js +98 -0
  562. package/dist/panoramic/community/graph-report-generator.js.map +1 -0
  563. package/dist/panoramic/community/index.d.ts +31 -0
  564. package/dist/panoramic/community/index.d.ts.map +1 -0
  565. package/dist/panoramic/community/index.js +63 -0
  566. package/dist/panoramic/community/index.js.map +1 -0
  567. package/dist/panoramic/community/surprising-edges.d.ts +42 -0
  568. package/dist/panoramic/community/surprising-edges.d.ts.map +1 -0
  569. package/dist/panoramic/community/surprising-edges.js +154 -0
  570. package/dist/panoramic/community/surprising-edges.js.map +1 -0
  571. package/dist/panoramic/cross-reference-index.d.ts +4 -0
  572. package/dist/panoramic/cross-reference-index.d.ts.map +1 -0
  573. package/dist/panoramic/cross-reference-index.js +201 -0
  574. package/dist/panoramic/cross-reference-index.js.map +1 -0
  575. package/dist/panoramic/exporters/architecture-ir-exporters.d.ts +7 -0
  576. package/dist/panoramic/exporters/architecture-ir-exporters.d.ts.map +1 -0
  577. package/dist/panoramic/exporters/architecture-ir-exporters.js +183 -0
  578. package/dist/panoramic/exporters/architecture-ir-exporters.js.map +1 -0
  579. package/dist/panoramic/exporters/export-types.d.ts +33 -0
  580. package/dist/panoramic/exporters/export-types.d.ts.map +1 -0
  581. package/dist/panoramic/exporters/export-types.js +7 -0
  582. package/dist/panoramic/exporters/export-types.js.map +1 -0
  583. package/dist/panoramic/exporters/html-exporter.d.ts +83 -0
  584. package/dist/panoramic/exporters/html-exporter.d.ts.map +1 -0
  585. package/dist/panoramic/exporters/html-exporter.js +224 -0
  586. package/dist/panoramic/exporters/html-exporter.js.map +1 -0
  587. package/dist/panoramic/exporters/html-template.d.ts +32 -0
  588. package/dist/panoramic/exporters/html-template.d.ts.map +1 -0
  589. package/dist/panoramic/exporters/html-template.js +737 -0
  590. package/dist/panoramic/exporters/html-template.js.map +1 -0
  591. package/dist/panoramic/exporters/obsidian-exporter.d.ts +67 -0
  592. package/dist/panoramic/exporters/obsidian-exporter.d.ts.map +1 -0
  593. package/dist/panoramic/exporters/obsidian-exporter.js +333 -0
  594. package/dist/panoramic/exporters/obsidian-exporter.js.map +1 -0
  595. package/dist/panoramic/generator-registry.d.ts +86 -0
  596. package/dist/panoramic/generator-registry.d.ts.map +1 -0
  597. package/dist/panoramic/generator-registry.js +194 -0
  598. package/dist/panoramic/generator-registry.js.map +1 -0
  599. package/dist/panoramic/generators/architecture-ir-generator.d.ts +36 -0
  600. package/dist/panoramic/generators/architecture-ir-generator.d.ts.map +1 -0
  601. package/dist/panoramic/generators/architecture-ir-generator.js +51 -0
  602. package/dist/panoramic/generators/architecture-ir-generator.js.map +1 -0
  603. package/dist/panoramic/generators/architecture-overview-generator.d.ts +31 -0
  604. package/dist/panoramic/generators/architecture-overview-generator.d.ts.map +1 -0
  605. package/dist/panoramic/generators/architecture-overview-generator.js +454 -0
  606. package/dist/panoramic/generators/architecture-overview-generator.js.map +1 -0
  607. package/dist/panoramic/generators/config-reference-generator.d.ts +78 -0
  608. package/dist/panoramic/generators/config-reference-generator.d.ts.map +1 -0
  609. package/dist/panoramic/generators/config-reference-generator.js +201 -0
  610. package/dist/panoramic/generators/config-reference-generator.js.map +1 -0
  611. package/dist/panoramic/generators/cross-package-analyzer.d.ts +112 -0
  612. package/dist/panoramic/generators/cross-package-analyzer.d.ts.map +1 -0
  613. package/dist/panoramic/generators/cross-package-analyzer.js +258 -0
  614. package/dist/panoramic/generators/cross-package-analyzer.js.map +1 -0
  615. package/dist/panoramic/generators/data-model-generator.d.ts +528 -0
  616. package/dist/panoramic/generators/data-model-generator.d.ts.map +1 -0
  617. package/dist/panoramic/generators/data-model-generator.js +674 -0
  618. package/dist/panoramic/generators/data-model-generator.js.map +1 -0
  619. package/dist/panoramic/generators/event-surface-generator.d.ts +52 -0
  620. package/dist/panoramic/generators/event-surface-generator.d.ts.map +1 -0
  621. package/dist/panoramic/generators/event-surface-generator.js +634 -0
  622. package/dist/panoramic/generators/event-surface-generator.js.map +1 -0
  623. package/dist/panoramic/generators/interface-surface-generator.d.ts +50 -0
  624. package/dist/panoramic/generators/interface-surface-generator.d.ts.map +1 -0
  625. package/dist/panoramic/generators/interface-surface-generator.js +393 -0
  626. package/dist/panoramic/generators/interface-surface-generator.js.map +1 -0
  627. package/dist/panoramic/generators/mock-readme-generator.d.ts +90 -0
  628. package/dist/panoramic/generators/mock-readme-generator.d.ts.map +1 -0
  629. package/dist/panoramic/generators/mock-readme-generator.js +113 -0
  630. package/dist/panoramic/generators/mock-readme-generator.js.map +1 -0
  631. package/dist/panoramic/generators/pattern-hints-generator.d.ts +28 -0
  632. package/dist/panoramic/generators/pattern-hints-generator.d.ts.map +1 -0
  633. package/dist/panoramic/generators/pattern-hints-generator.js +170 -0
  634. package/dist/panoramic/generators/pattern-hints-generator.js.map +1 -0
  635. package/dist/panoramic/generators/runtime-topology-generator.d.ts +77 -0
  636. package/dist/panoramic/generators/runtime-topology-generator.d.ts.map +1 -0
  637. package/dist/panoramic/generators/runtime-topology-generator.js +679 -0
  638. package/dist/panoramic/generators/runtime-topology-generator.js.map +1 -0
  639. package/dist/panoramic/generators/troubleshooting-generator.d.ts +51 -0
  640. package/dist/panoramic/generators/troubleshooting-generator.d.ts.map +1 -0
  641. package/dist/panoramic/generators/troubleshooting-generator.js +464 -0
  642. package/dist/panoramic/generators/troubleshooting-generator.js.map +1 -0
  643. package/dist/panoramic/generators/workspace-index-generator.d.ts +148 -0
  644. package/dist/panoramic/generators/workspace-index-generator.d.ts.map +1 -0
  645. package/dist/panoramic/generators/workspace-index-generator.js +500 -0
  646. package/dist/panoramic/generators/workspace-index-generator.js.map +1 -0
  647. package/dist/panoramic/graph/confidence-mapper.d.ts +39 -0
  648. package/dist/panoramic/graph/confidence-mapper.d.ts.map +1 -0
  649. package/dist/panoramic/graph/confidence-mapper.js +55 -0
  650. package/dist/panoramic/graph/confidence-mapper.js.map +1 -0
  651. package/dist/panoramic/graph/graph-builder.d.ts +33 -0
  652. package/dist/panoramic/graph/graph-builder.d.ts.map +1 -0
  653. package/dist/panoramic/graph/graph-builder.js +382 -0
  654. package/dist/panoramic/graph/graph-builder.js.map +1 -0
  655. package/dist/panoramic/graph/graph-paths.d.ts +13 -0
  656. package/dist/panoramic/graph/graph-paths.d.ts.map +1 -0
  657. package/dist/panoramic/graph/graph-paths.js +16 -0
  658. package/dist/panoramic/graph/graph-paths.js.map +1 -0
  659. package/dist/panoramic/graph/graph-query.d.ts +226 -0
  660. package/dist/panoramic/graph/graph-query.d.ts.map +1 -0
  661. package/dist/panoramic/graph/graph-query.js +571 -0
  662. package/dist/panoramic/graph/graph-query.js.map +1 -0
  663. package/dist/panoramic/graph/graph-types.d.ts +156 -0
  664. package/dist/panoramic/graph/graph-types.d.ts.map +1 -0
  665. package/dist/panoramic/graph/graph-types.js +10 -0
  666. package/dist/panoramic/graph/graph-types.js.map +1 -0
  667. package/dist/panoramic/graph/index.d.ts +6 -0
  668. package/dist/panoramic/graph/index.d.ts.map +1 -0
  669. package/dist/panoramic/graph/index.js +8 -0
  670. package/dist/panoramic/graph/index.js.map +1 -0
  671. package/dist/panoramic/hyperedges/constants.d.ts +16 -0
  672. package/dist/panoramic/hyperedges/constants.d.ts.map +1 -0
  673. package/dist/panoramic/hyperedges/constants.js +13 -0
  674. package/dist/panoramic/hyperedges/constants.js.map +1 -0
  675. package/dist/panoramic/hyperedges/extractor.d.ts +80 -0
  676. package/dist/panoramic/hyperedges/extractor.d.ts.map +1 -0
  677. package/dist/panoramic/hyperedges/extractor.js +133 -0
  678. package/dist/panoramic/hyperedges/extractor.js.map +1 -0
  679. package/dist/panoramic/hyperedges/index.d.ts +12 -0
  680. package/dist/panoramic/hyperedges/index.d.ts.map +1 -0
  681. package/dist/panoramic/hyperedges/index.js +19 -0
  682. package/dist/panoramic/hyperedges/index.js.map +1 -0
  683. package/dist/panoramic/hyperedges/prompt.d.ts +30 -0
  684. package/dist/panoramic/hyperedges/prompt.d.ts.map +1 -0
  685. package/dist/panoramic/hyperedges/prompt.js +88 -0
  686. package/dist/panoramic/hyperedges/prompt.js.map +1 -0
  687. package/dist/panoramic/hyperedges/schema.d.ts +91 -0
  688. package/dist/panoramic/hyperedges/schema.d.ts.map +1 -0
  689. package/dist/panoramic/hyperedges/schema.js +52 -0
  690. package/dist/panoramic/hyperedges/schema.js.map +1 -0
  691. package/dist/panoramic/index.d.ts +17 -0
  692. package/dist/panoramic/index.d.ts.map +1 -0
  693. package/dist/panoramic/index.js +22 -0
  694. package/dist/panoramic/index.js.map +1 -0
  695. package/dist/panoramic/interfaces.d.ts +243 -0
  696. package/dist/panoramic/interfaces.d.ts.map +1 -0
  697. package/dist/panoramic/interfaces.js +130 -0
  698. package/dist/panoramic/interfaces.js.map +1 -0
  699. package/dist/panoramic/internal.d.ts +67 -0
  700. package/dist/panoramic/internal.d.ts.map +1 -0
  701. package/dist/panoramic/internal.js +93 -0
  702. package/dist/panoramic/internal.js.map +1 -0
  703. package/dist/panoramic/models/architecture-ir-model.d.ts +92 -0
  704. package/dist/panoramic/models/architecture-ir-model.d.ts.map +1 -0
  705. package/dist/panoramic/models/architecture-ir-model.js +14 -0
  706. package/dist/panoramic/models/architecture-ir-model.js.map +1 -0
  707. package/dist/panoramic/models/architecture-overview-model.d.ts +77 -0
  708. package/dist/panoramic/models/architecture-overview-model.d.ts.map +1 -0
  709. package/dist/panoramic/models/architecture-overview-model.js +31 -0
  710. package/dist/panoramic/models/architecture-overview-model.js.map +1 -0
  711. package/dist/panoramic/models/component-view-model.d.ts +127 -0
  712. package/dist/panoramic/models/component-view-model.d.ts.map +1 -0
  713. package/dist/panoramic/models/component-view-model.js +65 -0
  714. package/dist/panoramic/models/component-view-model.js.map +1 -0
  715. package/dist/panoramic/models/docs-bundle-profiles.d.ts +4 -0
  716. package/dist/panoramic/models/docs-bundle-profiles.d.ts.map +1 -0
  717. package/dist/panoramic/models/docs-bundle-profiles.js +82 -0
  718. package/dist/panoramic/models/docs-bundle-profiles.js.map +1 -0
  719. package/dist/panoramic/models/docs-bundle-types.d.ts +94 -0
  720. package/dist/panoramic/models/docs-bundle-types.d.ts.map +1 -0
  721. package/dist/panoramic/models/docs-bundle-types.js +10 -0
  722. package/dist/panoramic/models/docs-bundle-types.js.map +1 -0
  723. package/dist/panoramic/models/docs-quality-model.d.ts +125 -0
  724. package/dist/panoramic/models/docs-quality-model.d.ts.map +1 -0
  725. package/dist/panoramic/models/docs-quality-model.js +166 -0
  726. package/dist/panoramic/models/docs-quality-model.js.map +1 -0
  727. package/dist/panoramic/models/pattern-hints-model.d.ts +89 -0
  728. package/dist/panoramic/models/pattern-hints-model.d.ts.map +1 -0
  729. package/dist/panoramic/models/pattern-hints-model.js +61 -0
  730. package/dist/panoramic/models/pattern-hints-model.js.map +1 -0
  731. package/dist/panoramic/models/pattern-knowledge-base.d.ts +31 -0
  732. package/dist/panoramic/models/pattern-knowledge-base.d.ts.map +1 -0
  733. package/dist/panoramic/models/pattern-knowledge-base.js +407 -0
  734. package/dist/panoramic/models/pattern-knowledge-base.js.map +1 -0
  735. package/dist/panoramic/models/runtime-topology-model.d.ts +145 -0
  736. package/dist/panoramic/models/runtime-topology-model.d.ts.map +1 -0
  737. package/dist/panoramic/models/runtime-topology-model.js +300 -0
  738. package/dist/panoramic/models/runtime-topology-model.js.map +1 -0
  739. package/dist/panoramic/output-filenames.d.ts +26 -0
  740. package/dist/panoramic/output-filenames.d.ts.map +1 -0
  741. package/dist/panoramic/output-filenames.js +48 -0
  742. package/dist/panoramic/output-filenames.js.map +1 -0
  743. package/dist/panoramic/parser-registry.d.ts +89 -0
  744. package/dist/panoramic/parser-registry.d.ts.map +1 -0
  745. package/dist/panoramic/parser-registry.js +169 -0
  746. package/dist/panoramic/parser-registry.js.map +1 -0
  747. package/dist/panoramic/parsers/abstract-artifact-parser.d.ts +48 -0
  748. package/dist/panoramic/parsers/abstract-artifact-parser.d.ts.map +1 -0
  749. package/dist/panoramic/parsers/abstract-artifact-parser.js +52 -0
  750. package/dist/panoramic/parsers/abstract-artifact-parser.js.map +1 -0
  751. package/dist/panoramic/parsers/abstract-config-parser.d.ts +35 -0
  752. package/dist/panoramic/parsers/abstract-config-parser.d.ts.map +1 -0
  753. package/dist/panoramic/parsers/abstract-config-parser.js +34 -0
  754. package/dist/panoramic/parsers/abstract-config-parser.js.map +1 -0
  755. package/dist/panoramic/parsers/behavior-yaml-parser.d.ts +34 -0
  756. package/dist/panoramic/parsers/behavior-yaml-parser.d.ts.map +1 -0
  757. package/dist/panoramic/parsers/behavior-yaml-parser.js +195 -0
  758. package/dist/panoramic/parsers/behavior-yaml-parser.js.map +1 -0
  759. package/dist/panoramic/parsers/comment-tracker.d.ts +37 -0
  760. package/dist/panoramic/parsers/comment-tracker.d.ts.map +1 -0
  761. package/dist/panoramic/parsers/comment-tracker.js +50 -0
  762. package/dist/panoramic/parsers/comment-tracker.js.map +1 -0
  763. package/dist/panoramic/parsers/dockerfile-parser.d.ts +42 -0
  764. package/dist/panoramic/parsers/dockerfile-parser.d.ts.map +1 -0
  765. package/dist/panoramic/parsers/dockerfile-parser.js +128 -0
  766. package/dist/panoramic/parsers/dockerfile-parser.js.map +1 -0
  767. package/dist/panoramic/parsers/env-config-parser.d.ts +37 -0
  768. package/dist/panoramic/parsers/env-config-parser.d.ts.map +1 -0
  769. package/dist/panoramic/parsers/env-config-parser.js +73 -0
  770. package/dist/panoramic/parsers/env-config-parser.js.map +1 -0
  771. package/dist/panoramic/parsers/index.d.ts +25 -0
  772. package/dist/panoramic/parsers/index.d.ts.map +1 -0
  773. package/dist/panoramic/parsers/index.js +25 -0
  774. package/dist/panoramic/parsers/index.js.map +1 -0
  775. package/dist/panoramic/parsers/skill-md-parser.d.ts +42 -0
  776. package/dist/panoramic/parsers/skill-md-parser.d.ts.map +1 -0
  777. package/dist/panoramic/parsers/skill-md-parser.js +105 -0
  778. package/dist/panoramic/parsers/skill-md-parser.js.map +1 -0
  779. package/dist/panoramic/parsers/toml-config-parser.d.ts +39 -0
  780. package/dist/panoramic/parsers/toml-config-parser.d.ts.map +1 -0
  781. package/dist/panoramic/parsers/toml-config-parser.js +98 -0
  782. package/dist/panoramic/parsers/toml-config-parser.js.map +1 -0
  783. package/dist/panoramic/parsers/types.d.ts +314 -0
  784. package/dist/panoramic/parsers/types.d.ts.map +1 -0
  785. package/dist/panoramic/parsers/types.js +136 -0
  786. package/dist/panoramic/parsers/types.js.map +1 -0
  787. package/dist/panoramic/parsers/yaml-config-parser.d.ts +58 -0
  788. package/dist/panoramic/parsers/yaml-config-parser.d.ts.map +1 -0
  789. package/dist/panoramic/parsers/yaml-config-parser.js +356 -0
  790. package/dist/panoramic/parsers/yaml-config-parser.js.map +1 -0
  791. package/dist/panoramic/pipelines/adr-decision-pipeline.d.ts +74 -0
  792. package/dist/panoramic/pipelines/adr-decision-pipeline.d.ts.map +1 -0
  793. package/dist/panoramic/pipelines/adr-decision-pipeline.js +421 -0
  794. package/dist/panoramic/pipelines/adr-decision-pipeline.js.map +1 -0
  795. package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts +30 -0
  796. package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts.map +1 -0
  797. package/dist/panoramic/pipelines/adr-evidence-verifier.js +141 -0
  798. package/dist/panoramic/pipelines/adr-evidence-verifier.js.map +1 -0
  799. package/dist/panoramic/pipelines/adr-mapreduce.d.ts +316 -0
  800. package/dist/panoramic/pipelines/adr-mapreduce.d.ts.map +1 -0
  801. package/dist/panoramic/pipelines/adr-mapreduce.js +331 -0
  802. package/dist/panoramic/pipelines/adr-mapreduce.js.map +1 -0
  803. package/dist/panoramic/pipelines/adr-migration.d.ts +26 -0
  804. package/dist/panoramic/pipelines/adr-migration.d.ts.map +1 -0
  805. package/dist/panoramic/pipelines/adr-migration.js +203 -0
  806. package/dist/panoramic/pipelines/adr-migration.js.map +1 -0
  807. package/dist/panoramic/pipelines/architecture-narrative-mapreduce.d.ts +121 -0
  808. package/dist/panoramic/pipelines/architecture-narrative-mapreduce.d.ts.map +1 -0
  809. package/dist/panoramic/pipelines/architecture-narrative-mapreduce.js +412 -0
  810. package/dist/panoramic/pipelines/architecture-narrative-mapreduce.js.map +1 -0
  811. package/dist/panoramic/pipelines/architecture-narrative.d.ts +123 -0
  812. package/dist/panoramic/pipelines/architecture-narrative.d.ts.map +1 -0
  813. package/dist/panoramic/pipelines/architecture-narrative.js +419 -0
  814. package/dist/panoramic/pipelines/architecture-narrative.js.map +1 -0
  815. package/dist/panoramic/pipelines/coverage-auditor.d.ts +95 -0
  816. package/dist/panoramic/pipelines/coverage-auditor.d.ts.map +1 -0
  817. package/dist/panoramic/pipelines/coverage-auditor.js +290 -0
  818. package/dist/panoramic/pipelines/coverage-auditor.js.map +1 -0
  819. package/dist/panoramic/pipelines/debt-intelligence-pipeline.d.ts +32 -0
  820. package/dist/panoramic/pipelines/debt-intelligence-pipeline.d.ts.map +1 -0
  821. package/dist/panoramic/pipelines/debt-intelligence-pipeline.js +108 -0
  822. package/dist/panoramic/pipelines/debt-intelligence-pipeline.js.map +1 -0
  823. package/dist/panoramic/pipelines/docs-bundle-manifest-reader.d.ts +26 -0
  824. package/dist/panoramic/pipelines/docs-bundle-manifest-reader.d.ts.map +1 -0
  825. package/dist/panoramic/pipelines/docs-bundle-manifest-reader.js +108 -0
  826. package/dist/panoramic/pipelines/docs-bundle-manifest-reader.js.map +1 -0
  827. package/dist/panoramic/pipelines/docs-bundle-orchestrator.d.ts +16 -0
  828. package/dist/panoramic/pipelines/docs-bundle-orchestrator.d.ts.map +1 -0
  829. package/dist/panoramic/pipelines/docs-bundle-orchestrator.js +588 -0
  830. package/dist/panoramic/pipelines/docs-bundle-orchestrator.js.map +1 -0
  831. package/dist/panoramic/pipelines/docs-quality-evaluator.d.ts +55 -0
  832. package/dist/panoramic/pipelines/docs-quality-evaluator.d.ts.map +1 -0
  833. package/dist/panoramic/pipelines/docs-quality-evaluator.js +1045 -0
  834. package/dist/panoramic/pipelines/docs-quality-evaluator.js.map +1 -0
  835. package/dist/panoramic/pipelines/narrative-provenance-adapter.d.ts +8 -0
  836. package/dist/panoramic/pipelines/narrative-provenance-adapter.d.ts.map +1 -0
  837. package/dist/panoramic/pipelines/narrative-provenance-adapter.js +99 -0
  838. package/dist/panoramic/pipelines/narrative-provenance-adapter.js.map +1 -0
  839. package/dist/panoramic/pipelines/product-ux-docs.d.ts +123 -0
  840. package/dist/panoramic/pipelines/product-ux-docs.d.ts.map +1 -0
  841. package/dist/panoramic/pipelines/product-ux-docs.js +959 -0
  842. package/dist/panoramic/pipelines/product-ux-docs.js.map +1 -0
  843. package/dist/panoramic/project-context.d.ts +17 -0
  844. package/dist/panoramic/project-context.d.ts.map +1 -0
  845. package/dist/panoramic/project-context.js +289 -0
  846. package/dist/panoramic/project-context.js.map +1 -0
  847. package/dist/panoramic/qa/citation.d.ts +21 -0
  848. package/dist/panoramic/qa/citation.d.ts.map +1 -0
  849. package/dist/panoramic/qa/citation.js +184 -0
  850. package/dist/panoramic/qa/citation.js.map +1 -0
  851. package/dist/panoramic/qa/debt-context.d.ts +33 -0
  852. package/dist/panoramic/qa/debt-context.d.ts.map +1 -0
  853. package/dist/panoramic/qa/debt-context.js +82 -0
  854. package/dist/panoramic/qa/debt-context.js.map +1 -0
  855. package/dist/panoramic/qa/graph-retriever.d.ts +29 -0
  856. package/dist/panoramic/qa/graph-retriever.d.ts.map +1 -0
  857. package/dist/panoramic/qa/graph-retriever.js +65 -0
  858. package/dist/panoramic/qa/graph-retriever.js.map +1 -0
  859. package/dist/panoramic/qa/index.d.ts +23 -0
  860. package/dist/panoramic/qa/index.d.ts.map +1 -0
  861. package/dist/panoramic/qa/index.js +201 -0
  862. package/dist/panoramic/qa/index.js.map +1 -0
  863. package/dist/panoramic/qa/llm-caller.d.ts +35 -0
  864. package/dist/panoramic/qa/llm-caller.d.ts.map +1 -0
  865. package/dist/panoramic/qa/llm-caller.js +138 -0
  866. package/dist/panoramic/qa/llm-caller.js.map +1 -0
  867. package/dist/panoramic/qa/prompt-builder.d.ts +36 -0
  868. package/dist/panoramic/qa/prompt-builder.d.ts.map +1 -0
  869. package/dist/panoramic/qa/prompt-builder.js +143 -0
  870. package/dist/panoramic/qa/prompt-builder.js.map +1 -0
  871. package/dist/panoramic/qa/rag-reranker.d.ts +43 -0
  872. package/dist/panoramic/qa/rag-reranker.d.ts.map +1 -0
  873. package/dist/panoramic/qa/rag-reranker.js +129 -0
  874. package/dist/panoramic/qa/rag-reranker.js.map +1 -0
  875. package/dist/panoramic/qa/types.d.ts +126 -0
  876. package/dist/panoramic/qa/types.d.ts.map +1 -0
  877. package/dist/panoramic/qa/types.js +6 -0
  878. package/dist/panoramic/qa/types.js.map +1 -0
  879. package/dist/panoramic/query.d.ts +29 -0
  880. package/dist/panoramic/query.d.ts.map +1 -0
  881. package/dist/panoramic/query.js +80 -0
  882. package/dist/panoramic/query.js.map +1 -0
  883. package/dist/panoramic/stored-module-specs.d.ts +26 -0
  884. package/dist/panoramic/stored-module-specs.d.ts.map +1 -0
  885. package/dist/panoramic/stored-module-specs.js +155 -0
  886. package/dist/panoramic/stored-module-specs.js.map +1 -0
  887. package/dist/panoramic/utils/html-sanitizer.d.ts +33 -0
  888. package/dist/panoramic/utils/html-sanitizer.d.ts.map +1 -0
  889. package/dist/panoramic/utils/html-sanitizer.js +170 -0
  890. package/dist/panoramic/utils/html-sanitizer.js.map +1 -0
  891. package/dist/panoramic/utils/llm-enricher.d.ts +74 -0
  892. package/dist/panoramic/utils/llm-enricher.d.ts.map +1 -0
  893. package/dist/panoramic/utils/llm-enricher.js +315 -0
  894. package/dist/panoramic/utils/llm-enricher.js.map +1 -0
  895. package/dist/panoramic/utils/llm-facade.d.ts +66 -0
  896. package/dist/panoramic/utils/llm-facade.d.ts.map +1 -0
  897. package/dist/panoramic/utils/llm-facade.js +136 -0
  898. package/dist/panoramic/utils/llm-facade.js.map +1 -0
  899. package/dist/panoramic/utils/logger.d.ts +43 -0
  900. package/dist/panoramic/utils/logger.d.ts.map +1 -0
  901. package/dist/panoramic/utils/logger.js +76 -0
  902. package/dist/panoramic/utils/logger.js.map +1 -0
  903. package/dist/panoramic/utils/mermaid-helpers.d.ts +19 -0
  904. package/dist/panoramic/utils/mermaid-helpers.d.ts.map +1 -0
  905. package/dist/panoramic/utils/mermaid-helpers.js +21 -0
  906. package/dist/panoramic/utils/mermaid-helpers.js.map +1 -0
  907. package/dist/panoramic/utils/multi-format-writer.d.ts +43 -0
  908. package/dist/panoramic/utils/multi-format-writer.d.ts.map +1 -0
  909. package/dist/panoramic/utils/multi-format-writer.js +73 -0
  910. package/dist/panoramic/utils/multi-format-writer.js.map +1 -0
  911. package/dist/panoramic/utils/template-loader.d.ts +15 -0
  912. package/dist/panoramic/utils/template-loader.d.ts.map +1 -0
  913. package/dist/panoramic/utils/template-loader.js +65 -0
  914. package/dist/panoramic/utils/template-loader.js.map +1 -0
  915. package/dist/panoramic/utils/text-segmenter.d.ts +50 -0
  916. package/dist/panoramic/utils/text-segmenter.d.ts.map +1 -0
  917. package/dist/panoramic/utils/text-segmenter.js +151 -0
  918. package/dist/panoramic/utils/text-segmenter.js.map +1 -0
  919. package/dist/scripts/postinstall.d.ts +7 -0
  920. package/dist/scripts/postinstall.d.ts.map +1 -0
  921. package/dist/scripts/postinstall.js +70 -0
  922. package/dist/scripts/postinstall.js.map +1 -0
  923. package/dist/scripts/preuninstall.d.ts +7 -0
  924. package/dist/scripts/preuninstall.d.ts.map +1 -0
  925. package/dist/scripts/preuninstall.js +62 -0
  926. package/dist/scripts/preuninstall.js.map +1 -0
  927. package/dist/spec-store/index.d.ts +9 -0
  928. package/dist/spec-store/index.d.ts.map +1 -0
  929. package/dist/spec-store/index.js +9 -0
  930. package/dist/spec-store/index.js.map +1 -0
  931. package/dist/spec-store/spec-identity.d.ts +28 -0
  932. package/dist/spec-store/spec-identity.d.ts.map +1 -0
  933. package/dist/spec-store/spec-identity.js +24 -0
  934. package/dist/spec-store/spec-identity.js.map +1 -0
  935. package/dist/spec-store/spec-store.d.ts +62 -0
  936. package/dist/spec-store/spec-store.d.ts.map +1 -0
  937. package/dist/spec-store/spec-store.js +201 -0
  938. package/dist/spec-store/spec-store.js.map +1 -0
  939. package/dist/utils/atomic-write.d.ts +10 -0
  940. package/dist/utils/atomic-write.d.ts.map +1 -0
  941. package/dist/utils/atomic-write.js +27 -0
  942. package/dist/utils/atomic-write.js.map +1 -0
  943. package/dist/utils/chunk-splitter.d.ts +32 -0
  944. package/dist/utils/chunk-splitter.d.ts.map +1 -0
  945. package/dist/utils/chunk-splitter.js +116 -0
  946. package/dist/utils/chunk-splitter.js.map +1 -0
  947. package/dist/utils/file-scanner.d.ts +38 -0
  948. package/dist/utils/file-scanner.d.ts.map +1 -0
  949. package/dist/utils/file-scanner.js +323 -0
  950. package/dist/utils/file-scanner.js.map +1 -0
  951. package/dist/utils/git-blame.d.ts +32 -0
  952. package/dist/utils/git-blame.d.ts.map +1 -0
  953. package/dist/utils/git-blame.js +151 -0
  954. package/dist/utils/git-blame.js.map +1 -0
  955. package/dist/utils/specify-template-sync.d.ts +16 -0
  956. package/dist/utils/specify-template-sync.d.ts.map +1 -0
  957. package/dist/utils/specify-template-sync.js +66 -0
  958. package/dist/utils/specify-template-sync.js.map +1 -0
  959. package/dist/watcher/file-watcher.d.ts +77 -0
  960. package/dist/watcher/file-watcher.d.ts.map +1 -0
  961. package/dist/watcher/file-watcher.js +233 -0
  962. package/dist/watcher/file-watcher.js.map +1 -0
  963. package/dist/watcher/index.d.ts +6 -0
  964. package/dist/watcher/index.d.ts.map +1 -0
  965. package/dist/watcher/index.js +5 -0
  966. package/dist/watcher/index.js.map +1 -0
  967. package/grammars/manifest.json +28 -0
  968. package/grammars/tree-sitter-go.wasm +0 -0
  969. package/grammars/tree-sitter-java.wasm +0 -0
  970. package/grammars/tree-sitter-javascript.wasm +0 -0
  971. package/grammars/tree-sitter-python.wasm +0 -0
  972. package/grammars/tree-sitter-typescript.wasm +0 -0
  973. package/package.json +84 -0
  974. package/plugins/spec-driver/.claude-plugin/plugin.json +16 -0
  975. package/plugins/spec-driver/README.md +401 -0
  976. package/plugins/spec-driver/agents/analyze.artifact.yaml +10 -0
  977. package/plugins/spec-driver/agents/analyze.md +144 -0
  978. package/plugins/spec-driver/agents/checklist.artifact.yaml +8 -0
  979. package/plugins/spec-driver/agents/checklist.md +84 -0
  980. package/plugins/spec-driver/agents/clarify.artifact.yaml +6 -0
  981. package/plugins/spec-driver/agents/clarify.md +104 -0
  982. package/plugins/spec-driver/agents/constitution.artifact.yaml +9 -0
  983. package/plugins/spec-driver/agents/constitution.md +100 -0
  984. package/plugins/spec-driver/agents/implement.artifact.yaml +8 -0
  985. package/plugins/spec-driver/agents/implement.md +159 -0
  986. package/plugins/spec-driver/agents/plan.artifact.yaml +12 -0
  987. package/plugins/spec-driver/agents/plan.md +116 -0
  988. package/plugins/spec-driver/agents/product-research.artifact.yaml +11 -0
  989. package/plugins/spec-driver/agents/product-research.md +94 -0
  990. package/plugins/spec-driver/agents/quality-review.artifact.yaml +11 -0
  991. package/plugins/spec-driver/agents/quality-review.md +165 -0
  992. package/plugins/spec-driver/agents/refactor-plan.md +132 -0
  993. package/plugins/spec-driver/agents/spec-review.artifact.yaml +12 -0
  994. package/plugins/spec-driver/agents/spec-review.md +111 -0
  995. package/plugins/spec-driver/agents/specify.artifact.yaml +9 -0
  996. package/plugins/spec-driver/agents/specify.md +109 -0
  997. package/plugins/spec-driver/agents/sync.artifact.yaml +19 -0
  998. package/plugins/spec-driver/agents/sync.md +91 -0
  999. package/plugins/spec-driver/agents/tasks.artifact.yaml +10 -0
  1000. package/plugins/spec-driver/agents/tasks.md +88 -0
  1001. package/plugins/spec-driver/agents/tech-research.artifact.yaml +12 -0
  1002. package/plugins/spec-driver/agents/tech-research.md +102 -0
  1003. package/plugins/spec-driver/agents/verify.artifact.yaml +11 -0
  1004. package/plugins/spec-driver/agents/verify.md +204 -0
  1005. package/plugins/spec-driver/config/orchestration.yaml +779 -0
  1006. package/plugins/spec-driver/contracts/orchestration-overrides-contract.yaml +124 -0
  1007. package/plugins/spec-driver/contracts/orchestration-schema.mjs +301 -0
  1008. package/plugins/spec-driver/contracts/scan-project-output.md +70 -0
  1009. package/plugins/spec-driver/contracts/wrapper-source-of-truth.yaml +44 -0
  1010. package/plugins/spec-driver/hooks/hooks.json +70 -0
  1011. package/plugins/spec-driver/hooks/post-tool-use-format.sh +28 -0
  1012. package/plugins/spec-driver/hooks/pre-tool-use-guard.sh +42 -0
  1013. package/plugins/spec-driver/hooks/stop-task-check.sh +22 -0
  1014. package/plugins/spec-driver/hooks/worktree-lifecycle.sh +33 -0
  1015. package/plugins/spec-driver/lib/orchestration-output-serializer.mjs +219 -0
  1016. package/plugins/spec-driver/lib/orchestration-resolver.mjs +485 -0
  1017. package/plugins/spec-driver/lib/orchestrator-fallback.mjs +98 -0
  1018. package/plugins/spec-driver/lib/orchestrator.mjs +280 -0
  1019. package/plugins/spec-driver/scorecards/default-governance.yaml +63 -0
  1020. package/plugins/spec-driver/scripts/codex-skills.sh +225 -0
  1021. package/plugins/spec-driver/scripts/experimental/README.md +9 -0
  1022. package/plugins/spec-driver/scripts/generate-adoption-insights.mjs +523 -0
  1023. package/plugins/spec-driver/scripts/generate-product-entity-catalog.mjs +472 -0
  1024. package/plugins/spec-driver/scripts/generate-product-quality-reports.mjs +18 -0
  1025. package/plugins/spec-driver/scripts/generate-product-scorecards.mjs +25 -0
  1026. package/plugins/spec-driver/scripts/generate-project-context-suggestions.mjs +622 -0
  1027. package/plugins/spec-driver/scripts/generate-workflow-registry.mjs +16 -0
  1028. package/plugins/spec-driver/scripts/init-project.sh +328 -0
  1029. package/plugins/spec-driver/scripts/lib/config-schema.mjs +433 -0
  1030. package/plugins/spec-driver/scripts/lib/init-project-output.sh +146 -0
  1031. package/plugins/spec-driver/scripts/lib/product-artifact-patchers.mjs +29 -0
  1032. package/plugins/spec-driver/scripts/lib/product-artifact-paths.mjs +129 -0
  1033. package/plugins/spec-driver/scripts/lib/product-governance-helpers.mjs +48 -0
  1034. package/plugins/spec-driver/scripts/lib/product-quality-core.mjs +531 -0
  1035. package/plugins/spec-driver/scripts/lib/product-scorecard-core.mjs +810 -0
  1036. package/plugins/spec-driver/scripts/lib/project-context-paths.mjs +21 -0
  1037. package/plugins/spec-driver/scripts/lib/project-profile-resolver.mjs +704 -0
  1038. package/plugins/spec-driver/scripts/lib/project-profile-schema.mjs +78 -0
  1039. package/plugins/spec-driver/scripts/lib/script-cli-args.mjs +25 -0
  1040. package/plugins/spec-driver/scripts/lib/script-diagnostics.mjs +29 -0
  1041. package/plugins/spec-driver/scripts/lib/script-report-io.mjs +37 -0
  1042. package/plugins/spec-driver/scripts/lib/simple-yaml.mjs +257 -0
  1043. package/plugins/spec-driver/scripts/lib/sync-conflict-resolver.mjs +128 -0
  1044. package/plugins/spec-driver/scripts/lib/sync-merge-strategy.mjs +388 -0
  1045. package/plugins/spec-driver/scripts/lib/sync-product-mapping.mjs +228 -0
  1046. package/plugins/spec-driver/scripts/lib/sync-timeline-builder.mjs +114 -0
  1047. package/plugins/spec-driver/scripts/lib/sync-validator.mjs +174 -0
  1048. package/plugins/spec-driver/scripts/lib/workflow-registry-core.mjs +281 -0
  1049. package/plugins/spec-driver/scripts/orchestrator-cli.mjs +490 -0
  1050. package/plugins/spec-driver/scripts/orchestrator-cli.sh +36 -0
  1051. package/plugins/spec-driver/scripts/postinstall.sh +101 -0
  1052. package/plugins/spec-driver/scripts/record-workflow-run.mjs +332 -0
  1053. package/plugins/spec-driver/scripts/resolve-project-context.mjs +56 -0
  1054. package/plugins/spec-driver/scripts/scan-project.sh +668 -0
  1055. package/plugins/spec-driver/scripts/sync-merge-engine.mjs +663 -0
  1056. package/plugins/spec-driver/scripts/validate-config.mjs +223 -0
  1057. package/plugins/spec-driver/scripts/validate-orchestration-overrides.mjs +190 -0
  1058. package/plugins/spec-driver/scripts/validate-wrapper-sources.mjs +302 -0
  1059. package/plugins/spec-driver/skills/spec-driver-constitution/SKILL.md +77 -0
  1060. package/plugins/spec-driver/skills/spec-driver-doc/SKILL.md +732 -0
  1061. package/plugins/spec-driver/skills/spec-driver-feature/SKILL.md +336 -0
  1062. package/plugins/spec-driver/skills/spec-driver-fix/SKILL.md +457 -0
  1063. package/plugins/spec-driver/skills/spec-driver-implement/SKILL.md +653 -0
  1064. package/plugins/spec-driver/skills/spec-driver-refactor/SKILL.md +250 -0
  1065. package/plugins/spec-driver/skills/spec-driver-resume/SKILL.md +325 -0
  1066. package/plugins/spec-driver/skills/spec-driver-story/SKILL.md +566 -0
  1067. package/plugins/spec-driver/skills/spec-driver-sync/SKILL.md +300 -0
  1068. package/plugins/spec-driver/templates/code-of-conduct-v2.1.md +85 -0
  1069. package/plugins/spec-driver/templates/licenses/Apache-2.0.txt +201 -0
  1070. package/plugins/spec-driver/templates/licenses/BSD-2-Clause.txt +24 -0
  1071. package/plugins/spec-driver/templates/licenses/BSD-3-Clause.txt +28 -0
  1072. package/plugins/spec-driver/templates/licenses/GPL-3.0.txt +232 -0
  1073. package/plugins/spec-driver/templates/licenses/ISC.txt +15 -0
  1074. package/plugins/spec-driver/templates/licenses/MIT.txt +21 -0
  1075. package/plugins/spec-driver/templates/licenses/MPL-2.0.txt +373 -0
  1076. package/plugins/spec-driver/templates/licenses/Unlicense.txt +24 -0
  1077. package/plugins/spec-driver/templates/orchestration-overrides.example.yaml +81 -0
  1078. package/plugins/spec-driver/templates/product-research-template.md +95 -0
  1079. package/plugins/spec-driver/templates/product-spec-template.md +250 -0
  1080. package/plugins/spec-driver/templates/research-synthesis-template.md +102 -0
  1081. package/plugins/spec-driver/templates/spec-driver.config-template.yaml +244 -0
  1082. package/plugins/spec-driver/templates/specify-base/agent-file-template.md +28 -0
  1083. package/plugins/spec-driver/templates/specify-base/checklist-template.md +40 -0
  1084. package/plugins/spec-driver/templates/specify-base/constitution-template.md +50 -0
  1085. package/plugins/spec-driver/templates/specify-base/plan-template.md +134 -0
  1086. package/plugins/spec-driver/templates/specify-base/product-research-template.md +95 -0
  1087. package/plugins/spec-driver/templates/specify-base/project-context-template.yaml +40 -0
  1088. package/plugins/spec-driver/templates/specify-base/research-synthesis-template.md +102 -0
  1089. package/plugins/spec-driver/templates/specify-base/spec-template.md +115 -0
  1090. package/plugins/spec-driver/templates/specify-base/tasks-template.md +266 -0
  1091. package/plugins/spec-driver/templates/specify-base/tech-research-template.md +111 -0
  1092. package/plugins/spec-driver/templates/specify-base/verification-report-template.md +63 -0
  1093. package/plugins/spec-driver/templates/tech-research-template.md +111 -0
  1094. package/plugins/spec-driver/templates/verification-report-template.md +63 -0
  1095. package/plugins/spec-driver/workflows/golden-paths.yaml +39 -0
  1096. package/plugins/spec-driver/workflows/spec-driver-doc.yaml +24 -0
  1097. package/plugins/spec-driver/workflows/spec-driver-feature.yaml +29 -0
  1098. package/plugins/spec-driver/workflows/spec-driver-fix.yaml +21 -0
  1099. package/plugins/spec-driver/workflows/spec-driver-implement.yaml +23 -0
  1100. package/plugins/spec-driver/workflows/spec-driver-resume.yaml +20 -0
  1101. package/plugins/spec-driver/workflows/spec-driver-story.yaml +24 -0
  1102. package/plugins/spec-driver/workflows/spec-driver-sync.yaml +34 -0
  1103. package/plugins/spectra/.claude-plugin/plugin.json +20 -0
  1104. package/plugins/spectra/.mcp.json +8 -0
  1105. package/plugins/spectra/README.md +128 -0
  1106. package/plugins/spectra/contracts/skill-source-of-truth.yaml +34 -0
  1107. package/plugins/spectra/hooks/hooks.json +15 -0
  1108. package/plugins/spectra/scripts/postinstall.sh +12 -0
  1109. package/plugins/spectra/scripts/sync-skill-mirrors.mjs +148 -0
  1110. package/plugins/spectra/scripts/validate-skill-sources.mjs +280 -0
  1111. package/plugins/spectra/skills/spectra/SKILL.md +214 -0
  1112. package/plugins/spectra/skills/spectra-batch/SKILL.md +232 -0
  1113. package/plugins/spectra/skills/spectra-diff/SKILL.md +99 -0
  1114. package/queries/go.scm +54 -0
  1115. package/queries/java.scm +50 -0
  1116. package/queries/javascript.scm +30 -0
  1117. package/queries/python.scm +35 -0
  1118. package/queries/typescript.scm +50 -0
  1119. package/scripts/lifecycle-runner.cjs +33 -0
  1120. package/templates/adr-draft.hbs +51 -0
  1121. package/templates/adr-index.hbs +25 -0
  1122. package/templates/api-surface.hbs +40 -0
  1123. package/templates/architecture-ir.hbs +49 -0
  1124. package/templates/architecture-narrative.hbs +116 -0
  1125. package/templates/architecture-overview.hbs +103 -0
  1126. package/templates/component-view.hbs +87 -0
  1127. package/templates/config-reference.hbs +22 -0
  1128. package/templates/coverage-report.hbs +84 -0
  1129. package/templates/cross-package-analysis.hbs +43 -0
  1130. package/templates/data-model.hbs +72 -0
  1131. package/templates/delta-report.hbs +53 -0
  1132. package/templates/docs-bundle-index.hbs +41 -0
  1133. package/templates/drift-report.hbs +53 -0
  1134. package/templates/dynamic-scenarios.hbs +46 -0
  1135. package/templates/event-surface.hbs +90 -0
  1136. package/templates/feature-brief-index.hbs +27 -0
  1137. package/templates/feature-brief.hbs +28 -0
  1138. package/templates/index-spec.hbs +57 -0
  1139. package/templates/interface-surface.hbs +87 -0
  1140. package/templates/module-spec.hbs +117 -0
  1141. package/templates/pattern-hints.hbs +85 -0
  1142. package/templates/product-overview.hbs +65 -0
  1143. package/templates/quality-report.hbs +130 -0
  1144. package/templates/runtime-topology.hbs +128 -0
  1145. package/templates/troubleshooting.hbs +86 -0
  1146. package/templates/user-journeys.hbs +44 -0
  1147. package/templates/workspace-index.hbs +26 -0
@@ -0,0 +1,201 @@
1
+ /**
2
+ * ConfigReferenceGenerator — 配置参考手册生成器
3
+ * 从 YAML/TOML/.env 配置文件生成配置参考手册。
4
+ * 实现 DocumentGenerator<ConfigReferenceInput, ConfigReferenceOutput> 接口。
5
+ *
6
+ * 解析逻辑已委托给 ArtifactParserRegistry 中注册的配置 Parser:
7
+ * - YamlConfigParser(id: yaml-config)
8
+ * - EnvConfigParser(id: env-config)
9
+ * - TomlConfigParser(id: toml-config)
10
+ */
11
+ import * as fs from 'node:fs';
12
+ import * as path from 'node:path';
13
+ import { ArtifactParserRegistry } from '../parser-registry.js';
14
+ import { loadTemplate } from '../utils/template-loader.js';
15
+ import { enrichConfigDescriptions } from '../utils/llm-enricher.js';
16
+ import { createLogger } from '../utils/logger.js';
17
+ const logger = createLogger('config-reference-generator');
18
+ // ============================================================
19
+ // 配置文件扩展名匹配
20
+ // ============================================================
21
+ /** YAML 文件扩展名 */
22
+ const YAML_EXTENSIONS = ['.yaml', '.yml'];
23
+ /** TOML 文件扩展名 */
24
+ const TOML_EXTENSIONS = ['.toml'];
25
+ /** .env 文件名匹配模式 */
26
+ const ENV_PATTERN = /^\.env(\..*)?$/;
27
+ /** 排除的目录名 */
28
+ const EXCLUDED_DIRS = new Set([
29
+ 'node_modules', '.git', 'dist', 'build', 'coverage',
30
+ '.next', '.nuxt', '__pycache__', '.venv', 'venv',
31
+ ]);
32
+ // ============================================================
33
+ // 辅助函数
34
+ // ============================================================
35
+ /**
36
+ * 判断文件是否为配置文件(YAML/TOML/.env)
37
+ */
38
+ function isConfigFile(fileName) {
39
+ const ext = path.extname(fileName).toLowerCase();
40
+ if (YAML_EXTENSIONS.includes(ext))
41
+ return 'yaml';
42
+ if (TOML_EXTENSIONS.includes(ext))
43
+ return 'toml';
44
+ if (ENV_PATTERN.test(fileName))
45
+ return 'env';
46
+ return null;
47
+ }
48
+ // ============================================================
49
+ // ConfigReferenceGenerator 实现
50
+ // ============================================================
51
+ /**
52
+ * 配置参考手册生成器
53
+ * 实现 DocumentGenerator<ConfigReferenceInput, ConfigReferenceOutput> 接口。
54
+ * 从项目中发现并解析 YAML/TOML/.env 配置文件,生成结构化的配置参考手册。
55
+ */
56
+ export class ConfigReferenceGenerator {
57
+ id = 'config-reference';
58
+ name = '配置参考手册生成器';
59
+ description = '从 YAML/TOML/.env 配置文件生成配置参考手册,包含每个配置项的名称、类型、默认值、说明';
60
+ /**
61
+ * 判断当前项目是否包含支持的配置文件
62
+ */
63
+ isApplicable(context) {
64
+ // 检查 configFiles 中是否有匹配的文件
65
+ for (const fileName of context.configFiles.keys()) {
66
+ if (isConfigFile(fileName) !== null) {
67
+ return true;
68
+ }
69
+ }
70
+ // 扫描项目根目录
71
+ try {
72
+ const entries = fs.readdirSync(context.projectRoot, { withFileTypes: true });
73
+ for (const entry of entries) {
74
+ if (entry.isFile() && isConfigFile(entry.name) !== null) {
75
+ return true;
76
+ }
77
+ }
78
+ }
79
+ catch (err) {
80
+ logger.debug(`根目录扫描失败,isApplicable 降级为 false: ${context.projectRoot} — ${String(err)}`);
81
+ }
82
+ return false;
83
+ }
84
+ /**
85
+ * 从项目中提取配置文件信息
86
+ */
87
+ async extract(context) {
88
+ const files = await this.discoverAndParseConfigFiles(context.projectRoot);
89
+ // 尝试从 package.json 获取项目名称
90
+ let projectName = path.basename(context.projectRoot);
91
+ const pkgJsonPath = path.join(context.projectRoot, 'package.json');
92
+ try {
93
+ if (fs.existsSync(pkgJsonPath)) {
94
+ const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
95
+ if (typeof pkg.name === 'string') {
96
+ projectName = pkg.name;
97
+ }
98
+ }
99
+ }
100
+ catch (err) {
101
+ logger.debug(`package.json 解析失败,使用默认项目名称: ${String(err)}`);
102
+ }
103
+ return { files, projectName };
104
+ }
105
+ /**
106
+ * 将提取的数据转换为结构化的文档输出
107
+ */
108
+ async generate(input, options) {
109
+ // 按文件路径排序
110
+ let sortedFiles = [...input.files].sort((a, b) => a.filePath.localeCompare(b.filePath));
111
+ // LLM 语义增强(仅在 useLLM=true 时启用)
112
+ if (options?.useLLM) {
113
+ sortedFiles = await enrichConfigDescriptions(sortedFiles);
114
+ }
115
+ const totalEntries = sortedFiles.reduce((sum, f) => sum + f.entries.length, 0);
116
+ return {
117
+ title: `配置参考手册: ${input.projectName}`,
118
+ projectName: input.projectName,
119
+ generatedAt: new Date().toISOString().split('T')[0],
120
+ files: sortedFiles,
121
+ totalEntries,
122
+ };
123
+ }
124
+ /**
125
+ * 使用 Handlebars 模板渲染为 Markdown
126
+ */
127
+ render(output) {
128
+ const template = loadTemplate('config-reference.hbs', import.meta.url);
129
+ return template(output);
130
+ }
131
+ // ============================================================
132
+ // 私有方法
133
+ // ============================================================
134
+ /**
135
+ * 发现并解析项目中的所有配置文件
136
+ * 扫描项目根目录和一级子目录,通过 ArtifactParserRegistry 获取 Parser 进行解析
137
+ */
138
+ async discoverAndParseConfigFiles(projectRoot) {
139
+ const results = [];
140
+ const discovered = new Set();
141
+ // 扫描根目录
142
+ this.scanDirectory(projectRoot, projectRoot, discovered);
143
+ // 扫描一级子目录
144
+ try {
145
+ const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
146
+ for (const entry of entries) {
147
+ if (entry.isDirectory() && !EXCLUDED_DIRS.has(entry.name) && !entry.name.startsWith('.')) {
148
+ const subDir = path.join(projectRoot, entry.name);
149
+ this.scanDirectory(subDir, projectRoot, discovered);
150
+ }
151
+ }
152
+ }
153
+ catch (err) {
154
+ logger.debug(`一级子目录扫描失败,已跳过: ${projectRoot} — ${String(err)}`);
155
+ }
156
+ const parserRegistry = ArtifactParserRegistry.getInstance();
157
+ // 解析每个发现的文件
158
+ for (const filePath of discovered) {
159
+ const relativePath = path.relative(projectRoot, filePath);
160
+ const fileName = path.basename(filePath);
161
+ const format = isConfigFile(fileName);
162
+ if (!format)
163
+ continue;
164
+ try {
165
+ // 通过 ParserRegistry 获取适用的 Parser
166
+ const matchedParsers = parserRegistry.getByFilePattern(filePath);
167
+ if (matchedParsers.length > 0) {
168
+ // 使用第一个匹配的 Parser 进行解析
169
+ const parseResult = await matchedParsers[0].parse(filePath);
170
+ results.push({ filePath: relativePath, format, entries: parseResult.entries });
171
+ }
172
+ else {
173
+ // 无匹配 Parser 时返回空 entries
174
+ results.push({ filePath: relativePath, format, entries: [] });
175
+ }
176
+ }
177
+ catch (err) {
178
+ logger.debug(`配置文件解析失败,使用空 entries: ${relativePath} — ${String(err)}`);
179
+ results.push({ filePath: relativePath, format, entries: [] });
180
+ }
181
+ }
182
+ return results;
183
+ }
184
+ /**
185
+ * 扫描目录查找配置文件
186
+ */
187
+ scanDirectory(dir, _projectRoot, discovered) {
188
+ try {
189
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
190
+ for (const entry of entries) {
191
+ if (entry.isFile() && isConfigFile(entry.name) !== null) {
192
+ discovered.add(path.join(dir, entry.name));
193
+ }
194
+ }
195
+ }
196
+ catch (err) {
197
+ logger.debug(`目录不可读,静默跳过: ${dir} — ${String(err)}`);
198
+ }
199
+ }
200
+ }
201
+ //# sourceMappingURL=config-reference-generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-reference-generator.js","sourceRoot":"","sources":["../../../src/panoramic/generators/config-reference-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,4BAA4B,CAAC,CAAC;AAoD1D,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAE/D,iBAAiB;AACjB,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAE1C,iBAAiB;AACjB,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,CAAC;AAElC,mBAAmB;AACnB,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC,aAAa;AACb,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IACnD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CACjD,CAAC,CAAC;AAEH,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAG1B,EAAE,GAAG,kBAA2B,CAAC;IACjC,IAAI,GAAG,WAAoB,CAAC;IAC5B,WAAW,GAAG,oDAAoD,CAAC;IAE5E;;OAEG;IACH,YAAY,CAAC,OAAuB;QAClC,2BAA2B;QAC3B,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAClD,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,UAAU;QACV,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACxD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,CAAC,WAAW,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE1E,0BAA0B;QAC1B,IAAI,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9D,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACjC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,KAA2B,EAC3B,OAAyB;QAEzB,UAAU;QACV,IAAI,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CACrC,CAAC;QAEF,+BAA+B;QAC/B,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,WAAW,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CACrC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAClC,CAAC,CACF,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,WAAW,KAAK,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE;YACpD,KAAK,EAAE,WAAW;YAClB,YAAY;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAA6B;QAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,+DAA+D;IAC/D,OAAO;IACP,+DAA+D;IAE/D;;;OAGG;IACK,KAAK,CAAC,2BAA2B,CACvC,WAAmB;QAEnB,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QAErC,QAAQ;QACR,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAEzD,UAAU;QACV,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClD,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,kBAAkB,WAAW,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,cAAc,GAAG,sBAAsB,CAAC,WAAW,EAAE,CAAC;QAE5D,YAAY;QACZ,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,IAAI,CAAC;gBACH,iCAAiC;gBACjC,MAAM,cAAc,GAAG,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAEjE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,uBAAuB;oBACvB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,QAAQ,CAAkB,CAAC;oBAC9E,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjF,CAAC;qBAAM,CAAC;oBACN,0BAA0B;oBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,yBAAyB,YAAY,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,GAAW,EACX,YAAoB,EACpB,UAAuB;QAEvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACxD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CAEF"}
@@ -0,0 +1,112 @@
1
+ import type { DocumentGenerator, ProjectContext, GenerateOptions } from '../interfaces.js';
2
+ import type { WorkspacePackageInfo } from './workspace-index-generator.js';
3
+ import type { DependencyGraph } from '../../models/dependency-graph.js';
4
+ /**
5
+ * CrossPackageAnalyzer extract() 产出
6
+ * 包含项目元信息、子包列表和构建好的包级 DependencyGraph
7
+ */
8
+ export interface CrossPackageInput {
9
+ /** 项目名称 */
10
+ projectName: string;
11
+ /** workspace 管理器类型 */
12
+ workspaceType: 'npm' | 'pnpm' | 'uv';
13
+ /** 所有子包元信息列表(复用 WorkspacePackageInfo) */
14
+ packages: WorkspacePackageInfo[];
15
+ /** 包级依赖关系图(复用现有 DependencyGraph 类型) */
16
+ graph: DependencyGraph;
17
+ }
18
+ /**
19
+ * CrossPackageAnalyzer generate() 产出
20
+ * 包含渲染 Markdown 文档所需的全部结构化数据
21
+ */
22
+ export interface CrossPackageOutput {
23
+ /** 文档标题 */
24
+ title: string;
25
+ /** 生成日期(YYYY-MM-DD) */
26
+ generatedAt: string;
27
+ /** 项目名称 */
28
+ projectName: string;
29
+ /** workspace 管理器类型 */
30
+ workspaceType: 'npm' | 'pnpm' | 'uv';
31
+ /** Mermaid graph TD 依赖拓扑图源代码(含循环标注) */
32
+ mermaidDiagram: string;
33
+ /** 拓扑排序结果(按 level 分组) */
34
+ levels: TopologyLevel[];
35
+ /** 拓扑排序线性顺序(叶子优先) */
36
+ topologicalOrder: string[];
37
+ /** 是否存在循环依赖 */
38
+ hasCycles: boolean;
39
+ /** 循环依赖组列表(每组为参与循环的包名数组) */
40
+ cycleGroups: CycleGroup[];
41
+ /** 统计摘要 */
42
+ stats: DependencyStats;
43
+ }
44
+ /**
45
+ * 拓扑排序层级
46
+ */
47
+ export interface TopologyLevel {
48
+ /** 层级编号(0 为最底层,无出度) */
49
+ level: number;
50
+ /** 该层级的子包名列表 */
51
+ packages: string[];
52
+ }
53
+ /**
54
+ * 循环依赖组
55
+ */
56
+ export interface CycleGroup {
57
+ /** 参与循环的子包名列表 */
58
+ packages: string[];
59
+ /** 循环路径的人类可读表示(如 "A -> B -> C -> A") */
60
+ cyclePath: string;
61
+ }
62
+ /**
63
+ * 依赖统计摘要
64
+ */
65
+ export interface DependencyStats {
66
+ /** 子包总数 */
67
+ totalPackages: number;
68
+ /** 总依赖边数(不含自依赖和无效依赖) */
69
+ totalEdges: number;
70
+ /** Root 包列表(入度为 0,不被任何包依赖) */
71
+ rootPackages: string[];
72
+ /** Leaf 包列表(出度为 0,不依赖任何包) */
73
+ leafPackages: string[];
74
+ }
75
+ /**
76
+ * 跨包依赖分析器
77
+ * 实现 DocumentGenerator<CrossPackageInput, CrossPackageOutput> 接口。
78
+ * 从 Monorepo 项目中分析子包间的依赖关系,检测循环依赖,
79
+ * 生成带循环标注的 Mermaid 依赖拓扑图和统计信息。
80
+ */
81
+ export declare class CrossPackageAnalyzer implements DocumentGenerator<CrossPackageInput, CrossPackageOutput> {
82
+ readonly id: "cross-package-deps";
83
+ readonly name: "\u8DE8\u5305\u4F9D\u8D56\u5206\u6790\u5668";
84
+ readonly description = "\u5206\u6790 Monorepo \u5B50\u5305\u95F4\u7684\u4F9D\u8D56\u5173\u7CFB\uFF0C\u68C0\u6D4B\u5FAA\u73AF\u4F9D\u8D56\u5E76\u751F\u6210\u62D3\u6251\u56FE";
85
+ /**
86
+ * 判断当前项目是否适用此 Generator(T014)
87
+ * 仅当 workspaceType === 'monorepo' 时返回 true
88
+ */
89
+ isApplicable(context: ProjectContext): boolean;
90
+ /**
91
+ * 从项目中提取 workspace 信息并构建包级依赖图(T015)
92
+ *
93
+ * 1. 复用 WorkspaceIndexGenerator.extract() 获取子包列表
94
+ * 2. 将 WorkspacePackageInfo[] 转换为 DependencyGraph
95
+ */
96
+ extract(context: ProjectContext): Promise<CrossPackageInput>;
97
+ /**
98
+ * 将提取的数据转换为结构化文档输出(T016-T017)
99
+ *
100
+ * 1. 调用 detectSCCs 检测循环依赖
101
+ * 2. 调用 topologicalSort 计算拓扑排序
102
+ * 3. 构建循环标注 Mermaid 图
103
+ * 4. 计算统计信息
104
+ * 5. 按 level 分组拓扑排序结果
105
+ */
106
+ generate(input: CrossPackageInput, _options?: GenerateOptions): Promise<CrossPackageOutput>;
107
+ /**
108
+ * 使用 Handlebars 模板渲染为 Markdown(T018)
109
+ */
110
+ render(output: CrossPackageOutput): string;
111
+ }
112
+ //# sourceMappingURL=cross-package-analyzer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-package-analyzer.d.ts","sourceRoot":"","sources":["../../../src/panoramic/generators/cross-package-analyzer.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,kCAAkC,CAAC;AASnG;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAErC,yCAAyC;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAEjC,uCAAuC;IACvC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAErC,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IAEvB,yBAAyB;IACzB,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,eAAe;IACf,SAAS,EAAE,OAAO,CAAC;IAEnB,4BAA4B;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,WAAW;IACX,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA8ED;;;;;GAKG;AACH,qBAAa,oBACX,YAAW,iBAAiB,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAEnE,QAAQ,CAAC,EAAE,EAAG,oBAAoB,CAAU;IAC5C,QAAQ,CAAC,IAAI,EAAG,4CAAS,CAAU;IACnC,QAAQ,CAAC,WAAW,0JAAuC;IAE3D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI9C;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0ElE;;;;;;;;OAQG;IACG,QAAQ,CACZ,KAAK,EAAE,iBAAiB,EACxB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAkG9B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;CAI3C"}
@@ -0,0 +1,258 @@
1
+ import { extractWorkspaceData } from './workspace-index-generator.js';
2
+ import { detectSCCs, topologicalSort } from '../../graph/topological-sort.js';
3
+ import { sanitizeMermaidId } from '../utils/mermaid-helpers.js';
4
+ import { loadTemplate } from '../utils/template-loader.js';
5
+ // ============================================================
6
+ // 辅助函数
7
+ // ============================================================
8
+ /**
9
+ * 构建带循环标注的 Mermaid graph TD 依赖拓扑图
10
+ *
11
+ * @param graph - 包级依赖关系图
12
+ * @param sccNodeSet - SCC 内部节点集合(size > 1 的 SCC 中的节点)
13
+ * @param sccEdgeSet - SCC 内部边集合("from->to" 格式的字符串集合)
14
+ * @returns Mermaid 源代码字符串
15
+ */
16
+ function buildCrossPackageMermaid(graph, sccNodeSet, sccEdgeSet) {
17
+ const lines = ['graph TD'];
18
+ // 添加所有节点
19
+ for (const node of graph.modules) {
20
+ const nodeId = sanitizeMermaidId(node.source);
21
+ if (sccNodeSet.has(node.source)) {
22
+ // SCC 内部节点添加 cycle 样式类
23
+ lines.push(` ${nodeId}["${node.source}"]:::cycle`);
24
+ }
25
+ else {
26
+ lines.push(` ${nodeId}["${node.source}"]`);
27
+ }
28
+ }
29
+ // 收集边,区分正常边和循环边
30
+ const normalEdges = [];
31
+ const cycleEdges = [];
32
+ const cycleEdgeIndices = [];
33
+ let edgeIndex = 0;
34
+ for (const edge of graph.edges) {
35
+ const sourceId = sanitizeMermaidId(edge.from);
36
+ const targetId = sanitizeMermaidId(edge.to);
37
+ const edgeKey = `${edge.from}->${edge.to}`;
38
+ if (sccEdgeSet.has(edgeKey)) {
39
+ // 循环边:虚线 + cycle 标签
40
+ cycleEdges.push(` ${sourceId} -.->|cycle| ${targetId}`);
41
+ cycleEdgeIndices.push(edgeIndex);
42
+ }
43
+ else {
44
+ // 正常边:实线
45
+ normalEdges.push(` ${sourceId} --> ${targetId}`);
46
+ }
47
+ edgeIndex++;
48
+ }
49
+ if (normalEdges.length === 0 && cycleEdges.length === 0) {
50
+ lines.push(' %% 无内部依赖');
51
+ }
52
+ else {
53
+ lines.push(...normalEdges);
54
+ lines.push(...cycleEdges);
55
+ }
56
+ // 添加 classDef 样式定义
57
+ if (sccNodeSet.size > 0) {
58
+ lines.push(' classDef cycle fill:#ffcccc,stroke:red,stroke-width:2px');
59
+ }
60
+ // 添加 linkStyle 指令为循环边设置红色
61
+ for (const idx of cycleEdgeIndices) {
62
+ lines.push(` linkStyle ${idx} stroke:red,stroke-width:2px`);
63
+ }
64
+ return lines.join('\n');
65
+ }
66
+ // ============================================================
67
+ // CrossPackageAnalyzer 实现
68
+ // ============================================================
69
+ /**
70
+ * 跨包依赖分析器
71
+ * 实现 DocumentGenerator<CrossPackageInput, CrossPackageOutput> 接口。
72
+ * 从 Monorepo 项目中分析子包间的依赖关系,检测循环依赖,
73
+ * 生成带循环标注的 Mermaid 依赖拓扑图和统计信息。
74
+ */
75
+ export class CrossPackageAnalyzer {
76
+ id = 'cross-package-deps';
77
+ name = '跨包依赖分析器';
78
+ description = '分析 Monorepo 子包间的依赖关系,检测循环依赖并生成拓扑图';
79
+ /**
80
+ * 判断当前项目是否适用此 Generator(T014)
81
+ * 仅当 workspaceType === 'monorepo' 时返回 true
82
+ */
83
+ isApplicable(context) {
84
+ return context.workspaceType === 'monorepo';
85
+ }
86
+ /**
87
+ * 从项目中提取 workspace 信息并构建包级依赖图(T015)
88
+ *
89
+ * 1. 复用 WorkspaceIndexGenerator.extract() 获取子包列表
90
+ * 2. 将 WorkspacePackageInfo[] 转换为 DependencyGraph
91
+ */
92
+ async extract(context) {
93
+ // 复用独立函数获取子包列表(不创建 Generator 实例)
94
+ const workspaceInput = extractWorkspaceData(context);
95
+ const { packages, projectName, workspaceType } = workspaceInput;
96
+ // 收集所有包名到 Set,用于过滤无效依赖
97
+ const packageNameSet = new Set(packages.map((p) => p.name));
98
+ // 构建 GraphNode 列表
99
+ // 先计算每个包的入度
100
+ const inDegreeMap = new Map();
101
+ for (const pkg of packages) {
102
+ inDegreeMap.set(pkg.name, 0);
103
+ }
104
+ for (const pkg of packages) {
105
+ for (const dep of pkg.dependencies) {
106
+ // 过滤自依赖和不存在的依赖
107
+ if (dep === pkg.name || !packageNameSet.has(dep))
108
+ continue;
109
+ inDegreeMap.set(dep, (inDegreeMap.get(dep) ?? 0) + 1);
110
+ }
111
+ }
112
+ const modules = [];
113
+ const edges = [];
114
+ for (const pkg of packages) {
115
+ // 计算有效出度(过滤自依赖和不存在的依赖)
116
+ const validDeps = pkg.dependencies.filter((dep) => dep !== pkg.name && packageNameSet.has(dep));
117
+ const outDegree = validDeps.length;
118
+ const inDegree = inDegreeMap.get(pkg.name) ?? 0;
119
+ modules.push({
120
+ source: pkg.name,
121
+ isOrphan: inDegree === 0 && outDegree === 0,
122
+ inDegree,
123
+ outDegree,
124
+ level: 0, // 由 topologicalSort() 填充
125
+ language: pkg.language,
126
+ });
127
+ // 构建边
128
+ for (const dep of validDeps) {
129
+ edges.push({
130
+ from: pkg.name,
131
+ to: dep,
132
+ isCircular: false, // 初始值,detectSCCs() 后更新
133
+ importType: 'static', // 包级依赖均为静态引用
134
+ });
135
+ }
136
+ }
137
+ const graph = {
138
+ projectRoot: context.projectRoot,
139
+ modules,
140
+ edges,
141
+ topologicalOrder: [],
142
+ sccs: [],
143
+ totalModules: modules.length,
144
+ totalEdges: edges.length,
145
+ analyzedAt: new Date().toISOString(),
146
+ mermaidSource: '',
147
+ };
148
+ return {
149
+ projectName,
150
+ workspaceType,
151
+ packages,
152
+ graph,
153
+ };
154
+ }
155
+ /**
156
+ * 将提取的数据转换为结构化文档输出(T016-T017)
157
+ *
158
+ * 1. 调用 detectSCCs 检测循环依赖
159
+ * 2. 调用 topologicalSort 计算拓扑排序
160
+ * 3. 构建循环标注 Mermaid 图
161
+ * 4. 计算统计信息
162
+ * 5. 按 level 分组拓扑排序结果
163
+ */
164
+ async generate(input, _options) {
165
+ const { graph } = input;
166
+ // 1. 检测 SCC
167
+ const sccs = detectSCCs(graph);
168
+ // 2. 拓扑排序
169
+ const topoResult = topologicalSort(graph);
170
+ // 3. 构建 SCC 内部节点和边集合(仅 size > 1 的 SCC)
171
+ const sccNodeSet = new Set();
172
+ const sccEdgeSet = new Set();
173
+ const cycleGroups = [];
174
+ for (const scc of sccs) {
175
+ if (scc.modules.length > 1) {
176
+ const sccModuleSet = new Set(scc.modules);
177
+ for (const mod of scc.modules) {
178
+ sccNodeSet.add(mod);
179
+ }
180
+ // 标记 SCC 内部边
181
+ for (const edge of graph.edges) {
182
+ if (sccModuleSet.has(edge.from) && sccModuleSet.has(edge.to)) {
183
+ sccEdgeSet.add(`${edge.from}->${edge.to}`);
184
+ edge.isCircular = true;
185
+ }
186
+ }
187
+ // 构建人类可读的循环路径
188
+ const cyclePath = [...scc.modules, scc.modules[0]].join(' -> ');
189
+ cycleGroups.push({
190
+ packages: [...scc.modules],
191
+ cyclePath,
192
+ });
193
+ }
194
+ }
195
+ // 4. 生成 Mermaid 图
196
+ const mermaidDiagram = buildCrossPackageMermaid(graph, sccNodeSet, sccEdgeSet);
197
+ // 5. 计算统计信息
198
+ const rootPackages = [];
199
+ const leafPackages = [];
200
+ for (const node of graph.modules) {
201
+ if (node.inDegree === 0)
202
+ rootPackages.push(node.source);
203
+ if (node.outDegree === 0)
204
+ leafPackages.push(node.source);
205
+ }
206
+ const stats = {
207
+ totalPackages: graph.modules.length,
208
+ totalEdges: graph.edges.length,
209
+ rootPackages: rootPackages.sort(),
210
+ leafPackages: leafPackages.sort(),
211
+ };
212
+ // 6. 按 level 分组
213
+ const levelMap = new Map();
214
+ for (const [mod, level] of topoResult.levels) {
215
+ if (!levelMap.has(level)) {
216
+ levelMap.set(level, []);
217
+ }
218
+ levelMap.get(level).push(mod);
219
+ }
220
+ // 如果拓扑排序没有覆盖所有节点(如全是孤立节点),补充缺失的
221
+ for (const node of graph.modules) {
222
+ if (!topoResult.levels.has(node.source)) {
223
+ if (!levelMap.has(0)) {
224
+ levelMap.set(0, []);
225
+ }
226
+ levelMap.get(0).push(node.source);
227
+ }
228
+ }
229
+ const levels = [];
230
+ const sortedLevelKeys = [...levelMap.keys()].sort((a, b) => a - b);
231
+ for (const level of sortedLevelKeys) {
232
+ levels.push({
233
+ level,
234
+ packages: levelMap.get(level).sort(),
235
+ });
236
+ }
237
+ return {
238
+ title: `跨包依赖分析: ${input.projectName}`,
239
+ generatedAt: new Date().toISOString().split('T')[0],
240
+ projectName: input.projectName,
241
+ workspaceType: input.workspaceType,
242
+ mermaidDiagram,
243
+ levels,
244
+ topologicalOrder: topoResult.order,
245
+ hasCycles: topoResult.hasCycles,
246
+ cycleGroups,
247
+ stats,
248
+ };
249
+ }
250
+ /**
251
+ * 使用 Handlebars 模板渲染为 Markdown(T018)
252
+ */
253
+ render(output) {
254
+ const template = loadTemplate('cross-package-analysis.hbs', import.meta.url);
255
+ return template(output);
256
+ }
257
+ }
258
+ //# sourceMappingURL=cross-package-analyzer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cross-package-analyzer.js","sourceRoot":"","sources":["../../../src/panoramic/generators/cross-package-analyzer.ts"],"names":[],"mappings":"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"}