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,80 @@
|
|
|
1
|
+
import type { DependencyGraph } from '../models/dependency-graph.js';
|
|
2
|
+
import type { ModuleSpec } from '../models/module-spec.js';
|
|
3
|
+
export declare const MODULE_SPEC_ANCHOR_ID = "module-spec";
|
|
4
|
+
export declare const CROSS_REFERENCE_MARKER_PREFIX = "<!-- cross-reference-index: auto";
|
|
5
|
+
export interface ExistingSpecDocument {
|
|
6
|
+
specPath: string;
|
|
7
|
+
sourceTarget: string;
|
|
8
|
+
relatedFiles: string[];
|
|
9
|
+
linked: boolean;
|
|
10
|
+
confidence?: 'high' | 'medium' | 'low';
|
|
11
|
+
}
|
|
12
|
+
export interface StoredModuleSpecSummary extends ExistingSpecDocument {
|
|
13
|
+
version?: string;
|
|
14
|
+
skeletonHash?: string;
|
|
15
|
+
language?: string;
|
|
16
|
+
crossLanguageRefs?: string[];
|
|
17
|
+
intentSummary: string;
|
|
18
|
+
outputPath: string;
|
|
19
|
+
}
|
|
20
|
+
export interface DocGraphSpecNode {
|
|
21
|
+
specPath: string;
|
|
22
|
+
sourceTarget: string;
|
|
23
|
+
relatedFiles: string[];
|
|
24
|
+
linked: boolean;
|
|
25
|
+
confidence?: 'high' | 'medium' | 'low';
|
|
26
|
+
currentRun: boolean;
|
|
27
|
+
}
|
|
28
|
+
export interface DocGraphSourceToSpec {
|
|
29
|
+
sourcePath: string;
|
|
30
|
+
specPath: string;
|
|
31
|
+
sourceTarget: string;
|
|
32
|
+
matchType: 'source-target' | 'related-file';
|
|
33
|
+
}
|
|
34
|
+
export interface DocGraphReferenceSample {
|
|
35
|
+
fromSource: string;
|
|
36
|
+
toSource: string;
|
|
37
|
+
}
|
|
38
|
+
export interface DocGraphReference {
|
|
39
|
+
kind: 'same-module' | 'cross-module';
|
|
40
|
+
fromSpecPath: string;
|
|
41
|
+
toSpecPath: string;
|
|
42
|
+
fromSourceTarget: string;
|
|
43
|
+
toSourceTarget: string;
|
|
44
|
+
evidenceCount: number;
|
|
45
|
+
evidenceSamples: DocGraphReferenceSample[];
|
|
46
|
+
}
|
|
47
|
+
export interface DocGraphMissingSpec {
|
|
48
|
+
sourcePath: string;
|
|
49
|
+
reason: 'no-spec-owner';
|
|
50
|
+
}
|
|
51
|
+
export interface DocGraphUnlinkedSpec {
|
|
52
|
+
specPath: string;
|
|
53
|
+
sourceTarget: string;
|
|
54
|
+
}
|
|
55
|
+
export interface DocGraph {
|
|
56
|
+
projectRoot: string;
|
|
57
|
+
generatedAt: string;
|
|
58
|
+
specs: DocGraphSpecNode[];
|
|
59
|
+
sourceToSpec: DocGraphSourceToSpec[];
|
|
60
|
+
references: DocGraphReference[];
|
|
61
|
+
missingSpecs: DocGraphMissingSpec[];
|
|
62
|
+
unlinkedSpecs: DocGraphUnlinkedSpec[];
|
|
63
|
+
}
|
|
64
|
+
export interface BuildDocGraphOptions {
|
|
65
|
+
projectRoot: string;
|
|
66
|
+
dependencyGraph: DependencyGraph;
|
|
67
|
+
moduleSpecs: ModuleSpec[];
|
|
68
|
+
existingSpecs?: ExistingSpecDocument[];
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* 扫描输出目录下的既有 *.spec.md,仅提取 044 所需最小元数据。
|
|
72
|
+
*/
|
|
73
|
+
export declare function scanExistingSpecDocuments(specsDir: string, projectRoot: string): ExistingSpecDocument[];
|
|
74
|
+
export declare function scanStoredModuleSpecs(specsDir: string, projectRoot: string): StoredModuleSpecSummary[];
|
|
75
|
+
/**
|
|
76
|
+
* 构建统一 DocGraph。
|
|
77
|
+
*/
|
|
78
|
+
export declare function buildDocGraph(options: BuildDocGraphOptions): DocGraph;
|
|
79
|
+
export declare function resolveSpecForSource(sourcePath: string, specs: DocGraphSpecNode[]): DocGraphSpecNode | undefined;
|
|
80
|
+
//# sourceMappingURL=doc-graph-builder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doc-graph-builder.d.ts","sourceRoot":"","sources":["../../src/panoramic/doc-graph-builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,352 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DocGraphBuilder
|
|
3
|
+
* 汇总当前批量生成的 ModuleSpec、既有 spec 文件以及文件级依赖图,
|
|
4
|
+
* 产出源码 -> spec -> 交叉引用 -> 缺口的统一图谱。
|
|
5
|
+
*/
|
|
6
|
+
import * as fs from 'node:fs';
|
|
7
|
+
import * as path from 'node:path';
|
|
8
|
+
export const MODULE_SPEC_ANCHOR_ID = 'module-spec';
|
|
9
|
+
export const CROSS_REFERENCE_MARKER_PREFIX = '<!-- cross-reference-index: auto';
|
|
10
|
+
/**
|
|
11
|
+
* 扫描输出目录下的既有 *.spec.md,仅提取 044 所需最小元数据。
|
|
12
|
+
*/
|
|
13
|
+
export function scanExistingSpecDocuments(specsDir, projectRoot) {
|
|
14
|
+
return scanStoredModuleSpecs(specsDir, projectRoot)
|
|
15
|
+
.map((summary) => ({
|
|
16
|
+
specPath: summary.specPath,
|
|
17
|
+
sourceTarget: summary.sourceTarget,
|
|
18
|
+
relatedFiles: summary.relatedFiles,
|
|
19
|
+
linked: summary.linked,
|
|
20
|
+
confidence: summary.confidence,
|
|
21
|
+
}))
|
|
22
|
+
.sort((a, b) => a.specPath.localeCompare(b.specPath));
|
|
23
|
+
}
|
|
24
|
+
export function scanStoredModuleSpecs(specsDir, projectRoot) {
|
|
25
|
+
if (!fs.existsSync(specsDir)) {
|
|
26
|
+
return [];
|
|
27
|
+
}
|
|
28
|
+
const specFiles = [];
|
|
29
|
+
walkSpecFiles(specsDir, specFiles);
|
|
30
|
+
return specFiles
|
|
31
|
+
.flatMap((filePath) => {
|
|
32
|
+
const content = fs.readFileSync(filePath, 'utf-8');
|
|
33
|
+
const metadata = extractStoredModuleSpecSummary(content);
|
|
34
|
+
if (!metadata) {
|
|
35
|
+
return [];
|
|
36
|
+
}
|
|
37
|
+
const document = {
|
|
38
|
+
specPath: normalizeProjectPath(filePath, projectRoot),
|
|
39
|
+
sourceTarget: normalizeProjectPath(metadata.sourceTarget, projectRoot),
|
|
40
|
+
relatedFiles: metadata.relatedFiles.map((item) => normalizeProjectPath(item, projectRoot)),
|
|
41
|
+
linked: content.includes(CROSS_REFERENCE_MARKER_PREFIX),
|
|
42
|
+
confidence: metadata.confidence,
|
|
43
|
+
version: metadata.version,
|
|
44
|
+
skeletonHash: metadata.skeletonHash,
|
|
45
|
+
language: metadata.language,
|
|
46
|
+
crossLanguageRefs: metadata.crossLanguageRefs?.map((item) => normalizeProjectPath(item, projectRoot)),
|
|
47
|
+
intentSummary: metadata.intentSummary,
|
|
48
|
+
outputPath: normalizeProjectPath(filePath, projectRoot),
|
|
49
|
+
};
|
|
50
|
+
return [document];
|
|
51
|
+
})
|
|
52
|
+
.sort((a, b) => a.specPath.localeCompare(b.specPath));
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* 构建统一 DocGraph。
|
|
56
|
+
*/
|
|
57
|
+
export function buildDocGraph(options) {
|
|
58
|
+
const { projectRoot, dependencyGraph } = options;
|
|
59
|
+
const currentSpecs = options.moduleSpecs.map((moduleSpec) => ({
|
|
60
|
+
specPath: normalizeProjectPath(moduleSpec.outputPath, projectRoot),
|
|
61
|
+
sourceTarget: normalizeProjectPath(moduleSpec.frontmatter.sourceTarget, projectRoot),
|
|
62
|
+
relatedFiles: dedupePaths(moduleSpec.frontmatter.relatedFiles.map((item) => normalizeProjectPath(item, projectRoot))),
|
|
63
|
+
linked: true,
|
|
64
|
+
confidence: moduleSpec.frontmatter.confidence,
|
|
65
|
+
currentRun: true,
|
|
66
|
+
}));
|
|
67
|
+
const specMap = new Map();
|
|
68
|
+
for (const spec of options.existingSpecs ?? []) {
|
|
69
|
+
specMap.set(spec.specPath, {
|
|
70
|
+
...spec,
|
|
71
|
+
relatedFiles: dedupePaths(spec.relatedFiles),
|
|
72
|
+
currentRun: false,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
for (const spec of currentSpecs) {
|
|
76
|
+
specMap.set(spec.specPath, spec);
|
|
77
|
+
}
|
|
78
|
+
const specs = [...specMap.values()].sort((a, b) => a.specPath.localeCompare(b.specPath));
|
|
79
|
+
const sourceToSpec = [];
|
|
80
|
+
const sourceToSpecKey = new Set();
|
|
81
|
+
for (const spec of specs) {
|
|
82
|
+
pushSourceToSpec(sourceToSpec, sourceToSpecKey, spec.sourceTarget, spec.specPath, spec.sourceTarget, 'source-target');
|
|
83
|
+
for (const relatedFile of spec.relatedFiles) {
|
|
84
|
+
pushSourceToSpec(sourceToSpec, sourceToSpecKey, relatedFile, spec.specPath, spec.sourceTarget, 'related-file');
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
const references = buildReferenceList(specs, dependencyGraph);
|
|
88
|
+
const missingSpecs = buildMissingSpecList(specs, dependencyGraph);
|
|
89
|
+
const unlinkedSpecs = specs
|
|
90
|
+
.filter((spec) => !spec.currentRun && !spec.linked)
|
|
91
|
+
.map((spec) => ({
|
|
92
|
+
specPath: spec.specPath,
|
|
93
|
+
sourceTarget: spec.sourceTarget,
|
|
94
|
+
}))
|
|
95
|
+
.sort((a, b) => a.specPath.localeCompare(b.specPath));
|
|
96
|
+
return {
|
|
97
|
+
projectRoot,
|
|
98
|
+
generatedAt: new Date().toISOString(),
|
|
99
|
+
specs,
|
|
100
|
+
sourceToSpec: sourceToSpec.sort((a, b) => {
|
|
101
|
+
const left = `${a.sourcePath}:${a.specPath}:${a.matchType}`;
|
|
102
|
+
const right = `${b.sourcePath}:${b.specPath}:${b.matchType}`;
|
|
103
|
+
return left.localeCompare(right);
|
|
104
|
+
}),
|
|
105
|
+
references,
|
|
106
|
+
missingSpecs,
|
|
107
|
+
unlinkedSpecs,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
function buildReferenceList(specs, dependencyGraph) {
|
|
111
|
+
const aggregated = new Map();
|
|
112
|
+
for (const edge of dependencyGraph.edges) {
|
|
113
|
+
const fromSpec = resolveSpecForSource(edge.from, specs);
|
|
114
|
+
const toSpec = resolveSpecForSource(edge.to, specs);
|
|
115
|
+
if (!fromSpec || !toSpec) {
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
const kind = fromSpec.specPath === toSpec.specPath ? 'same-module' : 'cross-module';
|
|
119
|
+
const key = `${kind}:${fromSpec.specPath}:${toSpec.specPath}`;
|
|
120
|
+
if (!aggregated.has(key)) {
|
|
121
|
+
aggregated.set(key, {
|
|
122
|
+
kind,
|
|
123
|
+
fromSpecPath: fromSpec.specPath,
|
|
124
|
+
toSpecPath: toSpec.specPath,
|
|
125
|
+
fromSourceTarget: fromSpec.sourceTarget,
|
|
126
|
+
toSourceTarget: toSpec.sourceTarget,
|
|
127
|
+
evidenceCount: 0,
|
|
128
|
+
evidenceSamples: [],
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
const entry = aggregated.get(key);
|
|
132
|
+
entry.evidenceCount += 1;
|
|
133
|
+
const duplicate = entry.evidenceSamples.some((sample) => sample.fromSource === edge.from && sample.toSource === edge.to);
|
|
134
|
+
if (!duplicate && entry.evidenceSamples.length < 5) {
|
|
135
|
+
entry.evidenceSamples.push({
|
|
136
|
+
fromSource: edge.from,
|
|
137
|
+
toSource: edge.to,
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
return [...aggregated.values()].sort((left, right) => {
|
|
142
|
+
if (right.evidenceCount !== left.evidenceCount) {
|
|
143
|
+
return right.evidenceCount - left.evidenceCount;
|
|
144
|
+
}
|
|
145
|
+
return `${left.fromSpecPath}:${left.toSpecPath}`.localeCompare(`${right.fromSpecPath}:${right.toSpecPath}`);
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
function buildMissingSpecList(specs, dependencyGraph) {
|
|
149
|
+
const missing = new Set();
|
|
150
|
+
for (const node of dependencyGraph.modules) {
|
|
151
|
+
if (!resolveSpecForSource(node.source, specs)) {
|
|
152
|
+
missing.add(node.source);
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
return [...missing]
|
|
156
|
+
.sort((a, b) => a.localeCompare(b))
|
|
157
|
+
.map((sourcePath) => ({
|
|
158
|
+
sourcePath,
|
|
159
|
+
reason: 'no-spec-owner',
|
|
160
|
+
}));
|
|
161
|
+
}
|
|
162
|
+
export function resolveSpecForSource(sourcePath, specs) {
|
|
163
|
+
let bestMatch;
|
|
164
|
+
for (const spec of specs) {
|
|
165
|
+
const exactSourceTarget = spec.sourceTarget === sourcePath;
|
|
166
|
+
const exactRelatedFile = spec.relatedFiles.includes(sourcePath);
|
|
167
|
+
const prefixMatch = sourcePath.startsWith(`${spec.sourceTarget}/`);
|
|
168
|
+
if (!exactSourceTarget && !exactRelatedFile && !prefixMatch) {
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
let score = spec.sourceTarget.length;
|
|
172
|
+
if (prefixMatch)
|
|
173
|
+
score += 1_000;
|
|
174
|
+
if (exactRelatedFile)
|
|
175
|
+
score += 2_000;
|
|
176
|
+
if (exactSourceTarget)
|
|
177
|
+
score += 3_000;
|
|
178
|
+
if (spec.currentRun)
|
|
179
|
+
score += 10;
|
|
180
|
+
if (!bestMatch || score > bestMatch.score) {
|
|
181
|
+
bestMatch = { spec, score };
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
return bestMatch?.spec;
|
|
185
|
+
}
|
|
186
|
+
function pushSourceToSpec(target, seen, sourcePath, specPath, sourceTarget, matchType) {
|
|
187
|
+
const key = `${sourcePath}:${specPath}:${matchType}`;
|
|
188
|
+
if (seen.has(key)) {
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
seen.add(key);
|
|
192
|
+
target.push({
|
|
193
|
+
sourcePath,
|
|
194
|
+
specPath,
|
|
195
|
+
sourceTarget,
|
|
196
|
+
matchType,
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
function extractModuleSpecMetadata(content) {
|
|
200
|
+
const summary = extractStoredModuleSpecSummary(content);
|
|
201
|
+
if (!summary) {
|
|
202
|
+
return null;
|
|
203
|
+
}
|
|
204
|
+
return {
|
|
205
|
+
sourceTarget: summary.sourceTarget,
|
|
206
|
+
relatedFiles: summary.relatedFiles,
|
|
207
|
+
confidence: summary.confidence,
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
function extractStoredModuleSpecSummary(content) {
|
|
211
|
+
const match = /^---\r?\n([\s\S]*?)\r?\n---/m.exec(content);
|
|
212
|
+
if (!match?.[1]) {
|
|
213
|
+
return null;
|
|
214
|
+
}
|
|
215
|
+
const lines = match[1].split(/\r?\n/);
|
|
216
|
+
let typeValue;
|
|
217
|
+
let sourceTarget;
|
|
218
|
+
let version;
|
|
219
|
+
let confidence;
|
|
220
|
+
let skeletonHash;
|
|
221
|
+
let language;
|
|
222
|
+
const relatedFiles = [];
|
|
223
|
+
const crossLanguageRefs = [];
|
|
224
|
+
let inRelatedFiles = false;
|
|
225
|
+
let inCrossLanguageRefs = false;
|
|
226
|
+
for (const rawLine of lines) {
|
|
227
|
+
const line = rawLine.trimEnd();
|
|
228
|
+
if (line.startsWith('type:')) {
|
|
229
|
+
typeValue = stripYamlScalar(line.slice('type:'.length).trim());
|
|
230
|
+
inRelatedFiles = false;
|
|
231
|
+
inCrossLanguageRefs = false;
|
|
232
|
+
continue;
|
|
233
|
+
}
|
|
234
|
+
if (line.startsWith('version:')) {
|
|
235
|
+
version = stripYamlScalar(line.slice('version:'.length).trim());
|
|
236
|
+
inRelatedFiles = false;
|
|
237
|
+
inCrossLanguageRefs = false;
|
|
238
|
+
continue;
|
|
239
|
+
}
|
|
240
|
+
if (line.startsWith('sourceTarget:')) {
|
|
241
|
+
sourceTarget = stripYamlScalar(line.slice('sourceTarget:'.length).trim());
|
|
242
|
+
inRelatedFiles = false;
|
|
243
|
+
inCrossLanguageRefs = false;
|
|
244
|
+
continue;
|
|
245
|
+
}
|
|
246
|
+
if (line.startsWith('confidence:')) {
|
|
247
|
+
const parsed = stripYamlScalar(line.slice('confidence:'.length).trim());
|
|
248
|
+
if (parsed === 'high' || parsed === 'medium' || parsed === 'low') {
|
|
249
|
+
confidence = parsed;
|
|
250
|
+
}
|
|
251
|
+
inRelatedFiles = false;
|
|
252
|
+
inCrossLanguageRefs = false;
|
|
253
|
+
continue;
|
|
254
|
+
}
|
|
255
|
+
if (line.startsWith('skeletonHash:')) {
|
|
256
|
+
skeletonHash = stripYamlScalar(line.slice('skeletonHash:'.length).trim());
|
|
257
|
+
inRelatedFiles = false;
|
|
258
|
+
inCrossLanguageRefs = false;
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
if (line.startsWith('language:')) {
|
|
262
|
+
language = stripYamlScalar(line.slice('language:'.length).trim());
|
|
263
|
+
inRelatedFiles = false;
|
|
264
|
+
inCrossLanguageRefs = false;
|
|
265
|
+
continue;
|
|
266
|
+
}
|
|
267
|
+
if (line === 'relatedFiles:') {
|
|
268
|
+
inRelatedFiles = true;
|
|
269
|
+
inCrossLanguageRefs = false;
|
|
270
|
+
continue;
|
|
271
|
+
}
|
|
272
|
+
if (line === 'crossLanguageRefs:') {
|
|
273
|
+
inCrossLanguageRefs = true;
|
|
274
|
+
inRelatedFiles = false;
|
|
275
|
+
continue;
|
|
276
|
+
}
|
|
277
|
+
if (inRelatedFiles) {
|
|
278
|
+
const trimmed = line.trim();
|
|
279
|
+
if (trimmed.startsWith('- ')) {
|
|
280
|
+
relatedFiles.push(stripYamlScalar(trimmed.slice(2).trim()));
|
|
281
|
+
continue;
|
|
282
|
+
}
|
|
283
|
+
inRelatedFiles = false;
|
|
284
|
+
}
|
|
285
|
+
if (inCrossLanguageRefs) {
|
|
286
|
+
const trimmed = line.trim();
|
|
287
|
+
if (trimmed.startsWith('- ')) {
|
|
288
|
+
crossLanguageRefs.push(stripYamlScalar(trimmed.slice(2).trim()));
|
|
289
|
+
continue;
|
|
290
|
+
}
|
|
291
|
+
inCrossLanguageRefs = false;
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
if (typeValue !== 'module-spec' || !sourceTarget) {
|
|
295
|
+
return null;
|
|
296
|
+
}
|
|
297
|
+
const intentSummary = extractIntentSummary(content, sourceTarget);
|
|
298
|
+
return {
|
|
299
|
+
sourceTarget,
|
|
300
|
+
relatedFiles,
|
|
301
|
+
confidence,
|
|
302
|
+
version,
|
|
303
|
+
skeletonHash,
|
|
304
|
+
language,
|
|
305
|
+
crossLanguageRefs: crossLanguageRefs.length > 0 ? crossLanguageRefs : undefined,
|
|
306
|
+
intentSummary,
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
function extractIntentSummary(content, sourceTarget) {
|
|
310
|
+
const match = /^##\s+1\.\s+意图\r?\n([\s\S]*?)(?=^##\s+\d+\.|\s*$)/m.exec(content);
|
|
311
|
+
if (!match?.[1]) {
|
|
312
|
+
return sourceTarget;
|
|
313
|
+
}
|
|
314
|
+
const firstMeaningfulLine = match[1]
|
|
315
|
+
.split(/\r?\n/)
|
|
316
|
+
.map((line) => line.trim())
|
|
317
|
+
.find((line) => line.length > 0);
|
|
318
|
+
return firstMeaningfulLine ?? sourceTarget;
|
|
319
|
+
}
|
|
320
|
+
function stripYamlScalar(value) {
|
|
321
|
+
if ((value.startsWith('"') && value.endsWith('"'))
|
|
322
|
+
|| (value.startsWith('\'') && value.endsWith('\''))) {
|
|
323
|
+
return value.slice(1, -1);
|
|
324
|
+
}
|
|
325
|
+
return value;
|
|
326
|
+
}
|
|
327
|
+
function walkSpecFiles(dir, results) {
|
|
328
|
+
const entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
329
|
+
for (const entry of entries) {
|
|
330
|
+
if (entry.isSymbolicLink()) {
|
|
331
|
+
continue;
|
|
332
|
+
}
|
|
333
|
+
const fullPath = path.join(dir, entry.name);
|
|
334
|
+
if (entry.isDirectory()) {
|
|
335
|
+
walkSpecFiles(fullPath, results);
|
|
336
|
+
continue;
|
|
337
|
+
}
|
|
338
|
+
if (entry.isFile() && entry.name.endsWith('.spec.md')) {
|
|
339
|
+
results.push(fullPath);
|
|
340
|
+
}
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
function dedupePaths(paths) {
|
|
344
|
+
return [...new Set(paths)].sort((a, b) => a.localeCompare(b));
|
|
345
|
+
}
|
|
346
|
+
function normalizeProjectPath(inputPath, projectRoot) {
|
|
347
|
+
const relative = path.isAbsolute(inputPath)
|
|
348
|
+
? path.relative(projectRoot, inputPath)
|
|
349
|
+
: inputPath;
|
|
350
|
+
return relative.split(path.sep).join('/');
|
|
351
|
+
}
|
|
352
|
+
//# sourceMappingURL=doc-graph-builder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doc-graph-builder.js","sourceRoot":"","sources":["../../src/panoramic/doc-graph-builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export interface BundleNavigationReference {
|
|
2
|
+
title: string;
|
|
3
|
+
path?: string;
|
|
4
|
+
children: BundleNavigationReference[];
|
|
5
|
+
}
|
|
6
|
+
export interface BundleProfileReference {
|
|
7
|
+
id: string;
|
|
8
|
+
title: string;
|
|
9
|
+
rootDir?: string;
|
|
10
|
+
docsRoot?: string;
|
|
11
|
+
landingPagePath?: string;
|
|
12
|
+
documentIds: string[];
|
|
13
|
+
navigation: BundleNavigationReference[];
|
|
14
|
+
}
|
|
15
|
+
export interface DocsBundleManifestReference {
|
|
16
|
+
sourcePath: string;
|
|
17
|
+
version?: number;
|
|
18
|
+
generatedAt?: string;
|
|
19
|
+
profiles: BundleProfileReference[];
|
|
20
|
+
}
|
|
21
|
+
export interface ReadDocsBundleManifestResult {
|
|
22
|
+
manifest?: DocsBundleManifestReference;
|
|
23
|
+
warnings: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare function readDocsBundleManifest(outputDir: string, projectRoot?: string): ReadDocsBundleManifestResult;
|
|
26
|
+
//# sourceMappingURL=docs-bundle-manifest-reader.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs-bundle-manifest-reader.d.ts","sourceRoot":"","sources":["../../src/panoramic/docs-bundle-manifest-reader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,4BAA4B,CAqC9B"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Docs bundle manifest reader
|
|
3
|
+
*
|
|
4
|
+
* 059 只做 055 manifest 的轻量读取与降级,不重做 bundle orchestration。
|
|
5
|
+
*/
|
|
6
|
+
import * as fs from 'node:fs';
|
|
7
|
+
import * as path from 'node:path';
|
|
8
|
+
import { parseYamlDocument, } from './parsers/yaml-config-parser.js';
|
|
9
|
+
const CANDIDATE_MANIFEST_NAMES = ['docs-bundle.yaml', 'docs-bundle.yml'];
|
|
10
|
+
export function readDocsBundleManifest(outputDir, projectRoot) {
|
|
11
|
+
const warnings = [];
|
|
12
|
+
const manifestPath = CANDIDATE_MANIFEST_NAMES
|
|
13
|
+
.map((fileName) => path.join(outputDir, fileName))
|
|
14
|
+
.find((candidatePath) => fs.existsSync(candidatePath));
|
|
15
|
+
if (!manifestPath) {
|
|
16
|
+
return {
|
|
17
|
+
manifest: undefined,
|
|
18
|
+
warnings: ['未找到 docs-bundle manifest,将以 partial 模式降级 required-doc 的发布覆盖校验。'],
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
try {
|
|
22
|
+
const parsed = parseYamlDocument(fs.readFileSync(manifestPath, 'utf-8'));
|
|
23
|
+
const profiles = readProfileReferences(parsed.profiles);
|
|
24
|
+
if (profiles.length === 0) {
|
|
25
|
+
warnings.push('docs-bundle manifest 已存在,但未解析到有效 profile。');
|
|
26
|
+
}
|
|
27
|
+
return {
|
|
28
|
+
manifest: {
|
|
29
|
+
sourcePath: normalizeProjectPath(manifestPath, projectRoot),
|
|
30
|
+
version: asNumber(parsed.version),
|
|
31
|
+
generatedAt: asString(parsed.generatedAt),
|
|
32
|
+
profiles,
|
|
33
|
+
},
|
|
34
|
+
warnings,
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
catch (error) {
|
|
38
|
+
return {
|
|
39
|
+
manifest: undefined,
|
|
40
|
+
warnings: [`docs-bundle manifest 读取失败: ${String(error)}`],
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
function readProfileReferences(value) {
|
|
45
|
+
if (!Array.isArray(value)) {
|
|
46
|
+
return [];
|
|
47
|
+
}
|
|
48
|
+
return value
|
|
49
|
+
.map((entry) => (isYamlObject(entry) ? entry : undefined))
|
|
50
|
+
.filter((entry) => Boolean(entry))
|
|
51
|
+
.map((entry) => ({
|
|
52
|
+
id: asString(entry.id) ?? 'unknown',
|
|
53
|
+
title: asString(entry.title) ?? asString(entry.id) ?? 'Unknown Profile',
|
|
54
|
+
rootDir: asString(entry.rootDir),
|
|
55
|
+
docsRoot: asString(entry.docsRoot),
|
|
56
|
+
landingPagePath: asString(entry.landingPagePath),
|
|
57
|
+
documentIds: readDocumentIds(entry.documents),
|
|
58
|
+
navigation: readNavigation(entry.navigation),
|
|
59
|
+
}));
|
|
60
|
+
}
|
|
61
|
+
function readDocumentIds(value) {
|
|
62
|
+
if (!Array.isArray(value)) {
|
|
63
|
+
return [];
|
|
64
|
+
}
|
|
65
|
+
return value
|
|
66
|
+
.map((entry) => (isYamlObject(entry) ? asString(entry.sourceId) : undefined))
|
|
67
|
+
.filter((entry) => Boolean(entry))
|
|
68
|
+
.sort((left, right) => left.localeCompare(right));
|
|
69
|
+
}
|
|
70
|
+
function readNavigation(value) {
|
|
71
|
+
if (!Array.isArray(value)) {
|
|
72
|
+
return [];
|
|
73
|
+
}
|
|
74
|
+
return value
|
|
75
|
+
.map((entry) => readNavigationNode(entry))
|
|
76
|
+
.filter((entry) => Boolean(entry));
|
|
77
|
+
}
|
|
78
|
+
function readNavigationNode(value) {
|
|
79
|
+
if (!isYamlObject(value)) {
|
|
80
|
+
return undefined;
|
|
81
|
+
}
|
|
82
|
+
return {
|
|
83
|
+
title: asString(value.title) ?? 'Untitled',
|
|
84
|
+
path: asString(value.path),
|
|
85
|
+
children: readNavigation(value.children),
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
function asString(value) {
|
|
89
|
+
return typeof value === 'string' ? value : undefined;
|
|
90
|
+
}
|
|
91
|
+
function asNumber(value) {
|
|
92
|
+
return typeof value === 'number' ? value : undefined;
|
|
93
|
+
}
|
|
94
|
+
function isYamlObject(value) {
|
|
95
|
+
return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
|
|
96
|
+
}
|
|
97
|
+
function normalizeProjectPath(candidatePath, projectRoot) {
|
|
98
|
+
if (!projectRoot) {
|
|
99
|
+
return candidatePath.split(path.sep).join('/');
|
|
100
|
+
}
|
|
101
|
+
const relative = path.relative(projectRoot, candidatePath);
|
|
102
|
+
return relative.startsWith('..')
|
|
103
|
+
? candidatePath.split(path.sep).join('/')
|
|
104
|
+
: relative.split(path.sep).join('/');
|
|
105
|
+
}
|
|
106
|
+
//# sourceMappingURL=docs-bundle-manifest-reader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs-bundle-manifest-reader.js","sourceRoot":"","sources":["../../src/panoramic/docs-bundle-manifest-reader.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { type DocsBundleInput, type DocsBundleResult } from './docs-bundle-types.js';
|
|
2
|
+
interface OrchestratorPaths {
|
|
3
|
+
projectRoot: string;
|
|
4
|
+
outputDir: string;
|
|
5
|
+
outputDirRelative: string;
|
|
6
|
+
}
|
|
7
|
+
export interface OrchestrateDocsBundleOptions {
|
|
8
|
+
projectRoot: string;
|
|
9
|
+
outputDir: string;
|
|
10
|
+
}
|
|
11
|
+
export declare function orchestrateDocsBundle(options: OrchestrateDocsBundleOptions): DocsBundleResult;
|
|
12
|
+
export declare function buildDocsBundleInput(paths: OrchestratorPaths): DocsBundleInput;
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=docs-bundle-orchestrator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs-bundle-orchestrator.d.ts","sourceRoot":"","sources":["../../src/panoramic/docs-bundle-orchestrator.ts"],"names":[],"mappings":"AASA,OAAO,EAQL,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EAGtB,MAAM,wBAAwB,CAAC;AA2GhC,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAYD,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,gBAAgB,CAgClB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,CAY9E"}
|