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.
Files changed (365) hide show
  1. package/README.md +12 -5
  2. package/dist/.spectra-build-meta.json +9 -0
  3. package/dist/adapters/language-adapter.d.ts +7 -12
  4. package/dist/adapters/language-adapter.d.ts.map +1 -1
  5. package/dist/adapters/python-adapter.d.ts.map +1 -1
  6. package/dist/adapters/python-adapter.js +11 -2
  7. package/dist/adapters/python-adapter.js.map +1 -1
  8. package/dist/batch/batch-orchestrator.d.ts +44 -1
  9. package/dist/batch/batch-orchestrator.d.ts.map +1 -1
  10. package/dist/batch/batch-orchestrator.js +312 -76
  11. package/dist/batch/batch-orchestrator.js.map +1 -1
  12. package/dist/batch/delta-regenerator.d.ts.map +1 -1
  13. package/dist/batch/delta-regenerator.js +21 -28
  14. package/dist/batch/delta-regenerator.js.map +1 -1
  15. package/dist/batch/module-grouper.d.ts +7 -0
  16. package/dist/batch/module-grouper.d.ts.map +1 -1
  17. package/dist/batch/module-grouper.js +2 -0
  18. package/dist/batch/module-grouper.js.map +1 -1
  19. package/dist/batch/regen-plan.d.ts +78 -0
  20. package/dist/batch/regen-plan.d.ts.map +1 -0
  21. package/dist/batch/regen-plan.js +93 -0
  22. package/dist/batch/regen-plan.js.map +1 -0
  23. package/dist/cli/commands/batch.d.ts.map +1 -1
  24. package/dist/cli/commands/batch.js +36 -8
  25. package/dist/cli/commands/batch.js.map +1 -1
  26. package/dist/cli/commands/scaffold-kb.d.ts +9 -0
  27. package/dist/cli/commands/scaffold-kb.d.ts.map +1 -0
  28. package/dist/cli/commands/scaffold-kb.js +179 -0
  29. package/dist/cli/commands/scaffold-kb.js.map +1 -0
  30. package/dist/cli/index.js +24 -5
  31. package/dist/cli/index.js.map +1 -1
  32. package/dist/cli/utils/error-handler.d.ts +0 -6
  33. package/dist/cli/utils/error-handler.d.ts.map +1 -1
  34. package/dist/cli/utils/error-handler.js +0 -13
  35. package/dist/cli/utils/error-handler.js.map +1 -1
  36. package/dist/cli/utils/parse-args.d.ts +43 -3
  37. package/dist/cli/utils/parse-args.d.ts.map +1 -1
  38. package/dist/cli/utils/parse-args.js +98 -12
  39. package/dist/cli/utils/parse-args.js.map +1 -1
  40. package/dist/cli/version-meta.d.ts +16 -0
  41. package/dist/cli/version-meta.d.ts.map +1 -0
  42. package/dist/cli/version-meta.js +28 -0
  43. package/dist/cli/version-meta.js.map +1 -0
  44. package/dist/core/ast-analyzer.d.ts.map +1 -1
  45. package/dist/core/ast-analyzer.js +7 -11
  46. package/dist/core/ast-analyzer.js.map +1 -1
  47. package/dist/core/import-resolver.d.ts +70 -67
  48. package/dist/core/import-resolver.d.ts.map +1 -1
  49. package/dist/core/import-resolver.js +341 -200
  50. package/dist/core/import-resolver.js.map +1 -1
  51. package/dist/core/single-spec-orchestrator.d.ts +21 -0
  52. package/dist/core/single-spec-orchestrator.d.ts.map +1 -1
  53. package/dist/core/single-spec-orchestrator.js +41 -14
  54. package/dist/core/single-spec-orchestrator.js.map +1 -1
  55. package/dist/core/skeleton-hash.d.ts +33 -0
  56. package/dist/core/skeleton-hash.d.ts.map +1 -0
  57. package/dist/core/skeleton-hash.js +76 -0
  58. package/dist/core/skeleton-hash.js.map +1 -0
  59. package/dist/core/tree-sitter-analyzer.d.ts +3 -2
  60. package/dist/core/tree-sitter-analyzer.d.ts.map +1 -1
  61. package/dist/core/tree-sitter-analyzer.js +5 -6
  62. package/dist/core/tree-sitter-analyzer.js.map +1 -1
  63. package/dist/core/tree-sitter-fallback.d.ts +7 -2
  64. package/dist/core/tree-sitter-fallback.d.ts.map +1 -1
  65. package/dist/core/tree-sitter-fallback.js +18 -15
  66. package/dist/core/tree-sitter-fallback.js.map +1 -1
  67. package/dist/extraction/image-extractor.d.ts.map +1 -1
  68. package/dist/extraction/image-extractor.js +3 -1
  69. package/dist/extraction/image-extractor.js.map +1 -1
  70. package/dist/extraction/markdown-extractor.d.ts.map +1 -1
  71. package/dist/extraction/markdown-extractor.js +3 -1
  72. package/dist/extraction/markdown-extractor.js.map +1 -1
  73. package/dist/generator/frontmatter.d.ts +5 -0
  74. package/dist/generator/frontmatter.d.ts.map +1 -1
  75. package/dist/generator/frontmatter.js +4 -0
  76. package/dist/generator/frontmatter.js.map +1 -1
  77. package/dist/kb-mcp/index.d.ts +14 -0
  78. package/dist/kb-mcp/index.d.ts.map +1 -0
  79. package/dist/kb-mcp/index.js +24 -0
  80. package/dist/kb-mcp/index.js.map +1 -0
  81. package/dist/kb-mcp/lib/kb-error.d.ts +21 -0
  82. package/dist/kb-mcp/lib/kb-error.d.ts.map +1 -0
  83. package/dist/kb-mcp/lib/kb-error.js +28 -0
  84. package/dist/kb-mcp/lib/kb-error.js.map +1 -0
  85. package/dist/kb-mcp/lib/kb-locator.d.ts +58 -0
  86. package/dist/kb-mcp/lib/kb-locator.d.ts.map +1 -0
  87. package/dist/kb-mcp/lib/kb-locator.js +85 -0
  88. package/dist/kb-mcp/lib/kb-locator.js.map +1 -0
  89. package/dist/kb-mcp/lib/result-merger.d.ts +35 -0
  90. package/dist/kb-mcp/lib/result-merger.d.ts.map +1 -0
  91. package/dist/kb-mcp/lib/result-merger.js +64 -0
  92. package/dist/kb-mcp/lib/result-merger.js.map +1 -0
  93. package/dist/kb-mcp/server.d.ts +12 -0
  94. package/dist/kb-mcp/server.d.ts.map +1 -0
  95. package/dist/kb-mcp/server.js +29 -0
  96. package/dist/kb-mcp/server.js.map +1 -0
  97. package/dist/kb-mcp/tools/kb-api-lookup.d.ts +28 -0
  98. package/dist/kb-mcp/tools/kb-api-lookup.d.ts.map +1 -0
  99. package/dist/kb-mcp/tools/kb-api-lookup.js +237 -0
  100. package/dist/kb-mcp/tools/kb-api-lookup.js.map +1 -0
  101. package/dist/kb-mcp/tools/kb-doc-lookup.d.ts +20 -0
  102. package/dist/kb-mcp/tools/kb-doc-lookup.d.ts.map +1 -0
  103. package/dist/kb-mcp/tools/kb-doc-lookup.js +92 -0
  104. package/dist/kb-mcp/tools/kb-doc-lookup.js.map +1 -0
  105. package/dist/kb-mcp/tools/kb-search.d.ts +23 -0
  106. package/dist/kb-mcp/tools/kb-search.d.ts.map +1 -0
  107. package/dist/kb-mcp/tools/kb-search.js +126 -0
  108. package/dist/kb-mcp/tools/kb-search.js.map +1 -0
  109. package/dist/knowledge-graph/import-resolver.d.ts +11 -86
  110. package/dist/knowledge-graph/import-resolver.d.ts.map +1 -1
  111. package/dist/knowledge-graph/import-resolver.js +10 -333
  112. package/dist/knowledge-graph/import-resolver.js.map +1 -1
  113. package/dist/knowledge-graph/incremental.d.ts +25 -4
  114. package/dist/knowledge-graph/incremental.d.ts.map +1 -1
  115. package/dist/knowledge-graph/incremental.js +37 -15
  116. package/dist/knowledge-graph/incremental.js.map +1 -1
  117. package/dist/knowledge-graph/index.d.ts +11 -0
  118. package/dist/knowledge-graph/index.d.ts.map +1 -1
  119. package/dist/knowledge-graph/index.js +43 -1
  120. package/dist/knowledge-graph/index.js.map +1 -1
  121. package/dist/knowledge-graph/module-derivation.d.ts +14 -0
  122. package/dist/knowledge-graph/module-derivation.d.ts.map +1 -1
  123. package/dist/knowledge-graph/module-derivation.js +44 -44
  124. package/dist/knowledge-graph/module-derivation.js.map +1 -1
  125. package/dist/knowledge-graph/persistence.d.ts +56 -16
  126. package/dist/knowledge-graph/persistence.d.ts.map +1 -1
  127. package/dist/knowledge-graph/persistence.js +86 -32
  128. package/dist/knowledge-graph/persistence.js.map +1 -1
  129. package/dist/knowledge-graph/query-helpers.d.ts +39 -12
  130. package/dist/knowledge-graph/query-helpers.d.ts.map +1 -1
  131. package/dist/knowledge-graph/query-helpers.js +199 -34
  132. package/dist/knowledge-graph/query-helpers.js.map +1 -1
  133. package/dist/knowledge-graph/relativize.d.ts +51 -0
  134. package/dist/knowledge-graph/relativize.d.ts.map +1 -0
  135. package/dist/knowledge-graph/relativize.js +104 -0
  136. package/dist/knowledge-graph/relativize.js.map +1 -0
  137. package/dist/mcp/agent-context-tools.d.ts +3 -54
  138. package/dist/mcp/agent-context-tools.d.ts.map +1 -1
  139. package/dist/mcp/agent-context-tools.js +141 -189
  140. package/dist/mcp/agent-context-tools.js.map +1 -1
  141. package/dist/mcp/file-nav-tools.d.ts +42 -0
  142. package/dist/mcp/file-nav-tools.d.ts.map +1 -0
  143. package/dist/mcp/file-nav-tools.js +318 -0
  144. package/dist/mcp/file-nav-tools.js.map +1 -0
  145. package/dist/mcp/graph-tools.d.ts +2 -0
  146. package/dist/mcp/graph-tools.d.ts.map +1 -1
  147. package/dist/mcp/graph-tools.js +134 -123
  148. package/dist/mcp/graph-tools.js.map +1 -1
  149. package/dist/mcp/lib/file-nav-helpers.d.ts +128 -0
  150. package/dist/mcp/lib/file-nav-helpers.d.ts.map +1 -0
  151. package/dist/mcp/lib/file-nav-helpers.js +305 -0
  152. package/dist/mcp/lib/file-nav-helpers.js.map +1 -0
  153. package/dist/mcp/lib/telemetry.d.ts +69 -0
  154. package/dist/mcp/lib/telemetry.d.ts.map +1 -0
  155. package/dist/mcp/lib/telemetry.js +113 -0
  156. package/dist/mcp/lib/telemetry.js.map +1 -0
  157. package/dist/mcp/lib/tool-response.d.ts +46 -0
  158. package/dist/mcp/lib/tool-response.d.ts.map +1 -0
  159. package/dist/mcp/lib/tool-response.js +83 -0
  160. package/dist/mcp/lib/tool-response.js.map +1 -0
  161. package/dist/mcp/server.d.ts +13 -2
  162. package/dist/mcp/server.d.ts.map +1 -1
  163. package/dist/mcp/server.js +209 -150
  164. package/dist/mcp/server.js.map +1 -1
  165. package/dist/models/code-skeleton.d.ts +4 -2
  166. package/dist/models/code-skeleton.d.ts.map +1 -1
  167. package/dist/models/code-skeleton.js +2 -1
  168. package/dist/models/code-skeleton.js.map +1 -1
  169. package/dist/models/module-spec.d.ts +18 -0
  170. package/dist/models/module-spec.d.ts.map +1 -1
  171. package/dist/models/module-spec.js +6 -0
  172. package/dist/models/module-spec.js.map +1 -1
  173. package/dist/panoramic/builders/doc-graph-builder.d.ts +13 -0
  174. package/dist/panoramic/builders/doc-graph-builder.d.ts.map +1 -1
  175. package/dist/panoramic/builders/doc-graph-builder.js +20 -0
  176. package/dist/panoramic/builders/doc-graph-builder.js.map +1 -1
  177. package/dist/panoramic/graph/graph-builder.d.ts +72 -2
  178. package/dist/panoramic/graph/graph-builder.d.ts.map +1 -1
  179. package/dist/panoramic/graph/graph-builder.js +257 -51
  180. package/dist/panoramic/graph/graph-builder.js.map +1 -1
  181. package/dist/panoramic/graph/graph-query.d.ts +16 -0
  182. package/dist/panoramic/graph/graph-query.d.ts.map +1 -1
  183. package/dist/panoramic/graph/graph-query.js +49 -1
  184. package/dist/panoramic/graph/graph-query.js.map +1 -1
  185. package/dist/panoramic/graph/index.d.ts +2 -1
  186. package/dist/panoramic/graph/index.d.ts.map +1 -1
  187. package/dist/panoramic/graph/index.js +1 -1
  188. package/dist/panoramic/graph/index.js.map +1 -1
  189. package/dist/panoramic/pipelines/adr-evidence-verifier.d.ts.map +1 -1
  190. package/dist/panoramic/pipelines/adr-evidence-verifier.js +1 -29
  191. package/dist/panoramic/pipelines/adr-evidence-verifier.js.map +1 -1
  192. package/dist/panoramic/query.d.ts +1 -0
  193. package/dist/panoramic/query.d.ts.map +1 -1
  194. package/dist/panoramic/query.js +5 -0
  195. package/dist/panoramic/query.js.map +1 -1
  196. package/dist/scaffold-kb/api-entities-serializer.d.ts +12 -0
  197. package/dist/scaffold-kb/api-entities-serializer.d.ts.map +1 -0
  198. package/dist/scaffold-kb/api-entities-serializer.js +144 -0
  199. package/dist/scaffold-kb/api-entities-serializer.js.map +1 -0
  200. package/dist/scaffold-kb/arbitration.d.ts +44 -0
  201. package/dist/scaffold-kb/arbitration.d.ts.map +1 -0
  202. package/dist/scaffold-kb/arbitration.js +144 -0
  203. package/dist/scaffold-kb/arbitration.js.map +1 -0
  204. package/dist/scaffold-kb/chunk-splitter.d.ts +20 -0
  205. package/dist/scaffold-kb/chunk-splitter.d.ts.map +1 -0
  206. package/dist/scaffold-kb/chunk-splitter.js +309 -0
  207. package/dist/scaffold-kb/chunk-splitter.js.map +1 -0
  208. package/dist/scaffold-kb/doc-graph-builder.d.ts +26 -0
  209. package/dist/scaffold-kb/doc-graph-builder.d.ts.map +1 -0
  210. package/dist/scaffold-kb/doc-graph-builder.js +72 -0
  211. package/dist/scaffold-kb/doc-graph-builder.js.map +1 -0
  212. package/dist/scaffold-kb/entity-extractor.d.ts +40 -0
  213. package/dist/scaffold-kb/entity-extractor.d.ts.map +1 -0
  214. package/dist/scaffold-kb/entity-extractor.js +0 -0
  215. package/dist/scaffold-kb/entity-extractor.js.map +1 -0
  216. package/dist/scaffold-kb/entity-heuristic.d.ts +14 -0
  217. package/dist/scaffold-kb/entity-heuristic.d.ts.map +1 -0
  218. package/dist/scaffold-kb/entity-heuristic.js +107 -0
  219. package/dist/scaffold-kb/entity-heuristic.js.map +1 -0
  220. package/dist/scaffold-kb/entity-matcher.d.ts +20 -0
  221. package/dist/scaffold-kb/entity-matcher.d.ts.map +1 -0
  222. package/dist/scaffold-kb/entity-matcher.js +53 -0
  223. package/dist/scaffold-kb/entity-matcher.js.map +1 -0
  224. package/dist/scaffold-kb/entity-util.d.ts +11 -0
  225. package/dist/scaffold-kb/entity-util.d.ts.map +1 -0
  226. package/dist/scaffold-kb/entity-util.js +23 -0
  227. package/dist/scaffold-kb/entity-util.js.map +1 -0
  228. package/dist/scaffold-kb/evidence-envelope.d.ts +17 -0
  229. package/dist/scaffold-kb/evidence-envelope.d.ts.map +1 -0
  230. package/dist/scaffold-kb/evidence-envelope.js +32 -0
  231. package/dist/scaffold-kb/evidence-envelope.js.map +1 -0
  232. package/dist/scaffold-kb/index.d.ts +20 -0
  233. package/dist/scaffold-kb/index.d.ts.map +1 -0
  234. package/dist/scaffold-kb/index.js +102 -0
  235. package/dist/scaffold-kb/index.js.map +1 -0
  236. package/dist/scaffold-kb/ingest/ingest-core.d.ts +47 -0
  237. package/dist/scaffold-kb/ingest/ingest-core.d.ts.map +1 -0
  238. package/dist/scaffold-kb/ingest/ingest-core.js +231 -0
  239. package/dist/scaffold-kb/ingest/ingest-core.js.map +1 -0
  240. package/dist/scaffold-kb/ingest/office-parser.d.ts +33 -0
  241. package/dist/scaffold-kb/ingest/office-parser.d.ts.map +1 -0
  242. package/dist/scaffold-kb/ingest/office-parser.js +187 -0
  243. package/dist/scaffold-kb/ingest/office-parser.js.map +1 -0
  244. package/dist/scaffold-kb/ingest/url-fetcher.d.ts +43 -0
  245. package/dist/scaffold-kb/ingest/url-fetcher.d.ts.map +1 -0
  246. package/dist/scaffold-kb/ingest/url-fetcher.js +245 -0
  247. package/dist/scaffold-kb/ingest/url-fetcher.js.map +1 -0
  248. package/dist/scaffold-kb/ingester.d.ts +38 -0
  249. package/dist/scaffold-kb/ingester.d.ts.map +1 -0
  250. package/dist/scaffold-kb/ingester.js +261 -0
  251. package/dist/scaffold-kb/ingester.js.map +1 -0
  252. package/dist/scaffold-kb/injection-format.d.ts +25 -0
  253. package/dist/scaffold-kb/injection-format.d.ts.map +1 -0
  254. package/dist/scaffold-kb/injection-format.js +55 -0
  255. package/dist/scaffold-kb/injection-format.js.map +1 -0
  256. package/dist/scaffold-kb/kb-writer.d.ts +13 -0
  257. package/dist/scaffold-kb/kb-writer.d.ts.map +1 -0
  258. package/dist/scaffold-kb/kb-writer.js +69 -0
  259. package/dist/scaffold-kb/kb-writer.js.map +1 -0
  260. package/dist/scaffold-kb/keyword-extract.d.ts +16 -0
  261. package/dist/scaffold-kb/keyword-extract.d.ts.map +1 -0
  262. package/dist/scaffold-kb/keyword-extract.js +49 -0
  263. package/dist/scaffold-kb/keyword-extract.js.map +1 -0
  264. package/dist/scaffold-kb/query-sanitizer.d.ts +28 -0
  265. package/dist/scaffold-kb/query-sanitizer.d.ts.map +1 -0
  266. package/dist/scaffold-kb/query-sanitizer.js +38 -0
  267. package/dist/scaffold-kb/query-sanitizer.js.map +1 -0
  268. package/dist/scaffold-kb/recall-eval.d.ts +48 -0
  269. package/dist/scaffold-kb/recall-eval.d.ts.map +1 -0
  270. package/dist/scaffold-kb/recall-eval.js +55 -0
  271. package/dist/scaffold-kb/recall-eval.js.map +1 -0
  272. package/dist/scaffold-kb/schema-compat.d.ts +22 -0
  273. package/dist/scaffold-kb/schema-compat.d.ts.map +1 -0
  274. package/dist/scaffold-kb/schema-compat.js +32 -0
  275. package/dist/scaffold-kb/schema-compat.js.map +1 -0
  276. package/dist/scaffold-kb/search-core.d.ts +42 -0
  277. package/dist/scaffold-kb/search-core.d.ts.map +1 -0
  278. package/dist/scaffold-kb/search-core.js +89 -0
  279. package/dist/scaffold-kb/search-core.js.map +1 -0
  280. package/dist/scaffold-kb/sqlite-engine.d.ts +58 -0
  281. package/dist/scaffold-kb/sqlite-engine.d.ts.map +1 -0
  282. package/dist/scaffold-kb/sqlite-engine.js +61 -0
  283. package/dist/scaffold-kb/sqlite-engine.js.map +1 -0
  284. package/dist/scaffold-kb/sqlite-writer.d.ts +18 -0
  285. package/dist/scaffold-kb/sqlite-writer.d.ts.map +1 -0
  286. package/dist/scaffold-kb/sqlite-writer.js +76 -0
  287. package/dist/scaffold-kb/sqlite-writer.js.map +1 -0
  288. package/dist/scaffold-kb/tokenizer.d.ts +26 -0
  289. package/dist/scaffold-kb/tokenizer.d.ts.map +1 -0
  290. package/dist/scaffold-kb/tokenizer.js +97 -0
  291. package/dist/scaffold-kb/tokenizer.js.map +1 -0
  292. package/dist/scaffold-kb/types.d.ts +157 -0
  293. package/dist/scaffold-kb/types.d.ts.map +1 -0
  294. package/dist/scaffold-kb/types.js +5 -0
  295. package/dist/scaffold-kb/types.js.map +1 -0
  296. package/dist/utils/file-scanner.d.ts +15 -0
  297. package/dist/utils/file-scanner.d.ts.map +1 -1
  298. package/dist/utils/file-scanner.js +17 -0
  299. package/dist/utils/file-scanner.js.map +1 -1
  300. package/dist/utils/string-distance.d.ts +20 -0
  301. package/dist/utils/string-distance.d.ts.map +1 -0
  302. package/dist/utils/string-distance.js +38 -0
  303. package/dist/utils/string-distance.js.map +1 -0
  304. package/package.json +11 -2
  305. package/plugins/demo-kb-en/.claude-plugin/plugin.json +11 -0
  306. package/plugins/demo-kb-en/.mcp.json +8 -0
  307. package/plugins/demo-kb-en/FIXTURE.json +23 -0
  308. package/plugins/demo-kb-en/FIXTURE.md +53 -0
  309. package/plugins/demo-kb-en/ingest-samples/meeting-notes.md +13 -0
  310. package/plugins/demo-kb-en/kb/api-entities.json +3445 -0
  311. package/plugins/demo-kb-en/kb/chunks.sqlite +0 -0
  312. package/plugins/demo-kb-en/kb/doc-graph.json +113 -0
  313. package/plugins/demo-kb-zh/.claude-plugin/plugin.json +11 -0
  314. package/plugins/demo-kb-zh/.mcp.json +8 -0
  315. package/plugins/demo-kb-zh/FIXTURE.json +23 -0
  316. package/plugins/demo-kb-zh/FIXTURE.md +63 -0
  317. package/plugins/demo-kb-zh/ingest-samples/meeting-notes.md +13 -0
  318. package/plugins/demo-kb-zh/kb/api-entities.json +990 -0
  319. package/plugins/demo-kb-zh/kb/chunks.sqlite +0 -0
  320. package/plugins/demo-kb-zh/kb/doc-graph.json +113 -0
  321. package/plugins/spec-driver/.claude-plugin/plugin.json +1 -1
  322. package/plugins/spec-driver/README.md +33 -1
  323. package/plugins/spec-driver/agents/verify.md +88 -0
  324. package/plugins/spec-driver/config/orchestration.yaml +39 -31
  325. package/plugins/spec-driver/contracts/orchestration-overrides-contract.yaml +27 -0
  326. package/plugins/spec-driver/contracts/orchestration-schema.mjs +272 -227
  327. package/plugins/spec-driver/contracts/wrapper-source-of-truth.yaml +3 -0
  328. package/plugins/spec-driver/hooks/hooks.json +9 -0
  329. package/plugins/spec-driver/hooks/stop-fix-compliance-check.sh +36 -0
  330. package/plugins/spec-driver/lib/delegation-contract.mjs +84 -0
  331. package/plugins/spec-driver/lib/orchestration-resolver.mjs +49 -0
  332. package/plugins/spec-driver/lib/orchestrator.mjs +29 -1
  333. package/plugins/spec-driver/scripts/codex-skills.sh +28 -28
  334. package/plugins/spec-driver/scripts/dev/spike-fix-compliance-e2e.mjs +130 -0
  335. package/plugins/spec-driver/scripts/fix-compliance-judge.mjs +415 -0
  336. package/plugins/spec-driver/scripts/generate-adoption-insights.mjs +48 -1
  337. package/plugins/spec-driver/scripts/goal-loop-cli.mjs +307 -0
  338. package/plugins/spec-driver/scripts/init-project.sh +56 -0
  339. package/plugins/spec-driver/scripts/kb-prequery.mjs +125 -0
  340. package/plugins/spec-driver/scripts/lib/config-schema.mjs +200 -94
  341. package/plugins/spec-driver/scripts/lib/ensure-gitignore.sh +277 -0
  342. package/plugins/spec-driver/scripts/lib/extract-wrapper-body.mjs +136 -0
  343. package/plugins/spec-driver/scripts/lib/fix-compliance-core.mjs +434 -0
  344. package/plugins/spec-driver/scripts/lib/fix-compliance-io.mjs +335 -0
  345. package/plugins/spec-driver/scripts/lib/goal-loop-core.mjs +783 -0
  346. package/plugins/spec-driver/scripts/lib/init-project-output.sh +28 -0
  347. package/plugins/spec-driver/scripts/lib/load-zod.mjs +62 -0
  348. package/plugins/spec-driver/scripts/lib/project-profile-resolver.mjs +141 -49
  349. package/plugins/spec-driver/scripts/lib/project-profile-schema.mjs +88 -54
  350. package/plugins/spec-driver/scripts/postinstall.sh +13 -1
  351. package/plugins/spec-driver/scripts/record-workflow-run.mjs +75 -0
  352. package/plugins/spec-driver/scripts/sync-delegation-contract.mjs +187 -0
  353. package/plugins/spec-driver/scripts/validate-orchestrator-models.mjs +156 -0
  354. package/plugins/spec-driver/scripts/validate-wrapper-sources.mjs +46 -1
  355. package/plugins/spec-driver/skills/spec-driver-feature/SKILL.md +292 -0
  356. package/plugins/spec-driver/skills/spec-driver-fix/SKILL.md +87 -8
  357. package/plugins/spec-driver/skills/spec-driver-implement/SKILL.md +8 -0
  358. package/plugins/spec-driver/skills/spec-driver-resume/SKILL.md +12 -1
  359. package/plugins/spec-driver/skills/spec-driver-story/SKILL.md +20 -0
  360. package/plugins/spec-driver/templates/delegation-contract.md +27 -0
  361. package/plugins/spec-driver/templates/goal-loop-override-template.yaml +284 -0
  362. package/plugins/spec-driver/templates/specify-base/project-context-template.yaml +10 -0
  363. package/plugins/spectra/.claude-plugin/plugin.json +1 -1
  364. package/plugins/spectra/README.md +1 -1
  365. 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;AAkEnE;;;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,CAkBP;AA+BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8O1D"}
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"}