@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,688 +0,0 @@
1
- import * as path from "node:path";
2
- import { ObservationCache } from "./cache.js";
3
- import { Metrics } from "./metrics.js";
4
- import {
5
- type PersistedLocalActivityWindow,
6
- PersistedLocalHistoryAttachUnavailableError,
7
- PersistedLocalHistoryStore,
8
- type PersistedLocalHistoryAttachDeclaration,
9
- type PersistedLocalHistoryContext,
10
- type RepoConcurrencySummary,
11
- type PersistedLocalHistorySummary,
12
- } from "./persisted-local-history.js";
13
- import { type PersistedLocalHistoryGraphContext } from "./persisted-local-history-graph.js";
14
- import { RepoStateTracker, type RepoObservation } from "./repo-state.js";
15
- import type { RuntimeCausalContext } from "./runtime-causal-context.js";
16
- import { buildRuntimeStagedTarget } from "./runtime-staged-target.js";
17
- import {
18
- buildRuntimeWorkspaceOverlayFooting,
19
- type RuntimeWorkspaceOverlayFooting,
20
- } from "./runtime-workspace-overlay.js";
21
- import { buildWorkspaceReadObservation, type AttributedReadToolName } from "./workspace-read-observation.js";
22
- import {
23
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
24
- WorkspaceBindingRequiredError,
25
- type CausalAttachResult,
26
- type ResolvedWorkspace,
27
- type WorkspaceActionResult,
28
- type WorkspaceAuthorizationPolicy,
29
- type WorkspaceBindAction,
30
- type WorkspaceBindRequest,
31
- type WorkspaceCapabilityProfile,
32
- type WorkspaceExecutionContext,
33
- type WorkspaceMode,
34
- type WorkspaceSharedAttachPolicy,
35
- type WorkspaceStatus,
36
- } from "./workspace-router-model.js";
37
- import { resolveWorkspaceRequest, stableWorkspaceId } from "./workspace-router-resolution.js";
38
- import type { FileSystem } from "../ports/filesystem.js";
39
- import type { GitClient } from "../ports/git.js";
40
- import type { WarpContext } from "../warp/context.js";
41
- import type { JsonObject } from "../contracts/json-object.js";
42
- import type { WarpPool } from "./warp-pool.js";
43
- import { DEFAULT_WARP_WRITER_ID } from "../warp/writer-id.js";
44
- import { GovernorTracker } from "../session/tracker.js";
45
- import {
46
- type BoundWorkspace,
47
- type WorkspaceSlice,
48
- boundWorkspaceStatus,
49
- buildPersistedLocalHistoryContext,
50
- buildPersistedLocalHistoryContextFromExecution,
51
- buildPersistedLocalHistoryGraphContext,
52
- buildWorkspaceCausalContext,
53
- createBoundWorkspace,
54
- createWorkspaceSlice,
55
- nextBindingSliceDir,
56
- resolveCheckoutBoundaryHookEvent,
57
- unboundWorkspaceStatus,
58
- } from "./workspace-router-runtime.js";
59
- export {
60
- DEFAULT_DAEMON_CAPABILITY_PROFILE,
61
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
62
- WorkspaceBindingRequiredError,
63
- WorkspaceCapabilityDeniedError,
64
- type CausalAttachResult,
65
- type ResolvedWorkspace,
66
- type WorkspaceActionResult,
67
- type WorkspaceAuthorizationPolicy,
68
- type WorkspaceBindAction,
69
- type WorkspaceBindRequest,
70
- type WorkspaceCapabilityProfile,
71
- type WorkspaceExecutionContext,
72
- type WorkspaceMode,
73
- type WorkspaceSharedAttachPolicy,
74
- type WorkspaceStatus,
75
- } from "./workspace-router-model.js";
76
- export { resolveWorkspaceRequest } from "./workspace-router-resolution.js";
77
-
78
- interface WorkspaceRouterOptions {
79
- readonly mode: WorkspaceMode;
80
- readonly fs: FileSystem;
81
- readonly git: GitClient;
82
- readonly graftDir: string;
83
- readonly projectRoot?: string | undefined;
84
- readonly warpPool: WarpPool;
85
- readonly transportSessionId: string;
86
- readonly warpWriterId?: string | undefined;
87
- readonly authorizationPolicy?: WorkspaceAuthorizationPolicy | undefined;
88
- readonly sharedAttachPolicy?: WorkspaceSharedAttachPolicy | undefined;
89
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
90
- readonly persistedLocalHistoryGraph?: boolean;
91
- }
92
-
93
- export class WorkspaceRouter {
94
- private bindingCounter = 0;
95
- private sliceIdCounter = 0;
96
- private currentSlice: WorkspaceSlice;
97
- private currentBinding: BoundWorkspace | null = null;
98
- private initialization: Promise<void> | null = null;
99
-
100
- constructor(private readonly options: WorkspaceRouterOptions) {
101
- const initialProjectRoot = options.mode === "repo_local" ? options.projectRoot : undefined;
102
- this.currentSlice = createWorkspaceSlice({
103
- graftDir: options.mode === "repo_local" ? options.graftDir : path.join(options.graftDir, "unbound"),
104
- fs: options.fs,
105
- git: options.git,
106
- nextSliceId: `slice-${String(++this.sliceIdCounter).padStart(4, "0")}`,
107
- ...(initialProjectRoot !== undefined ? { projectRoot: initialProjectRoot } : {}),
108
- });
109
- }
110
-
111
- async initialize(): Promise<void> {
112
- if (this.options.mode !== "repo_local") {
113
- return;
114
- }
115
- if (this.currentBinding !== null) {
116
- return;
117
- }
118
- if (this.initialization !== null) {
119
- await this.initialization;
120
- return;
121
- }
122
-
123
- const projectRoot = this.options.projectRoot;
124
- if (projectRoot === undefined) {
125
- throw new Error("repo_local workspace router requires projectRoot");
126
- }
127
-
128
- this.initialization = (async () => {
129
- const resolved = await resolveWorkspaceRequest(this.options.git, { cwd: projectRoot });
130
- const initialWorkspace = "code" in resolved
131
- ? {
132
- repoId: stableWorkspaceId("repo", projectRoot),
133
- worktreeId: stableWorkspaceId("worktree", projectRoot),
134
- worktreeRoot: projectRoot,
135
- gitCommonDir: projectRoot,
136
- }
137
- : {
138
- repoId: resolved.repoId,
139
- worktreeId: stableWorkspaceId("worktree", projectRoot),
140
- worktreeRoot: projectRoot,
141
- gitCommonDir: resolved.gitCommonDir,
142
- };
143
- const currentBinding = await this.createBoundWorkspace(
144
- initialWorkspace,
145
- this.options.graftDir,
146
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
147
- undefined,
148
- this.currentSlice,
149
- );
150
- const currentRepoState = currentBinding.slice.repoState;
151
- if (currentRepoState === null) {
152
- throw new WorkspaceBindingRequiredError("workspace");
153
- }
154
- await currentRepoState.initialize();
155
- await this.options.persistedLocalHistory.noteBinding({
156
- current: this.buildPersistedLocalHistoryContext(currentBinding, currentRepoState.getState()),
157
- currentGraph: await this.buildPersistedLocalHistoryGraphContext(currentBinding),
158
- });
159
- this.currentBinding = currentBinding;
160
- })();
161
-
162
- await this.initialization;
163
- }
164
-
165
- get mode(): WorkspaceMode {
166
- return this.options.mode;
167
- }
168
-
169
- get governor(): GovernorTracker {
170
- return this.currentSlice.governor;
171
- }
172
-
173
- get cache(): ObservationCache {
174
- return this.currentSlice.cache;
175
- }
176
-
177
- get metrics(): Metrics {
178
- return this.currentSlice.metrics;
179
- }
180
-
181
- get graftDir(): string {
182
- return this.currentSlice.graftDir;
183
- }
184
-
185
- isBound(): boolean {
186
- return this.currentBinding !== null;
187
- }
188
-
189
- getProjectRoot(): string {
190
- return this.requireBinding().worktreeRoot;
191
- }
192
-
193
- getGraftignorePatterns(): readonly string[] {
194
- return this.requireBinding().graftignorePatterns;
195
- }
196
-
197
- getPathResolver(): (input: string) => string {
198
- return this.requireBinding().resolvePath;
199
- }
200
-
201
- getWarp(): Promise<WarpContext> {
202
- return this.requireBinding().getWarp();
203
- }
204
-
205
- async observeRepoState(): Promise<void> {
206
- const binding = this.requireBinding();
207
- const repoState = this.requireRepoState();
208
- const previousObservation = repoState.getState();
209
- const nextObservation = await repoState.observe();
210
- const checkoutBoundaryHookEvent = previousObservation.checkoutEpoch !== nextObservation.checkoutEpoch
211
- ? await this.resolveCheckoutBoundaryHookEvent(binding, previousObservation.observedAt, nextObservation)
212
- : null;
213
- const previousContext = this.buildPersistedLocalHistoryContext(binding, previousObservation);
214
- const nextContext = this.buildPersistedLocalHistoryContext(
215
- binding,
216
- nextObservation,
217
- checkoutBoundaryHookEvent,
218
- );
219
- if (previousContext.checkoutEpochId !== nextContext.checkoutEpochId) {
220
- await this.options.persistedLocalHistory.noteCheckoutBoundary({
221
- previous: previousContext,
222
- current: nextContext,
223
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
224
- });
225
- }
226
- }
227
-
228
- getRepoState() {
229
- return this.requireRepoState().getState();
230
- }
231
-
232
- getStatus(): WorkspaceStatus {
233
- if (this.currentBinding === null) {
234
- return unboundWorkspaceStatus(this.options.mode);
235
- }
236
- return boundWorkspaceStatus(this.options.mode, this.currentBinding);
237
- }
238
-
239
- async getPersistedLocalHistorySummary(): Promise<PersistedLocalHistorySummary> {
240
- const binding = this.currentBinding;
241
- if (binding?.slice.repoState === null || binding === null) {
242
- return {
243
- availability: "none",
244
- persistence: "persisted_local_history",
245
- historyPath: null,
246
- totalContinuityRecords: 0,
247
- active: false,
248
- lastOperation: null,
249
- lastObservedAt: null,
250
- continuityKey: null,
251
- causalSessionId: null,
252
- strandId: null,
253
- checkoutEpochId: null,
254
- continuedFromCausalSessionId: null,
255
- continuityConfidence: "unknown",
256
- continuityEvidence: [],
257
- attribution: {
258
- actor: {
259
- actorId: "unknown",
260
- actorKind: "unknown",
261
- displayName: "Unknown",
262
- source: "persisted_local_history.fallback",
263
- authorityScope: "inferred",
264
- },
265
- confidence: "unknown",
266
- basis: "unknown_fallback",
267
- evidence: [],
268
- },
269
- latestReadEvent: null,
270
- latestStageEvent: null,
271
- latestTransitionEvent: null,
272
- preserves: [
273
- "continuity_operations",
274
- "read_events",
275
- "stage_events",
276
- "transition_events",
277
- "runtime_context_ids",
278
- "workspace_overlay_snapshots",
279
- ],
280
- excludes: [
281
- "raw_chat_transcripts",
282
- "queue_bookkeeping",
283
- "canonical_provenance",
284
- "canonical_structural_truth",
285
- ],
286
- nextAction: "bind_workspace_to_begin_local_history",
287
- };
288
- }
289
- const status = this.getStatus();
290
- const repoState = binding.slice.repoState.getState();
291
- const causalContext = this.buildCausalContext(binding, repoState);
292
- const graph = await this.buildPersistedLocalHistoryGraphContext(binding);
293
- let summary = await this.options.persistedLocalHistory.summarize(status, causalContext, graph);
294
-
295
- if (repoState.semanticTransition !== null) {
296
- await this.options.persistedLocalHistory.noteSemanticTransitionObservation({
297
- current: this.buildPersistedLocalHistoryContext(binding, repoState),
298
- semanticTransition: repoState.semanticTransition,
299
- transition: repoState.lastTransition,
300
- attribution: summary.attribution,
301
- graph,
302
- });
303
- summary = await this.options.persistedLocalHistory.summarize(status, causalContext, graph);
304
- }
305
-
306
- const stagedTarget = buildRuntimeStagedTarget(status, causalContext, repoState, summary.attribution);
307
-
308
- if (stagedTarget.availability === "full_file") {
309
- await this.options.persistedLocalHistory.noteStageObservation({
310
- current: this.buildPersistedLocalHistoryContext(binding, repoState),
311
- stagedTarget,
312
- attribution: summary.attribution,
313
- graph,
314
- });
315
- return this.options.persistedLocalHistory.summarize(status, causalContext, graph);
316
- }
317
-
318
- return summary;
319
- }
320
-
321
- async getRepoConcurrencySummary(): Promise<RepoConcurrencySummary | null> {
322
- const binding = this.currentBinding;
323
- if (binding?.slice.repoState === null || binding === null) {
324
- return null;
325
- }
326
- return this.options.persistedLocalHistory.summarizeRepoConcurrency(
327
- this.getStatus(),
328
- await this.buildPersistedLocalHistoryGraphContext(binding),
329
- );
330
- }
331
-
332
- async getPersistedLocalActivityWindow(limit: number): Promise<PersistedLocalActivityWindow> {
333
- const binding = this.currentBinding;
334
- if (binding?.slice.repoState === null || binding === null) {
335
- return {
336
- historyPath: null,
337
- limit,
338
- totalMatchingItems: 0,
339
- truncated: false,
340
- items: [],
341
- };
342
- }
343
-
344
- await this.getPersistedLocalHistorySummary();
345
-
346
- const status = this.getStatus();
347
- const repoState = binding.slice.repoState.getState();
348
- const causalContext = this.buildCausalContext(binding, repoState);
349
- const graph = await this.buildPersistedLocalHistoryGraphContext(binding);
350
- return this.options.persistedLocalHistory.listRecentActivity(
351
- status,
352
- causalContext,
353
- limit,
354
- graph,
355
- );
356
- }
357
-
358
- getWorkspaceOverlayFooting(): Promise<RuntimeWorkspaceOverlayFooting | null> {
359
- const binding = this.currentBinding;
360
- if (binding?.slice.repoState === null || binding === null) {
361
- return Promise.resolve(null);
362
- }
363
- return buildRuntimeWorkspaceOverlayFooting(
364
- this.options.fs,
365
- this.options.git,
366
- binding.worktreeRoot,
367
- binding.gitCommonDir,
368
- binding.slice.repoState.getState(),
369
- );
370
- }
371
-
372
- async noteReadObservation(
373
- toolName: AttributedReadToolName,
374
- args: JsonObject,
375
- result: JsonObject,
376
- execution?: WorkspaceExecutionContext | null,
377
- ): Promise<void> {
378
- const active = execution ?? this.captureCurrentExecutionContext();
379
- if (active === null) {
380
- return;
381
- }
382
-
383
- const readObservation = buildWorkspaceReadObservation(active, toolName, args, result);
384
- if (readObservation === null) {
385
- return;
386
- }
387
-
388
- const summary = await this.options.persistedLocalHistory.summarize(
389
- active.status,
390
- active.getCausalContext(),
391
- await this.buildPersistedLocalHistoryGraphContextFromExecution(active),
392
- );
393
-
394
- await this.options.persistedLocalHistory.noteReadObservation({
395
- current: this.buildPersistedLocalHistoryContextFromExecution(active, active.repoState.getState()),
396
- attribution: summary.attribution,
397
- graph: await this.buildPersistedLocalHistoryGraphContextFromExecution(active),
398
- ...readObservation,
399
- });
400
- }
401
-
402
- captureExecutionContext(): WorkspaceExecutionContext {
403
- const binding = this.requireBinding();
404
- const repoState = binding.slice.repoState;
405
- if (repoState === null) {
406
- throw new WorkspaceBindingRequiredError("workspace");
407
- }
408
- return {
409
- sliceId: binding.slice.sliceId,
410
- repoId: binding.repoId,
411
- worktreeId: binding.worktreeId,
412
- projectRoot: binding.worktreeRoot,
413
- worktreeRoot: binding.worktreeRoot,
414
- gitCommonDir: binding.gitCommonDir,
415
- graftignorePatterns: binding.graftignorePatterns,
416
- resolvePath: binding.resolvePath,
417
- capabilityProfile: binding.capabilityProfile,
418
- warpWriterId: binding.warpWriterId,
419
- getCausalContext: () => this.buildCausalContext(binding, repoState.getState()),
420
- status: boundWorkspaceStatus(this.options.mode, binding),
421
- governor: binding.slice.governor,
422
- cache: binding.slice.cache,
423
- metrics: binding.slice.metrics,
424
- graftDir: binding.slice.graftDir,
425
- repoState,
426
- getWarp: binding.getWarp,
427
- };
428
- }
429
-
430
- async bind(request: WorkspaceBindRequest, actionName: string): Promise<WorkspaceActionResult> {
431
- return this.bindInternal("bind", request, actionName);
432
- }
433
-
434
- async rebind(request: WorkspaceBindRequest, actionName: string): Promise<WorkspaceActionResult> {
435
- if (this.currentBinding === null) {
436
- return {
437
- ok: false,
438
- action: "rebind",
439
- freshSessionSlice: false,
440
- ...this.getStatus(),
441
- errorCode: "UNBOUND_SESSION",
442
- error: "workspace_rebind requires an active workspace binding.",
443
- };
444
- }
445
- return this.bindInternal("rebind", request, actionName);
446
- }
447
-
448
- async declareAttach(
449
- declaration: PersistedLocalHistoryAttachDeclaration,
450
- ): Promise<CausalAttachResult> {
451
- const binding = this.currentBinding;
452
- if (binding?.slice.repoState === null || binding === null) {
453
- return {
454
- ok: false,
455
- action: "attach",
456
- ...this.getStatus(),
457
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
458
- errorCode: "UNBOUND_SESSION",
459
- error: "causal_attach requires an active workspace binding.",
460
- };
461
- }
462
-
463
- try {
464
- await this.options.persistedLocalHistory.declareAttach({
465
- current: this.buildPersistedLocalHistoryContext(binding, binding.slice.repoState.getState()),
466
- declaration,
467
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
468
- });
469
- } catch (error) {
470
- if (error instanceof PersistedLocalHistoryAttachUnavailableError) {
471
- const sharedAttachSource = this.options.sharedAttachPolicy?.resolveSharedAttachSource({
472
- sessionId: this.options.transportSessionId,
473
- repoId: binding.repoId,
474
- worktreeId: binding.worktreeId,
475
- }) ?? null;
476
- if (sharedAttachSource !== null) {
477
- await this.options.persistedLocalHistory.declareSharedAttach({
478
- current: this.buildPersistedLocalHistoryContext(binding, binding.slice.repoState.getState()),
479
- declaration,
480
- source: sharedAttachSource,
481
- graph: await this.buildPersistedLocalHistoryGraphContext(binding),
482
- });
483
- return {
484
- ok: true,
485
- action: "attach",
486
- ...this.getStatus(),
487
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
488
- };
489
- }
490
- return {
491
- ok: false,
492
- action: "attach",
493
- ...this.getStatus(),
494
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
495
- errorCode: error.code,
496
- error: error.message,
497
- };
498
- }
499
- throw error;
500
- }
501
-
502
- return {
503
- ok: true,
504
- action: "attach",
505
- ...this.getStatus(),
506
- persistedLocalHistory: await this.getPersistedLocalHistorySummary(),
507
- };
508
- }
509
-
510
- private async bindInternal(
511
- action: WorkspaceBindAction,
512
- request: WorkspaceBindRequest,
513
- actionName: string,
514
- ): Promise<WorkspaceActionResult> {
515
- const resolved = await resolveWorkspaceRequest(this.options.git, request);
516
- if ("code" in resolved) {
517
- return {
518
- ok: false,
519
- action,
520
- freshSessionSlice: false,
521
- ...this.getStatus(),
522
- errorCode: resolved.code,
523
- error: resolved.message,
524
- };
525
- }
526
-
527
- const sliceDir = nextBindingSliceDir(this.options.graftDir, ++this.bindingCounter);
528
- await this.options.fs.mkdir(sliceDir, { recursive: true });
529
-
530
- const capabilityProfile = this.options.mode === "repo_local"
531
- ? DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE
532
- : (await this.options.authorizationPolicy?.getCapabilityProfile(resolved)) ?? null;
533
- if (capabilityProfile === null) {
534
- return {
535
- ok: false,
536
- action,
537
- freshSessionSlice: false,
538
- ...this.getStatus(),
539
- errorCode: "WORKSPACE_NOT_AUTHORIZED",
540
- error: `Workspace ${resolved.worktreeRoot} is not authorized for daemon binding. Call workspace_authorize first.`,
541
- };
542
- }
543
-
544
- const nextBinding = await this.createBoundWorkspace(resolved, sliceDir, capabilityProfile, actionName);
545
- const nextRepoState = nextBinding.slice.repoState;
546
- if (nextRepoState === null) {
547
- throw new WorkspaceBindingRequiredError("workspace");
548
- }
549
- await nextRepoState.initialize();
550
- const previousBinding = this.currentBinding;
551
- const previousRepoState = previousBinding?.slice.repoState;
552
- await this.options.persistedLocalHistory.noteBinding({
553
- current: this.buildPersistedLocalHistoryContext(nextBinding, nextRepoState.getState()),
554
- previous: previousBinding === null || previousRepoState == null
555
- ? null
556
- : this.buildPersistedLocalHistoryContext(previousBinding, previousRepoState.getState()),
557
- currentGraph: await this.buildPersistedLocalHistoryGraphContext(nextBinding),
558
- previousGraph: previousBinding === null
559
- ? null
560
- : await this.buildPersistedLocalHistoryGraphContext(previousBinding),
561
- });
562
- if (this.options.mode === "daemon") {
563
- await this.options.authorizationPolicy?.noteBound(resolved);
564
- }
565
- this.currentBinding = nextBinding;
566
- this.currentSlice = nextBinding.slice;
567
-
568
- return {
569
- ok: true,
570
- action,
571
- freshSessionSlice: true,
572
- ...this.getStatus(),
573
- };
574
- }
575
-
576
- private async createBoundWorkspace(
577
- resolved: ResolvedWorkspace,
578
- graftDir: string,
579
- capabilityProfile: WorkspaceCapabilityProfile,
580
- actionName: string | undefined,
581
- sliceOverride?: WorkspaceSlice,
582
- ): Promise<BoundWorkspace> {
583
- const slice = sliceOverride ?? createWorkspaceSlice({
584
- graftDir,
585
- projectRoot: resolved.worktreeRoot,
586
- fs: this.options.fs,
587
- git: this.options.git,
588
- nextSliceId: `slice-${String(++this.sliceIdCounter).padStart(4, "0")}`,
589
- });
590
- return createBoundWorkspace({
591
- resolved,
592
- graftDir,
593
- capabilityProfile,
594
- ...(actionName !== undefined ? { actionName } : {}),
595
- slice,
596
- fs: this.options.fs,
597
- transportSessionId: this.options.transportSessionId,
598
- warpWriterId: this.options.warpWriterId ?? DEFAULT_WARP_WRITER_ID,
599
- warpPool: this.options.warpPool,
600
- });
601
- }
602
-
603
- private requireBinding(): BoundWorkspace {
604
- if (this.currentBinding === null) {
605
- throw new WorkspaceBindingRequiredError("workspace");
606
- }
607
- return this.currentBinding;
608
- }
609
-
610
- private requireRepoState(): RepoStateTracker {
611
- const repoState = this.currentBinding?.slice.repoState;
612
- if (repoState === null || repoState === undefined) {
613
- throw new WorkspaceBindingRequiredError("workspace");
614
- }
615
- return repoState;
616
- }
617
-
618
- private buildCausalContext(
619
- binding: BoundWorkspace,
620
- observation: { readonly checkoutEpoch: number },
621
- ): RuntimeCausalContext {
622
- return buildWorkspaceCausalContext(binding, observation);
623
- }
624
-
625
- private buildPersistedLocalHistoryContext(
626
- binding: BoundWorkspace,
627
- observation: RepoObservation,
628
- hookEvent: import("./runtime-workspace-overlay.js").GitTransitionHookEvent | null = null,
629
- ): PersistedLocalHistoryContext {
630
- return buildPersistedLocalHistoryContext({
631
- persistedLocalHistory: this.options.persistedLocalHistory,
632
- mode: this.options.mode,
633
- binding,
634
- observation,
635
- hookEvent,
636
- });
637
- }
638
-
639
- private buildPersistedLocalHistoryContextFromExecution(
640
- execution: WorkspaceExecutionContext,
641
- observation: RepoObservation,
642
- ): PersistedLocalHistoryContext {
643
- return buildPersistedLocalHistoryContextFromExecution({
644
- persistedLocalHistory: this.options.persistedLocalHistory,
645
- execution,
646
- observation,
647
- });
648
- }
649
-
650
- private async resolveCheckoutBoundaryHookEvent(
651
- binding: BoundWorkspace,
652
- previousObservedAt: string,
653
- observation: RepoObservation,
654
- ): Promise<import("./runtime-workspace-overlay.js").GitTransitionHookEvent | null> {
655
- return resolveCheckoutBoundaryHookEvent({
656
- fs: this.options.fs,
657
- git: this.options.git,
658
- binding,
659
- previousObservedAt,
660
- observation,
661
- });
662
- }
663
-
664
- private captureCurrentExecutionContext(): WorkspaceExecutionContext | null {
665
- if (this.currentBinding === null) {
666
- return null;
667
- }
668
- return this.captureExecutionContext();
669
- }
670
-
671
- private async buildPersistedLocalHistoryGraphContext(
672
- binding: BoundWorkspace,
673
- ): Promise<PersistedLocalHistoryGraphContext | null> {
674
- if (this.options.persistedLocalHistoryGraph === false) {
675
- return null;
676
- }
677
- return buildPersistedLocalHistoryGraphContext(binding.worktreeRoot, binding.getWarp);
678
- }
679
-
680
- private async buildPersistedLocalHistoryGraphContextFromExecution(
681
- execution: WorkspaceExecutionContext,
682
- ): Promise<PersistedLocalHistoryGraphContext | null> {
683
- if (this.options.persistedLocalHistoryGraph === false) {
684
- return null;
685
- }
686
- return buildPersistedLocalHistoryGraphContext(execution.worktreeRoot, execution.getWarp);
687
- }
688
- }