@flyingrobots/graft 0.7.0 → 0.8.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 (561) hide show
  1. package/CHANGELOG.md +153 -0
  2. package/README.md +33 -17
  3. package/bin/graft.js +26 -26
  4. package/dist/api/index.d.ts +3 -0
  5. package/dist/api/index.d.ts.map +1 -1
  6. package/dist/api/index.js +2 -0
  7. package/dist/api/index.js.map +1 -1
  8. package/dist/cli/cli-error.d.ts.map +1 -1
  9. package/dist/cli/cli-error.js +22 -3
  10. package/dist/cli/cli-error.js.map +1 -1
  11. package/dist/cli/command-parser.d.ts.map +1 -1
  12. package/dist/cli/command-parser.js +62 -6
  13. package/dist/cli/command-parser.js.map +1 -1
  14. package/dist/cli/dead-symbols-render.d.ts +2 -0
  15. package/dist/cli/dead-symbols-render.d.ts.map +1 -0
  16. package/dist/cli/dead-symbols-render.js +23 -0
  17. package/dist/cli/dead-symbols-render.js.map +1 -0
  18. package/dist/cli/doctor-render.d.ts +2 -0
  19. package/dist/cli/doctor-render.d.ts.map +1 -0
  20. package/dist/cli/doctor-render.js +80 -0
  21. package/dist/cli/doctor-render.js.map +1 -0
  22. package/dist/cli/entrypoint.d.ts +1 -0
  23. package/dist/cli/entrypoint.d.ts.map +1 -1
  24. package/dist/cli/entrypoint.js +1 -0
  25. package/dist/cli/entrypoint.js.map +1 -1
  26. package/dist/cli/git-graft-enhance-model.d.ts +33 -3
  27. package/dist/cli/git-graft-enhance-model.d.ts.map +1 -1
  28. package/dist/cli/git-graft-enhance-model.js +38 -0
  29. package/dist/cli/git-graft-enhance-model.js.map +1 -1
  30. package/dist/cli/git-graft-enhance-render.d.ts.map +1 -1
  31. package/dist/cli/git-graft-enhance-render.js +13 -0
  32. package/dist/cli/git-graft-enhance-render.js.map +1 -1
  33. package/dist/cli/git-graft-enhance.d.ts.map +1 -1
  34. package/dist/cli/git-graft-enhance.js +44 -1
  35. package/dist/cli/git-graft-enhance.js.map +1 -1
  36. package/dist/cli/index-cmd.d.ts +1 -0
  37. package/dist/cli/index-cmd.d.ts.map +1 -1
  38. package/dist/cli/index-cmd.js +3 -0
  39. package/dist/cli/index-cmd.js.map +1 -1
  40. package/dist/cli/init-client-config.d.ts.map +1 -1
  41. package/dist/cli/init-client-config.js +40 -4
  42. package/dist/cli/init-client-config.js.map +1 -1
  43. package/dist/cli/init-model.js +2 -2
  44. package/dist/cli/init-model.js.map +1 -1
  45. package/dist/cli/json-document.d.ts +1 -0
  46. package/dist/cli/json-document.d.ts.map +1 -1
  47. package/dist/cli/json-document.js +3 -0
  48. package/dist/cli/json-document.js.map +1 -1
  49. package/dist/cli/main.d.ts +2 -0
  50. package/dist/cli/main.d.ts.map +1 -1
  51. package/dist/cli/main.js +24 -2
  52. package/dist/cli/main.js.map +1 -1
  53. package/dist/cli/peer-command.d.ts.map +1 -1
  54. package/dist/cli/peer-command.js +25 -0
  55. package/dist/cli/peer-command.js.map +1 -1
  56. package/dist/cli/review-cooldown.d.ts +15 -0
  57. package/dist/cli/review-cooldown.d.ts.map +1 -0
  58. package/dist/cli/review-cooldown.js +136 -0
  59. package/dist/cli/review-cooldown.js.map +1 -0
  60. package/dist/cli/structural-blame-render.d.ts +2 -0
  61. package/dist/cli/structural-blame-render.d.ts.map +1 -0
  62. package/dist/cli/structural-blame-render.js +39 -0
  63. package/dist/cli/structural-blame-render.js.map +1 -0
  64. package/dist/cli/structural-review-render.d.ts +2 -0
  65. package/dist/cli/structural-review-render.d.ts.map +1 -0
  66. package/dist/cli/structural-review-render.js +56 -0
  67. package/dist/cli/structural-review-render.js.map +1 -0
  68. package/dist/cli/structural-test-coverage-render.d.ts +2 -0
  69. package/dist/cli/structural-test-coverage-render.d.ts.map +1 -0
  70. package/dist/cli/structural-test-coverage-render.js +46 -0
  71. package/dist/cli/structural-test-coverage-render.js.map +1 -0
  72. package/dist/contracts/capabilities.d.ts +9 -6
  73. package/dist/contracts/capabilities.d.ts.map +1 -1
  74. package/dist/contracts/capabilities.js +40 -1
  75. package/dist/contracts/capabilities.js.map +1 -1
  76. package/dist/contracts/causal-ontology.d.ts +17 -17
  77. package/dist/contracts/output-schema-cli.d.ts +103 -41
  78. package/dist/contracts/output-schema-cli.d.ts.map +1 -1
  79. package/dist/contracts/output-schema-cli.js +29 -0
  80. package/dist/contracts/output-schema-cli.js.map +1 -1
  81. package/dist/contracts/output-schema-fragments.d.ts +76 -76
  82. package/dist/contracts/output-schema-mcp.d.ts +87 -62
  83. package/dist/contracts/output-schema-mcp.d.ts.map +1 -1
  84. package/dist/contracts/output-schema-mcp.js +43 -21
  85. package/dist/contracts/output-schema-mcp.js.map +1 -1
  86. package/dist/contracts/output-schema-meta.d.ts +2 -2
  87. package/dist/contracts/output-schema-meta.d.ts.map +1 -1
  88. package/dist/contracts/output-schemas.d.ts +7 -7
  89. package/dist/contracts/output-schemas.d.ts.map +1 -1
  90. package/dist/contracts/output-schemas.js +69 -1
  91. package/dist/contracts/output-schemas.js.map +1 -1
  92. package/dist/git/version-guard.d.ts +17 -0
  93. package/dist/git/version-guard.d.ts.map +1 -0
  94. package/dist/git/version-guard.js +51 -0
  95. package/dist/git/version-guard.js.map +1 -0
  96. package/dist/hooks/posttooluse-read.js +3 -3
  97. package/dist/hooks/posttooluse-read.js.map +1 -1
  98. package/dist/hooks/pretooluse-read.js +1 -1
  99. package/dist/hooks/pretooluse-read.js.map +1 -1
  100. package/dist/mcp/burden.d.ts.map +1 -1
  101. package/dist/mcp/burden.js +2 -0
  102. package/dist/mcp/burden.js.map +1 -1
  103. package/dist/mcp/daemon-server.d.ts.map +1 -1
  104. package/dist/mcp/daemon-server.js +2 -0
  105. package/dist/mcp/daemon-server.js.map +1 -1
  106. package/dist/mcp/daemon-worker-child-pool.d.ts +2 -0
  107. package/dist/mcp/daemon-worker-child-pool.d.ts.map +1 -1
  108. package/dist/mcp/daemon-worker-child-pool.js +10 -3
  109. package/dist/mcp/daemon-worker-child-pool.js.map +1 -1
  110. package/dist/mcp/daemon-worker-pool.d.ts +1 -1
  111. package/dist/mcp/daemon-worker-pool.d.ts.map +1 -1
  112. package/dist/mcp/daemon-worker-pool.js +1 -1
  113. package/dist/mcp/daemon-worker-pool.js.map +1 -1
  114. package/dist/mcp/persisted-local-history-graph.d.ts.map +1 -1
  115. package/dist/mcp/persisted-local-history-graph.js +2 -1
  116. package/dist/mcp/persisted-local-history-graph.js.map +1 -1
  117. package/dist/mcp/persisted-local-history.d.ts +5 -5
  118. package/dist/mcp/repo-tool-job.d.ts.map +1 -1
  119. package/dist/mcp/repo-tool-job.js +2 -0
  120. package/dist/mcp/repo-tool-job.js.map +1 -1
  121. package/dist/mcp/server-invocation.d.ts.map +1 -1
  122. package/dist/mcp/server-invocation.js +206 -147
  123. package/dist/mcp/server-invocation.js.map +1 -1
  124. package/dist/mcp/server.d.ts.map +1 -1
  125. package/dist/mcp/server.js +184 -116
  126. package/dist/mcp/server.js.map +1 -1
  127. package/dist/mcp/stdio-server.d.ts.map +1 -1
  128. package/dist/mcp/stdio-server.js +2 -0
  129. package/dist/mcp/stdio-server.js.map +1 -1
  130. package/dist/mcp/tool-registry.d.ts.map +1 -1
  131. package/dist/mcp/tool-registry.js +4 -0
  132. package/dist/mcp/tool-registry.js.map +1 -1
  133. package/dist/mcp/tools/changed-since.d.ts.map +1 -1
  134. package/dist/mcp/tools/changed-since.js +10 -3
  135. package/dist/mcp/tools/changed-since.js.map +1 -1
  136. package/dist/mcp/tools/dead-symbols.d.ts +3 -0
  137. package/dist/mcp/tools/dead-symbols.d.ts.map +1 -0
  138. package/dist/mcp/tools/dead-symbols.js +33 -0
  139. package/dist/mcp/tools/dead-symbols.js.map +1 -0
  140. package/dist/mcp/tools/map.d.ts.map +1 -1
  141. package/dist/mcp/tools/map.js +2 -0
  142. package/dist/mcp/tools/map.js.map +1 -1
  143. package/dist/mcp/tools/precision-warp.d.ts.map +1 -1
  144. package/dist/mcp/tools/precision-warp.js +2 -6
  145. package/dist/mcp/tools/precision-warp.js.map +1 -1
  146. package/dist/mcp/tools/refactor-difficulty.d.ts.map +1 -1
  147. package/dist/mcp/tools/refactor-difficulty.js +2 -0
  148. package/dist/mcp/tools/refactor-difficulty.js.map +1 -1
  149. package/dist/mcp/tools/safe-read.d.ts.map +1 -1
  150. package/dist/mcp/tools/safe-read.js +10 -105
  151. package/dist/mcp/tools/safe-read.js.map +1 -1
  152. package/dist/mcp/tools/structural-test-coverage.d.ts +3 -0
  153. package/dist/mcp/tools/structural-test-coverage.d.ts.map +1 -0
  154. package/dist/mcp/tools/structural-test-coverage.js +35 -0
  155. package/dist/mcp/tools/structural-test-coverage.js.map +1 -0
  156. package/dist/operations/cached-file.d.ts +6 -2
  157. package/dist/operations/cached-file.d.ts.map +1 -1
  158. package/dist/operations/cached-file.js +30 -6
  159. package/dist/operations/cached-file.js.map +1 -1
  160. package/dist/operations/export-surface-diff.d.ts.map +1 -1
  161. package/dist/operations/export-surface-diff.js +2 -0
  162. package/dist/operations/export-surface-diff.js.map +1 -1
  163. package/dist/operations/file-outline.js +2 -2
  164. package/dist/operations/file-outline.js.map +1 -1
  165. package/dist/operations/graft-diff.d.ts.map +1 -1
  166. package/dist/operations/graft-diff.js +2 -0
  167. package/dist/operations/graft-diff.js.map +1 -1
  168. package/dist/operations/projection-safety.d.ts.map +1 -1
  169. package/dist/operations/projection-safety.js +2 -0
  170. package/dist/operations/projection-safety.js.map +1 -1
  171. package/dist/operations/repo-workspace.d.ts.map +1 -1
  172. package/dist/operations/repo-workspace.js +26 -8
  173. package/dist/operations/repo-workspace.js.map +1 -1
  174. package/dist/operations/review-cooldown-status.d.ts +27 -0
  175. package/dist/operations/review-cooldown-status.d.ts.map +1 -0
  176. package/dist/operations/review-cooldown-status.js +115 -0
  177. package/dist/operations/review-cooldown-status.js.map +1 -0
  178. package/dist/operations/safe-read.js +2 -2
  179. package/dist/operations/safe-read.js.map +1 -1
  180. package/dist/operations/sludge-detector.d.ts.map +1 -1
  181. package/dist/operations/sludge-detector.js +2 -1
  182. package/dist/operations/sludge-detector.js.map +1 -1
  183. package/dist/operations/structural-review.js +8 -8
  184. package/dist/operations/structural-review.js.map +1 -1
  185. package/dist/operations/structural-test-coverage-map.d.ts +44 -0
  186. package/dist/operations/structural-test-coverage-map.d.ts.map +1 -0
  187. package/dist/operations/structural-test-coverage-map.js +331 -0
  188. package/dist/operations/structural-test-coverage-map.js.map +1 -0
  189. package/dist/operations/structured-buffer-compare.d.ts.map +1 -1
  190. package/dist/operations/structured-buffer-compare.js +4 -1
  191. package/dist/operations/structured-buffer-compare.js.map +1 -1
  192. package/dist/operations/structured-buffer-model.d.ts +15 -13
  193. package/dist/operations/structured-buffer-model.d.ts.map +1 -1
  194. package/dist/operations/structured-buffer-model.js +24 -5
  195. package/dist/operations/structured-buffer-model.js.map +1 -1
  196. package/dist/operations/structured-buffer-query.d.ts.map +1 -1
  197. package/dist/operations/structured-buffer-query.js +21 -12
  198. package/dist/operations/structured-buffer-query.js.map +1 -1
  199. package/dist/parser/extractors/common.d.ts +16 -0
  200. package/dist/parser/extractors/common.d.ts.map +1 -0
  201. package/dist/parser/extractors/common.js +23 -0
  202. package/dist/parser/extractors/common.js.map +1 -0
  203. package/dist/parser/extractors/go.d.ts +18 -0
  204. package/dist/parser/extractors/go.d.ts.map +1 -0
  205. package/dist/parser/extractors/go.js +200 -0
  206. package/dist/parser/extractors/go.js.map +1 -0
  207. package/dist/parser/extractors/graphql.d.ts +26 -0
  208. package/dist/parser/extractors/graphql.d.ts.map +1 -0
  209. package/dist/parser/extractors/graphql.js +239 -0
  210. package/dist/parser/extractors/graphql.js.map +1 -0
  211. package/dist/parser/extractors/index.d.ts +4 -0
  212. package/dist/parser/extractors/index.d.ts.map +1 -0
  213. package/dist/parser/extractors/index.js +26 -0
  214. package/dist/parser/extractors/index.js.map +1 -0
  215. package/dist/parser/extractors/json.d.ts +10 -0
  216. package/dist/parser/extractors/json.d.ts.map +1 -0
  217. package/dist/parser/extractors/json.js +75 -0
  218. package/dist/parser/extractors/json.js.map +1 -0
  219. package/dist/parser/extractors/python.d.ts +16 -0
  220. package/dist/parser/extractors/python.d.ts.map +1 -0
  221. package/dist/parser/extractors/python.js +145 -0
  222. package/dist/parser/extractors/python.js.map +1 -0
  223. package/dist/parser/extractors/rust.d.ts +12 -0
  224. package/dist/parser/extractors/rust.d.ts.map +1 -0
  225. package/dist/parser/extractors/rust.js +122 -0
  226. package/dist/parser/extractors/rust.js.map +1 -0
  227. package/dist/parser/extractors/toml.d.ts +10 -0
  228. package/dist/parser/extractors/toml.d.ts.map +1 -0
  229. package/dist/parser/extractors/toml.js +74 -0
  230. package/dist/parser/extractors/toml.js.map +1 -0
  231. package/dist/parser/extractors/typescript.d.ts +13 -0
  232. package/dist/parser/extractors/typescript.d.ts.map +1 -0
  233. package/dist/parser/extractors/typescript.js +179 -0
  234. package/dist/parser/extractors/typescript.js.map +1 -0
  235. package/dist/parser/extractors/yaml.d.ts +13 -0
  236. package/dist/parser/extractors/yaml.d.ts.map +1 -0
  237. package/dist/parser/extractors/yaml.js +93 -0
  238. package/dist/parser/extractors/yaml.js.map +1 -0
  239. package/dist/parser/lang.d.ts +2 -2
  240. package/dist/parser/lang.d.ts.map +1 -1
  241. package/dist/parser/lang.js +19 -1
  242. package/dist/parser/lang.js.map +1 -1
  243. package/dist/parser/outline.d.ts +4 -0
  244. package/dist/parser/outline.d.ts.map +1 -1
  245. package/dist/parser/outline.js +32 -221
  246. package/dist/parser/outline.js.map +1 -1
  247. package/dist/parser/runtime.d.ts +7 -0
  248. package/dist/parser/runtime.d.ts.map +1 -1
  249. package/dist/parser/runtime.js +99 -10
  250. package/dist/parser/runtime.js.map +1 -1
  251. package/dist/parser/types.d.ts +1 -1
  252. package/dist/parser/types.d.ts.map +1 -1
  253. package/dist/parser/types.js.map +1 -1
  254. package/dist/ports/provenance-timeline.d.ts +10 -0
  255. package/dist/ports/provenance-timeline.d.ts.map +1 -0
  256. package/dist/ports/provenance-timeline.js +17 -0
  257. package/dist/ports/provenance-timeline.js.map +1 -0
  258. package/dist/ports/semantic-enrichment.d.ts +47 -0
  259. package/dist/ports/semantic-enrichment.d.ts.map +1 -0
  260. package/dist/ports/semantic-enrichment.js +2 -0
  261. package/dist/ports/semantic-enrichment.js.map +1 -0
  262. package/dist/version.d.ts.map +1 -1
  263. package/dist/version.js +3 -1
  264. package/dist/version.js.map +1 -1
  265. package/dist/warp/ast-import-resolver.d.ts.map +1 -1
  266. package/dist/warp/ast-import-resolver.js +2 -1
  267. package/dist/warp/ast-import-resolver.js.map +1 -1
  268. package/dist/warp/dead-symbols.d.ts.map +1 -1
  269. package/dist/warp/dead-symbols.js +4 -7
  270. package/dist/warp/dead-symbols.js.map +1 -1
  271. package/dist/warp/index-head.d.ts +4 -0
  272. package/dist/warp/index-head.d.ts.map +1 -1
  273. package/dist/warp/index-head.js +255 -22
  274. package/dist/warp/index-head.js.map +1 -1
  275. package/dist/warp/observers.d.ts.map +1 -1
  276. package/dist/warp/observers.js +3 -2
  277. package/dist/warp/observers.js.map +1 -1
  278. package/dist/warp/refactor-difficulty.d.ts.map +1 -1
  279. package/dist/warp/refactor-difficulty.js +4 -9
  280. package/dist/warp/refactor-difficulty.js.map +1 -1
  281. package/dist/warp/references.d.ts.map +1 -1
  282. package/dist/warp/references.js +2 -1
  283. package/dist/warp/references.js.map +1 -1
  284. package/dist/warp/semantic-enrichment.d.ts +14 -0
  285. package/dist/warp/semantic-enrichment.d.ts.map +1 -0
  286. package/dist/warp/semantic-enrichment.js +55 -0
  287. package/dist/warp/semantic-enrichment.js.map +1 -0
  288. package/dist/warp/structural-queries.d.ts.map +1 -1
  289. package/dist/warp/structural-queries.js +7 -14
  290. package/dist/warp/structural-queries.js.map +1 -1
  291. package/dist/warp/sym-id-codec.d.ts +14 -0
  292. package/dist/warp/sym-id-codec.d.ts.map +1 -0
  293. package/dist/warp/sym-id-codec.js +47 -0
  294. package/dist/warp/sym-id-codec.js.map +1 -0
  295. package/dist/warp/symbol-timeline.d.ts.map +1 -1
  296. package/dist/warp/symbol-timeline.js +6 -14
  297. package/dist/warp/symbol-timeline.js.map +1 -1
  298. package/dist/warp/warp-structural-churn.d.ts.map +1 -1
  299. package/dist/warp/warp-structural-churn.js +6 -10
  300. package/dist/warp/warp-structural-churn.js.map +1 -1
  301. package/dist/warp/warp-structural-log.d.ts.map +1 -1
  302. package/dist/warp/warp-structural-log.js +8 -10
  303. package/dist/warp/warp-structural-log.js.map +1 -1
  304. package/docs/CLI.md +63 -5
  305. package/docs/MCP.md +2 -1
  306. package/docs/SETUP.md +11 -7
  307. package/package.json +12 -4
  308. package/src/adapters/canonical-json.ts +0 -56
  309. package/src/adapters/json-text-decoder.ts +0 -11
  310. package/src/adapters/node-fs.ts +0 -43
  311. package/src/adapters/node-git.ts +0 -47
  312. package/src/adapters/node-paths.ts +0 -35
  313. package/src/adapters/node-process-runner.ts +0 -27
  314. package/src/adapters/repo-paths.ts +0 -63
  315. package/src/adapters/rotating-ndjson-log.ts +0 -66
  316. package/src/api/index.ts +0 -107
  317. package/src/api/repo-local-graft.ts +0 -21
  318. package/src/api/repo-workspace.ts +0 -34
  319. package/src/api/tool-bridge.ts +0 -22
  320. package/src/cli/activity-render.ts +0 -112
  321. package/src/cli/cli-error.ts +0 -192
  322. package/src/cli/command-parser.ts +0 -484
  323. package/src/cli/daemon-status-model.ts +0 -238
  324. package/src/cli/daemon-status-render.ts +0 -102
  325. package/src/cli/daemon-status.ts +0 -100
  326. package/src/cli/entrypoint.ts +0 -18
  327. package/src/cli/git-graft-enhance-model.ts +0 -131
  328. package/src/cli/git-graft-enhance-render.ts +0 -33
  329. package/src/cli/git-graft-enhance.ts +0 -54
  330. package/src/cli/index-cmd.ts +0 -90
  331. package/src/cli/index-model.ts +0 -75
  332. package/src/cli/init-bootstrap.ts +0 -47
  333. package/src/cli/init-client-config.ts +0 -428
  334. package/src/cli/init-model.ts +0 -284
  335. package/src/cli/init-render.ts +0 -54
  336. package/src/cli/init-target-hooks.ts +0 -93
  337. package/src/cli/init.ts +0 -124
  338. package/src/cli/json-document.ts +0 -155
  339. package/src/cli/local-history-dag-model.ts +0 -437
  340. package/src/cli/local-history-dag-render.ts +0 -133
  341. package/src/cli/local-history-dag.ts +0 -103
  342. package/src/cli/main.ts +0 -197
  343. package/src/cli/migrate-local-history.ts +0 -119
  344. package/src/cli/peer-command.ts +0 -60
  345. package/src/contracts/capabilities.ts +0 -540
  346. package/src/contracts/causal-ontology.ts +0 -627
  347. package/src/contracts/causal-surface-next-action.ts +0 -18
  348. package/src/contracts/json-object.ts +0 -18
  349. package/src/contracts/mcp-runtime.ts +0 -16
  350. package/src/contracts/output-schema-cli.ts +0 -103
  351. package/src/contracts/output-schema-fragments.ts +0 -881
  352. package/src/contracts/output-schema-mcp.ts +0 -501
  353. package/src/contracts/output-schema-meta.ts +0 -119
  354. package/src/contracts/output-schemas.ts +0 -1524
  355. package/src/git/diff.ts +0 -161
  356. package/src/git/target-git-hook-bootstrap.ts +0 -56
  357. package/src/guards/stream-boundary.ts +0 -110
  358. package/src/hooks/posttooluse-read.ts +0 -54
  359. package/src/hooks/pretooluse-read.ts +0 -52
  360. package/src/hooks/read-governor.ts +0 -95
  361. package/src/hooks/read-messages.ts +0 -53
  362. package/src/hooks/shared.ts +0 -168
  363. package/src/index.ts +0 -1
  364. package/src/mcp/burden.ts +0 -132
  365. package/src/mcp/cache.ts +0 -7
  366. package/src/mcp/cached-file.ts +0 -1
  367. package/src/mcp/context.ts +0 -150
  368. package/src/mcp/control-plane/authz-storage.ts +0 -129
  369. package/src/mcp/control-plane/session-registry.ts +0 -115
  370. package/src/mcp/control-plane/status-projection.ts +0 -76
  371. package/src/mcp/control-plane/types.ts +0 -144
  372. package/src/mcp/daemon-bootstrap.ts +0 -100
  373. package/src/mcp/daemon-control-plane.ts +0 -310
  374. package/src/mcp/daemon-job-scheduler.ts +0 -279
  375. package/src/mcp/daemon-repos.ts +0 -99
  376. package/src/mcp/daemon-server.ts +0 -172
  377. package/src/mcp/daemon-session-host.ts +0 -234
  378. package/src/mcp/daemon-stdio-bridge.ts +0 -262
  379. package/src/mcp/daemon-worker-child-pool.ts +0 -213
  380. package/src/mcp/daemon-worker-inline-pool.ts +0 -46
  381. package/src/mcp/daemon-worker-pool.ts +0 -7
  382. package/src/mcp/daemon-worker-process.ts +0 -52
  383. package/src/mcp/daemon-worker-types.ts +0 -66
  384. package/src/mcp/metrics.ts +0 -176
  385. package/src/mcp/monitor-health.ts +0 -83
  386. package/src/mcp/monitor-persistence.ts +0 -54
  387. package/src/mcp/monitor-tick-job.ts +0 -153
  388. package/src/mcp/monitor-types.ts +0 -103
  389. package/src/mcp/persisted-local-history-graph.ts +0 -592
  390. package/src/mcp/persisted-local-history-policy.ts +0 -501
  391. package/src/mcp/persisted-local-history-views.ts +0 -250
  392. package/src/mcp/persisted-local-history.ts +0 -1621
  393. package/src/mcp/persistent-monitor-runtime.ts +0 -482
  394. package/src/mcp/policy.ts +0 -75
  395. package/src/mcp/receipt.ts +0 -201
  396. package/src/mcp/repo-concurrency.ts +0 -392
  397. package/src/mcp/repo-overview/filter.ts +0 -44
  398. package/src/mcp/repo-overview/types.ts +0 -63
  399. package/src/mcp/repo-overview/view-projection.ts +0 -90
  400. package/src/mcp/repo-state-git.ts +0 -247
  401. package/src/mcp/repo-state-observation.ts +0 -203
  402. package/src/mcp/repo-state-transition.ts +0 -151
  403. package/src/mcp/repo-state-types.ts +0 -107
  404. package/src/mcp/repo-state.ts +0 -146
  405. package/src/mcp/repo-tool-job.ts +0 -102
  406. package/src/mcp/repo-tool-worker-context.ts +0 -215
  407. package/src/mcp/repo-workspace.ts +0 -21
  408. package/src/mcp/run-capture-config.ts +0 -33
  409. package/src/mcp/runtime-causal-context.ts +0 -72
  410. package/src/mcp/runtime-observability.ts +0 -217
  411. package/src/mcp/runtime-staged-target.ts +0 -161
  412. package/src/mcp/runtime-workspace-overlay.ts +0 -255
  413. package/src/mcp/secret-scrub.ts +0 -89
  414. package/src/mcp/semantic-transition-guidance.ts +0 -60
  415. package/src/mcp/semantic-transition-summary.ts +0 -130
  416. package/src/mcp/server-context.ts +0 -236
  417. package/src/mcp/server-invocation.ts +0 -388
  418. package/src/mcp/server-tool-access.ts +0 -148
  419. package/src/mcp/server.ts +0 -270
  420. package/src/mcp/stdio-server.ts +0 -26
  421. package/src/mcp/stdio.ts +0 -3
  422. package/src/mcp/tool-registry.ts +0 -98
  423. package/src/mcp/tools/activity-view.ts +0 -325
  424. package/src/mcp/tools/budget.ts +0 -23
  425. package/src/mcp/tools/causal-attach.ts +0 -67
  426. package/src/mcp/tools/causal-status.ts +0 -58
  427. package/src/mcp/tools/changed-since.ts +0 -71
  428. package/src/mcp/tools/code-find.ts +0 -192
  429. package/src/mcp/tools/code-refs.ts +0 -470
  430. package/src/mcp/tools/code-show.ts +0 -289
  431. package/src/mcp/tools/daemon-monitors.ts +0 -14
  432. package/src/mcp/tools/daemon-repos.ts +0 -22
  433. package/src/mcp/tools/daemon-sessions.ts +0 -14
  434. package/src/mcp/tools/daemon-status.ts +0 -12
  435. package/src/mcp/tools/diagnostic-models.ts +0 -97
  436. package/src/mcp/tools/doctor.ts +0 -83
  437. package/src/mcp/tools/explain.ts +0 -84
  438. package/src/mcp/tools/export-surface-diff.ts +0 -26
  439. package/src/mcp/tools/file-outline.ts +0 -67
  440. package/src/mcp/tools/git-files.ts +0 -73
  441. package/src/mcp/tools/graft-diff.ts +0 -35
  442. package/src/mcp/tools/graft-edit.ts +0 -276
  443. package/src/mcp/tools/knowledge-map.ts +0 -34
  444. package/src/mcp/tools/map-collector.ts +0 -338
  445. package/src/mcp/tools/map.ts +0 -185
  446. package/src/mcp/tools/monitor-nudge.ts +0 -19
  447. package/src/mcp/tools/monitor-pause.ts +0 -18
  448. package/src/mcp/tools/monitor-resume.ts +0 -18
  449. package/src/mcp/tools/monitor-start.ts +0 -20
  450. package/src/mcp/tools/monitor-stop.ts +0 -18
  451. package/src/mcp/tools/precision-live.ts +0 -158
  452. package/src/mcp/tools/precision-match.ts +0 -54
  453. package/src/mcp/tools/precision-paths.ts +0 -59
  454. package/src/mcp/tools/precision-query.ts +0 -127
  455. package/src/mcp/tools/precision-show.ts +0 -86
  456. package/src/mcp/tools/precision-visibility.ts +0 -44
  457. package/src/mcp/tools/precision-warp.ts +0 -101
  458. package/src/mcp/tools/precision.ts +0 -21
  459. package/src/mcp/tools/read-range.ts +0 -28
  460. package/src/mcp/tools/refactor-difficulty.ts +0 -42
  461. package/src/mcp/tools/run-capture.ts +0 -149
  462. package/src/mcp/tools/safe-read.ts +0 -148
  463. package/src/mcp/tools/since.ts +0 -53
  464. package/src/mcp/tools/state.ts +0 -39
  465. package/src/mcp/tools/stats.ts +0 -24
  466. package/src/mcp/tools/structural-blame.ts +0 -55
  467. package/src/mcp/tools/structural-churn.ts +0 -28
  468. package/src/mcp/tools/structural-log.ts +0 -41
  469. package/src/mcp/tools/structural-review.ts +0 -63
  470. package/src/mcp/tools/workspace-authorizations.ts +0 -14
  471. package/src/mcp/tools/workspace-authorize.ts +0 -20
  472. package/src/mcp/tools/workspace-bind.ts +0 -25
  473. package/src/mcp/tools/workspace-rebind.ts +0 -25
  474. package/src/mcp/tools/workspace-revoke.ts +0 -18
  475. package/src/mcp/tools/workspace-status.ts +0 -12
  476. package/src/mcp/warp-pool.ts +0 -36
  477. package/src/mcp/workspace-read-observation-model.ts +0 -48
  478. package/src/mcp/workspace-read-observation.ts +0 -103
  479. package/src/mcp/workspace-router-capability.ts +0 -32
  480. package/src/mcp/workspace-router-history.ts +0 -233
  481. package/src/mcp/workspace-router-model.ts +0 -131
  482. package/src/mcp/workspace-router-resolution.ts +0 -71
  483. package/src/mcp/workspace-router-runtime.ts +0 -246
  484. package/src/mcp/workspace-router.ts +0 -688
  485. package/src/metrics/logger.ts +0 -40
  486. package/src/metrics/types.ts +0 -40
  487. package/src/operations/adaptive-projection.ts +0 -54
  488. package/src/operations/agent-handoff.ts +0 -59
  489. package/src/operations/cached-file.ts +0 -40
  490. package/src/operations/capture-range.ts +0 -64
  491. package/src/operations/conversation-primer.ts +0 -82
  492. package/src/operations/cross-session-resume.ts +0 -104
  493. package/src/operations/deterministic-replay.ts +0 -143
  494. package/src/operations/diff-identity.ts +0 -127
  495. package/src/operations/export-surface-diff.ts +0 -355
  496. package/src/operations/file-outline.ts +0 -48
  497. package/src/operations/footprint-parallelism.ts +0 -98
  498. package/src/operations/graft-diff.ts +0 -169
  499. package/src/operations/horizon-of-readability.ts +0 -60
  500. package/src/operations/import-reference-impact.ts +0 -143
  501. package/src/operations/knowledge-map.ts +0 -96
  502. package/src/operations/observation-cache.ts +0 -165
  503. package/src/operations/projection-safety.ts +0 -111
  504. package/src/operations/read-range.ts +0 -64
  505. package/src/operations/repo-workspace.ts +0 -339
  506. package/src/operations/result-dto.ts +0 -23
  507. package/src/operations/safe-read.ts +0 -118
  508. package/src/operations/semantic-drift.ts +0 -70
  509. package/src/operations/session-filtration.ts +0 -76
  510. package/src/operations/session-replay.ts +0 -73
  511. package/src/operations/sludge-detector.ts +0 -356
  512. package/src/operations/state.ts +0 -66
  513. package/src/operations/structural-blame.ts +0 -197
  514. package/src/operations/structural-review.ts +0 -317
  515. package/src/operations/structured-buffer-compare.ts +0 -429
  516. package/src/operations/structured-buffer-model.ts +0 -456
  517. package/src/operations/structured-buffer-query.ts +0 -794
  518. package/src/operations/structured-buffer.ts +0 -181
  519. package/src/operations/teaching-hints.ts +0 -52
  520. package/src/parser/diff.ts +0 -320
  521. package/src/parser/lang.ts +0 -71
  522. package/src/parser/markdown.ts +0 -197
  523. package/src/parser/outline.ts +0 -316
  524. package/src/parser/runtime.ts +0 -71
  525. package/src/parser/types.ts +0 -75
  526. package/src/policy/evaluate.ts +0 -178
  527. package/src/policy/graftignore.ts +0 -6
  528. package/src/policy/types.ts +0 -87
  529. package/src/ports/codec.ts +0 -13
  530. package/src/ports/filesystem.ts +0 -18
  531. package/src/ports/git.ts +0 -16
  532. package/src/ports/guards.ts +0 -68
  533. package/src/ports/paths.ts +0 -22
  534. package/src/ports/process-runner.ts +0 -22
  535. package/src/release/security-gate.ts +0 -102
  536. package/src/session/tracker.ts +0 -145
  537. package/src/session/types.ts +0 -23
  538. package/src/version.ts +0 -3
  539. package/src/warp/ast-emitter.ts +0 -133
  540. package/src/warp/ast-import-resolver.ts +0 -333
  541. package/src/warp/commit-meta.ts +0 -19
  542. package/src/warp/context.ts +0 -48
  543. package/src/warp/dead-symbols.ts +0 -174
  544. package/src/warp/drift-sentinel.ts +0 -101
  545. package/src/warp/index-head.ts +0 -348
  546. package/src/warp/observers.ts +0 -101
  547. package/src/warp/open.ts +0 -67
  548. package/src/warp/outline-diff-trailer.ts +0 -100
  549. package/src/warp/plumbing.d.ts +0 -24
  550. package/src/warp/refactor-difficulty.ts +0 -257
  551. package/src/warp/references.ts +0 -77
  552. package/src/warp/stale-docs.ts +0 -210
  553. package/src/warp/structural-drift-detection.ts +0 -97
  554. package/src/warp/structural-queries.ts +0 -258
  555. package/src/warp/symbol-timeline.ts +0 -209
  556. package/src/warp/traverse-hydrate.ts +0 -61
  557. package/src/warp/warp-reference-count.ts +0 -47
  558. package/src/warp/warp-structural-blame.ts +0 -65
  559. package/src/warp/warp-structural-churn.ts +0 -309
  560. package/src/warp/warp-structural-log.ts +0 -149
  561. package/src/warp/writer-id.ts +0 -30
@@ -1,42 +0,0 @@
1
- import { z } from "zod";
2
- import { toJsonObject } from "../../operations/result-dto.js";
3
- import { refactorDifficultyFromGraph } from "../../warp/refactor-difficulty.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const refactorDifficultyTool: ToolDefinition = {
7
- name: "graft_difficulty",
8
- description:
9
- "Refactor difficulty score for a symbol. Combines WARP aggregate " +
10
- "churn curvature with WARP reference-edge friction so agents can " +
11
- "choose refactor vs workaround.",
12
- schema: {
13
- symbol: z.string(),
14
- path: z.string().optional(),
15
- limit: z.number().int().positive().optional(),
16
- },
17
- createHandler(): ToolHandler {
18
- return async (args, ctx) => {
19
- const symbol = args["symbol"];
20
- const rawPath = args["path"];
21
- const rawLimit = args["limit"];
22
-
23
- if (typeof symbol !== "string" || symbol.trim().length === 0) {
24
- throw new Error("graft_difficulty: symbol must be a non-empty string");
25
- }
26
-
27
- const warp = await ctx.getWarp();
28
- const result = await refactorDifficultyFromGraph(warp, {
29
- symbol,
30
- ...(typeof rawPath === "string" ? { path: rawPath } : {}),
31
- ...(typeof rawLimit === "number" ? { limit: rawLimit } : {}),
32
- });
33
-
34
- ctx.recordFootprint({
35
- symbols: [symbol.trim()],
36
- paths: result.entries.map((entry) => entry.filePath),
37
- });
38
-
39
- return ctx.respond("graft_difficulty", toJsonObject(result));
40
- };
41
- },
42
- };
@@ -1,149 +0,0 @@
1
- import * as path from "node:path";
2
- import { z } from "zod";
3
- import type { ToolDefinition, ToolContext, ToolHandler } from "../context.js";
4
-
5
- const RUN_CAPTURE_POLICY_BOUNDARY = {
6
- kind: "shell_escape_hatch",
7
- boundedReadContract: false,
8
- policyEnforced: false,
9
- } as const;
10
-
11
- const PRIVATE_KEY_BLOCK_RE = /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g;
12
- const SECRET_ASSIGNMENT_RE = /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|bearer|token|secret|password|passwd|private[_-]?key|client[_-]?secret|session[_-]?key)\b\s*[:=]\s*)([^\r\n]+)/gi;
13
- const BEARER_TOKEN_RE = /(\bbearer\s+)([A-Za-z0-9._~+/=-]{8,})/gi;
14
-
15
- function tailOutput(output: string, tail: number): {
16
- readonly tailed: string;
17
- readonly totalLines: number;
18
- } {
19
- const lines = output.split("\n");
20
- return {
21
- tailed: lines.slice(-tail).join("\n"),
22
- totalLines: lines.length,
23
- };
24
- }
25
-
26
- function renderCaptureError(result: {
27
- readonly status: number | null;
28
- readonly stderr: string;
29
- readonly error?: Error;
30
- }): string {
31
- if (result.error !== undefined) {
32
- return result.error.message;
33
- }
34
- const stderr = result.stderr.trim();
35
- if (stderr.length > 0) {
36
- return stderr;
37
- }
38
- return `Command exited with status ${String(result.status)}`;
39
- }
40
-
41
- function redactForLog(output: string): {
42
- readonly value: string;
43
- readonly redactions: number;
44
- } {
45
- let redactions = 0;
46
- let value = output.replace(PRIVATE_KEY_BLOCK_RE, () => {
47
- redactions++;
48
- return "[REDACTED PRIVATE KEY BLOCK]";
49
- });
50
- value = value.replace(SECRET_ASSIGNMENT_RE, (_match, prefix: string) => {
51
- redactions++;
52
- return `${prefix}[REDACTED]`;
53
- });
54
- value = value.replace(BEARER_TOKEN_RE, (_match, prefix: string) => {
55
- redactions++;
56
- return `${prefix}[REDACTED]`;
57
- });
58
- return { value, redactions };
59
- }
60
-
61
- async function persistCaptureLog(ctx: ToolContext, output: string): Promise<{
62
- readonly logPath: string | null;
63
- readonly logRedactions: number;
64
- }> {
65
- if (!ctx.runCapture.persistLogs) {
66
- return { logPath: null, logRedactions: 0 };
67
- }
68
-
69
- const logPath = path.join(ctx.graftDir, "logs", "capture.log");
70
- const persisted = ctx.runCapture.redactLogs ? redactForLog(output) : { value: output, redactions: 0 };
71
-
72
- try {
73
- await ctx.fs.mkdir(path.dirname(logPath), { recursive: true });
74
- await ctx.fs.writeFile(logPath, persisted.value, "utf-8");
75
- return {
76
- logPath,
77
- logRedactions: persisted.redactions,
78
- };
79
- } catch {
80
- return { logPath: null, logRedactions: 0 };
81
- }
82
- }
83
-
84
- export const runCaptureTool: ToolDefinition = {
85
- name: "run_capture",
86
- description:
87
- "Execute a shell command and return the last N lines of output " +
88
- "(default 60). Responses include an explicit policy boundary. " +
89
- "Persisted logs can be disabled and obvious secrets are redacted " +
90
- "before writing to .graft/logs/capture.log.",
91
- schema: { command: z.string(), tail: z.number().optional() },
92
- createHandler(): ToolHandler {
93
- return async (args, ctx) => {
94
- const command = args["command"] as string;
95
- const tail = Math.max(1, Math.floor((args["tail"] as number | undefined) ?? 60));
96
- if (!ctx.runCapture.enabled) {
97
- return ctx.respond("run_capture", {
98
- output: "",
99
- totalLines: 0,
100
- tailedLines: 0,
101
- logPath: null,
102
- logRedactions: 0,
103
- logPersistenceEnabled: false,
104
- truncated: false,
105
- disabled: true,
106
- error: "run_capture is disabled by configuration",
107
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
108
- });
109
- }
110
- const result = ctx.process.run({
111
- command: "sh",
112
- args: ["-c", command],
113
- cwd: ctx.projectRoot,
114
- timeoutMs: 30000,
115
- maxBufferBytes: 10 * 1024 * 1024,
116
- });
117
-
118
- if (result.error !== undefined || result.status !== 0) {
119
- const tailedOutput = tailOutput(result.stdout, tail);
120
- return ctx.respond("run_capture", {
121
- error: renderCaptureError(result),
122
- output: tailedOutput.tailed,
123
- totalLines: tailedOutput.totalLines,
124
- tailedLines: Math.min(tail, tailedOutput.totalLines),
125
- logPath: null,
126
- logRedactions: 0,
127
- logPersistenceEnabled: ctx.runCapture.persistLogs,
128
- truncated: tailedOutput.totalLines > tail,
129
- stderr: result.stderr.slice(0, 2000),
130
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
131
- });
132
- }
133
-
134
- const output = result.stdout;
135
- const tailedOutput = tailOutput(output, tail);
136
- const persisted = await persistCaptureLog(ctx, output);
137
- return ctx.respond("run_capture", {
138
- output: tailedOutput.tailed,
139
- totalLines: tailedOutput.totalLines,
140
- tailedLines: Math.min(tail, tailedOutput.totalLines),
141
- logPath: persisted.logPath,
142
- logRedactions: persisted.logRedactions,
143
- logPersistenceEnabled: ctx.runCapture.persistLogs,
144
- truncated: tailedOutput.totalLines > tail,
145
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
146
- });
147
- };
148
- },
149
- };
@@ -1,148 +0,0 @@
1
- import { z } from "zod";
2
- import { safeRead, type SafeReadResult } from "../../operations/safe-read.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import { RefusedResult } from "../../policy/types.js";
5
- import { diffOutlines } from "../../parser/diff.js";
6
- import { CachedFile } from "../cached-file.js";
7
- import type { Metrics } from "../metrics.js";
8
- import { evaluateMcpPolicy } from "../policy.js";
9
- import { toRepoPolicyPath } from "../../adapters/repo-paths.js";
10
- import type { ToolDefinition, ToolHandler } from "../context.js";
11
-
12
- const PROJECTION_METRICS: Readonly<Record<string, ((m: Metrics) => void) | undefined>> = {
13
- content: (m) => { m.recordRead(); },
14
- outline: (m) => { m.recordOutline(); },
15
- refused: (m) => { m.recordRefusal(); },
16
- };
17
-
18
- const CACHEABLE_PROJECTIONS: ReadonlySet<SafeReadResult["projection"]> = new Set(["content", "outline"]);
19
-
20
- export const safeReadTool: ToolDefinition = {
21
- name: "safe_read",
22
- description:
23
- "Policy-enforced file read. Returns full content for small files, " +
24
- "structural outline with jump table for large files, or refusal with " +
25
- "reason code for banned files. Detects re-reads and returns cached " +
26
- "outlines or structural diffs.",
27
- schema: { path: z.string(), intent: z.string().optional() },
28
- createHandler(): ToolHandler {
29
- return async (args, ctx) => {
30
- const filePath = ctx.resolvePath(args["path"] as string);
31
- ctx.recordFootprint({ paths: [filePath] });
32
-
33
- // Build CachedFile once — all consumers share the same snapshot,
34
- // eliminating TOCTOU races where the file changes between reads.
35
- let cf: CachedFile | null = null;
36
- try {
37
- const rawContent = await ctx.fs.readFile(filePath, "utf-8");
38
- cf = new CachedFile(filePath, rawContent);
39
- } catch {
40
- // File doesn't exist or can't be read — proceed to safeRead for error handling
41
- }
42
-
43
- // Check cache if we could read the file
44
- if (cf?.supportsOutline === true) {
45
- const cacheResult = ctx.cache.check(filePath, cf.rawContent);
46
- if (cacheResult.hit) {
47
- // Defense: re-check policy before returning cached data.
48
- const policy = evaluateMcpPolicy(ctx, filePath, cf.actual);
49
- if (policy instanceof RefusedResult) {
50
- ctx.metrics.recordRefusal();
51
- return ctx.respond("safe_read", {
52
- path: filePath,
53
- projection: "refused",
54
- reason: policy.reason,
55
- reasonDetail: policy.reasonDetail,
56
- next: [...policy.next],
57
- actual: cf.actual,
58
- });
59
- }
60
-
61
- cacheResult.obs.touch(ctx.cache.now());
62
- ctx.metrics.recordCacheHit(cf.actual.bytes);
63
- ctx.recordFootprint({
64
- symbols: cacheResult.obs.outline.map((e) => e.name),
65
- });
66
- return ctx.respond("safe_read", {
67
- path: filePath,
68
- projection: "cache_hit",
69
- reason: "REREAD_UNCHANGED",
70
- outline: cacheResult.obs.outline,
71
- jumpTable: cacheResult.obs.jumpTable,
72
- actual: cf.actual,
73
- readCount: cacheResult.obs.readCount,
74
- estimatedBytesAvoided: cf.actual.bytes,
75
- lastReadAt: cacheResult.obs.lastReadAt,
76
- });
77
- }
78
-
79
- // File changed since last observation — compute structural diff
80
- if (cacheResult.stale !== null) {
81
- // Defense: re-check policy before returning structural data.
82
- const policy = evaluateMcpPolicy(ctx, filePath, cf.actual);
83
- if (policy instanceof RefusedResult) {
84
- ctx.metrics.recordRefusal();
85
- return ctx.respond("safe_read", {
86
- path: filePath,
87
- projection: "refused",
88
- reason: policy.reason,
89
- reasonDetail: policy.reasonDetail,
90
- next: [...policy.next],
91
- actual: cf.actual,
92
- });
93
- }
94
-
95
- const diff = diffOutlines(cacheResult.stale.outline, cf.outline);
96
- const newReadCount = cacheResult.stale.readCount + 1;
97
- ctx.cache.record(filePath, cf.hash, cf.outline, cf.jumpTable, cf.actual);
98
- ctx.recordFootprint({
99
- symbols: cf.outline.map((e) => e.name),
100
- });
101
- const updatedObs = ctx.cache.get(filePath);
102
- return ctx.respond("safe_read", {
103
- path: filePath,
104
- projection: "diff",
105
- reason: "CHANGED_SINCE_LAST_READ",
106
- diff,
107
- outline: cf.outline,
108
- jumpTable: cf.jumpTable,
109
- actual: cf.actual,
110
- readCount: newReadCount,
111
- lastReadAt: updatedObs?.lastReadAt ?? ctx.cache.now(),
112
- });
113
- }
114
- }
115
-
116
- // First read — pass rawContent to avoid double-read (TOCTOU)
117
- const result = await safeRead(filePath, {
118
- fs: ctx.fs,
119
- codec: ctx.codec,
120
- content: cf?.rawContent,
121
- intent: args["intent"] as string | undefined,
122
- policyPath: toRepoPolicyPath(ctx.projectRoot, filePath),
123
- graftignorePatterns: [...ctx.graftignorePatterns],
124
- sessionDepth: ctx.governor.getGovernorDepth(),
125
- budgetRemaining: ctx.governor.getBudget()?.remaining,
126
- });
127
-
128
- PROJECTION_METRICS[result.projection]?.(ctx.metrics);
129
- if (result.outline !== undefined) {
130
- ctx.recordFootprint({ symbols: result.outline.map((e) => e.name) });
131
- }
132
-
133
- // Record observation for cacheable projections — uses CachedFile
134
- // outline (no re-read) to eliminate the snapshot race.
135
- if (
136
- cf !== null &&
137
- cf.supportsOutline &&
138
- result.actual !== undefined &&
139
- CACHEABLE_PROJECTIONS.has(result.projection) &&
140
- result.reason !== "UNSUPPORTED_LANGUAGE"
141
- ) {
142
- ctx.cache.record(filePath, cf.hash, cf.outline, cf.jumpTable, result.actual);
143
- }
144
-
145
- return ctx.respond("safe_read", toJsonObject(result));
146
- };
147
- },
148
- };
@@ -1,53 +0,0 @@
1
- import { z } from "zod";
2
- import { graftDiff } from "../../operations/graft-diff.js";
3
- import type { ToolDefinition, ToolHandler } from "../context.js";
4
- import { evaluateMcpRefusal } from "../policy.js";
5
-
6
- export const sinceTool: ToolDefinition = {
7
- name: "graft_since",
8
- description:
9
- "Structural changes since a git ref. Shows symbols added, removed, " +
10
- "and changed per file — not line hunks. Includes per-file summary " +
11
- "lines for quick triage. Defaults to HEAD as the comparison target.",
12
- schema: {
13
- base: z.string(),
14
- head: z.string().optional(),
15
- },
16
- createHandler(): ToolHandler {
17
- return async (args, ctx) => {
18
- const base = args["base"] as string;
19
- const head = (args["head"] as string | undefined) ?? "HEAD";
20
-
21
- const result = await graftDiff({
22
- cwd: ctx.projectRoot,
23
- fs: ctx.fs,
24
- git: ctx.git,
25
- resolveWorkingTreePath: (filePath) => ctx.resolvePath(filePath),
26
- base,
27
- head,
28
- refusalCheck: (filePath, actual) => evaluateMcpRefusal(ctx, filePath, actual),
29
- });
30
-
31
- // Aggregate symbol-level changes across all files
32
- let totalAdded = 0;
33
- let totalRemoved = 0;
34
- let totalChanged = 0;
35
-
36
- for (const file of result.files) {
37
- totalAdded += file.diff.added.length;
38
- totalRemoved += file.diff.removed.length;
39
- totalChanged += file.diff.changed.length;
40
- }
41
-
42
- ctx.recordFootprint({
43
- paths: result.files.map((f) => f.path),
44
- });
45
-
46
- return ctx.respond("graft_since", {
47
- ...result,
48
- summary: `+${String(totalAdded)} added, -${String(totalRemoved)} removed, ~${String(totalChanged)} changed across ${String(result.files.length)} files`,
49
- layer: "ref_view",
50
- });
51
- };
52
- },
53
- };
@@ -1,39 +0,0 @@
1
- import * as path from "node:path";
2
- import { z } from "zod";
3
- import { STATE_FILENAME, stateSave, stateLoad } from "../../operations/state.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
- import { toJsonObject } from "../../operations/result-dto.js";
6
-
7
- export const stateSaveTool: ToolDefinition = {
8
- name: "state_save",
9
- description:
10
- "Save session working state (max 8 KB). Use for session bookmarks: " +
11
- "current task, files modified, next planned actions.",
12
- schema: { content: z.string() },
13
- createHandler(): ToolHandler {
14
- return async (args, ctx) => {
15
- const result = await stateSave(args["content"] as string, {
16
- stateDir: ctx.graftDir,
17
- statePath: path.join(ctx.graftDir, STATE_FILENAME),
18
- fs: ctx.fs,
19
- });
20
- return ctx.respond("state_save", toJsonObject(result));
21
- };
22
- },
23
- };
24
-
25
- export const stateLoadTool: ToolDefinition = {
26
- name: "state_load",
27
- description:
28
- "Load previously saved session state. Returns null if no state has " +
29
- "been saved.",
30
- createHandler(): ToolHandler {
31
- return async (_args, ctx) => {
32
- const result = await stateLoad({
33
- statePath: path.join(ctx.graftDir, STATE_FILENAME),
34
- fs: ctx.fs,
35
- });
36
- return ctx.respond("state_load", toJsonObject(result));
37
- };
38
- },
39
- };
@@ -1,24 +0,0 @@
1
- import { totalNonReadBytesReturned } from "../burden.js";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const statsTool: ToolDefinition = {
5
- name: "stats",
6
- description:
7
- "Decision metrics for the current session. Total reads, outlines, " +
8
- "refusals, cache hits, bytes avoided, and burden by tool kind.",
9
- createHandler(): ToolHandler {
10
- return (_args, ctx) => {
11
- const snap = ctx.metrics.snapshot();
12
- return ctx.respond("stats", {
13
- totalReads: snap.reads,
14
- totalOutlines: snap.outlines,
15
- totalRefusals: snap.refusals,
16
- totalCacheHits: snap.cacheHits,
17
- totalBytesReturned: snap.bytesReturned,
18
- totalBytesAvoidedByCache: snap.bytesAvoided,
19
- totalNonReadBytesReturned: totalNonReadBytesReturned(snap.burdenByKind),
20
- burdenByKind: snap.burdenByKind,
21
- });
22
- };
23
- },
24
- };
@@ -1,55 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
- import { structuralBlameFromGraph } from "../../warp/warp-structural-blame.js";
4
- import { toJsonObject } from "../../operations/result-dto.js";
5
-
6
- export const structuralBlameTool: ToolDefinition = {
7
- name: "graft_blame",
8
- description:
9
- "Symbol-level blame: who last changed a symbol's signature, when " +
10
- "it was created, and its full change history. Returns creation " +
11
- "commit, last signature change, change count, reference count, " +
12
- "and chronological history.",
13
- schema: {
14
- symbol: z.string(),
15
- path: z.string().optional(),
16
- },
17
- createHandler(): ToolHandler {
18
- return async (args, ctx) => {
19
- const symbol = args["symbol"];
20
- const rawPath = args["path"];
21
-
22
- if (typeof symbol !== "string" || symbol.trim().length === 0) {
23
- throw new Error("graft_blame: symbol must be a non-empty string");
24
- }
25
-
26
- const symbolName = symbol.trim();
27
- const filePath = typeof rawPath === "string" ? rawPath : undefined;
28
- const warp = await ctx.getWarp();
29
-
30
- const blame = await structuralBlameFromGraph(
31
- warp,
32
- symbolName,
33
- filePath ?? "",
34
- );
35
-
36
- ctx.recordFootprint({ symbols: [symbolName] });
37
-
38
- return ctx.respond("graft_blame", toJsonObject({
39
- symbol: blame.symbol,
40
- filePath: blame.filePath,
41
- changeCount: blame.changeCount,
42
- createdInCommit: blame.createdInCommit ?? null,
43
- lastSignatureChange: blame.lastSignatureChange ?? null,
44
- referenceCount: blame.referenceCount,
45
- history: blame.history.map((v) => ({
46
- sha: v.sha,
47
- tick: v.tick,
48
- changeKind: v.changeKind,
49
- present: v.present,
50
- signature: v.signature ?? null,
51
- })),
52
- }));
53
- };
54
- },
55
- };
@@ -1,28 +0,0 @@
1
- import { z } from "zod";
2
- import { toJsonObject } from "../../operations/result-dto.js";
3
- import { structuralChurnFromGraph } from "../../warp/warp-structural-churn.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const structuralChurnTool: ToolDefinition = {
7
- name: "graft_churn",
8
- description:
9
- "Structural churn report — which symbols change most frequently? " +
10
- "Identifies maintenance hotspots by walking indexed commits and " +
11
- "counting per-symbol change frequency.",
12
- schema: {
13
- path: z.string().optional(),
14
- limit: z.number().int().positive().optional(),
15
- },
16
- createHandler(): ToolHandler {
17
- return async (args, ctx) => {
18
- const warp = await ctx.getWarp();
19
- const options: { path?: string; limit?: number } = {};
20
- const pathArg = args["path"];
21
- const limitArg = args["limit"];
22
- if (typeof pathArg === "string") options.path = pathArg;
23
- if (typeof limitArg === "number") options.limit = limitArg;
24
- const result = await structuralChurnFromGraph(warp, options);
25
- return ctx.respond("graft_churn", toJsonObject(result));
26
- };
27
- },
28
- };
@@ -1,41 +0,0 @@
1
- import { z } from "zod";
2
- import { structuralLogFromGraph } from "../../warp/warp-structural-log.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const structuralLogTool: ToolDefinition = {
7
- name: "graft_log",
8
- description:
9
- "Structural git log — shows symbol-level changes (added, removed, " +
10
- "changed) per commit. Like `git log` but for code structure, not lines.",
11
- schema: {
12
- path: z.string().optional(),
13
- limit: z.number().optional(),
14
- },
15
- createHandler(): ToolHandler {
16
- return async (args, ctx) => {
17
- const filePath = args["path"] as string | undefined;
18
- const limit = args["limit"] as number | undefined;
19
- const warp = await ctx.getWarp();
20
-
21
- const options: { path?: string; limit?: number } = {};
22
- if (filePath !== undefined) options.path = filePath;
23
- if (limit !== undefined) options.limit = limit;
24
- const entries = await structuralLogFromGraph(warp, options);
25
-
26
- ctx.recordFootprint({
27
- symbols: entries.flatMap((e) => [
28
- ...e.symbols.added.map((s) => s.name),
29
- ...e.symbols.removed.map((s) => s.name),
30
- ...e.symbols.changed.map((s) => s.name),
31
- ]),
32
- });
33
-
34
- return ctx.respond("graft_log", toJsonObject({
35
- entries,
36
- count: entries.length,
37
- layer: "commit_worldline",
38
- }));
39
- };
40
- },
41
- };
@@ -1,63 +0,0 @@
1
- import { z } from "zod";
2
- import { structuralReview, type ReferenceCountResult } from "../../operations/structural-review.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import type { ToolContext, ToolDefinition, ToolHandler } from "../context.js";
5
- import { countSymbolReferencesFromGraph } from "../../warp/warp-reference-count.js";
6
- import { nodePathOps } from "../../adapters/node-paths.js";
7
- import { countNamedImportReferencesAtRef } from "../../operations/import-reference-impact.js";
8
-
9
- async function countReviewReferences(
10
- ctx: ToolContext,
11
- symbolName: string,
12
- filePath: string,
13
- headRef: string,
14
- ): Promise<ReferenceCountResult> {
15
- const warpCtx = await ctx.getWarp();
16
- const graphResult = await countSymbolReferencesFromGraph(warpCtx, symbolName, filePath);
17
- if (graphResult.referenceCount > 0) {
18
- return graphResult;
19
- }
20
-
21
- try {
22
- const fallbackResult = await countNamedImportReferencesAtRef({
23
- cwd: ctx.projectRoot,
24
- git: ctx.git,
25
- pathOps: nodePathOps,
26
- symbolName,
27
- filePath,
28
- ref: headRef,
29
- });
30
- return fallbackResult.referenceCount > 0 ? fallbackResult : graphResult;
31
- } catch {
32
- return graphResult;
33
- }
34
- }
35
-
36
- export const structuralReviewTool: ToolDefinition = {
37
- name: "graft_review",
38
- description:
39
- "Zero-noise structural PR review. Categorizes changed files as " +
40
- "structural, formatting, test, docs, or config. Detects breaking " +
41
- "changes (removed exports, changed signatures) with impact counts.",
42
- schema: { base: z.string().optional(), head: z.string().optional() },
43
- createHandler(): ToolHandler {
44
- return async (args, ctx) => {
45
- const head = args["head"] as string | undefined;
46
- const result = await structuralReview({
47
- cwd: ctx.projectRoot,
48
- fs: ctx.fs,
49
- git: ctx.git,
50
- resolveWorkingTreePath: (filePath) => ctx.resolvePath(filePath),
51
- base: args["base"] as string | undefined,
52
- head,
53
- countReferences: async (symbolName, filePath) => {
54
- return countReviewReferences(ctx, symbolName, filePath, head ?? "HEAD");
55
- },
56
- });
57
- ctx.recordFootprint({
58
- paths: result.files.map((f) => f.path),
59
- });
60
- return ctx.respond("graft_review", toJsonObject(result));
61
- };
62
- },
63
- };
@@ -1,14 +0,0 @@
1
- import type { ToolDefinition, ToolHandler } from "../context.js";
2
-
3
- export const workspaceAuthorizationsTool: ToolDefinition = {
4
- name: "workspace_authorizations",
5
- description:
6
- "List daemon-authorized workspaces, their capability posture, and active bound-session counts.",
7
- createHandler(): ToolHandler {
8
- return async (_args, ctx) => {
9
- return ctx.respond("workspace_authorizations", {
10
- workspaces: await ctx.listWorkspaceAuthorizations(),
11
- });
12
- };
13
- },
14
- };
@@ -1,20 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const workspaceAuthorizeTool: ToolDefinition = {
5
- name: "workspace_authorize",
6
- description:
7
- "Authorize a workspace for daemon binding and optionally change its daemon capability posture.",
8
- schema: {
9
- cwd: z.string(),
10
- runCapture: z.boolean().optional(),
11
- },
12
- createHandler(): ToolHandler {
13
- return async (args, ctx) => {
14
- return ctx.respond("workspace_authorize", { ...await ctx.authorizeWorkspace({
15
- cwd: args["cwd"] as string,
16
- runCapture: args["runCapture"] as boolean | undefined,
17
- }) });
18
- };
19
- },
20
- };