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
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"component-view-model.d.ts","sourceRoot":"","sources":["../../../src/panoramic/models/component-view-model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D,MAAM,MAAM,2BAA2B,GACnC,iBAAiB,GACjB,aAAa,GACb,mBAAmB,GACnB,wBAAwB,GACxB,kBAAkB,GAClB,eAAe,GACf,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"component-view-model.d.ts","sourceRoot":"","sources":["../../../src/panoramic/models/component-view-model.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"component-view-model.js","sourceRoot":"","sources":["../../../src/panoramic/models/component-view-model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;
|
|
1
|
+
{"version":3,"file":"component-view-model.js","sourceRoot":"","sources":["../../../src/panoramic/models/component-view-model.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ArchitectureNarrativeOutput } from './architecture-narrative.js';
|
|
2
|
+
import { type DocumentProvenanceRecord } from './docs-quality-model.js';
|
|
3
|
+
export interface AdaptNarrativeProvenanceOptions {
|
|
4
|
+
outputDir?: string;
|
|
5
|
+
projectRoot?: string;
|
|
6
|
+
}
|
|
7
|
+
export declare function adaptArchitectureNarrativeProvenance(narrative: ArchitectureNarrativeOutput, options?: AdaptNarrativeProvenanceOptions): DocumentProvenanceRecord;
|
|
8
|
+
//# sourceMappingURL=narrative-provenance-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"narrative-provenance-adapter.d.ts","sourceRoot":"","sources":["../../src/panoramic/narrative-provenance-adapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,2BAA2B,EAG5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,KAAK,wBAAwB,EAE9B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,2BAA2B,EACtC,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CA2D1B"}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Narrative provenance adapter
|
|
3
|
+
*
|
|
4
|
+
* 为 architecture-narrative 补上 059 可直接消费的 section-level provenance wrapper。
|
|
5
|
+
*/
|
|
6
|
+
import * as path from 'node:path';
|
|
7
|
+
import { normalizeConfidence, summarizeProvenanceRecord, summarizeProvenanceSection, } from './docs-quality-model.js';
|
|
8
|
+
export function adaptArchitectureNarrativeProvenance(narrative, options = {}) {
|
|
9
|
+
const sourcePath = options.outputDir
|
|
10
|
+
? normalizeProjectPath(path.join(options.outputDir, 'architecture-narrative.md'), options.projectRoot)
|
|
11
|
+
: undefined;
|
|
12
|
+
const executiveSummaryEntries = narrative.keyModules
|
|
13
|
+
.slice(0, 4)
|
|
14
|
+
.map((module) => createModuleEntry(module, 'executive-summary'));
|
|
15
|
+
const keyModuleEntries = narrative.keyModules.map((module) => createModuleEntry(module, 'key-module'));
|
|
16
|
+
const symbolEntries = [
|
|
17
|
+
...narrative.keySymbols.map((symbol) => createSymbolEntry(symbol)),
|
|
18
|
+
...narrative.keyMethods.map((symbol) => createSymbolEntry(symbol)),
|
|
19
|
+
];
|
|
20
|
+
const observationEntries = [
|
|
21
|
+
...narrative.supportingDocs.map((doc) => ({
|
|
22
|
+
sourceType: 'generated-doc',
|
|
23
|
+
originType: doc.generatorId,
|
|
24
|
+
ref: doc.title,
|
|
25
|
+
path: doc.path,
|
|
26
|
+
note: `supporting-doc:${doc.generatorId}`,
|
|
27
|
+
confidence: 'medium',
|
|
28
|
+
inferred: false,
|
|
29
|
+
})),
|
|
30
|
+
...narrative.keyModules.slice(0, 3).map((module) => createModuleEntry(module, 'observation')),
|
|
31
|
+
];
|
|
32
|
+
return summarizeProvenanceRecord({
|
|
33
|
+
documentId: 'architecture-narrative',
|
|
34
|
+
title: narrative.title,
|
|
35
|
+
sourcePath,
|
|
36
|
+
available: true,
|
|
37
|
+
warnings: [],
|
|
38
|
+
sections: [
|
|
39
|
+
summarizeProvenanceSection({
|
|
40
|
+
id: 'executive-summary',
|
|
41
|
+
title: 'Executive Summary',
|
|
42
|
+
summary: narrative.executiveSummary.join(' '),
|
|
43
|
+
entries: executiveSummaryEntries,
|
|
44
|
+
}),
|
|
45
|
+
summarizeProvenanceSection({
|
|
46
|
+
id: 'key-modules',
|
|
47
|
+
title: 'Key Modules',
|
|
48
|
+
summary: `关键模块数: ${narrative.keyModules.length}`,
|
|
49
|
+
entries: keyModuleEntries,
|
|
50
|
+
}),
|
|
51
|
+
summarizeProvenanceSection({
|
|
52
|
+
id: 'key-symbols',
|
|
53
|
+
title: 'Key Symbols & Methods',
|
|
54
|
+
summary: `关键符号与方法数: ${narrative.keySymbols.length + narrative.keyMethods.length}`,
|
|
55
|
+
entries: symbolEntries,
|
|
56
|
+
}),
|
|
57
|
+
summarizeProvenanceSection({
|
|
58
|
+
id: 'observations',
|
|
59
|
+
title: 'Observations',
|
|
60
|
+
summary: narrative.observations.join(' '),
|
|
61
|
+
entries: observationEntries,
|
|
62
|
+
}),
|
|
63
|
+
],
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
function createModuleEntry(module, notePrefix) {
|
|
67
|
+
return {
|
|
68
|
+
sourceType: 'spec',
|
|
69
|
+
originType: 'stored-module-spec',
|
|
70
|
+
ref: module.sourceTarget,
|
|
71
|
+
path: module.relatedFiles[0] ?? module.sourceTarget,
|
|
72
|
+
note: `${notePrefix}:${module.intentSummary}`,
|
|
73
|
+
excerpt: module.businessSummary,
|
|
74
|
+
confidence: normalizeConfidence(module.confidence),
|
|
75
|
+
inferred: module.inferred,
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
function createSymbolEntry(symbol) {
|
|
79
|
+
return {
|
|
80
|
+
sourceType: 'code',
|
|
81
|
+
originType: symbol.kind,
|
|
82
|
+
ref: `${symbol.moduleName}:${symbol.ownerName ? `${symbol.ownerName}.` : ''}${symbol.name}`,
|
|
83
|
+
path: symbol.moduleName,
|
|
84
|
+
note: symbol.signature,
|
|
85
|
+
excerpt: symbol.note,
|
|
86
|
+
confidence: normalizeConfidence(symbol.inferred ? 'low' : 'medium'),
|
|
87
|
+
inferred: symbol.inferred,
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
function normalizeProjectPath(candidatePath, projectRoot) {
|
|
91
|
+
if (!projectRoot) {
|
|
92
|
+
return candidatePath.split(path.sep).join('/');
|
|
93
|
+
}
|
|
94
|
+
const relative = path.relative(projectRoot, candidatePath);
|
|
95
|
+
return relative.startsWith('..')
|
|
96
|
+
? candidatePath.split(path.sep).join('/')
|
|
97
|
+
: relative.split(path.sep).join('/');
|
|
98
|
+
}
|
|
99
|
+
//# sourceMappingURL=narrative-provenance-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"narrative-provenance-adapter.js","sourceRoot":"","sources":["../../src/panoramic/narrative-provenance-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* - 启用/禁用状态由 Registry 拥有(独立 Map),不修改外部 Parser 实例
|
|
14
14
|
* - getByFilePattern 使用简单的扩展名/文件名匹配(无外部依赖)
|
|
15
15
|
*
|
|
16
|
-
*
|
|
16
|
+
* 生命周期:进程级单例,所有 entry point 通过 src/runtime-bootstrap.ts 的 bootstrapRuntime 完成注册。
|
|
17
17
|
*/
|
|
18
18
|
import type { z } from 'zod';
|
|
19
19
|
import type { ArtifactParser } from './interfaces.js';
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* - 启用/禁用状态由 Registry 拥有(独立 Map),不修改外部 Parser 实例
|
|
14
14
|
* - getByFilePattern 使用简单的扩展名/文件名匹配(无外部依赖)
|
|
15
15
|
*
|
|
16
|
-
*
|
|
16
|
+
* 生命周期:进程级单例,所有 entry point 通过 src/runtime-bootstrap.ts 的 bootstrapRuntime 完成注册。
|
|
17
17
|
*/
|
|
18
18
|
import { ArtifactParserMetadataSchema } from './interfaces.js';
|
|
19
19
|
import { AbstractRegistry } from './abstract-registry.js';
|
|
@@ -17,11 +17,11 @@ export declare const SkillMdSectionSchema: z.ZodObject<{
|
|
|
17
17
|
/** 该标题下的正文内容(保留原始 Markdown 格式) */
|
|
18
18
|
content: z.ZodString;
|
|
19
19
|
}, "strip", z.ZodTypeAny, {
|
|
20
|
-
content: string;
|
|
21
20
|
heading: string;
|
|
22
|
-
}, {
|
|
23
21
|
content: string;
|
|
22
|
+
}, {
|
|
24
23
|
heading: string;
|
|
24
|
+
content: string;
|
|
25
25
|
}>;
|
|
26
26
|
/** SKILL.md 的单个二级标题分段 */
|
|
27
27
|
export type SkillMdSection = z.infer<typeof SkillMdSectionSchema>;
|
|
@@ -42,19 +42,19 @@ export declare const SkillMdInfoSchema: z.ZodObject<{
|
|
|
42
42
|
/** 该标题下的正文内容(保留原始 Markdown 格式) */
|
|
43
43
|
content: z.ZodString;
|
|
44
44
|
}, "strip", z.ZodTypeAny, {
|
|
45
|
-
content: string;
|
|
46
45
|
heading: string;
|
|
47
|
-
}, {
|
|
48
46
|
content: string;
|
|
47
|
+
}, {
|
|
49
48
|
heading: string;
|
|
49
|
+
content: string;
|
|
50
50
|
}>, "many">;
|
|
51
51
|
}, "strip", z.ZodTypeAny, {
|
|
52
52
|
name: string;
|
|
53
53
|
description: string;
|
|
54
54
|
title: string;
|
|
55
55
|
sections: {
|
|
56
|
-
content: string;
|
|
57
56
|
heading: string;
|
|
57
|
+
content: string;
|
|
58
58
|
}[];
|
|
59
59
|
version?: string | undefined;
|
|
60
60
|
}, {
|
|
@@ -62,8 +62,8 @@ export declare const SkillMdInfoSchema: z.ZodObject<{
|
|
|
62
62
|
description: string;
|
|
63
63
|
title: string;
|
|
64
64
|
sections: {
|
|
65
|
-
content: string;
|
|
66
65
|
heading: string;
|
|
66
|
+
content: string;
|
|
67
67
|
}[];
|
|
68
68
|
version?: string | undefined;
|
|
69
69
|
}>;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PatternHintsGenerator
|
|
3
|
+
*
|
|
4
|
+
* 组合 045 的架构概览输出,生成规则驱动的模式提示与 explanation 附录。
|
|
5
|
+
*/
|
|
6
|
+
import type { DocumentGenerator, GenerateOptions, ProjectContext } from './interfaces.js';
|
|
7
|
+
import { ArchitectureOverviewGenerator } from './architecture-overview-generator.js';
|
|
8
|
+
import { type PatternHint, type PatternHintsInput, type PatternHintsOutput, type PatternKnowledgeBaseEntry } from './pattern-hints-model.js';
|
|
9
|
+
export type PatternHintsLLMEnhancer = (hints: PatternHint[], input: PatternHintsInput) => Promise<PatternHint[]>;
|
|
10
|
+
export interface PatternHintsGeneratorDependencies {
|
|
11
|
+
architectureOverviewGenerator?: ArchitectureOverviewGenerator;
|
|
12
|
+
knowledgeBase?: readonly PatternKnowledgeBaseEntry[];
|
|
13
|
+
llmEnhancer?: PatternHintsLLMEnhancer;
|
|
14
|
+
}
|
|
15
|
+
export declare class PatternHintsGenerator implements DocumentGenerator<PatternHintsInput, PatternHintsOutput> {
|
|
16
|
+
readonly id: "pattern-hints";
|
|
17
|
+
readonly name: "\u67B6\u6784\u6A21\u5F0F\u63D0\u793A\u751F\u6210\u5668";
|
|
18
|
+
readonly description = "\u57FA\u4E8E\u67B6\u6784\u6982\u89C8\u5171\u4EAB\u6A21\u578B\u751F\u6210\u6A21\u5F0F\u63D0\u793A\u3001\u8BC1\u636E\u94FE\u4E0E explanation \u9644\u5F55";
|
|
19
|
+
private readonly architectureOverviewGenerator;
|
|
20
|
+
private readonly knowledgeBase;
|
|
21
|
+
private readonly llmEnhancer;
|
|
22
|
+
constructor(dependencies?: PatternHintsGeneratorDependencies);
|
|
23
|
+
isApplicable(context: ProjectContext): boolean | Promise<boolean>;
|
|
24
|
+
extract(context: ProjectContext): Promise<PatternHintsInput>;
|
|
25
|
+
generate(input: PatternHintsInput, options?: GenerateOptions): Promise<PatternHintsOutput>;
|
|
26
|
+
render(output: PatternHintsOutput): string;
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=pattern-hints-generator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pattern-hints-generator.d.ts","sourceRoot":"","sources":["../../src/panoramic/pattern-hints-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAKrF,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AASlC,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,iBAAiB,KACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE5B,MAAM,WAAW,iCAAiC;IAChD,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAC9D,aAAa,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACrD,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED,qBAAa,qBACX,YAAW,iBAAiB,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAEnE,QAAQ,CAAC,EAAE,EAAG,eAAe,CAAU;IACvC,QAAQ,CAAC,IAAI,EAAG,wDAAW,CAAU;IACrC,QAAQ,CAAC,WAAW,6JAA0C;IAE9D,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAgC;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,YAAY,GAAE,iCAAsC;IAMhE,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe5D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiDhG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;CAM3C"}
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PatternHintsGenerator
|
|
3
|
+
*
|
|
4
|
+
* 组合 045 的架构概览输出,生成规则驱动的模式提示与 explanation 附录。
|
|
5
|
+
*/
|
|
6
|
+
import Anthropic from '@anthropic-ai/sdk';
|
|
7
|
+
import { ArchitectureOverviewGenerator } from './architecture-overview-generator.js';
|
|
8
|
+
import { DEFAULT_PATTERN_KNOWLEDGE_BASE, evaluatePatternHints, } from './pattern-knowledge-base.js';
|
|
9
|
+
import { summarizePatternHints, } from './pattern-hints-model.js';
|
|
10
|
+
import { loadTemplate } from './utils/template-loader.js';
|
|
11
|
+
import { detectAuth } from '../auth/auth-detector.js';
|
|
12
|
+
import { callLLMviaCli } from '../auth/cli-proxy.js';
|
|
13
|
+
import { callLLMviaCodex } from '../auth/codex-proxy.js';
|
|
14
|
+
import { resolveReverseSpecModel } from '../core/model-selection.js';
|
|
15
|
+
const LLM_TIMEOUT_MS = 2_500;
|
|
16
|
+
export class PatternHintsGenerator {
|
|
17
|
+
id = 'pattern-hints';
|
|
18
|
+
name = '架构模式提示生成器';
|
|
19
|
+
description = '基于架构概览共享模型生成模式提示、证据链与 explanation 附录';
|
|
20
|
+
architectureOverviewGenerator;
|
|
21
|
+
knowledgeBase;
|
|
22
|
+
llmEnhancer;
|
|
23
|
+
constructor(dependencies = {}) {
|
|
24
|
+
this.architectureOverviewGenerator = dependencies.architectureOverviewGenerator ?? new ArchitectureOverviewGenerator();
|
|
25
|
+
this.knowledgeBase = dependencies.knowledgeBase ?? DEFAULT_PATTERN_KNOWLEDGE_BASE;
|
|
26
|
+
this.llmEnhancer = dependencies.llmEnhancer ?? defaultPatternHintsLLMEnhancer;
|
|
27
|
+
}
|
|
28
|
+
isApplicable(context) {
|
|
29
|
+
return this.architectureOverviewGenerator.isApplicable(context);
|
|
30
|
+
}
|
|
31
|
+
async extract(context) {
|
|
32
|
+
const architectureOverview = await this.architectureOverviewGenerator.generate(await this.architectureOverviewGenerator.extract(context));
|
|
33
|
+
return {
|
|
34
|
+
architectureOverview,
|
|
35
|
+
warnings: [...architectureOverview.warnings],
|
|
36
|
+
weakSignals: {
|
|
37
|
+
runtimeAvailable: architectureOverview.deploymentView?.available ?? false,
|
|
38
|
+
docGraphAvailable: context.existingSpecs.length > 0,
|
|
39
|
+
},
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
async generate(input, options) {
|
|
43
|
+
const evaluation = evaluatePatternHints({
|
|
44
|
+
architectureOverview: input.architectureOverview,
|
|
45
|
+
weakSignals: input.weakSignals,
|
|
46
|
+
}, this.knowledgeBase);
|
|
47
|
+
const warnings = new Set([
|
|
48
|
+
...input.warnings,
|
|
49
|
+
...input.architectureOverview.warnings,
|
|
50
|
+
...evaluation.warnings,
|
|
51
|
+
]);
|
|
52
|
+
let matchedPatterns = evaluation.matchedPatterns;
|
|
53
|
+
if (options?.useLLM && matchedPatterns.length > 0) {
|
|
54
|
+
try {
|
|
55
|
+
matchedPatterns = await this.llmEnhancer(matchedPatterns, input);
|
|
56
|
+
}
|
|
57
|
+
catch (error) {
|
|
58
|
+
warnings.add(`LLM explanation 增强失败,已回退规则输出: ${String(error)}`);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
const normalizedWarnings = uniqueSorted([...warnings]);
|
|
62
|
+
const model = {
|
|
63
|
+
projectName: input.architectureOverview.model.projectName,
|
|
64
|
+
matchedPatterns,
|
|
65
|
+
noHighConfidenceMatch: matchedPatterns.length === 0,
|
|
66
|
+
alternatives: evaluation.alternatives,
|
|
67
|
+
warnings: normalizedWarnings,
|
|
68
|
+
stats: summarizePatternHints({
|
|
69
|
+
matchedPatterns,
|
|
70
|
+
warnings: normalizedWarnings,
|
|
71
|
+
}, evaluation.totalPatternsEvaluated),
|
|
72
|
+
};
|
|
73
|
+
return {
|
|
74
|
+
title: `架构模式提示: ${model.projectName}`,
|
|
75
|
+
generatedAt: input.architectureOverview.generatedAt,
|
|
76
|
+
architectureOverview: input.architectureOverview,
|
|
77
|
+
model,
|
|
78
|
+
warnings: normalizedWarnings,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
render(output) {
|
|
82
|
+
const overviewMarkdown = this.architectureOverviewGenerator.render(output.architectureOverview).trimEnd();
|
|
83
|
+
const appendixTemplate = loadTemplate('pattern-hints.hbs', import.meta.url);
|
|
84
|
+
const appendixMarkdown = appendixTemplate(output).trim();
|
|
85
|
+
return `${overviewMarkdown}\n\n${appendixMarkdown}\n`;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
async function defaultPatternHintsLLMEnhancer(hints, input) {
|
|
89
|
+
if (hints.length === 0) {
|
|
90
|
+
return hints;
|
|
91
|
+
}
|
|
92
|
+
const auth = detectAuth();
|
|
93
|
+
if (!auth.preferred) {
|
|
94
|
+
return hints;
|
|
95
|
+
}
|
|
96
|
+
const systemPrompt = [
|
|
97
|
+
'你是架构文档说明增强器。',
|
|
98
|
+
'你的任务不是重新判断模式,也不是修改 confidence、evidence 或 alternatives。',
|
|
99
|
+
'你只能在既有结构化事实基础上,重写 explanation 和 summary 的中文表述。',
|
|
100
|
+
'若输入包含 [推断] 或证据不足信息,输出必须保留这种不确定性。',
|
|
101
|
+
'严格输出 JSON 数组,每个元素包含 patternId、summary、explanation 三个字段,不要输出其他内容。',
|
|
102
|
+
].join('\n');
|
|
103
|
+
const userPrompt = JSON.stringify({
|
|
104
|
+
projectName: input.architectureOverview.model.projectName,
|
|
105
|
+
patterns: hints.map((hint) => ({
|
|
106
|
+
patternId: hint.patternId,
|
|
107
|
+
patternName: hint.patternName,
|
|
108
|
+
summary: hint.summary,
|
|
109
|
+
explanation: hint.explanation,
|
|
110
|
+
matchedSignals: hint.matchedSignals,
|
|
111
|
+
missingSignals: hint.missingSignals,
|
|
112
|
+
alternatives: hint.competingAlternatives.map((alternative) => ({
|
|
113
|
+
patternName: alternative.patternName,
|
|
114
|
+
reason: alternative.reason,
|
|
115
|
+
})),
|
|
116
|
+
inferred: hint.inferred,
|
|
117
|
+
})),
|
|
118
|
+
});
|
|
119
|
+
const responseText = await callPatternHintsLLM(systemPrompt, userPrompt);
|
|
120
|
+
if (!responseText) {
|
|
121
|
+
return hints;
|
|
122
|
+
}
|
|
123
|
+
const parsed = parsePatternHintsEnhancement(responseText);
|
|
124
|
+
if (!parsed) {
|
|
125
|
+
return hints;
|
|
126
|
+
}
|
|
127
|
+
const updates = new Map(parsed.map((item) => [item.patternId, item]));
|
|
128
|
+
return hints.map((hint) => {
|
|
129
|
+
const update = updates.get(hint.patternId);
|
|
130
|
+
if (!update) {
|
|
131
|
+
return hint;
|
|
132
|
+
}
|
|
133
|
+
const summary = normalizeInferenceMarker(update.summary?.trim() || hint.summary, hint.inferred);
|
|
134
|
+
const explanation = normalizeInferenceMarker(update.explanation?.trim() || hint.explanation, hint.inferred);
|
|
135
|
+
return {
|
|
136
|
+
...hint,
|
|
137
|
+
summary,
|
|
138
|
+
explanation,
|
|
139
|
+
};
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
async function callPatternHintsLLM(systemPrompt, userPrompt) {
|
|
143
|
+
const authResult = detectAuth();
|
|
144
|
+
if (!authResult.preferred) {
|
|
145
|
+
return null;
|
|
146
|
+
}
|
|
147
|
+
const providerRuntime = authResult.preferred.type === 'cli-proxy' && authResult.preferred.provider === 'codex'
|
|
148
|
+
? 'codex'
|
|
149
|
+
: 'claude';
|
|
150
|
+
const model = process.env['PANORAMIC_LLM_MODEL'] ?? resolveReverseSpecModel({
|
|
151
|
+
provider: providerRuntime,
|
|
152
|
+
}).model;
|
|
153
|
+
if (authResult.preferred.type === 'api-key') {
|
|
154
|
+
const client = new Anthropic({
|
|
155
|
+
apiKey: process.env['ANTHROPIC_API_KEY'],
|
|
156
|
+
timeout: LLM_TIMEOUT_MS,
|
|
157
|
+
});
|
|
158
|
+
const response = await client.messages.create({
|
|
159
|
+
model,
|
|
160
|
+
max_tokens: 1_024,
|
|
161
|
+
temperature: 0.2,
|
|
162
|
+
system: systemPrompt,
|
|
163
|
+
messages: [{ role: 'user', content: userPrompt }],
|
|
164
|
+
});
|
|
165
|
+
const text = response.content
|
|
166
|
+
.filter((block) => block.type === 'text')
|
|
167
|
+
.map((block) => block.text)
|
|
168
|
+
.join('\n');
|
|
169
|
+
return text || null;
|
|
170
|
+
}
|
|
171
|
+
const fullPrompt = `${systemPrompt}\n\n---\n\n${userPrompt}`;
|
|
172
|
+
const cliResponse = authResult.preferred.provider === 'codex'
|
|
173
|
+
? await callLLMviaCodex(fullPrompt, { model, timeout: LLM_TIMEOUT_MS })
|
|
174
|
+
: await callLLMviaCli(fullPrompt, { model, timeout: LLM_TIMEOUT_MS });
|
|
175
|
+
return cliResponse.content || null;
|
|
176
|
+
}
|
|
177
|
+
function parsePatternHintsEnhancement(text) {
|
|
178
|
+
try {
|
|
179
|
+
const parsed = extractJsonArray(text);
|
|
180
|
+
if (!Array.isArray(parsed)) {
|
|
181
|
+
return null;
|
|
182
|
+
}
|
|
183
|
+
return parsed
|
|
184
|
+
.filter((item) => typeof item === 'object' && item !== null)
|
|
185
|
+
.filter((item) => typeof item['patternId'] === 'string')
|
|
186
|
+
.map((item) => ({
|
|
187
|
+
patternId: String(item['patternId']),
|
|
188
|
+
summary: typeof item['summary'] === 'string' ? item['summary'] : undefined,
|
|
189
|
+
explanation: typeof item['explanation'] === 'string' ? item['explanation'] : undefined,
|
|
190
|
+
}));
|
|
191
|
+
}
|
|
192
|
+
catch {
|
|
193
|
+
return null;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
function extractJsonArray(text) {
|
|
197
|
+
const trimmed = text.trim();
|
|
198
|
+
const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
|
|
199
|
+
if (codeBlockMatch) {
|
|
200
|
+
return JSON.parse(codeBlockMatch[1].trim());
|
|
201
|
+
}
|
|
202
|
+
const arrayStart = trimmed.indexOf('[');
|
|
203
|
+
const arrayEnd = trimmed.lastIndexOf(']');
|
|
204
|
+
if (arrayStart >= 0 && arrayEnd > arrayStart) {
|
|
205
|
+
return JSON.parse(trimmed.slice(arrayStart, arrayEnd + 1));
|
|
206
|
+
}
|
|
207
|
+
return JSON.parse(trimmed);
|
|
208
|
+
}
|
|
209
|
+
function normalizeInferenceMarker(text, inferred) {
|
|
210
|
+
if (!inferred || text.includes('[推断]')) {
|
|
211
|
+
return text;
|
|
212
|
+
}
|
|
213
|
+
return `${text} [推断]`;
|
|
214
|
+
}
|
|
215
|
+
function uniqueSorted(values) {
|
|
216
|
+
return [...new Set(values)].sort((left, right) => left.localeCompare(right));
|
|
217
|
+
}
|
|
218
|
+
//# sourceMappingURL=pattern-hints-generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pattern-hints-generator.js","sourceRoot":"","sources":["../../src/panoramic/pattern-hints-generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pattern hints shared model
|
|
3
|
+
*
|
|
4
|
+
* Feature 050 负责生产这份结构化模式提示模型。
|
|
5
|
+
* 本文件只承载共享实体与 helper,不包含 Markdown/模板细节。
|
|
6
|
+
*/
|
|
7
|
+
import type { ArchitectureOverviewOutput } from './architecture-overview-generator.js';
|
|
8
|
+
import type { ArchitectureSectionKind } from './architecture-overview-model.js';
|
|
9
|
+
export type PatternEvidenceSource = 'architecture-overview' | 'runtime-topology' | 'workspace-index' | 'cross-package' | 'doc-graph';
|
|
10
|
+
export type PatternMatchLevel = 'high' | 'medium' | 'low' | 'none';
|
|
11
|
+
export interface PatternEvidenceRef {
|
|
12
|
+
source: PatternEvidenceSource;
|
|
13
|
+
ref: string;
|
|
14
|
+
sectionKind?: ArchitectureSectionKind;
|
|
15
|
+
nodeId?: string;
|
|
16
|
+
edgeRef?: string;
|
|
17
|
+
note?: string;
|
|
18
|
+
inferred?: boolean;
|
|
19
|
+
}
|
|
20
|
+
export interface PatternAlternative {
|
|
21
|
+
patternId: string;
|
|
22
|
+
patternName: string;
|
|
23
|
+
reason: string;
|
|
24
|
+
confidenceGap?: number;
|
|
25
|
+
}
|
|
26
|
+
export interface PatternHint {
|
|
27
|
+
patternId: string;
|
|
28
|
+
patternName: string;
|
|
29
|
+
summary: string;
|
|
30
|
+
confidence: number;
|
|
31
|
+
matchLevel: Exclude<PatternMatchLevel, 'none'>;
|
|
32
|
+
explanation: string;
|
|
33
|
+
evidence: PatternEvidenceRef[];
|
|
34
|
+
matchedSignals: string[];
|
|
35
|
+
missingSignals: string[];
|
|
36
|
+
competingAlternatives: PatternAlternative[];
|
|
37
|
+
inferred: boolean;
|
|
38
|
+
}
|
|
39
|
+
export interface PatternHintStats {
|
|
40
|
+
totalPatternsEvaluated: number;
|
|
41
|
+
matchedPatterns: number;
|
|
42
|
+
highConfidencePatterns: number;
|
|
43
|
+
warningCount: number;
|
|
44
|
+
}
|
|
45
|
+
export interface PatternHintsModel {
|
|
46
|
+
projectName: string;
|
|
47
|
+
matchedPatterns: PatternHint[];
|
|
48
|
+
noHighConfidenceMatch: boolean;
|
|
49
|
+
alternatives: PatternAlternative[];
|
|
50
|
+
warnings: string[];
|
|
51
|
+
stats: PatternHintStats;
|
|
52
|
+
}
|
|
53
|
+
export interface PatternHintsInput {
|
|
54
|
+
architectureOverview: ArchitectureOverviewOutput;
|
|
55
|
+
warnings: string[];
|
|
56
|
+
weakSignals?: {
|
|
57
|
+
runtimeAvailable: boolean;
|
|
58
|
+
docGraphAvailable: boolean;
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
export interface PatternHintsOutput {
|
|
62
|
+
title: string;
|
|
63
|
+
generatedAt: string;
|
|
64
|
+
architectureOverview: ArchitectureOverviewOutput;
|
|
65
|
+
model: PatternHintsModel;
|
|
66
|
+
warnings: string[];
|
|
67
|
+
}
|
|
68
|
+
export interface PatternSignalRule {
|
|
69
|
+
id: string;
|
|
70
|
+
description: string;
|
|
71
|
+
sectionKind?: ArchitectureSectionKind;
|
|
72
|
+
weight: number;
|
|
73
|
+
}
|
|
74
|
+
export interface PatternKnowledgeBaseEntry {
|
|
75
|
+
id: string;
|
|
76
|
+
name: string;
|
|
77
|
+
summary: string;
|
|
78
|
+
positiveSignals: PatternSignalRule[];
|
|
79
|
+
negativeSignals: PatternSignalRule[];
|
|
80
|
+
competingPatternIds: string[];
|
|
81
|
+
explanationSeed: string;
|
|
82
|
+
}
|
|
83
|
+
export declare function createPatternEvidenceRef(source: PatternEvidenceSource, ref: string, options?: Omit<PatternEvidenceRef, 'source' | 'ref'>): PatternEvidenceRef;
|
|
84
|
+
export declare function determinePatternMatchLevel(confidence: number): PatternMatchLevel;
|
|
85
|
+
export declare function summarizePatternHints(model: Pick<PatternHintsModel, 'matchedPatterns' | 'warnings'>, totalPatternsEvaluated: number): PatternHintStats;
|
|
86
|
+
export declare function getHighConfidencePatternHints(model: PatternHintsModel): PatternHint[];
|
|
87
|
+
export declare function dedupePatternEvidence(evidence: PatternEvidenceRef[]): PatternEvidenceRef[];
|
|
88
|
+
export declare function clampConfidence(value: number): number;
|
|
89
|
+
//# sourceMappingURL=pattern-hints-model.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pattern-hints-model.d.ts","sourceRoot":"","sources":["../../src/panoramic/pattern-hints-model.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pattern hints shared model
|
|
3
|
+
*
|
|
4
|
+
* Feature 050 负责生产这份结构化模式提示模型。
|
|
5
|
+
* 本文件只承载共享实体与 helper,不包含 Markdown/模板细节。
|
|
6
|
+
*/
|
|
7
|
+
export function createPatternEvidenceRef(source, ref, options = {}) {
|
|
8
|
+
return {
|
|
9
|
+
source,
|
|
10
|
+
ref,
|
|
11
|
+
...options,
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
export function determinePatternMatchLevel(confidence) {
|
|
15
|
+
if (confidence >= 0.72) {
|
|
16
|
+
return 'high';
|
|
17
|
+
}
|
|
18
|
+
if (confidence >= 0.55) {
|
|
19
|
+
return 'medium';
|
|
20
|
+
}
|
|
21
|
+
if (confidence >= 0.35) {
|
|
22
|
+
return 'low';
|
|
23
|
+
}
|
|
24
|
+
return 'none';
|
|
25
|
+
}
|
|
26
|
+
export function summarizePatternHints(model, totalPatternsEvaluated) {
|
|
27
|
+
return {
|
|
28
|
+
totalPatternsEvaluated,
|
|
29
|
+
matchedPatterns: model.matchedPatterns.length,
|
|
30
|
+
highConfidencePatterns: model.matchedPatterns.filter((hint) => hint.matchLevel === 'high').length,
|
|
31
|
+
warningCount: model.warnings.length,
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
export function getHighConfidencePatternHints(model) {
|
|
35
|
+
return model.matchedPatterns.filter((hint) => hint.matchLevel === 'high');
|
|
36
|
+
}
|
|
37
|
+
export function dedupePatternEvidence(evidence) {
|
|
38
|
+
const seen = new Set();
|
|
39
|
+
const deduped = [];
|
|
40
|
+
for (const item of evidence) {
|
|
41
|
+
const key = [
|
|
42
|
+
item.source,
|
|
43
|
+
item.ref,
|
|
44
|
+
item.sectionKind ?? '',
|
|
45
|
+
item.nodeId ?? '',
|
|
46
|
+
item.edgeRef ?? '',
|
|
47
|
+
item.note ?? '',
|
|
48
|
+
item.inferred ? '1' : '0',
|
|
49
|
+
].join('::');
|
|
50
|
+
if (seen.has(key)) {
|
|
51
|
+
continue;
|
|
52
|
+
}
|
|
53
|
+
seen.add(key);
|
|
54
|
+
deduped.push(item);
|
|
55
|
+
}
|
|
56
|
+
return deduped;
|
|
57
|
+
}
|
|
58
|
+
export function clampConfidence(value) {
|
|
59
|
+
return Math.max(0, Math.min(1, Number(value.toFixed(2))));
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=pattern-hints-model.js.map
|