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
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Feature 171 — File Navigation MCP Tools(view_file / search_in_file / list_directory)
|
|
3
|
+
*
|
|
4
|
+
* 对标 SWE-Agent / OpenHands scaffolding 的文件导航工具,让 driver 按 line range / pattern /
|
|
5
|
+
* 目录查看文件以省 token。建在 Feature 151 graph + Feature 155 agent-context 之上。
|
|
6
|
+
*
|
|
7
|
+
* 模块分层:
|
|
8
|
+
* - 纯逻辑/IO 在 lib/file-nav-helpers.ts(≥95% 单测)
|
|
9
|
+
* - 共享响应原语在 lib/tool-response.ts;telemetry 在 lib/telemetry.ts
|
|
10
|
+
* - 本文件只做薄 handler 编排 + Zod schema + F170c 4 要素 description
|
|
11
|
+
*
|
|
12
|
+
* 🔴 所有 path 经 resolveSafePath 校验(LFI 红线);错误响应全部脱敏(不回传绝对路径/stack)。
|
|
13
|
+
*/
|
|
14
|
+
import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
15
|
+
import { type ToolResult } from './lib/tool-response.js';
|
|
16
|
+
interface ViewFileArgs {
|
|
17
|
+
path: string;
|
|
18
|
+
startLine?: number;
|
|
19
|
+
endLine?: number;
|
|
20
|
+
symbolId?: string;
|
|
21
|
+
projectRoot?: string;
|
|
22
|
+
}
|
|
23
|
+
export declare function handleViewFile(args: ViewFileArgs): Promise<ToolResult>;
|
|
24
|
+
interface SearchInFileArgs {
|
|
25
|
+
path: string;
|
|
26
|
+
pattern: string;
|
|
27
|
+
isRegex?: boolean;
|
|
28
|
+
maxMatches?: number;
|
|
29
|
+
contextLines?: number;
|
|
30
|
+
projectRoot?: string;
|
|
31
|
+
}
|
|
32
|
+
export declare function handleSearchInFile(args: SearchInFileArgs): Promise<ToolResult>;
|
|
33
|
+
interface ListDirectoryArgs {
|
|
34
|
+
path: string;
|
|
35
|
+
depth?: number;
|
|
36
|
+
includeIgnored?: boolean;
|
|
37
|
+
projectRoot?: string;
|
|
38
|
+
}
|
|
39
|
+
export declare function handleListDirectory(args: ListDirectoryArgs): Promise<ToolResult>;
|
|
40
|
+
export declare function registerFileNavTools(server: McpServer): void;
|
|
41
|
+
export {};
|
|
42
|
+
//# sourceMappingURL=file-nav-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-nav-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/file-nav-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAyChC,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqID,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA6D5E;AAMD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BpF;AAMD,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBtF;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyD5D"}
|
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Feature 171 — File Navigation MCP Tools(view_file / search_in_file / list_directory)
|
|
3
|
+
*
|
|
4
|
+
* 对标 SWE-Agent / OpenHands scaffolding 的文件导航工具,让 driver 按 line range / pattern /
|
|
5
|
+
* 目录查看文件以省 token。建在 Feature 151 graph + Feature 155 agent-context 之上。
|
|
6
|
+
*
|
|
7
|
+
* 模块分层:
|
|
8
|
+
* - 纯逻辑/IO 在 lib/file-nav-helpers.ts(≥95% 单测)
|
|
9
|
+
* - 共享响应原语在 lib/tool-response.ts;telemetry 在 lib/telemetry.ts
|
|
10
|
+
* - 本文件只做薄 handler 编排 + Zod schema + F170c 4 要素 description
|
|
11
|
+
*
|
|
12
|
+
* 🔴 所有 path 经 resolveSafePath 校验(LFI 红线);错误响应全部脱敏(不回传绝对路径/stack)。
|
|
13
|
+
*/
|
|
14
|
+
import { readFileSync, statSync, realpathSync } from 'node:fs';
|
|
15
|
+
import * as path from 'node:path';
|
|
16
|
+
import { z } from 'zod';
|
|
17
|
+
import { getCachedGraphData, isGraphFormatStaleError } from './graph-tools.js';
|
|
18
|
+
import { canonicalizeSymbolId, findNode, moduleFileFromId, resolveSymbolFuzzy, } from '../knowledge-graph/query-helpers.js';
|
|
19
|
+
import { buildErrorResponse, buildSuccessResponse, exceedsPayloadCap, } from './lib/tool-response.js';
|
|
20
|
+
import { recordAndReturn } from './lib/telemetry.js';
|
|
21
|
+
import { resolveSafePath, sliceLines, isBinary, matchInFile, buildDirListing, buildFileNavHint, } from './lib/file-nav-helpers.js';
|
|
22
|
+
// ============================================================
|
|
23
|
+
// 共享:path 校验 + 脱敏错误映射
|
|
24
|
+
// ============================================================
|
|
25
|
+
/** 把 SafePathErrorCode 映射为脱敏的 ToolResult(不含绝对路径) */
|
|
26
|
+
function safePathError(code) {
|
|
27
|
+
switch (code) {
|
|
28
|
+
case 'path-outside-root':
|
|
29
|
+
return buildErrorResponse('path-outside-root', 'path 超出 projectRoot 范围', '仅允许访问项目根内的文件');
|
|
30
|
+
case 'file-not-found':
|
|
31
|
+
return buildErrorResponse('file-not-found', 'path 指向的文件或目录不存在');
|
|
32
|
+
case 'invalid-input':
|
|
33
|
+
default:
|
|
34
|
+
return buildErrorResponse('invalid-input', 'path 非法(为空或含非法字符)');
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
function requestSize(args) {
|
|
38
|
+
try {
|
|
39
|
+
return JSON.stringify(args).length;
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
return 0;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
const ViewFileInputSchema = {
|
|
46
|
+
path: z.string().describe('项目根内的相对/绝对文件路径'),
|
|
47
|
+
startLine: z.number().int().optional().describe('起始行(1-indexed,含)'),
|
|
48
|
+
endLine: z.number().int().optional().describe('结束行(1-indexed,含)'),
|
|
49
|
+
symbolId: z.string().optional().describe('symbol id;提供时按其 graph lineRange 切片'),
|
|
50
|
+
// 🔴 安全:projectRoot 不暴露给 MCP 客户端,固定为 server 启动 cwd(防客户端把安全边界放大到 /)。
|
|
51
|
+
// 内部/测试经 handler 的 args.projectRoot 注入。
|
|
52
|
+
};
|
|
53
|
+
/** 从已解析的 canonicalId 取 file + lineRange(canonical 与 fuzzy-resolved 路径共用,消除重复) */
|
|
54
|
+
function nodeToRange(graphData, id) {
|
|
55
|
+
const node = findNode(graphData, id);
|
|
56
|
+
/* v8 ignore next 3 — 防御性:调用方已确认 id 命中(canon ok 或 fuzzy autoResolved),findNode 不应为 null */
|
|
57
|
+
if (node === null) {
|
|
58
|
+
return { ok: false, result: buildErrorResponse('symbol-not-found', 'symbol 节点对象未找到') };
|
|
59
|
+
}
|
|
60
|
+
const md = node.metadata;
|
|
61
|
+
const file = (md['sourceFile'] ?? md['sourcePath'] ?? moduleFileFromId(node.id)) || null;
|
|
62
|
+
const lineRange = md['lineRange'];
|
|
63
|
+
return { ok: true, file, start: lineRange?.start, end: lineRange?.end };
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* 用 symbolId 解析 graph node 的 file + lineRange;失败返回错误 ToolResult。
|
|
67
|
+
* F184 FR-003:canonicalize not-found 时接入分层 fuzzy(镜像 agent-context-tools 的 F174 写法)——
|
|
68
|
+
* autoResolved 唯一高分候选自动采用(fuzzyResolved=true,调用方 push 'fuzzy-resolved' warning);
|
|
69
|
+
* 否则错误响应经 context.fuzzyMatches 回传 top-3 候选(含 matchKind),修复 context→view_file 链自断。
|
|
70
|
+
*/
|
|
71
|
+
function resolveSymbolRange(projectRoot, symbolId) {
|
|
72
|
+
// F193 Codex implement-C2:捕获 graph-format-stale,给明确重建指引,
|
|
73
|
+
// 不让 stale error 冒泡到外层 catch-all 转成 internal-error。
|
|
74
|
+
let cached;
|
|
75
|
+
try {
|
|
76
|
+
cached = getCachedGraphData(projectRoot);
|
|
77
|
+
}
|
|
78
|
+
catch (err) {
|
|
79
|
+
if (isGraphFormatStaleError(err)) {
|
|
80
|
+
return {
|
|
81
|
+
ok: false,
|
|
82
|
+
result: buildErrorResponse('graph-format-stale', err.message, '当前 worktree 的图为旧绝对路径格式(可能 copy 自主仓/其他 worktree)。运行 `spectra index` 或 `spectra batch` 在当前 worktree 重建图。'),
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
throw err;
|
|
86
|
+
}
|
|
87
|
+
if (cached === null) {
|
|
88
|
+
return { ok: false, result: buildErrorResponse('graph-not-built', 'graph 未构建', '请先运行 `spectra batch` 生成图谱') };
|
|
89
|
+
}
|
|
90
|
+
const { graphData } = cached;
|
|
91
|
+
const canon = canonicalizeSymbolId(symbolId, graphData, { projectRoot });
|
|
92
|
+
if (canon.reason === 'invalid') {
|
|
93
|
+
return { ok: false, result: buildErrorResponse('invalid-symbol-id', 'symbolId 格式非法') };
|
|
94
|
+
}
|
|
95
|
+
if (canon.reason === 'not-found' || canon.canonicalId === null) {
|
|
96
|
+
const fuzzy = resolveSymbolFuzzy(graphData, symbolId, { projectRoot });
|
|
97
|
+
if (fuzzy.autoResolved && fuzzy.candidates[0] !== undefined) {
|
|
98
|
+
const range = nodeToRange(graphData, fuzzy.candidates[0].id);
|
|
99
|
+
if (!range.ok)
|
|
100
|
+
return range;
|
|
101
|
+
return { ...range, fuzzyResolved: true };
|
|
102
|
+
}
|
|
103
|
+
return {
|
|
104
|
+
ok: false,
|
|
105
|
+
result: buildErrorResponse('symbol-not-found', 'symbolId 在 graph 中未找到', '请检查 id,参考 fuzzyMatches 候选,或先调 context 确认 symbol,或改用 startLine/endLine', { fuzzyMatches: fuzzy.candidates.slice(0, 3) }),
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
return nodeToRange(graphData, canon.canonicalId);
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* 判定 symbol 解析出的文件与用户 path 是否冲突。
|
|
112
|
+
* 按 path segment 比较后缀(修 Codex W3:避免 'evil/xb.ts' endsWith 'b.ts' 的字符串误判)。
|
|
113
|
+
* 一个是另一个的 segment 后缀(如 'sub/b.ts' vs 'b.ts')视为一致。
|
|
114
|
+
*/
|
|
115
|
+
function fileMismatch(reqRel, nodeFile) {
|
|
116
|
+
const a = path.normalize(reqRel).split(path.sep).filter(Boolean);
|
|
117
|
+
const b = path.normalize(nodeFile).split('/').filter((s) => s && s !== '.');
|
|
118
|
+
const shorter = a.length <= b.length ? a : b;
|
|
119
|
+
const longer = a.length <= b.length ? b : a;
|
|
120
|
+
for (let i = 1; i <= shorter.length; i++) {
|
|
121
|
+
if (shorter[shorter.length - i] !== longer[longer.length - i])
|
|
122
|
+
return true;
|
|
123
|
+
}
|
|
124
|
+
return false; // shorter 是 longer 的 segment 后缀
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* 共享 handler 骨架:采样 telemetry → 校验 path → resolveSafePath → 执行 body → 统一 internal-error 边界。
|
|
128
|
+
* body 收到已校验在根内的 realPath(必存在,故 body 内 statSync 不会 ENOENT)。
|
|
129
|
+
* 所有错误码统一经 recordAndReturn 透传;任何未预期异常落到脱敏的 internal-error(FR-014)。
|
|
130
|
+
*/
|
|
131
|
+
async function runFileNavTool(toolName, args, body) {
|
|
132
|
+
const start = Date.now();
|
|
133
|
+
const reqSize = requestSize(args);
|
|
134
|
+
try {
|
|
135
|
+
if (typeof args.path !== 'string' || args.path.length === 0) {
|
|
136
|
+
return recordAndReturn(toolName, start, reqSize, buildErrorResponse('invalid-input', 'path 必填且为非空字符串'));
|
|
137
|
+
}
|
|
138
|
+
const projectRoot = args.projectRoot ?? process.cwd();
|
|
139
|
+
const safe = resolveSafePath(projectRoot, args.path);
|
|
140
|
+
if (!safe.ok) {
|
|
141
|
+
return recordAndReturn(toolName, start, reqSize, safePathError(safe.code));
|
|
142
|
+
}
|
|
143
|
+
return recordAndReturn(toolName, start, reqSize, body(projectRoot, safe.realPath));
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
// FR-014 脱敏:不回传 err.message/stack
|
|
147
|
+
return recordAndReturn(toolName, start, reqSize, buildErrorResponse('internal-error', `${toolName} 内部错误`));
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
export async function handleViewFile(args) {
|
|
151
|
+
return runFileNavTool('view_file', args, (projectRoot, realPath) => {
|
|
152
|
+
if (statSync(realPath).isDirectory()) {
|
|
153
|
+
return buildErrorResponse('invalid-input', 'path 是目录,请用 list_directory');
|
|
154
|
+
}
|
|
155
|
+
let startLine = args.startLine;
|
|
156
|
+
let endLine = args.endLine;
|
|
157
|
+
const warnings = [];
|
|
158
|
+
if (typeof args.symbolId === 'string' && args.symbolId.length > 0) {
|
|
159
|
+
const sym = resolveSymbolRange(projectRoot, args.symbolId);
|
|
160
|
+
if (!sym.ok)
|
|
161
|
+
return sym.result;
|
|
162
|
+
// F184:fuzzy 自动 resolve 命中时记 warning(顺序在 symbolId-overrides-lines 之前;
|
|
163
|
+
// warnings 为无序集合语义,测试用 toContain/arrayContaining)
|
|
164
|
+
if (sym.fuzzyResolved === true)
|
|
165
|
+
warnings.push('fuzzy-resolved');
|
|
166
|
+
// projectRoot 已在 resolveSafePath 成功 realpath,此处直接复用(不会抛)
|
|
167
|
+
const reqRel = path.relative(realpathSync.native(projectRoot), realPath);
|
|
168
|
+
if (sym.file !== null && fileMismatch(reqRel, sym.file)) {
|
|
169
|
+
// F184:fuzzy 解析到另一文件导致的不一致,用 context.fuzzyResolved 布尔保留诊断
|
|
170
|
+
// (warning 在 error envelope 会丢,故改放 context)。
|
|
171
|
+
// 🔴 不回传 sym.file:graph metadata 的 sourceFile 可能是绝对路径(实测 baseline graph 存在
|
|
172
|
+
// 绝对路径 node),回传会破坏 file-nav 脱敏红线(FR-014)。布尔已足够提示"symbolId 模糊命中了
|
|
173
|
+
// 与 path 不同的文件",调用方据此二选一即可。
|
|
174
|
+
return buildErrorResponse('invalid-input', 'path 与 symbolId 所属文件不一致', '二选一:去掉 path 用 symbolId,或去掉 symbolId 用 path', sym.fuzzyResolved === true ? { fuzzyResolved: true } : undefined);
|
|
175
|
+
}
|
|
176
|
+
if (typeof sym.start === 'number') {
|
|
177
|
+
// FR-003:symbolId 与显式行区间同存 → 以 symbolId 为准并 warning
|
|
178
|
+
if (args.startLine !== undefined || args.endLine !== undefined) {
|
|
179
|
+
warnings.push('symbolId-overrides-lines');
|
|
180
|
+
}
|
|
181
|
+
startLine = sym.start;
|
|
182
|
+
endLine = typeof sym.end === 'number' ? sym.end : sym.start;
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
const buf = readFileSync(realPath);
|
|
186
|
+
if (isBinary(buf)) {
|
|
187
|
+
return buildErrorResponse('binary-file', '目标为二进制文件,无法按行查看');
|
|
188
|
+
}
|
|
189
|
+
const slice = sliceLines(buf.toString('utf-8'), { startLine, endLine });
|
|
190
|
+
const data = {
|
|
191
|
+
path: args.path,
|
|
192
|
+
lines: slice.lines,
|
|
193
|
+
startLine: slice.startLine,
|
|
194
|
+
endLine: slice.endLine,
|
|
195
|
+
totalLines: slice.totalLines,
|
|
196
|
+
truncated: slice.truncated,
|
|
197
|
+
};
|
|
198
|
+
if (warnings.length > 0)
|
|
199
|
+
data['warnings'] = warnings;
|
|
200
|
+
data['nextStepHint'] = buildFileNavHint('view_file', data);
|
|
201
|
+
// lines 不做静默截断(丢代码行会误导):超 cap 显式返回 payload-too-large,引导缩小区间
|
|
202
|
+
const result = buildSuccessResponse(data, []);
|
|
203
|
+
if (exceedsPayloadCap(result)) {
|
|
204
|
+
return buildErrorResponse('payload-too-large', '响应过大,请缩小 startLine/endLine 区间');
|
|
205
|
+
}
|
|
206
|
+
return result;
|
|
207
|
+
});
|
|
208
|
+
}
|
|
209
|
+
const SearchInFileInputSchema = {
|
|
210
|
+
path: z.string().describe('项目根内的相对/绝对文件路径'),
|
|
211
|
+
pattern: z.string().describe('搜索 pattern(literal 或 regex)'),
|
|
212
|
+
isRegex: z.boolean().optional().describe('是否按正则匹配(默认 false)'),
|
|
213
|
+
maxMatches: z.number().int().optional().describe('最多返回命中数(默认 50,上限 1000)'),
|
|
214
|
+
contextLines: z.number().int().optional().describe('每条命中前后上下文行数(默认 0,上限 20)'),
|
|
215
|
+
// 🔴 安全:projectRoot 不暴露给 MCP 客户端,固定为 server 启动 cwd(防客户端把安全边界放大到 /)。
|
|
216
|
+
// 内部/测试经 handler 的 args.projectRoot 注入。
|
|
217
|
+
};
|
|
218
|
+
export async function handleSearchInFile(args) {
|
|
219
|
+
return runFileNavTool('search_in_file', args, (_projectRoot, realPath) => {
|
|
220
|
+
if (statSync(realPath).isDirectory()) {
|
|
221
|
+
return buildErrorResponse('invalid-input', 'path 是目录,请用 list_directory');
|
|
222
|
+
}
|
|
223
|
+
const buf = readFileSync(realPath);
|
|
224
|
+
if (isBinary(buf)) {
|
|
225
|
+
return buildErrorResponse('binary-file', '目标为二进制文件,无法搜索');
|
|
226
|
+
}
|
|
227
|
+
const m = matchInFile(buf.toString('utf-8'), args.pattern, {
|
|
228
|
+
isRegex: args.isRegex,
|
|
229
|
+
maxMatches: args.maxMatches,
|
|
230
|
+
contextLines: args.contextLines,
|
|
231
|
+
});
|
|
232
|
+
if (!m.ok) {
|
|
233
|
+
return buildErrorResponse('invalid-input', `pattern 非法:${m.reason}`);
|
|
234
|
+
}
|
|
235
|
+
const data = {
|
|
236
|
+
path: args.path,
|
|
237
|
+
matches: m.matches,
|
|
238
|
+
totalMatches: m.totalMatches,
|
|
239
|
+
returnedMatches: m.returnedMatches,
|
|
240
|
+
};
|
|
241
|
+
if (m.warnings.length > 0)
|
|
242
|
+
data['warnings'] = m.warnings;
|
|
243
|
+
data['nextStepHint'] = buildFileNavHint('search_in_file', data);
|
|
244
|
+
// matches 按字节截断(已带 totalMatches/returnedMatches);path 已 ≤ MAX_PATH_LENGTH,
|
|
245
|
+
// 其余字段有界 → 截断后必 ≤ cap,无需 payload-too-large 复核(修 Codex CRITICAL-2 的根因是超长 path)
|
|
246
|
+
return buildSuccessResponse(data, ['matches']);
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
const ListDirectoryInputSchema = {
|
|
250
|
+
path: z.string().describe('项目根内的相对/绝对目录路径'),
|
|
251
|
+
depth: z.number().int().optional().describe('递归深度(默认 1,上限 10)'),
|
|
252
|
+
includeIgnored: z.boolean().optional().describe('是否纳入 .git 等忽略项(默认 false)'),
|
|
253
|
+
// 🔴 安全:projectRoot 不暴露给 MCP 客户端,固定为 server 启动 cwd(防客户端把安全边界放大到 /)。
|
|
254
|
+
// 内部/测试经 handler 的 args.projectRoot 注入。
|
|
255
|
+
};
|
|
256
|
+
export async function handleListDirectory(args) {
|
|
257
|
+
return runFileNavTool('list_directory', args, (_projectRoot, realPath) => {
|
|
258
|
+
if (!statSync(realPath).isDirectory()) {
|
|
259
|
+
return buildErrorResponse('invalid-input', 'path 不是目录,请用 view_file');
|
|
260
|
+
}
|
|
261
|
+
const listing = buildDirListing(realPath, { depth: args.depth, includeIgnored: args.includeIgnored });
|
|
262
|
+
const data = {
|
|
263
|
+
path: args.path,
|
|
264
|
+
entries: listing.entries,
|
|
265
|
+
entryCount: listing.entries.length,
|
|
266
|
+
};
|
|
267
|
+
if (listing.warnings.length > 0)
|
|
268
|
+
data['warnings'] = listing.warnings;
|
|
269
|
+
data['nextStepHint'] = buildFileNavHint('list_directory', data);
|
|
270
|
+
// entries 按字节截断(已带 listing-truncated / entryCount);其余字段有界 → 截断后必 ≤ cap
|
|
271
|
+
return buildSuccessResponse(data, ['entries']);
|
|
272
|
+
});
|
|
273
|
+
}
|
|
274
|
+
// ============================================================
|
|
275
|
+
// 注册(F170c 4 要素 description)
|
|
276
|
+
// ============================================================
|
|
277
|
+
export function registerFileNavTools(server) {
|
|
278
|
+
server.tool('view_file', `按行区间或 symbol 定位查看文件片段(带行号),省 token 替代全文 Read。
|
|
279
|
+
|
|
280
|
+
Use this tool when:
|
|
281
|
+
- 只想看文件某一段而非全文(省 token)
|
|
282
|
+
- 拿到 context/impact 的 symbol 后定位其定义行段
|
|
283
|
+
- 按行号翻页查看大文件
|
|
284
|
+
|
|
285
|
+
Example:
|
|
286
|
+
- Input: { path: "src/a.ts", startLine: 10, endLine: 40 }
|
|
287
|
+
- Output: { lines, startLine, endLine, totalLines, truncated, nextStepHint }
|
|
288
|
+
|
|
289
|
+
Typical chained usage:
|
|
290
|
+
- context → view_file(symbolId)(按 symbol lineRange 看定义行段)`, ViewFileInputSchema, async (args) => handleViewFile(args));
|
|
291
|
+
server.tool('search_in_file', `在单个文件内按 pattern(literal 或 regex)搜索,返回带前后上下文行的命中列表。
|
|
292
|
+
|
|
293
|
+
Use this tool when:
|
|
294
|
+
- 在已知文件里定位某标识符/字符串出现处
|
|
295
|
+
- 需要命中行的前后上下文行
|
|
296
|
+
- 在大文件里快速跳到关键行
|
|
297
|
+
|
|
298
|
+
Example:
|
|
299
|
+
- Input: { path: "src/a.ts", pattern: "TODO", contextLines: 2 }
|
|
300
|
+
- Output: { matches: [{line, text, before, after}], totalMatches, nextStepHint }
|
|
301
|
+
|
|
302
|
+
Typical chained usage:
|
|
303
|
+
- search_in_file → view_file(查某命中处完整行段)`, SearchInFileInputSchema, async (args) => handleSearchInFile(args));
|
|
304
|
+
server.tool('list_directory', `列出目录条目(name/type/size),可递归 depth 层,默认仅过滤 .git。
|
|
305
|
+
|
|
306
|
+
Use this tool when:
|
|
307
|
+
- 不清楚目录结构、决定下一步看哪个文件
|
|
308
|
+
- 探索三方/子模块代码布局
|
|
309
|
+
- 递归浏览某子树
|
|
310
|
+
|
|
311
|
+
Example:
|
|
312
|
+
- Input: { path: "src/mcp", depth: 1 }
|
|
313
|
+
- Output: { entries: [{name, type, size}], entryCount, nextStepHint }
|
|
314
|
+
|
|
315
|
+
Typical chained usage:
|
|
316
|
+
- list_directory → view_file(查目录里某个文件)`, ListDirectoryInputSchema, async (args) => handleListDirectory(args));
|
|
317
|
+
}
|
|
318
|
+
//# sourceMappingURL=file-nav-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-nav-tools.js","sourceRoot":"","sources":["../../src/mcp/file-nav-tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -29,6 +29,8 @@ export declare function getCachedGraphData(projectRoot?: string): {
|
|
|
29
29
|
mtimeMs: number;
|
|
30
30
|
sizeBytes: number;
|
|
31
31
|
} | null;
|
|
32
|
+
/** 判定一个 caught error 是否为加载期 graph-format-stale 信号(Feature 193 FR-006) */
|
|
33
|
+
export declare function isGraphFormatStaleError(err: unknown): err is Error;
|
|
32
34
|
/**
|
|
33
35
|
* 向 MCP Server 注册所有图谱查询工具
|
|
34
36
|
* @param server - McpServer 实例
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/graph-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;
|
|
1
|
+
{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/graph-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAoEnE;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACxD,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAwBP;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,KAAK,CAElE;AAwDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoP1D"}
|