@flyingrobots/graft 0.7.0 → 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 (283) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +0 -1
  3. package/bin/graft.js +26 -26
  4. package/dist/cli/init-client-config.d.ts.map +1 -1
  5. package/dist/cli/init-client-config.js +40 -4
  6. package/dist/cli/init-client-config.js.map +1 -1
  7. package/dist/cli/init-model.js +2 -2
  8. package/dist/cli/init-model.js.map +1 -1
  9. package/dist/cli/json-document.d.ts +1 -0
  10. package/dist/cli/json-document.d.ts.map +1 -1
  11. package/dist/cli/json-document.js +3 -0
  12. package/dist/cli/json-document.js.map +1 -1
  13. package/dist/hooks/posttooluse-read.js +1 -1
  14. package/dist/hooks/posttooluse-read.js.map +1 -1
  15. package/dist/hooks/pretooluse-read.js +1 -1
  16. package/dist/hooks/pretooluse-read.js.map +1 -1
  17. package/dist/mcp/daemon-worker-child-pool.d.ts +2 -0
  18. package/dist/mcp/daemon-worker-child-pool.d.ts.map +1 -1
  19. package/dist/mcp/daemon-worker-child-pool.js +10 -3
  20. package/dist/mcp/daemon-worker-child-pool.js.map +1 -1
  21. package/dist/mcp/daemon-worker-pool.d.ts +1 -1
  22. package/dist/mcp/daemon-worker-pool.d.ts.map +1 -1
  23. package/dist/mcp/daemon-worker-pool.js +1 -1
  24. package/dist/mcp/daemon-worker-pool.js.map +1 -1
  25. package/dist/version.d.ts.map +1 -1
  26. package/dist/version.js +3 -1
  27. package/dist/version.js.map +1 -1
  28. package/docs/SETUP.md +11 -7
  29. package/package.json +9 -4
  30. package/src/adapters/canonical-json.ts +0 -56
  31. package/src/adapters/json-text-decoder.ts +0 -11
  32. package/src/adapters/node-fs.ts +0 -43
  33. package/src/adapters/node-git.ts +0 -47
  34. package/src/adapters/node-paths.ts +0 -35
  35. package/src/adapters/node-process-runner.ts +0 -27
  36. package/src/adapters/repo-paths.ts +0 -63
  37. package/src/adapters/rotating-ndjson-log.ts +0 -66
  38. package/src/api/index.ts +0 -107
  39. package/src/api/repo-local-graft.ts +0 -21
  40. package/src/api/repo-workspace.ts +0 -34
  41. package/src/api/tool-bridge.ts +0 -22
  42. package/src/cli/activity-render.ts +0 -112
  43. package/src/cli/cli-error.ts +0 -192
  44. package/src/cli/command-parser.ts +0 -484
  45. package/src/cli/daemon-status-model.ts +0 -238
  46. package/src/cli/daemon-status-render.ts +0 -102
  47. package/src/cli/daemon-status.ts +0 -100
  48. package/src/cli/entrypoint.ts +0 -18
  49. package/src/cli/git-graft-enhance-model.ts +0 -131
  50. package/src/cli/git-graft-enhance-render.ts +0 -33
  51. package/src/cli/git-graft-enhance.ts +0 -54
  52. package/src/cli/index-cmd.ts +0 -90
  53. package/src/cli/index-model.ts +0 -75
  54. package/src/cli/init-bootstrap.ts +0 -47
  55. package/src/cli/init-client-config.ts +0 -428
  56. package/src/cli/init-model.ts +0 -284
  57. package/src/cli/init-render.ts +0 -54
  58. package/src/cli/init-target-hooks.ts +0 -93
  59. package/src/cli/init.ts +0 -124
  60. package/src/cli/json-document.ts +0 -155
  61. package/src/cli/local-history-dag-model.ts +0 -437
  62. package/src/cli/local-history-dag-render.ts +0 -133
  63. package/src/cli/local-history-dag.ts +0 -103
  64. package/src/cli/main.ts +0 -197
  65. package/src/cli/migrate-local-history.ts +0 -119
  66. package/src/cli/peer-command.ts +0 -60
  67. package/src/contracts/capabilities.ts +0 -540
  68. package/src/contracts/causal-ontology.ts +0 -627
  69. package/src/contracts/causal-surface-next-action.ts +0 -18
  70. package/src/contracts/json-object.ts +0 -18
  71. package/src/contracts/mcp-runtime.ts +0 -16
  72. package/src/contracts/output-schema-cli.ts +0 -103
  73. package/src/contracts/output-schema-fragments.ts +0 -881
  74. package/src/contracts/output-schema-mcp.ts +0 -501
  75. package/src/contracts/output-schema-meta.ts +0 -119
  76. package/src/contracts/output-schemas.ts +0 -1524
  77. package/src/git/diff.ts +0 -161
  78. package/src/git/target-git-hook-bootstrap.ts +0 -56
  79. package/src/guards/stream-boundary.ts +0 -110
  80. package/src/hooks/posttooluse-read.ts +0 -54
  81. package/src/hooks/pretooluse-read.ts +0 -52
  82. package/src/hooks/read-governor.ts +0 -95
  83. package/src/hooks/read-messages.ts +0 -53
  84. package/src/hooks/shared.ts +0 -168
  85. package/src/index.ts +0 -1
  86. package/src/mcp/burden.ts +0 -132
  87. package/src/mcp/cache.ts +0 -7
  88. package/src/mcp/cached-file.ts +0 -1
  89. package/src/mcp/context.ts +0 -150
  90. package/src/mcp/control-plane/authz-storage.ts +0 -129
  91. package/src/mcp/control-plane/session-registry.ts +0 -115
  92. package/src/mcp/control-plane/status-projection.ts +0 -76
  93. package/src/mcp/control-plane/types.ts +0 -144
  94. package/src/mcp/daemon-bootstrap.ts +0 -100
  95. package/src/mcp/daemon-control-plane.ts +0 -310
  96. package/src/mcp/daemon-job-scheduler.ts +0 -279
  97. package/src/mcp/daemon-repos.ts +0 -99
  98. package/src/mcp/daemon-server.ts +0 -172
  99. package/src/mcp/daemon-session-host.ts +0 -234
  100. package/src/mcp/daemon-stdio-bridge.ts +0 -262
  101. package/src/mcp/daemon-worker-child-pool.ts +0 -213
  102. package/src/mcp/daemon-worker-inline-pool.ts +0 -46
  103. package/src/mcp/daemon-worker-pool.ts +0 -7
  104. package/src/mcp/daemon-worker-process.ts +0 -52
  105. package/src/mcp/daemon-worker-types.ts +0 -66
  106. package/src/mcp/metrics.ts +0 -176
  107. package/src/mcp/monitor-health.ts +0 -83
  108. package/src/mcp/monitor-persistence.ts +0 -54
  109. package/src/mcp/monitor-tick-job.ts +0 -153
  110. package/src/mcp/monitor-types.ts +0 -103
  111. package/src/mcp/persisted-local-history-graph.ts +0 -592
  112. package/src/mcp/persisted-local-history-policy.ts +0 -501
  113. package/src/mcp/persisted-local-history-views.ts +0 -250
  114. package/src/mcp/persisted-local-history.ts +0 -1621
  115. package/src/mcp/persistent-monitor-runtime.ts +0 -482
  116. package/src/mcp/policy.ts +0 -75
  117. package/src/mcp/receipt.ts +0 -201
  118. package/src/mcp/repo-concurrency.ts +0 -392
  119. package/src/mcp/repo-overview/filter.ts +0 -44
  120. package/src/mcp/repo-overview/types.ts +0 -63
  121. package/src/mcp/repo-overview/view-projection.ts +0 -90
  122. package/src/mcp/repo-state-git.ts +0 -247
  123. package/src/mcp/repo-state-observation.ts +0 -203
  124. package/src/mcp/repo-state-transition.ts +0 -151
  125. package/src/mcp/repo-state-types.ts +0 -107
  126. package/src/mcp/repo-state.ts +0 -146
  127. package/src/mcp/repo-tool-job.ts +0 -102
  128. package/src/mcp/repo-tool-worker-context.ts +0 -215
  129. package/src/mcp/repo-workspace.ts +0 -21
  130. package/src/mcp/run-capture-config.ts +0 -33
  131. package/src/mcp/runtime-causal-context.ts +0 -72
  132. package/src/mcp/runtime-observability.ts +0 -217
  133. package/src/mcp/runtime-staged-target.ts +0 -161
  134. package/src/mcp/runtime-workspace-overlay.ts +0 -255
  135. package/src/mcp/secret-scrub.ts +0 -89
  136. package/src/mcp/semantic-transition-guidance.ts +0 -60
  137. package/src/mcp/semantic-transition-summary.ts +0 -130
  138. package/src/mcp/server-context.ts +0 -236
  139. package/src/mcp/server-invocation.ts +0 -388
  140. package/src/mcp/server-tool-access.ts +0 -148
  141. package/src/mcp/server.ts +0 -270
  142. package/src/mcp/stdio-server.ts +0 -26
  143. package/src/mcp/stdio.ts +0 -3
  144. package/src/mcp/tool-registry.ts +0 -98
  145. package/src/mcp/tools/activity-view.ts +0 -325
  146. package/src/mcp/tools/budget.ts +0 -23
  147. package/src/mcp/tools/causal-attach.ts +0 -67
  148. package/src/mcp/tools/causal-status.ts +0 -58
  149. package/src/mcp/tools/changed-since.ts +0 -71
  150. package/src/mcp/tools/code-find.ts +0 -192
  151. package/src/mcp/tools/code-refs.ts +0 -470
  152. package/src/mcp/tools/code-show.ts +0 -289
  153. package/src/mcp/tools/daemon-monitors.ts +0 -14
  154. package/src/mcp/tools/daemon-repos.ts +0 -22
  155. package/src/mcp/tools/daemon-sessions.ts +0 -14
  156. package/src/mcp/tools/daemon-status.ts +0 -12
  157. package/src/mcp/tools/diagnostic-models.ts +0 -97
  158. package/src/mcp/tools/doctor.ts +0 -83
  159. package/src/mcp/tools/explain.ts +0 -84
  160. package/src/mcp/tools/export-surface-diff.ts +0 -26
  161. package/src/mcp/tools/file-outline.ts +0 -67
  162. package/src/mcp/tools/git-files.ts +0 -73
  163. package/src/mcp/tools/graft-diff.ts +0 -35
  164. package/src/mcp/tools/graft-edit.ts +0 -276
  165. package/src/mcp/tools/knowledge-map.ts +0 -34
  166. package/src/mcp/tools/map-collector.ts +0 -338
  167. package/src/mcp/tools/map.ts +0 -185
  168. package/src/mcp/tools/monitor-nudge.ts +0 -19
  169. package/src/mcp/tools/monitor-pause.ts +0 -18
  170. package/src/mcp/tools/monitor-resume.ts +0 -18
  171. package/src/mcp/tools/monitor-start.ts +0 -20
  172. package/src/mcp/tools/monitor-stop.ts +0 -18
  173. package/src/mcp/tools/precision-live.ts +0 -158
  174. package/src/mcp/tools/precision-match.ts +0 -54
  175. package/src/mcp/tools/precision-paths.ts +0 -59
  176. package/src/mcp/tools/precision-query.ts +0 -127
  177. package/src/mcp/tools/precision-show.ts +0 -86
  178. package/src/mcp/tools/precision-visibility.ts +0 -44
  179. package/src/mcp/tools/precision-warp.ts +0 -101
  180. package/src/mcp/tools/precision.ts +0 -21
  181. package/src/mcp/tools/read-range.ts +0 -28
  182. package/src/mcp/tools/refactor-difficulty.ts +0 -42
  183. package/src/mcp/tools/run-capture.ts +0 -149
  184. package/src/mcp/tools/safe-read.ts +0 -148
  185. package/src/mcp/tools/since.ts +0 -53
  186. package/src/mcp/tools/state.ts +0 -39
  187. package/src/mcp/tools/stats.ts +0 -24
  188. package/src/mcp/tools/structural-blame.ts +0 -55
  189. package/src/mcp/tools/structural-churn.ts +0 -28
  190. package/src/mcp/tools/structural-log.ts +0 -41
  191. package/src/mcp/tools/structural-review.ts +0 -63
  192. package/src/mcp/tools/workspace-authorizations.ts +0 -14
  193. package/src/mcp/tools/workspace-authorize.ts +0 -20
  194. package/src/mcp/tools/workspace-bind.ts +0 -25
  195. package/src/mcp/tools/workspace-rebind.ts +0 -25
  196. package/src/mcp/tools/workspace-revoke.ts +0 -18
  197. package/src/mcp/tools/workspace-status.ts +0 -12
  198. package/src/mcp/warp-pool.ts +0 -36
  199. package/src/mcp/workspace-read-observation-model.ts +0 -48
  200. package/src/mcp/workspace-read-observation.ts +0 -103
  201. package/src/mcp/workspace-router-capability.ts +0 -32
  202. package/src/mcp/workspace-router-history.ts +0 -233
  203. package/src/mcp/workspace-router-model.ts +0 -131
  204. package/src/mcp/workspace-router-resolution.ts +0 -71
  205. package/src/mcp/workspace-router-runtime.ts +0 -246
  206. package/src/mcp/workspace-router.ts +0 -688
  207. package/src/metrics/logger.ts +0 -40
  208. package/src/metrics/types.ts +0 -40
  209. package/src/operations/adaptive-projection.ts +0 -54
  210. package/src/operations/agent-handoff.ts +0 -59
  211. package/src/operations/cached-file.ts +0 -40
  212. package/src/operations/capture-range.ts +0 -64
  213. package/src/operations/conversation-primer.ts +0 -82
  214. package/src/operations/cross-session-resume.ts +0 -104
  215. package/src/operations/deterministic-replay.ts +0 -143
  216. package/src/operations/diff-identity.ts +0 -127
  217. package/src/operations/export-surface-diff.ts +0 -355
  218. package/src/operations/file-outline.ts +0 -48
  219. package/src/operations/footprint-parallelism.ts +0 -98
  220. package/src/operations/graft-diff.ts +0 -169
  221. package/src/operations/horizon-of-readability.ts +0 -60
  222. package/src/operations/import-reference-impact.ts +0 -143
  223. package/src/operations/knowledge-map.ts +0 -96
  224. package/src/operations/observation-cache.ts +0 -165
  225. package/src/operations/projection-safety.ts +0 -111
  226. package/src/operations/read-range.ts +0 -64
  227. package/src/operations/repo-workspace.ts +0 -339
  228. package/src/operations/result-dto.ts +0 -23
  229. package/src/operations/safe-read.ts +0 -118
  230. package/src/operations/semantic-drift.ts +0 -70
  231. package/src/operations/session-filtration.ts +0 -76
  232. package/src/operations/session-replay.ts +0 -73
  233. package/src/operations/sludge-detector.ts +0 -356
  234. package/src/operations/state.ts +0 -66
  235. package/src/operations/structural-blame.ts +0 -197
  236. package/src/operations/structural-review.ts +0 -317
  237. package/src/operations/structured-buffer-compare.ts +0 -429
  238. package/src/operations/structured-buffer-model.ts +0 -456
  239. package/src/operations/structured-buffer-query.ts +0 -794
  240. package/src/operations/structured-buffer.ts +0 -181
  241. package/src/operations/teaching-hints.ts +0 -52
  242. package/src/parser/diff.ts +0 -320
  243. package/src/parser/lang.ts +0 -71
  244. package/src/parser/markdown.ts +0 -197
  245. package/src/parser/outline.ts +0 -316
  246. package/src/parser/runtime.ts +0 -71
  247. package/src/parser/types.ts +0 -75
  248. package/src/policy/evaluate.ts +0 -178
  249. package/src/policy/graftignore.ts +0 -6
  250. package/src/policy/types.ts +0 -87
  251. package/src/ports/codec.ts +0 -13
  252. package/src/ports/filesystem.ts +0 -18
  253. package/src/ports/git.ts +0 -16
  254. package/src/ports/guards.ts +0 -68
  255. package/src/ports/paths.ts +0 -22
  256. package/src/ports/process-runner.ts +0 -22
  257. package/src/release/security-gate.ts +0 -102
  258. package/src/session/tracker.ts +0 -145
  259. package/src/session/types.ts +0 -23
  260. package/src/version.ts +0 -3
  261. package/src/warp/ast-emitter.ts +0 -133
  262. package/src/warp/ast-import-resolver.ts +0 -333
  263. package/src/warp/commit-meta.ts +0 -19
  264. package/src/warp/context.ts +0 -48
  265. package/src/warp/dead-symbols.ts +0 -174
  266. package/src/warp/drift-sentinel.ts +0 -101
  267. package/src/warp/index-head.ts +0 -348
  268. package/src/warp/observers.ts +0 -101
  269. package/src/warp/open.ts +0 -67
  270. package/src/warp/outline-diff-trailer.ts +0 -100
  271. package/src/warp/plumbing.d.ts +0 -24
  272. package/src/warp/refactor-difficulty.ts +0 -257
  273. package/src/warp/references.ts +0 -77
  274. package/src/warp/stale-docs.ts +0 -210
  275. package/src/warp/structural-drift-detection.ts +0 -97
  276. package/src/warp/structural-queries.ts +0 -258
  277. package/src/warp/symbol-timeline.ts +0 -209
  278. package/src/warp/traverse-hydrate.ts +0 -61
  279. package/src/warp/warp-reference-count.ts +0 -47
  280. package/src/warp/warp-structural-blame.ts +0 -65
  281. package/src/warp/warp-structural-churn.ts +0 -309
  282. package/src/warp/warp-structural-log.ts +0 -149
  283. package/src/warp/writer-id.ts +0 -30
@@ -1,172 +0,0 @@
1
- import * as fs from "node:fs/promises";
2
- import * as http from "node:http";
3
- import * as path from "node:path";
4
- import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
5
- import { nodeFs } from "../adapters/node-fs.js";
6
- import { nodeGit } from "../adapters/node-git.js";
7
- import { DaemonControlPlane, type DaemonStatusView } from "./daemon-control-plane.js";
8
- import { DaemonJobScheduler } from "./daemon-job-scheduler.js";
9
- import { ChildProcessDaemonWorkerPool } from "./daemon-worker-pool.js";
10
- import { PersistentMonitorRuntime } from "./persistent-monitor-runtime.js";
11
- import { InMemoryWarpPool } from "./warp-pool.js";
12
- import { openWarp } from "../warp/open.js";
13
- import type { RunCaptureConfig } from "./run-capture-config.js";
14
- import type { RuntimeObservabilityState } from "./runtime-observability.js";
15
- import {
16
- closeHttpServer,
17
- defaultDaemonRoot,
18
- ensurePrivateDirectory,
19
- isNamedPipePath,
20
- prepareSocketPath,
21
- resolveSocketPath,
22
- tightenSocketPermissions,
23
- } from "./daemon-bootstrap.js";
24
- import { createDaemonSessionHost } from "./daemon-session-host.js";
25
-
26
- const HEALTH_PATH = "/healthz";
27
- const MCP_PATH = "/mcp";
28
-
29
- export type DaemonHealthStatus = DaemonStatusView;
30
-
31
- export interface StartDaemonServerOptions {
32
- readonly socketPath?: string | undefined;
33
- readonly graftDir?: string | undefined;
34
- readonly env?: Readonly<Record<string, string | undefined>> | undefined;
35
- readonly runCapture?: Partial<RunCaptureConfig> | undefined;
36
- readonly runtimeObservability?: Partial<RuntimeObservabilityState> | undefined;
37
- readonly workerPoolSize?: number | undefined;
38
- readonly persistedLocalHistoryGraph?: boolean | undefined;
39
- }
40
-
41
- export interface GraftDaemonServer {
42
- readonly socketPath: string;
43
- readonly healthPath: typeof HEALTH_PATH;
44
- readonly mcpPath: typeof MCP_PATH;
45
- close(): Promise<void>;
46
- getHealthStatus(): DaemonHealthStatus;
47
- }
48
-
49
- export async function startDaemonServer(options: StartDaemonServerOptions = {}): Promise<GraftDaemonServer> {
50
- const graftDir = path.resolve(options.graftDir ?? defaultDaemonRoot());
51
- const socketPath = resolveSocketPath(options.socketPath, graftDir);
52
- const warpPool = new InMemoryWarpPool((cwd) => openWarp({ cwd }));
53
- const controlPlane = new DaemonControlPlane({
54
- fs: nodeFs,
55
- codec: new CanonicalJsonCodec(),
56
- git: nodeGit,
57
- graftDir,
58
- });
59
- const daemonScheduler = new DaemonJobScheduler();
60
- const daemonWorkerPool = new ChildProcessDaemonWorkerPool({
61
- ...(options.workerPoolSize !== undefined ? { size: options.workerPoolSize } : {}),
62
- });
63
- const monitorRuntime = new PersistentMonitorRuntime({
64
- fs: nodeFs,
65
- codec: new CanonicalJsonCodec(),
66
- git: nodeGit,
67
- graftDir,
68
- controlPlane,
69
- scheduler: daemonScheduler,
70
- workerPool: daemonWorkerPool,
71
- });
72
- const startedAt = new Date().toISOString();
73
- const transportKind = isNamedPipePath(socketPath) ? "named_pipe" : "unix_socket";
74
-
75
- const getHealthStatus = (): DaemonHealthStatus => {
76
- return controlPlane.getStatus({
77
- transport: transportKind,
78
- sameUserOnly: true,
79
- socketPath,
80
- mcpPath: MCP_PATH,
81
- healthPath: HEALTH_PATH,
82
- activeWarpRepos: warpPool.size(),
83
- startedAt,
84
- }, monitorRuntime.getCounts(), daemonScheduler.getCounts(), daemonWorkerPool.getCounts());
85
- };
86
-
87
- await ensurePrivateDirectory(graftDir);
88
- await ensurePrivateDirectory(path.join(graftDir, "sessions"));
89
- await controlPlane.initialize();
90
- await monitorRuntime.initialize();
91
- await prepareSocketPath(socketPath);
92
- const sessionHost = createDaemonSessionHost({
93
- graftDir,
94
- socketPath,
95
- transportKind,
96
- healthPath: HEALTH_PATH,
97
- mcpPath: MCP_PATH,
98
- startedAt,
99
- warpPool,
100
- controlPlane,
101
- daemonScheduler,
102
- daemonWorkerPool,
103
- monitorRuntime,
104
- getHealthStatus,
105
- ...(options.env !== undefined ? { env: options.env } : {}),
106
- ...(options.runCapture !== undefined ? { runCapture: options.runCapture } : {}),
107
- ...(options.runtimeObservability !== undefined
108
- ? { runtimeObservability: options.runtimeObservability }
109
- : {}),
110
- ...(options.persistedLocalHistoryGraph !== undefined
111
- ? { persistedLocalHistoryGraph: options.persistedLocalHistoryGraph }
112
- : {}),
113
- });
114
-
115
- const httpServer = http.createServer((req, res) => {
116
- void sessionHost.handleRequest(req, res);
117
- });
118
-
119
- await new Promise<void>((resolve, reject) => {
120
- const onError = (error: Error): void => {
121
- httpServer.off("listening", onListening);
122
- reject(error);
123
- };
124
- const onListening = (): void => {
125
- httpServer.off("error", onError);
126
- resolve();
127
- };
128
- httpServer.once("error", onError);
129
- httpServer.once("listening", onListening);
130
- httpServer.listen(socketPath);
131
- });
132
- await tightenSocketPermissions(socketPath);
133
-
134
- let closing: Promise<void> | null = null;
135
-
136
- const shutdown = (): void => {
137
- void daemon.close().finally(() => {
138
- process.exitCode = process.exitCode ?? 0;
139
- });
140
- };
141
-
142
- process.once("SIGINT", shutdown);
143
- process.once("SIGTERM", shutdown);
144
-
145
- const daemon: GraftDaemonServer = {
146
- socketPath,
147
- healthPath: HEALTH_PATH,
148
- mcpPath: MCP_PATH,
149
- getHealthStatus(): DaemonHealthStatus {
150
- return getHealthStatus();
151
- },
152
- async close(): Promise<void> {
153
- if (closing !== null) return closing;
154
- closing = (async () => {
155
- process.off("SIGINT", shutdown);
156
- process.off("SIGTERM", shutdown);
157
- await sessionHost.close();
158
- await monitorRuntime.close();
159
- await daemonWorkerPool.close();
160
- await closeHttpServer(httpServer);
161
- if (!isNamedPipePath(socketPath)) {
162
- await fs.unlink(socketPath).catch(() => {
163
- return undefined;
164
- });
165
- }
166
- })();
167
- return closing;
168
- },
169
- };
170
-
171
- return daemon;
172
- }
@@ -1,234 +0,0 @@
1
- import * as crypto from "node:crypto";
2
- import * as fs from "node:fs/promises";
3
- import * as http from "node:http";
4
- import * as path from "node:path";
5
- import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
6
- import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
7
- import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
8
- import { createGraftServer, type GraftServer } from "./server.js";
9
- import type { DaemonControlPlane, DaemonStatusView } from "./daemon-control-plane.js";
10
- import type { DaemonJobScheduler } from "./daemon-job-scheduler.js";
11
- import type { ChildProcessDaemonWorkerPool } from "./daemon-worker-pool.js";
12
- import type { PersistentMonitorRuntime } from "./persistent-monitor-runtime.js";
13
- import type { RunCaptureConfig } from "./run-capture-config.js";
14
- import type { RuntimeObservabilityState } from "./runtime-observability.js";
15
- import type { WarpPool } from "./warp-pool.js";
16
- import { ensurePrivateDirectory } from "./daemon-bootstrap.js";
17
-
18
- const MAX_BODY_BYTES = 1024 * 1024;
19
-
20
- interface DaemonSession {
21
- readonly id: string;
22
- readonly graftDir: string;
23
- readonly transport: StreamableHTTPServerTransport;
24
- readonly server: GraftServer;
25
- }
26
-
27
- export interface CreateDaemonSessionHostOptions {
28
- readonly graftDir: string;
29
- readonly socketPath: string;
30
- readonly transportKind: "unix_socket" | "named_pipe";
31
- readonly healthPath: string;
32
- readonly mcpPath: string;
33
- readonly startedAt: string;
34
- readonly warpPool: WarpPool;
35
- readonly controlPlane: DaemonControlPlane;
36
- readonly daemonScheduler: DaemonJobScheduler;
37
- readonly daemonWorkerPool: ChildProcessDaemonWorkerPool;
38
- readonly monitorRuntime: PersistentMonitorRuntime;
39
- readonly getHealthStatus: () => DaemonStatusView;
40
- readonly env?: Readonly<Record<string, string | undefined>> | undefined;
41
- readonly runCapture?: Partial<RunCaptureConfig> | undefined;
42
- readonly runtimeObservability?: Partial<RuntimeObservabilityState> | undefined;
43
- readonly persistedLocalHistoryGraph?: boolean | undefined;
44
- }
45
-
46
- export interface DaemonSessionHost {
47
- handleRequest(req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
48
- close(): Promise<void>;
49
- }
50
-
51
- function getHeader(req: http.IncomingMessage, name: string): string | undefined {
52
- const value = req.headers[name];
53
- return Array.isArray(value) ? value[0] : value;
54
- }
55
-
56
- async function readJsonBody(req: http.IncomingMessage): Promise<unknown> {
57
- const chunks: Buffer[] = [];
58
- let total = 0;
59
- for await (const chunk of req as AsyncIterable<Buffer | string>) {
60
- const buffer = typeof chunk === "string" ? Buffer.from(chunk, "utf-8") : chunk;
61
- total += buffer.length;
62
- if (total > MAX_BODY_BYTES) {
63
- throw new Error(`Request body exceeds ${String(MAX_BODY_BYTES)} bytes`);
64
- }
65
- chunks.push(buffer);
66
- }
67
- if (chunks.length === 0) return undefined;
68
- return JSON.parse(Buffer.concat(chunks).toString("utf-8")) as unknown;
69
- }
70
-
71
- function sendJson(res: http.ServerResponse, statusCode: number, body: Record<string, unknown>): void {
72
- if (res.headersSent) return;
73
- res.writeHead(statusCode, { "content-type": "application/json" });
74
- res.end(JSON.stringify(body));
75
- }
76
-
77
- function sendJsonRpcError(res: http.ServerResponse, code: number, message: string): void {
78
- sendJson(res, code === -32700 ? 400 : 500, {
79
- jsonrpc: "2.0",
80
- error: { code, message },
81
- id: null,
82
- });
83
- }
84
-
85
- async function removeSessionDirectory(sessionGraftDir: string): Promise<void> {
86
- try {
87
- await fs.rm(sessionGraftDir, { recursive: true, force: true });
88
- } catch (error: unknown) {
89
- const code = error instanceof Error && "code" in error ? (error as NodeJS.ErrnoException).code : undefined;
90
- if (code !== "ENOENT") {
91
- console.error(`[graft] failed to remove session directory ${sessionGraftDir}: ${String(error)}`);
92
- }
93
- }
94
- }
95
-
96
- async function createDaemonSession(
97
- newSessionId: string,
98
- options: CreateDaemonSessionHostOptions,
99
- sessions: Map<string, DaemonSession>,
100
- ): Promise<DaemonSession> {
101
- const sessionGraftDir = path.join(options.graftDir, "sessions", newSessionId);
102
- await ensurePrivateDirectory(sessionGraftDir);
103
- const transport = new StreamableHTTPServerTransport({
104
- sessionIdGenerator: () => newSessionId,
105
- });
106
- const server = createGraftServer({
107
- mode: "daemon",
108
- sessionId: newSessionId,
109
- graftDir: sessionGraftDir,
110
- warpPool: options.warpPool,
111
- daemonControlPlane: options.controlPlane,
112
- daemonScheduler: options.daemonScheduler,
113
- daemonWorkerPool: options.daemonWorkerPool,
114
- daemonRuntime: () => ({
115
- transport: options.transportKind,
116
- sameUserOnly: true,
117
- socketPath: options.socketPath,
118
- mcpPath: options.mcpPath,
119
- healthPath: options.healthPath,
120
- activeWarpRepos: options.warpPool.size(),
121
- startedAt: options.startedAt,
122
- }),
123
- monitorRuntime: options.monitorRuntime,
124
- ...(options.env !== undefined ? { env: options.env } : {}),
125
- ...(options.runCapture !== undefined ? { runCapture: options.runCapture } : {}),
126
- ...(options.runtimeObservability !== undefined
127
- ? { runtimeObservability: options.runtimeObservability }
128
- : {}),
129
- ...(options.persistedLocalHistoryGraph !== undefined
130
- ? { persistedLocalHistoryGraph: options.persistedLocalHistoryGraph }
131
- : {}),
132
- });
133
- const session: DaemonSession = {
134
- id: newSessionId,
135
- graftDir: sessionGraftDir,
136
- transport,
137
- server,
138
- };
139
- transport.onclose = () => {
140
- sessions.delete(newSessionId);
141
- options.controlPlane.unregisterTransport(newSessionId);
142
- void removeSessionDirectory(sessionGraftDir);
143
- };
144
- transport.onerror = () => {
145
- sessions.delete(newSessionId);
146
- options.controlPlane.unregisterTransport(newSessionId);
147
- void removeSessionDirectory(sessionGraftDir);
148
- };
149
- sessions.set(newSessionId, session);
150
- options.controlPlane.registerTransport(
151
- newSessionId,
152
- () => server.getWorkspaceStatus(),
153
- () => server.getRuntimeCausalContext(),
154
- );
155
- await server.getMcpServer().connect(transport as Transport);
156
- return session;
157
- }
158
-
159
- export function createDaemonSessionHost(options: CreateDaemonSessionHostOptions): DaemonSessionHost {
160
- const sessions = new Map<string, DaemonSession>();
161
-
162
- return {
163
- async handleRequest(req, res): Promise<void> {
164
- try {
165
- const url = new URL(req.url ?? "/", "http://localhost");
166
- if (req.method === "GET" && url.pathname === options.healthPath) {
167
- sendJson(res, 200, { ...options.getHealthStatus() });
168
- return;
169
- }
170
-
171
- if (url.pathname !== options.mcpPath) {
172
- sendJson(res, 404, { error: "Not found" });
173
- return;
174
- }
175
-
176
- const sessionId = getHeader(req, "mcp-session-id");
177
-
178
- if (req.method === "POST") {
179
- const parsedBody = await readJsonBody(req);
180
- let session = sessionId !== undefined ? sessions.get(sessionId) : undefined;
181
- if (session === undefined) {
182
- if (sessionId !== undefined) {
183
- sendJsonRpcError(res, -32000, `Unknown MCP session: ${sessionId}`);
184
- return;
185
- }
186
- if (!isInitializeRequest(parsedBody)) {
187
- sendJsonRpcError(res, -32000, "Initialization requests must start a daemon session");
188
- return;
189
- }
190
- session = await createDaemonSession(crypto.randomUUID(), options, sessions);
191
- }
192
-
193
- options.controlPlane.touchTransport(session.id);
194
- await session.transport.handleRequest(req, res, parsedBody);
195
- return;
196
- }
197
-
198
- if (req.method === "GET" || req.method === "DELETE") {
199
- if (sessionId === undefined) {
200
- sendJson(res, 400, { error: "Missing MCP session header" });
201
- return;
202
- }
203
- const session = sessions.get(sessionId);
204
- if (session === undefined) {
205
- sendJson(res, 404, { error: `Unknown MCP session: ${sessionId}` });
206
- return;
207
- }
208
- options.controlPlane.touchTransport(session.id);
209
- await session.transport.handleRequest(req, res);
210
- return;
211
- }
212
-
213
- sendJson(res, 405, { error: "Method not allowed" });
214
- } catch (error) {
215
- if (error instanceof SyntaxError) {
216
- sendJsonRpcError(res, -32700, "Invalid JSON");
217
- return;
218
- }
219
- sendJsonRpcError(res, -32603, error instanceof Error ? error.message : String(error));
220
- }
221
- },
222
-
223
- async close(): Promise<void> {
224
- for (const session of [...sessions.values()]) {
225
- options.controlPlane.unregisterTransport(session.id);
226
- await session.transport.close().catch(() => {
227
- return undefined;
228
- });
229
- await removeSessionDirectory(session.graftDir);
230
- }
231
- sessions.clear();
232
- },
233
- };
234
- }
@@ -1,262 +0,0 @@
1
- import * as http from "node:http";
2
- import { spawn, type ChildProcess } from "node:child_process";
3
- import { fileURLToPath } from "node:url";
4
- import { dirname, resolve } from "node:path";
5
- import { Readable } from "node:stream";
6
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
7
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
8
- import {
9
- isInitializeRequest,
10
- isJSONRPCRequest,
11
- type JSONRPCMessage,
12
- type JSONRPCRequest,
13
- } from "@modelcontextprotocol/sdk/types.js";
14
- import { defaultDaemonRoot, resolveSocketPath } from "./daemon-bootstrap.js";
15
-
16
- const DEFAULT_READY_TIMEOUT_MS = 5_000;
17
- const DEFAULT_POLL_INTERVAL_MS = 100;
18
- const MCP_PATH = "/mcp";
19
- const HEALTH_PATH = "/healthz";
20
-
21
- function toNodeHeaders(headers: Headers): http.OutgoingHttpHeaders {
22
- const outgoing: http.OutgoingHttpHeaders = {};
23
- for (const [name, value] of headers.entries()) {
24
- outgoing[name] = value;
25
- }
26
- return outgoing;
27
- }
28
-
29
- function toResponseHeaders(headers: http.IncomingHttpHeaders): Headers {
30
- const responseHeaders = new Headers();
31
- for (const [name, value] of Object.entries(headers)) {
32
- if (value === undefined) continue;
33
- if (Array.isArray(value)) {
34
- for (const item of value) {
35
- responseHeaders.append(name, item);
36
- }
37
- continue;
38
- }
39
- responseHeaders.append(name, value);
40
- }
41
- return responseHeaders;
42
- }
43
-
44
- export function createLocalSocketFetch(socketPath: string): typeof fetch {
45
- return async (input: string | URL | Request, init?: RequestInit): Promise<Response> => {
46
- const request = input instanceof Request ? input : new Request(input, init);
47
- const url = new URL(request.url);
48
- const body = request.body === null ? undefined : Buffer.from(await request.arrayBuffer());
49
-
50
- return await new Promise<Response>((resolvePromise, reject) => {
51
- const req = http.request({
52
- socketPath,
53
- path: `${url.pathname}${url.search}`,
54
- method: request.method,
55
- headers: toNodeHeaders(request.headers),
56
- signal: request.signal,
57
- }, (res) => {
58
- const bodyStream = Readable.toWeb(res) as ReadableStream<Uint8Array>;
59
- resolvePromise(new Response(bodyStream, {
60
- status: res.statusCode ?? 0,
61
- statusText: res.statusMessage ?? "",
62
- headers: toResponseHeaders(res.headers),
63
- }));
64
- });
65
- req.once("error", reject);
66
- if (body !== undefined && body.byteLength > 0) {
67
- req.write(body);
68
- }
69
- req.end();
70
- });
71
- };
72
- }
73
-
74
- async function isDaemonHealthy(socketPath: string): Promise<boolean> {
75
- try {
76
- const response = await createLocalSocketFetch(socketPath)(
77
- new URL(`http://graft${HEALTH_PATH}`),
78
- {
79
- method: "GET",
80
- headers: {
81
- accept: "application/json",
82
- },
83
- },
84
- );
85
- await response.arrayBuffer();
86
- return response.ok;
87
- } catch {
88
- return false;
89
- }
90
- }
91
-
92
- function resolveGraftBinPath(): string {
93
- return resolve(dirname(fileURLToPath(import.meta.url)), "../../bin/graft.js");
94
- }
95
-
96
- function spawnDaemonProcess(socketPath: string): ChildProcess {
97
- const child = spawn(
98
- process.execPath,
99
- [resolveGraftBinPath(), "daemon", "--socket", socketPath],
100
- {
101
- detached: true,
102
- stdio: ["ignore", "ignore", "ignore"],
103
- windowsHide: true,
104
- env: { ...process.env },
105
- },
106
- );
107
- child.unref();
108
- return child;
109
- }
110
-
111
- function delay(ms: number): Promise<void> {
112
- return new Promise((resolvePromise) => {
113
- setTimeout(resolvePromise, ms);
114
- });
115
- }
116
-
117
- export interface EnsureDaemonReadyOptions {
118
- socketPath?: string;
119
- timeoutMs?: number;
120
- pollIntervalMs?: number;
121
- spawnIfMissing?: boolean;
122
- spawnDaemon?: ((socketPath: string) => ChildProcess | undefined) | undefined;
123
- healthCheck?: ((socketPath: string) => Promise<boolean>) | undefined;
124
- }
125
-
126
- export async function ensureDaemonReady(options: EnsureDaemonReadyOptions = {}): Promise<string> {
127
- const socketPath = resolveSocketPath(options.socketPath, defaultDaemonRoot());
128
- const timeoutMs = options.timeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
129
- const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
130
- const healthCheck = options.healthCheck ?? isDaemonHealthy;
131
-
132
- if (await healthCheck(socketPath)) {
133
- return socketPath;
134
- }
135
-
136
- if (options.spawnIfMissing === false) {
137
- throw new Error(
138
- `No graft daemon is listening on ${socketPath}. Start it with \`graft daemon --socket ${socketPath}\` or use repo-local \`graft serve\`.`,
139
- );
140
- }
141
-
142
- let spawnError: unknown;
143
- try {
144
- (options.spawnDaemon ?? spawnDaemonProcess)(socketPath);
145
- } catch (error) {
146
- spawnError = error;
147
- }
148
-
149
- const deadline = Date.now() + timeoutMs;
150
- while (Date.now() <= deadline) {
151
- if (await healthCheck(socketPath)) {
152
- return socketPath;
153
- }
154
- await delay(pollIntervalMs);
155
- }
156
-
157
- const suffix = spawnError instanceof Error
158
- ? ` Auto-start failed: ${spawnError.message}`
159
- : "";
160
- throw new Error(`Timed out waiting for graft daemon readiness on ${socketPath}.${suffix}`);
161
- }
162
-
163
- function internalErrorResponse(
164
- message: JSONRPCRequest,
165
- error: unknown,
166
- ): JSONRPCMessage {
167
- return {
168
- jsonrpc: "2.0",
169
- id: message.id,
170
- error: {
171
- code: -32603,
172
- message: error instanceof Error ? error.message : String(error),
173
- },
174
- };
175
- }
176
-
177
- export interface StartDaemonBackedStdioBridgeOptions {
178
- socketPath?: string;
179
- spawnIfMissing?: boolean;
180
- ensureReady?: ((options?: EnsureDaemonReadyOptions) => Promise<string>) | undefined;
181
- }
182
-
183
- export async function startDaemonBackedStdioBridge(
184
- options: StartDaemonBackedStdioBridgeOptions = {},
185
- ): Promise<void> {
186
- const socketPath = await (options.ensureReady ?? ensureDaemonReady)({
187
- ...(options.socketPath !== undefined ? { socketPath: options.socketPath } : {}),
188
- ...(options.spawnIfMissing !== undefined ? { spawnIfMissing: options.spawnIfMissing } : {}),
189
- });
190
- const stdioTransport = new StdioServerTransport();
191
- const daemonTransport = new StreamableHTTPClientTransport(
192
- new URL(`http://graft${MCP_PATH}`),
193
- { fetch: createLocalSocketFetch(socketPath) },
194
- );
195
-
196
- let closed = false;
197
- const close = async (): Promise<void> => {
198
- if (closed) return;
199
- closed = true;
200
- process.stdin.off("end", onStdinEnd);
201
- process.stdin.off("close", onStdinEnd);
202
- process.off("SIGINT", onSignal);
203
- process.off("SIGTERM", onSignal);
204
- await daemonTransport.terminateSession().catch(() => {
205
- return undefined;
206
- });
207
- await daemonTransport.close().catch(() => {
208
- return undefined;
209
- });
210
- await stdioTransport.close().catch(() => {
211
- return undefined;
212
- });
213
- };
214
-
215
- const onSignal = (): void => {
216
- void close().finally(() => {
217
- process.exitCode = process.exitCode ?? 0;
218
- });
219
- };
220
- const onStdinEnd = (): void => {
221
- void close();
222
- };
223
-
224
- stdioTransport.onmessage = (message): void => {
225
- if (isInitializeRequest(message)) {
226
- daemonTransport.setProtocolVersion(message.params.protocolVersion);
227
- }
228
- void daemonTransport.send(message).catch(async (error: unknown) => {
229
- if (!isJSONRPCRequest(message)) {
230
- console.error(error);
231
- return;
232
- }
233
- await stdioTransport.send(internalErrorResponse(message, error)).catch(() => {
234
- return undefined;
235
- });
236
- });
237
- };
238
- stdioTransport.onerror = (error): void => {
239
- console.error(error);
240
- void close();
241
- };
242
- daemonTransport.onmessage = (message): void => {
243
- void stdioTransport.send(message).catch((error: unknown) => {
244
- console.error(error);
245
- void close();
246
- });
247
- };
248
- daemonTransport.onerror = (error): void => {
249
- console.error(error);
250
- };
251
- daemonTransport.onclose = (): void => {
252
- void close();
253
- };
254
-
255
- process.stdin.on("end", onStdinEnd);
256
- process.stdin.on("close", onStdinEnd);
257
- process.once("SIGINT", onSignal);
258
- process.once("SIGTERM", onSignal);
259
-
260
- await daemonTransport.start();
261
- await stdioTransport.start();
262
- }