@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,158 +0,0 @@
1
- import { getFileAtRef } from "../../git/diff.js";
2
- import { detectLang } from "../../parser/lang.js";
3
- import { extractOutline } from "../../parser/outline.js";
4
- import type { JumpEntry, OutlineEntry } from "../../parser/types.js";
5
- import type { ToolContext } from "../context.js";
6
- import { evaluateMcpRefusal, type McpPolicyRefusal } from "../policy.js";
7
- import type { RankedPrecisionSymbolMatch } from "./precision-query.js";
8
- import { PrecisionSearchRequest } from "./precision-query.js";
9
- import { PrecisionSymbolMatch } from "./precision-match.js";
10
-
11
- const MAX_RANGE_LINES = 250;
12
-
13
- function buildJumpLookup(
14
- jumpTable: readonly JumpEntry[],
15
- ): Map<string, { start: number; end: number }[]> {
16
- const lookup = new Map<string, { start: number; end: number }[]>();
17
- for (const entry of jumpTable) {
18
- const existing = lookup.get(entry.symbol) ?? [];
19
- existing.push({ start: entry.start, end: entry.end });
20
- lookup.set(entry.symbol, existing);
21
- }
22
- return lookup;
23
- }
24
-
25
- export type PrecisionPolicyRefusal = McpPolicyRefusal;
26
-
27
- export function collectSymbols(
28
- entries: readonly OutlineEntry[],
29
- filePath: string,
30
- jumpTable: readonly JumpEntry[],
31
- jumpCursor: Map<string, number> = new Map<string, number>(),
32
- ): PrecisionSymbolMatch[] {
33
- const jumpLookup = buildJumpLookup(jumpTable);
34
- const results: PrecisionSymbolMatch[] = [];
35
-
36
- for (const entry of entries) {
37
- const candidates = jumpLookup.get(entry.name) ?? [];
38
- const jumpIndex = jumpCursor.get(entry.name) ?? 0;
39
- const jump = candidates[jumpIndex];
40
- if (jump !== undefined) {
41
- jumpCursor.set(entry.name, jumpIndex + 1);
42
- }
43
- results.push(new PrecisionSymbolMatch({
44
- name: entry.name,
45
- kind: entry.kind,
46
- path: filePath,
47
- exported: entry.exported,
48
- ...(entry.signature !== undefined ? { signature: entry.signature } : {}),
49
- ...(jump?.start !== undefined ? { startLine: jump.start } : {}),
50
- ...(jump?.end !== undefined ? { endLine: jump.end } : {}),
51
- }));
52
-
53
- if (entry.children !== undefined && entry.children.length > 0) {
54
- results.push(...collectSymbols(entry.children, filePath, jumpTable, jumpCursor));
55
- }
56
- }
57
-
58
- return results;
59
- }
60
-
61
- export async function loadFileContent(
62
- ctx: ToolContext,
63
- filePath: string,
64
- ref?: string,
65
- ): Promise<string | null> {
66
- if (ref !== undefined) {
67
- return getFileAtRef(ref, filePath, { cwd: ctx.projectRoot, git: ctx.git });
68
- }
69
-
70
- try {
71
- return await ctx.fs.readFile(ctx.resolvePath(filePath), "utf-8");
72
- } catch {
73
- return null;
74
- }
75
- }
76
-
77
- export function evaluatePrecisionPolicy(
78
- ctx: ToolContext,
79
- filePath: string,
80
- content: string,
81
- ): PrecisionPolicyRefusal | null {
82
- const actual = {
83
- lines: content.split("\n").length,
84
- bytes: Buffer.byteLength(content),
85
- };
86
- return evaluateMcpRefusal(ctx, filePath, actual);
87
- }
88
-
89
- export async function searchLiveSymbols(
90
- ctx: ToolContext,
91
- filePaths: readonly string[],
92
- request: PrecisionSearchRequest,
93
- ref?: string,
94
- ): Promise<PrecisionSymbolMatch[]> {
95
- const matches: RankedPrecisionSymbolMatch[] = [];
96
-
97
- for (const filePath of filePaths) {
98
- const lang = detectLang(filePath);
99
- if (lang === null) continue;
100
-
101
- const content = await loadFileContent(ctx, filePath, ref);
102
- if (content === null) continue;
103
-
104
- const result = extractOutline(content, lang);
105
- const symbols = collectSymbols(result.entries, filePath, result.jumpTable ?? []);
106
-
107
- for (const symbol of symbols) {
108
- const ranked = request.rank(symbol);
109
- if (ranked !== null) matches.push(ranked);
110
- }
111
- }
112
-
113
- return request.sort(matches);
114
- }
115
-
116
- export function readRangeFromContent(
117
- filePath: string,
118
- content: string,
119
- start: number,
120
- end: number,
121
- ): {
122
- path: string;
123
- content?: string | undefined;
124
- startLine?: number | undefined;
125
- endLine?: number | undefined;
126
- truncated?: boolean | undefined;
127
- clipped?: boolean | undefined;
128
- reason?: string | undefined;
129
- } {
130
- if (start > end) {
131
- return { path: filePath, reason: "INVALID_RANGE" };
132
- }
133
-
134
- const allLines = content.split("\n");
135
- const totalLines = allLines.length;
136
- let effectiveEnd = end;
137
- let truncated = false;
138
- let clipped = false;
139
-
140
- if (effectiveEnd - start + 1 > MAX_RANGE_LINES) {
141
- effectiveEnd = start + MAX_RANGE_LINES - 1;
142
- truncated = true;
143
- }
144
-
145
- if (effectiveEnd > totalLines) {
146
- effectiveEnd = totalLines;
147
- clipped = true;
148
- }
149
-
150
- return {
151
- path: filePath,
152
- content: allLines.slice(start - 1, effectiveEnd).join("\n"),
153
- startLine: start,
154
- endLine: effectiveEnd,
155
- ...(truncated ? { truncated: true, reason: "RANGE_EXCEEDED" } : {}),
156
- ...(clipped ? { clipped: true } : {}),
157
- };
158
- }
@@ -1,54 +0,0 @@
1
- export class PrecisionSymbolMatch {
2
- readonly name: string;
3
- readonly kind: string;
4
- readonly path: string;
5
- readonly identityId?: string;
6
- readonly signature?: string;
7
- readonly exported: boolean;
8
- readonly startLine?: number;
9
- readonly endLine?: number;
10
-
11
- constructor(opts: {
12
- name: string;
13
- kind: string;
14
- path: string;
15
- identityId?: string;
16
- signature?: string;
17
- exported: boolean;
18
- startLine?: number;
19
- endLine?: number;
20
- }) {
21
- if (opts.name.trim().length === 0) {
22
- throw new Error("PrecisionSymbolMatch: name must be non-empty");
23
- }
24
- if (opts.kind.trim().length === 0) {
25
- throw new Error("PrecisionSymbolMatch: kind must be non-empty");
26
- }
27
- if (opts.path.trim().length === 0) {
28
- throw new Error("PrecisionSymbolMatch: path must be non-empty");
29
- }
30
- if (opts.startLine !== undefined && (!Number.isInteger(opts.startLine) || opts.startLine < 1)) {
31
- throw new Error("PrecisionSymbolMatch: startLine must be an integer >= 1");
32
- }
33
- if (opts.endLine !== undefined && (!Number.isInteger(opts.endLine) || opts.endLine < 1)) {
34
- throw new Error("PrecisionSymbolMatch: endLine must be an integer >= 1");
35
- }
36
- if (
37
- opts.startLine !== undefined &&
38
- opts.endLine !== undefined &&
39
- opts.endLine < opts.startLine
40
- ) {
41
- throw new Error("PrecisionSymbolMatch: endLine must be >= startLine");
42
- }
43
-
44
- this.name = opts.name.trim();
45
- this.kind = opts.kind.trim();
46
- this.path = opts.path.trim();
47
- this.exported = opts.exported;
48
- if (opts.identityId !== undefined) this.identityId = opts.identityId;
49
- if (opts.signature !== undefined) this.signature = opts.signature;
50
- if (opts.startLine !== undefined) this.startLine = opts.startLine;
51
- if (opts.endLine !== undefined) this.endLine = opts.endLine;
52
- Object.freeze(this);
53
- }
54
- }
@@ -1,59 +0,0 @@
1
- import * as path from "node:path";
2
- import { GitError } from "../../git/diff.js";
3
- import type { GitClient } from "../../ports/git.js";
4
-
5
- async function git(gitClient: GitClient, args: readonly string[], cwd: string): Promise<string> {
6
- const result = await gitClient.run({ args, cwd });
7
- if (result.error !== undefined || result.status !== 0) {
8
- throw result.error ?? new Error(result.stderr.trim() || `git exited with status ${String(result.status)}`);
9
- }
10
- return result.stdout;
11
- }
12
-
13
- export function normalizeRepoPath(projectRoot: string, input: string): string {
14
- if (!path.isAbsolute(input)) return input;
15
- const rel = path.relative(projectRoot, input);
16
- if (rel === "") return ".";
17
- return rel.startsWith("..") ? input : rel;
18
- }
19
-
20
- export function requireRepoPath(projectRoot: string, input: string): string {
21
- const normalized = normalizeRepoPath(projectRoot, input);
22
- if (path.isAbsolute(normalized)) {
23
- throw new Error(`Path must be inside the repository for git-ref queries: ${input}`);
24
- }
25
- return normalized;
26
- }
27
-
28
- export async function resolveGitRef(ref: string, gitClient: GitClient, cwd: string): Promise<string> {
29
- try {
30
- return (await git(gitClient, ["rev-parse", "--verify", ref], cwd)).trim();
31
- } catch {
32
- throw new GitError(`ref does not exist: ${ref}`);
33
- }
34
- }
35
-
36
- export async function listTrackedFilesAtRef(
37
- dirPath: string,
38
- gitClient: GitClient,
39
- cwd: string,
40
- ref: string,
41
- ): Promise<string[]> {
42
- try {
43
- const args = dirPath.length > 0
44
- ? ["ls-tree", "-r", "--name-only", ref, "--", dirPath]
45
- : ["ls-tree", "-r", "--name-only", ref];
46
- const output = (await git(gitClient, args, cwd)).trim();
47
- return output.length === 0 ? [] : output.split("\n");
48
- } catch {
49
- return [];
50
- }
51
- }
52
-
53
- export async function isWorkingTreeDirty(gitClient: GitClient, cwd: string): Promise<boolean> {
54
- try {
55
- return (await git(gitClient, ["status", "--porcelain"], cwd)).trim().length > 0;
56
- } catch {
57
- return true;
58
- }
59
- }
@@ -1,127 +0,0 @@
1
- import picomatch from "picomatch";
2
- import { PrecisionSymbolMatch } from "./precision-match.js";
3
-
4
- type SymbolQueryMode = "glob" | "plain";
5
-
6
- export class RankedPrecisionSymbolMatch {
7
- readonly match: PrecisionSymbolMatch;
8
- readonly score: number;
9
-
10
- constructor(opts: {
11
- match: PrecisionSymbolMatch;
12
- score: number;
13
- }) {
14
- if (opts.score < 0) {
15
- throw new Error("RankedPrecisionSymbolMatch: score must be >= 0");
16
- }
17
- this.match = opts.match;
18
- this.score = opts.score;
19
- Object.freeze(this);
20
- }
21
- }
22
-
23
- class PrecisionSymbolQuery {
24
- readonly text: string;
25
- readonly mode: SymbolQueryMode;
26
- readonly #globMatcher?: (name: string) => boolean;
27
-
28
- constructor(query: string) {
29
- const normalizedQuery = query.trim();
30
- if (normalizedQuery.length === 0) {
31
- throw new Error("PrecisionSymbolQuery: query must be non-empty");
32
- }
33
- this.text = normalizedQuery;
34
- if (picomatch.scan(normalizedQuery).isGlob) {
35
- this.mode = "glob";
36
- this.#globMatcher = picomatch(normalizedQuery, { nocase: true });
37
- } else {
38
- this.mode = "plain";
39
- }
40
- Object.freeze(this);
41
- }
42
-
43
- score(name: string): number | null {
44
- if (this.mode === "glob") {
45
- return this.#globMatcher?.(name) === true ? 0 : null;
46
- }
47
-
48
- const loweredName = name.toLowerCase();
49
- const loweredQuery = this.text.toLowerCase();
50
- if (name === this.text) return 0;
51
- if (loweredName === loweredQuery) return 1;
52
- if (name.startsWith(this.text)) return 2;
53
- if (loweredName.startsWith(loweredQuery)) return 3;
54
- return loweredName.includes(loweredQuery) ? 4 : null;
55
- }
56
- }
57
-
58
- export class PrecisionSearchRequest {
59
- readonly exactName?: string;
60
- readonly query?: PrecisionSymbolQuery;
61
- readonly kind?: string;
62
- readonly filePath?: string;
63
- readonly pathPrefix?: string;
64
- readonly ceiling?: number;
65
-
66
- constructor(opts: {
67
- exactName?: string;
68
- query?: string;
69
- kind?: string;
70
- filePath?: string;
71
- pathPrefix?: string;
72
- ceiling?: number;
73
- }) {
74
- const exactName = opts.exactName?.trim();
75
- const query = opts.query?.trim();
76
- const kind = opts.kind?.trim().toLowerCase();
77
- const filePath = opts.filePath?.trim();
78
- const pathPrefix = opts.pathPrefix?.trim();
79
-
80
- if ((exactName?.length ?? 0) === 0 && (query?.length ?? 0) === 0) {
81
- throw new Error("PrecisionSearchRequest: exactName or query is required");
82
- }
83
- if (
84
- opts.ceiling !== undefined &&
85
- (!Number.isInteger(opts.ceiling) || opts.ceiling < 1)
86
- ) {
87
- throw new Error("PrecisionSearchRequest: ceiling must be an integer >= 1");
88
- }
89
-
90
- if (exactName !== undefined && exactName.length > 0) this.exactName = exactName;
91
- if (query !== undefined && query.length > 0) this.query = new PrecisionSymbolQuery(query);
92
- if (kind !== undefined && kind.length > 0) this.kind = kind;
93
- if (filePath !== undefined && filePath.length > 0) this.filePath = filePath;
94
- if (pathPrefix !== undefined && pathPrefix.length > 0) this.pathPrefix = pathPrefix;
95
- if (opts.ceiling !== undefined) this.ceiling = opts.ceiling;
96
- Object.freeze(this);
97
- }
98
-
99
- selectLens(): "file" | "exact" | "all" {
100
- if (this.filePath !== undefined) return "file";
101
- if (this.exactName !== undefined) return "exact";
102
- return "all";
103
- }
104
-
105
- rank(match: PrecisionSymbolMatch): RankedPrecisionSymbolMatch | null {
106
- if (this.exactName !== undefined && match.name !== this.exactName) return null;
107
- if (this.kind !== undefined && match.kind.toLowerCase() !== this.kind) return null;
108
- if (this.filePath !== undefined && match.path !== this.filePath) return null;
109
- if (this.pathPrefix !== undefined && !match.path.startsWith(this.pathPrefix)) return null;
110
- if (this.query === undefined) {
111
- return new RankedPrecisionSymbolMatch({ match, score: 0 });
112
- }
113
- const score = this.query.score(match.name);
114
- return score === null ? null : new RankedPrecisionSymbolMatch({ match, score });
115
- }
116
-
117
- sort(matches: readonly RankedPrecisionSymbolMatch[]): PrecisionSymbolMatch[] {
118
- return [...matches]
119
- .sort((a, b) =>
120
- a.score - b.score ||
121
- (this.query?.mode === "plain" ? a.match.name.length - b.match.name.length : 0) ||
122
- a.match.path.localeCompare(b.match.path) ||
123
- a.match.name.localeCompare(b.match.name)
124
- )
125
- .map((entry) => entry.match);
126
- }
127
- }
@@ -1,86 +0,0 @@
1
- import type { ToolContext } from "../context.js";
2
- import { listProjectFiles } from "./git-files.js";
3
- import {
4
- getIndexedCommitCeilings,
5
- searchWarpSymbols,
6
- } from "./precision-warp.js";
7
- import {
8
- listTrackedFilesAtRef,
9
- requireRepoPath,
10
- resolveGitRef,
11
- } from "./precision-paths.js";
12
- import {
13
- searchLiveSymbols,
14
- } from "./precision-live.js";
15
- import { PrecisionSearchRequest } from "./precision-query.js";
16
- import type { PrecisionSymbolMatch } from "./precision-match.js";
17
-
18
- export interface CodeShowResolution {
19
- readonly layer: "commit_worldline" | "ref_view" | "workspace_overlay";
20
- readonly source: "warp" | "live";
21
- readonly resolvedRef?: string | undefined;
22
- readonly locations: PrecisionSymbolMatch[];
23
- }
24
-
25
- export async function resolveCodeShowLocations(
26
- ctx: ToolContext,
27
- input: {
28
- symbolName: string;
29
- targetPath?: string | undefined;
30
- ref?: string | undefined;
31
- allowWarp: boolean;
32
- },
33
- ): Promise<CodeShowResolution> {
34
- const repoState = ctx.getRepoState();
35
- const layer = input.ref !== undefined
36
- ? "commit_worldline"
37
- : repoState.dirty
38
- ? "workspace_overlay"
39
- : "ref_view";
40
-
41
- let resolvedRef: string | undefined;
42
- if (input.ref !== undefined) {
43
- resolvedRef = await resolveGitRef(input.ref, ctx.git, ctx.projectRoot);
44
- }
45
-
46
- if (resolvedRef !== undefined) {
47
- const repoPath = input.targetPath !== undefined
48
- ? requireRepoPath(ctx.projectRoot, input.targetPath)
49
- : undefined;
50
-
51
- if (input.allowWarp) {
52
- const warp = await ctx.getWarp();
53
- const ceilings = await getIndexedCommitCeilings(warp);
54
- const ceiling = ceilings.get(resolvedRef);
55
- if (ceiling !== undefined) {
56
- const locations = await searchWarpSymbols(warp, new PrecisionSearchRequest({
57
- exactName: input.symbolName,
58
- ...(repoPath !== undefined ? { filePath: repoPath } : {}),
59
- ceiling,
60
- }));
61
- return { layer, source: "warp", resolvedRef, locations };
62
- }
63
- }
64
-
65
- const filePaths = repoPath !== undefined
66
- ? [repoPath]
67
- : await listTrackedFilesAtRef("", ctx.git, ctx.projectRoot, resolvedRef);
68
- const locations = await searchLiveSymbols(
69
- ctx,
70
- filePaths,
71
- new PrecisionSearchRequest({ exactName: input.symbolName }),
72
- resolvedRef,
73
- );
74
- return { layer, source: "live", resolvedRef, locations };
75
- }
76
-
77
- const filePaths = input.targetPath !== undefined
78
- ? [input.targetPath]
79
- : await listProjectFiles("", ctx.projectRoot, ctx.git);
80
- const locations = await searchLiveSymbols(
81
- ctx,
82
- filePaths,
83
- new PrecisionSearchRequest({ exactName: input.symbolName }),
84
- );
85
- return { layer, source: "live", locations };
86
- }
@@ -1,44 +0,0 @@
1
- import type { ToolContext } from "../context.js";
2
- import {
3
- evaluatePrecisionPolicy,
4
- loadFileContent,
5
- type PrecisionPolicyRefusal,
6
- } from "./precision-live.js";
7
- import type { PrecisionSymbolMatch } from "./precision-match.js";
8
-
9
- export interface PrecisionVisibilityResult {
10
- readonly visibleMatches: PrecisionSymbolMatch[];
11
- readonly fileCache: Map<string, string>;
12
- readonly firstRefusal:
13
- | PrecisionPolicyRefusal
14
- | undefined;
15
- }
16
-
17
- export async function filterVisiblePrecisionMatches(
18
- ctx: ToolContext,
19
- matches: readonly PrecisionSymbolMatch[],
20
- ref?: string,
21
- ): Promise<PrecisionVisibilityResult> {
22
- const visibleMatches: PrecisionSymbolMatch[] = [];
23
- const fileCache = new Map<string, string>();
24
- let firstRefusal: PrecisionPolicyRefusal | undefined;
25
-
26
- for (const match of matches) {
27
- let content = fileCache.get(match.path);
28
- if (content === undefined) {
29
- const loaded = await loadFileContent(ctx, match.path, ref);
30
- if (loaded === null) continue;
31
- fileCache.set(match.path, loaded);
32
- content = loaded;
33
- }
34
-
35
- const refusal = evaluatePrecisionPolicy(ctx, match.path, content);
36
- if (refusal !== null) {
37
- firstRefusal ??= refusal;
38
- continue;
39
- }
40
- visibleMatches.push(match);
41
- }
42
-
43
- return { visibleMatches, fileCache, firstRefusal };
44
- }
@@ -1,101 +0,0 @@
1
- import type { QueryResultV1 } from "@git-stunts/git-warp";
2
- import type { WarpContext } from "../../warp/context.js";
3
- import { observeGraph } from "../../warp/context.js";
4
- import { allSymbolsLens, commitsLens, fileSymbolsLens, symbolByNameLens } from "../../warp/observers.js";
5
- import type { RankedPrecisionSymbolMatch } from "./precision-query.js";
6
- import { PrecisionSearchRequest } from "./precision-query.js";
7
- import { PrecisionSymbolMatch } from "./precision-match.js";
8
-
9
- function decodeSymbolPath(nodeId: string): string | null {
10
- if (!nodeId.startsWith("sym:")) return null;
11
- const lastColon = nodeId.lastIndexOf(":");
12
- if (lastColon <= "sym:".length) return null;
13
- return nodeId.slice("sym:".length, lastColon);
14
- }
15
-
16
- function toMatch(
17
- nodeId: string,
18
- props: Record<string, unknown>,
19
- ): PrecisionSymbolMatch | null {
20
- const name = props["name"];
21
- const kind = props["kind"];
22
- const path = decodeSymbolPath(nodeId);
23
- if (typeof name !== "string" || typeof kind !== "string" || path === null) {
24
- return null;
25
- }
26
-
27
- return new PrecisionSymbolMatch({
28
- name,
29
- kind,
30
- path,
31
- ...(typeof props["identityId"] === "string" ? { identityId: props["identityId"] } : {}),
32
- ...(typeof props["signature"] === "string" ? { signature: props["signature"] } : {}),
33
- exported: props["exported"] === true,
34
- ...(typeof props["startLine"] === "number" ? { startLine: props["startLine"] } : {}),
35
- ...(typeof props["endLine"] === "number" ? { endLine: props["endLine"] } : {}),
36
- });
37
- }
38
-
39
- export async function getIndexedCommitCeilings(ctx: WarpContext): Promise<ReadonlyMap<string, number>> {
40
- const ceilings = new Map<string, number>();
41
- const observer = await observeGraph(ctx, commitsLens());
42
-
43
- // Slice-first: use query API instead of getNodes() + per-node getNodeProps()
44
- const result = await observer.query()
45
- .match("commit:*")
46
- .select(["id", "props"])
47
- .run() as QueryResultV1;
48
-
49
- for (const node of result.nodes) {
50
- const props = node.props ?? {};
51
- const sha = typeof props["sha"] === "string" ? props["sha"] : null;
52
- const tick = typeof props["tick"] === "number" ? props["tick"] : null;
53
- if (sha !== null && tick !== null) {
54
- ceilings.set(sha, tick);
55
- }
56
- }
57
-
58
- return ceilings;
59
- }
60
-
61
- export async function searchWarpSymbols(
62
- ctx: WarpContext,
63
- request: PrecisionSearchRequest,
64
- ): Promise<PrecisionSymbolMatch[]> {
65
- const lensMode = request.selectLens();
66
- let lens;
67
- if (lensMode === "file") {
68
- if (request.filePath === undefined) {
69
- throw new Error("PrecisionSearchRequest selected file lens without filePath");
70
- }
71
- lens = fileSymbolsLens(request.filePath);
72
- } else if (lensMode === "exact") {
73
- if (request.exactName === undefined) {
74
- throw new Error("PrecisionSearchRequest selected exact lens without exactName");
75
- }
76
- lens = symbolByNameLens(request.exactName);
77
- } else {
78
- lens = allSymbolsLens();
79
- }
80
-
81
- const observer = await observeGraph(ctx,
82
- lens,
83
- request.ceiling !== undefined ? { source: { kind: "live", ceiling: request.ceiling } } : undefined,
84
- );
85
- // Slice-first: use query API instead of getNodes() + per-node getNodeProps()
86
- const queryResult = await observer.query()
87
- .match("*")
88
- .select(["id", "props"])
89
- .run() as QueryResultV1;
90
-
91
- const matches = queryResult.nodes.map((node) => {
92
- const props = node.props ?? {};
93
- if (node.id === undefined) return null;
94
- const match = toMatch(node.id, props);
95
- if (match === null) return null;
96
- return request.rank(match);
97
- });
98
-
99
- const visibleMatches = matches.filter((match): match is RankedPrecisionSymbolMatch => match !== null);
100
- return request.sort(visibleMatches);
101
- }
@@ -1,21 +0,0 @@
1
- export { PrecisionSearchRequest } from "./precision-query.js";
2
- export { PrecisionSymbolMatch } from "./precision-match.js";
3
- export type { PrecisionPolicyRefusal } from "./precision-live.js";
4
- export {
5
- collectSymbols,
6
- loadFileContent,
7
- evaluatePrecisionPolicy,
8
- searchLiveSymbols,
9
- readRangeFromContent,
10
- } from "./precision-live.js";
11
- export {
12
- normalizeRepoPath,
13
- requireRepoPath,
14
- resolveGitRef,
15
- listTrackedFilesAtRef,
16
- isWorkingTreeDirty,
17
- } from "./precision-paths.js";
18
- export {
19
- getIndexedCommitCeilings,
20
- searchWarpSymbols,
21
- } from "./precision-warp.js";
@@ -1,28 +0,0 @@
1
- import { z } from "zod";
2
- import { readRange } from "../../operations/read-range.js";
3
- import type { ToolDefinition, ToolHandler } from "../context.js";
4
- import { toJsonObject } from "../../operations/result-dto.js";
5
-
6
- export const readRangeTool: ToolDefinition = {
7
- name: "read_range",
8
- description:
9
- "Read a bounded range of lines from a file. Maximum 250 lines. " +
10
- "Use jump table entries from file_outline or safe_read to target " +
11
- "specific symbols.",
12
- schema: { path: z.string(), start: z.number(), end: z.number() },
13
- policyCheck: true,
14
- createHandler(): ToolHandler {
15
- return async (args, ctx) => {
16
- const filePath = ctx.resolvePath(args["path"] as string);
17
- const startLine = args["start"] as number;
18
- const endLine = args["end"] as number;
19
- const result = await readRange(filePath, startLine, endLine, { fs: ctx.fs });
20
- ctx.metrics.recordRead();
21
- ctx.recordFootprint({
22
- paths: [filePath],
23
- regions: [{ path: filePath, startLine, endLine }],
24
- });
25
- return ctx.respond("read_range", toJsonObject(result));
26
- };
27
- },
28
- };