@flyingrobots/graft 0.6.1 → 0.7.1

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 (665) hide show
  1. package/CHANGELOG.md +148 -0
  2. package/README.md +1 -2
  3. package/bin/graft.js +26 -26
  4. package/dist/adapters/json-text-decoder.d.ts +3 -0
  5. package/dist/adapters/json-text-decoder.d.ts.map +1 -0
  6. package/dist/adapters/json-text-decoder.js +12 -0
  7. package/dist/adapters/json-text-decoder.js.map +1 -0
  8. package/dist/adapters/node-paths.d.ts +3 -0
  9. package/dist/adapters/node-paths.d.ts.map +1 -0
  10. package/dist/adapters/node-paths.js +29 -0
  11. package/dist/adapters/node-paths.js.map +1 -0
  12. package/dist/adapters/repo-paths.d.ts.map +1 -1
  13. package/dist/adapters/repo-paths.js +40 -5
  14. package/dist/adapters/repo-paths.js.map +1 -1
  15. package/dist/api/tool-bridge.d.ts +1 -1
  16. package/dist/api/tool-bridge.d.ts.map +1 -1
  17. package/dist/api/tool-bridge.js +1 -1
  18. package/dist/api/tool-bridge.js.map +1 -1
  19. package/dist/cli/cli-error.d.ts.map +1 -1
  20. package/dist/cli/cli-error.js +47 -10
  21. package/dist/cli/cli-error.js.map +1 -1
  22. package/dist/cli/command-parser.d.ts +12 -3
  23. package/dist/cli/command-parser.d.ts.map +1 -1
  24. package/dist/cli/command-parser.js +161 -2
  25. package/dist/cli/command-parser.js.map +1 -1
  26. package/dist/cli/daemon-status-model.d.ts +87 -0
  27. package/dist/cli/daemon-status-model.d.ts.map +1 -0
  28. package/dist/cli/daemon-status-model.js +142 -0
  29. package/dist/cli/daemon-status-model.js.map +1 -0
  30. package/dist/cli/daemon-status-render.d.ts +3 -0
  31. package/dist/cli/daemon-status-render.d.ts.map +1 -0
  32. package/dist/cli/daemon-status-render.js +100 -0
  33. package/dist/cli/daemon-status-render.js.map +1 -0
  34. package/dist/cli/daemon-status.d.ts +7 -0
  35. package/dist/cli/daemon-status.d.ts.map +1 -0
  36. package/dist/cli/daemon-status.js +79 -0
  37. package/dist/cli/daemon-status.js.map +1 -0
  38. package/dist/cli/git-graft-enhance-model.d.ts +67 -0
  39. package/dist/cli/git-graft-enhance-model.d.ts.map +1 -0
  40. package/dist/cli/git-graft-enhance-model.js +55 -0
  41. package/dist/cli/git-graft-enhance-model.js.map +1 -0
  42. package/dist/cli/git-graft-enhance-render.d.ts +3 -0
  43. package/dist/cli/git-graft-enhance-render.d.ts.map +1 -0
  44. package/dist/cli/git-graft-enhance-render.js +29 -0
  45. package/dist/cli/git-graft-enhance-render.js.map +1 -0
  46. package/dist/cli/git-graft-enhance.d.ts +14 -0
  47. package/dist/cli/git-graft-enhance.d.ts.map +1 -0
  48. package/dist/cli/git-graft-enhance.js +29 -0
  49. package/dist/cli/git-graft-enhance.js.map +1 -0
  50. package/dist/cli/index-cmd.d.ts.map +1 -1
  51. package/dist/cli/index-cmd.js +18 -21
  52. package/dist/cli/index-cmd.js.map +1 -1
  53. package/dist/cli/index-model.d.ts +5 -9
  54. package/dist/cli/index-model.d.ts.map +1 -1
  55. package/dist/cli/index-model.js +20 -18
  56. package/dist/cli/index-model.js.map +1 -1
  57. package/dist/cli/init-client-config.d.ts +12 -7
  58. package/dist/cli/init-client-config.d.ts.map +1 -1
  59. package/dist/cli/init-client-config.js +145 -47
  60. package/dist/cli/init-client-config.js.map +1 -1
  61. package/dist/cli/init-model.d.ts +9 -2
  62. package/dist/cli/init-model.d.ts.map +1 -1
  63. package/dist/cli/init-model.js +54 -6
  64. package/dist/cli/init-model.js.map +1 -1
  65. package/dist/cli/init-render.d.ts.map +1 -1
  66. package/dist/cli/init-render.js +2 -2
  67. package/dist/cli/init-render.js.map +1 -1
  68. package/dist/cli/init.d.ts.map +1 -1
  69. package/dist/cli/init.js +11 -9
  70. package/dist/cli/init.js.map +1 -1
  71. package/dist/cli/json-document.d.ts +6 -0
  72. package/dist/cli/json-document.d.ts.map +1 -1
  73. package/dist/cli/json-document.js +12 -0
  74. package/dist/cli/json-document.js.map +1 -1
  75. package/dist/cli/main.d.ts +7 -0
  76. package/dist/cli/main.d.ts.map +1 -1
  77. package/dist/cli/main.js +49 -7
  78. package/dist/cli/main.js.map +1 -1
  79. package/dist/cli/migrate-local-history.d.ts.map +1 -1
  80. package/dist/cli/migrate-local-history.js +3 -2
  81. package/dist/cli/migrate-local-history.js.map +1 -1
  82. package/dist/cli/peer-command.d.ts +1 -1
  83. package/dist/cli/peer-command.d.ts.map +1 -1
  84. package/dist/cli/peer-command.js +1 -1
  85. package/dist/cli/peer-command.js.map +1 -1
  86. package/dist/contracts/capabilities.d.ts +5 -5
  87. package/dist/contracts/capabilities.d.ts.map +1 -1
  88. package/dist/contracts/capabilities.js +89 -0
  89. package/dist/contracts/capabilities.js.map +1 -1
  90. package/dist/contracts/causal-ontology.d.ts +17 -17
  91. package/dist/contracts/json-object.d.ts +0 -1
  92. package/dist/contracts/json-object.d.ts.map +1 -1
  93. package/dist/contracts/json-object.js +0 -10
  94. package/dist/contracts/json-object.js.map +1 -1
  95. package/dist/contracts/output-schema-cli.d.ts +277 -25
  96. package/dist/contracts/output-schema-cli.d.ts.map +1 -1
  97. package/dist/contracts/output-schema-cli.js +35 -3
  98. package/dist/contracts/output-schema-cli.js.map +1 -1
  99. package/dist/contracts/output-schema-fragments.d.ts +212 -87
  100. package/dist/contracts/output-schema-fragments.d.ts.map +1 -1
  101. package/dist/contracts/output-schema-fragments.js +49 -2
  102. package/dist/contracts/output-schema-fragments.js.map +1 -1
  103. package/dist/contracts/output-schema-mcp.d.ts +372 -47
  104. package/dist/contracts/output-schema-mcp.d.ts.map +1 -1
  105. package/dist/contracts/output-schema-mcp.js +217 -1
  106. package/dist/contracts/output-schema-mcp.js.map +1 -1
  107. package/dist/contracts/output-schema-meta.d.ts +2 -2
  108. package/dist/contracts/output-schema-meta.d.ts.map +1 -1
  109. package/dist/contracts/output-schemas.d.ts +7 -7
  110. package/dist/contracts/output-schemas.d.ts.map +1 -1
  111. package/dist/contracts/output-schemas.js +294 -6
  112. package/dist/contracts/output-schemas.js.map +1 -1
  113. package/dist/git/diff.d.ts +11 -0
  114. package/dist/git/diff.d.ts.map +1 -1
  115. package/dist/git/diff.js +50 -6
  116. package/dist/git/diff.js.map +1 -1
  117. package/dist/hooks/posttooluse-read.js +1 -1
  118. package/dist/hooks/posttooluse-read.js.map +1 -1
  119. package/dist/hooks/pretooluse-read.js +1 -1
  120. package/dist/hooks/pretooluse-read.js.map +1 -1
  121. package/dist/mcp/burden.d.ts.map +1 -1
  122. package/dist/mcp/burden.js +9 -0
  123. package/dist/mcp/burden.js.map +1 -1
  124. package/dist/mcp/context.d.ts +3 -2
  125. package/dist/mcp/context.d.ts.map +1 -1
  126. package/dist/mcp/context.js +2 -37
  127. package/dist/mcp/context.js.map +1 -1
  128. package/dist/mcp/daemon-server.d.ts +2 -0
  129. package/dist/mcp/daemon-server.d.ts.map +1 -1
  130. package/dist/mcp/daemon-server.js +6 -1
  131. package/dist/mcp/daemon-server.js.map +1 -1
  132. package/dist/mcp/daemon-session-host.d.ts +1 -0
  133. package/dist/mcp/daemon-session-host.d.ts.map +1 -1
  134. package/dist/mcp/daemon-session-host.js +3 -0
  135. package/dist/mcp/daemon-session-host.js.map +1 -1
  136. package/dist/mcp/daemon-stdio-bridge.d.ts +1 -0
  137. package/dist/mcp/daemon-stdio-bridge.d.ts.map +1 -1
  138. package/dist/mcp/daemon-stdio-bridge.js +1 -0
  139. package/dist/mcp/daemon-stdio-bridge.js.map +1 -1
  140. package/dist/mcp/daemon-worker-child-pool.d.ts +2 -0
  141. package/dist/mcp/daemon-worker-child-pool.d.ts.map +1 -1
  142. package/dist/mcp/daemon-worker-child-pool.js +10 -3
  143. package/dist/mcp/daemon-worker-child-pool.js.map +1 -1
  144. package/dist/mcp/daemon-worker-pool.d.ts +1 -1
  145. package/dist/mcp/daemon-worker-pool.d.ts.map +1 -1
  146. package/dist/mcp/daemon-worker-pool.js +1 -1
  147. package/dist/mcp/daemon-worker-pool.js.map +1 -1
  148. package/dist/mcp/monitor-tick-job.d.ts +1 -0
  149. package/dist/mcp/monitor-tick-job.d.ts.map +1 -1
  150. package/dist/mcp/monitor-tick-job.js +84 -29
  151. package/dist/mcp/monitor-tick-job.js.map +1 -1
  152. package/dist/mcp/monitor-types.d.ts +1 -1
  153. package/dist/mcp/monitor-types.d.ts.map +1 -1
  154. package/dist/mcp/persisted-local-history-graph.d.ts +2 -2
  155. package/dist/mcp/persisted-local-history-graph.d.ts.map +1 -1
  156. package/dist/mcp/persisted-local-history-graph.js +3 -2
  157. package/dist/mcp/persisted-local-history-graph.js.map +1 -1
  158. package/dist/mcp/persisted-local-history.d.ts +5 -5
  159. package/dist/mcp/persisted-local-history.js +2 -2
  160. package/dist/mcp/persisted-local-history.js.map +1 -1
  161. package/dist/mcp/persistent-monitor-runtime.d.ts +1 -0
  162. package/dist/mcp/persistent-monitor-runtime.d.ts.map +1 -1
  163. package/dist/mcp/persistent-monitor-runtime.js +35 -0
  164. package/dist/mcp/persistent-monitor-runtime.js.map +1 -1
  165. package/dist/mcp/repo-tool-worker-context.d.ts.map +1 -1
  166. package/dist/mcp/repo-tool-worker-context.js +5 -2
  167. package/dist/mcp/repo-tool-worker-context.js.map +1 -1
  168. package/dist/mcp/server-context.d.ts.map +1 -1
  169. package/dist/mcp/server-context.js +13 -0
  170. package/dist/mcp/server-context.js.map +1 -1
  171. package/dist/mcp/server-tool-access.d.ts +1 -1
  172. package/dist/mcp/server-tool-access.d.ts.map +1 -1
  173. package/dist/mcp/server-tool-access.js +3 -1
  174. package/dist/mcp/server-tool-access.js.map +1 -1
  175. package/dist/mcp/server.d.ts +3 -0
  176. package/dist/mcp/server.d.ts.map +1 -1
  177. package/dist/mcp/server.js +5 -3
  178. package/dist/mcp/server.js.map +1 -1
  179. package/dist/mcp/tool-registry.d.ts.map +1 -1
  180. package/dist/mcp/tool-registry.js +18 -0
  181. package/dist/mcp/tool-registry.js.map +1 -1
  182. package/dist/mcp/tools/code-find.d.ts.map +1 -1
  183. package/dist/mcp/tools/code-find.js +20 -0
  184. package/dist/mcp/tools/code-find.js.map +1 -1
  185. package/dist/mcp/tools/code-show.d.ts.map +1 -1
  186. package/dist/mcp/tools/code-show.js +24 -0
  187. package/dist/mcp/tools/code-show.js.map +1 -1
  188. package/dist/mcp/tools/diagnostic-models.d.ts +2 -0
  189. package/dist/mcp/tools/diagnostic-models.d.ts.map +1 -1
  190. package/dist/mcp/tools/doctor.d.ts.map +1 -1
  191. package/dist/mcp/tools/doctor.js +18 -1
  192. package/dist/mcp/tools/doctor.js.map +1 -1
  193. package/dist/mcp/tools/export-surface-diff.d.ts +3 -0
  194. package/dist/mcp/tools/export-surface-diff.d.ts.map +1 -0
  195. package/dist/mcp/tools/export-surface-diff.js +24 -0
  196. package/dist/mcp/tools/export-surface-diff.js.map +1 -0
  197. package/dist/mcp/tools/file-outline.js +1 -1
  198. package/dist/mcp/tools/file-outline.js.map +1 -1
  199. package/dist/mcp/tools/graft-edit.d.ts +3 -0
  200. package/dist/mcp/tools/graft-edit.d.ts.map +1 -0
  201. package/dist/mcp/tools/graft-edit.js +192 -0
  202. package/dist/mcp/tools/graft-edit.js.map +1 -0
  203. package/dist/mcp/tools/knowledge-map.d.ts +3 -0
  204. package/dist/mcp/tools/knowledge-map.d.ts.map +1 -0
  205. package/dist/mcp/tools/knowledge-map.js +31 -0
  206. package/dist/mcp/tools/knowledge-map.js.map +1 -0
  207. package/dist/mcp/tools/monitor-nudge.d.ts +3 -0
  208. package/dist/mcp/tools/monitor-nudge.d.ts.map +1 -0
  209. package/dist/mcp/tools/monitor-nudge.js +17 -0
  210. package/dist/mcp/tools/monitor-nudge.js.map +1 -0
  211. package/dist/mcp/tools/precision-warp.d.ts +3 -3
  212. package/dist/mcp/tools/precision-warp.d.ts.map +1 -1
  213. package/dist/mcp/tools/precision-warp.js +24 -15
  214. package/dist/mcp/tools/precision-warp.js.map +1 -1
  215. package/dist/mcp/tools/refactor-difficulty.d.ts +3 -0
  216. package/dist/mcp/tools/refactor-difficulty.d.ts.map +1 -0
  217. package/dist/mcp/tools/refactor-difficulty.js +36 -0
  218. package/dist/mcp/tools/refactor-difficulty.js.map +1 -0
  219. package/dist/mcp/tools/safe-read.js +2 -2
  220. package/dist/mcp/tools/safe-read.js.map +1 -1
  221. package/dist/mcp/tools/structural-blame.d.ts +3 -0
  222. package/dist/mcp/tools/structural-blame.d.ts.map +1 -0
  223. package/dist/mcp/tools/structural-blame.js +44 -0
  224. package/dist/mcp/tools/structural-blame.js.map +1 -0
  225. package/dist/mcp/tools/structural-churn.d.ts +3 -0
  226. package/dist/mcp/tools/structural-churn.d.ts.map +1 -0
  227. package/dist/mcp/tools/structural-churn.js +28 -0
  228. package/dist/mcp/tools/structural-churn.js.map +1 -0
  229. package/dist/mcp/tools/structural-log.d.ts +3 -0
  230. package/dist/mcp/tools/structural-log.d.ts.map +1 -0
  231. package/dist/mcp/tools/structural-log.js +38 -0
  232. package/dist/mcp/tools/structural-log.js.map +1 -0
  233. package/dist/mcp/tools/structural-review.d.ts +3 -0
  234. package/dist/mcp/tools/structural-review.d.ts.map +1 -0
  235. package/dist/mcp/tools/structural-review.js +55 -0
  236. package/dist/mcp/tools/structural-review.js.map +1 -0
  237. package/dist/mcp/warp-pool.d.ts +4 -4
  238. package/dist/mcp/warp-pool.d.ts.map +1 -1
  239. package/dist/mcp/warp-pool.js.map +1 -1
  240. package/dist/mcp/workspace-router-model.d.ts +2 -2
  241. package/dist/mcp/workspace-router-model.d.ts.map +1 -1
  242. package/dist/mcp/workspace-router-runtime.d.ts +3 -3
  243. package/dist/mcp/workspace-router-runtime.d.ts.map +1 -1
  244. package/dist/mcp/workspace-router-runtime.js +4 -1
  245. package/dist/mcp/workspace-router-runtime.js.map +1 -1
  246. package/dist/mcp/workspace-router.d.ts +3 -2
  247. package/dist/mcp/workspace-router.d.ts.map +1 -1
  248. package/dist/mcp/workspace-router.js +6 -0
  249. package/dist/mcp/workspace-router.js.map +1 -1
  250. package/dist/operations/adaptive-projection.d.ts +22 -0
  251. package/dist/operations/adaptive-projection.d.ts.map +1 -0
  252. package/dist/operations/adaptive-projection.js +36 -0
  253. package/dist/operations/adaptive-projection.js.map +1 -0
  254. package/dist/operations/agent-handoff.d.ts +25 -0
  255. package/dist/operations/agent-handoff.d.ts.map +1 -0
  256. package/dist/operations/agent-handoff.js +36 -0
  257. package/dist/operations/agent-handoff.js.map +1 -0
  258. package/dist/operations/capture-range.d.ts +33 -0
  259. package/dist/operations/capture-range.d.ts.map +1 -0
  260. package/dist/operations/capture-range.js +45 -0
  261. package/dist/operations/capture-range.js.map +1 -0
  262. package/dist/operations/conversation-primer.d.ts +27 -0
  263. package/dist/operations/conversation-primer.d.ts.map +1 -0
  264. package/dist/operations/conversation-primer.js +52 -0
  265. package/dist/operations/conversation-primer.js.map +1 -0
  266. package/dist/operations/cross-session-resume.d.ts +28 -0
  267. package/dist/operations/cross-session-resume.d.ts.map +1 -0
  268. package/dist/operations/cross-session-resume.js +79 -0
  269. package/dist/operations/cross-session-resume.js.map +1 -0
  270. package/dist/operations/deterministic-replay.d.ts +39 -0
  271. package/dist/operations/deterministic-replay.d.ts.map +1 -0
  272. package/dist/operations/deterministic-replay.js +90 -0
  273. package/dist/operations/deterministic-replay.js.map +1 -0
  274. package/dist/operations/export-surface-diff.d.ts +36 -0
  275. package/dist/operations/export-surface-diff.d.ts.map +1 -0
  276. package/dist/operations/export-surface-diff.js +298 -0
  277. package/dist/operations/export-surface-diff.js.map +1 -0
  278. package/dist/operations/footprint-parallelism.d.ts +25 -0
  279. package/dist/operations/footprint-parallelism.d.ts.map +1 -0
  280. package/dist/operations/footprint-parallelism.js +79 -0
  281. package/dist/operations/footprint-parallelism.js.map +1 -0
  282. package/dist/operations/graft-diff.d.ts.map +1 -1
  283. package/dist/operations/graft-diff.js +14 -7
  284. package/dist/operations/graft-diff.js.map +1 -1
  285. package/dist/operations/horizon-of-readability.d.ts +23 -0
  286. package/dist/operations/horizon-of-readability.d.ts.map +1 -0
  287. package/dist/operations/horizon-of-readability.js +39 -0
  288. package/dist/operations/horizon-of-readability.js.map +1 -0
  289. package/dist/operations/import-reference-impact.d.ts +13 -0
  290. package/dist/operations/import-reference-impact.d.ts.map +1 -0
  291. package/dist/operations/import-reference-impact.js +101 -0
  292. package/dist/operations/import-reference-impact.js.map +1 -0
  293. package/dist/operations/knowledge-map.d.ts +30 -0
  294. package/dist/operations/knowledge-map.d.ts.map +1 -0
  295. package/dist/operations/knowledge-map.js +64 -0
  296. package/dist/operations/knowledge-map.js.map +1 -0
  297. package/dist/operations/observation-cache.d.ts +8 -2
  298. package/dist/operations/observation-cache.d.ts.map +1 -1
  299. package/dist/operations/observation-cache.js +17 -5
  300. package/dist/operations/observation-cache.js.map +1 -1
  301. package/dist/operations/projection-safety.d.ts +31 -0
  302. package/dist/operations/projection-safety.d.ts.map +1 -0
  303. package/dist/operations/projection-safety.js +77 -0
  304. package/dist/operations/projection-safety.js.map +1 -0
  305. package/dist/operations/repo-workspace.js +3 -3
  306. package/dist/operations/repo-workspace.js.map +1 -1
  307. package/dist/operations/semantic-drift.d.ts +27 -0
  308. package/dist/operations/semantic-drift.d.ts.map +1 -0
  309. package/dist/operations/semantic-drift.js +46 -0
  310. package/dist/operations/semantic-drift.js.map +1 -0
  311. package/dist/operations/session-filtration.d.ts +36 -0
  312. package/dist/operations/session-filtration.d.ts.map +1 -0
  313. package/dist/operations/session-filtration.js +48 -0
  314. package/dist/operations/session-filtration.js.map +1 -0
  315. package/dist/operations/session-replay.d.ts +17 -0
  316. package/dist/operations/session-replay.d.ts.map +1 -0
  317. package/dist/operations/session-replay.js +59 -0
  318. package/dist/operations/session-replay.js.map +1 -0
  319. package/dist/operations/sludge-detector.d.ts +45 -0
  320. package/dist/operations/sludge-detector.d.ts.map +1 -0
  321. package/dist/operations/sludge-detector.js +278 -0
  322. package/dist/operations/sludge-detector.js.map +1 -0
  323. package/dist/operations/structural-blame.d.ts +67 -0
  324. package/dist/operations/structural-blame.d.ts.map +1 -0
  325. package/dist/operations/structural-blame.js +111 -0
  326. package/dist/operations/structural-blame.js.map +1 -0
  327. package/dist/operations/structural-review.d.ts +47 -0
  328. package/dist/operations/structural-review.d.ts.map +1 -0
  329. package/dist/operations/structural-review.js +225 -0
  330. package/dist/operations/structural-review.js.map +1 -0
  331. package/dist/operations/teaching-hints.d.ts +18 -0
  332. package/dist/operations/teaching-hints.d.ts.map +1 -0
  333. package/dist/operations/teaching-hints.js +35 -0
  334. package/dist/operations/teaching-hints.js.map +1 -0
  335. package/dist/parser/diff.d.ts +2 -0
  336. package/dist/parser/diff.d.ts.map +1 -1
  337. package/dist/parser/diff.js +7 -0
  338. package/dist/parser/diff.js.map +1 -1
  339. package/dist/ports/paths.d.ts +17 -0
  340. package/dist/ports/paths.d.ts.map +1 -0
  341. package/dist/ports/{warp.js → paths.js} +2 -2
  342. package/dist/ports/paths.js.map +1 -0
  343. package/dist/version.d.ts.map +1 -1
  344. package/dist/version.js +3 -1
  345. package/dist/version.js.map +1 -1
  346. package/dist/warp/ast-emitter.d.ts +28 -0
  347. package/dist/warp/ast-emitter.d.ts.map +1 -0
  348. package/dist/warp/ast-emitter.js +90 -0
  349. package/dist/warp/ast-emitter.js.map +1 -0
  350. package/dist/warp/ast-import-resolver.d.ts +13 -0
  351. package/dist/warp/ast-import-resolver.d.ts.map +1 -0
  352. package/dist/warp/ast-import-resolver.js +259 -0
  353. package/dist/warp/ast-import-resolver.js.map +1 -0
  354. package/dist/warp/commit-meta.d.ts +8 -0
  355. package/dist/warp/commit-meta.d.ts.map +1 -0
  356. package/dist/warp/commit-meta.js +13 -0
  357. package/dist/warp/commit-meta.js.map +1 -0
  358. package/dist/warp/context.d.ts +10 -0
  359. package/dist/warp/context.d.ts.map +1 -0
  360. package/dist/warp/context.js +26 -0
  361. package/dist/warp/context.js.map +1 -0
  362. package/dist/warp/dead-symbols.d.ts +40 -0
  363. package/dist/warp/dead-symbols.d.ts.map +1 -0
  364. package/dist/warp/dead-symbols.js +127 -0
  365. package/dist/warp/dead-symbols.js.map +1 -0
  366. package/dist/warp/drift-sentinel.d.ts +30 -0
  367. package/dist/warp/drift-sentinel.d.ts.map +1 -0
  368. package/dist/warp/drift-sentinel.js +65 -0
  369. package/dist/warp/drift-sentinel.js.map +1 -0
  370. package/dist/warp/index-head.d.ts +32 -0
  371. package/dist/warp/index-head.d.ts.map +1 -0
  372. package/dist/warp/index-head.js +245 -0
  373. package/dist/warp/index-head.js.map +1 -0
  374. package/dist/warp/observers.d.ts +6 -6
  375. package/dist/warp/observers.d.ts.map +1 -1
  376. package/dist/warp/observers.js +5 -4
  377. package/dist/warp/observers.js.map +1 -1
  378. package/dist/warp/open.d.ts +5 -4
  379. package/dist/warp/open.d.ts.map +1 -1
  380. package/dist/warp/open.js +24 -49
  381. package/dist/warp/open.js.map +1 -1
  382. package/dist/warp/outline-diff-trailer.d.ts +26 -0
  383. package/dist/warp/outline-diff-trailer.d.ts.map +1 -0
  384. package/dist/warp/outline-diff-trailer.js +68 -0
  385. package/dist/warp/outline-diff-trailer.js.map +1 -0
  386. package/dist/warp/refactor-difficulty.d.ts +38 -0
  387. package/dist/warp/refactor-difficulty.d.ts.map +1 -0
  388. package/dist/warp/refactor-difficulty.js +169 -0
  389. package/dist/warp/refactor-difficulty.js.map +1 -0
  390. package/dist/warp/references.d.ts +22 -0
  391. package/dist/warp/references.d.ts.map +1 -0
  392. package/dist/warp/references.js +57 -0
  393. package/dist/warp/references.js.map +1 -0
  394. package/dist/warp/stale-docs.d.ts +56 -0
  395. package/dist/warp/stale-docs.d.ts.map +1 -0
  396. package/dist/warp/stale-docs.js +149 -0
  397. package/dist/warp/stale-docs.js.map +1 -0
  398. package/dist/warp/structural-drift-detection.d.ts +49 -0
  399. package/dist/warp/structural-drift-detection.d.ts.map +1 -0
  400. package/dist/warp/structural-drift-detection.js +51 -0
  401. package/dist/warp/structural-drift-detection.js.map +1 -0
  402. package/dist/warp/structural-queries.d.ts +49 -0
  403. package/dist/warp/structural-queries.d.ts.map +1 -0
  404. package/dist/warp/structural-queries.js +175 -0
  405. package/dist/warp/structural-queries.js.map +1 -0
  406. package/dist/warp/symbol-timeline.d.ts +34 -0
  407. package/dist/warp/symbol-timeline.d.ts.map +1 -0
  408. package/dist/warp/symbol-timeline.js +127 -0
  409. package/dist/warp/symbol-timeline.js.map +1 -0
  410. package/dist/warp/traverse-hydrate.d.ts +23 -0
  411. package/dist/warp/traverse-hydrate.d.ts.map +1 -0
  412. package/dist/warp/traverse-hydrate.js +39 -0
  413. package/dist/warp/traverse-hydrate.js.map +1 -0
  414. package/dist/warp/warp-reference-count.d.ts +19 -0
  415. package/dist/warp/warp-reference-count.d.ts.map +1 -0
  416. package/dist/warp/warp-reference-count.js +32 -0
  417. package/dist/warp/warp-reference-count.js.map +1 -0
  418. package/dist/warp/warp-structural-blame.d.ts +20 -0
  419. package/dist/warp/warp-structural-blame.d.ts.map +1 -0
  420. package/dist/warp/warp-structural-blame.js +43 -0
  421. package/dist/warp/warp-structural-blame.js.map +1 -0
  422. package/dist/warp/warp-structural-churn.d.ts +30 -0
  423. package/dist/warp/warp-structural-churn.d.ts.map +1 -0
  424. package/dist/warp/warp-structural-churn.js +213 -0
  425. package/dist/warp/warp-structural-churn.js.map +1 -0
  426. package/dist/warp/warp-structural-log.d.ts +35 -0
  427. package/dist/warp/warp-structural-log.d.ts.map +1 -0
  428. package/dist/warp/warp-structural-log.js +104 -0
  429. package/dist/warp/warp-structural-log.js.map +1 -0
  430. package/docs/CLI.md +68 -4
  431. package/docs/MCP.md +23 -0
  432. package/docs/SETUP.md +112 -27
  433. package/package.json +13 -6
  434. package/dist/ports/warp.d.ts +0 -45
  435. package/dist/ports/warp.d.ts.map +0 -1
  436. package/dist/ports/warp.js.map +0 -1
  437. package/dist/warp/identity-resolver.d.ts +0 -14
  438. package/dist/warp/identity-resolver.d.ts.map +0 -1
  439. package/dist/warp/identity-resolver.js +0 -31
  440. package/dist/warp/identity-resolver.js.map +0 -1
  441. package/dist/warp/indexer-git.d.ts +0 -22
  442. package/dist/warp/indexer-git.d.ts.map +0 -1
  443. package/dist/warp/indexer-git.js +0 -148
  444. package/dist/warp/indexer-git.js.map +0 -1
  445. package/dist/warp/indexer-graph.d.ts +0 -17
  446. package/dist/warp/indexer-graph.d.ts.map +0 -1
  447. package/dist/warp/indexer-graph.js +0 -179
  448. package/dist/warp/indexer-graph.js.map +0 -1
  449. package/dist/warp/indexer-model.d.ts +0 -51
  450. package/dist/warp/indexer-model.d.ts.map +0 -1
  451. package/dist/warp/indexer-model.js +0 -21
  452. package/dist/warp/indexer-model.js.map +0 -1
  453. package/dist/warp/indexer.d.ts +0 -9
  454. package/dist/warp/indexer.d.ts.map +0 -1
  455. package/dist/warp/indexer.js +0 -112
  456. package/dist/warp/indexer.js.map +0 -1
  457. package/dist/warp/symbol-identity.d.ts +0 -11
  458. package/dist/warp/symbol-identity.d.ts.map +0 -1
  459. package/dist/warp/symbol-identity.js +0 -67
  460. package/dist/warp/symbol-identity.js.map +0 -1
  461. package/src/adapters/canonical-json.ts +0 -56
  462. package/src/adapters/node-fs.ts +0 -43
  463. package/src/adapters/node-git.ts +0 -47
  464. package/src/adapters/node-process-runner.ts +0 -27
  465. package/src/adapters/repo-paths.ts +0 -22
  466. package/src/adapters/rotating-ndjson-log.ts +0 -66
  467. package/src/api/index.ts +0 -107
  468. package/src/api/repo-local-graft.ts +0 -21
  469. package/src/api/repo-workspace.ts +0 -34
  470. package/src/api/tool-bridge.ts +0 -21
  471. package/src/cli/activity-render.ts +0 -112
  472. package/src/cli/cli-error.ts +0 -153
  473. package/src/cli/command-parser.ts +0 -302
  474. package/src/cli/entrypoint.ts +0 -18
  475. package/src/cli/index-cmd.ts +0 -94
  476. package/src/cli/index-model.ts +0 -76
  477. package/src/cli/init-bootstrap.ts +0 -47
  478. package/src/cli/init-client-config.ts +0 -299
  479. package/src/cli/init-model.ts +0 -229
  480. package/src/cli/init-render.ts +0 -54
  481. package/src/cli/init-target-hooks.ts +0 -93
  482. package/src/cli/init.ts +0 -122
  483. package/src/cli/json-document.ts +0 -144
  484. package/src/cli/local-history-dag-model.ts +0 -437
  485. package/src/cli/local-history-dag-render.ts +0 -133
  486. package/src/cli/local-history-dag.ts +0 -103
  487. package/src/cli/main.ts +0 -150
  488. package/src/cli/migrate-local-history.ts +0 -118
  489. package/src/cli/peer-command.ts +0 -59
  490. package/src/contracts/capabilities.ts +0 -450
  491. package/src/contracts/causal-ontology.ts +0 -627
  492. package/src/contracts/causal-surface-next-action.ts +0 -18
  493. package/src/contracts/json-object.ts +0 -28
  494. package/src/contracts/mcp-runtime.ts +0 -16
  495. package/src/contracts/output-schema-cli.ts +0 -70
  496. package/src/contracts/output-schema-fragments.ts +0 -831
  497. package/src/contracts/output-schema-mcp.ts +0 -282
  498. package/src/contracts/output-schema-meta.ts +0 -119
  499. package/src/contracts/output-schemas.ts +0 -1230
  500. package/src/git/diff.ts +0 -100
  501. package/src/git/target-git-hook-bootstrap.ts +0 -56
  502. package/src/guards/stream-boundary.ts +0 -110
  503. package/src/hooks/posttooluse-read.ts +0 -54
  504. package/src/hooks/pretooluse-read.ts +0 -52
  505. package/src/hooks/read-governor.ts +0 -95
  506. package/src/hooks/read-messages.ts +0 -53
  507. package/src/hooks/shared.ts +0 -168
  508. package/src/index.ts +0 -1
  509. package/src/mcp/burden.ts +0 -123
  510. package/src/mcp/cache.ts +0 -7
  511. package/src/mcp/cached-file.ts +0 -1
  512. package/src/mcp/context.ts +0 -187
  513. package/src/mcp/control-plane/authz-storage.ts +0 -129
  514. package/src/mcp/control-plane/session-registry.ts +0 -115
  515. package/src/mcp/control-plane/status-projection.ts +0 -76
  516. package/src/mcp/control-plane/types.ts +0 -144
  517. package/src/mcp/daemon-bootstrap.ts +0 -100
  518. package/src/mcp/daemon-control-plane.ts +0 -310
  519. package/src/mcp/daemon-job-scheduler.ts +0 -279
  520. package/src/mcp/daemon-repos.ts +0 -99
  521. package/src/mcp/daemon-server.ts +0 -165
  522. package/src/mcp/daemon-session-host.ts +0 -230
  523. package/src/mcp/daemon-stdio-bridge.ts +0 -260
  524. package/src/mcp/daemon-worker-child-pool.ts +0 -213
  525. package/src/mcp/daemon-worker-inline-pool.ts +0 -46
  526. package/src/mcp/daemon-worker-pool.ts +0 -7
  527. package/src/mcp/daemon-worker-process.ts +0 -52
  528. package/src/mcp/daemon-worker-types.ts +0 -66
  529. package/src/mcp/metrics.ts +0 -176
  530. package/src/mcp/monitor-health.ts +0 -83
  531. package/src/mcp/monitor-persistence.ts +0 -54
  532. package/src/mcp/monitor-tick-job.ts +0 -102
  533. package/src/mcp/monitor-types.ts +0 -103
  534. package/src/mcp/persisted-local-history-graph.ts +0 -591
  535. package/src/mcp/persisted-local-history-policy.ts +0 -501
  536. package/src/mcp/persisted-local-history-views.ts +0 -250
  537. package/src/mcp/persisted-local-history.ts +0 -1621
  538. package/src/mcp/persistent-monitor-runtime.ts +0 -445
  539. package/src/mcp/policy.ts +0 -75
  540. package/src/mcp/receipt.ts +0 -201
  541. package/src/mcp/repo-concurrency.ts +0 -392
  542. package/src/mcp/repo-overview/filter.ts +0 -44
  543. package/src/mcp/repo-overview/types.ts +0 -63
  544. package/src/mcp/repo-overview/view-projection.ts +0 -90
  545. package/src/mcp/repo-state-git.ts +0 -247
  546. package/src/mcp/repo-state-observation.ts +0 -203
  547. package/src/mcp/repo-state-transition.ts +0 -151
  548. package/src/mcp/repo-state-types.ts +0 -107
  549. package/src/mcp/repo-state.ts +0 -146
  550. package/src/mcp/repo-tool-job.ts +0 -102
  551. package/src/mcp/repo-tool-worker-context.ts +0 -212
  552. package/src/mcp/repo-workspace.ts +0 -21
  553. package/src/mcp/run-capture-config.ts +0 -33
  554. package/src/mcp/runtime-causal-context.ts +0 -72
  555. package/src/mcp/runtime-observability.ts +0 -217
  556. package/src/mcp/runtime-staged-target.ts +0 -161
  557. package/src/mcp/runtime-workspace-overlay.ts +0 -255
  558. package/src/mcp/secret-scrub.ts +0 -89
  559. package/src/mcp/semantic-transition-guidance.ts +0 -60
  560. package/src/mcp/semantic-transition-summary.ts +0 -130
  561. package/src/mcp/server-context.ts +0 -223
  562. package/src/mcp/server-invocation.ts +0 -388
  563. package/src/mcp/server-tool-access.ts +0 -145
  564. package/src/mcp/server.ts +0 -265
  565. package/src/mcp/stdio-server.ts +0 -26
  566. package/src/mcp/stdio.ts +0 -3
  567. package/src/mcp/tool-registry.ts +0 -80
  568. package/src/mcp/tools/activity-view.ts +0 -325
  569. package/src/mcp/tools/budget.ts +0 -23
  570. package/src/mcp/tools/causal-attach.ts +0 -67
  571. package/src/mcp/tools/causal-status.ts +0 -58
  572. package/src/mcp/tools/changed-since.ts +0 -71
  573. package/src/mcp/tools/code-find.ts +0 -169
  574. package/src/mcp/tools/code-refs.ts +0 -470
  575. package/src/mcp/tools/code-show.ts +0 -262
  576. package/src/mcp/tools/daemon-monitors.ts +0 -14
  577. package/src/mcp/tools/daemon-repos.ts +0 -22
  578. package/src/mcp/tools/daemon-sessions.ts +0 -14
  579. package/src/mcp/tools/daemon-status.ts +0 -12
  580. package/src/mcp/tools/diagnostic-models.ts +0 -95
  581. package/src/mcp/tools/doctor.ts +0 -66
  582. package/src/mcp/tools/explain.ts +0 -84
  583. package/src/mcp/tools/file-outline.ts +0 -67
  584. package/src/mcp/tools/git-files.ts +0 -73
  585. package/src/mcp/tools/graft-diff.ts +0 -35
  586. package/src/mcp/tools/map-collector.ts +0 -338
  587. package/src/mcp/tools/map.ts +0 -185
  588. package/src/mcp/tools/monitor-pause.ts +0 -18
  589. package/src/mcp/tools/monitor-resume.ts +0 -18
  590. package/src/mcp/tools/monitor-start.ts +0 -20
  591. package/src/mcp/tools/monitor-stop.ts +0 -18
  592. package/src/mcp/tools/precision-live.ts +0 -158
  593. package/src/mcp/tools/precision-match.ts +0 -54
  594. package/src/mcp/tools/precision-paths.ts +0 -59
  595. package/src/mcp/tools/precision-query.ts +0 -127
  596. package/src/mcp/tools/precision-show.ts +0 -86
  597. package/src/mcp/tools/precision-visibility.ts +0 -44
  598. package/src/mcp/tools/precision-warp.ts +0 -90
  599. package/src/mcp/tools/precision.ts +0 -21
  600. package/src/mcp/tools/read-range.ts +0 -28
  601. package/src/mcp/tools/run-capture.ts +0 -149
  602. package/src/mcp/tools/safe-read.ts +0 -148
  603. package/src/mcp/tools/since.ts +0 -53
  604. package/src/mcp/tools/state.ts +0 -39
  605. package/src/mcp/tools/stats.ts +0 -24
  606. package/src/mcp/tools/workspace-authorizations.ts +0 -14
  607. package/src/mcp/tools/workspace-authorize.ts +0 -20
  608. package/src/mcp/tools/workspace-bind.ts +0 -25
  609. package/src/mcp/tools/workspace-rebind.ts +0 -25
  610. package/src/mcp/tools/workspace-revoke.ts +0 -18
  611. package/src/mcp/tools/workspace-status.ts +0 -12
  612. package/src/mcp/warp-pool.ts +0 -36
  613. package/src/mcp/workspace-read-observation-model.ts +0 -48
  614. package/src/mcp/workspace-read-observation.ts +0 -103
  615. package/src/mcp/workspace-router-capability.ts +0 -32
  616. package/src/mcp/workspace-router-history.ts +0 -233
  617. package/src/mcp/workspace-router-model.ts +0 -131
  618. package/src/mcp/workspace-router-resolution.ts +0 -71
  619. package/src/mcp/workspace-router-runtime.ts +0 -243
  620. package/src/mcp/workspace-router.ts +0 -681
  621. package/src/metrics/logger.ts +0 -40
  622. package/src/metrics/types.ts +0 -40
  623. package/src/operations/cached-file.ts +0 -40
  624. package/src/operations/diff-identity.ts +0 -127
  625. package/src/operations/file-outline.ts +0 -48
  626. package/src/operations/graft-diff.ts +0 -162
  627. package/src/operations/observation-cache.ts +0 -149
  628. package/src/operations/read-range.ts +0 -64
  629. package/src/operations/repo-workspace.ts +0 -339
  630. package/src/operations/result-dto.ts +0 -23
  631. package/src/operations/safe-read.ts +0 -118
  632. package/src/operations/state.ts +0 -66
  633. package/src/operations/structured-buffer-compare.ts +0 -429
  634. package/src/operations/structured-buffer-model.ts +0 -456
  635. package/src/operations/structured-buffer-query.ts +0 -794
  636. package/src/operations/structured-buffer.ts +0 -181
  637. package/src/parser/diff.ts +0 -313
  638. package/src/parser/lang.ts +0 -71
  639. package/src/parser/markdown.ts +0 -197
  640. package/src/parser/outline.ts +0 -316
  641. package/src/parser/runtime.ts +0 -71
  642. package/src/parser/types.ts +0 -75
  643. package/src/policy/evaluate.ts +0 -178
  644. package/src/policy/graftignore.ts +0 -6
  645. package/src/policy/types.ts +0 -87
  646. package/src/ports/codec.ts +0 -13
  647. package/src/ports/filesystem.ts +0 -18
  648. package/src/ports/git.ts +0 -16
  649. package/src/ports/guards.ts +0 -68
  650. package/src/ports/process-runner.ts +0 -22
  651. package/src/ports/warp.ts +0 -55
  652. package/src/release/security-gate.ts +0 -102
  653. package/src/session/tracker.ts +0 -145
  654. package/src/session/types.ts +0 -23
  655. package/src/version.ts +0 -3
  656. package/src/warp/identity-resolver.ts +0 -35
  657. package/src/warp/indexer-git.ts +0 -182
  658. package/src/warp/indexer-graph.ts +0 -276
  659. package/src/warp/indexer-model.ts +0 -69
  660. package/src/warp/indexer.ts +0 -186
  661. package/src/warp/observers.ts +0 -100
  662. package/src/warp/open.ts +0 -93
  663. package/src/warp/plumbing.d.ts +0 -15
  664. package/src/warp/symbol-identity.ts +0 -100
  665. package/src/warp/writer-id.ts +0 -30
@@ -1,18 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const monitorStopTool: ToolDefinition = {
5
- name: "monitor_stop",
6
- description:
7
- "Stop the repo-scoped background index monitor for an authorized workspace.",
8
- schema: {
9
- cwd: z.string(),
10
- },
11
- createHandler(): ToolHandler {
12
- return async (args, ctx) => {
13
- return ctx.respond("monitor_stop", { ...await ctx.stopMonitor({
14
- cwd: args["cwd"] as string,
15
- }) });
16
- };
17
- },
18
- };
@@ -1,158 +0,0 @@
1
- import { getFileAtRef } from "../../git/diff.js";
2
- import { detectLang } from "../../parser/lang.js";
3
- import { extractOutline } from "../../parser/outline.js";
4
- import type { JumpEntry, OutlineEntry } from "../../parser/types.js";
5
- import type { ToolContext } from "../context.js";
6
- import { evaluateMcpRefusal, type McpPolicyRefusal } from "../policy.js";
7
- import type { RankedPrecisionSymbolMatch } from "./precision-query.js";
8
- import { PrecisionSearchRequest } from "./precision-query.js";
9
- import { PrecisionSymbolMatch } from "./precision-match.js";
10
-
11
- const MAX_RANGE_LINES = 250;
12
-
13
- function buildJumpLookup(
14
- jumpTable: readonly JumpEntry[],
15
- ): Map<string, { start: number; end: number }[]> {
16
- const lookup = new Map<string, { start: number; end: number }[]>();
17
- for (const entry of jumpTable) {
18
- const existing = lookup.get(entry.symbol) ?? [];
19
- existing.push({ start: entry.start, end: entry.end });
20
- lookup.set(entry.symbol, existing);
21
- }
22
- return lookup;
23
- }
24
-
25
- export type PrecisionPolicyRefusal = McpPolicyRefusal;
26
-
27
- export function collectSymbols(
28
- entries: readonly OutlineEntry[],
29
- filePath: string,
30
- jumpTable: readonly JumpEntry[],
31
- jumpCursor: Map<string, number> = new Map<string, number>(),
32
- ): PrecisionSymbolMatch[] {
33
- const jumpLookup = buildJumpLookup(jumpTable);
34
- const results: PrecisionSymbolMatch[] = [];
35
-
36
- for (const entry of entries) {
37
- const candidates = jumpLookup.get(entry.name) ?? [];
38
- const jumpIndex = jumpCursor.get(entry.name) ?? 0;
39
- const jump = candidates[jumpIndex];
40
- if (jump !== undefined) {
41
- jumpCursor.set(entry.name, jumpIndex + 1);
42
- }
43
- results.push(new PrecisionSymbolMatch({
44
- name: entry.name,
45
- kind: entry.kind,
46
- path: filePath,
47
- exported: entry.exported,
48
- ...(entry.signature !== undefined ? { signature: entry.signature } : {}),
49
- ...(jump?.start !== undefined ? { startLine: jump.start } : {}),
50
- ...(jump?.end !== undefined ? { endLine: jump.end } : {}),
51
- }));
52
-
53
- if (entry.children !== undefined && entry.children.length > 0) {
54
- results.push(...collectSymbols(entry.children, filePath, jumpTable, jumpCursor));
55
- }
56
- }
57
-
58
- return results;
59
- }
60
-
61
- export async function loadFileContent(
62
- ctx: ToolContext,
63
- filePath: string,
64
- ref?: string,
65
- ): Promise<string | null> {
66
- if (ref !== undefined) {
67
- return getFileAtRef(ref, filePath, { cwd: ctx.projectRoot, git: ctx.git });
68
- }
69
-
70
- try {
71
- return await ctx.fs.readFile(ctx.resolvePath(filePath), "utf-8");
72
- } catch {
73
- return null;
74
- }
75
- }
76
-
77
- export function evaluatePrecisionPolicy(
78
- ctx: ToolContext,
79
- filePath: string,
80
- content: string,
81
- ): PrecisionPolicyRefusal | null {
82
- const actual = {
83
- lines: content.split("\n").length,
84
- bytes: Buffer.byteLength(content),
85
- };
86
- return evaluateMcpRefusal(ctx, filePath, actual);
87
- }
88
-
89
- export async function searchLiveSymbols(
90
- ctx: ToolContext,
91
- filePaths: readonly string[],
92
- request: PrecisionSearchRequest,
93
- ref?: string,
94
- ): Promise<PrecisionSymbolMatch[]> {
95
- const matches: RankedPrecisionSymbolMatch[] = [];
96
-
97
- for (const filePath of filePaths) {
98
- const lang = detectLang(filePath);
99
- if (lang === null) continue;
100
-
101
- const content = await loadFileContent(ctx, filePath, ref);
102
- if (content === null) continue;
103
-
104
- const result = extractOutline(content, lang);
105
- const symbols = collectSymbols(result.entries, filePath, result.jumpTable ?? []);
106
-
107
- for (const symbol of symbols) {
108
- const ranked = request.rank(symbol);
109
- if (ranked !== null) matches.push(ranked);
110
- }
111
- }
112
-
113
- return request.sort(matches);
114
- }
115
-
116
- export function readRangeFromContent(
117
- filePath: string,
118
- content: string,
119
- start: number,
120
- end: number,
121
- ): {
122
- path: string;
123
- content?: string | undefined;
124
- startLine?: number | undefined;
125
- endLine?: number | undefined;
126
- truncated?: boolean | undefined;
127
- clipped?: boolean | undefined;
128
- reason?: string | undefined;
129
- } {
130
- if (start > end) {
131
- return { path: filePath, reason: "INVALID_RANGE" };
132
- }
133
-
134
- const allLines = content.split("\n");
135
- const totalLines = allLines.length;
136
- let effectiveEnd = end;
137
- let truncated = false;
138
- let clipped = false;
139
-
140
- if (effectiveEnd - start + 1 > MAX_RANGE_LINES) {
141
- effectiveEnd = start + MAX_RANGE_LINES - 1;
142
- truncated = true;
143
- }
144
-
145
- if (effectiveEnd > totalLines) {
146
- effectiveEnd = totalLines;
147
- clipped = true;
148
- }
149
-
150
- return {
151
- path: filePath,
152
- content: allLines.slice(start - 1, effectiveEnd).join("\n"),
153
- startLine: start,
154
- endLine: effectiveEnd,
155
- ...(truncated ? { truncated: true, reason: "RANGE_EXCEEDED" } : {}),
156
- ...(clipped ? { clipped: true } : {}),
157
- };
158
- }
@@ -1,54 +0,0 @@
1
- export class PrecisionSymbolMatch {
2
- readonly name: string;
3
- readonly kind: string;
4
- readonly path: string;
5
- readonly identityId?: string;
6
- readonly signature?: string;
7
- readonly exported: boolean;
8
- readonly startLine?: number;
9
- readonly endLine?: number;
10
-
11
- constructor(opts: {
12
- name: string;
13
- kind: string;
14
- path: string;
15
- identityId?: string;
16
- signature?: string;
17
- exported: boolean;
18
- startLine?: number;
19
- endLine?: number;
20
- }) {
21
- if (opts.name.trim().length === 0) {
22
- throw new Error("PrecisionSymbolMatch: name must be non-empty");
23
- }
24
- if (opts.kind.trim().length === 0) {
25
- throw new Error("PrecisionSymbolMatch: kind must be non-empty");
26
- }
27
- if (opts.path.trim().length === 0) {
28
- throw new Error("PrecisionSymbolMatch: path must be non-empty");
29
- }
30
- if (opts.startLine !== undefined && (!Number.isInteger(opts.startLine) || opts.startLine < 1)) {
31
- throw new Error("PrecisionSymbolMatch: startLine must be an integer >= 1");
32
- }
33
- if (opts.endLine !== undefined && (!Number.isInteger(opts.endLine) || opts.endLine < 1)) {
34
- throw new Error("PrecisionSymbolMatch: endLine must be an integer >= 1");
35
- }
36
- if (
37
- opts.startLine !== undefined &&
38
- opts.endLine !== undefined &&
39
- opts.endLine < opts.startLine
40
- ) {
41
- throw new Error("PrecisionSymbolMatch: endLine must be >= startLine");
42
- }
43
-
44
- this.name = opts.name.trim();
45
- this.kind = opts.kind.trim();
46
- this.path = opts.path.trim();
47
- this.exported = opts.exported;
48
- if (opts.identityId !== undefined) this.identityId = opts.identityId;
49
- if (opts.signature !== undefined) this.signature = opts.signature;
50
- if (opts.startLine !== undefined) this.startLine = opts.startLine;
51
- if (opts.endLine !== undefined) this.endLine = opts.endLine;
52
- Object.freeze(this);
53
- }
54
- }
@@ -1,59 +0,0 @@
1
- import * as path from "node:path";
2
- import { GitError } from "../../git/diff.js";
3
- import type { GitClient } from "../../ports/git.js";
4
-
5
- async function git(gitClient: GitClient, args: readonly string[], cwd: string): Promise<string> {
6
- const result = await gitClient.run({ args, cwd });
7
- if (result.error !== undefined || result.status !== 0) {
8
- throw result.error ?? new Error(result.stderr.trim() || `git exited with status ${String(result.status)}`);
9
- }
10
- return result.stdout;
11
- }
12
-
13
- export function normalizeRepoPath(projectRoot: string, input: string): string {
14
- if (!path.isAbsolute(input)) return input;
15
- const rel = path.relative(projectRoot, input);
16
- if (rel === "") return ".";
17
- return rel.startsWith("..") ? input : rel;
18
- }
19
-
20
- export function requireRepoPath(projectRoot: string, input: string): string {
21
- const normalized = normalizeRepoPath(projectRoot, input);
22
- if (path.isAbsolute(normalized)) {
23
- throw new Error(`Path must be inside the repository for git-ref queries: ${input}`);
24
- }
25
- return normalized;
26
- }
27
-
28
- export async function resolveGitRef(ref: string, gitClient: GitClient, cwd: string): Promise<string> {
29
- try {
30
- return (await git(gitClient, ["rev-parse", "--verify", ref], cwd)).trim();
31
- } catch {
32
- throw new GitError(`ref does not exist: ${ref}`);
33
- }
34
- }
35
-
36
- export async function listTrackedFilesAtRef(
37
- dirPath: string,
38
- gitClient: GitClient,
39
- cwd: string,
40
- ref: string,
41
- ): Promise<string[]> {
42
- try {
43
- const args = dirPath.length > 0
44
- ? ["ls-tree", "-r", "--name-only", ref, "--", dirPath]
45
- : ["ls-tree", "-r", "--name-only", ref];
46
- const output = (await git(gitClient, args, cwd)).trim();
47
- return output.length === 0 ? [] : output.split("\n");
48
- } catch {
49
- return [];
50
- }
51
- }
52
-
53
- export async function isWorkingTreeDirty(gitClient: GitClient, cwd: string): Promise<boolean> {
54
- try {
55
- return (await git(gitClient, ["status", "--porcelain"], cwd)).trim().length > 0;
56
- } catch {
57
- return true;
58
- }
59
- }
@@ -1,127 +0,0 @@
1
- import picomatch from "picomatch";
2
- import { PrecisionSymbolMatch } from "./precision-match.js";
3
-
4
- type SymbolQueryMode = "glob" | "plain";
5
-
6
- export class RankedPrecisionSymbolMatch {
7
- readonly match: PrecisionSymbolMatch;
8
- readonly score: number;
9
-
10
- constructor(opts: {
11
- match: PrecisionSymbolMatch;
12
- score: number;
13
- }) {
14
- if (opts.score < 0) {
15
- throw new Error("RankedPrecisionSymbolMatch: score must be >= 0");
16
- }
17
- this.match = opts.match;
18
- this.score = opts.score;
19
- Object.freeze(this);
20
- }
21
- }
22
-
23
- class PrecisionSymbolQuery {
24
- readonly text: string;
25
- readonly mode: SymbolQueryMode;
26
- readonly #globMatcher?: (name: string) => boolean;
27
-
28
- constructor(query: string) {
29
- const normalizedQuery = query.trim();
30
- if (normalizedQuery.length === 0) {
31
- throw new Error("PrecisionSymbolQuery: query must be non-empty");
32
- }
33
- this.text = normalizedQuery;
34
- if (picomatch.scan(normalizedQuery).isGlob) {
35
- this.mode = "glob";
36
- this.#globMatcher = picomatch(normalizedQuery, { nocase: true });
37
- } else {
38
- this.mode = "plain";
39
- }
40
- Object.freeze(this);
41
- }
42
-
43
- score(name: string): number | null {
44
- if (this.mode === "glob") {
45
- return this.#globMatcher?.(name) === true ? 0 : null;
46
- }
47
-
48
- const loweredName = name.toLowerCase();
49
- const loweredQuery = this.text.toLowerCase();
50
- if (name === this.text) return 0;
51
- if (loweredName === loweredQuery) return 1;
52
- if (name.startsWith(this.text)) return 2;
53
- if (loweredName.startsWith(loweredQuery)) return 3;
54
- return loweredName.includes(loweredQuery) ? 4 : null;
55
- }
56
- }
57
-
58
- export class PrecisionSearchRequest {
59
- readonly exactName?: string;
60
- readonly query?: PrecisionSymbolQuery;
61
- readonly kind?: string;
62
- readonly filePath?: string;
63
- readonly pathPrefix?: string;
64
- readonly ceiling?: number;
65
-
66
- constructor(opts: {
67
- exactName?: string;
68
- query?: string;
69
- kind?: string;
70
- filePath?: string;
71
- pathPrefix?: string;
72
- ceiling?: number;
73
- }) {
74
- const exactName = opts.exactName?.trim();
75
- const query = opts.query?.trim();
76
- const kind = opts.kind?.trim().toLowerCase();
77
- const filePath = opts.filePath?.trim();
78
- const pathPrefix = opts.pathPrefix?.trim();
79
-
80
- if ((exactName?.length ?? 0) === 0 && (query?.length ?? 0) === 0) {
81
- throw new Error("PrecisionSearchRequest: exactName or query is required");
82
- }
83
- if (
84
- opts.ceiling !== undefined &&
85
- (!Number.isInteger(opts.ceiling) || opts.ceiling < 1)
86
- ) {
87
- throw new Error("PrecisionSearchRequest: ceiling must be an integer >= 1");
88
- }
89
-
90
- if (exactName !== undefined && exactName.length > 0) this.exactName = exactName;
91
- if (query !== undefined && query.length > 0) this.query = new PrecisionSymbolQuery(query);
92
- if (kind !== undefined && kind.length > 0) this.kind = kind;
93
- if (filePath !== undefined && filePath.length > 0) this.filePath = filePath;
94
- if (pathPrefix !== undefined && pathPrefix.length > 0) this.pathPrefix = pathPrefix;
95
- if (opts.ceiling !== undefined) this.ceiling = opts.ceiling;
96
- Object.freeze(this);
97
- }
98
-
99
- selectLens(): "file" | "exact" | "all" {
100
- if (this.filePath !== undefined) return "file";
101
- if (this.exactName !== undefined) return "exact";
102
- return "all";
103
- }
104
-
105
- rank(match: PrecisionSymbolMatch): RankedPrecisionSymbolMatch | null {
106
- if (this.exactName !== undefined && match.name !== this.exactName) return null;
107
- if (this.kind !== undefined && match.kind.toLowerCase() !== this.kind) return null;
108
- if (this.filePath !== undefined && match.path !== this.filePath) return null;
109
- if (this.pathPrefix !== undefined && !match.path.startsWith(this.pathPrefix)) return null;
110
- if (this.query === undefined) {
111
- return new RankedPrecisionSymbolMatch({ match, score: 0 });
112
- }
113
- const score = this.query.score(match.name);
114
- return score === null ? null : new RankedPrecisionSymbolMatch({ match, score });
115
- }
116
-
117
- sort(matches: readonly RankedPrecisionSymbolMatch[]): PrecisionSymbolMatch[] {
118
- return [...matches]
119
- .sort((a, b) =>
120
- a.score - b.score ||
121
- (this.query?.mode === "plain" ? a.match.name.length - b.match.name.length : 0) ||
122
- a.match.path.localeCompare(b.match.path) ||
123
- a.match.name.localeCompare(b.match.name)
124
- )
125
- .map((entry) => entry.match);
126
- }
127
- }
@@ -1,86 +0,0 @@
1
- import type { ToolContext } from "../context.js";
2
- import { listProjectFiles } from "./git-files.js";
3
- import {
4
- getIndexedCommitCeilings,
5
- searchWarpSymbols,
6
- } from "./precision-warp.js";
7
- import {
8
- listTrackedFilesAtRef,
9
- requireRepoPath,
10
- resolveGitRef,
11
- } from "./precision-paths.js";
12
- import {
13
- searchLiveSymbols,
14
- } from "./precision-live.js";
15
- import { PrecisionSearchRequest } from "./precision-query.js";
16
- import type { PrecisionSymbolMatch } from "./precision-match.js";
17
-
18
- export interface CodeShowResolution {
19
- readonly layer: "commit_worldline" | "ref_view" | "workspace_overlay";
20
- readonly source: "warp" | "live";
21
- readonly resolvedRef?: string | undefined;
22
- readonly locations: PrecisionSymbolMatch[];
23
- }
24
-
25
- export async function resolveCodeShowLocations(
26
- ctx: ToolContext,
27
- input: {
28
- symbolName: string;
29
- targetPath?: string | undefined;
30
- ref?: string | undefined;
31
- allowWarp: boolean;
32
- },
33
- ): Promise<CodeShowResolution> {
34
- const repoState = ctx.getRepoState();
35
- const layer = input.ref !== undefined
36
- ? "commit_worldline"
37
- : repoState.dirty
38
- ? "workspace_overlay"
39
- : "ref_view";
40
-
41
- let resolvedRef: string | undefined;
42
- if (input.ref !== undefined) {
43
- resolvedRef = await resolveGitRef(input.ref, ctx.git, ctx.projectRoot);
44
- }
45
-
46
- if (resolvedRef !== undefined) {
47
- const repoPath = input.targetPath !== undefined
48
- ? requireRepoPath(ctx.projectRoot, input.targetPath)
49
- : undefined;
50
-
51
- if (input.allowWarp) {
52
- const warp = await ctx.getWarp();
53
- const ceilings = await getIndexedCommitCeilings(warp);
54
- const ceiling = ceilings.get(resolvedRef);
55
- if (ceiling !== undefined) {
56
- const locations = await searchWarpSymbols(warp, new PrecisionSearchRequest({
57
- exactName: input.symbolName,
58
- ...(repoPath !== undefined ? { filePath: repoPath } : {}),
59
- ceiling,
60
- }));
61
- return { layer, source: "warp", resolvedRef, locations };
62
- }
63
- }
64
-
65
- const filePaths = repoPath !== undefined
66
- ? [repoPath]
67
- : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
68
- const locations = await searchLiveSymbols(
69
- ctx,
70
- filePaths,
71
- new PrecisionSearchRequest({ exactName: input.symbolName }),
72
- resolvedRef,
73
- );
74
- return { layer, source: "live", resolvedRef, locations };
75
- }
76
-
77
- const filePaths = input.targetPath !== undefined
78
- ? [input.targetPath]
79
- : await listProjectFiles("", ctx.projectRoot, ctx.git);
80
- const locations = await searchLiveSymbols(
81
- ctx,
82
- filePaths,
83
- new PrecisionSearchRequest({ exactName: input.symbolName }),
84
- );
85
- return { layer, source: "live", locations };
86
- }
@@ -1,44 +0,0 @@
1
- import type { ToolContext } from "../context.js";
2
- import {
3
- evaluatePrecisionPolicy,
4
- loadFileContent,
5
- type PrecisionPolicyRefusal,
6
- } from "./precision-live.js";
7
- import type { PrecisionSymbolMatch } from "./precision-match.js";
8
-
9
- export interface PrecisionVisibilityResult {
10
- readonly visibleMatches: PrecisionSymbolMatch[];
11
- readonly fileCache: Map<string, string>;
12
- readonly firstRefusal:
13
- | PrecisionPolicyRefusal
14
- | undefined;
15
- }
16
-
17
- export async function filterVisiblePrecisionMatches(
18
- ctx: ToolContext,
19
- matches: readonly PrecisionSymbolMatch[],
20
- ref?: string,
21
- ): Promise<PrecisionVisibilityResult> {
22
- const visibleMatches: PrecisionSymbolMatch[] = [];
23
- const fileCache = new Map<string, string>();
24
- let firstRefusal: PrecisionPolicyRefusal | undefined;
25
-
26
- for (const match of matches) {
27
- let content = fileCache.get(match.path);
28
- if (content === undefined) {
29
- const loaded = await loadFileContent(ctx, match.path, ref);
30
- if (loaded === null) continue;
31
- fileCache.set(match.path, loaded);
32
- content = loaded;
33
- }
34
-
35
- const refusal = evaluatePrecisionPolicy(ctx, match.path, content);
36
- if (refusal !== null) {
37
- firstRefusal ??= refusal;
38
- continue;
39
- }
40
- visibleMatches.push(match);
41
- }
42
-
43
- return { visibleMatches, fileCache, firstRefusal };
44
- }
@@ -1,90 +0,0 @@
1
- import type { WarpHandle } from "../../ports/warp.js";
2
- import { allSymbolsLens, commitsLens, fileSymbolsLens, symbolByNameLens } from "../../warp/observers.js";
3
- import type { RankedPrecisionSymbolMatch } from "./precision-query.js";
4
- import { PrecisionSearchRequest } from "./precision-query.js";
5
- import { PrecisionSymbolMatch } from "./precision-match.js";
6
-
7
- function decodeSymbolPath(nodeId: string): string | null {
8
- if (!nodeId.startsWith("sym:")) return null;
9
- const lastColon = nodeId.lastIndexOf(":");
10
- if (lastColon <= "sym:".length) return null;
11
- return nodeId.slice("sym:".length, lastColon);
12
- }
13
-
14
- function toMatch(
15
- nodeId: string,
16
- props: Record<string, unknown>,
17
- ): PrecisionSymbolMatch | null {
18
- const name = props["name"];
19
- const kind = props["kind"];
20
- const path = decodeSymbolPath(nodeId);
21
- if (typeof name !== "string" || typeof kind !== "string" || path === null) {
22
- return null;
23
- }
24
-
25
- return new PrecisionSymbolMatch({
26
- name,
27
- kind,
28
- path,
29
- ...(typeof props["identityId"] === "string" ? { identityId: props["identityId"] } : {}),
30
- ...(typeof props["signature"] === "string" ? { signature: props["signature"] } : {}),
31
- exported: props["exported"] === true,
32
- ...(typeof props["startLine"] === "number" ? { startLine: props["startLine"] } : {}),
33
- ...(typeof props["endLine"] === "number" ? { endLine: props["endLine"] } : {}),
34
- });
35
- }
36
-
37
- export async function getIndexedCommitCeilings(warp: WarpHandle): Promise<ReadonlyMap<string, number>> {
38
- const ceilings = new Map<string, number>();
39
- const observer = await warp.observer(commitsLens());
40
- const nodeIds = await observer.getNodes();
41
-
42
- for (const nodeId of nodeIds) {
43
- const props = await observer.getNodeProps(nodeId);
44
- const sha = typeof props?.["sha"] === "string" ? props["sha"] : null;
45
- const tick = typeof props?.["tick"] === "number" ? props["tick"] : null;
46
- if (sha !== null && tick !== null) {
47
- ceilings.set(sha, tick);
48
- }
49
- }
50
-
51
- return ceilings;
52
- }
53
-
54
- export async function searchWarpSymbols(
55
- warp: WarpHandle,
56
- request: PrecisionSearchRequest,
57
- ): Promise<PrecisionSymbolMatch[]> {
58
- const lensMode = request.selectLens();
59
- let lens;
60
- if (lensMode === "file") {
61
- if (request.filePath === undefined) {
62
- throw new Error("PrecisionSearchRequest selected file lens without filePath");
63
- }
64
- lens = fileSymbolsLens(request.filePath);
65
- } else if (lensMode === "exact") {
66
- if (request.exactName === undefined) {
67
- throw new Error("PrecisionSearchRequest selected exact lens without exactName");
68
- }
69
- lens = symbolByNameLens(request.exactName);
70
- } else {
71
- lens = allSymbolsLens();
72
- }
73
-
74
- const observer = await warp.observer(
75
- lens,
76
- request.ceiling !== undefined ? { source: { kind: "live", ceiling: request.ceiling } } : undefined,
77
- );
78
- const nodeIds = await observer.getNodes();
79
-
80
- const matches = await Promise.all(nodeIds.map(async (nodeId) => {
81
- const props = await observer.getNodeProps(nodeId);
82
- if (props === null) return null;
83
- const match = toMatch(nodeId, props);
84
- if (match === null) return null;
85
- return request.rank(match);
86
- }));
87
-
88
- const visibleMatches = matches.filter((match): match is RankedPrecisionSymbolMatch => match !== null);
89
- return request.sort(visibleMatches);
90
- }
@@ -1,21 +0,0 @@
1
- export { PrecisionSearchRequest } from "./precision-query.js";
2
- export { PrecisionSymbolMatch } from "./precision-match.js";
3
- export type { PrecisionPolicyRefusal } from "./precision-live.js";
4
- export {
5
- collectSymbols,
6
- loadFileContent,
7
- evaluatePrecisionPolicy,
8
- searchLiveSymbols,
9
- readRangeFromContent,
10
- } from "./precision-live.js";
11
- export {
12
- normalizeRepoPath,
13
- requireRepoPath,
14
- resolveGitRef,
15
- listTrackedFilesAtRef,
16
- isWorkingTreeDirty,
17
- } from "./precision-paths.js";
18
- export {
19
- getIndexedCommitCeilings,
20
- searchWarpSymbols,
21
- } from "./precision-warp.js";
@@ -1,28 +0,0 @@
1
- import { z } from "zod";
2
- import { readRange } from "../../operations/read-range.js";
3
- import type { ToolDefinition, ToolHandler } from "../context.js";
4
- import { toJsonObject } from "../../operations/result-dto.js";
5
-
6
- export const readRangeTool: ToolDefinition = {
7
- name: "read_range",
8
- description:
9
- "Read a bounded range of lines from a file. Maximum 250 lines. " +
10
- "Use jump table entries from file_outline or safe_read to target " +
11
- "specific symbols.",
12
- schema: { path: z.string(), start: z.number(), end: z.number() },
13
- policyCheck: true,
14
- createHandler(): ToolHandler {
15
- return async (args, ctx) => {
16
- const filePath = ctx.resolvePath(args["path"] as string);
17
- const startLine = args["start"] as number;
18
- const endLine = args["end"] as number;
19
- const result = await readRange(filePath, startLine, endLine, { fs: ctx.fs });
20
- ctx.metrics.recordRead();
21
- ctx.recordFootprint({
22
- paths: [filePath],
23
- regions: [{ path: filePath, startLine, endLine }],
24
- });
25
- return ctx.respond("read_range", toJsonObject(result));
26
- };
27
- },
28
- };