spectra-cli 4.2.0 → 4.3.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 +12 -5
- package/dist/.spectra-build-meta.json +9 -0
- package/dist/adapters/language-adapter.d.ts +7 -12
- package/dist/adapters/language-adapter.d.ts.map +1 -1
- package/dist/adapters/python-adapter.d.ts.map +1 -1
- package/dist/adapters/python-adapter.js +11 -2
- package/dist/adapters/python-adapter.js.map +1 -1
- package/dist/batch/batch-orchestrator.d.ts +44 -1
- package/dist/batch/batch-orchestrator.d.ts.map +1 -1
- package/dist/batch/batch-orchestrator.js +312 -76
- package/dist/batch/batch-orchestrator.js.map +1 -1
- package/dist/batch/delta-regenerator.d.ts.map +1 -1
- package/dist/batch/delta-regenerator.js +21 -28
- package/dist/batch/delta-regenerator.js.map +1 -1
- package/dist/batch/module-grouper.d.ts +7 -0
- package/dist/batch/module-grouper.d.ts.map +1 -1
- package/dist/batch/module-grouper.js +2 -0
- package/dist/batch/module-grouper.js.map +1 -1
- package/dist/batch/regen-plan.d.ts +78 -0
- package/dist/batch/regen-plan.d.ts.map +1 -0
- package/dist/batch/regen-plan.js +93 -0
- package/dist/batch/regen-plan.js.map +1 -0
- package/dist/cli/commands/batch.d.ts.map +1 -1
- package/dist/cli/commands/batch.js +36 -8
- package/dist/cli/commands/batch.js.map +1 -1
- package/dist/cli/commands/scaffold-kb.d.ts +9 -0
- package/dist/cli/commands/scaffold-kb.d.ts.map +1 -0
- package/dist/cli/commands/scaffold-kb.js +179 -0
- package/dist/cli/commands/scaffold-kb.js.map +1 -0
- package/dist/cli/index.js +24 -5
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/utils/error-handler.d.ts +0 -6
- package/dist/cli/utils/error-handler.d.ts.map +1 -1
- package/dist/cli/utils/error-handler.js +0 -13
- package/dist/cli/utils/error-handler.js.map +1 -1
- package/dist/cli/utils/parse-args.d.ts +43 -3
- package/dist/cli/utils/parse-args.d.ts.map +1 -1
- package/dist/cli/utils/parse-args.js +98 -12
- package/dist/cli/utils/parse-args.js.map +1 -1
- package/dist/cli/version-meta.d.ts +16 -0
- package/dist/cli/version-meta.d.ts.map +1 -0
- package/dist/cli/version-meta.js +28 -0
- package/dist/cli/version-meta.js.map +1 -0
- package/dist/core/ast-analyzer.d.ts.map +1 -1
- package/dist/core/ast-analyzer.js +7 -11
- package/dist/core/ast-analyzer.js.map +1 -1
- package/dist/core/import-resolver.d.ts +70 -67
- package/dist/core/import-resolver.d.ts.map +1 -1
- package/dist/core/import-resolver.js +341 -200
- package/dist/core/import-resolver.js.map +1 -1
- package/dist/core/single-spec-orchestrator.d.ts +21 -0
- package/dist/core/single-spec-orchestrator.d.ts.map +1 -1
- package/dist/core/single-spec-orchestrator.js +41 -14
- package/dist/core/single-spec-orchestrator.js.map +1 -1
- package/dist/core/skeleton-hash.d.ts +33 -0
- package/dist/core/skeleton-hash.d.ts.map +1 -0
- package/dist/core/skeleton-hash.js +76 -0
- package/dist/core/skeleton-hash.js.map +1 -0
- package/dist/core/tree-sitter-analyzer.d.ts +3 -2
- package/dist/core/tree-sitter-analyzer.d.ts.map +1 -1
- package/dist/core/tree-sitter-analyzer.js +5 -6
- package/dist/core/tree-sitter-analyzer.js.map +1 -1
- package/dist/core/tree-sitter-fallback.d.ts +7 -2
- package/dist/core/tree-sitter-fallback.d.ts.map +1 -1
- package/dist/core/tree-sitter-fallback.js +18 -15
- package/dist/core/tree-sitter-fallback.js.map +1 -1
- package/dist/extraction/image-extractor.d.ts.map +1 -1
- package/dist/extraction/image-extractor.js +3 -1
- package/dist/extraction/image-extractor.js.map +1 -1
- package/dist/extraction/markdown-extractor.d.ts.map +1 -1
- package/dist/extraction/markdown-extractor.js +3 -1
- package/dist/extraction/markdown-extractor.js.map +1 -1
- package/dist/generator/frontmatter.d.ts +5 -0
- package/dist/generator/frontmatter.d.ts.map +1 -1
- package/dist/generator/frontmatter.js +4 -0
- package/dist/generator/frontmatter.js.map +1 -1
- package/dist/kb-mcp/index.d.ts +14 -0
- package/dist/kb-mcp/index.d.ts.map +1 -0
- package/dist/kb-mcp/index.js +24 -0
- package/dist/kb-mcp/index.js.map +1 -0
- package/dist/kb-mcp/lib/kb-error.d.ts +21 -0
- package/dist/kb-mcp/lib/kb-error.d.ts.map +1 -0
- package/dist/kb-mcp/lib/kb-error.js +28 -0
- package/dist/kb-mcp/lib/kb-error.js.map +1 -0
- package/dist/kb-mcp/lib/kb-locator.d.ts +58 -0
- package/dist/kb-mcp/lib/kb-locator.d.ts.map +1 -0
- package/dist/kb-mcp/lib/kb-locator.js +85 -0
- package/dist/kb-mcp/lib/kb-locator.js.map +1 -0
- package/dist/kb-mcp/lib/result-merger.d.ts +35 -0
- package/dist/kb-mcp/lib/result-merger.d.ts.map +1 -0
- package/dist/kb-mcp/lib/result-merger.js +64 -0
- package/dist/kb-mcp/lib/result-merger.js.map +1 -0
- package/dist/kb-mcp/server.d.ts +12 -0
- package/dist/kb-mcp/server.d.ts.map +1 -0
- package/dist/kb-mcp/server.js +29 -0
- package/dist/kb-mcp/server.js.map +1 -0
- package/dist/kb-mcp/tools/kb-api-lookup.d.ts +28 -0
- package/dist/kb-mcp/tools/kb-api-lookup.d.ts.map +1 -0
- package/dist/kb-mcp/tools/kb-api-lookup.js +237 -0
- package/dist/kb-mcp/tools/kb-api-lookup.js.map +1 -0
- package/dist/kb-mcp/tools/kb-doc-lookup.d.ts +20 -0
- package/dist/kb-mcp/tools/kb-doc-lookup.d.ts.map +1 -0
- package/dist/kb-mcp/tools/kb-doc-lookup.js +92 -0
- package/dist/kb-mcp/tools/kb-doc-lookup.js.map +1 -0
- package/dist/kb-mcp/tools/kb-search.d.ts +23 -0
- package/dist/kb-mcp/tools/kb-search.d.ts.map +1 -0
- package/dist/kb-mcp/tools/kb-search.js +126 -0
- package/dist/kb-mcp/tools/kb-search.js.map +1 -0
- package/dist/knowledge-graph/import-resolver.d.ts +11 -86
- package/dist/knowledge-graph/import-resolver.d.ts.map +1 -1
- package/dist/knowledge-graph/import-resolver.js +10 -333
- package/dist/knowledge-graph/import-resolver.js.map +1 -1
- package/dist/knowledge-graph/incremental.d.ts +25 -4
- package/dist/knowledge-graph/incremental.d.ts.map +1 -1
- package/dist/knowledge-graph/incremental.js +37 -15
- package/dist/knowledge-graph/incremental.js.map +1 -1
- package/dist/knowledge-graph/index.d.ts +11 -0
- package/dist/knowledge-graph/index.d.ts.map +1 -1
- package/dist/knowledge-graph/index.js +43 -1
- package/dist/knowledge-graph/index.js.map +1 -1
- package/dist/knowledge-graph/module-derivation.d.ts +14 -0
- package/dist/knowledge-graph/module-derivation.d.ts.map +1 -1
- package/dist/knowledge-graph/module-derivation.js +44 -44
- package/dist/knowledge-graph/module-derivation.js.map +1 -1
- package/dist/knowledge-graph/persistence.d.ts +56 -16
- package/dist/knowledge-graph/persistence.d.ts.map +1 -1
- package/dist/knowledge-graph/persistence.js +86 -32
- package/dist/knowledge-graph/persistence.js.map +1 -1
- package/dist/knowledge-graph/query-helpers.d.ts +39 -12
- package/dist/knowledge-graph/query-helpers.d.ts.map +1 -1
- package/dist/knowledge-graph/query-helpers.js +199 -34
- package/dist/knowledge-graph/query-helpers.js.map +1 -1
- package/dist/knowledge-graph/relativize.d.ts +51 -0
- package/dist/knowledge-graph/relativize.d.ts.map +1 -0
- package/dist/knowledge-graph/relativize.js +104 -0
- package/dist/knowledge-graph/relativize.js.map +1 -0
- package/dist/mcp/agent-context-tools.d.ts +3 -54
- package/dist/mcp/agent-context-tools.d.ts.map +1 -1
- package/dist/mcp/agent-context-tools.js +141 -189
- package/dist/mcp/agent-context-tools.js.map +1 -1
- package/dist/mcp/file-nav-tools.d.ts +42 -0
- package/dist/mcp/file-nav-tools.d.ts.map +1 -0
- package/dist/mcp/file-nav-tools.js +318 -0
- package/dist/mcp/file-nav-tools.js.map +1 -0
- package/dist/mcp/graph-tools.d.ts +2 -0
- package/dist/mcp/graph-tools.d.ts.map +1 -1
- package/dist/mcp/graph-tools.js +134 -123
- package/dist/mcp/graph-tools.js.map +1 -1
- package/dist/mcp/lib/file-nav-helpers.d.ts +128 -0
- package/dist/mcp/lib/file-nav-helpers.d.ts.map +1 -0
- package/dist/mcp/lib/file-nav-helpers.js +305 -0
- package/dist/mcp/lib/file-nav-helpers.js.map +1 -0
- package/dist/mcp/lib/telemetry.d.ts +69 -0
- package/dist/mcp/lib/telemetry.d.ts.map +1 -0
- package/dist/mcp/lib/telemetry.js +113 -0
- package/dist/mcp/lib/telemetry.js.map +1 -0
- package/dist/mcp/lib/tool-response.d.ts +46 -0
- package/dist/mcp/lib/tool-response.d.ts.map +1 -0
- package/dist/mcp/lib/tool-response.js +83 -0
- package/dist/mcp/lib/tool-response.js.map +1 -0
- package/dist/mcp/server.d.ts +13 -2
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +209 -150
- package/dist/mcp/server.js.map +1 -1
- package/dist/models/code-skeleton.d.ts +4 -2
- package/dist/models/code-skeleton.d.ts.map +1 -1
- package/dist/models/code-skeleton.js +2 -1
- package/dist/models/code-skeleton.js.map +1 -1
- package/dist/models/module-spec.d.ts +18 -0
- package/dist/models/module-spec.d.ts.map +1 -1
- package/dist/models/module-spec.js +6 -0
- package/dist/models/module-spec.js.map +1 -1
- package/dist/panoramic/builders/doc-graph-builder.d.ts +13 -0
- package/dist/panoramic/builders/doc-graph-builder.d.ts.map +1 -1
- package/dist/panoramic/builders/doc-graph-builder.js +20 -0
- package/dist/panoramic/builders/doc-graph-builder.js.map +1 -1
- package/dist/panoramic/graph/graph-builder.d.ts +72 -2
- package/dist/panoramic/graph/graph-builder.d.ts.map +1 -1
- package/dist/panoramic/graph/graph-builder.js +257 -51
- package/dist/panoramic/graph/graph-builder.js.map +1 -1
- package/dist/panoramic/graph/graph-query.d.ts +16 -0
- package/dist/panoramic/graph/graph-query.d.ts.map +1 -1
- package/dist/panoramic/graph/graph-query.js +49 -1
- package/dist/panoramic/graph/graph-query.js.map +1 -1
- package/dist/panoramic/graph/index.d.ts +2 -1
- package/dist/panoramic/graph/index.d.ts.map +1 -1
- package/dist/panoramic/graph/index.js +1 -1
- package/dist/panoramic/graph/index.js.map +1 -1
- package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts.map +1 -1
- package/dist/panoramic/pipelines/adr-evidence-verifier.js +1 -29
- package/dist/panoramic/pipelines/adr-evidence-verifier.js.map +1 -1
- package/dist/panoramic/query.d.ts +1 -0
- package/dist/panoramic/query.d.ts.map +1 -1
- package/dist/panoramic/query.js +5 -0
- package/dist/panoramic/query.js.map +1 -1
- package/dist/scaffold-kb/api-entities-serializer.d.ts +12 -0
- package/dist/scaffold-kb/api-entities-serializer.d.ts.map +1 -0
- package/dist/scaffold-kb/api-entities-serializer.js +144 -0
- package/dist/scaffold-kb/api-entities-serializer.js.map +1 -0
- package/dist/scaffold-kb/arbitration.d.ts +44 -0
- package/dist/scaffold-kb/arbitration.d.ts.map +1 -0
- package/dist/scaffold-kb/arbitration.js +144 -0
- package/dist/scaffold-kb/arbitration.js.map +1 -0
- package/dist/scaffold-kb/chunk-splitter.d.ts +20 -0
- package/dist/scaffold-kb/chunk-splitter.d.ts.map +1 -0
- package/dist/scaffold-kb/chunk-splitter.js +309 -0
- package/dist/scaffold-kb/chunk-splitter.js.map +1 -0
- package/dist/scaffold-kb/doc-graph-builder.d.ts +26 -0
- package/dist/scaffold-kb/doc-graph-builder.d.ts.map +1 -0
- package/dist/scaffold-kb/doc-graph-builder.js +72 -0
- package/dist/scaffold-kb/doc-graph-builder.js.map +1 -0
- package/dist/scaffold-kb/entity-extractor.d.ts +40 -0
- package/dist/scaffold-kb/entity-extractor.d.ts.map +1 -0
- package/dist/scaffold-kb/entity-extractor.js +0 -0
- package/dist/scaffold-kb/entity-extractor.js.map +1 -0
- package/dist/scaffold-kb/entity-heuristic.d.ts +14 -0
- package/dist/scaffold-kb/entity-heuristic.d.ts.map +1 -0
- package/dist/scaffold-kb/entity-heuristic.js +107 -0
- package/dist/scaffold-kb/entity-heuristic.js.map +1 -0
- package/dist/scaffold-kb/entity-matcher.d.ts +20 -0
- package/dist/scaffold-kb/entity-matcher.d.ts.map +1 -0
- package/dist/scaffold-kb/entity-matcher.js +53 -0
- package/dist/scaffold-kb/entity-matcher.js.map +1 -0
- package/dist/scaffold-kb/entity-util.d.ts +11 -0
- package/dist/scaffold-kb/entity-util.d.ts.map +1 -0
- package/dist/scaffold-kb/entity-util.js +23 -0
- package/dist/scaffold-kb/entity-util.js.map +1 -0
- package/dist/scaffold-kb/evidence-envelope.d.ts +17 -0
- package/dist/scaffold-kb/evidence-envelope.d.ts.map +1 -0
- package/dist/scaffold-kb/evidence-envelope.js +32 -0
- package/dist/scaffold-kb/evidence-envelope.js.map +1 -0
- package/dist/scaffold-kb/index.d.ts +20 -0
- package/dist/scaffold-kb/index.d.ts.map +1 -0
- package/dist/scaffold-kb/index.js +102 -0
- package/dist/scaffold-kb/index.js.map +1 -0
- package/dist/scaffold-kb/ingest/ingest-core.d.ts +47 -0
- package/dist/scaffold-kb/ingest/ingest-core.d.ts.map +1 -0
- package/dist/scaffold-kb/ingest/ingest-core.js +231 -0
- package/dist/scaffold-kb/ingest/ingest-core.js.map +1 -0
- package/dist/scaffold-kb/ingest/office-parser.d.ts +33 -0
- package/dist/scaffold-kb/ingest/office-parser.d.ts.map +1 -0
- package/dist/scaffold-kb/ingest/office-parser.js +187 -0
- package/dist/scaffold-kb/ingest/office-parser.js.map +1 -0
- package/dist/scaffold-kb/ingest/url-fetcher.d.ts +43 -0
- package/dist/scaffold-kb/ingest/url-fetcher.d.ts.map +1 -0
- package/dist/scaffold-kb/ingest/url-fetcher.js +245 -0
- package/dist/scaffold-kb/ingest/url-fetcher.js.map +1 -0
- package/dist/scaffold-kb/ingester.d.ts +38 -0
- package/dist/scaffold-kb/ingester.d.ts.map +1 -0
- package/dist/scaffold-kb/ingester.js +261 -0
- package/dist/scaffold-kb/ingester.js.map +1 -0
- package/dist/scaffold-kb/injection-format.d.ts +25 -0
- package/dist/scaffold-kb/injection-format.d.ts.map +1 -0
- package/dist/scaffold-kb/injection-format.js +55 -0
- package/dist/scaffold-kb/injection-format.js.map +1 -0
- package/dist/scaffold-kb/kb-writer.d.ts +13 -0
- package/dist/scaffold-kb/kb-writer.d.ts.map +1 -0
- package/dist/scaffold-kb/kb-writer.js +69 -0
- package/dist/scaffold-kb/kb-writer.js.map +1 -0
- package/dist/scaffold-kb/keyword-extract.d.ts +16 -0
- package/dist/scaffold-kb/keyword-extract.d.ts.map +1 -0
- package/dist/scaffold-kb/keyword-extract.js +49 -0
- package/dist/scaffold-kb/keyword-extract.js.map +1 -0
- package/dist/scaffold-kb/query-sanitizer.d.ts +28 -0
- package/dist/scaffold-kb/query-sanitizer.d.ts.map +1 -0
- package/dist/scaffold-kb/query-sanitizer.js +38 -0
- package/dist/scaffold-kb/query-sanitizer.js.map +1 -0
- package/dist/scaffold-kb/recall-eval.d.ts +48 -0
- package/dist/scaffold-kb/recall-eval.d.ts.map +1 -0
- package/dist/scaffold-kb/recall-eval.js +55 -0
- package/dist/scaffold-kb/recall-eval.js.map +1 -0
- package/dist/scaffold-kb/schema-compat.d.ts +22 -0
- package/dist/scaffold-kb/schema-compat.d.ts.map +1 -0
- package/dist/scaffold-kb/schema-compat.js +32 -0
- package/dist/scaffold-kb/schema-compat.js.map +1 -0
- package/dist/scaffold-kb/search-core.d.ts +42 -0
- package/dist/scaffold-kb/search-core.d.ts.map +1 -0
- package/dist/scaffold-kb/search-core.js +89 -0
- package/dist/scaffold-kb/search-core.js.map +1 -0
- package/dist/scaffold-kb/sqlite-engine.d.ts +58 -0
- package/dist/scaffold-kb/sqlite-engine.d.ts.map +1 -0
- package/dist/scaffold-kb/sqlite-engine.js +61 -0
- package/dist/scaffold-kb/sqlite-engine.js.map +1 -0
- package/dist/scaffold-kb/sqlite-writer.d.ts +18 -0
- package/dist/scaffold-kb/sqlite-writer.d.ts.map +1 -0
- package/dist/scaffold-kb/sqlite-writer.js +76 -0
- package/dist/scaffold-kb/sqlite-writer.js.map +1 -0
- package/dist/scaffold-kb/tokenizer.d.ts +26 -0
- package/dist/scaffold-kb/tokenizer.d.ts.map +1 -0
- package/dist/scaffold-kb/tokenizer.js +97 -0
- package/dist/scaffold-kb/tokenizer.js.map +1 -0
- package/dist/scaffold-kb/types.d.ts +157 -0
- package/dist/scaffold-kb/types.d.ts.map +1 -0
- package/dist/scaffold-kb/types.js +5 -0
- package/dist/scaffold-kb/types.js.map +1 -0
- package/dist/utils/file-scanner.d.ts +15 -0
- package/dist/utils/file-scanner.d.ts.map +1 -1
- package/dist/utils/file-scanner.js +17 -0
- package/dist/utils/file-scanner.js.map +1 -1
- package/dist/utils/string-distance.d.ts +20 -0
- package/dist/utils/string-distance.d.ts.map +1 -0
- package/dist/utils/string-distance.js +38 -0
- package/dist/utils/string-distance.js.map +1 -0
- package/package.json +11 -2
- package/plugins/demo-kb-en/.claude-plugin/plugin.json +11 -0
- package/plugins/demo-kb-en/.mcp.json +8 -0
- package/plugins/demo-kb-en/FIXTURE.json +23 -0
- package/plugins/demo-kb-en/FIXTURE.md +53 -0
- package/plugins/demo-kb-en/ingest-samples/meeting-notes.md +13 -0
- package/plugins/demo-kb-en/kb/api-entities.json +3445 -0
- package/plugins/demo-kb-en/kb/chunks.sqlite +0 -0
- package/plugins/demo-kb-en/kb/doc-graph.json +113 -0
- package/plugins/demo-kb-zh/.claude-plugin/plugin.json +11 -0
- package/plugins/demo-kb-zh/.mcp.json +8 -0
- package/plugins/demo-kb-zh/FIXTURE.json +23 -0
- package/plugins/demo-kb-zh/FIXTURE.md +63 -0
- package/plugins/demo-kb-zh/ingest-samples/meeting-notes.md +13 -0
- package/plugins/demo-kb-zh/kb/api-entities.json +990 -0
- package/plugins/demo-kb-zh/kb/chunks.sqlite +0 -0
- package/plugins/demo-kb-zh/kb/doc-graph.json +113 -0
- package/plugins/spec-driver/.claude-plugin/plugin.json +1 -1
- package/plugins/spec-driver/README.md +33 -1
- package/plugins/spec-driver/agents/verify.md +88 -0
- package/plugins/spec-driver/config/orchestration.yaml +39 -31
- package/plugins/spec-driver/contracts/orchestration-overrides-contract.yaml +27 -0
- package/plugins/spec-driver/contracts/orchestration-schema.mjs +272 -227
- package/plugins/spec-driver/contracts/wrapper-source-of-truth.yaml +3 -0
- package/plugins/spec-driver/hooks/hooks.json +9 -0
- package/plugins/spec-driver/hooks/stop-fix-compliance-check.sh +36 -0
- package/plugins/spec-driver/lib/delegation-contract.mjs +84 -0
- package/plugins/spec-driver/lib/orchestration-resolver.mjs +49 -0
- package/plugins/spec-driver/lib/orchestrator.mjs +29 -1
- package/plugins/spec-driver/scripts/codex-skills.sh +28 -28
- package/plugins/spec-driver/scripts/dev/spike-fix-compliance-e2e.mjs +130 -0
- package/plugins/spec-driver/scripts/fix-compliance-judge.mjs +415 -0
- package/plugins/spec-driver/scripts/generate-adoption-insights.mjs +48 -1
- package/plugins/spec-driver/scripts/goal-loop-cli.mjs +307 -0
- package/plugins/spec-driver/scripts/init-project.sh +56 -0
- package/plugins/spec-driver/scripts/kb-prequery.mjs +125 -0
- package/plugins/spec-driver/scripts/lib/config-schema.mjs +200 -94
- package/plugins/spec-driver/scripts/lib/ensure-gitignore.sh +277 -0
- package/plugins/spec-driver/scripts/lib/extract-wrapper-body.mjs +136 -0
- package/plugins/spec-driver/scripts/lib/fix-compliance-core.mjs +434 -0
- package/plugins/spec-driver/scripts/lib/fix-compliance-io.mjs +335 -0
- package/plugins/spec-driver/scripts/lib/goal-loop-core.mjs +783 -0
- package/plugins/spec-driver/scripts/lib/init-project-output.sh +28 -0
- package/plugins/spec-driver/scripts/lib/load-zod.mjs +62 -0
- package/plugins/spec-driver/scripts/lib/project-profile-resolver.mjs +141 -49
- package/plugins/spec-driver/scripts/lib/project-profile-schema.mjs +88 -54
- package/plugins/spec-driver/scripts/postinstall.sh +13 -1
- package/plugins/spec-driver/scripts/record-workflow-run.mjs +75 -0
- package/plugins/spec-driver/scripts/sync-delegation-contract.mjs +187 -0
- package/plugins/spec-driver/scripts/validate-orchestrator-models.mjs +156 -0
- package/plugins/spec-driver/scripts/validate-wrapper-sources.mjs +46 -1
- package/plugins/spec-driver/skills/spec-driver-feature/SKILL.md +292 -0
- package/plugins/spec-driver/skills/spec-driver-fix/SKILL.md +87 -8
- package/plugins/spec-driver/skills/spec-driver-implement/SKILL.md +8 -0
- package/plugins/spec-driver/skills/spec-driver-resume/SKILL.md +12 -1
- package/plugins/spec-driver/skills/spec-driver-story/SKILL.md +20 -0
- package/plugins/spec-driver/templates/delegation-contract.md +27 -0
- package/plugins/spec-driver/templates/goal-loop-override-template.yaml +284 -0
- package/plugins/spec-driver/templates/specify-base/project-context-template.yaml +10 -0
- package/plugins/spectra/.claude-plugin/plugin.json +1 -1
- package/plugins/spectra/README.md +1 -1
- package/templates/module-spec.hbs +1 -0
package/dist/mcp/server.d.ts
CHANGED
|
@@ -1,10 +1,21 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* MCP Server 定义
|
|
3
|
-
* 注册
|
|
4
|
-
* 6 个 graph 查询工具 + 3 个 agent-context 工具 impact / context / detect_changes
|
|
3
|
+
* 注册 17 个工具(prepare、generate、batch、diff、panoramic-query +
|
|
4
|
+
* 6 个 graph 查询工具 + 3 个 agent-context 工具 impact / context / detect_changes +
|
|
5
|
+
* 3 个 file-navigation 工具 view_file / search_in_file / list_directory)
|
|
5
6
|
* 供 Claude Code 通过 MCP 协议调用。
|
|
6
7
|
*/
|
|
7
8
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
9
|
+
/**
|
|
10
|
+
* MCP server 级 instructions(F184 FR-002):经 SDK `ServerOptions` 注入 initialize result,
|
|
11
|
+
* 给 driver / 子代理在无明确指令时一份工具分组导览 + 典型链路 + 恢复流,提升 MCP 工具采用率。
|
|
12
|
+
*
|
|
13
|
+
* 约束:
|
|
14
|
+
* - 控制在 ≤1600 字符(server 级一次性导览,避免上下文膨胀;F184 Codex Plan W-004)
|
|
15
|
+
* - 不硬编码工具总数(用分组描述,降工具增减时的漂移;新增/删除工具时同步本文)
|
|
16
|
+
* - 必含典型链路串 `detect_changes → impact → context → view_file` 与 `graph-not-built` 恢复流
|
|
17
|
+
*/
|
|
18
|
+
export declare const TOOL_GUIDE: string;
|
|
8
19
|
/**
|
|
9
20
|
* 创建并配置 MCP Server 实例
|
|
10
21
|
*/
|
package/dist/mcp/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBpE;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAWX,CAAC;AAEb;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAuS3C"}
|
package/dist/mcp/server.js
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* MCP Server 定义
|
|
3
|
-
* 注册
|
|
4
|
-
* 6 个 graph 查询工具 + 3 个 agent-context 工具 impact / context / detect_changes
|
|
3
|
+
* 注册 17 个工具(prepare、generate、batch、diff、panoramic-query +
|
|
4
|
+
* 6 个 graph 查询工具 + 3 个 agent-context 工具 impact / context / detect_changes +
|
|
5
|
+
* 3 个 file-navigation 工具 view_file / search_in_file / list_directory)
|
|
5
6
|
* 供 Claude Code 通过 MCP 协议调用。
|
|
6
7
|
*/
|
|
7
8
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
8
9
|
import { z } from 'zod';
|
|
9
|
-
import { readFileSync } from 'node:fs';
|
|
10
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
10
11
|
import { resolve, dirname } from 'node:path';
|
|
11
12
|
import { fileURLToPath } from 'node:url';
|
|
12
13
|
import { prepareContext, generateSpec } from '../core/single-spec-orchestrator.js';
|
|
13
|
-
import { runBatch } from '../batch/batch-orchestrator.js';
|
|
14
|
+
import { runBatch, buildAstGraphOnly } from '../batch/batch-orchestrator.js';
|
|
15
|
+
import { resolveRegenPlan } from '../batch/regen-plan.js';
|
|
14
16
|
import { loadProjectConfig } from '../config/project-config.js';
|
|
15
17
|
import { detectDrift } from '../diff/drift-orchestrator.js';
|
|
16
18
|
import { bootstrapRuntime } from '../runtime-bootstrap.js';
|
|
@@ -18,178 +20,241 @@ import { scanFiles } from '../utils/file-scanner.js';
|
|
|
18
20
|
import { queryPanoramic } from '../panoramic/query.js';
|
|
19
21
|
import { registerGraphTools } from './graph-tools.js';
|
|
20
22
|
import { registerAgentContextTools } from './agent-context-tools.js';
|
|
23
|
+
import { registerFileNavTools } from './file-nav-tools.js';
|
|
24
|
+
import { buildErrorResponse } from './lib/tool-response.js';
|
|
25
|
+
import { withTelemetry } from './lib/telemetry.js';
|
|
21
26
|
// 读取 package.json 版本号
|
|
22
27
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
23
28
|
const pkgPath = resolve(__dirname, '..', '..', 'package.json');
|
|
24
29
|
const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
|
|
30
|
+
/**
|
|
31
|
+
* MCP server 级 instructions(F184 FR-002):经 SDK `ServerOptions` 注入 initialize result,
|
|
32
|
+
* 给 driver / 子代理在无明确指令时一份工具分组导览 + 典型链路 + 恢复流,提升 MCP 工具采用率。
|
|
33
|
+
*
|
|
34
|
+
* 约束:
|
|
35
|
+
* - 控制在 ≤1600 字符(server 级一次性导览,避免上下文膨胀;F184 Codex Plan W-004)
|
|
36
|
+
* - 不硬编码工具总数(用分组描述,降工具增减时的漂移;新增/删除工具时同步本文)
|
|
37
|
+
* - 必含典型链路串 `detect_changes → impact → context → view_file` 与 `graph-not-built` 恢复流
|
|
38
|
+
*/
|
|
39
|
+
export const TOOL_GUIDE = [
|
|
40
|
+
'Spectra 把代码库变成可查询的知识图谱,工具分四组:',
|
|
41
|
+
'• 上下文导航(最常用):detect_changes(git diff→受影响 symbol)、impact(某 symbol 的 BFS 影响面与 caller 链)、context(symbol 360°:定义+caller+callee+import)。',
|
|
42
|
+
'• 文件查看:view_file(按行区间或 symbolId 看片段,省 token 替代全文 Read)、search_in_file(文件内 pattern 搜索)、list_directory(列目录)。',
|
|
43
|
+
'• 图谱查询:graph_query(关键词子图)、graph_node(节点详情+邻居)、graph_path(两节点最短调用路径)、graph_community(模块聚类)、graph_god_nodes(高耦合枢纽)、graph_hyperedges(跨模块协作超边)。',
|
|
44
|
+
'• Spec 生成:prepare、generate、batch、diff、panoramic-query。',
|
|
45
|
+
'',
|
|
46
|
+
'典型链路:detect_changes → impact → context → view_file(改动评估→影响面→symbol 上下文→定位代码行)。',
|
|
47
|
+
'按任务选工具:评估改动影响/blast radius → impact;找 caller/谁调用了 X → impact(direction=upstream);看某 symbol 定义+依赖 → context;定位某段代码行 → view_file;不清楚结构先探索 → graph_query。',
|
|
48
|
+
'',
|
|
49
|
+
'恢复流:工具返回 graph-not-built 时,优先运行 `spectra batch --mode graph-only`(纯 AST · 零 LLM · 无需认证 · <2min)快速建图再重试;需要完整 spec 关系图再跑 `spectra batch`。symbol 入参类工具(context/impact/view_file)支持 fuzzy——名字有偏差会自动 resolve(warnings: fuzzy-resolved)或回传候选(context.fuzzyMatches),不必精确。',
|
|
50
|
+
].join('\n');
|
|
25
51
|
/**
|
|
26
52
|
* 创建并配置 MCP Server 实例
|
|
27
53
|
*/
|
|
28
54
|
export function createMcpServer() {
|
|
29
55
|
// 单一 runtime 初始化(FR-10):注册语言适配器 / 文档生成器 / 制品解析器
|
|
30
56
|
bootstrapRuntime();
|
|
57
|
+
// F184 FR-002:instructions 属于 SDK 第二个 ServerOptions 参数(非 serverInfo 对象),
|
|
58
|
+
// 写错位置不会进入 initialize result。
|
|
31
59
|
const server = new McpServer({
|
|
32
60
|
name: 'spectra',
|
|
33
61
|
version: pkg.version,
|
|
62
|
+
}, {
|
|
63
|
+
instructions: TOOL_GUIDE,
|
|
34
64
|
});
|
|
35
65
|
// ─── 工具 1: prepare — AST 预处理 + 上下文组装 ───
|
|
36
|
-
server.tool('prepare',
|
|
66
|
+
server.tool('prepare', `AST 预处理 + 上下文组装:对文件/目录抽取 CodeSkeleton 结构,供后续 spec 生成。
|
|
67
|
+
|
|
68
|
+
Use this tool when:
|
|
69
|
+
- 想先看某目录的 AST 结构与语言分布
|
|
70
|
+
- generate 前的轻量预处理
|
|
71
|
+
- 只要结构化骨架、不需要 LLM 推断时
|
|
72
|
+
|
|
73
|
+
Example:
|
|
74
|
+
- Input: { targetPath: "src/auth", deep: false }
|
|
75
|
+
- Output: { skeletons, mergedSkeleton, detectedLanguages }
|
|
76
|
+
|
|
77
|
+
Typical chained usage:
|
|
78
|
+
- prepare → generate(预处理后生成完整 spec)`, {
|
|
37
79
|
targetPath: z.string().describe('目标文件或目录路径(绝对或相对于 cwd)'),
|
|
38
80
|
deep: z.boolean().default(false).describe('深度分析模式(包含函数体)'),
|
|
39
|
-
},
|
|
81
|
+
}, withTelemetry('prepare', async (args) => {
|
|
82
|
+
const { targetPath, deep } = args;
|
|
83
|
+
// 顶层异常由 withTelemetry 捕获 → 脱敏 internal-error(F177)
|
|
84
|
+
const result = await prepareContext(targetPath, {
|
|
85
|
+
deep,
|
|
86
|
+
projectRoot: process.cwd(),
|
|
87
|
+
});
|
|
88
|
+
// 提取 detectedLanguages(Feature 031)—— 局部失败不影响主流程
|
|
89
|
+
let detectedLanguages;
|
|
40
90
|
try {
|
|
41
|
-
const
|
|
42
|
-
|
|
43
|
-
projectRoot: process.cwd()
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
let detectedLanguages;
|
|
47
|
-
try {
|
|
48
|
-
const resolvedTarget = require('node:path').resolve(targetPath);
|
|
49
|
-
const fs = require('node:fs');
|
|
50
|
-
if (fs.statSync(resolvedTarget).isDirectory()) {
|
|
51
|
-
const sr = scanFiles(resolvedTarget, { projectRoot: process.cwd() });
|
|
52
|
-
if (sr.languageStats && sr.languageStats.size > 0) {
|
|
53
|
-
detectedLanguages = Array.from(sr.languageStats.keys());
|
|
54
|
-
}
|
|
91
|
+
const resolvedTarget = resolve(targetPath);
|
|
92
|
+
if (statSync(resolvedTarget).isDirectory()) {
|
|
93
|
+
const sr = scanFiles(resolvedTarget, { projectRoot: process.cwd() });
|
|
94
|
+
if (sr.languageStats && sr.languageStats.size > 0) {
|
|
95
|
+
detectedLanguages = Array.from(sr.languageStats.keys());
|
|
55
96
|
}
|
|
56
97
|
}
|
|
57
|
-
catch {
|
|
58
|
-
// 语言检测失败不影响主流程
|
|
59
|
-
}
|
|
60
|
-
const responseData = detectedLanguages
|
|
61
|
-
? { ...result, detectedLanguages }
|
|
62
|
-
: result;
|
|
63
|
-
return {
|
|
64
|
-
content: [{ type: 'text', text: JSON.stringify(responseData) }],
|
|
65
|
-
};
|
|
66
98
|
}
|
|
67
|
-
catch
|
|
68
|
-
|
|
69
|
-
content: [
|
|
70
|
-
{
|
|
71
|
-
type: 'text',
|
|
72
|
-
text: `prepare 失败: ${err instanceof Error ? err.message : String(err)}`,
|
|
73
|
-
},
|
|
74
|
-
],
|
|
75
|
-
isError: true,
|
|
76
|
-
};
|
|
99
|
+
catch {
|
|
100
|
+
// 语言检测失败不影响主流程
|
|
77
101
|
}
|
|
78
|
-
|
|
102
|
+
const responseData = detectedLanguages
|
|
103
|
+
? { ...result, detectedLanguages }
|
|
104
|
+
: result;
|
|
105
|
+
return {
|
|
106
|
+
content: [{ type: 'text', text: JSON.stringify(responseData) }],
|
|
107
|
+
};
|
|
108
|
+
}));
|
|
79
109
|
// ─── 工具 2: generate — 完整 Spec 生成流水线 ───
|
|
80
|
-
server.tool('generate',
|
|
110
|
+
server.tool('generate', `完整 Spec 生成流水线:对目标文件/目录跑 AST + LLM 推断,产出 .spec.md 文档。
|
|
111
|
+
|
|
112
|
+
Use this tool when:
|
|
113
|
+
- 要为某模块生成可读的规范文档
|
|
114
|
+
- 单文件/单目录的一次性 spec 生成
|
|
115
|
+
- prepare 之后要落地完整文档
|
|
116
|
+
|
|
117
|
+
Example:
|
|
118
|
+
- Input: { targetPath: "src/auth/login.ts", deep: true }
|
|
119
|
+
- Output: { specPath, tokenUsage, confidence, warnings }
|
|
120
|
+
|
|
121
|
+
Typical chained usage:
|
|
122
|
+
- prepare → generate;大范围生成改用 batch`, {
|
|
81
123
|
targetPath: z.string().describe('目标文件或目录路径'),
|
|
82
124
|
deep: z.boolean().default(false).describe('深度分析模式'),
|
|
83
125
|
outputDir: z.string().default('specs').describe('输出目录'),
|
|
84
|
-
},
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
catch (err) {
|
|
106
|
-
return {
|
|
107
|
-
content: [
|
|
108
|
-
{
|
|
109
|
-
type: 'text',
|
|
110
|
-
text: `generate 失败: ${err instanceof Error ? err.message : String(err)}`,
|
|
111
|
-
},
|
|
112
|
-
],
|
|
113
|
-
isError: true,
|
|
114
|
-
};
|
|
115
|
-
}
|
|
116
|
-
});
|
|
126
|
+
}, withTelemetry('generate', async (args) => {
|
|
127
|
+
const { targetPath, deep, outputDir } = args;
|
|
128
|
+
const result = await generateSpec(targetPath, {
|
|
129
|
+
deep,
|
|
130
|
+
outputDir,
|
|
131
|
+
projectRoot: process.cwd(),
|
|
132
|
+
});
|
|
133
|
+
return {
|
|
134
|
+
content: [
|
|
135
|
+
{
|
|
136
|
+
type: 'text',
|
|
137
|
+
text: JSON.stringify({
|
|
138
|
+
specPath: result.specPath,
|
|
139
|
+
tokenUsage: result.tokenUsage,
|
|
140
|
+
confidence: result.confidence,
|
|
141
|
+
warnings: result.warnings,
|
|
142
|
+
}),
|
|
143
|
+
},
|
|
144
|
+
],
|
|
145
|
+
};
|
|
146
|
+
}));
|
|
117
147
|
// ─── 工具 3: batch — 批量 Spec 生成 ───
|
|
118
|
-
server.tool('batch',
|
|
148
|
+
server.tool('batch', `批量 Spec 生成:对整个项目按语言/增量批量产出 spec,带 checkpoint 与增量 cache,并生成 graph.json。
|
|
149
|
+
|
|
150
|
+
Use this tool when:
|
|
151
|
+
- 首次为项目生成全套 spec
|
|
152
|
+
- 代码改动后增量重生成受影响 spec
|
|
153
|
+
- 需要图谱工具的前置 graph.json
|
|
154
|
+
|
|
155
|
+
Example:
|
|
156
|
+
- Input: { projectRoot: ".", mode: "full" }
|
|
157
|
+
- Output: { successful, skipped, failed, indexGenerated }
|
|
158
|
+
|
|
159
|
+
Typical chained usage:
|
|
160
|
+
- batch → graph_query / context / impact(先建图再查询)`, {
|
|
119
161
|
projectRoot: z
|
|
120
162
|
.string()
|
|
121
163
|
.optional()
|
|
122
164
|
.describe('项目根目录(默认为当前工作目录)'),
|
|
123
|
-
|
|
165
|
+
full: z
|
|
166
|
+
.boolean()
|
|
167
|
+
.optional()
|
|
168
|
+
.describe('显式全量重生成(regen 轴逃生口,绕过增量 cache + checkpoint);与 --mode full 质量维度正交'),
|
|
169
|
+
force: z
|
|
170
|
+
.boolean()
|
|
171
|
+
.optional()
|
|
172
|
+
.describe('强制重新生成所有 spec(full 的等义别名,向后兼容)'),
|
|
124
173
|
incremental: z
|
|
125
174
|
.boolean()
|
|
126
175
|
.optional()
|
|
127
|
-
.describe('仅重生成受影响的 spec
|
|
176
|
+
.describe('仅重生成受影响的 spec(增量模式);未指定时默认走增量(FR-001)'),
|
|
128
177
|
languages: z
|
|
129
178
|
.array(z.string())
|
|
130
179
|
.optional()
|
|
131
180
|
.describe('仅处理指定语言(如 ["typescript", "python"])'),
|
|
132
181
|
// F5:运行模式参数(FR-007)
|
|
133
182
|
mode: z
|
|
134
|
-
.enum(['full', 'reading', 'code-only'])
|
|
183
|
+
.enum(['full', 'reading', 'code-only', 'graph-only'])
|
|
135
184
|
.optional()
|
|
136
|
-
.describe('
|
|
137
|
-
},
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
mode: effectiveMode,
|
|
151
|
-
});
|
|
152
|
-
return {
|
|
153
|
-
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
154
|
-
};
|
|
155
|
-
}
|
|
156
|
-
catch (err) {
|
|
185
|
+
.describe('spec 文档质量维度(与 regen 轴正交):full(默认,完整文档)| reading(轻量,跳过产品文档层)| code-only(仅跳 enrichment 层,仍逐模块调 spec-gen LLM,非零成本)| graph-only(纯 AST · 零 LLM · 无需认证 · 仅建图不生成 spec 文档,可作为 impact/context 工具的前置步骤)'),
|
|
186
|
+
}, withTelemetry('batch', async (args) => {
|
|
187
|
+
const { projectRoot, full, force, incremental, languages, mode } = args;
|
|
188
|
+
const root = projectRoot ?? process.cwd();
|
|
189
|
+
// F5:F-009 修复 — MCP 路径 mode 日志输出(FR-006)
|
|
190
|
+
const effectiveMode = mode ?? 'full';
|
|
191
|
+
const mcpLogger = { info: (msg) => console.error(msg) };
|
|
192
|
+
mcpLogger.info(`[info] batch mode=${effectiveMode}`);
|
|
193
|
+
// graph-only 提前拦截:纯 AST 零 LLM,不走 runBatch/regen 轴(复用 buildAstGraphOnly,对齐 CLI 范式)
|
|
194
|
+
if (effectiveMode === 'graph-only') {
|
|
195
|
+
if (languages?.length) {
|
|
196
|
+
mcpLogger.info('[warn] graph-only 不支持 languages 过滤,将全仓建图');
|
|
197
|
+
}
|
|
198
|
+
const graphResult = await buildAstGraphOnly(root);
|
|
157
199
|
return {
|
|
158
|
-
content: [
|
|
159
|
-
{
|
|
160
|
-
type: 'text',
|
|
161
|
-
text: `batch 失败: ${err instanceof Error ? err.message : String(err)}`,
|
|
162
|
-
},
|
|
163
|
-
],
|
|
164
|
-
isError: true,
|
|
200
|
+
content: [{ type: 'text', text: JSON.stringify(graphResult) }],
|
|
165
201
|
};
|
|
166
202
|
}
|
|
167
|
-
|
|
203
|
+
// 加载项目配置作为 fallback(MCP 显式参数优先)
|
|
204
|
+
const fileConfig = loadProjectConfig(root);
|
|
205
|
+
// F175 FR-002:合并 config fallback 后统一解析 regen 计划(唯一默认值来源)。
|
|
206
|
+
const regenPlan = resolveRegenPlan({
|
|
207
|
+
incremental: incremental ?? fileConfig.incremental,
|
|
208
|
+
full,
|
|
209
|
+
force: force ?? fileConfig.force,
|
|
210
|
+
});
|
|
211
|
+
const result = await runBatch(root, {
|
|
212
|
+
incremental: regenPlan.incremental,
|
|
213
|
+
full: regenPlan.full,
|
|
214
|
+
languages: languages ?? fileConfig.languages,
|
|
215
|
+
mode: effectiveMode,
|
|
216
|
+
});
|
|
217
|
+
return {
|
|
218
|
+
content: [{ type: 'text', text: JSON.stringify(result) }],
|
|
219
|
+
};
|
|
220
|
+
}));
|
|
168
221
|
// ─── 工具 4: diff — Spec 漂移检测 ───
|
|
169
|
-
server.tool('diff',
|
|
222
|
+
server.tool('diff', `Spec 漂移检测:比对 .spec.md 与源码,找出文档与实现的偏差、新增行为、过期条目。
|
|
223
|
+
|
|
224
|
+
Use this tool when:
|
|
225
|
+
- 代码改动后检查 spec 是否过时
|
|
226
|
+
- 重构前确认 spec 与实现一致
|
|
227
|
+
- 审查 spec 文档准确性
|
|
228
|
+
|
|
229
|
+
Example:
|
|
230
|
+
- Input: { specPath: "src/auth.spec.md", sourcePath: "src/auth.ts" }
|
|
231
|
+
- Output: { summary, items, recommendation }
|
|
232
|
+
|
|
233
|
+
Typical chained usage:
|
|
234
|
+
- batch → diff(生成 spec 后检查漂移)`, {
|
|
170
235
|
specPath: z.string().describe('Spec 文件路径(.spec.md)'),
|
|
171
236
|
sourcePath: z.string().describe('源代码文件或目录路径'),
|
|
172
|
-
},
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
catch (err) {
|
|
180
|
-
return {
|
|
181
|
-
content: [
|
|
182
|
-
{
|
|
183
|
-
type: 'text',
|
|
184
|
-
text: `diff 失败: ${err instanceof Error ? err.message : String(err)}`,
|
|
185
|
-
},
|
|
186
|
-
],
|
|
187
|
-
isError: true,
|
|
188
|
-
};
|
|
189
|
-
}
|
|
190
|
-
});
|
|
237
|
+
}, withTelemetry('diff', async (args) => {
|
|
238
|
+
const { specPath, sourcePath } = args;
|
|
239
|
+
const report = await detectDrift(resolve(specPath), resolve(sourcePath));
|
|
240
|
+
return {
|
|
241
|
+
content: [{ type: 'text', text: JSON.stringify(report) }],
|
|
242
|
+
};
|
|
243
|
+
}));
|
|
191
244
|
// ─── 工具 5: panoramic-query — panoramic 架构分析 ───
|
|
192
|
-
server.tool('panoramic-query',
|
|
245
|
+
server.tool('panoramic-query', `panoramic 架构分析:cross-package / architecture-ir / overview / natural-language 四种操作,做架构级查询。
|
|
246
|
+
|
|
247
|
+
Use this tool when:
|
|
248
|
+
- 想要 monorepo 跨包依赖全景
|
|
249
|
+
- 问架构级自然语言问题(operation=natural-language)
|
|
250
|
+
- 需要项目 overview 而非单 symbol 上下文
|
|
251
|
+
|
|
252
|
+
Example:
|
|
253
|
+
- Input: { operation: "natural-language", projectRoot: ".", question: "认证流程怎么走" }
|
|
254
|
+
- Output: { answer, citations, tokenUsage }(其他 operation 返回各自结构,如 architecture-ir 返回 IR、overview 返回分层视图)
|
|
255
|
+
|
|
256
|
+
Typical chained usage:
|
|
257
|
+
- batch → panoramic-query(建图后做架构级查询)`, {
|
|
193
258
|
operation: z
|
|
194
259
|
.enum(['cross-package', 'architecture-ir', 'overview', 'natural-language'])
|
|
195
260
|
.describe('分析操作类型;natural-language 触发自然语言问答(FR-009)'),
|
|
@@ -201,34 +266,28 @@ export function createMcpServer() {
|
|
|
201
266
|
.string()
|
|
202
267
|
.optional()
|
|
203
268
|
.describe('问题文本(operation=natural-language 时必填,其他 operation 忽略)'),
|
|
204
|
-
},
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
269
|
+
}, withTelemetry('panoramic-query', async (args) => {
|
|
270
|
+
const { operation, projectRoot, question } = args;
|
|
271
|
+
const result = await queryPanoramic({ operation, projectRoot, question });
|
|
272
|
+
if (!result.ok) {
|
|
273
|
+
// F177(修隐性 bug EC-6:旧实现此路径未置 isError,且用旧 {error} 形态):
|
|
274
|
+
// 按 query 层判别区分——预期输入失败回传安全文案;内部异常脱敏为 internal-error
|
|
275
|
+
// (result.error 可能含绝对路径,不回传原文,spec C-4 / Codex CRITICAL-D)。
|
|
276
|
+
if (result.kind === 'invalid-input') {
|
|
277
|
+
return buildErrorResponse('invalid-input', result.error);
|
|
211
278
|
}
|
|
212
|
-
return
|
|
213
|
-
content: [{ type: 'text', text: JSON.stringify(result.data) }],
|
|
214
|
-
};
|
|
279
|
+
return buildErrorResponse('internal-error', 'panoramic-query 内部错误');
|
|
215
280
|
}
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
type: 'text',
|
|
221
|
-
text: `panoramic-query 失败: ${err instanceof Error ? err.message : String(err)}`,
|
|
222
|
-
},
|
|
223
|
-
],
|
|
224
|
-
isError: true,
|
|
225
|
-
};
|
|
226
|
-
}
|
|
227
|
-
});
|
|
281
|
+
return {
|
|
282
|
+
content: [{ type: 'text', text: JSON.stringify(result.data) }],
|
|
283
|
+
};
|
|
284
|
+
}));
|
|
228
285
|
// ─── 注册图谱查询工具(graph_query / graph_node / graph_path / graph_community / graph_god_nodes) ───
|
|
229
286
|
registerGraphTools(server);
|
|
230
287
|
// ─── Feature 155 — Agent-Context tools(impact / context / detect_changes) ───
|
|
231
288
|
registerAgentContextTools(server);
|
|
289
|
+
// ─── Feature 171 — File Navigation tools(view_file / search_in_file / list_directory) ───
|
|
290
|
+
registerFileNavTools(server);
|
|
232
291
|
return server;
|
|
233
292
|
}
|
|
234
293
|
//# sourceMappingURL=server.js.map
|
package/dist/mcp/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
|
|
@@ -137,7 +137,8 @@ export declare const ImportReferenceSchema: z.ZodObject<{
|
|
|
137
137
|
isTypeOnly: z.ZodBoolean;
|
|
138
138
|
/**
|
|
139
139
|
* 语法类型(Feature 156 W1.0 新增;可选,向后兼容)。
|
|
140
|
-
*
|
|
140
|
+
* 由各 analyzer 在抽取 import 时行内派生(ast-analyzer 据 ts-morph 节点、
|
|
141
|
+
* tree-sitter 路径据 isTypeOnly);写入 CodeSkeleton.imports[].importType;
|
|
141
142
|
* deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence;
|
|
142
143
|
* module-derivation 在重建 ModuleEdge.importType 时读取此字段。
|
|
143
144
|
*/
|
|
@@ -263,7 +264,8 @@ export declare const CodeSkeletonSchema: z.ZodObject<{
|
|
|
263
264
|
isTypeOnly: z.ZodBoolean;
|
|
264
265
|
/**
|
|
265
266
|
* 语法类型(Feature 156 W1.0 新增;可选,向后兼容)。
|
|
266
|
-
*
|
|
267
|
+
* 由各 analyzer 在抽取 import 时行内派生(ast-analyzer 据 ts-morph 节点、
|
|
268
|
+
* tree-sitter 路径据 isTypeOnly);写入 CodeSkeleton.imports[].importType;
|
|
267
269
|
* deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence;
|
|
268
270
|
* module-derivation 在重建 ModuleEdge.importType 时读取此字段。
|
|
269
271
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"code-skeleton.d.ts","sourceRoot":"","sources":["../../src/models/code-skeleton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/D,eAAO,MAAM,gBAAgB,2IAc3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,4HAU3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,+CAA6C,CAAC;AAC3E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,qEAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc,2GAYzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,2BAA2B;AAC3B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,WAAW;AACX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,mEAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,WAAW;AACX,eAAO,MAAM,qBAAqB;;;;;;;IAOhC
|
|
1
|
+
{"version":3,"file":"code-skeleton.d.ts","sourceRoot":"","sources":["../../src/models/code-skeleton.ts"],"names":[],"mappings":"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"}
|
|
@@ -103,7 +103,8 @@ export const ImportReferenceSchema = z.object({
|
|
|
103
103
|
isTypeOnly: z.boolean(),
|
|
104
104
|
/**
|
|
105
105
|
* 语法类型(Feature 156 W1.0 新增;可选,向后兼容)。
|
|
106
|
-
*
|
|
106
|
+
* 由各 analyzer 在抽取 import 时行内派生(ast-analyzer 据 ts-morph 节点、
|
|
107
|
+
* tree-sitter 路径据 isTypeOnly);写入 CodeSkeleton.imports[].importType;
|
|
107
108
|
* deriveImportEdges 把此值写入 UnifiedGraphEdge.evidence;
|
|
108
109
|
* module-derivation 在重建 ModuleEdge.importType 时读取此字段。
|
|
109
110
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"code-skeleton.js","sourceRoot":"","sources":["../../src/models/code-skeleton.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"code-skeleton.js","sourceRoot":"","sources":["../../src/models/code-skeleton.ts"],"names":[],"mappings":"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"}
|