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,286 @@
1
+ /**
2
+ * 多模态提取管道(Feature 107 + Feature 140 T21)
3
+ * 协调三路提取器(Markdown、OpenAPI、图像),集成缓存,控制并发
4
+ *
5
+ * 行为契约(extraction-pipeline.contract.md):
6
+ * - includeDocs=false && includeImages=false 时立即返回空 output
7
+ * - 所有提取失败时返回空 output,不抛出异常
8
+ * - 返回的 ExtractionResult[] 已通过 Zod schema 验证
9
+ * - Markdown LLM 并发上限 5,单次超时 8 秒(FR-016)
10
+ * - 图片数量 > 50 输出警告(FR-017)
11
+ *
12
+ * **Feature 140 FR-010 行为变更**:返回类型从 `ExtractionResult[]` 改为 `ExtractionPipelineOutput`
13
+ * 包装对象,新增 `readmeContent?: string` 字段:当 `includeDocs=true` 且 projectRoot 下存在
14
+ * `README.md`(不区分大小写:README.md / readme.md / Readme.md)时,读取其全量内容(不截断)
15
+ * 放入 `readmeContent`,供下游 architecture-narrative / hyperedge 等 pipeline 作为 shared
16
+ * header 注入(架构 §三 ADR shared header / §四 Narrative Phase B)。
17
+ *
18
+ * 与原有 ExtractionResult[] 的关系:README.md 仍会被走 Markdown LLM 提取通道(产生 nodes/edges
19
+ * 进入 results 数组),同时其 raw 内容也独立放入 readmeContent;二者并存不冲突,但下游使用
20
+ * readmeContent 比拼 nodes 更直接(保留原始语境)。
21
+ */
22
+ import * as fs from 'node:fs';
23
+ import * as path from 'node:path';
24
+ import { createLogger } from '../panoramic/utils/logger.js';
25
+ import { ExtractionResultSchema, EMPTY_EXTRACTION_RESULT } from './extraction-types.js';
26
+ import { classifyFile, EXCLUDED_DIR_SEGMENTS } from './artifact-classifier.js';
27
+ import { fileExtractHash, loadExtractCache, saveExtractCache } from './extraction-cache.js';
28
+ import { extractMarkdown } from './markdown-extractor.js';
29
+ import { extractOpenApi } from './openapi-extractor.js';
30
+ import { extractImage } from './image-extractor.js';
31
+ const logger = createLogger('extraction-pipeline');
32
+ // ============================================================
33
+ // 文件扫描(递归)
34
+ // ============================================================
35
+ /**
36
+ * 递归扫描目录,收集符合条件的文件路径
37
+ */
38
+ function scanDirectory(dir) {
39
+ const results = [];
40
+ let entries;
41
+ try {
42
+ entries = fs.readdirSync(dir, { withFileTypes: true });
43
+ }
44
+ catch {
45
+ return results;
46
+ }
47
+ for (const entry of entries) {
48
+ const fullPath = path.join(dir, entry.name);
49
+ if (entry.isDirectory()) {
50
+ // 目录级剪枝:跳过排除目录,避免展开 node_modules 等巨型目录
51
+ if (EXCLUDED_DIR_SEGMENTS.has(entry.name))
52
+ continue;
53
+ results.push(...scanDirectory(fullPath));
54
+ }
55
+ else if (entry.isFile()) {
56
+ results.push(fullPath);
57
+ }
58
+ }
59
+ return results;
60
+ }
61
+ /**
62
+ * 扫描项目根目录,返回按类型分组的文件列表
63
+ */
64
+ function scanProjectFiles(projectRoot, includeDocs, includeImages) {
65
+ const allFiles = scanDirectory(projectRoot);
66
+ const docFiles = [];
67
+ const apiSpecFiles = [];
68
+ const imageFiles = [];
69
+ for (const filePath of allFiles) {
70
+ const kind = classifyFile(filePath);
71
+ if (kind === 'document' && includeDocs) {
72
+ docFiles.push(filePath);
73
+ }
74
+ else if (kind === 'api-spec' && includeDocs) {
75
+ apiSpecFiles.push(filePath);
76
+ }
77
+ else if (kind === 'image' && includeImages) {
78
+ imageFiles.push(filePath);
79
+ }
80
+ }
81
+ return { docFiles, apiSpecFiles, imageFiles };
82
+ }
83
+ // ============================================================
84
+ // 手写并发池(不引入 p-limit)
85
+ // ============================================================
86
+ /**
87
+ * 手写并发池
88
+ * 同时最多 maxConcurrency 个 Promise 在执行
89
+ *
90
+ * @param tasks - 异步任务工厂函数列表
91
+ * @param maxConcurrency - 并发上限
92
+ * @returns 所有任务结果(按完成顺序收集)
93
+ */
94
+ async function concurrentPool(tasks, maxConcurrency) {
95
+ const results = [];
96
+ const executing = new Set();
97
+ for (const taskFn of tasks) {
98
+ const promise = taskFn().then((result) => {
99
+ results.push(result);
100
+ }).catch((err) => {
101
+ // 单个任务失败不影响池子继续,但记录日志保持可观测性
102
+ logger.debug(`并发任务失败: ${String(err)}`);
103
+ });
104
+ const tracked = promise.finally(() => {
105
+ executing.delete(tracked);
106
+ });
107
+ executing.add(tracked);
108
+ if (executing.size >= maxConcurrency) {
109
+ await Promise.race(executing);
110
+ }
111
+ }
112
+ await Promise.all(executing);
113
+ return results;
114
+ }
115
+ // ============================================================
116
+ // 单文件提取(含缓存集成)
117
+ // ============================================================
118
+ /**
119
+ * 从单个文件提取结果,优先走缓存
120
+ */
121
+ async function extractWithCache(filePath, outputDir, projectRoot, kind) {
122
+ // 读取文件内容(用于计算 hash)
123
+ let content;
124
+ if (kind === 'image') {
125
+ // 图像是二进制文件,用 hex 编码计算 hash
126
+ try {
127
+ content = fs.readFileSync(filePath).toString('hex');
128
+ }
129
+ catch {
130
+ content = '';
131
+ }
132
+ }
133
+ else {
134
+ try {
135
+ content = fs.readFileSync(filePath, 'utf-8');
136
+ }
137
+ catch {
138
+ content = '';
139
+ }
140
+ }
141
+ const isMarkdown = kind === 'document';
142
+ const hash = fileExtractHash(filePath, content, isMarkdown);
143
+ // 缓存命中
144
+ const cached = loadExtractCache(hash, outputDir);
145
+ if (cached) {
146
+ logger.debug(`缓存命中,跳过提取: ${path.relative(projectRoot, filePath)}`);
147
+ return cached;
148
+ }
149
+ // 缓存未命中,调用对应提取器
150
+ let result;
151
+ try {
152
+ if (kind === 'document') {
153
+ result = await extractMarkdown(filePath, content, projectRoot);
154
+ }
155
+ else if (kind === 'api-spec') {
156
+ result = extractOpenApi(filePath, projectRoot);
157
+ }
158
+ else {
159
+ result = await extractImage(filePath, { projectRoot });
160
+ }
161
+ }
162
+ catch (err) {
163
+ logger.warn(`提取失败,降级为空结果: ${filePath} — ${String(err)}`);
164
+ return EMPTY_EXTRACTION_RESULT;
165
+ }
166
+ // Zod 验证(FR-015)
167
+ const validated = ExtractionResultSchema.safeParse(result);
168
+ if (!validated.success) {
169
+ logger.warn(`提取结果 Zod 验证失败,丢弃: ${filePath}`);
170
+ return EMPTY_EXTRACTION_RESULT;
171
+ }
172
+ // 写入缓存
173
+ await saveExtractCache(hash, outputDir, validated.data, filePath).catch((err) => {
174
+ logger.debug(`缓存写入失败(非致命): ${String(err)}`);
175
+ });
176
+ return validated.data;
177
+ }
178
+ // ============================================================
179
+ // 公开 API
180
+ // ============================================================
181
+ /**
182
+ * 在 projectRoot 下定位 README 文件(不区分大小写)。
183
+ * 优先级:README.md > readme.md > Readme.md > 其他大小写组合(按目录条目自然顺序)。
184
+ * 找不到时返回 undefined。
185
+ *
186
+ * **导出原因**:batch-orchestrator 在 generateBatchProjectDocs 之前需要早期 README 读取
187
+ * (narrative 在 docs 阶段生成,早于 extraction-pipeline);共享同一个 findReadmePath
188
+ * 助手避免两处大小写匹配候选列表漂移(修复 Codex review CRITICAL 2)。
189
+ *
190
+ * @param projectRoot - 项目根目录绝对路径
191
+ * @returns README 文件绝对路径;找不到返回 undefined
192
+ */
193
+ export function findReadmePath(projectRoot) {
194
+ let entries;
195
+ try {
196
+ entries = fs.readdirSync(projectRoot, { withFileTypes: true });
197
+ }
198
+ catch {
199
+ return undefined;
200
+ }
201
+ // 优先匹配规范命名 README.md,否则任何大小写
202
+ const candidates = entries.filter((e) => e.isFile() && /^readme\.md$/i.test(e.name));
203
+ if (candidates.length === 0)
204
+ return undefined;
205
+ // 优先返回 'README.md' 本身(spec 锁定首选规范名)
206
+ const canonical = candidates.find((e) => e.name === 'README.md');
207
+ return path.join(projectRoot, (canonical ?? candidates[0]).name);
208
+ }
209
+ /**
210
+ * 运行多模态提取管道
211
+ *
212
+ * @param options - 管道选项
213
+ * @returns ExtractionPipelineOutput — { results, readmeContent? };不抛出异常
214
+ */
215
+ export async function runExtractionPipeline(options) {
216
+ const { projectRoot, outputDir, includeDocs, includeImages } = options;
217
+ // 快速返回:两个标志均未启用
218
+ if (!includeDocs && !includeImages) {
219
+ return { results: [] };
220
+ }
221
+ // 扫描文件
222
+ const { docFiles, apiSpecFiles, imageFiles } = scanProjectFiles(projectRoot, includeDocs, includeImages);
223
+ // 图片数量警告(FR-017)
224
+ if (imageFiles.length > 50) {
225
+ logger.warn(`检测到 ${imageFiles.length} 张图片,Vision API 调用成本较高。` +
226
+ '建议仅在必要时使用 --include-images 标志。');
227
+ }
228
+ const allResults = [];
229
+ // API 规范文件(确定性,无 LLM,直接提取)
230
+ for (const filePath of apiSpecFiles) {
231
+ try {
232
+ const result = await extractWithCache(filePath, outputDir, projectRoot, 'api-spec');
233
+ if (result.nodes.length > 0 || result.edges.length > 0) {
234
+ allResults.push(result);
235
+ }
236
+ }
237
+ catch (err) {
238
+ logger.warn(`API 规范提取失败: ${filePath} — ${String(err)}`);
239
+ }
240
+ }
241
+ // Markdown 文件(含 LLM,并发上限 5)
242
+ const markdownTasks = docFiles.map((filePath) => async () => {
243
+ try {
244
+ const result = await extractWithCache(filePath, outputDir, projectRoot, 'document');
245
+ if (result.nodes.length > 0 || result.edges.length > 0) {
246
+ allResults.push(result);
247
+ }
248
+ }
249
+ catch (err) {
250
+ logger.warn(`Markdown 提取失败: ${filePath} — ${String(err)}`);
251
+ }
252
+ });
253
+ // FR-016:并发上限 5
254
+ await concurrentPool(markdownTasks, 5);
255
+ // 图像文件(Vision API)
256
+ const imageTasks = imageFiles.map((filePath) => async () => {
257
+ try {
258
+ const result = await extractWithCache(filePath, outputDir, projectRoot, 'image');
259
+ if (result.nodes.length > 0 || result.edges.length > 0) {
260
+ allResults.push(result);
261
+ }
262
+ }
263
+ catch (err) {
264
+ logger.warn(`图像提取失败: ${filePath} — ${String(err)}`);
265
+ }
266
+ });
267
+ await concurrentPool(imageTasks, 3);
268
+ // Feature 140 FR-010:includeDocs=true 时单独读取 README 全量内容(不走 LLM 提取链路)
269
+ // 不截断(移除 v4.0.x 时代的 5k token 限制);读取失败 → undefined(下游不阻断)。
270
+ // 注意:README 仍会被上方 markdown LLM 提取链路处理(产生 nodes/edges 进入 results),
271
+ // 此处的 readmeContent 是 raw 内容并存,供 narrative / hyperedge 等下游 pipeline 直接消费。
272
+ let readmeContent;
273
+ if (includeDocs) {
274
+ const readmePath = findReadmePath(projectRoot);
275
+ if (readmePath) {
276
+ try {
277
+ readmeContent = fs.readFileSync(readmePath, 'utf-8');
278
+ }
279
+ catch (err) {
280
+ logger.warn(`README 读取失败(不阻断主流程): ${path.relative(projectRoot, readmePath)} — ${String(err)}`);
281
+ }
282
+ }
283
+ }
284
+ return { results: allResults, readmeContent };
285
+ }
286
+ //# sourceMappingURL=extraction-pipeline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction-pipeline.js","sourceRoot":"","sources":["../../src/extraction/extraction-pipeline.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,180 @@
1
+ /**
2
+ * 多模态提取模块核心类型定义(Feature 107)
3
+ * 定义 Zod schema + TypeScript 类型,供提取器和图构建器消费
4
+ */
5
+ import { z } from 'zod';
6
+ /**
7
+ * 文件制品类型
8
+ * - document:Markdown 文档
9
+ * - api-spec:OpenAPI / AsyncAPI 规范
10
+ * - image:图像(PNG/JPG/JPEG/SVG 等)
11
+ */
12
+ export type ArtifactKind = 'document' | 'api-spec' | 'image';
13
+ /**
14
+ * 提取节点类型(对应 GraphNode.kind 新增的四个枚举值 + document)
15
+ * Feature 145:新增 'component'(函数/类符号)和 'module'(文件级模块)以支持 Python AST 桥接
16
+ */
17
+ export type ExtractedNodeKind = 'document' | 'api' | 'api-schema' | 'event' | 'diagram' | 'service' | 'component' | 'module';
18
+ /**
19
+ * 提取节点 Zod schema
20
+ * id 由提取器按数据模型规则生成,在同一 ExtractionResult 内唯一
21
+ */
22
+ export declare const ExtractedNodeSchema: z.ZodObject<{
23
+ /** 全局唯一 ID,格式由提取器按 data-model.md 规则生成 */
24
+ id: z.ZodString;
25
+ /** 人类可读显示标签 */
26
+ label: z.ZodString;
27
+ /**
28
+ * 节点类型
29
+ * Feature 145:新增 'component'(函数/类符号)和 'module'(文件级模块)以支持 Python AST 桥接
30
+ */
31
+ kind: z.ZodEnum<["document", "api", "api-schema", "event", "diagram", "service", "component", "module"]>;
32
+ /** 来源文件路径(提取器内部使用绝对路径,合并到图谱时建议转换为相对路径) */
33
+ source_file: z.ZodString;
34
+ /** 置信度标签:EXTRACTED(确定性提取)| INFERRED(LLM 推断)| AMBIGUOUS(弱信号) */
35
+ confidence: z.ZodEnum<["EXTRACTED", "INFERRED", "AMBIGUOUS"]>;
36
+ /** 扩展元数据(type-safe 但不约束 key) */
37
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
38
+ }, "strip", z.ZodTypeAny, {
39
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
40
+ id: string;
41
+ label: string;
42
+ source_file: string;
43
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
44
+ metadata?: Record<string, unknown> | undefined;
45
+ }, {
46
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
47
+ id: string;
48
+ label: string;
49
+ source_file: string;
50
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
51
+ metadata?: Record<string, unknown> | undefined;
52
+ }>;
53
+ export type ExtractedNode = z.infer<typeof ExtractedNodeSchema>;
54
+ /**
55
+ * 提取边 Zod schema
56
+ */
57
+ export declare const ExtractedEdgeSchema: z.ZodObject<{
58
+ /** 来源节点 ID */
59
+ source: z.ZodString;
60
+ /** 目标节点 ID */
61
+ target: z.ZodString;
62
+ /** 关系类型(documents / references / defines / uses-schema / publishes / subscribes / depicts) */
63
+ relation: z.ZodString;
64
+ /** 置信度标签 */
65
+ confidence: z.ZodEnum<["EXTRACTED", "INFERRED", "AMBIGUOUS"]>;
66
+ /** 社区检测边权重,默认 1.0(FR-021:统一权重) */
67
+ weight: z.ZodDefault<z.ZodNumber>;
68
+ }, "strip", z.ZodTypeAny, {
69
+ source: string;
70
+ target: string;
71
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
72
+ relation: string;
73
+ weight: number;
74
+ }, {
75
+ source: string;
76
+ target: string;
77
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
78
+ relation: string;
79
+ weight?: number | undefined;
80
+ }>;
81
+ export type ExtractedEdge = z.infer<typeof ExtractedEdgeSchema>;
82
+ /**
83
+ * 提取结果 Zod schema(一个文件对应一个提取结果)
84
+ */
85
+ export declare const ExtractionResultSchema: z.ZodObject<{
86
+ nodes: z.ZodArray<z.ZodObject<{
87
+ /** 全局唯一 ID,格式由提取器按 data-model.md 规则生成 */
88
+ id: z.ZodString;
89
+ /** 人类可读显示标签 */
90
+ label: z.ZodString;
91
+ /**
92
+ * 节点类型
93
+ * Feature 145:新增 'component'(函数/类符号)和 'module'(文件级模块)以支持 Python AST 桥接
94
+ */
95
+ kind: z.ZodEnum<["document", "api", "api-schema", "event", "diagram", "service", "component", "module"]>;
96
+ /** 来源文件路径(提取器内部使用绝对路径,合并到图谱时建议转换为相对路径) */
97
+ source_file: z.ZodString;
98
+ /** 置信度标签:EXTRACTED(确定性提取)| INFERRED(LLM 推断)| AMBIGUOUS(弱信号) */
99
+ confidence: z.ZodEnum<["EXTRACTED", "INFERRED", "AMBIGUOUS"]>;
100
+ /** 扩展元数据(type-safe 但不约束 key) */
101
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
102
+ }, "strip", z.ZodTypeAny, {
103
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
104
+ id: string;
105
+ label: string;
106
+ source_file: string;
107
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
108
+ metadata?: Record<string, unknown> | undefined;
109
+ }, {
110
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
111
+ id: string;
112
+ label: string;
113
+ source_file: string;
114
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
115
+ metadata?: Record<string, unknown> | undefined;
116
+ }>, "many">;
117
+ edges: z.ZodArray<z.ZodObject<{
118
+ /** 来源节点 ID */
119
+ source: z.ZodString;
120
+ /** 目标节点 ID */
121
+ target: z.ZodString;
122
+ /** 关系类型(documents / references / defines / uses-schema / publishes / subscribes / depicts) */
123
+ relation: z.ZodString;
124
+ /** 置信度标签 */
125
+ confidence: z.ZodEnum<["EXTRACTED", "INFERRED", "AMBIGUOUS"]>;
126
+ /** 社区检测边权重,默认 1.0(FR-021:统一权重) */
127
+ weight: z.ZodDefault<z.ZodNumber>;
128
+ }, "strip", z.ZodTypeAny, {
129
+ source: string;
130
+ target: string;
131
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
132
+ relation: string;
133
+ weight: number;
134
+ }, {
135
+ source: string;
136
+ target: string;
137
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
138
+ relation: string;
139
+ weight?: number | undefined;
140
+ }>, "many">;
141
+ }, "strip", z.ZodTypeAny, {
142
+ edges: {
143
+ source: string;
144
+ target: string;
145
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
146
+ relation: string;
147
+ weight: number;
148
+ }[];
149
+ nodes: {
150
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
151
+ id: string;
152
+ label: string;
153
+ source_file: string;
154
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
155
+ metadata?: Record<string, unknown> | undefined;
156
+ }[];
157
+ }, {
158
+ edges: {
159
+ source: string;
160
+ target: string;
161
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
162
+ relation: string;
163
+ weight?: number | undefined;
164
+ }[];
165
+ nodes: {
166
+ kind: "module" | "document" | "api" | "api-schema" | "event" | "diagram" | "service" | "component";
167
+ id: string;
168
+ label: string;
169
+ source_file: string;
170
+ confidence: "EXTRACTED" | "INFERRED" | "AMBIGUOUS";
171
+ metadata?: Record<string, unknown> | undefined;
172
+ }[];
173
+ }>;
174
+ export type ExtractionResult = z.infer<typeof ExtractionResultSchema>;
175
+ /**
176
+ * 空提取结果常量(Null Object 模式,所有降级路径统一返回此值)
177
+ * 使用 Object.freeze 确保不可变,调用方不得修改
178
+ */
179
+ export declare const EMPTY_EXTRACTION_RESULT: ExtractionResult;
180
+ //# sourceMappingURL=extraction-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction-types.d.ts","sourceRoot":"","sources":["../../src/extraction/extraction-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAM7D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAM7H;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,yCAAyC;;IAEzC,eAAe;;IAEf;;;OAGG;;IAEH,0CAA0C;;IAE1C,+DAA+D;;IAE/D,gCAAgC;;;;;;;;;;;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,cAAc;;IAEd,cAAc;;IAEd,8FAA8F;;IAE9F,YAAY;;IAEZ,kCAAkC;;;;;;;;;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;QAxCjC,yCAAyC;;QAEzC,eAAe;;QAEf;;;WAGG;;QAEH,0CAA0C;;QAE1C,+DAA+D;;QAE/D,gCAAgC;;;;;;;;;;;;;;;;;;QAUhC,cAAc;;QAEd,cAAc;;QAEd,8FAA8F;;QAE9F,YAAY;;QAEZ,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAGpC,CAAC"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * 多模态提取模块核心类型定义(Feature 107)
3
+ * 定义 Zod schema + TypeScript 类型,供提取器和图构建器消费
4
+ */
5
+ import { z } from 'zod';
6
+ // ============================================================
7
+ // Zod Schema 定义
8
+ // ============================================================
9
+ /**
10
+ * 提取节点 Zod schema
11
+ * id 由提取器按数据模型规则生成,在同一 ExtractionResult 内唯一
12
+ */
13
+ export const ExtractedNodeSchema = z.object({
14
+ /** 全局唯一 ID,格式由提取器按 data-model.md 规则生成 */
15
+ id: z.string(),
16
+ /** 人类可读显示标签 */
17
+ label: z.string(),
18
+ /**
19
+ * 节点类型
20
+ * Feature 145:新增 'component'(函数/类符号)和 'module'(文件级模块)以支持 Python AST 桥接
21
+ */
22
+ kind: z.enum(['document', 'api', 'api-schema', 'event', 'diagram', 'service', 'component', 'module']),
23
+ /** 来源文件路径(提取器内部使用绝对路径,合并到图谱时建议转换为相对路径) */
24
+ source_file: z.string(),
25
+ /** 置信度标签:EXTRACTED(确定性提取)| INFERRED(LLM 推断)| AMBIGUOUS(弱信号) */
26
+ confidence: z.enum(['EXTRACTED', 'INFERRED', 'AMBIGUOUS']),
27
+ /** 扩展元数据(type-safe 但不约束 key) */
28
+ metadata: z.record(z.unknown()).optional(),
29
+ });
30
+ /**
31
+ * 提取边 Zod schema
32
+ */
33
+ export const ExtractedEdgeSchema = z.object({
34
+ /** 来源节点 ID */
35
+ source: z.string(),
36
+ /** 目标节点 ID */
37
+ target: z.string(),
38
+ /** 关系类型(documents / references / defines / uses-schema / publishes / subscribes / depicts) */
39
+ relation: z.string(),
40
+ /** 置信度标签 */
41
+ confidence: z.enum(['EXTRACTED', 'INFERRED', 'AMBIGUOUS']),
42
+ /** 社区检测边权重,默认 1.0(FR-021:统一权重) */
43
+ weight: z.number().default(1.0),
44
+ });
45
+ /**
46
+ * 提取结果 Zod schema(一个文件对应一个提取结果)
47
+ */
48
+ export const ExtractionResultSchema = z.object({
49
+ nodes: z.array(ExtractedNodeSchema),
50
+ edges: z.array(ExtractedEdgeSchema),
51
+ });
52
+ // ============================================================
53
+ // 常量
54
+ // ============================================================
55
+ /**
56
+ * 空提取结果常量(Null Object 模式,所有降级路径统一返回此值)
57
+ * 使用 Object.freeze 确保不可变,调用方不得修改
58
+ */
59
+ export const EMPTY_EXTRACTION_RESULT = Object.freeze({
60
+ nodes: [],
61
+ edges: [],
62
+ });
63
+ //# sourceMappingURL=extraction-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extraction-types.js","sourceRoot":"","sources":["../../src/extraction/extraction-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,yCAAyC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,eAAe;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrG,0CAA0C;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,+DAA+D;IAC/D,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC1D,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,cAAc;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,cAAc;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,8FAA8F;IAC9F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY;IACZ,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC1D,kCAAkC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CAChC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACpC,CAAC,CAAC;AAIH,+DAA+D;AAC/D,KAAK;AACL,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqB,MAAM,CAAC,MAAM,CAAC;IACrE,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC,CAAC"}
@@ -0,0 +1,21 @@
1
+ import Anthropic from '@anthropic-ai/sdk';
2
+ import type { ExtractionResult } from './extraction-types.js';
3
+ /** 图像提取器选项 */
4
+ export interface ImageExtractorOptions {
5
+ /** 项目根目录(用于计算相对路径) */
6
+ projectRoot: string;
7
+ /**
8
+ * Anthropic 客户端工厂函数(可注入用于测试)
9
+ * 如果为 undefined,使用默认 new Anthropic({ apiKey })
10
+ */
11
+ anthropicClientFactory?: (apiKey: string) => Pick<Anthropic, 'messages'>;
12
+ }
13
+ /**
14
+ * 从单个图像文件提取节点和边
15
+ *
16
+ * @param filePath - 图像文件绝对路径
17
+ * @param options - 提取器选项
18
+ * @returns ExtractionResult(不抛出异常,失败时返回 EMPTY_EXTRACTION_RESULT)
19
+ */
20
+ export declare function extractImage(filePath: string, options: ImageExtractorOptions): Promise<ExtractionResult>;
21
+ //# sourceMappingURL=image-extractor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/image-extractor.ts"],"names":[],"mappings":"AAaA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,uBAAuB,CAAC;AAyB7E,cAAc;AACd,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;CAC1E;AAuGD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAiG3B"}