spectra-cli 4.1.1 → 4.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/adapters/go-adapter.d.ts.map +1 -1
- package/dist/adapters/go-adapter.js +2 -0
- package/dist/adapters/go-adapter.js.map +1 -1
- package/dist/adapters/index.d.ts +1 -1
- package/dist/adapters/index.d.ts.map +1 -1
- package/dist/adapters/java-adapter.d.ts.map +1 -1
- package/dist/adapters/java-adapter.js +2 -0
- package/dist/adapters/java-adapter.js.map +1 -1
- package/dist/adapters/language-adapter.d.ts +47 -9
- package/dist/adapters/language-adapter.d.ts.map +1 -1
- package/dist/adapters/python-adapter.d.ts +34 -6
- package/dist/adapters/python-adapter.d.ts.map +1 -1
- package/dist/adapters/python-adapter.js +157 -59
- package/dist/adapters/python-adapter.js.map +1 -1
- package/dist/adapters/ts-js-adapter.d.ts +13 -5
- package/dist/adapters/ts-js-adapter.d.ts.map +1 -1
- package/dist/adapters/ts-js-adapter.js +55 -14
- package/dist/adapters/ts-js-adapter.js.map +1 -1
- package/dist/batch/batch-orchestrator.d.ts +30 -4
- package/dist/batch/batch-orchestrator.d.ts.map +1 -1
- package/dist/batch/batch-orchestrator.js +284 -7
- package/dist/batch/batch-orchestrator.js.map +1 -1
- package/dist/batch/delta-regenerator.d.ts +2 -2
- package/dist/batch/delta-regenerator.d.ts.map +1 -1
- package/dist/batch/delta-regenerator.js.map +1 -1
- package/dist/batch/module-grouper.d.ts +2 -2
- package/dist/batch/module-grouper.d.ts.map +1 -1
- package/dist/batch/module-grouper.js +1 -1
- package/dist/batch/module-grouper.js.map +1 -1
- package/dist/cli/commands/graph.js +1 -1
- package/dist/cli/commands/graph.js.map +1 -1
- package/dist/cli/commands/index.d.ts +8 -0
- package/dist/cli/commands/index.d.ts.map +1 -0
- package/dist/cli/commands/index.js +274 -0
- package/dist/cli/commands/index.js.map +1 -0
- package/dist/cli/commands/query.d.ts.map +1 -1
- package/dist/cli/commands/query.js +3 -1
- package/dist/cli/commands/query.js.map +1 -1
- package/dist/cli/index.js +9 -9
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/utils/parse-args.d.ts +13 -1
- package/dist/cli/utils/parse-args.d.ts.map +1 -1
- package/dist/cli/utils/parse-args.js +79 -2
- package/dist/cli/utils/parse-args.js.map +1 -1
- package/dist/core/ast-analyzer.d.ts.map +1 -1
- package/dist/core/ast-analyzer.js +79 -5
- package/dist/core/ast-analyzer.js.map +1 -1
- package/dist/core/import-resolver.d.ts +90 -0
- package/dist/core/import-resolver.d.ts.map +1 -0
- package/dist/core/import-resolver.js +273 -0
- package/dist/core/import-resolver.js.map +1 -0
- package/dist/core/query-mappers/base-mapper.d.ts +13 -0
- package/dist/core/query-mappers/base-mapper.d.ts.map +1 -1
- package/dist/core/query-mappers/go-mapper.d.ts +68 -0
- package/dist/core/query-mappers/go-mapper.d.ts.map +1 -1
- package/dist/core/query-mappers/go-mapper.js +421 -0
- package/dist/core/query-mappers/go-mapper.js.map +1 -1
- package/dist/core/query-mappers/java-mapper.d.ts +196 -0
- package/dist/core/query-mappers/java-mapper.d.ts.map +1 -1
- package/dist/core/query-mappers/java-mapper.js +600 -0
- package/dist/core/query-mappers/java-mapper.js.map +1 -1
- package/dist/core/query-mappers/python-mapper.d.ts +55 -0
- package/dist/core/query-mappers/python-mapper.d.ts.map +1 -1
- package/dist/core/query-mappers/python-mapper.js +273 -0
- package/dist/core/query-mappers/python-mapper.js.map +1 -1
- package/dist/core/query-mappers/typescript-mapper.d.ts +102 -0
- package/dist/core/query-mappers/typescript-mapper.d.ts.map +1 -1
- package/dist/core/query-mappers/typescript-mapper.js +470 -0
- package/dist/core/query-mappers/typescript-mapper.js.map +1 -1
- package/dist/core/single-spec-orchestrator.d.ts.map +1 -1
- package/dist/core/single-spec-orchestrator.js +146 -9
- package/dist/core/single-spec-orchestrator.js.map +1 -1
- package/dist/core/tree-sitter-analyzer.d.ts +6 -0
- package/dist/core/tree-sitter-analyzer.d.ts.map +1 -1
- package/dist/core/tree-sitter-analyzer.js +33 -1
- package/dist/core/tree-sitter-analyzer.js.map +1 -1
- package/dist/core/tree-sitter-fallback.d.ts +7 -4
- package/dist/core/tree-sitter-fallback.d.ts.map +1 -1
- package/dist/core/tree-sitter-fallback.js +157 -12
- package/dist/core/tree-sitter-fallback.js.map +1 -1
- package/dist/extraction/extraction-types.d.ts +25 -25
- package/dist/generator/index-generator.d.ts +3 -3
- package/dist/generator/index-generator.d.ts.map +1 -1
- package/dist/generator/index-generator.js +1 -1
- package/dist/generator/index-generator.js.map +1 -1
- package/dist/graph/directory-graph.d.ts +14 -4
- package/dist/graph/directory-graph.d.ts.map +1 -1
- package/dist/graph/directory-graph.js +71 -128
- package/dist/graph/directory-graph.js.map +1 -1
- package/dist/graph/mermaid-renderer.d.ts +8 -5
- package/dist/graph/mermaid-renderer.d.ts.map +1 -1
- package/dist/graph/mermaid-renderer.js +3 -3
- package/dist/graph/mermaid-renderer.js.map +1 -1
- package/dist/graph/topological-sort.d.ts +13 -6
- package/dist/graph/topological-sort.d.ts.map +1 -1
- package/dist/graph/topological-sort.js +2 -2
- package/dist/graph/topological-sort.js.map +1 -1
- package/dist/knowledge-graph/call-resolver.d.ts +64 -0
- package/dist/knowledge-graph/call-resolver.d.ts.map +1 -0
- package/dist/knowledge-graph/call-resolver.js +323 -0
- package/dist/knowledge-graph/call-resolver.js.map +1 -0
- package/dist/knowledge-graph/import-resolver.d.ts +114 -0
- package/dist/knowledge-graph/import-resolver.d.ts.map +1 -0
- package/dist/knowledge-graph/import-resolver.js +537 -0
- package/dist/knowledge-graph/import-resolver.js.map +1 -0
- package/dist/knowledge-graph/incremental.d.ts +110 -0
- package/dist/knowledge-graph/incremental.d.ts.map +1 -0
- package/dist/knowledge-graph/incremental.js +410 -0
- package/dist/knowledge-graph/incremental.js.map +1 -0
- package/dist/knowledge-graph/index.d.ts +74 -0
- package/dist/knowledge-graph/index.d.ts.map +1 -0
- package/dist/knowledge-graph/index.js +156 -0
- package/dist/knowledge-graph/index.js.map +1 -0
- package/dist/knowledge-graph/module-derivation.d.ts +238 -0
- package/dist/knowledge-graph/module-derivation.d.ts.map +1 -0
- package/dist/knowledge-graph/module-derivation.js +418 -0
- package/dist/knowledge-graph/module-derivation.js.map +1 -0
- package/dist/knowledge-graph/persistence.d.ts +270 -0
- package/dist/knowledge-graph/persistence.d.ts.map +1 -0
- package/dist/knowledge-graph/persistence.js +226 -0
- package/dist/knowledge-graph/persistence.js.map +1 -0
- package/dist/knowledge-graph/query-helpers.d.ts +164 -0
- package/dist/knowledge-graph/query-helpers.d.ts.map +1 -0
- package/dist/knowledge-graph/query-helpers.js +394 -0
- package/dist/knowledge-graph/query-helpers.js.map +1 -0
- package/dist/knowledge-graph/unified-graph.d.ts +310 -0
- package/dist/knowledge-graph/unified-graph.d.ts.map +1 -0
- package/dist/knowledge-graph/unified-graph.js +182 -0
- package/dist/knowledge-graph/unified-graph.js.map +1 -0
- package/dist/mcp/agent-context-tools.d.ts +104 -0
- package/dist/mcp/agent-context-tools.d.ts.map +1 -0
- package/dist/mcp/agent-context-tools.js +854 -0
- package/dist/mcp/agent-context-tools.js.map +1 -0
- package/dist/mcp/graph-tools.d.ts +20 -0
- package/dist/mcp/graph-tools.d.ts.map +1 -1
- package/dist/mcp/graph-tools.js +71 -11
- package/dist/mcp/graph-tools.js.map +1 -1
- package/dist/mcp/lib/response-helpers.d.ts +67 -0
- package/dist/mcp/lib/response-helpers.d.ts.map +1 -0
- package/dist/mcp/lib/response-helpers.js +103 -0
- package/dist/mcp/lib/response-helpers.js.map +1 -0
- package/dist/mcp/server.d.ts +3 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +9 -10
- package/dist/mcp/server.js.map +1 -1
- package/dist/models/call-site.d.ts +68 -0
- package/dist/models/call-site.d.ts.map +1 -0
- package/dist/models/call-site.js +60 -0
- package/dist/models/call-site.js.map +1 -0
- package/dist/models/code-skeleton.d.ts +78 -6
- package/dist/models/code-skeleton.d.ts.map +1 -1
- package/dist/models/code-skeleton.js +29 -0
- package/dist/models/code-skeleton.js.map +1 -1
- package/dist/models/drift-item.d.ts +4 -4
- package/dist/models/module-spec.d.ts +155 -94
- package/dist/models/module-spec.d.ts.map +1 -1
- package/dist/panoramic/adr-decision-pipeline.d.ts +53 -0
- package/dist/panoramic/adr-decision-pipeline.d.ts.map +1 -0
- package/dist/panoramic/adr-decision-pipeline.js +685 -0
- package/dist/panoramic/adr-decision-pipeline.js.map +1 -0
- package/dist/panoramic/api-surface-generator.d.ts +56 -0
- package/dist/panoramic/api-surface-generator.d.ts.map +1 -0
- package/dist/panoramic/api-surface-generator.js +1671 -0
- package/dist/panoramic/api-surface-generator.js.map +1 -0
- package/dist/panoramic/architecture-ir-builder.d.ts +19 -0
- package/dist/panoramic/architecture-ir-builder.d.ts.map +1 -0
- package/dist/panoramic/architecture-ir-builder.js +561 -0
- package/dist/panoramic/architecture-ir-builder.js.map +1 -0
- package/dist/panoramic/architecture-ir-exporters.d.ts +7 -0
- package/dist/panoramic/architecture-ir-exporters.d.ts.map +1 -0
- package/dist/panoramic/architecture-ir-exporters.js +183 -0
- package/dist/panoramic/architecture-ir-exporters.js.map +1 -0
- package/dist/panoramic/architecture-ir-generator.d.ts +36 -0
- package/dist/panoramic/architecture-ir-generator.d.ts.map +1 -0
- package/dist/panoramic/architecture-ir-generator.js +51 -0
- package/dist/panoramic/architecture-ir-generator.js.map +1 -0
- package/dist/panoramic/architecture-ir-mermaid-adapter.d.ts +6 -0
- package/dist/panoramic/architecture-ir-mermaid-adapter.d.ts.map +1 -0
- package/dist/panoramic/architecture-ir-mermaid-adapter.js +98 -0
- package/dist/panoramic/architecture-ir-mermaid-adapter.js.map +1 -0
- package/dist/panoramic/architecture-ir-model.d.ts +87 -0
- package/dist/panoramic/architecture-ir-model.d.ts.map +1 -0
- package/dist/panoramic/architecture-ir-model.js +20 -0
- package/dist/panoramic/architecture-ir-model.js.map +1 -0
- package/dist/panoramic/architecture-narrative.d.ts +68 -0
- package/dist/panoramic/architecture-narrative.d.ts.map +1 -0
- package/dist/panoramic/architecture-narrative.js +401 -0
- package/dist/panoramic/architecture-narrative.js.map +1 -0
- package/dist/panoramic/architecture-overview-generator.d.ts +31 -0
- package/dist/panoramic/architecture-overview-generator.d.ts.map +1 -0
- package/dist/panoramic/architecture-overview-generator.js +454 -0
- package/dist/panoramic/architecture-overview-generator.js.map +1 -0
- package/dist/panoramic/architecture-overview-model.d.ts +77 -0
- package/dist/panoramic/architecture-overview-model.d.ts.map +1 -0
- package/dist/panoramic/architecture-overview-model.js +31 -0
- package/dist/panoramic/architecture-overview-model.js.map +1 -0
- package/dist/panoramic/batch-project-docs.d.ts.map +1 -1
- package/dist/panoramic/batch-project-docs.js +4 -2
- package/dist/panoramic/batch-project-docs.js.map +1 -1
- package/dist/panoramic/builders/component-view-builder.d.ts +25 -1
- package/dist/panoramic/builders/component-view-builder.d.ts.map +1 -1
- package/dist/panoramic/builders/component-view-builder.js +83 -3
- package/dist/panoramic/builders/component-view-builder.js.map +1 -1
- package/dist/panoramic/builders/doc-graph-builder.d.ts +2 -2
- package/dist/panoramic/builders/doc-graph-builder.d.ts.map +1 -1
- package/dist/panoramic/builders/doc-graph-builder.js.map +1 -1
- package/dist/panoramic/component-view-builder.d.ts +17 -0
- package/dist/panoramic/component-view-builder.d.ts.map +1 -0
- package/dist/panoramic/component-view-builder.js +652 -0
- package/dist/panoramic/component-view-builder.js.map +1 -0
- package/dist/panoramic/component-view-model.d.ts +127 -0
- package/dist/panoramic/component-view-model.d.ts.map +1 -0
- package/dist/panoramic/component-view-model.js +65 -0
- package/dist/panoramic/component-view-model.js.map +1 -0
- package/dist/panoramic/config-reference-generator.d.ts +78 -0
- package/dist/panoramic/config-reference-generator.d.ts.map +1 -0
- package/dist/panoramic/config-reference-generator.js +199 -0
- package/dist/panoramic/config-reference-generator.js.map +1 -0
- package/dist/panoramic/coverage-auditor.d.ts +95 -0
- package/dist/panoramic/coverage-auditor.d.ts.map +1 -0
- package/dist/panoramic/coverage-auditor.js +290 -0
- package/dist/panoramic/coverage-auditor.js.map +1 -0
- package/dist/panoramic/cross-package-analyzer.d.ts +112 -0
- package/dist/panoramic/cross-package-analyzer.d.ts.map +1 -0
- package/dist/panoramic/cross-package-analyzer.js +258 -0
- package/dist/panoramic/cross-package-analyzer.js.map +1 -0
- package/dist/panoramic/data-model-generator.d.ts +528 -0
- package/dist/panoramic/data-model-generator.d.ts.map +1 -0
- package/dist/panoramic/data-model-generator.js +647 -0
- package/dist/panoramic/data-model-generator.js.map +1 -0
- package/dist/panoramic/doc-graph-builder.d.ts +80 -0
- package/dist/panoramic/doc-graph-builder.d.ts.map +1 -0
- package/dist/panoramic/doc-graph-builder.js +352 -0
- package/dist/panoramic/doc-graph-builder.js.map +1 -0
- package/dist/panoramic/docs-bundle-manifest-reader.d.ts +26 -0
- package/dist/panoramic/docs-bundle-manifest-reader.d.ts.map +1 -0
- package/dist/panoramic/docs-bundle-manifest-reader.js +106 -0
- package/dist/panoramic/docs-bundle-manifest-reader.js.map +1 -0
- package/dist/panoramic/docs-bundle-orchestrator.d.ts +14 -0
- package/dist/panoramic/docs-bundle-orchestrator.d.ts.map +1 -0
- package/dist/panoramic/docs-bundle-orchestrator.js +538 -0
- package/dist/panoramic/docs-bundle-orchestrator.js.map +1 -0
- package/dist/panoramic/docs-bundle-profiles.d.ts +4 -0
- package/dist/panoramic/docs-bundle-profiles.d.ts.map +1 -0
- package/dist/panoramic/docs-bundle-profiles.js +82 -0
- package/dist/panoramic/docs-bundle-profiles.js.map +1 -0
- package/dist/panoramic/docs-bundle-types.d.ts +94 -0
- package/dist/panoramic/docs-bundle-types.d.ts.map +1 -0
- package/dist/panoramic/docs-bundle-types.js +10 -0
- package/dist/panoramic/docs-bundle-types.js.map +1 -0
- package/dist/panoramic/docs-quality-evaluator.d.ts +31 -0
- package/dist/panoramic/docs-quality-evaluator.d.ts.map +1 -0
- package/dist/panoramic/docs-quality-evaluator.js +941 -0
- package/dist/panoramic/docs-quality-evaluator.js.map +1 -0
- package/dist/panoramic/docs-quality-model.d.ts +125 -0
- package/dist/panoramic/docs-quality-model.d.ts.map +1 -0
- package/dist/panoramic/docs-quality-model.js +166 -0
- package/dist/panoramic/docs-quality-model.js.map +1 -0
- package/dist/panoramic/dynamic-scenarios-builder.d.ts +18 -0
- package/dist/panoramic/dynamic-scenarios-builder.d.ts.map +1 -0
- package/dist/panoramic/dynamic-scenarios-builder.js +316 -0
- package/dist/panoramic/dynamic-scenarios-builder.js.map +1 -0
- package/dist/panoramic/event-surface-generator.d.ts +52 -0
- package/dist/panoramic/event-surface-generator.d.ts.map +1 -0
- package/dist/panoramic/event-surface-generator.js +507 -0
- package/dist/panoramic/event-surface-generator.js.map +1 -0
- package/dist/panoramic/generator-registry.d.ts +1 -1
- package/dist/panoramic/generator-registry.d.ts.map +1 -1
- package/dist/panoramic/generator-registry.js +5 -2
- package/dist/panoramic/generator-registry.js.map +1 -1
- package/dist/panoramic/generators/cross-package-analyzer.d.ts +5 -5
- package/dist/panoramic/generators/cross-package-analyzer.d.ts.map +1 -1
- package/dist/panoramic/generators/cross-package-analyzer.js +1 -1
- package/dist/panoramic/generators/cross-package-analyzer.js.map +1 -1
- package/dist/panoramic/generators/data-model-generator.d.ts +27 -27
- package/dist/panoramic/graph/confidence-mapper.d.ts +18 -0
- package/dist/panoramic/graph/confidence-mapper.d.ts.map +1 -1
- package/dist/panoramic/graph/confidence-mapper.js +26 -0
- package/dist/panoramic/graph/confidence-mapper.js.map +1 -1
- package/dist/panoramic/graph/graph-builder.d.ts.map +1 -1
- package/dist/panoramic/graph/graph-builder.js +78 -0
- package/dist/panoramic/graph/graph-builder.js.map +1 -1
- package/dist/panoramic/graph/graph-paths.d.ts +8 -0
- package/dist/panoramic/graph/graph-paths.d.ts.map +1 -1
- package/dist/panoramic/graph/graph-paths.js +10 -0
- package/dist/panoramic/graph/graph-paths.js.map +1 -1
- package/dist/panoramic/graph/graph-query.d.ts +33 -2
- package/dist/panoramic/graph/graph-query.d.ts.map +1 -1
- package/dist/panoramic/graph/graph-query.js +69 -19
- package/dist/panoramic/graph/graph-query.js.map +1 -1
- package/dist/panoramic/graph/graph-types.d.ts +32 -3
- package/dist/panoramic/graph/graph-types.d.ts.map +1 -1
- package/dist/panoramic/hyperedges/schema.d.ts +6 -6
- package/dist/panoramic/interface-surface-generator.d.ts +50 -0
- package/dist/panoramic/interface-surface-generator.d.ts.map +1 -0
- package/dist/panoramic/interface-surface-generator.js +388 -0
- package/dist/panoramic/interface-surface-generator.js.map +1 -0
- package/dist/panoramic/interfaces.d.ts +2 -2
- package/dist/panoramic/mock-readme-generator.d.ts +90 -0
- package/dist/panoramic/mock-readme-generator.d.ts.map +1 -0
- package/dist/panoramic/mock-readme-generator.js +111 -0
- package/dist/panoramic/mock-readme-generator.js.map +1 -0
- package/dist/panoramic/models/component-view-model.d.ts +1 -1
- package/dist/panoramic/models/component-view-model.d.ts.map +1 -1
- package/dist/panoramic/models/component-view-model.js.map +1 -1
- package/dist/panoramic/narrative-provenance-adapter.d.ts +8 -0
- package/dist/panoramic/narrative-provenance-adapter.d.ts.map +1 -0
- package/dist/panoramic/narrative-provenance-adapter.js +99 -0
- package/dist/panoramic/narrative-provenance-adapter.js.map +1 -0
- package/dist/panoramic/parser-registry.d.ts +1 -1
- package/dist/panoramic/parser-registry.js +1 -1
- package/dist/panoramic/parsers/types.d.ts +6 -6
- package/dist/panoramic/pattern-hints-generator.d.ts +28 -0
- package/dist/panoramic/pattern-hints-generator.d.ts.map +1 -0
- package/dist/panoramic/pattern-hints-generator.js +218 -0
- package/dist/panoramic/pattern-hints-generator.js.map +1 -0
- package/dist/panoramic/pattern-hints-model.d.ts +89 -0
- package/dist/panoramic/pattern-hints-model.d.ts.map +1 -0
- package/dist/panoramic/pattern-hints-model.js +61 -0
- package/dist/panoramic/pattern-hints-model.js.map +1 -0
- package/dist/panoramic/pattern-knowledge-base.d.ts +31 -0
- package/dist/panoramic/pattern-knowledge-base.d.ts.map +1 -0
- package/dist/panoramic/pattern-knowledge-base.js +407 -0
- package/dist/panoramic/pattern-knowledge-base.js.map +1 -0
- package/dist/panoramic/pipelines/coverage-auditor.d.ts.map +1 -1
- package/dist/panoramic/pipelines/coverage-auditor.js +4 -2
- package/dist/panoramic/pipelines/coverage-auditor.js.map +1 -1
- package/dist/panoramic/pipelines/docs-bundle-orchestrator.js +13 -6
- package/dist/panoramic/pipelines/docs-bundle-orchestrator.js.map +1 -1
- package/dist/panoramic/pipelines/product-ux-docs.d.ts +5 -0
- package/dist/panoramic/pipelines/product-ux-docs.d.ts.map +1 -1
- package/dist/panoramic/pipelines/product-ux-docs.js +34 -6
- package/dist/panoramic/pipelines/product-ux-docs.js.map +1 -1
- package/dist/panoramic/product-ux-docs.d.ts +104 -0
- package/dist/panoramic/product-ux-docs.d.ts.map +1 -0
- package/dist/panoramic/product-ux-docs.js +817 -0
- package/dist/panoramic/product-ux-docs.js.map +1 -0
- package/dist/panoramic/qa/__tests__/citation.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/citation.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/citation.test.js +193 -0
- package/dist/panoramic/qa/__tests__/citation.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/debt-context.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/debt-context.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/debt-context.test.js +154 -0
- package/dist/panoramic/qa/__tests__/debt-context.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/graph-retriever.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/graph-retriever.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/graph-retriever.test.js +148 -0
- package/dist/panoramic/qa/__tests__/graph-retriever.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/index.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/index.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/index.test.js +246 -0
- package/dist/panoramic/qa/__tests__/index.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/llm-caller.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/llm-caller.test.js +168 -0
- package/dist/panoramic/qa/__tests__/llm-caller.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/prompt-builder.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/prompt-builder.test.js +150 -0
- package/dist/panoramic/qa/__tests__/prompt-builder.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/qa-integration.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/qa-integration.test.js +296 -0
- package/dist/panoramic/qa/__tests__/qa-integration.test.js.map +1 -0
- package/dist/panoramic/qa/__tests__/rag-reranker.test.d.ts +2 -0
- package/dist/panoramic/qa/__tests__/rag-reranker.test.d.ts.map +1 -0
- package/dist/panoramic/qa/__tests__/rag-reranker.test.js +136 -0
- package/dist/panoramic/qa/__tests__/rag-reranker.test.js.map +1 -0
- package/dist/panoramic/qa/index.d.ts.map +1 -1
- package/dist/panoramic/qa/index.js +10 -3
- package/dist/panoramic/qa/index.js.map +1 -1
- package/dist/panoramic/runtime-topology-generator.d.ts +77 -0
- package/dist/panoramic/runtime-topology-generator.d.ts.map +1 -0
- package/dist/panoramic/runtime-topology-generator.js +676 -0
- package/dist/panoramic/runtime-topology-generator.js.map +1 -0
- package/dist/panoramic/runtime-topology-model.d.ts +145 -0
- package/dist/panoramic/runtime-topology-model.d.ts.map +1 -0
- package/dist/panoramic/runtime-topology-model.js +300 -0
- package/dist/panoramic/runtime-topology-model.js.map +1 -0
- package/dist/panoramic/troubleshooting-generator.d.ts +51 -0
- package/dist/panoramic/troubleshooting-generator.d.ts.map +1 -0
- package/dist/panoramic/troubleshooting-generator.js +451 -0
- package/dist/panoramic/troubleshooting-generator.js.map +1 -0
- package/dist/panoramic/utils/text-segmenter.d.ts +15 -0
- package/dist/panoramic/utils/text-segmenter.d.ts.map +1 -1
- package/dist/panoramic/utils/text-segmenter.js +38 -0
- package/dist/panoramic/utils/text-segmenter.js.map +1 -1
- package/dist/panoramic/workspace-index-generator.d.ts +148 -0
- package/dist/panoramic/workspace-index-generator.d.ts.map +1 -0
- package/dist/panoramic/workspace-index-generator.js +497 -0
- package/dist/panoramic/workspace-index-generator.js.map +1 -0
- package/dist/runtime-bootstrap.d.ts +9 -0
- package/dist/runtime-bootstrap.d.ts.map +1 -0
- package/dist/runtime-bootstrap.js +33 -0
- package/dist/runtime-bootstrap.js.map +1 -0
- package/dist/utils/file-scanner.js +1 -1
- package/dist/utils/file-scanner.js.map +1 -1
- package/package.json +12 -2
- package/plugins/spec-driver/.claude-plugin/plugin.json +1 -1
- package/plugins/spec-driver/README.md +18 -1
- package/plugins/spec-driver/agents/implement.md +20 -1
- package/plugins/spec-driver/agents/plan.md +20 -1
- package/plugins/spec-driver/agents/quality-review.md +20 -1
- package/plugins/spec-driver/agents/spec-review.md +20 -1
- package/plugins/spec-driver/agents/verify.md +20 -1
- package/plugins/spec-driver/docs/customization.md +134 -0
- package/plugins/spec-driver/docs/spectra-mcp-integration.md +165 -0
- package/plugins/spec-driver/lib/preference-rules.mjs +96 -0
- package/plugins/spec-driver/scripts/postinstall.sh +1 -1
- package/plugins/spec-driver/scripts/sync-preference-rules.mjs +148 -0
- package/plugins/spec-driver/skills/spec-driver-feature/SKILL.md +10 -0
- package/plugins/spec-driver/skills/spec-driver-fix/SKILL.md +10 -0
- package/plugins/spec-driver/skills/spec-driver-implement/SKILL.md +10 -0
- package/plugins/spec-driver/skills/spec-driver-refactor/SKILL.md +10 -0
- package/plugins/spec-driver/skills/spec-driver-story/SKILL.md +10 -0
- package/plugins/spec-driver/templates/preference-rules.md +39 -0
- package/plugins/spectra/.claude-plugin/plugin.json +1 -1
- package/plugins/spectra/README.md +48 -1
- package/plugins/spectra/hooks/post-commit.sh +40 -0
- package/templates/product-overview.hbs +1 -1
|
@@ -0,0 +1,454 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ArchitectureOverviewGenerator
|
|
3
|
+
*
|
|
4
|
+
* 组合 RuntimeTopology、WorkspaceIndex、CrossPackage 的结构化输出,
|
|
5
|
+
* 生成系统上下文、部署视图和分层视图的统一架构概览。
|
|
6
|
+
*/
|
|
7
|
+
import * as path from 'node:path';
|
|
8
|
+
import { CrossPackageAnalyzer } from './cross-package-analyzer.js';
|
|
9
|
+
import { RuntimeTopologyGenerator } from './runtime-topology-generator.js';
|
|
10
|
+
import { createArchitectureEvidence, getArchitectureSection, inferModuleResponsibility, summarizeArchitectureOverview, } from './architecture-overview-model.js';
|
|
11
|
+
import { WorkspaceIndexGenerator } from './workspace-index-generator.js';
|
|
12
|
+
import { loadTemplate } from './utils/template-loader.js';
|
|
13
|
+
import { sanitizeMermaidId } from './utils/mermaid-helpers.js';
|
|
14
|
+
const PROJECT_NODE_ID = 'project';
|
|
15
|
+
export class ArchitectureOverviewGenerator {
|
|
16
|
+
id = 'architecture-overview';
|
|
17
|
+
name = '架构概览生成器';
|
|
18
|
+
description = '组合运行时拓扑、workspace 和跨包依赖输出,生成系统上下文与部署视图';
|
|
19
|
+
isApplicable(context) {
|
|
20
|
+
const runtimeApplicable = new RuntimeTopologyGenerator().isApplicable(context);
|
|
21
|
+
const workspaceApplicable = new WorkspaceIndexGenerator().isApplicable(context);
|
|
22
|
+
return Boolean(runtimeApplicable || workspaceApplicable);
|
|
23
|
+
}
|
|
24
|
+
async extract(context) {
|
|
25
|
+
const warnings = new Set();
|
|
26
|
+
const runtimeGenerator = new RuntimeTopologyGenerator();
|
|
27
|
+
const workspaceGenerator = new WorkspaceIndexGenerator();
|
|
28
|
+
const crossPackageAnalyzer = new CrossPackageAnalyzer();
|
|
29
|
+
let runtime;
|
|
30
|
+
if (runtimeGenerator.isApplicable(context)) {
|
|
31
|
+
try {
|
|
32
|
+
runtime = await runtimeGenerator.generate(await runtimeGenerator.extract(context));
|
|
33
|
+
}
|
|
34
|
+
catch (error) {
|
|
35
|
+
warnings.add(`运行时拓扑输入生成失败: ${String(error)}`);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
else {
|
|
39
|
+
warnings.add('未检测到 Compose / Dockerfile,部署视图将按需降级');
|
|
40
|
+
}
|
|
41
|
+
let workspace;
|
|
42
|
+
if (workspaceGenerator.isApplicable(context)) {
|
|
43
|
+
try {
|
|
44
|
+
workspace = await workspaceGenerator.generate(await workspaceGenerator.extract(context));
|
|
45
|
+
}
|
|
46
|
+
catch (error) {
|
|
47
|
+
warnings.add(`Workspace 输入生成失败: ${String(error)}`);
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
else {
|
|
51
|
+
warnings.add('当前项目不是 monorepo,分层视图将按需降级');
|
|
52
|
+
}
|
|
53
|
+
let crossPackage;
|
|
54
|
+
if (crossPackageAnalyzer.isApplicable(context)) {
|
|
55
|
+
try {
|
|
56
|
+
crossPackage = await crossPackageAnalyzer.generate(await crossPackageAnalyzer.extract(context));
|
|
57
|
+
}
|
|
58
|
+
catch (error) {
|
|
59
|
+
warnings.add(`跨包依赖输入生成失败: ${String(error)}`);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
else if (workspace) {
|
|
63
|
+
warnings.add('跨包依赖分析不适用,将仅使用 workspace 分组构建分层视图');
|
|
64
|
+
}
|
|
65
|
+
return {
|
|
66
|
+
projectName: runtime?.topology.projectName
|
|
67
|
+
?? workspace?.projectName
|
|
68
|
+
?? crossPackage?.projectName
|
|
69
|
+
?? path.basename(context.projectRoot),
|
|
70
|
+
runtime,
|
|
71
|
+
workspace,
|
|
72
|
+
crossPackage,
|
|
73
|
+
warnings: uniqueSorted([...warnings]),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
async generate(input, _options) {
|
|
77
|
+
const warnings = new Set(input.warnings);
|
|
78
|
+
const systemContext = buildSystemContextSection(input.projectName, input.runtime, input.workspace, input.crossPackage, warnings);
|
|
79
|
+
const deploymentView = buildDeploymentSection(input.runtime, warnings);
|
|
80
|
+
const layeredView = buildLayeredSection(input.workspace, input.crossPackage, warnings);
|
|
81
|
+
const moduleSummaries = buildModuleSummaries(input.workspace);
|
|
82
|
+
const deploymentUnits = buildDeploymentUnits(input.runtime);
|
|
83
|
+
const model = {
|
|
84
|
+
projectName: input.projectName,
|
|
85
|
+
sections: [systemContext, deploymentView, layeredView],
|
|
86
|
+
moduleSummaries,
|
|
87
|
+
deploymentUnits,
|
|
88
|
+
warnings: uniqueSorted([...warnings]),
|
|
89
|
+
stats: {
|
|
90
|
+
totalSections: 0,
|
|
91
|
+
availableSections: 0,
|
|
92
|
+
totalNodes: 0,
|
|
93
|
+
totalEdges: 0,
|
|
94
|
+
totalModules: 0,
|
|
95
|
+
totalDeploymentUnits: 0,
|
|
96
|
+
totalWarnings: 0,
|
|
97
|
+
},
|
|
98
|
+
};
|
|
99
|
+
model.stats = summarizeArchitectureOverview(model);
|
|
100
|
+
return {
|
|
101
|
+
title: `架构概览: ${input.projectName}`,
|
|
102
|
+
generatedAt: new Date().toISOString().split('T')[0],
|
|
103
|
+
model,
|
|
104
|
+
warnings: model.warnings,
|
|
105
|
+
systemContext: getArchitectureSection(model, 'system-context'),
|
|
106
|
+
deploymentView: getArchitectureSection(model, 'deployment'),
|
|
107
|
+
layeredView: getArchitectureSection(model, 'layered'),
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
render(output) {
|
|
111
|
+
const template = loadTemplate('architecture-overview.hbs', import.meta.url);
|
|
112
|
+
return template(output);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
function buildSystemContextSection(projectName, runtime, workspace, crossPackage, warnings) {
|
|
116
|
+
const nodes = new Map();
|
|
117
|
+
const edges = new Map();
|
|
118
|
+
addNode(nodes, {
|
|
119
|
+
id: PROJECT_NODE_ID,
|
|
120
|
+
label: projectName,
|
|
121
|
+
kind: 'project',
|
|
122
|
+
description: '当前项目系统边界',
|
|
123
|
+
evidence: [],
|
|
124
|
+
});
|
|
125
|
+
if (runtime?.topology.services.length) {
|
|
126
|
+
for (const service of runtime.topology.services) {
|
|
127
|
+
const serviceId = `service:${service.name}`;
|
|
128
|
+
const portList = service.ports
|
|
129
|
+
.map((port) => `${port.published ?? '--'}->${port.target}/${port.protocol}`)
|
|
130
|
+
.join(', ');
|
|
131
|
+
addNode(nodes, {
|
|
132
|
+
id: serviceId,
|
|
133
|
+
label: service.name,
|
|
134
|
+
kind: 'service',
|
|
135
|
+
description: [
|
|
136
|
+
service.containerName,
|
|
137
|
+
service.image,
|
|
138
|
+
portList.length > 0 ? `ports=${portList}` : '',
|
|
139
|
+
].filter(Boolean).join(' | '),
|
|
140
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
141
|
+
});
|
|
142
|
+
addEdge(edges, {
|
|
143
|
+
from: PROJECT_NODE_ID,
|
|
144
|
+
to: serviceId,
|
|
145
|
+
relation: 'contains',
|
|
146
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
147
|
+
});
|
|
148
|
+
for (const dependency of service.dependsOn) {
|
|
149
|
+
addEdge(edges, {
|
|
150
|
+
from: serviceId,
|
|
151
|
+
to: `service:${dependency.service}`,
|
|
152
|
+
relation: 'depends-on',
|
|
153
|
+
evidence: [createArchitectureEvidence('runtime-topology', dependency.sourceFile)],
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
const groupDependencies = new Map();
|
|
159
|
+
if (workspace?.groups.length) {
|
|
160
|
+
const packageToGroup = new Map();
|
|
161
|
+
for (const group of workspace.groups) {
|
|
162
|
+
for (const pkg of group.packages) {
|
|
163
|
+
packageToGroup.set(pkg.name, group.name);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
for (const group of workspace.groups) {
|
|
167
|
+
const groupId = `group:${group.name}`;
|
|
168
|
+
addNode(nodes, {
|
|
169
|
+
id: groupId,
|
|
170
|
+
label: group.name === '.' ? 'root' : group.name,
|
|
171
|
+
kind: 'module-group',
|
|
172
|
+
description: `${group.packages.length} 个子包`,
|
|
173
|
+
evidence: [createArchitectureEvidence('workspace-index', group.name)],
|
|
174
|
+
});
|
|
175
|
+
addEdge(edges, {
|
|
176
|
+
from: PROJECT_NODE_ID,
|
|
177
|
+
to: groupId,
|
|
178
|
+
relation: 'groups',
|
|
179
|
+
evidence: [createArchitectureEvidence('workspace-index', group.name)],
|
|
180
|
+
});
|
|
181
|
+
for (const pkg of group.packages) {
|
|
182
|
+
const currentGroup = group.name;
|
|
183
|
+
for (const dependency of pkg.dependencies) {
|
|
184
|
+
const targetGroup = packageToGroup.get(dependency);
|
|
185
|
+
if (!targetGroup || targetGroup === currentGroup) {
|
|
186
|
+
continue;
|
|
187
|
+
}
|
|
188
|
+
if (!groupDependencies.has(currentGroup)) {
|
|
189
|
+
groupDependencies.set(currentGroup, new Set());
|
|
190
|
+
}
|
|
191
|
+
groupDependencies.get(currentGroup).add(targetGroup);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
for (const [fromGroup, targets] of groupDependencies) {
|
|
197
|
+
for (const targetGroup of targets) {
|
|
198
|
+
addEdge(edges, {
|
|
199
|
+
from: `group:${fromGroup}`,
|
|
200
|
+
to: `group:${targetGroup}`,
|
|
201
|
+
relation: 'depends-on',
|
|
202
|
+
evidence: [
|
|
203
|
+
createArchitectureEvidence(crossPackage ? 'cross-package' : 'workspace-index', crossPackage?.projectName ?? fromGroup),
|
|
204
|
+
],
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
const sectionNodes = [...nodes.values()];
|
|
209
|
+
const sectionEdges = [...edges.values()];
|
|
210
|
+
if (sectionNodes.length <= 1) {
|
|
211
|
+
warnings.add('缺少运行时与 workspace 结构化输入,系统上下文视图已降级');
|
|
212
|
+
return {
|
|
213
|
+
kind: 'system-context',
|
|
214
|
+
title: '系统上下文视图',
|
|
215
|
+
available: false,
|
|
216
|
+
nodes: sectionNodes,
|
|
217
|
+
edges: sectionEdges,
|
|
218
|
+
missingReason: '未检测到可组合的 runtime / workspace 输入',
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
return {
|
|
222
|
+
kind: 'system-context',
|
|
223
|
+
title: '系统上下文视图',
|
|
224
|
+
available: true,
|
|
225
|
+
description: '高层展示项目边界、关键服务和主要模块组',
|
|
226
|
+
nodes: sectionNodes,
|
|
227
|
+
edges: sectionEdges,
|
|
228
|
+
mermaidDiagram: buildMermaidDiagram(sectionNodes, sectionEdges),
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
function buildDeploymentSection(runtime, warnings) {
|
|
232
|
+
if (!runtime || (runtime.topology.services.length === 0 && runtime.topology.images.length === 0)) {
|
|
233
|
+
warnings.add('运行时拓扑不可用,部署视图已降级');
|
|
234
|
+
return {
|
|
235
|
+
kind: 'deployment',
|
|
236
|
+
title: '部署视图',
|
|
237
|
+
available: false,
|
|
238
|
+
nodes: [],
|
|
239
|
+
edges: [],
|
|
240
|
+
missingReason: '未检测到 Compose / Dockerfile 运行时信号',
|
|
241
|
+
};
|
|
242
|
+
}
|
|
243
|
+
const nodes = new Map();
|
|
244
|
+
const edges = new Map();
|
|
245
|
+
for (const service of runtime.topology.services) {
|
|
246
|
+
const serviceId = `service:${service.name}`;
|
|
247
|
+
addNode(nodes, {
|
|
248
|
+
id: serviceId,
|
|
249
|
+
label: service.name,
|
|
250
|
+
kind: 'service',
|
|
251
|
+
description: `容器=${service.containerName}`,
|
|
252
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
253
|
+
});
|
|
254
|
+
addNode(nodes, {
|
|
255
|
+
id: `container:${service.containerName}`,
|
|
256
|
+
label: service.containerName,
|
|
257
|
+
kind: 'container',
|
|
258
|
+
description: service.command ? `CMD=${service.command}` : undefined,
|
|
259
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
260
|
+
});
|
|
261
|
+
addEdge(edges, {
|
|
262
|
+
from: serviceId,
|
|
263
|
+
to: `container:${service.containerName}`,
|
|
264
|
+
relation: 'deploys',
|
|
265
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
266
|
+
});
|
|
267
|
+
if (service.image) {
|
|
268
|
+
addNode(nodes, {
|
|
269
|
+
id: `image:${service.image}`,
|
|
270
|
+
label: service.image,
|
|
271
|
+
kind: 'image',
|
|
272
|
+
description: service.targetStage ? `target=${service.targetStage}` : undefined,
|
|
273
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
274
|
+
});
|
|
275
|
+
addEdge(edges, {
|
|
276
|
+
from: `container:${service.containerName}`,
|
|
277
|
+
to: `image:${service.image}`,
|
|
278
|
+
relation: 'uses-image',
|
|
279
|
+
evidence: [createArchitectureEvidence('runtime-topology', service.sourceFile)],
|
|
280
|
+
});
|
|
281
|
+
}
|
|
282
|
+
for (const dependency of service.dependsOn) {
|
|
283
|
+
addEdge(edges, {
|
|
284
|
+
from: serviceId,
|
|
285
|
+
to: `service:${dependency.service}`,
|
|
286
|
+
relation: 'depends-on',
|
|
287
|
+
evidence: [createArchitectureEvidence('runtime-topology', dependency.sourceFile)],
|
|
288
|
+
});
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
if (runtime.topology.services.length === 0) {
|
|
292
|
+
for (const image of runtime.topology.images) {
|
|
293
|
+
addNode(nodes, {
|
|
294
|
+
id: `image:${image.name}`,
|
|
295
|
+
label: image.name,
|
|
296
|
+
kind: 'image',
|
|
297
|
+
description: image.dockerfilePath ? `dockerfile=${image.dockerfilePath}` : undefined,
|
|
298
|
+
evidence: [createArchitectureEvidence('runtime-topology', image.sourceFile)],
|
|
299
|
+
});
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
const sectionNodes = [...nodes.values()];
|
|
303
|
+
const sectionEdges = [...edges.values()];
|
|
304
|
+
return {
|
|
305
|
+
kind: 'deployment',
|
|
306
|
+
title: '部署视图',
|
|
307
|
+
available: true,
|
|
308
|
+
description: '展示服务、容器、镜像和关键部署依赖关系',
|
|
309
|
+
nodes: sectionNodes,
|
|
310
|
+
edges: sectionEdges,
|
|
311
|
+
mermaidDiagram: buildMermaidDiagram(sectionNodes, sectionEdges),
|
|
312
|
+
};
|
|
313
|
+
}
|
|
314
|
+
function buildLayeredSection(workspace, crossPackage, warnings) {
|
|
315
|
+
if (!workspace) {
|
|
316
|
+
warnings.add('Workspace 结构不可用,分层视图已降级');
|
|
317
|
+
return {
|
|
318
|
+
kind: 'layered',
|
|
319
|
+
title: '分层视图',
|
|
320
|
+
available: false,
|
|
321
|
+
nodes: [],
|
|
322
|
+
edges: [],
|
|
323
|
+
missingReason: '当前项目不适用 workspace / cross-package 分层分析',
|
|
324
|
+
};
|
|
325
|
+
}
|
|
326
|
+
const nodes = new Map();
|
|
327
|
+
const edges = new Map();
|
|
328
|
+
const internalPackageNames = new Set(workspace.packages.map((pkg) => pkg.name));
|
|
329
|
+
for (const group of workspace.groups) {
|
|
330
|
+
const groupId = `group:${group.name}`;
|
|
331
|
+
addNode(nodes, {
|
|
332
|
+
id: groupId,
|
|
333
|
+
label: group.name === '.' ? 'root' : group.name,
|
|
334
|
+
kind: 'module-group',
|
|
335
|
+
description: `${group.packages.length} 个子包`,
|
|
336
|
+
evidence: [createArchitectureEvidence('workspace-index', group.name)],
|
|
337
|
+
});
|
|
338
|
+
for (const pkg of group.packages) {
|
|
339
|
+
const packageId = `package:${pkg.name}`;
|
|
340
|
+
addNode(nodes, {
|
|
341
|
+
id: packageId,
|
|
342
|
+
label: pkg.name,
|
|
343
|
+
kind: 'package',
|
|
344
|
+
description: `${pkg.language} | ${pkg.path}`,
|
|
345
|
+
evidence: [createArchitectureEvidence('workspace-index', pkg.path)],
|
|
346
|
+
});
|
|
347
|
+
addEdge(edges, {
|
|
348
|
+
from: groupId,
|
|
349
|
+
to: packageId,
|
|
350
|
+
relation: 'contains',
|
|
351
|
+
evidence: [createArchitectureEvidence('workspace-index', pkg.path)],
|
|
352
|
+
});
|
|
353
|
+
for (const dependency of pkg.dependencies) {
|
|
354
|
+
if (!internalPackageNames.has(dependency)) {
|
|
355
|
+
continue;
|
|
356
|
+
}
|
|
357
|
+
addEdge(edges, {
|
|
358
|
+
from: packageId,
|
|
359
|
+
to: `package:${dependency}`,
|
|
360
|
+
relation: 'depends-on',
|
|
361
|
+
evidence: [
|
|
362
|
+
createArchitectureEvidence(crossPackage ? 'cross-package' : 'workspace-index', crossPackage?.projectName ?? pkg.path),
|
|
363
|
+
],
|
|
364
|
+
});
|
|
365
|
+
}
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
if (crossPackage?.hasCycles) {
|
|
369
|
+
warnings.add(`检测到跨包循环依赖: ${crossPackage.cycleGroups.map((group) => group.cyclePath).join('; ')}`);
|
|
370
|
+
}
|
|
371
|
+
return {
|
|
372
|
+
kind: 'layered',
|
|
373
|
+
title: '分层视图',
|
|
374
|
+
available: true,
|
|
375
|
+
description: '展示 workspace 分组、包级依赖和跨包层次',
|
|
376
|
+
nodes: [...nodes.values()],
|
|
377
|
+
edges: [...edges.values()],
|
|
378
|
+
mermaidDiagram: buildMermaidDiagram([...nodes.values()], [...edges.values()]),
|
|
379
|
+
};
|
|
380
|
+
}
|
|
381
|
+
function buildModuleSummaries(workspace) {
|
|
382
|
+
if (!workspace) {
|
|
383
|
+
return [];
|
|
384
|
+
}
|
|
385
|
+
const groupByPackage = new Map();
|
|
386
|
+
for (const group of workspace.groups) {
|
|
387
|
+
for (const pkg of group.packages) {
|
|
388
|
+
groupByPackage.set(pkg.name, group.name);
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
return workspace.packages
|
|
392
|
+
.map((pkg) => ({
|
|
393
|
+
groupName: groupByPackage.get(pkg.name) ?? '.',
|
|
394
|
+
packageName: pkg.name,
|
|
395
|
+
path: pkg.path,
|
|
396
|
+
language: pkg.language,
|
|
397
|
+
responsibility: inferModuleResponsibility(pkg.name, pkg.description, pkg.path),
|
|
398
|
+
dependencies: [...pkg.dependencies].sort(),
|
|
399
|
+
}))
|
|
400
|
+
.sort((a, b) => a.path.localeCompare(b.path));
|
|
401
|
+
}
|
|
402
|
+
function buildDeploymentUnits(runtime) {
|
|
403
|
+
if (!runtime) {
|
|
404
|
+
return [];
|
|
405
|
+
}
|
|
406
|
+
return runtime.topology.services
|
|
407
|
+
.map((service) => ({
|
|
408
|
+
serviceName: service.name,
|
|
409
|
+
containerName: service.containerName,
|
|
410
|
+
imageName: service.image,
|
|
411
|
+
targetStage: service.targetStage,
|
|
412
|
+
dependsOn: service.dependsOn.map((dependency) => dependency.service).sort(),
|
|
413
|
+
ports: service.ports.map((port) => `${port.published ?? '--'}->${port.target}/${port.protocol}`),
|
|
414
|
+
volumes: service.volumes.map((volume) => `${volume.source ?? '--'}:${volume.target}`),
|
|
415
|
+
}))
|
|
416
|
+
.sort((a, b) => a.serviceName.localeCompare(b.serviceName));
|
|
417
|
+
}
|
|
418
|
+
function addNode(target, node) {
|
|
419
|
+
if (!target.has(node.id)) {
|
|
420
|
+
target.set(node.id, node);
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
function addEdge(target, edge) {
|
|
424
|
+
const key = `${edge.from}|${edge.to}|${edge.relation}`;
|
|
425
|
+
if (!target.has(key)) {
|
|
426
|
+
target.set(key, edge);
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
function buildMermaidDiagram(nodes, edges) {
|
|
430
|
+
const lines = ['graph TD'];
|
|
431
|
+
for (const node of nodes) {
|
|
432
|
+
const nodeId = sanitizeMermaidId(node.id);
|
|
433
|
+
const label = escapeMermaidLabel(node.label);
|
|
434
|
+
lines.push(` ${nodeId}["${label}"]`);
|
|
435
|
+
}
|
|
436
|
+
if (edges.length === 0) {
|
|
437
|
+
lines.push(' %% no edges');
|
|
438
|
+
}
|
|
439
|
+
else {
|
|
440
|
+
for (const edge of edges) {
|
|
441
|
+
const fromId = sanitizeMermaidId(edge.from);
|
|
442
|
+
const toId = sanitizeMermaidId(edge.to);
|
|
443
|
+
lines.push(` ${fromId} -->|${edge.relation}| ${toId}`);
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
return lines.join('\n');
|
|
447
|
+
}
|
|
448
|
+
function escapeMermaidLabel(value) {
|
|
449
|
+
return value.replace(/"/g, '\\"');
|
|
450
|
+
}
|
|
451
|
+
function uniqueSorted(values) {
|
|
452
|
+
return [...new Set(values)].sort((a, b) => a.localeCompare(b));
|
|
453
|
+
}
|
|
454
|
+
//# sourceMappingURL=architecture-overview-generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"architecture-overview-generator.js","sourceRoot":"","sources":["../../src/panoramic/architecture-overview-generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Architecture overview shared model
|
|
3
|
+
*
|
|
4
|
+
* Feature 045 负责生产这份结构化架构视图模型,Feature 050 直接消费它。
|
|
5
|
+
* 本文件只承载共享实体与 helper,不包含 Markdown/模板细节。
|
|
6
|
+
*/
|
|
7
|
+
export type ArchitectureSourceKind = 'runtime-topology' | 'workspace-index' | 'cross-package';
|
|
8
|
+
export type ArchitectureSectionKind = 'system-context' | 'deployment' | 'layered';
|
|
9
|
+
export type ArchitectureNodeKind = 'project' | 'service' | 'container' | 'image' | 'module-group' | 'package' | 'external';
|
|
10
|
+
export type ArchitectureRelationKind = 'contains' | 'depends-on' | 'deploys' | 'uses-image' | 'groups';
|
|
11
|
+
export interface ArchitectureEvidence {
|
|
12
|
+
source: ArchitectureSourceKind;
|
|
13
|
+
ref: string;
|
|
14
|
+
note?: string;
|
|
15
|
+
}
|
|
16
|
+
export interface ArchitectureViewNode {
|
|
17
|
+
id: string;
|
|
18
|
+
label: string;
|
|
19
|
+
kind: ArchitectureNodeKind;
|
|
20
|
+
description?: string;
|
|
21
|
+
evidence: ArchitectureEvidence[];
|
|
22
|
+
}
|
|
23
|
+
export interface ArchitectureViewEdge {
|
|
24
|
+
from: string;
|
|
25
|
+
to: string;
|
|
26
|
+
relation: ArchitectureRelationKind;
|
|
27
|
+
evidence: ArchitectureEvidence[];
|
|
28
|
+
}
|
|
29
|
+
export interface ArchitectureViewSection {
|
|
30
|
+
kind: ArchitectureSectionKind;
|
|
31
|
+
title: string;
|
|
32
|
+
available: boolean;
|
|
33
|
+
description?: string;
|
|
34
|
+
nodes: ArchitectureViewNode[];
|
|
35
|
+
edges: ArchitectureViewEdge[];
|
|
36
|
+
mermaidDiagram?: string;
|
|
37
|
+
missingReason?: string;
|
|
38
|
+
}
|
|
39
|
+
export interface ArchitectureModuleSummary {
|
|
40
|
+
groupName: string;
|
|
41
|
+
packageName: string;
|
|
42
|
+
path: string;
|
|
43
|
+
language: string;
|
|
44
|
+
responsibility: string;
|
|
45
|
+
dependencies: string[];
|
|
46
|
+
}
|
|
47
|
+
export interface DeploymentUnitSummary {
|
|
48
|
+
serviceName: string;
|
|
49
|
+
containerName?: string;
|
|
50
|
+
imageName?: string;
|
|
51
|
+
targetStage?: string;
|
|
52
|
+
dependsOn: string[];
|
|
53
|
+
ports: string[];
|
|
54
|
+
volumes: string[];
|
|
55
|
+
}
|
|
56
|
+
export interface ArchitectureOverviewStats {
|
|
57
|
+
totalSections: number;
|
|
58
|
+
availableSections: number;
|
|
59
|
+
totalNodes: number;
|
|
60
|
+
totalEdges: number;
|
|
61
|
+
totalModules: number;
|
|
62
|
+
totalDeploymentUnits: number;
|
|
63
|
+
totalWarnings: number;
|
|
64
|
+
}
|
|
65
|
+
export interface ArchitectureOverviewModel {
|
|
66
|
+
projectName: string;
|
|
67
|
+
sections: ArchitectureViewSection[];
|
|
68
|
+
moduleSummaries: ArchitectureModuleSummary[];
|
|
69
|
+
deploymentUnits: DeploymentUnitSummary[];
|
|
70
|
+
warnings: string[];
|
|
71
|
+
stats: ArchitectureOverviewStats;
|
|
72
|
+
}
|
|
73
|
+
export declare function createArchitectureEvidence(source: ArchitectureSourceKind, ref: string, note?: string): ArchitectureEvidence;
|
|
74
|
+
export declare function inferModuleResponsibility(packageName: string, description: string, packagePath: string): string;
|
|
75
|
+
export declare function summarizeArchitectureOverview(model: Pick<ArchitectureOverviewModel, 'sections' | 'moduleSummaries' | 'deploymentUnits' | 'warnings'>): ArchitectureOverviewStats;
|
|
76
|
+
export declare function getArchitectureSection(model: ArchitectureOverviewModel, kind: ArchitectureSectionKind): ArchitectureViewSection | undefined;
|
|
77
|
+
//# sourceMappingURL=architecture-overview-model.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"architecture-overview-model.d.ts","sourceRoot":"","sources":["../../src/panoramic/architecture-overview-model.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Architecture overview shared model
|
|
3
|
+
*
|
|
4
|
+
* Feature 045 负责生产这份结构化架构视图模型,Feature 050 直接消费它。
|
|
5
|
+
* 本文件只承载共享实体与 helper,不包含 Markdown/模板细节。
|
|
6
|
+
*/
|
|
7
|
+
export function createArchitectureEvidence(source, ref, note) {
|
|
8
|
+
return { source, ref, note };
|
|
9
|
+
}
|
|
10
|
+
export function inferModuleResponsibility(packageName, description, packagePath) {
|
|
11
|
+
const normalized = description.trim();
|
|
12
|
+
if (normalized.length > 0) {
|
|
13
|
+
return normalized;
|
|
14
|
+
}
|
|
15
|
+
return `[推断] ${packageName}(${packagePath})未声明 description,职责基于包名/路径推断`;
|
|
16
|
+
}
|
|
17
|
+
export function summarizeArchitectureOverview(model) {
|
|
18
|
+
return {
|
|
19
|
+
totalSections: model.sections.length,
|
|
20
|
+
availableSections: model.sections.filter((section) => section.available).length,
|
|
21
|
+
totalNodes: model.sections.reduce((sum, section) => sum + section.nodes.length, 0),
|
|
22
|
+
totalEdges: model.sections.reduce((sum, section) => sum + section.edges.length, 0),
|
|
23
|
+
totalModules: model.moduleSummaries.length,
|
|
24
|
+
totalDeploymentUnits: model.deploymentUnits.length,
|
|
25
|
+
totalWarnings: model.warnings.length,
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export function getArchitectureSection(model, kind) {
|
|
29
|
+
return model.sections.find((section) => section.kind === kind);
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=architecture-overview-model.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"architecture-overview-model.js","sourceRoot":"","sources":["../../src/panoramic/architecture-overview-model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyFH,MAAM,UAAU,0BAA0B,CACxC,MAA8B,EAC9B,GAAW,EACX,IAAa;IAEb,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,QAAQ,WAAW,IAAI,WAAW,8BAA8B,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAuG;IAEvG,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;QACpC,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM;QAC/E,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,MAAM;QAC1C,oBAAoB,EAAE,KAAK,CAAC,eAAe,CAAC,MAAM;QAClD,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAgC,EAChC,IAA6B;IAE7B,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACjE,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"batch-project-docs.d.ts","sourceRoot":"","sources":["../../src/panoramic/batch-project-docs.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"batch-project-docs.d.ts","sourceRoot":"","sources":["../../src/panoramic/batch-project-docs.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQzE,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAuB,MAAM,sCAAsC,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAA0B,MAAM,yCAAyC,CAAC;AAExG,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAkB/C,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C;;;OAGG;IACH,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,aAAa,EAAE,sBAAsB,CAAC;IACtC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;CAC7C;AAMD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACtD,gBAAgB,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC5D,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,eAAe,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,CAAC;IACrE,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAgB/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAkC,CAAC;AAEtF,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,OAAO,mBAAmB,EAAE,OAAO,CAAC;CACvD;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA6bjC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,wBAAwB,CA+C1B"}
|
|
@@ -6,7 +6,8 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import fs from 'node:fs';
|
|
8
8
|
import path from 'node:path';
|
|
9
|
-
import { GeneratorRegistry
|
|
9
|
+
import { GeneratorRegistry } from './generator-registry.js';
|
|
10
|
+
import { bootstrapRuntime } from '../runtime-bootstrap.js';
|
|
10
11
|
import { CacheManager } from './cache/cache-manager.js';
|
|
11
12
|
import { ContentHasherImpl } from './cache/content-hasher.js';
|
|
12
13
|
import { ManifestManagerImpl } from './cache/manifest-manager.js';
|
|
@@ -71,7 +72,8 @@ export const READING_SKIP_IDS = new Set([
|
|
|
71
72
|
export const CODE_ONLY_SKIP_IDS = new Set([...READING_SKIP_IDS]);
|
|
72
73
|
export async function generateBatchProjectDocs(options) {
|
|
73
74
|
const projectContext = await buildProjectContext(options.projectRoot);
|
|
74
|
-
|
|
75
|
+
// 单一 runtime 初始化(FR-10):注册全部 registry,幂等
|
|
76
|
+
bootstrapRuntime();
|
|
75
77
|
const registry = GeneratorRegistry.getInstance();
|
|
76
78
|
const effectiveMode = options.mode ?? 'full';
|
|
77
79
|
// F5:按 mode 过滤 generator,reading/code-only 模式跳过对应集合中的 generator
|