@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,42 +0,0 @@
1
- import { z } from "zod";
2
- import { toJsonObject } from "../../operations/result-dto.js";
3
- import { refactorDifficultyFromGraph } from "../../warp/refactor-difficulty.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const refactorDifficultyTool: ToolDefinition = {
7
- name: "graft_difficulty",
8
- description:
9
- "Refactor difficulty score for a symbol. Combines WARP aggregate " +
10
- "churn curvature with WARP reference-edge friction so agents can " +
11
- "choose refactor vs workaround.",
12
- schema: {
13
- symbol: z.string(),
14
- path: z.string().optional(),
15
- limit: z.number().int().positive().optional(),
16
- },
17
- createHandler(): ToolHandler {
18
- return async (args, ctx) => {
19
- const symbol = args["symbol"];
20
- const rawPath = args["path"];
21
- const rawLimit = args["limit"];
22
-
23
- if (typeof symbol !== "string" || symbol.trim().length === 0) {
24
- throw new Error("graft_difficulty: symbol must be a non-empty string");
25
- }
26
-
27
- const warp = await ctx.getWarp();
28
- const result = await refactorDifficultyFromGraph(warp, {
29
- symbol,
30
- ...(typeof rawPath === "string" ? { path: rawPath } : {}),
31
- ...(typeof rawLimit === "number" ? { limit: rawLimit } : {}),
32
- });
33
-
34
- ctx.recordFootprint({
35
- symbols: [symbol.trim()],
36
- paths: result.entries.map((entry) => entry.filePath),
37
- });
38
-
39
- return ctx.respond("graft_difficulty", toJsonObject(result));
40
- };
41
- },
42
- };
@@ -1,149 +0,0 @@
1
- import * as path from "node:path";
2
- import { z } from "zod";
3
- import type { ToolDefinition, ToolContext, ToolHandler } from "../context.js";
4
-
5
- const RUN_CAPTURE_POLICY_BOUNDARY = {
6
- kind: "shell_escape_hatch",
7
- boundedReadContract: false,
8
- policyEnforced: false,
9
- } as const;
10
-
11
- const PRIVATE_KEY_BLOCK_RE = /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g;
12
- const SECRET_ASSIGNMENT_RE = /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|bearer|token|secret|password|passwd|private[_-]?key|client[_-]?secret|session[_-]?key)\b\s*[:=]\s*)([^\r\n]+)/gi;
13
- const BEARER_TOKEN_RE = /(\bbearer\s+)([A-Za-z0-9._~+/=-]{8,})/gi;
14
-
15
- function tailOutput(output: string, tail: number): {
16
- readonly tailed: string;
17
- readonly totalLines: number;
18
- } {
19
- const lines = output.split("\n");
20
- return {
21
- tailed: lines.slice(-tail).join("\n"),
22
- totalLines: lines.length,
23
- };
24
- }
25
-
26
- function renderCaptureError(result: {
27
- readonly status: number | null;
28
- readonly stderr: string;
29
- readonly error?: Error;
30
- }): string {
31
- if (result.error !== undefined) {
32
- return result.error.message;
33
- }
34
- const stderr = result.stderr.trim();
35
- if (stderr.length > 0) {
36
- return stderr;
37
- }
38
- return `Command exited with status ${String(result.status)}`;
39
- }
40
-
41
- function redactForLog(output: string): {
42
- readonly value: string;
43
- readonly redactions: number;
44
- } {
45
- let redactions = 0;
46
- let value = output.replace(PRIVATE_KEY_BLOCK_RE, () => {
47
- redactions++;
48
- return "[REDACTED PRIVATE KEY BLOCK]";
49
- });
50
- value = value.replace(SECRET_ASSIGNMENT_RE, (_match, prefix: string) => {
51
- redactions++;
52
- return `${prefix}[REDACTED]`;
53
- });
54
- value = value.replace(BEARER_TOKEN_RE, (_match, prefix: string) => {
55
- redactions++;
56
- return `${prefix}[REDACTED]`;
57
- });
58
- return { value, redactions };
59
- }
60
-
61
- async function persistCaptureLog(ctx: ToolContext, output: string): Promise<{
62
- readonly logPath: string | null;
63
- readonly logRedactions: number;
64
- }> {
65
- if (!ctx.runCapture.persistLogs) {
66
- return { logPath: null, logRedactions: 0 };
67
- }
68
-
69
- const logPath = path.join(ctx.graftDir, "logs", "capture.log");
70
- const persisted = ctx.runCapture.redactLogs ? redactForLog(output) : { value: output, redactions: 0 };
71
-
72
- try {
73
- await ctx.fs.mkdir(path.dirname(logPath), { recursive: true });
74
- await ctx.fs.writeFile(logPath, persisted.value, "utf-8");
75
- return {
76
- logPath,
77
- logRedactions: persisted.redactions,
78
- };
79
- } catch {
80
- return { logPath: null, logRedactions: 0 };
81
- }
82
- }
83
-
84
- export const runCaptureTool: ToolDefinition = {
85
- name: "run_capture",
86
- description:
87
- "Execute a shell command and return the last N lines of output " +
88
- "(default 60). Responses include an explicit policy boundary. " +
89
- "Persisted logs can be disabled and obvious secrets are redacted " +
90
- "before writing to .graft/logs/capture.log.",
91
- schema: { command: z.string(), tail: z.number().optional() },
92
- createHandler(): ToolHandler {
93
- return async (args, ctx) => {
94
- const command = args["command"] as string;
95
- const tail = Math.max(1, Math.floor((args["tail"] as number | undefined) ?? 60));
96
- if (!ctx.runCapture.enabled) {
97
- return ctx.respond("run_capture", {
98
- output: "",
99
- totalLines: 0,
100
- tailedLines: 0,
101
- logPath: null,
102
- logRedactions: 0,
103
- logPersistenceEnabled: false,
104
- truncated: false,
105
- disabled: true,
106
- error: "run_capture is disabled by configuration",
107
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
108
- });
109
- }
110
- const result = ctx.process.run({
111
- command: "sh",
112
- args: ["-c", command],
113
- cwd: ctx.projectRoot,
114
- timeoutMs: 30000,
115
- maxBufferBytes: 10 * 1024 * 1024,
116
- });
117
-
118
- if (result.error !== undefined || result.status !== 0) {
119
- const tailedOutput = tailOutput(result.stdout, tail);
120
- return ctx.respond("run_capture", {
121
- error: renderCaptureError(result),
122
- output: tailedOutput.tailed,
123
- totalLines: tailedOutput.totalLines,
124
- tailedLines: Math.min(tail, tailedOutput.totalLines),
125
- logPath: null,
126
- logRedactions: 0,
127
- logPersistenceEnabled: ctx.runCapture.persistLogs,
128
- truncated: tailedOutput.totalLines > tail,
129
- stderr: result.stderr.slice(0, 2000),
130
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
131
- });
132
- }
133
-
134
- const output = result.stdout;
135
- const tailedOutput = tailOutput(output, tail);
136
- const persisted = await persistCaptureLog(ctx, output);
137
- return ctx.respond("run_capture", {
138
- output: tailedOutput.tailed,
139
- totalLines: tailedOutput.totalLines,
140
- tailedLines: Math.min(tail, tailedOutput.totalLines),
141
- logPath: persisted.logPath,
142
- logRedactions: persisted.logRedactions,
143
- logPersistenceEnabled: ctx.runCapture.persistLogs,
144
- truncated: tailedOutput.totalLines > tail,
145
- policyBoundary: RUN_CAPTURE_POLICY_BOUNDARY,
146
- });
147
- };
148
- },
149
- };
@@ -1,148 +0,0 @@
1
- import { z } from "zod";
2
- import { safeRead, type SafeReadResult } from "../../operations/safe-read.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import { RefusedResult } from "../../policy/types.js";
5
- import { diffOutlines } from "../../parser/diff.js";
6
- import { CachedFile } from "../cached-file.js";
7
- import type { Metrics } from "../metrics.js";
8
- import { evaluateMcpPolicy } from "../policy.js";
9
- import { toRepoPolicyPath } from "../../adapters/repo-paths.js";
10
- import type { ToolDefinition, ToolHandler } from "../context.js";
11
-
12
- const PROJECTION_METRICS: Readonly<Record<string, ((m: Metrics) => void) | undefined>> = {
13
- content: (m) => { m.recordRead(); },
14
- outline: (m) => { m.recordOutline(); },
15
- refused: (m) => { m.recordRefusal(); },
16
- };
17
-
18
- const CACHEABLE_PROJECTIONS: ReadonlySet<SafeReadResult["projection"]> = new Set(["content", "outline"]);
19
-
20
- export const safeReadTool: ToolDefinition = {
21
- name: "safe_read",
22
- description:
23
- "Policy-enforced file read. Returns full content for small files, " +
24
- "structural outline with jump table for large files, or refusal with " +
25
- "reason code for banned files. Detects re-reads and returns cached " +
26
- "outlines or structural diffs.",
27
- schema: { path: z.string(), intent: z.string().optional() },
28
- createHandler(): ToolHandler {
29
- return async (args, ctx) => {
30
- const filePath = ctx.resolvePath(args["path"] as string);
31
- ctx.recordFootprint({ paths: [filePath] });
32
-
33
- // Build CachedFile once — all consumers share the same snapshot,
34
- // eliminating TOCTOU races where the file changes between reads.
35
- let cf: CachedFile | null = null;
36
- try {
37
- const rawContent = await ctx.fs.readFile(filePath, "utf-8");
38
- cf = new CachedFile(filePath, rawContent);
39
- } catch {
40
- // File doesn't exist or can't be read — proceed to safeRead for error handling
41
- }
42
-
43
- // Check cache if we could read the file
44
- if (cf?.supportsOutline === true) {
45
- const cacheResult = ctx.cache.check(filePath, cf.rawContent);
46
- if (cacheResult.hit) {
47
- // Defense: re-check policy before returning cached data.
48
- const policy = evaluateMcpPolicy(ctx, filePath, cf.actual);
49
- if (policy instanceof RefusedResult) {
50
- ctx.metrics.recordRefusal();
51
- return ctx.respond("safe_read", {
52
- path: filePath,
53
- projection: "refused",
54
- reason: policy.reason,
55
- reasonDetail: policy.reasonDetail,
56
- next: [...policy.next],
57
- actual: cf.actual,
58
- });
59
- }
60
-
61
- cacheResult.obs.touch(ctx.cache.now());
62
- ctx.metrics.recordCacheHit(cf.actual.bytes);
63
- ctx.recordFootprint({
64
- symbols: cacheResult.obs.outline.map((e) => e.name),
65
- });
66
- return ctx.respond("safe_read", {
67
- path: filePath,
68
- projection: "cache_hit",
69
- reason: "REREAD_UNCHANGED",
70
- outline: cacheResult.obs.outline,
71
- jumpTable: cacheResult.obs.jumpTable,
72
- actual: cf.actual,
73
- readCount: cacheResult.obs.readCount,
74
- estimatedBytesAvoided: cf.actual.bytes,
75
- lastReadAt: cacheResult.obs.lastReadAt,
76
- });
77
- }
78
-
79
- // File changed since last observation — compute structural diff
80
- if (cacheResult.stale !== null) {
81
- // Defense: re-check policy before returning structural data.
82
- const policy = evaluateMcpPolicy(ctx, filePath, cf.actual);
83
- if (policy instanceof RefusedResult) {
84
- ctx.metrics.recordRefusal();
85
- return ctx.respond("safe_read", {
86
- path: filePath,
87
- projection: "refused",
88
- reason: policy.reason,
89
- reasonDetail: policy.reasonDetail,
90
- next: [...policy.next],
91
- actual: cf.actual,
92
- });
93
- }
94
-
95
- const diff = diffOutlines(cacheResult.stale.outline, cf.outline);
96
- const newReadCount = cacheResult.stale.readCount + 1;
97
- ctx.cache.record(filePath, cf.hash, cf.outline, cf.jumpTable, cf.actual);
98
- ctx.recordFootprint({
99
- symbols: cf.outline.map((e) => e.name),
100
- });
101
- const updatedObs = ctx.cache.get(filePath);
102
- return ctx.respond("safe_read", {
103
- path: filePath,
104
- projection: "diff",
105
- reason: "CHANGED_SINCE_LAST_READ",
106
- diff,
107
- outline: cf.outline,
108
- jumpTable: cf.jumpTable,
109
- actual: cf.actual,
110
- readCount: newReadCount,
111
- lastReadAt: updatedObs?.lastReadAt ?? ctx.cache.now(),
112
- });
113
- }
114
- }
115
-
116
- // First read — pass rawContent to avoid double-read (TOCTOU)
117
- const result = await safeRead(filePath, {
118
- fs: ctx.fs,
119
- codec: ctx.codec,
120
- content: cf?.rawContent,
121
- intent: args["intent"] as string | undefined,
122
- policyPath: toRepoPolicyPath(ctx.projectRoot, filePath),
123
- graftignorePatterns: [...ctx.graftignorePatterns],
124
- sessionDepth: ctx.governor.getGovernorDepth(),
125
- budgetRemaining: ctx.governor.getBudget()?.remaining,
126
- });
127
-
128
- PROJECTION_METRICS[result.projection]?.(ctx.metrics);
129
- if (result.outline !== undefined) {
130
- ctx.recordFootprint({ symbols: result.outline.map((e) => e.name) });
131
- }
132
-
133
- // Record observation for cacheable projections — uses CachedFile
134
- // outline (no re-read) to eliminate the snapshot race.
135
- if (
136
- cf !== null &&
137
- cf.supportsOutline &&
138
- result.actual !== undefined &&
139
- CACHEABLE_PROJECTIONS.has(result.projection) &&
140
- result.reason !== "UNSUPPORTED_LANGUAGE"
141
- ) {
142
- ctx.cache.record(filePath, cf.hash, cf.outline, cf.jumpTable, result.actual);
143
- }
144
-
145
- return ctx.respond("safe_read", toJsonObject(result));
146
- };
147
- },
148
- };
@@ -1,53 +0,0 @@
1
- import { z } from "zod";
2
- import { graftDiff } from "../../operations/graft-diff.js";
3
- import type { ToolDefinition, ToolHandler } from "../context.js";
4
- import { evaluateMcpRefusal } from "../policy.js";
5
-
6
- export const sinceTool: ToolDefinition = {
7
- name: "graft_since",
8
- description:
9
- "Structural changes since a git ref. Shows symbols added, removed, " +
10
- "and changed per file — not line hunks. Includes per-file summary " +
11
- "lines for quick triage. Defaults to HEAD as the comparison target.",
12
- schema: {
13
- base: z.string(),
14
- head: z.string().optional(),
15
- },
16
- createHandler(): ToolHandler {
17
- return async (args, ctx) => {
18
- const base = args["base"] as string;
19
- const head = (args["head"] as string | undefined) ?? "HEAD";
20
-
21
- const result = await graftDiff({
22
- cwd: ctx.projectRoot,
23
- fs: ctx.fs,
24
- git: ctx.git,
25
- resolveWorkingTreePath: (filePath) => ctx.resolvePath(filePath),
26
- base,
27
- head,
28
- refusalCheck: (filePath, actual) => evaluateMcpRefusal(ctx, filePath, actual),
29
- });
30
-
31
- // Aggregate symbol-level changes across all files
32
- let totalAdded = 0;
33
- let totalRemoved = 0;
34
- let totalChanged = 0;
35
-
36
- for (const file of result.files) {
37
- totalAdded += file.diff.added.length;
38
- totalRemoved += file.diff.removed.length;
39
- totalChanged += file.diff.changed.length;
40
- }
41
-
42
- ctx.recordFootprint({
43
- paths: result.files.map((f) => f.path),
44
- });
45
-
46
- return ctx.respond("graft_since", {
47
- ...result,
48
- summary: `+${String(totalAdded)} added, -${String(totalRemoved)} removed, ~${String(totalChanged)} changed across ${String(result.files.length)} files`,
49
- layer: "ref_view",
50
- });
51
- };
52
- },
53
- };
@@ -1,39 +0,0 @@
1
- import * as path from "node:path";
2
- import { z } from "zod";
3
- import { STATE_FILENAME, stateSave, stateLoad } from "../../operations/state.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
- import { toJsonObject } from "../../operations/result-dto.js";
6
-
7
- export const stateSaveTool: ToolDefinition = {
8
- name: "state_save",
9
- description:
10
- "Save session working state (max 8 KB). Use for session bookmarks: " +
11
- "current task, files modified, next planned actions.",
12
- schema: { content: z.string() },
13
- createHandler(): ToolHandler {
14
- return async (args, ctx) => {
15
- const result = await stateSave(args["content"] as string, {
16
- stateDir: ctx.graftDir,
17
- statePath: path.join(ctx.graftDir, STATE_FILENAME),
18
- fs: ctx.fs,
19
- });
20
- return ctx.respond("state_save", toJsonObject(result));
21
- };
22
- },
23
- };
24
-
25
- export const stateLoadTool: ToolDefinition = {
26
- name: "state_load",
27
- description:
28
- "Load previously saved session state. Returns null if no state has " +
29
- "been saved.",
30
- createHandler(): ToolHandler {
31
- return async (_args, ctx) => {
32
- const result = await stateLoad({
33
- statePath: path.join(ctx.graftDir, STATE_FILENAME),
34
- fs: ctx.fs,
35
- });
36
- return ctx.respond("state_load", toJsonObject(result));
37
- };
38
- },
39
- };
@@ -1,24 +0,0 @@
1
- import { totalNonReadBytesReturned } from "../burden.js";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const statsTool: ToolDefinition = {
5
- name: "stats",
6
- description:
7
- "Decision metrics for the current session. Total reads, outlines, " +
8
- "refusals, cache hits, bytes avoided, and burden by tool kind.",
9
- createHandler(): ToolHandler {
10
- return (_args, ctx) => {
11
- const snap = ctx.metrics.snapshot();
12
- return ctx.respond("stats", {
13
- totalReads: snap.reads,
14
- totalOutlines: snap.outlines,
15
- totalRefusals: snap.refusals,
16
- totalCacheHits: snap.cacheHits,
17
- totalBytesReturned: snap.bytesReturned,
18
- totalBytesAvoidedByCache: snap.bytesAvoided,
19
- totalNonReadBytesReturned: totalNonReadBytesReturned(snap.burdenByKind),
20
- burdenByKind: snap.burdenByKind,
21
- });
22
- };
23
- },
24
- };
@@ -1,55 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
- import { structuralBlameFromGraph } from "../../warp/warp-structural-blame.js";
4
- import { toJsonObject } from "../../operations/result-dto.js";
5
-
6
- export const structuralBlameTool: ToolDefinition = {
7
- name: "graft_blame",
8
- description:
9
- "Symbol-level blame: who last changed a symbol's signature, when " +
10
- "it was created, and its full change history. Returns creation " +
11
- "commit, last signature change, change count, reference count, " +
12
- "and chronological history.",
13
- schema: {
14
- symbol: z.string(),
15
- path: z.string().optional(),
16
- },
17
- createHandler(): ToolHandler {
18
- return async (args, ctx) => {
19
- const symbol = args["symbol"];
20
- const rawPath = args["path"];
21
-
22
- if (typeof symbol !== "string" || symbol.trim().length === 0) {
23
- throw new Error("graft_blame: symbol must be a non-empty string");
24
- }
25
-
26
- const symbolName = symbol.trim();
27
- const filePath = typeof rawPath === "string" ? rawPath : undefined;
28
- const warp = await ctx.getWarp();
29
-
30
- const blame = await structuralBlameFromGraph(
31
- warp,
32
- symbolName,
33
- filePath ?? "",
34
- );
35
-
36
- ctx.recordFootprint({ symbols: [symbolName] });
37
-
38
- return ctx.respond("graft_blame", toJsonObject({
39
- symbol: blame.symbol,
40
- filePath: blame.filePath,
41
- changeCount: blame.changeCount,
42
- createdInCommit: blame.createdInCommit ?? null,
43
- lastSignatureChange: blame.lastSignatureChange ?? null,
44
- referenceCount: blame.referenceCount,
45
- history: blame.history.map((v) => ({
46
- sha: v.sha,
47
- tick: v.tick,
48
- changeKind: v.changeKind,
49
- present: v.present,
50
- signature: v.signature ?? null,
51
- })),
52
- }));
53
- };
54
- },
55
- };
@@ -1,28 +0,0 @@
1
- import { z } from "zod";
2
- import { toJsonObject } from "../../operations/result-dto.js";
3
- import { structuralChurnFromGraph } from "../../warp/warp-structural-churn.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const structuralChurnTool: ToolDefinition = {
7
- name: "graft_churn",
8
- description:
9
- "Structural churn report — which symbols change most frequently? " +
10
- "Identifies maintenance hotspots by walking indexed commits and " +
11
- "counting per-symbol change frequency.",
12
- schema: {
13
- path: z.string().optional(),
14
- limit: z.number().int().positive().optional(),
15
- },
16
- createHandler(): ToolHandler {
17
- return async (args, ctx) => {
18
- const warp = await ctx.getWarp();
19
- const options: { path?: string; limit?: number } = {};
20
- const pathArg = args["path"];
21
- const limitArg = args["limit"];
22
- if (typeof pathArg === "string") options.path = pathArg;
23
- if (typeof limitArg === "number") options.limit = limitArg;
24
- const result = await structuralChurnFromGraph(warp, options);
25
- return ctx.respond("graft_churn", toJsonObject(result));
26
- };
27
- },
28
- };
@@ -1,41 +0,0 @@
1
- import { z } from "zod";
2
- import { structuralLogFromGraph } from "../../warp/warp-structural-log.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import type { ToolDefinition, ToolHandler } from "../context.js";
5
-
6
- export const structuralLogTool: ToolDefinition = {
7
- name: "graft_log",
8
- description:
9
- "Structural git log — shows symbol-level changes (added, removed, " +
10
- "changed) per commit. Like `git log` but for code structure, not lines.",
11
- schema: {
12
- path: z.string().optional(),
13
- limit: z.number().optional(),
14
- },
15
- createHandler(): ToolHandler {
16
- return async (args, ctx) => {
17
- const filePath = args["path"] as string | undefined;
18
- const limit = args["limit"] as number | undefined;
19
- const warp = await ctx.getWarp();
20
-
21
- const options: { path?: string; limit?: number } = {};
22
- if (filePath !== undefined) options.path = filePath;
23
- if (limit !== undefined) options.limit = limit;
24
- const entries = await structuralLogFromGraph(warp, options);
25
-
26
- ctx.recordFootprint({
27
- symbols: entries.flatMap((e) => [
28
- ...e.symbols.added.map((s) => s.name),
29
- ...e.symbols.removed.map((s) => s.name),
30
- ...e.symbols.changed.map((s) => s.name),
31
- ]),
32
- });
33
-
34
- return ctx.respond("graft_log", toJsonObject({
35
- entries,
36
- count: entries.length,
37
- layer: "commit_worldline",
38
- }));
39
- };
40
- },
41
- };
@@ -1,63 +0,0 @@
1
- import { z } from "zod";
2
- import { structuralReview, type ReferenceCountResult } from "../../operations/structural-review.js";
3
- import { toJsonObject } from "../../operations/result-dto.js";
4
- import type { ToolContext, ToolDefinition, ToolHandler } from "../context.js";
5
- import { countSymbolReferencesFromGraph } from "../../warp/warp-reference-count.js";
6
- import { nodePathOps } from "../../adapters/node-paths.js";
7
- import { countNamedImportReferencesAtRef } from "../../operations/import-reference-impact.js";
8
-
9
- async function countReviewReferences(
10
- ctx: ToolContext,
11
- symbolName: string,
12
- filePath: string,
13
- headRef: string,
14
- ): Promise<ReferenceCountResult> {
15
- const warpCtx = await ctx.getWarp();
16
- const graphResult = await countSymbolReferencesFromGraph(warpCtx, symbolName, filePath);
17
- if (graphResult.referenceCount > 0) {
18
- return graphResult;
19
- }
20
-
21
- try {
22
- const fallbackResult = await countNamedImportReferencesAtRef({
23
- cwd: ctx.projectRoot,
24
- git: ctx.git,
25
- pathOps: nodePathOps,
26
- symbolName,
27
- filePath,
28
- ref: headRef,
29
- });
30
- return fallbackResult.referenceCount > 0 ? fallbackResult : graphResult;
31
- } catch {
32
- return graphResult;
33
- }
34
- }
35
-
36
- export const structuralReviewTool: ToolDefinition = {
37
- name: "graft_review",
38
- description:
39
- "Zero-noise structural PR review. Categorizes changed files as " +
40
- "structural, formatting, test, docs, or config. Detects breaking " +
41
- "changes (removed exports, changed signatures) with impact counts.",
42
- schema: { base: z.string().optional(), head: z.string().optional() },
43
- createHandler(): ToolHandler {
44
- return async (args, ctx) => {
45
- const head = args["head"] as string | undefined;
46
- const result = await structuralReview({
47
- cwd: ctx.projectRoot,
48
- fs: ctx.fs,
49
- git: ctx.git,
50
- resolveWorkingTreePath: (filePath) => ctx.resolvePath(filePath),
51
- base: args["base"] as string | undefined,
52
- head,
53
- countReferences: async (symbolName, filePath) => {
54
- return countReviewReferences(ctx, symbolName, filePath, head ?? "HEAD");
55
- },
56
- });
57
- ctx.recordFootprint({
58
- paths: result.files.map((f) => f.path),
59
- });
60
- return ctx.respond("graft_review", toJsonObject(result));
61
- };
62
- },
63
- };
@@ -1,14 +0,0 @@
1
- import type { ToolDefinition, ToolHandler } from "../context.js";
2
-
3
- export const workspaceAuthorizationsTool: ToolDefinition = {
4
- name: "workspace_authorizations",
5
- description:
6
- "List daemon-authorized workspaces, their capability posture, and active bound-session counts.",
7
- createHandler(): ToolHandler {
8
- return async (_args, ctx) => {
9
- return ctx.respond("workspace_authorizations", {
10
- workspaces: await ctx.listWorkspaceAuthorizations(),
11
- });
12
- };
13
- },
14
- };
@@ -1,20 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const workspaceAuthorizeTool: ToolDefinition = {
5
- name: "workspace_authorize",
6
- description:
7
- "Authorize a workspace for daemon binding and optionally change its daemon capability posture.",
8
- schema: {
9
- cwd: z.string(),
10
- runCapture: z.boolean().optional(),
11
- },
12
- createHandler(): ToolHandler {
13
- return async (args, ctx) => {
14
- return ctx.respond("workspace_authorize", { ...await ctx.authorizeWorkspace({
15
- cwd: args["cwd"] as string,
16
- runCapture: args["runCapture"] as boolean | undefined,
17
- }) });
18
- };
19
- },
20
- };