@flyingrobots/graft 0.5.0 → 0.6.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 (996) hide show
  1. package/{docs/ADVANCED_GUIDE.md → ADVANCED_GUIDE.md} +10 -7
  2. package/ARCHITECTURE.md +130 -377
  3. package/CHANGELOG.md +101 -13
  4. package/GUIDE.md +53 -0
  5. package/README.md +107 -269
  6. package/bin/graft.js +5 -3
  7. package/dist/adapters/canonical-json.d.ts +6 -0
  8. package/dist/adapters/canonical-json.d.ts.map +1 -0
  9. package/dist/adapters/canonical-json.js +52 -0
  10. package/dist/adapters/canonical-json.js.map +1 -0
  11. package/dist/adapters/node-fs.d.ts +3 -0
  12. package/dist/adapters/node-fs.d.ts.map +1 -0
  13. package/dist/adapters/node-fs.js +33 -0
  14. package/dist/adapters/node-fs.js.map +1 -0
  15. package/dist/adapters/node-git.d.ts +3 -0
  16. package/dist/adapters/node-git.d.ts.map +1 -0
  17. package/dist/adapters/node-git.js +44 -0
  18. package/dist/adapters/node-git.js.map +1 -0
  19. package/dist/adapters/node-process-runner.d.ts +3 -0
  20. package/dist/adapters/node-process-runner.d.ts.map +1 -0
  21. package/dist/adapters/node-process-runner.js +23 -0
  22. package/dist/adapters/node-process-runner.js.map +1 -0
  23. package/dist/adapters/repo-paths.d.ts +3 -0
  24. package/dist/adapters/repo-paths.d.ts.map +1 -0
  25. package/dist/adapters/repo-paths.js +22 -0
  26. package/dist/adapters/repo-paths.js.map +1 -0
  27. package/dist/adapters/rotating-ndjson-log.d.ts +18 -0
  28. package/dist/adapters/rotating-ndjson-log.d.ts.map +1 -0
  29. package/dist/adapters/rotating-ndjson-log.js +48 -0
  30. package/dist/adapters/rotating-ndjson-log.js.map +1 -0
  31. package/dist/api/index.d.ts +27 -0
  32. package/dist/api/index.d.ts.map +1 -0
  33. package/dist/api/index.js +25 -0
  34. package/dist/api/index.js.map +1 -0
  35. package/dist/api/repo-local-graft.d.ts +7 -0
  36. package/dist/api/repo-local-graft.d.ts.map +1 -0
  37. package/dist/api/repo-local-graft.js +12 -0
  38. package/dist/api/repo-local-graft.js.map +1 -0
  39. package/dist/api/repo-workspace.d.ts +15 -0
  40. package/dist/api/repo-workspace.d.ts.map +1 -0
  41. package/dist/api/repo-workspace.js +23 -0
  42. package/dist/api/repo-workspace.js.map +1 -0
  43. package/dist/api/tool-bridge.d.ts +7 -0
  44. package/dist/api/tool-bridge.d.ts.map +1 -0
  45. package/dist/api/tool-bridge.js +14 -0
  46. package/dist/api/tool-bridge.js.map +1 -0
  47. package/dist/cli/activity-render.d.ts +2 -0
  48. package/dist/cli/activity-render.d.ts.map +1 -0
  49. package/dist/cli/activity-render.js +90 -0
  50. package/dist/cli/activity-render.js.map +1 -0
  51. package/dist/cli/cli-error.d.ts +10 -0
  52. package/dist/cli/cli-error.d.ts.map +1 -0
  53. package/dist/cli/cli-error.js +130 -0
  54. package/dist/cli/cli-error.js.map +1 -0
  55. package/dist/cli/command-parser.d.ts +17 -0
  56. package/dist/cli/command-parser.d.ts.map +1 -0
  57. package/dist/cli/command-parser.js +255 -0
  58. package/dist/cli/command-parser.js.map +1 -0
  59. package/dist/cli/entrypoint.d.ts +7 -0
  60. package/dist/cli/entrypoint.d.ts.map +1 -0
  61. package/dist/cli/entrypoint.js +8 -0
  62. package/dist/cli/entrypoint.js.map +1 -0
  63. package/dist/cli/index-cmd.d.ts +12 -0
  64. package/dist/cli/index-cmd.d.ts.map +1 -0
  65. package/dist/cli/index-cmd.js +73 -0
  66. package/dist/cli/index-cmd.js.map +1 -0
  67. package/dist/cli/index-model.d.ts +33 -0
  68. package/dist/cli/index-model.d.ts.map +1 -0
  69. package/dist/cli/index-model.js +55 -0
  70. package/dist/cli/index-model.js.map +1 -0
  71. package/dist/cli/init-bootstrap.d.ts +6 -0
  72. package/dist/cli/init-bootstrap.d.ts.map +1 -0
  73. package/dist/cli/init-bootstrap.js +27 -0
  74. package/dist/cli/init-bootstrap.js.map +1 -0
  75. package/dist/cli/init-client-config.d.ts +13 -0
  76. package/dist/cli/init-client-config.d.ts.map +1 -0
  77. package/dist/cli/init-client-config.js +215 -0
  78. package/dist/cli/init-client-config.js.map +1 -0
  79. package/dist/cli/init-model.d.ts +80 -0
  80. package/dist/cli/init-model.d.ts.map +1 -0
  81. package/dist/cli/init-model.js +202 -0
  82. package/dist/cli/init-model.js.map +1 -0
  83. package/dist/cli/init-render.d.ts +8 -0
  84. package/dist/cli/init-render.d.ts.map +1 -0
  85. package/dist/cli/init-render.js +43 -0
  86. package/dist/cli/init-render.js.map +1 -0
  87. package/dist/cli/init-target-hooks.d.ts +3 -0
  88. package/dist/cli/init-target-hooks.d.ts.map +1 -0
  89. package/dist/cli/init-target-hooks.js +75 -0
  90. package/dist/cli/init-target-hooks.js.map +1 -0
  91. package/dist/cli/init.d.ts +12 -0
  92. package/dist/cli/init.d.ts.map +1 -0
  93. package/dist/cli/init.js +96 -0
  94. package/dist/cli/init.js.map +1 -0
  95. package/dist/cli/json-document.d.ts +35 -0
  96. package/dist/cli/json-document.d.ts.map +1 -0
  97. package/dist/cli/json-document.js +107 -0
  98. package/dist/cli/json-document.js.map +1 -0
  99. package/dist/cli/local-history-dag-model.d.ts +43 -0
  100. package/dist/cli/local-history-dag-model.d.ts.map +1 -0
  101. package/dist/cli/local-history-dag-model.js +344 -0
  102. package/dist/cli/local-history-dag-model.js.map +1 -0
  103. package/dist/cli/local-history-dag-render.d.ts +3 -0
  104. package/dist/cli/local-history-dag-render.d.ts.map +1 -0
  105. package/dist/cli/local-history-dag-render.js +126 -0
  106. package/dist/cli/local-history-dag-render.js.map +1 -0
  107. package/dist/cli/local-history-dag.d.ts +13 -0
  108. package/dist/cli/local-history-dag.d.ts.map +1 -0
  109. package/dist/cli/local-history-dag.js +60 -0
  110. package/dist/cli/local-history-dag.js.map +1 -0
  111. package/dist/cli/main.d.ts +15 -0
  112. package/dist/cli/main.d.ts.map +1 -0
  113. package/dist/cli/main.js +126 -0
  114. package/dist/cli/main.js.map +1 -0
  115. package/dist/cli/migrate-local-history.d.ts +12 -0
  116. package/dist/cli/migrate-local-history.d.ts.map +1 -0
  117. package/dist/cli/migrate-local-history.js +82 -0
  118. package/dist/cli/migrate-local-history.js.map +1 -0
  119. package/dist/cli/peer-command.d.ts +9 -0
  120. package/dist/cli/peer-command.d.ts.map +1 -0
  121. package/dist/cli/peer-command.js +38 -0
  122. package/dist/cli/peer-command.js.map +1 -0
  123. package/dist/contracts/capabilities.d.ts +44 -0
  124. package/dist/contracts/capabilities.d.ts.map +1 -0
  125. package/dist/contracts/capabilities.js +382 -0
  126. package/dist/contracts/capabilities.js.map +1 -0
  127. package/dist/contracts/causal-ontology.d.ts +1937 -0
  128. package/dist/contracts/causal-ontology.d.ts.map +1 -0
  129. package/dist/contracts/causal-ontology.js +506 -0
  130. package/dist/contracts/causal-ontology.js.map +1 -0
  131. package/dist/contracts/causal-surface-next-action.d.ts +17 -0
  132. package/dist/contracts/causal-surface-next-action.d.ts.map +1 -0
  133. package/dist/contracts/causal-surface-next-action.js +16 -0
  134. package/dist/contracts/causal-surface-next-action.js.map +1 -0
  135. package/dist/contracts/json-object.d.ts +7 -0
  136. package/dist/contracts/json-object.d.ts.map +1 -0
  137. package/dist/contracts/json-object.js +24 -0
  138. package/dist/contracts/json-object.js.map +1 -0
  139. package/dist/contracts/mcp-runtime.d.ts +4 -0
  140. package/dist/contracts/mcp-runtime.d.ts.map +1 -0
  141. package/dist/contracts/mcp-runtime.js +11 -0
  142. package/dist/contracts/mcp-runtime.js.map +1 -0
  143. package/dist/contracts/output-schema-cli.d.ts +2716 -0
  144. package/dist/contracts/output-schema-cli.d.ts.map +1 -0
  145. package/dist/contracts/output-schema-cli.js +68 -0
  146. package/dist/contracts/output-schema-cli.js.map +1 -0
  147. package/dist/contracts/output-schema-fragments.d.ts +10819 -0
  148. package/dist/contracts/output-schema-fragments.d.ts.map +1 -0
  149. package/dist/contracts/output-schema-fragments.js +753 -0
  150. package/dist/contracts/output-schema-fragments.js.map +1 -0
  151. package/dist/contracts/output-schema-mcp.d.ts +5926 -0
  152. package/dist/contracts/output-schema-mcp.d.ts.map +1 -0
  153. package/dist/contracts/output-schema-mcp.js +231 -0
  154. package/dist/contracts/output-schema-mcp.js.map +1 -0
  155. package/dist/contracts/output-schema-meta.d.ts +30 -0
  156. package/dist/contracts/output-schema-meta.d.ts.map +1 -0
  157. package/dist/contracts/output-schema-meta.js +51 -0
  158. package/dist/contracts/output-schema-meta.js.map +1 -0
  159. package/dist/contracts/output-schemas.d.ts +1072 -0
  160. package/dist/contracts/output-schemas.d.ts.map +1 -0
  161. package/dist/contracts/output-schemas.js +1089 -0
  162. package/dist/contracts/output-schemas.js.map +1 -0
  163. package/dist/git/diff.d.ts +32 -0
  164. package/dist/git/diff.d.ts.map +1 -0
  165. package/dist/git/diff.js +82 -0
  166. package/dist/git/diff.js.map +1 -0
  167. package/dist/git/target-git-hook-bootstrap.d.ts +7 -0
  168. package/dist/git/target-git-hook-bootstrap.d.ts.map +1 -0
  169. package/dist/git/target-git-hook-bootstrap.js +40 -0
  170. package/dist/git/target-git-hook-bootstrap.js.map +1 -0
  171. package/dist/guards/stream-boundary.d.ts +41 -0
  172. package/dist/guards/stream-boundary.d.ts.map +1 -0
  173. package/dist/guards/stream-boundary.js +97 -0
  174. package/dist/guards/stream-boundary.js.map +1 -0
  175. package/dist/hooks/posttooluse-read.d.ts +4 -0
  176. package/dist/hooks/posttooluse-read.d.ts.map +1 -0
  177. package/dist/hooks/posttooluse-read.js +41 -0
  178. package/dist/hooks/posttooluse-read.js.map +1 -0
  179. package/dist/hooks/pretooluse-read.d.ts +4 -0
  180. package/dist/hooks/pretooluse-read.d.ts.map +1 -0
  181. package/dist/hooks/pretooluse-read.js +41 -0
  182. package/dist/hooks/pretooluse-read.js.map +1 -0
  183. package/dist/hooks/read-governor.d.ts +24 -0
  184. package/dist/hooks/read-governor.d.ts.map +1 -0
  185. package/dist/hooks/read-governor.js +76 -0
  186. package/dist/hooks/read-governor.js.map +1 -0
  187. package/dist/hooks/read-messages.d.ts +6 -0
  188. package/dist/hooks/read-messages.d.ts.map +1 -0
  189. package/dist/hooks/read-messages.js +45 -0
  190. package/dist/hooks/read-messages.js.map +1 -0
  191. package/dist/hooks/shared.d.ts +52 -0
  192. package/dist/hooks/shared.d.ts.map +1 -0
  193. package/dist/hooks/shared.js +137 -0
  194. package/dist/hooks/shared.js.map +1 -0
  195. package/dist/index.d.ts +2 -0
  196. package/dist/index.d.ts.map +1 -0
  197. package/dist/index.js +2 -0
  198. package/dist/index.js.map +1 -0
  199. package/dist/mcp/burden.d.ts +21 -0
  200. package/dist/mcp/burden.d.ts.map +1 -0
  201. package/dist/mcp/burden.js +96 -0
  202. package/dist/mcp/burden.js.map +1 -0
  203. package/dist/mcp/cache.d.ts +2 -0
  204. package/dist/mcp/cache.d.ts.map +1 -0
  205. package/dist/mcp/cache.js +2 -0
  206. package/dist/mcp/cache.js.map +1 -0
  207. package/dist/mcp/cached-file.d.ts +2 -0
  208. package/dist/mcp/cached-file.d.ts.map +1 -0
  209. package/dist/mcp/cached-file.js +2 -0
  210. package/dist/mcp/cached-file.js.map +1 -0
  211. package/dist/mcp/context.d.ts +84 -0
  212. package/dist/mcp/context.d.ts.map +1 -0
  213. package/dist/mcp/context.js +79 -0
  214. package/dist/mcp/context.js.map +1 -0
  215. package/dist/mcp/control-plane/authz-storage.d.ts +35 -0
  216. package/dist/mcp/control-plane/authz-storage.d.ts.map +1 -0
  217. package/dist/mcp/control-plane/authz-storage.js +85 -0
  218. package/dist/mcp/control-plane/authz-storage.js.map +1 -0
  219. package/dist/mcp/control-plane/session-registry.d.ts +12 -0
  220. package/dist/mcp/control-plane/session-registry.d.ts.map +1 -0
  221. package/dist/mcp/control-plane/session-registry.js +88 -0
  222. package/dist/mcp/control-plane/session-registry.js.map +1 -0
  223. package/dist/mcp/control-plane/status-projection.d.ts +8 -0
  224. package/dist/mcp/control-plane/status-projection.d.ts.map +1 -0
  225. package/dist/mcp/control-plane/status-projection.js +49 -0
  226. package/dist/mcp/control-plane/status-projection.js.map +1 -0
  227. package/dist/mcp/control-plane/types.d.ts +107 -0
  228. package/dist/mcp/control-plane/types.d.ts.map +1 -0
  229. package/dist/mcp/control-plane/types.js +2 -0
  230. package/dist/mcp/control-plane/types.js.map +1 -0
  231. package/dist/mcp/daemon-bootstrap.d.ts +9 -0
  232. package/dist/mcp/daemon-bootstrap.d.ts.map +1 -0
  233. package/dist/mcp/daemon-bootstrap.js +96 -0
  234. package/dist/mcp/daemon-bootstrap.js.map +1 -0
  235. package/dist/mcp/daemon-control-plane.d.ts +37 -0
  236. package/dist/mcp/daemon-control-plane.d.ts.map +1 -0
  237. package/dist/mcp/daemon-control-plane.js +200 -0
  238. package/dist/mcp/daemon-control-plane.js.map +1 -0
  239. package/dist/mcp/daemon-job-scheduler.d.ts +60 -0
  240. package/dist/mcp/daemon-job-scheduler.d.ts.map +1 -0
  241. package/dist/mcp/daemon-job-scheduler.js +203 -0
  242. package/dist/mcp/daemon-job-scheduler.js.map +1 -0
  243. package/dist/mcp/daemon-repos.d.ts +9 -0
  244. package/dist/mcp/daemon-repos.d.ts.map +1 -0
  245. package/dist/mcp/daemon-repos.js +73 -0
  246. package/dist/mcp/daemon-repos.js.map +1 -0
  247. package/dist/mcp/daemon-server.d.ts +23 -0
  248. package/dist/mcp/daemon-server.d.ts.map +1 -0
  249. package/dist/mcp/daemon-server.js +128 -0
  250. package/dist/mcp/daemon-server.js.map +1 -0
  251. package/dist/mcp/daemon-session-host.d.ts +31 -0
  252. package/dist/mcp/daemon-session-host.d.ts.map +1 -0
  253. package/dist/mcp/daemon-session-host.js +173 -0
  254. package/dist/mcp/daemon-session-host.js.map +1 -0
  255. package/dist/mcp/daemon-stdio-bridge.d.ts +17 -0
  256. package/dist/mcp/daemon-stdio-bridge.d.ts.map +1 -0
  257. package/dist/mcp/daemon-stdio-bridge.js +207 -0
  258. package/dist/mcp/daemon-stdio-bridge.js.map +1 -0
  259. package/dist/mcp/daemon-worker-child-pool.d.ts +22 -0
  260. package/dist/mcp/daemon-worker-child-pool.d.ts.map +1 -0
  261. package/dist/mcp/daemon-worker-child-pool.js +193 -0
  262. package/dist/mcp/daemon-worker-child-pool.js.map +1 -0
  263. package/dist/mcp/daemon-worker-inline-pool.d.ts +12 -0
  264. package/dist/mcp/daemon-worker-inline-pool.d.ts.map +1 -0
  265. package/dist/mcp/daemon-worker-inline-pool.js +43 -0
  266. package/dist/mcp/daemon-worker-inline-pool.js.map +1 -0
  267. package/dist/mcp/daemon-worker-pool.d.ts +4 -0
  268. package/dist/mcp/daemon-worker-pool.d.ts.map +1 -0
  269. package/dist/mcp/daemon-worker-pool.js +3 -0
  270. package/dist/mcp/daemon-worker-pool.js.map +1 -0
  271. package/dist/mcp/daemon-worker-process.d.ts +2 -0
  272. package/dist/mcp/daemon-worker-process.d.ts.map +1 -0
  273. package/dist/mcp/daemon-worker-process.js +26 -0
  274. package/dist/mcp/daemon-worker-process.js.map +1 -0
  275. package/dist/mcp/daemon-worker-types.d.ts +56 -0
  276. package/dist/mcp/daemon-worker-types.d.ts.map +1 -0
  277. package/dist/mcp/daemon-worker-types.js +2 -0
  278. package/dist/mcp/daemon-worker-types.js.map +1 -0
  279. package/dist/mcp/metrics.d.ts +57 -0
  280. package/dist/mcp/metrics.d.ts.map +1 -0
  281. package/dist/mcp/metrics.js +133 -0
  282. package/dist/mcp/metrics.js.map +1 -0
  283. package/dist/mcp/monitor-health.d.ts +29 -0
  284. package/dist/mcp/monitor-health.d.ts.map +1 -0
  285. package/dist/mcp/monitor-health.js +70 -0
  286. package/dist/mcp/monitor-health.js.map +1 -0
  287. package/dist/mcp/monitor-persistence.d.ts +17 -0
  288. package/dist/mcp/monitor-persistence.d.ts.map +1 -0
  289. package/dist/mcp/monitor-persistence.js +38 -0
  290. package/dist/mcp/monitor-persistence.js.map +1 -0
  291. package/dist/mcp/monitor-tick-job.d.ts +22 -0
  292. package/dist/mcp/monitor-tick-job.d.ts.map +1 -0
  293. package/dist/mcp/monitor-tick-job.js +65 -0
  294. package/dist/mcp/monitor-tick-job.js.map +1 -0
  295. package/dist/mcp/monitor-types.d.ts +123 -0
  296. package/dist/mcp/monitor-types.d.ts.map +1 -0
  297. package/dist/mcp/monitor-types.js +29 -0
  298. package/dist/mcp/monitor-types.js.map +1 -0
  299. package/dist/mcp/persisted-local-history-graph.d.ts +40 -0
  300. package/dist/mcp/persisted-local-history-graph.d.ts.map +1 -0
  301. package/dist/mcp/persisted-local-history-graph.js +388 -0
  302. package/dist/mcp/persisted-local-history-graph.js.map +1 -0
  303. package/dist/mcp/persisted-local-history-policy.d.ts +43 -0
  304. package/dist/mcp/persisted-local-history-policy.d.ts.map +1 -0
  305. package/dist/mcp/persisted-local-history-policy.js +372 -0
  306. package/dist/mcp/persisted-local-history-policy.js.map +1 -0
  307. package/dist/mcp/persisted-local-history-views.d.ts +24 -0
  308. package/dist/mcp/persisted-local-history-views.d.ts.map +1 -0
  309. package/dist/mcp/persisted-local-history-views.js +201 -0
  310. package/dist/mcp/persisted-local-history-views.js.map +1 -0
  311. package/dist/mcp/persisted-local-history.d.ts +795 -0
  312. package/dist/mcp/persisted-local-history.d.ts.map +1 -0
  313. package/dist/mcp/persisted-local-history.js +1076 -0
  314. package/dist/mcp/persisted-local-history.js.map +1 -0
  315. package/dist/mcp/persistent-monitor-runtime.d.ts +33 -0
  316. package/dist/mcp/persistent-monitor-runtime.d.ts.map +1 -0
  317. package/dist/mcp/persistent-monitor-runtime.js +356 -0
  318. package/dist/mcp/persistent-monitor-runtime.js.map +1 -0
  319. package/dist/mcp/policy.d.ts +29 -0
  320. package/dist/mcp/policy.d.ts.map +1 -0
  321. package/dist/mcp/policy.js +40 -0
  322. package/dist/mcp/policy.js.map +1 -0
  323. package/dist/mcp/receipt.d.ts +64 -0
  324. package/dist/mcp/receipt.d.ts.map +1 -0
  325. package/dist/mcp/receipt.js +99 -0
  326. package/dist/mcp/receipt.js.map +1 -0
  327. package/dist/mcp/repo-concurrency.d.ts +62 -0
  328. package/dist/mcp/repo-concurrency.d.ts.map +1 -0
  329. package/dist/mcp/repo-concurrency.js +195 -0
  330. package/dist/mcp/repo-concurrency.js.map +1 -0
  331. package/dist/mcp/repo-overview/filter.d.ts +6 -0
  332. package/dist/mcp/repo-overview/filter.d.ts.map +1 -0
  333. package/dist/mcp/repo-overview/filter.js +32 -0
  334. package/dist/mcp/repo-overview/filter.js.map +1 -0
  335. package/dist/mcp/repo-overview/types.d.ts +41 -0
  336. package/dist/mcp/repo-overview/types.d.ts.map +1 -0
  337. package/dist/mcp/repo-overview/types.js +2 -0
  338. package/dist/mcp/repo-overview/types.js.map +1 -0
  339. package/dist/mcp/repo-overview/view-projection.d.ts +8 -0
  340. package/dist/mcp/repo-overview/view-projection.d.ts.map +1 -0
  341. package/dist/mcp/repo-overview/view-projection.js +73 -0
  342. package/dist/mcp/repo-overview/view-projection.js.map +1 -0
  343. package/dist/mcp/repo-state-git.d.ts +8 -0
  344. package/dist/mcp/repo-state-git.d.ts.map +1 -0
  345. package/dist/mcp/repo-state-git.js +203 -0
  346. package/dist/mcp/repo-state-git.js.map +1 -0
  347. package/dist/mcp/repo-state-observation.d.ts +4 -0
  348. package/dist/mcp/repo-state-observation.d.ts.map +1 -0
  349. package/dist/mcp/repo-state-observation.js +171 -0
  350. package/dist/mcp/repo-state-observation.js.map +1 -0
  351. package/dist/mcp/repo-state-transition.d.ts +4 -0
  352. package/dist/mcp/repo-state-transition.d.ts.map +1 -0
  353. package/dist/mcp/repo-state-transition.js +124 -0
  354. package/dist/mcp/repo-state-transition.js.map +1 -0
  355. package/dist/mcp/repo-state-types.d.ts +88 -0
  356. package/dist/mcp/repo-state-types.d.ts.map +1 -0
  357. package/dist/mcp/repo-state-types.js +2 -0
  358. package/dist/mcp/repo-state-types.js.map +1 -0
  359. package/dist/mcp/repo-state.d.ts +37 -0
  360. package/dist/mcp/repo-state.d.ts.map +1 -0
  361. package/dist/mcp/repo-state.js +101 -0
  362. package/dist/mcp/repo-state.js.map +1 -0
  363. package/dist/mcp/repo-tool-job.d.ts +55 -0
  364. package/dist/mcp/repo-tool-job.d.ts.map +1 -0
  365. package/dist/mcp/repo-tool-job.js +50 -0
  366. package/dist/mcp/repo-tool-job.js.map +1 -0
  367. package/dist/mcp/repo-tool-worker-context.d.ts +8 -0
  368. package/dist/mcp/repo-tool-worker-context.d.ts.map +1 -0
  369. package/dist/mcp/repo-tool-worker-context.js +199 -0
  370. package/dist/mcp/repo-tool-worker-context.js.map +1 -0
  371. package/dist/mcp/repo-workspace.d.ts +4 -0
  372. package/dist/mcp/repo-workspace.d.ts.map +1 -0
  373. package/dist/mcp/repo-workspace.js +15 -0
  374. package/dist/mcp/repo-workspace.js.map +1 -0
  375. package/dist/mcp/run-capture-config.d.ts +11 -0
  376. package/dist/mcp/run-capture-config.d.ts.map +1 -0
  377. package/dist/mcp/run-capture-config.js +23 -0
  378. package/dist/mcp/run-capture-config.js.map +1 -0
  379. package/dist/mcp/runtime-causal-context.d.ts +22 -0
  380. package/dist/mcp/runtime-causal-context.d.ts.map +1 -0
  381. package/dist/mcp/runtime-causal-context.js +28 -0
  382. package/dist/mcp/runtime-causal-context.js.map +1 -0
  383. package/dist/mcp/runtime-observability.d.ts +102 -0
  384. package/dist/mcp/runtime-observability.d.ts.map +1 -0
  385. package/dist/mcp/runtime-observability.js +95 -0
  386. package/dist/mcp/runtime-observability.js.map +1 -0
  387. package/dist/mcp/runtime-staged-target.d.ts +28 -0
  388. package/dist/mcp/runtime-staged-target.d.ts.map +1 -0
  389. package/dist/mcp/runtime-staged-target.js +101 -0
  390. package/dist/mcp/runtime-staged-target.js.map +1 -0
  391. package/dist/mcp/runtime-workspace-overlay.d.ts +45 -0
  392. package/dist/mcp/runtime-workspace-overlay.d.ts.map +1 -0
  393. package/dist/mcp/runtime-workspace-overlay.js +153 -0
  394. package/dist/mcp/runtime-workspace-overlay.js.map +1 -0
  395. package/dist/mcp/secret-scrub.d.ts +17 -0
  396. package/dist/mcp/secret-scrub.d.ts.map +1 -0
  397. package/dist/mcp/secret-scrub.js +82 -0
  398. package/dist/mcp/secret-scrub.js.map +1 -0
  399. package/dist/mcp/semantic-transition-guidance.d.ts +6 -0
  400. package/dist/mcp/semantic-transition-guidance.d.ts.map +1 -0
  401. package/dist/mcp/semantic-transition-guidance.js +47 -0
  402. package/dist/mcp/semantic-transition-guidance.js.map +1 -0
  403. package/dist/mcp/semantic-transition-summary.d.ts +23 -0
  404. package/dist/mcp/semantic-transition-summary.d.ts.map +1 -0
  405. package/dist/mcp/semantic-transition-summary.js +82 -0
  406. package/dist/mcp/semantic-transition-summary.js.map +1 -0
  407. package/dist/mcp/server-context.d.ts +46 -0
  408. package/dist/mcp/server-context.d.ts.map +1 -0
  409. package/dist/mcp/server-context.js +163 -0
  410. package/dist/mcp/server-context.js.map +1 -0
  411. package/dist/mcp/server-invocation.d.ts +73 -0
  412. package/dist/mcp/server-invocation.d.ts.map +1 -0
  413. package/dist/mcp/server-invocation.js +265 -0
  414. package/dist/mcp/server-invocation.js.map +1 -0
  415. package/dist/mcp/server-tool-access.d.ts +18 -0
  416. package/dist/mcp/server-tool-access.d.ts.map +1 -0
  417. package/dist/mcp/server-tool-access.js +123 -0
  418. package/dist/mcp/server-tool-access.js.map +1 -0
  419. package/dist/mcp/server.d.ts +41 -0
  420. package/dist/mcp/server.d.ts.map +1 -0
  421. package/dist/mcp/server.js +215 -0
  422. package/dist/mcp/server.js.map +1 -0
  423. package/dist/mcp/stdio-server.d.ts +6 -0
  424. package/dist/mcp/stdio-server.d.ts.map +1 -0
  425. package/dist/mcp/stdio-server.js +20 -0
  426. package/dist/mcp/stdio-server.js.map +1 -0
  427. package/dist/mcp/stdio.d.ts +2 -0
  428. package/dist/mcp/stdio.d.ts.map +1 -0
  429. package/dist/mcp/stdio.js +3 -0
  430. package/dist/mcp/stdio.js.map +1 -0
  431. package/dist/mcp/tool-registry.d.ts +5 -0
  432. package/dist/mcp/tool-registry.d.ts.map +1 -0
  433. package/dist/mcp/tool-registry.js +76 -0
  434. package/dist/mcp/tool-registry.js.map +1 -0
  435. package/dist/mcp/tools/activity-view.d.ts +3 -0
  436. package/dist/mcp/tools/activity-view.d.ts.map +1 -0
  437. package/dist/mcp/tools/activity-view.js +259 -0
  438. package/dist/mcp/tools/activity-view.js.map +1 -0
  439. package/dist/mcp/tools/budget.d.ts +3 -0
  440. package/dist/mcp/tools/budget.d.ts.map +1 -0
  441. package/dist/mcp/tools/budget.js +20 -0
  442. package/dist/mcp/tools/budget.js.map +1 -0
  443. package/dist/mcp/tools/causal-attach.d.ts +3 -0
  444. package/dist/mcp/tools/causal-attach.d.ts.map +1 -0
  445. package/dist/mcp/tools/causal-attach.js +53 -0
  446. package/dist/mcp/tools/causal-attach.js.map +1 -0
  447. package/dist/mcp/tools/causal-status.d.ts +3 -0
  448. package/dist/mcp/tools/causal-status.d.ts.map +1 -0
  449. package/dist/mcp/tools/causal-status.js +46 -0
  450. package/dist/mcp/tools/causal-status.js.map +1 -0
  451. package/dist/mcp/tools/changed-since.d.ts +3 -0
  452. package/dist/mcp/tools/changed-since.d.ts.map +1 -0
  453. package/dist/mcp/tools/changed-since.js +57 -0
  454. package/dist/mcp/tools/changed-since.js.map +1 -0
  455. package/dist/mcp/tools/code-find.d.ts +104 -0
  456. package/dist/mcp/tools/code-find.d.ts.map +1 -0
  457. package/dist/mcp/tools/code-find.js +125 -0
  458. package/dist/mcp/tools/code-find.js.map +1 -0
  459. package/dist/mcp/tools/code-refs.d.ts +3 -0
  460. package/dist/mcp/tools/code-refs.d.ts.map +1 -0
  461. package/dist/mcp/tools/code-refs.js +370 -0
  462. package/dist/mcp/tools/code-refs.js.map +1 -0
  463. package/dist/mcp/tools/code-show.d.ts +104 -0
  464. package/dist/mcp/tools/code-show.d.ts.map +1 -0
  465. package/dist/mcp/tools/code-show.js +202 -0
  466. package/dist/mcp/tools/code-show.js.map +1 -0
  467. package/dist/mcp/tools/daemon-monitors.d.ts +3 -0
  468. package/dist/mcp/tools/daemon-monitors.d.ts.map +1 -0
  469. package/dist/mcp/tools/daemon-monitors.js +12 -0
  470. package/dist/mcp/tools/daemon-monitors.js.map +1 -0
  471. package/dist/mcp/tools/daemon-repos.d.ts +3 -0
  472. package/dist/mcp/tools/daemon-repos.d.ts.map +1 -0
  473. package/dist/mcp/tools/daemon-repos.js +20 -0
  474. package/dist/mcp/tools/daemon-repos.js.map +1 -0
  475. package/dist/mcp/tools/daemon-sessions.d.ts +3 -0
  476. package/dist/mcp/tools/daemon-sessions.d.ts.map +1 -0
  477. package/dist/mcp/tools/daemon-sessions.js +12 -0
  478. package/dist/mcp/tools/daemon-sessions.js.map +1 -0
  479. package/dist/mcp/tools/daemon-status.d.ts +3 -0
  480. package/dist/mcp/tools/daemon-status.d.ts.map +1 -0
  481. package/dist/mcp/tools/daemon-status.js +10 -0
  482. package/dist/mcp/tools/daemon-status.js.map +1 -0
  483. package/dist/mcp/tools/diagnostic-models.d.ts +85 -0
  484. package/dist/mcp/tools/diagnostic-models.d.ts.map +1 -0
  485. package/dist/mcp/tools/diagnostic-models.js +5 -0
  486. package/dist/mcp/tools/diagnostic-models.js.map +1 -0
  487. package/dist/mcp/tools/doctor.d.ts +3 -0
  488. package/dist/mcp/tools/doctor.d.ts.map +1 -0
  489. package/dist/mcp/tools/doctor.js +54 -0
  490. package/dist/mcp/tools/doctor.js.map +1 -0
  491. package/dist/mcp/tools/explain.d.ts +3 -0
  492. package/dist/mcp/tools/explain.d.ts.map +1 -0
  493. package/dist/mcp/tools/explain.js +81 -0
  494. package/dist/mcp/tools/explain.js.map +1 -0
  495. package/dist/mcp/tools/file-outline.d.ts +3 -0
  496. package/dist/mcp/tools/file-outline.d.ts.map +1 -0
  497. package/dist/mcp/tools/file-outline.js +54 -0
  498. package/dist/mcp/tools/file-outline.js.map +1 -0
  499. package/dist/mcp/tools/git-files.d.ts +24 -0
  500. package/dist/mcp/tools/git-files.d.ts.map +1 -0
  501. package/dist/mcp/tools/git-files.js +57 -0
  502. package/dist/mcp/tools/git-files.js.map +1 -0
  503. package/dist/mcp/tools/graft-diff.d.ts +3 -0
  504. package/dist/mcp/tools/graft-diff.d.ts.map +1 -0
  505. package/dist/mcp/tools/graft-diff.js +33 -0
  506. package/dist/mcp/tools/graft-diff.js.map +1 -0
  507. package/dist/mcp/tools/map-collector.d.ts +85 -0
  508. package/dist/mcp/tools/map-collector.d.ts.map +1 -0
  509. package/dist/mcp/tools/map-collector.js +249 -0
  510. package/dist/mcp/tools/map-collector.js.map +1 -0
  511. package/dist/mcp/tools/map.d.ts +7 -0
  512. package/dist/mcp/tools/map.d.ts.map +1 -0
  513. package/dist/mcp/tools/map.js +154 -0
  514. package/dist/mcp/tools/map.js.map +1 -0
  515. package/dist/mcp/tools/monitor-pause.d.ts +3 -0
  516. package/dist/mcp/tools/monitor-pause.d.ts.map +1 -0
  517. package/dist/mcp/tools/monitor-pause.js +16 -0
  518. package/dist/mcp/tools/monitor-pause.js.map +1 -0
  519. package/dist/mcp/tools/monitor-resume.d.ts +3 -0
  520. package/dist/mcp/tools/monitor-resume.d.ts.map +1 -0
  521. package/dist/mcp/tools/monitor-resume.js +16 -0
  522. package/dist/mcp/tools/monitor-resume.js.map +1 -0
  523. package/dist/mcp/tools/monitor-start.d.ts +3 -0
  524. package/dist/mcp/tools/monitor-start.d.ts.map +1 -0
  525. package/dist/mcp/tools/monitor-start.js +18 -0
  526. package/dist/mcp/tools/monitor-start.js.map +1 -0
  527. package/dist/mcp/tools/monitor-stop.d.ts +3 -0
  528. package/dist/mcp/tools/monitor-stop.d.ts.map +1 -0
  529. package/dist/mcp/tools/monitor-stop.js +16 -0
  530. package/dist/mcp/tools/monitor-stop.js.map +1 -0
  531. package/dist/mcp/tools/precision-live.d.ts +20 -0
  532. package/dist/mcp/tools/precision-live.d.ts.map +1 -0
  533. package/dist/mcp/tools/precision-live.js +105 -0
  534. package/dist/mcp/tools/precision-live.js.map +1 -0
  535. package/dist/mcp/tools/precision-match.d.ts +21 -0
  536. package/dist/mcp/tools/precision-match.d.ts.map +1 -0
  537. package/dist/mcp/tools/precision-match.js +46 -0
  538. package/dist/mcp/tools/precision-match.js.map +1 -0
  539. package/dist/mcp/tools/precision-paths.d.ts +7 -0
  540. package/dist/mcp/tools/precision-paths.d.ts.map +1 -0
  541. package/dist/mcp/tools/precision-paths.js +53 -0
  542. package/dist/mcp/tools/precision-paths.js.map +1 -0
  543. package/dist/mcp/tools/precision-query.d.ts +38 -0
  544. package/dist/mcp/tools/precision-query.d.ts.map +1 -0
  545. package/dist/mcp/tools/precision-query.js +116 -0
  546. package/dist/mcp/tools/precision-query.js.map +1 -0
  547. package/dist/mcp/tools/precision-show.d.ts +15 -0
  548. package/dist/mcp/tools/precision-show.d.ts.map +1 -0
  549. package/dist/mcp/tools/precision-show.js +46 -0
  550. package/dist/mcp/tools/precision-show.js.map +1 -0
  551. package/dist/mcp/tools/precision-visibility.d.ts +10 -0
  552. package/dist/mcp/tools/precision-visibility.d.ts.map +1 -0
  553. package/dist/mcp/tools/precision-visibility.js +24 -0
  554. package/dist/mcp/tools/precision-visibility.js.map +1 -0
  555. package/dist/mcp/tools/precision-warp.d.ts +6 -0
  556. package/dist/mcp/tools/precision-warp.d.ts.map +1 -0
  557. package/dist/mcp/tools/precision-warp.js +76 -0
  558. package/dist/mcp/tools/precision-warp.js.map +1 -0
  559. package/dist/mcp/tools/precision.d.ts +7 -0
  560. package/dist/mcp/tools/precision.d.ts.map +1 -0
  561. package/dist/mcp/tools/precision.js +6 -0
  562. package/dist/mcp/tools/precision.js.map +1 -0
  563. package/dist/mcp/tools/read-range.d.ts +3 -0
  564. package/dist/mcp/tools/read-range.d.ts.map +1 -0
  565. package/dist/mcp/tools/read-range.js +26 -0
  566. package/dist/mcp/tools/read-range.js.map +1 -0
  567. package/dist/mcp/tools/run-capture.d.ts +3 -0
  568. package/dist/mcp/tools/run-capture.d.ts.map +1 -0
  569. package/dist/mcp/tools/run-capture.js +125 -0
  570. package/dist/mcp/tools/run-capture.js.map +1 -0
  571. package/dist/mcp/tools/safe-read.d.ts +3 -0
  572. package/dist/mcp/tools/safe-read.d.ts.map +1 -0
  573. package/dist/mcp/tools/safe-read.js +133 -0
  574. package/dist/mcp/tools/safe-read.js.map +1 -0
  575. package/dist/mcp/tools/since.d.ts +3 -0
  576. package/dist/mcp/tools/since.d.ts.map +1 -0
  577. package/dist/mcp/tools/since.js +46 -0
  578. package/dist/mcp/tools/since.js.map +1 -0
  579. package/dist/mcp/tools/state.d.ts +4 -0
  580. package/dist/mcp/tools/state.d.ts.map +1 -0
  581. package/dist/mcp/tools/state.js +35 -0
  582. package/dist/mcp/tools/state.js.map +1 -0
  583. package/dist/mcp/tools/stats.d.ts +3 -0
  584. package/dist/mcp/tools/stats.d.ts.map +1 -0
  585. package/dist/mcp/tools/stats.js +22 -0
  586. package/dist/mcp/tools/stats.js.map +1 -0
  587. package/dist/mcp/tools/workspace-authorizations.d.ts +3 -0
  588. package/dist/mcp/tools/workspace-authorizations.d.ts.map +1 -0
  589. package/dist/mcp/tools/workspace-authorizations.js +12 -0
  590. package/dist/mcp/tools/workspace-authorizations.js.map +1 -0
  591. package/dist/mcp/tools/workspace-authorize.d.ts +3 -0
  592. package/dist/mcp/tools/workspace-authorize.d.ts.map +1 -0
  593. package/dist/mcp/tools/workspace-authorize.js +18 -0
  594. package/dist/mcp/tools/workspace-authorize.js.map +1 -0
  595. package/dist/mcp/tools/workspace-bind.d.ts +3 -0
  596. package/dist/mcp/tools/workspace-bind.d.ts.map +1 -0
  597. package/dist/mcp/tools/workspace-bind.js +23 -0
  598. package/dist/mcp/tools/workspace-bind.js.map +1 -0
  599. package/dist/mcp/tools/workspace-rebind.d.ts +3 -0
  600. package/dist/mcp/tools/workspace-rebind.d.ts.map +1 -0
  601. package/dist/mcp/tools/workspace-rebind.js +23 -0
  602. package/dist/mcp/tools/workspace-rebind.js.map +1 -0
  603. package/dist/mcp/tools/workspace-revoke.d.ts +3 -0
  604. package/dist/mcp/tools/workspace-revoke.d.ts.map +1 -0
  605. package/dist/mcp/tools/workspace-revoke.js +16 -0
  606. package/dist/mcp/tools/workspace-revoke.js.map +1 -0
  607. package/dist/mcp/tools/workspace-status.d.ts +3 -0
  608. package/dist/mcp/tools/workspace-status.d.ts.map +1 -0
  609. package/dist/mcp/tools/workspace-status.js +10 -0
  610. package/dist/mcp/tools/workspace-status.js.map +1 -0
  611. package/dist/mcp/warp-pool.d.ts +13 -0
  612. package/dist/mcp/warp-pool.d.ts.map +1 -0
  613. package/dist/mcp/warp-pool.js +30 -0
  614. package/dist/mcp/warp-pool.js.map +1 -0
  615. package/dist/mcp/workspace-read-observation-model.d.ts +34 -0
  616. package/dist/mcp/workspace-read-observation-model.d.ts.map +1 -0
  617. package/dist/mcp/workspace-read-observation-model.js +35 -0
  618. package/dist/mcp/workspace-read-observation-model.js.map +1 -0
  619. package/dist/mcp/workspace-read-observation.d.ts +19 -0
  620. package/dist/mcp/workspace-read-observation.d.ts.map +1 -0
  621. package/dist/mcp/workspace-read-observation.js +71 -0
  622. package/dist/mcp/workspace-read-observation.js.map +1 -0
  623. package/dist/mcp/workspace-router-capability.d.ts +14 -0
  624. package/dist/mcp/workspace-router-capability.d.ts.map +1 -0
  625. package/dist/mcp/workspace-router-capability.js +22 -0
  626. package/dist/mcp/workspace-router-capability.js.map +1 -0
  627. package/dist/mcp/workspace-router-history.d.ts +65 -0
  628. package/dist/mcp/workspace-router-history.d.ts.map +1 -0
  629. package/dist/mcp/workspace-router-history.js +142 -0
  630. package/dist/mcp/workspace-router-history.js.map +1 -0
  631. package/dist/mcp/workspace-router-model.d.ts +96 -0
  632. package/dist/mcp/workspace-router-model.d.ts.map +1 -0
  633. package/dist/mcp/workspace-router-model.js +31 -0
  634. package/dist/mcp/workspace-router-model.js.map +1 -0
  635. package/dist/mcp/workspace-router-resolution.d.ts +10 -0
  636. package/dist/mcp/workspace-router-resolution.d.ts.map +1 -0
  637. package/dist/mcp/workspace-router-resolution.js +56 -0
  638. package/dist/mcp/workspace-router-resolution.js.map +1 -0
  639. package/dist/mcp/workspace-router-runtime.d.ts +79 -0
  640. package/dist/mcp/workspace-router-runtime.d.ts.map +1 -0
  641. package/dist/mcp/workspace-router-runtime.js +126 -0
  642. package/dist/mcp/workspace-router-runtime.js.map +1 -0
  643. package/dist/mcp/workspace-router.d.ts +72 -0
  644. package/dist/mcp/workspace-router.d.ts.map +1 -0
  645. package/dist/mcp/workspace-router.js +494 -0
  646. package/dist/mcp/workspace-router.js.map +1 -0
  647. package/dist/metrics/logger.d.ts +14 -0
  648. package/dist/metrics/logger.d.ts.map +1 -0
  649. package/dist/metrics/logger.js +30 -0
  650. package/dist/metrics/logger.js.map +1 -0
  651. package/dist/metrics/types.d.ts +25 -0
  652. package/dist/metrics/types.d.ts.map +1 -0
  653. package/dist/metrics/types.js +28 -0
  654. package/dist/metrics/types.js.map +1 -0
  655. package/dist/operations/cached-file.d.ts +24 -0
  656. package/dist/operations/cached-file.d.ts.map +1 -0
  657. package/dist/operations/cached-file.js +37 -0
  658. package/dist/operations/cached-file.js.map +1 -0
  659. package/dist/operations/diff-identity.d.ts +32 -0
  660. package/dist/operations/diff-identity.d.ts.map +1 -0
  661. package/dist/operations/diff-identity.js +93 -0
  662. package/dist/operations/diff-identity.js.map +1 -0
  663. package/dist/operations/file-outline.d.ts +15 -0
  664. package/dist/operations/file-outline.d.ts.map +1 -0
  665. package/dist/operations/file-outline.js +32 -0
  666. package/dist/operations/file-outline.js.map +1 -0
  667. package/dist/operations/graft-diff.d.ts +43 -0
  668. package/dist/operations/graft-diff.d.ts.map +1 -0
  669. package/dist/operations/graft-diff.js +115 -0
  670. package/dist/operations/graft-diff.js.map +1 -0
  671. package/dist/operations/observation-cache.d.ts +64 -0
  672. package/dist/operations/observation-cache.d.ts.map +1 -0
  673. package/dist/operations/observation-cache.js +104 -0
  674. package/dist/operations/observation-cache.js.map +1 -0
  675. package/dist/operations/read-range.d.ts +14 -0
  676. package/dist/operations/read-range.d.ts.map +1 -0
  677. package/dist/operations/read-range.js +41 -0
  678. package/dist/operations/read-range.js.map +1 -0
  679. package/dist/operations/repo-workspace.d.ts +114 -0
  680. package/dist/operations/repo-workspace.d.ts.map +1 -0
  681. package/dist/operations/repo-workspace.js +228 -0
  682. package/dist/operations/repo-workspace.js.map +1 -0
  683. package/dist/operations/result-dto.d.ts +10 -0
  684. package/dist/operations/result-dto.d.ts.map +1 -0
  685. package/dist/operations/result-dto.js +21 -0
  686. package/dist/operations/result-dto.js.map +1 -0
  687. package/dist/operations/safe-read.d.ts +35 -0
  688. package/dist/operations/safe-read.d.ts.map +1 -0
  689. package/dist/operations/safe-read.js +75 -0
  690. package/dist/operations/safe-read.js.map +1 -0
  691. package/dist/operations/state.d.ts +25 -0
  692. package/dist/operations/state.d.ts.map +1 -0
  693. package/dist/operations/state.js +47 -0
  694. package/dist/operations/state.js.map +1 -0
  695. package/dist/operations/structured-buffer-compare.d.ts +5 -0
  696. package/dist/operations/structured-buffer-compare.d.ts.map +1 -0
  697. package/dist/operations/structured-buffer-compare.js +392 -0
  698. package/dist/operations/structured-buffer-compare.js.map +1 -0
  699. package/dist/operations/structured-buffer-model.d.ts +232 -0
  700. package/dist/operations/structured-buffer-model.d.ts.map +1 -0
  701. package/dist/operations/structured-buffer-model.js +175 -0
  702. package/dist/operations/structured-buffer-model.js.map +1 -0
  703. package/dist/operations/structured-buffer-query.d.ts +24 -0
  704. package/dist/operations/structured-buffer-query.d.ts.map +1 -0
  705. package/dist/operations/structured-buffer-query.js +690 -0
  706. package/dist/operations/structured-buffer-query.js.map +1 -0
  707. package/dist/operations/structured-buffer.d.ts +43 -0
  708. package/dist/operations/structured-buffer.d.ts.map +1 -0
  709. package/dist/operations/structured-buffer.js +96 -0
  710. package/dist/operations/structured-buffer.js.map +1 -0
  711. package/dist/parser/diff.d.ts +63 -0
  712. package/dist/parser/diff.d.ts.map +1 -0
  713. package/dist/parser/diff.js +259 -0
  714. package/dist/parser/diff.js.map +1 -0
  715. package/dist/parser/lang.d.ts +17 -0
  716. package/dist/parser/lang.d.ts.map +1 -0
  717. package/dist/parser/lang.js +51 -0
  718. package/dist/parser/lang.js.map +1 -0
  719. package/dist/parser/markdown.d.ts +3 -0
  720. package/dist/parser/markdown.d.ts.map +1 -0
  721. package/dist/parser/markdown.js +168 -0
  722. package/dist/parser/markdown.js.map +1 -0
  723. package/dist/parser/outline.d.ts +12 -0
  724. package/dist/parser/outline.d.ts.map +1 -0
  725. package/dist/parser/outline.js +251 -0
  726. package/dist/parser/outline.js.map +1 -0
  727. package/dist/parser/runtime.d.ts +13 -0
  728. package/dist/parser/runtime.d.ts.map +1 -0
  729. package/dist/parser/runtime.js +43 -0
  730. package/dist/parser/runtime.js.map +1 -0
  731. package/dist/parser/types.d.ts +41 -0
  732. package/dist/parser/types.d.ts.map +1 -0
  733. package/dist/parser/types.js +46 -0
  734. package/dist/parser/types.js.map +1 -0
  735. package/dist/policy/evaluate.d.ts +8 -0
  736. package/dist/policy/evaluate.d.ts.map +1 -0
  737. package/dist/policy/evaluate.js +153 -0
  738. package/dist/policy/evaluate.js.map +1 -0
  739. package/dist/policy/graftignore.d.ts +2 -0
  740. package/dist/policy/graftignore.d.ts.map +1 -0
  741. package/dist/policy/graftignore.js +7 -0
  742. package/dist/policy/graftignore.js.map +1 -0
  743. package/dist/policy/types.d.ts +104 -0
  744. package/dist/policy/types.d.ts.map +1 -0
  745. package/dist/policy/types.js +49 -0
  746. package/dist/policy/types.js.map +1 -0
  747. package/dist/ports/codec.d.ts +10 -0
  748. package/dist/ports/codec.d.ts.map +1 -0
  749. package/dist/ports/codec.js +5 -0
  750. package/dist/ports/codec.js.map +1 -0
  751. package/dist/ports/filesystem.d.ts +19 -0
  752. package/dist/ports/filesystem.d.ts.map +1 -0
  753. package/dist/ports/filesystem.js +5 -0
  754. package/dist/ports/filesystem.js.map +1 -0
  755. package/dist/ports/git.d.ts +11 -0
  756. package/dist/ports/git.d.ts.map +1 -0
  757. package/dist/ports/git.js +5 -0
  758. package/dist/ports/git.js.map +1 -0
  759. package/dist/ports/guards.d.ts +15 -0
  760. package/dist/ports/guards.d.ts.map +1 -0
  761. package/dist/ports/guards.js +43 -0
  762. package/dist/ports/guards.js.map +1 -0
  763. package/dist/ports/process-runner.d.ts +17 -0
  764. package/dist/ports/process-runner.d.ts.map +1 -0
  765. package/dist/ports/process-runner.js +5 -0
  766. package/dist/ports/process-runner.js.map +1 -0
  767. package/dist/ports/warp.d.ts +45 -0
  768. package/dist/ports/warp.d.ts.map +1 -0
  769. package/dist/ports/warp.js +5 -0
  770. package/dist/ports/warp.js.map +1 -0
  771. package/dist/release/security-gate.d.ts +24 -0
  772. package/dist/release/security-gate.d.ts.map +1 -0
  773. package/dist/release/security-gate.js +69 -0
  774. package/dist/release/security-gate.js.map +1 -0
  775. package/dist/session/tracker.d.ts +36 -0
  776. package/dist/session/tracker.d.ts.map +1 -0
  777. package/dist/session/tracker.js +113 -0
  778. package/dist/session/tracker.js.map +1 -0
  779. package/dist/session/types.d.ts +14 -0
  780. package/dist/session/types.d.ts.map +1 -0
  781. package/dist/session/types.js +18 -0
  782. package/dist/session/types.js.map +1 -0
  783. package/dist/version.d.ts +2 -0
  784. package/dist/version.d.ts.map +1 -0
  785. package/dist/version.js +3 -0
  786. package/dist/version.js.map +1 -0
  787. package/dist/warp/identity-resolver.d.ts +14 -0
  788. package/dist/warp/identity-resolver.d.ts.map +1 -0
  789. package/dist/warp/identity-resolver.js +31 -0
  790. package/dist/warp/identity-resolver.js.map +1 -0
  791. package/dist/warp/indexer-git.d.ts +22 -0
  792. package/dist/warp/indexer-git.d.ts.map +1 -0
  793. package/dist/warp/indexer-git.js +148 -0
  794. package/dist/warp/indexer-git.js.map +1 -0
  795. package/dist/warp/indexer-graph.d.ts +17 -0
  796. package/dist/warp/indexer-graph.d.ts.map +1 -0
  797. package/dist/warp/indexer-graph.js +179 -0
  798. package/dist/warp/indexer-graph.js.map +1 -0
  799. package/dist/warp/indexer-model.d.ts +51 -0
  800. package/dist/warp/indexer-model.d.ts.map +1 -0
  801. package/dist/warp/indexer-model.js +21 -0
  802. package/dist/warp/indexer-model.js.map +1 -0
  803. package/dist/warp/indexer.d.ts +9 -0
  804. package/dist/warp/indexer.d.ts.map +1 -0
  805. package/dist/warp/indexer.js +112 -0
  806. package/dist/warp/indexer.js.map +1 -0
  807. package/dist/warp/observers.d.ts +54 -0
  808. package/dist/warp/observers.d.ts.map +1 -0
  809. package/dist/warp/observers.js +88 -0
  810. package/dist/warp/observers.js.map +1 -0
  811. package/dist/warp/open.d.ts +15 -0
  812. package/dist/warp/open.d.ts.map +1 -0
  813. package/dist/warp/open.js +67 -0
  814. package/dist/warp/open.js.map +1 -0
  815. package/dist/warp/symbol-identity.d.ts +11 -0
  816. package/dist/warp/symbol-identity.d.ts.map +1 -0
  817. package/dist/warp/symbol-identity.js +67 -0
  818. package/dist/warp/symbol-identity.js.map +1 -0
  819. package/dist/warp/writer-id.d.ts +5 -0
  820. package/dist/warp/writer-id.d.ts.map +1 -0
  821. package/dist/warp/writer-id.js +25 -0
  822. package/dist/warp/writer-id.js.map +1 -0
  823. package/docs/CLI.md +37 -15
  824. package/docs/MCP.md +44 -25
  825. package/docs/{GUIDE.md → SETUP.md} +21 -0
  826. package/package.json +24 -7
  827. package/src/adapters/repo-paths.ts +22 -0
  828. package/src/adapters/rotating-ndjson-log.ts +66 -0
  829. package/src/api/index.ts +107 -0
  830. package/src/api/repo-local-graft.ts +21 -0
  831. package/src/api/repo-workspace.ts +34 -0
  832. package/src/api/tool-bridge.ts +21 -0
  833. package/src/cli/activity-render.ts +112 -0
  834. package/src/cli/cli-error.ts +153 -0
  835. package/src/cli/command-parser.ts +302 -0
  836. package/src/cli/entrypoint.ts +18 -0
  837. package/src/cli/index-cmd.ts +31 -23
  838. package/src/cli/index-model.ts +76 -0
  839. package/src/cli/init-bootstrap.ts +47 -0
  840. package/src/cli/init-client-config.ts +299 -0
  841. package/src/cli/init-model.ts +229 -0
  842. package/src/cli/init-render.ts +54 -0
  843. package/src/cli/init-target-hooks.ts +93 -0
  844. package/src/cli/init.ts +16 -757
  845. package/src/cli/json-document.ts +144 -0
  846. package/src/cli/local-history-dag-model.ts +437 -0
  847. package/src/cli/local-history-dag-render.ts +133 -0
  848. package/src/cli/local-history-dag.ts +103 -0
  849. package/src/cli/main.ts +46 -333
  850. package/src/cli/migrate-local-history.ts +118 -0
  851. package/src/cli/peer-command.ts +59 -0
  852. package/src/contracts/capabilities.ts +218 -109
  853. package/src/contracts/causal-ontology.ts +5 -0
  854. package/src/contracts/json-object.ts +28 -0
  855. package/src/contracts/mcp-runtime.ts +16 -0
  856. package/src/contracts/output-schema-cli.ts +70 -0
  857. package/src/contracts/output-schema-fragments.ts +831 -0
  858. package/src/contracts/output-schema-mcp.ts +282 -0
  859. package/src/contracts/output-schema-meta.ts +119 -0
  860. package/src/contracts/output-schemas.ts +62 -1
  861. package/src/index.ts +1 -0
  862. package/src/mcp/cache.ts +7 -145
  863. package/src/mcp/cached-file.ts +1 -40
  864. package/src/mcp/context.ts +83 -13
  865. package/src/mcp/control-plane/authz-storage.ts +129 -0
  866. package/src/mcp/control-plane/session-registry.ts +115 -0
  867. package/src/mcp/control-plane/status-projection.ts +76 -0
  868. package/src/mcp/control-plane/types.ts +144 -0
  869. package/src/mcp/daemon-bootstrap.ts +100 -0
  870. package/src/mcp/daemon-control-plane.ts +93 -337
  871. package/src/mcp/daemon-repos.ts +27 -144
  872. package/src/mcp/daemon-server.ts +31 -262
  873. package/src/mcp/daemon-session-host.ts +230 -0
  874. package/src/mcp/daemon-stdio-bridge.ts +260 -0
  875. package/src/mcp/daemon-worker-child-pool.ts +213 -0
  876. package/src/mcp/daemon-worker-inline-pool.ts +46 -0
  877. package/src/mcp/daemon-worker-pool.ts +7 -310
  878. package/src/mcp/daemon-worker-types.ts +66 -0
  879. package/src/mcp/metrics.ts +68 -52
  880. package/src/mcp/monitor-health.ts +83 -0
  881. package/src/mcp/monitor-persistence.ts +54 -0
  882. package/src/mcp/monitor-tick-job.ts +3 -0
  883. package/src/mcp/monitor-types.ts +103 -0
  884. package/src/mcp/persisted-local-history-graph.ts +591 -0
  885. package/src/mcp/persisted-local-history-policy.ts +501 -0
  886. package/src/mcp/persisted-local-history-views.ts +250 -0
  887. package/src/mcp/persisted-local-history.ts +1137 -762
  888. package/src/mcp/persistent-monitor-runtime.ts +71 -175
  889. package/src/mcp/policy.ts +11 -20
  890. package/src/mcp/receipt.ts +67 -19
  891. package/src/mcp/repo-concurrency.ts +81 -7
  892. package/src/mcp/repo-overview/filter.ts +44 -0
  893. package/src/mcp/repo-overview/types.ts +63 -0
  894. package/src/mcp/repo-overview/view-projection.ts +90 -0
  895. package/src/mcp/repo-state-git.ts +247 -0
  896. package/src/mcp/repo-state-observation.ts +203 -0
  897. package/src/mcp/repo-state-transition.ts +151 -0
  898. package/src/mcp/repo-state-types.ts +107 -0
  899. package/src/mcp/repo-state.ts +90 -721
  900. package/src/mcp/repo-tool-job.ts +16 -216
  901. package/src/mcp/repo-tool-worker-context.ts +212 -0
  902. package/src/mcp/repo-workspace.ts +21 -0
  903. package/src/mcp/runtime-observability.ts +41 -43
  904. package/src/mcp/secret-scrub.ts +89 -0
  905. package/src/mcp/server-context.ts +223 -0
  906. package/src/mcp/server-invocation.ts +388 -0
  907. package/src/mcp/server-tool-access.ts +145 -0
  908. package/src/mcp/server.ts +46 -606
  909. package/src/mcp/stdio-server.ts +16 -2
  910. package/src/mcp/tool-registry.ts +80 -0
  911. package/src/mcp/tools/activity-view.ts +3 -3
  912. package/src/mcp/tools/budget.ts +10 -7
  913. package/src/mcp/tools/causal-attach.ts +3 -3
  914. package/src/mcp/tools/causal-status.ts +3 -3
  915. package/src/mcp/tools/changed-since.ts +4 -3
  916. package/src/mcp/tools/code-find.ts +7 -2
  917. package/src/mcp/tools/code-refs.ts +7 -3
  918. package/src/mcp/tools/code-show.ts +12 -2
  919. package/src/mcp/tools/daemon-monitors.ts +3 -3
  920. package/src/mcp/tools/daemon-repos.ts +3 -3
  921. package/src/mcp/tools/daemon-sessions.ts +3 -3
  922. package/src/mcp/tools/daemon-status.ts +3 -3
  923. package/src/mcp/tools/diagnostic-models.ts +95 -0
  924. package/src/mcp/tools/doctor.ts +10 -7
  925. package/src/mcp/tools/explain.ts +3 -3
  926. package/src/mcp/tools/file-outline.ts +10 -4
  927. package/src/mcp/tools/graft-diff.ts +6 -3
  928. package/src/mcp/tools/map-collector.ts +338 -0
  929. package/src/mcp/tools/map.ts +52 -3
  930. package/src/mcp/tools/monitor-pause.ts +3 -3
  931. package/src/mcp/tools/monitor-resume.ts +3 -3
  932. package/src/mcp/tools/monitor-start.ts +3 -3
  933. package/src/mcp/tools/monitor-stop.ts +3 -3
  934. package/src/mcp/tools/precision-live.ts +158 -0
  935. package/src/mcp/tools/precision-match.ts +3 -0
  936. package/src/mcp/tools/precision-paths.ts +59 -0
  937. package/src/mcp/tools/precision-show.ts +86 -0
  938. package/src/mcp/tools/precision-visibility.ts +44 -0
  939. package/src/mcp/tools/precision-warp.ts +90 -0
  940. package/src/mcp/tools/precision.ts +19 -310
  941. package/src/mcp/tools/read-range.ts +12 -5
  942. package/src/mcp/tools/run-capture.ts +2 -2
  943. package/src/mcp/tools/safe-read.ts +21 -10
  944. package/src/mcp/tools/since.ts +7 -3
  945. package/src/mcp/tools/state.ts +8 -7
  946. package/src/mcp/tools/stats.ts +3 -3
  947. package/src/mcp/tools/workspace-authorizations.ts +3 -3
  948. package/src/mcp/tools/workspace-authorize.ts +3 -3
  949. package/src/mcp/tools/workspace-bind.ts +3 -3
  950. package/src/mcp/tools/workspace-rebind.ts +3 -3
  951. package/src/mcp/tools/workspace-revoke.ts +3 -3
  952. package/src/mcp/tools/workspace-status.ts +3 -3
  953. package/src/mcp/warp-pool.ts +6 -6
  954. package/src/mcp/workspace-read-observation-model.ts +48 -0
  955. package/src/mcp/workspace-read-observation.ts +103 -0
  956. package/src/mcp/workspace-router-capability.ts +32 -0
  957. package/src/mcp/workspace-router-history.ts +233 -0
  958. package/src/mcp/workspace-router-model.ts +131 -0
  959. package/src/mcp/workspace-router-resolution.ts +71 -0
  960. package/src/mcp/workspace-router-runtime.ts +243 -0
  961. package/src/mcp/workspace-router.ts +151 -454
  962. package/src/metrics/logger.ts +22 -51
  963. package/src/metrics/types.ts +32 -4
  964. package/src/operations/cached-file.ts +40 -0
  965. package/src/operations/diff-identity.ts +127 -0
  966. package/src/operations/file-outline.ts +1 -1
  967. package/src/operations/graft-diff.ts +0 -1
  968. package/src/operations/observation-cache.ts +149 -0
  969. package/src/operations/read-range.ts +0 -1
  970. package/src/operations/repo-workspace.ts +339 -0
  971. package/src/operations/result-dto.ts +23 -0
  972. package/src/operations/safe-read.ts +3 -4
  973. package/src/operations/state.ts +42 -6
  974. package/src/operations/structured-buffer-compare.ts +429 -0
  975. package/src/operations/structured-buffer-model.ts +456 -0
  976. package/src/operations/structured-buffer-query.ts +794 -0
  977. package/src/operations/structured-buffer.ts +181 -0
  978. package/src/parser/diff.ts +172 -1
  979. package/src/parser/lang.ts +58 -15
  980. package/src/parser/markdown.ts +197 -0
  981. package/src/parser/outline.ts +8 -208
  982. package/src/parser/runtime.ts +71 -0
  983. package/src/policy/evaluate.ts +2 -2
  984. package/src/policy/types.ts +9 -9
  985. package/src/ports/guards.ts +68 -0
  986. package/src/ports/warp.ts +55 -0
  987. package/src/session/tracker.ts +7 -7
  988. package/src/session/types.ts +4 -1
  989. package/src/warp/identity-resolver.ts +35 -0
  990. package/src/warp/indexer-git.ts +182 -0
  991. package/src/warp/indexer-graph.ts +276 -0
  992. package/src/warp/indexer-model.ts +69 -0
  993. package/src/warp/indexer.ts +122 -449
  994. package/src/warp/observers.ts +7 -12
  995. package/src/warp/open.ts +66 -4
  996. package/src/warp/symbol-identity.ts +100 -0
@@ -0,0 +1,144 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import {
4
+ cloneJsonValue,
5
+ isJsonObjectValue,
6
+ type JsonArrayValue,
7
+ type JsonObjectValue,
8
+ type JsonValue,
9
+ } from "./init-model.js";
10
+
11
+ function formatJsonField(pointer: readonly string[]): string {
12
+ return pointer.length === 0 ? "document root" : pointer.join(".");
13
+ }
14
+
15
+ export class JsonArrayNode {
16
+ constructor(
17
+ private readonly value: JsonArrayValue,
18
+ private readonly label: string,
19
+ private readonly pointer: readonly string[] = [],
20
+ ) {}
21
+
22
+ static fromUnknown(
23
+ value: unknown,
24
+ label: string,
25
+ pointer: readonly string[] = [],
26
+ ): JsonArrayNode {
27
+ if (!Array.isArray(value)) {
28
+ throw new Error(`${label}: expected ${formatJsonField(pointer)} to be an array`);
29
+ }
30
+ return new JsonArrayNode(value as JsonArrayValue, label, pointer);
31
+ }
32
+
33
+ objectItems(): JsonObjectNode[] {
34
+ return this.value.map((item, index) =>
35
+ JsonObjectNode.fromUnknown(item, this.label, [...this.pointer, `[${String(index)}]`]),
36
+ );
37
+ }
38
+
39
+ push(value: JsonValue): void {
40
+ this.value.push(cloneJsonValue(value));
41
+ }
42
+ }
43
+
44
+ export class JsonObjectNode {
45
+ constructor(
46
+ private readonly value: JsonObjectValue,
47
+ private readonly label: string,
48
+ private readonly pointer: readonly string[] = [],
49
+ ) {}
50
+
51
+ static fromUnknown(
52
+ value: unknown,
53
+ label: string,
54
+ pointer: readonly string[] = [],
55
+ ): JsonObjectNode {
56
+ if (!isJsonObjectValue(value)) {
57
+ throw new Error(`${label}: expected ${formatJsonField(pointer)} to be an object`);
58
+ }
59
+ return new JsonObjectNode(value, label, pointer);
60
+ }
61
+
62
+ has(key: string): boolean {
63
+ return this.value[key] !== undefined;
64
+ }
65
+
66
+ set(key: string, value: JsonValue): void {
67
+ this.value[key] = cloneJsonValue(value);
68
+ }
69
+
70
+ ensureObject(key: string): JsonObjectNode {
71
+ const current = this.value[key];
72
+ if (current === undefined) {
73
+ const created: JsonObjectValue = {};
74
+ this.value[key] = created;
75
+ return new JsonObjectNode(created, this.label, [...this.pointer, key]);
76
+ }
77
+ return JsonObjectNode.fromUnknown(current, this.label, [...this.pointer, key]);
78
+ }
79
+
80
+ ensureArray(key: string): JsonArrayNode {
81
+ const current = this.value[key];
82
+ if (current === undefined) {
83
+ const created: JsonArrayValue = [];
84
+ this.value[key] = created;
85
+ return new JsonArrayNode(created, this.label, [...this.pointer, key]);
86
+ }
87
+ return JsonArrayNode.fromUnknown(current, this.label, [...this.pointer, key]);
88
+ }
89
+
90
+ requireArray(key: string): JsonArrayNode {
91
+ const current = this.value[key];
92
+ if (current === undefined) {
93
+ throw new Error(`${this.label}: expected ${formatJsonField([...this.pointer, key])} to exist`);
94
+ }
95
+ return JsonArrayNode.fromUnknown(current, this.label, [...this.pointer, key]);
96
+ }
97
+
98
+ stringValue(key: string): string | undefined {
99
+ const current = this.value[key];
100
+ return typeof current === "string" ? current : undefined;
101
+ }
102
+
103
+ toJsonValue(): JsonObjectValue {
104
+ return this.value;
105
+ }
106
+ }
107
+
108
+ export class JsonObjectDocument {
109
+ constructor(
110
+ readonly label: string,
111
+ readonly filePath: string,
112
+ private readonly rootNode: JsonObjectNode,
113
+ ) {}
114
+
115
+ static create(
116
+ filePath: string,
117
+ label: string,
118
+ root: JsonObjectValue,
119
+ ): JsonObjectDocument {
120
+ return new JsonObjectDocument(
121
+ label,
122
+ filePath,
123
+ new JsonObjectNode(cloneJsonValue(root), label),
124
+ );
125
+ }
126
+
127
+ static open(filePath: string, label: string): JsonObjectDocument {
128
+ const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8")) as unknown;
129
+ return new JsonObjectDocument(
130
+ label,
131
+ filePath,
132
+ JsonObjectNode.fromUnknown(parsed, label),
133
+ );
134
+ }
135
+
136
+ root(): JsonObjectNode {
137
+ return this.rootNode;
138
+ }
139
+
140
+ write(): void {
141
+ fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
142
+ fs.writeFileSync(this.filePath, JSON.stringify(this.rootNode.toJsonValue(), null, 2));
143
+ }
144
+ }
@@ -0,0 +1,437 @@
1
+ import { z } from "zod";
2
+ import { nodeGit } from "../adapters/node-git.js";
3
+ import { resolveWorkspaceRequest } from "../mcp/workspace-router.js";
4
+ import { openWarp } from "../warp/open.js";
5
+
6
+ export const DEFAULT_LOCAL_HISTORY_DAG_LIMIT = 12;
7
+
8
+ const LOCAL_HISTORY_OBSERVER_MATCH = ["lh:*", "repo:*", "worktree:*", "file:*", "sym:*"] as const;
9
+ const LOCAL_HISTORY_OBSERVER_EXPOSE = [
10
+ "actorId",
11
+ "actorKind",
12
+ "authority",
13
+ "causalSessionId",
14
+ "checkoutEpochId",
15
+ "continuityOperation",
16
+ "entityKind",
17
+ "eventId",
18
+ "eventKind",
19
+ "name",
20
+ "occurredAt",
21
+ "openedAt",
22
+ "path",
23
+ "phase",
24
+ "projection",
25
+ "reason",
26
+ "repoId",
27
+ "selectionKind",
28
+ "semanticKind",
29
+ "source",
30
+ "sourceLayer",
31
+ "startedAt",
32
+ "strandId",
33
+ "summary",
34
+ "surface",
35
+ "symbols",
36
+ "targetId",
37
+ "transportSessionId",
38
+ "worktreeId",
39
+ "workspaceOverlayId",
40
+ "workspaceSliceId",
41
+ "paths",
42
+ ] as const;
43
+ const optionalString = z.string().nullish().transform((value) => value ?? undefined);
44
+ const optionalStringArray = z.array(z.string()).nullish().transform((value) => value ?? undefined);
45
+ const LOCAL_EDGE_LABELS = new Set([
46
+ "follows",
47
+ "continues_from",
48
+ "creates_strand",
49
+ "parks_strand",
50
+ "in_session",
51
+ "in_strand",
52
+ "in_worktree",
53
+ "in_checkout_epoch",
54
+ "in_workspace_slice",
55
+ "attributed_to",
56
+ "has_footprint",
57
+ "captures_target",
58
+ "creates_epoch",
59
+ "has_worktree",
60
+ "entered_epoch",
61
+ "has_causal_session",
62
+ "owns_strand",
63
+ "has_workspace_slice",
64
+ "bound_to",
65
+ "opened_at_epoch",
66
+ "anchored_to",
67
+ "selected_from",
68
+ "supported_by",
69
+ "has_region",
70
+ "references_file",
71
+ "touches_file",
72
+ "targets_file",
73
+ "targets_symbol",
74
+ ]);
75
+ const SUPPORTING_ENTITY_KINDS = new Set([
76
+ "repo",
77
+ "worktree",
78
+ "checkout_epoch",
79
+ "causal_session",
80
+ "strand",
81
+ "workspace_slice",
82
+ "actor",
83
+ "workspace_overlay",
84
+ "staged_target",
85
+ "causal_footprint",
86
+ "causal_region",
87
+ "evidence",
88
+ ]);
89
+
90
+ const observedNodePropsSchema = z.looseObject({
91
+ actorId: optionalString,
92
+ actorKind: optionalString,
93
+ authority: optionalString,
94
+ causalSessionId: optionalString,
95
+ checkoutEpochId: optionalString,
96
+ continuityOperation: optionalString,
97
+ entityKind: optionalString,
98
+ eventId: optionalString,
99
+ eventKind: optionalString,
100
+ name: optionalString,
101
+ occurredAt: optionalString,
102
+ openedAt: optionalString,
103
+ path: optionalString,
104
+ paths: optionalStringArray,
105
+ phase: optionalString,
106
+ projection: optionalString,
107
+ reason: optionalString,
108
+ repoId: optionalString,
109
+ selectionKind: optionalString,
110
+ semanticKind: optionalString,
111
+ source: optionalString,
112
+ sourceLayer: optionalString,
113
+ startedAt: optionalString,
114
+ strandId: optionalString,
115
+ summary: optionalString,
116
+ surface: optionalString,
117
+ symbols: optionalStringArray,
118
+ targetId: optionalString,
119
+ transportSessionId: optionalString,
120
+ worktreeId: optionalString,
121
+ workspaceOverlayId: optionalString,
122
+ workspaceSliceId: optionalString,
123
+ });
124
+ const observedEdgeSchema = z.object({
125
+ from: z.string(),
126
+ to: z.string(),
127
+ label: z.string(),
128
+ }).strict();
129
+
130
+ type ObservedNodeProps = z.infer<typeof observedNodePropsSchema>;
131
+
132
+ export interface LocalHistoryDagNode {
133
+ readonly id: string;
134
+ readonly label: string;
135
+ readonly entityKind: string;
136
+ readonly eventKind?: string | undefined;
137
+ readonly occurredAt?: string | undefined;
138
+ }
139
+
140
+ export interface LocalHistoryDagEdge {
141
+ readonly from: string;
142
+ readonly to: string;
143
+ readonly label: string;
144
+ }
145
+
146
+ export interface LocalHistoryDagModel {
147
+ readonly cwd: string;
148
+ readonly repoId: string;
149
+ readonly worktreeId: string;
150
+ readonly requestedEventLimit: number;
151
+ readonly totalEventCount: number;
152
+ readonly shownEventCount: number;
153
+ readonly nodeCount: number;
154
+ readonly edgeCount: number;
155
+ readonly truncated: boolean;
156
+ readonly nodes: readonly LocalHistoryDagNode[];
157
+ readonly edges: readonly LocalHistoryDagEdge[];
158
+ }
159
+
160
+ export interface LocalHistoryDagObservedNodeInput {
161
+ readonly id: string;
162
+ readonly props: Record<string, unknown>;
163
+ }
164
+
165
+ interface ObservedNode {
166
+ readonly id: string;
167
+ readonly props: ObservedNodeProps;
168
+ }
169
+
170
+ function compareByTimeThenId(
171
+ left: { readonly occurredAt?: string | undefined; readonly id: string },
172
+ right: { readonly occurredAt?: string | undefined; readonly id: string },
173
+ ): number {
174
+ const leftTime = left.occurredAt ?? "";
175
+ const rightTime = right.occurredAt ?? "";
176
+ const byTime = leftTime.localeCompare(rightTime);
177
+ if (byTime !== 0) {
178
+ return byTime;
179
+ }
180
+ return left.id.localeCompare(right.id);
181
+ }
182
+
183
+ function trimId(value: string): string {
184
+ const parts = value.split(":");
185
+ return parts.at(-1) ?? value;
186
+ }
187
+
188
+ function parseObservedNode(input: LocalHistoryDagObservedNodeInput): ObservedNode | null {
189
+ const parsed = observedNodePropsSchema.safeParse(input.props);
190
+ if (!parsed.success) {
191
+ return null;
192
+ }
193
+ return {
194
+ id: input.id,
195
+ props: parsed.data,
196
+ };
197
+ }
198
+
199
+ function parseObservedEdge(input: LocalHistoryDagEdge): LocalHistoryDagEdge | null {
200
+ const parsed = observedEdgeSchema.safeParse(input);
201
+ return parsed.success ? parsed.data : null;
202
+ }
203
+
204
+ function buildNodeLabel(node: ObservedNode): string {
205
+ const { id, props } = node;
206
+ const entityKind = props.entityKind ?? "node";
207
+ const occurredAt = props.occurredAt;
208
+
209
+ if (entityKind === "local_history_event") {
210
+ const eventKind = props.eventKind ?? "event";
211
+ if (eventKind === "continuity") {
212
+ const operation = props.continuityOperation ?? "continuity";
213
+ return occurredAt !== undefined ? `continuity:${operation} @ ${occurredAt}` : `continuity:${operation}`;
214
+ }
215
+ if (eventKind === "read") {
216
+ const surface = props.surface ?? "read";
217
+ const projection = props.projection ?? "unknown";
218
+ return occurredAt !== undefined ? `read:${surface}/${projection} @ ${occurredAt}` : `read:${surface}/${projection}`;
219
+ }
220
+ if (eventKind === "stage") {
221
+ const selectionKind = props.selectionKind ?? "stage";
222
+ return occurredAt !== undefined ? `stage:${selectionKind} @ ${occurredAt}` : `stage:${selectionKind}`;
223
+ }
224
+ if (eventKind === "transition") {
225
+ const semanticKind = props.semanticKind ?? "transition";
226
+ return occurredAt !== undefined ? `transition:${semanticKind} @ ${occurredAt}` : `transition:${semanticKind}`;
227
+ }
228
+ return occurredAt !== undefined ? `${eventKind} @ ${occurredAt}` : eventKind;
229
+ }
230
+
231
+ if (entityKind === "causal_session") {
232
+ return `session:${trimId(props.causalSessionId ?? id)}`;
233
+ }
234
+ if (entityKind === "strand") {
235
+ return `strand:${trimId(props.strandId ?? id)}`;
236
+ }
237
+ if (entityKind === "workspace_slice") {
238
+ return `slice:${trimId(props.workspaceSliceId ?? id)}`;
239
+ }
240
+ if (entityKind === "checkout_epoch") {
241
+ return `epoch:${trimId(props.checkoutEpochId ?? id)}`;
242
+ }
243
+ if (entityKind === "actor") {
244
+ const actorId = trimId(props.actorId ?? id);
245
+ const actorKind = props.actorKind ?? "actor";
246
+ return actorKind === "unknown" ? `actor:${actorId}` : `${actorKind}:${actorId}`;
247
+ }
248
+ if (entityKind === "workspace_overlay") {
249
+ return `overlay:${trimId(props.workspaceOverlayId ?? id)}`;
250
+ }
251
+ if (entityKind === "staged_target") {
252
+ return `target:${props.selectionKind ?? trimId(props.targetId ?? id)}`;
253
+ }
254
+ if (entityKind === "causal_footprint") {
255
+ const pathCount = props.paths?.length ?? 0;
256
+ const symbolCount = props.symbols?.length ?? 0;
257
+ return `footprint:${String(pathCount)}p/${String(symbolCount)}s`;
258
+ }
259
+ if (entityKind === "repo") {
260
+ return `repo:${trimId(props.repoId ?? id)}`;
261
+ }
262
+ if (entityKind === "worktree") {
263
+ return `worktree:${trimId(props.worktreeId ?? id)}`;
264
+ }
265
+ if (props.path !== undefined) {
266
+ return `file:${props.path}`;
267
+ }
268
+ if (props.name !== undefined) {
269
+ return `symbol:${props.name}`;
270
+ }
271
+
272
+ return `${entityKind}:${trimId(id)}`;
273
+ }
274
+
275
+ function toDagNode(node: ObservedNode): LocalHistoryDagNode {
276
+ return {
277
+ id: node.id,
278
+ label: buildNodeLabel(node),
279
+ entityKind: node.props.entityKind ?? "unknown",
280
+ ...(node.props.eventKind !== undefined ? { eventKind: node.props.eventKind } : {}),
281
+ ...(node.props.occurredAt !== undefined ? { occurredAt: node.props.occurredAt } : {}),
282
+ };
283
+ }
284
+
285
+ function resolveSelectedWorktreeId(
286
+ resolvedWorktreeId: string,
287
+ repoId: string,
288
+ nodes: readonly ObservedNode[],
289
+ ): string {
290
+ const graphWorktreeIds = nodes
291
+ .filter((node) => node.props.entityKind === "worktree" && node.props.repoId === repoId && node.props.worktreeId !== undefined)
292
+ .map((node) => node.props.worktreeId)
293
+ .sort();
294
+
295
+ if (graphWorktreeIds.includes(resolvedWorktreeId)) {
296
+ return resolvedWorktreeId;
297
+ }
298
+ if (graphWorktreeIds.length === 1) {
299
+ return graphWorktreeIds[0] ?? resolvedWorktreeId;
300
+ }
301
+ return resolvedWorktreeId;
302
+ }
303
+
304
+ function collectEventNodes(
305
+ repoId: string,
306
+ worktreeId: string,
307
+ nodes: readonly ObservedNode[],
308
+ ): readonly { id: string; occurredAt?: string | undefined }[] {
309
+ return nodes
310
+ .filter((node) =>
311
+ node.props.entityKind === "local_history_event" &&
312
+ node.props.repoId === repoId &&
313
+ node.props.worktreeId === worktreeId
314
+ )
315
+ .map((node) => ({
316
+ id: node.id,
317
+ occurredAt: node.props.occurredAt,
318
+ }))
319
+ .sort(compareByTimeThenId);
320
+ }
321
+
322
+ function collectIncludedNodeIds(
323
+ selectedEventIds: ReadonlySet<string>,
324
+ nodesById: ReadonlyMap<string, ObservedNode>,
325
+ edges: readonly LocalHistoryDagEdge[],
326
+ ): Set<string> {
327
+ const included = new Set<string>(selectedEventIds);
328
+ let changed = true;
329
+
330
+ while (changed) {
331
+ changed = false;
332
+ for (const edge of edges) {
333
+ if (!LOCAL_EDGE_LABELS.has(edge.label)) {
334
+ continue;
335
+ }
336
+ const fromIncluded = included.has(edge.from);
337
+ const toIncluded = included.has(edge.to);
338
+ if (!fromIncluded && !toIncluded) {
339
+ continue;
340
+ }
341
+
342
+ const fromKind = nodesById.get(edge.from)?.props.entityKind;
343
+ const toKind = nodesById.get(edge.to)?.props.entityKind;
344
+
345
+ if (fromIncluded && !toIncluded && toKind !== undefined && SUPPORTING_ENTITY_KINDS.has(toKind)) {
346
+ included.add(edge.to);
347
+ changed = true;
348
+ }
349
+ if (toIncluded && !fromIncluded && fromKind !== undefined && SUPPORTING_ENTITY_KINDS.has(fromKind)) {
350
+ included.add(edge.from);
351
+ changed = true;
352
+ }
353
+ }
354
+ }
355
+
356
+ return included;
357
+ }
358
+
359
+ export function buildLocalHistoryDagModelFromObservedGraph(input: {
360
+ readonly cwd: string;
361
+ readonly repoId: string;
362
+ readonly resolvedWorktreeId: string;
363
+ readonly requestedEventLimit: number;
364
+ readonly observedNodes: readonly LocalHistoryDagObservedNodeInput[];
365
+ readonly observedEdges: readonly LocalHistoryDagEdge[];
366
+ }): LocalHistoryDagModel {
367
+ const nodes = input.observedNodes
368
+ .map(parseObservedNode)
369
+ .filter((node): node is ObservedNode => node !== null);
370
+ const edges = input.observedEdges
371
+ .map(parseObservedEdge)
372
+ .filter((edge): edge is LocalHistoryDagEdge => edge !== null);
373
+ const nodesById = new Map(nodes.map((node) => [node.id, node] as const));
374
+ const candidateIdSet = new Set(nodesById.keys());
375
+ const boundedEdges = edges.filter((edge) => candidateIdSet.has(edge.from) && candidateIdSet.has(edge.to));
376
+ const selectedWorktreeId = resolveSelectedWorktreeId(input.resolvedWorktreeId, input.repoId, nodes);
377
+ const eventNodes = collectEventNodes(input.repoId, selectedWorktreeId, nodes);
378
+ const selectedEventIds = new Set(eventNodes.slice(-input.requestedEventLimit).map((node) => node.id));
379
+ const includedNodeIds = collectIncludedNodeIds(selectedEventIds, nodesById, boundedEdges);
380
+ const selectedNodes = [...includedNodeIds]
381
+ .map((id) => nodesById.get(id))
382
+ .filter((node): node is ObservedNode => node !== undefined)
383
+ .map(toDagNode)
384
+ .sort(compareByTimeThenId);
385
+ const selectedEdges = boundedEdges.filter((edge) => includedNodeIds.has(edge.from) && includedNodeIds.has(edge.to));
386
+
387
+ return {
388
+ cwd: input.cwd,
389
+ repoId: input.repoId,
390
+ worktreeId: selectedWorktreeId,
391
+ requestedEventLimit: input.requestedEventLimit,
392
+ totalEventCount: eventNodes.length,
393
+ shownEventCount: selectedEventIds.size,
394
+ nodeCount: selectedNodes.length,
395
+ edgeCount: selectedEdges.length,
396
+ truncated: eventNodes.length > selectedEventIds.size,
397
+ nodes: selectedNodes,
398
+ edges: selectedEdges,
399
+ };
400
+ }
401
+
402
+ export async function loadLocalHistoryDagModel(options: {
403
+ readonly cwd: string;
404
+ readonly limit: number;
405
+ }): Promise<LocalHistoryDagModel> {
406
+ const resolved = await resolveWorkspaceRequest(nodeGit, { cwd: options.cwd });
407
+ if ("code" in resolved) {
408
+ throw new Error(resolved.message);
409
+ }
410
+
411
+ const warp = await openWarp({ cwd: options.cwd });
412
+ const observer = await warp.observer({
413
+ match: [...LOCAL_HISTORY_OBSERVER_MATCH],
414
+ expose: [...LOCAL_HISTORY_OBSERVER_EXPOSE],
415
+ });
416
+ const observedNodeIds = await observer.getNodes();
417
+ const observedNodes = (await Promise.all(
418
+ observedNodeIds.map(async (id) => {
419
+ const props = await observer.getNodeProps(id);
420
+ return props === null ? null : { id, props };
421
+ }),
422
+ )).filter((node): node is LocalHistoryDagObservedNodeInput => node !== null);
423
+ const observedEdges = (await observer.getEdges()).map((edge) => ({
424
+ from: edge.from,
425
+ to: edge.to,
426
+ label: edge.label,
427
+ }));
428
+
429
+ return buildLocalHistoryDagModelFromObservedGraph({
430
+ cwd: options.cwd,
431
+ repoId: resolved.repoId,
432
+ resolvedWorktreeId: resolved.worktreeId,
433
+ requestedEventLimit: options.limit > 0 ? options.limit : DEFAULT_LOCAL_HISTORY_DAG_LIMIT,
434
+ observedNodes,
435
+ observedEdges,
436
+ });
437
+ }
@@ -0,0 +1,133 @@
1
+ import { dag, type DagNode } from "@flyingrobots/bijou";
2
+ import { initDefaultContext } from "@flyingrobots/bijou-node";
3
+ import type { TokenValue } from "@flyingrobots/bijou";
4
+ import type { LocalHistoryDagModel, LocalHistoryDagNode } from "./local-history-dag-model.js";
5
+
6
+ function compareByTimeThenId(
7
+ left: { readonly occurredAt?: string | undefined; readonly id: string },
8
+ right: { readonly occurredAt?: string | undefined; readonly id: string },
9
+ ): number {
10
+ const leftTime = left.occurredAt ?? "";
11
+ const rightTime = right.occurredAt ?? "";
12
+ const byTime = leftTime.localeCompare(rightTime);
13
+ if (byTime !== 0) {
14
+ return byTime;
15
+ }
16
+ return left.id.localeCompare(right.id);
17
+ }
18
+
19
+ function eventPath(model: LocalHistoryDagModel): string[] {
20
+ return model.nodes
21
+ .filter((node) => node.entityKind === "local_history_event")
22
+ .sort(compareByTimeThenId)
23
+ .map((node) => node.id);
24
+ }
25
+
26
+ function tokenForNode(node: LocalHistoryDagNode): TokenValue | undefined {
27
+ if (node.entityKind === "local_history_event") {
28
+ if (node.eventKind === "continuity") {
29
+ return { hex: "#22c55e" };
30
+ }
31
+ if (node.eventKind === "read") {
32
+ return { hex: "#3b82f6" };
33
+ }
34
+ if (node.eventKind === "stage") {
35
+ return { hex: "#f59e0b" };
36
+ }
37
+ if (node.eventKind === "transition") {
38
+ return { hex: "#ef4444" };
39
+ }
40
+ return { hex: "#0ea5e9" };
41
+ }
42
+
43
+ if (node.entityKind === "repo" || node.entityKind === "worktree") {
44
+ return { hex: "#14b8a6" };
45
+ }
46
+ if (node.entityKind === "causal_session" || node.entityKind === "strand" || node.entityKind === "workspace_slice") {
47
+ return { hex: "#06b6d4" };
48
+ }
49
+ if (node.entityKind === "checkout_epoch") {
50
+ return { hex: "#84cc16" };
51
+ }
52
+ if (node.entityKind === "causal_footprint" || node.entityKind === "staged_target") {
53
+ return { hex: "#f59e0b" };
54
+ }
55
+ if (node.entityKind === "evidence" || node.entityKind === "actor" || node.entityKind === "causal_region") {
56
+ return { hex: "#94a3b8" };
57
+ }
58
+
59
+ return undefined;
60
+ }
61
+
62
+ function badgeForNode(node: LocalHistoryDagNode): string | undefined {
63
+ if (node.entityKind === "local_history_event") {
64
+ return node.eventKind?.toUpperCase();
65
+ }
66
+ if (node.entityKind === "repo") return "REPO";
67
+ if (node.entityKind === "worktree") return "WT";
68
+ if (node.entityKind === "causal_session") return "SESSION";
69
+ if (node.entityKind === "strand") return "STRAND";
70
+ if (node.entityKind === "workspace_slice") return "SLICE";
71
+ if (node.entityKind === "checkout_epoch") return "EPOCH";
72
+ if (node.entityKind === "causal_footprint") return "FOOTPRINT";
73
+ if (node.entityKind === "evidence") return "EVID";
74
+ return undefined;
75
+ }
76
+
77
+ function toBijouDagNodes(model: LocalHistoryDagModel): DagNode[] {
78
+ const outgoingEdges = new Map<string, string[]>();
79
+ for (const edge of model.edges) {
80
+ const bucket = outgoingEdges.get(edge.from) ?? [];
81
+ bucket.push(edge.to);
82
+ outgoingEdges.set(edge.from, bucket);
83
+ }
84
+
85
+ return model.nodes.map((node) => {
86
+ const dagNode: DagNode = {
87
+ id: node.id,
88
+ label: node.label,
89
+ };
90
+ const edges = outgoingEdges.get(node.id);
91
+ if (edges !== undefined) {
92
+ dagNode.edges = edges;
93
+ }
94
+ const badge = badgeForNode(node);
95
+ if (badge !== undefined) {
96
+ dagNode.badge = badge;
97
+ }
98
+ const token = tokenForNode(node);
99
+ if (token !== undefined) {
100
+ dagNode.token = token;
101
+ }
102
+ return dagNode;
103
+ });
104
+ }
105
+
106
+ export function renderLocalHistoryDag(model: LocalHistoryDagModel): string {
107
+ if (model.shownEventCount === 0) {
108
+ return [
109
+ "Local History DAG",
110
+ `repo: ${model.repoId}`,
111
+ `worktree: ${model.worktreeId}`,
112
+ "",
113
+ "No local history event nodes found in the WARP graph.",
114
+ ].join("\n");
115
+ }
116
+
117
+ const ctx = initDefaultContext();
118
+ const header = [
119
+ "Local History DAG",
120
+ `repo: ${model.repoId}`,
121
+ `worktree: ${model.worktreeId}`,
122
+ `events: ${String(model.shownEventCount)}/${String(model.totalEventCount)} (limit ${String(model.requestedEventLimit)})`,
123
+ `nodes: ${String(model.nodeCount)}`,
124
+ `edges: ${String(model.edgeCount)}`,
125
+ ].join("\n");
126
+ const graph = dag(toBijouDagNodes(model), {
127
+ ctx,
128
+ highlightPath: eventPath(model),
129
+ highlightToken: { hex: "#f97316" },
130
+ });
131
+
132
+ return `${header}\n\n${graph}`.trimEnd();
133
+ }