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