@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,25 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const workspaceBindTool: ToolDefinition = {
5
- name: "workspace_bind",
6
- description:
7
- "Bind the current daemon session to a workspace by resolving repo and worktree identity server-side.",
8
- schema: {
9
- cwd: z.string(),
10
- worktreeRoot: z.string().optional(),
11
- gitCommonDir: z.string().optional(),
12
- repoId: z.string().optional(),
13
- },
14
- createHandler(): ToolHandler {
15
- return async (args, ctx) => {
16
- const result = await ctx.bindWorkspace({
17
- cwd: args["cwd"] as string,
18
- worktreeRoot: args["worktreeRoot"] as string | undefined,
19
- gitCommonDir: args["gitCommonDir"] as string | undefined,
20
- repoId: args["repoId"] as string | undefined,
21
- }, "workspace_bind");
22
- return ctx.respond("workspace_bind", { ...result });
23
- };
24
- },
25
- };
@@ -1,25 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const workspaceRebindTool: ToolDefinition = {
5
- name: "workspace_rebind",
6
- description:
7
- "Rebind the current daemon session to a different workspace and start a fresh session-local slice.",
8
- schema: {
9
- cwd: z.string(),
10
- worktreeRoot: z.string().optional(),
11
- gitCommonDir: z.string().optional(),
12
- repoId: z.string().optional(),
13
- },
14
- createHandler(): ToolHandler {
15
- return async (args, ctx) => {
16
- const result = await ctx.rebindWorkspace({
17
- cwd: args["cwd"] as string,
18
- worktreeRoot: args["worktreeRoot"] as string | undefined,
19
- gitCommonDir: args["gitCommonDir"] as string | undefined,
20
- repoId: args["repoId"] as string | undefined,
21
- }, "workspace_rebind");
22
- return ctx.respond("workspace_rebind", { ...result });
23
- };
24
- },
25
- };
@@ -1,18 +0,0 @@
1
- import { z } from "zod";
2
- import type { ToolDefinition, ToolHandler } from "../context.js";
3
-
4
- export const workspaceRevokeTool: ToolDefinition = {
5
- name: "workspace_revoke",
6
- description:
7
- "Revoke daemon authorization for a workspace while leaving any already-open sessions visible to the control plane.",
8
- schema: {
9
- cwd: z.string(),
10
- },
11
- createHandler(): ToolHandler {
12
- return async (args, ctx) => {
13
- return ctx.respond("workspace_revoke", { ...await ctx.revokeWorkspace({
14
- cwd: args["cwd"] as string,
15
- }) });
16
- };
17
- },
18
- };
@@ -1,12 +0,0 @@
1
- import type { ToolDefinition, ToolHandler } from "../context.js";
2
-
3
- export const workspaceStatusTool: ToolDefinition = {
4
- name: "workspace_status",
5
- description:
6
- "Return the current daemon workspace binding state and resolved capability profile.",
7
- createHandler(): ToolHandler {
8
- return (_args, ctx) => {
9
- return ctx.respond("workspace_status", { ...ctx.getWorkspaceStatus() });
10
- };
11
- },
12
- };
@@ -1,36 +0,0 @@
1
- import type WarpApp from "@git-stunts/git-warp";
2
- import { DEFAULT_WARP_WRITER_ID } from "../warp/writer-id.js";
3
-
4
- export interface WarpPool {
5
- getOrOpen(repoId: string, worktreeRoot: string, writerId?: string): Promise<WarpApp>;
6
- size(): number;
7
- }
8
-
9
- export class InMemoryWarpPool implements WarpPool {
10
- private readonly opened = new Map<string, Map<string, Promise<WarpApp>>>();
11
-
12
- constructor(private readonly openWarp: (worktreeRoot: string, writerId: string) => Promise<WarpApp>) {}
13
-
14
- getOrOpen(repoId: string, worktreeRoot: string, writerId: string = DEFAULT_WARP_WRITER_ID): Promise<WarpApp> {
15
- const repoHandles = this.opened.get(repoId);
16
- const cached = repoHandles?.get(writerId);
17
- if (cached !== undefined) return cached;
18
-
19
- const nextRepoHandles = repoHandles ?? new Map<string, Promise<WarpApp>>();
20
- const opened = this.openWarp(worktreeRoot, writerId).catch((error: unknown) => {
21
- const current = this.opened.get(repoId);
22
- current?.delete(writerId);
23
- if (current?.size === 0) {
24
- this.opened.delete(repoId);
25
- }
26
- throw error;
27
- });
28
- nextRepoHandles.set(writerId, opened);
29
- this.opened.set(repoId, nextRepoHandles);
30
- return opened;
31
- }
32
-
33
- size(): number {
34
- return this.opened.size;
35
- }
36
- }
@@ -1,48 +0,0 @@
1
- import { z } from "zod";
2
- import type { JsonObject } from "../contracts/json-object.js";
3
-
4
- export const attributedReadArgsSchema = z.object({
5
- path: z.string(),
6
- }).catchall(z.unknown());
7
-
8
- const safeReadObservationResultSchema = z.object({
9
- projection: z.enum(["content", "outline", "cache_hit", "diff"]),
10
- reason: z.string().optional(),
11
- }).catchall(z.unknown());
12
-
13
- const fileOutlineObservationResultSchema = z.object({
14
- reason: z.string().optional(),
15
- error: z.string().optional(),
16
- }).catchall(z.unknown());
17
-
18
- const readRangeObservationResultSchema = z.object({
19
- content: z.string(),
20
- startLine: z.number().int(),
21
- endLine: z.number().int(),
22
- reason: z.string().optional(),
23
- }).catchall(z.unknown());
24
-
25
- export type AttributedReadArgs = z.infer<typeof attributedReadArgsSchema>;
26
- export type SafeReadObservationResult = z.infer<typeof safeReadObservationResultSchema>;
27
- export type FileOutlineObservationResult = z.infer<typeof fileOutlineObservationResultSchema>;
28
- export type ReadRangeObservationResult = z.infer<typeof readRangeObservationResultSchema>;
29
-
30
- export function parseAttributedReadArgs(args: JsonObject): AttributedReadArgs | null {
31
- const parsed = attributedReadArgsSchema.safeParse(args);
32
- return parsed.success ? parsed.data : null;
33
- }
34
-
35
- export function parseSafeReadObservationResult(result: JsonObject): SafeReadObservationResult | null {
36
- const parsed = safeReadObservationResultSchema.safeParse(result);
37
- return parsed.success ? parsed.data : null;
38
- }
39
-
40
- export function parseFileOutlineObservationResult(result: JsonObject): FileOutlineObservationResult | null {
41
- const parsed = fileOutlineObservationResultSchema.safeParse(result);
42
- return parsed.success ? parsed.data : null;
43
- }
44
-
45
- export function parseReadRangeObservationResult(result: JsonObject): ReadRangeObservationResult | null {
46
- const parsed = readRangeObservationResultSchema.safeParse(result);
47
- return parsed.success ? parsed.data : null;
48
- }
@@ -1,103 +0,0 @@
1
- import * as path from "node:path";
2
- import type { JsonObject } from "../contracts/json-object.js";
3
- import type { WorkspaceExecutionContext } from "./workspace-router-model.js";
4
- import {
5
- parseAttributedReadArgs,
6
- parseFileOutlineObservationResult,
7
- parseReadRangeObservationResult,
8
- parseSafeReadObservationResult,
9
- } from "./workspace-read-observation-model.js";
10
-
11
- export type AttributedReadToolName = "safe_read" | "file_outline" | "read_range";
12
-
13
- export function buildWorkspaceReadObservation(
14
- execution: WorkspaceExecutionContext,
15
- toolName: AttributedReadToolName,
16
- args: JsonObject,
17
- result: JsonObject,
18
- ): {
19
- readonly surface: string;
20
- readonly projection: string;
21
- readonly sourceLayer: "canonical_structural_truth" | "workspace_overlay";
22
- readonly reason: string;
23
- readonly footprint: {
24
- readonly paths: string[];
25
- readonly symbols: string[];
26
- readonly regions: {
27
- readonly path: string;
28
- readonly startLine: number;
29
- readonly endLine: number;
30
- }[];
31
- };
32
- } | null {
33
- const parsedArgs = parseAttributedReadArgs(args);
34
- if (parsedArgs === null) {
35
- return null;
36
- }
37
-
38
- const absolutePath = execution.resolvePath(parsedArgs.path);
39
- const relativePath = path.relative(execution.worktreeRoot, absolutePath);
40
- const footprintPath = relativePath.startsWith("..") ? absolutePath : relativePath;
41
- const sourceLayer = execution.repoState.getState().workspaceOverlayId === null
42
- ? "canonical_structural_truth"
43
- : "workspace_overlay";
44
-
45
- if (toolName === "safe_read") {
46
- const parsedResult = parseSafeReadObservationResult(result);
47
- if (parsedResult === null) {
48
- return null;
49
- }
50
- return {
51
- surface: "safe_read",
52
- projection: parsedResult.projection,
53
- sourceLayer,
54
- reason: parsedResult.reason ?? "SAFE_READ",
55
- footprint: {
56
- paths: [footprintPath],
57
- symbols: [],
58
- regions: [],
59
- },
60
- };
61
- }
62
-
63
- if (toolName === "file_outline") {
64
- const parsedResult = parseFileOutlineObservationResult(result);
65
- if (parsedResult === null) {
66
- return null;
67
- }
68
- if (typeof parsedResult.error === "string" || parsedResult.reason === "UNSUPPORTED_LANGUAGE") {
69
- return null;
70
- }
71
- return {
72
- surface: "file_outline",
73
- projection: "outline",
74
- sourceLayer,
75
- reason: parsedResult.reason ?? "FILE_OUTLINE",
76
- footprint: {
77
- paths: [footprintPath],
78
- symbols: [],
79
- regions: [],
80
- },
81
- };
82
- }
83
-
84
- const parsedResult = parseReadRangeObservationResult(result);
85
- if (parsedResult === null) {
86
- return null;
87
- }
88
- return {
89
- surface: "read_range",
90
- projection: "content",
91
- sourceLayer,
92
- reason: parsedResult.reason ?? "READ_RANGE",
93
- footprint: {
94
- paths: [footprintPath],
95
- symbols: [],
96
- regions: [{
97
- path: footprintPath,
98
- startLine: parsedResult.startLine,
99
- endLine: parsedResult.endLine,
100
- }],
101
- },
102
- };
103
- }
@@ -1,32 +0,0 @@
1
- // ---------------------------------------------------------------------------
2
- // workspace-router-capability — capability profile resolution for binding
3
- //
4
- // Determines which capability profile applies when a workspace is bound,
5
- // whether in repo_local mode (always the local profile) or daemon mode
6
- // (delegated to the authorization policy).
7
- // ---------------------------------------------------------------------------
8
- import {
9
- DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE,
10
- type ResolvedWorkspace,
11
- type WorkspaceAuthorizationPolicy,
12
- type WorkspaceCapabilityProfile,
13
- type WorkspaceMode,
14
- } from "./workspace-router-model.js";
15
-
16
- /**
17
- * Resolve the capability profile for a workspace binding attempt.
18
- *
19
- * In `repo_local` mode the default local profile is always returned.
20
- * In `daemon` mode the authorization policy is consulted; `null` means
21
- * the workspace is not authorized.
22
- */
23
- export async function resolveCapabilityProfile(input: {
24
- readonly mode: WorkspaceMode;
25
- readonly resolved: ResolvedWorkspace;
26
- readonly authorizationPolicy?: WorkspaceAuthorizationPolicy | undefined;
27
- }): Promise<WorkspaceCapabilityProfile | null> {
28
- if (input.mode === "repo_local") {
29
- return DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE;
30
- }
31
- return (await input.authorizationPolicy?.getCapabilityProfile(input.resolved)) ?? null;
32
- }
@@ -1,233 +0,0 @@
1
- // ---------------------------------------------------------------------------
2
- // workspace-router-history — persisted local history query operations
3
- //
4
- // Pure functions that query and observe persisted local history state.
5
- // Extracted from WorkspaceRouter to separate history concerns from
6
- // workspace lifecycle orchestration.
7
- // ---------------------------------------------------------------------------
8
- import { buildRuntimeStagedTarget } from "./runtime-staged-target.js";
9
- import {
10
- buildWorkspaceReadObservation,
11
- type AttributedReadToolName,
12
- } from "./workspace-read-observation.js";
13
- import type {
14
- PersistedLocalActivityWindow,
15
- PersistedLocalHistoryStore,
16
- RepoConcurrencySummary,
17
- PersistedLocalHistorySummary,
18
- PersistedLocalHistoryContext,
19
- } from "./persisted-local-history.js";
20
- import type { PersistedLocalHistoryGraphContext } from "./persisted-local-history-graph.js";
21
- import type { RepoObservation } from "./repo-state.js";
22
- import type { RuntimeCausalContext } from "./runtime-causal-context.js";
23
- import type {
24
- WorkspaceExecutionContext,
25
- WorkspaceStatus,
26
- } from "./workspace-router-model.js";
27
- import type { JsonObject } from "../contracts/json-object.js";
28
- import type { BoundWorkspace } from "./workspace-router-runtime.js";
29
-
30
- // ---------------------------------------------------------------------------
31
- // Unbound fallback — returned when no workspace is bound
32
- // ---------------------------------------------------------------------------
33
-
34
- export const UNBOUND_PERSISTED_LOCAL_HISTORY_SUMMARY: PersistedLocalHistorySummary = Object.freeze({
35
- availability: "none",
36
- persistence: "persisted_local_history",
37
- historyPath: null,
38
- totalContinuityRecords: 0,
39
- active: false,
40
- lastOperation: null,
41
- lastObservedAt: null,
42
- continuityKey: null,
43
- causalSessionId: null,
44
- strandId: null,
45
- checkoutEpochId: null,
46
- continuedFromCausalSessionId: null,
47
- continuityConfidence: "unknown",
48
- continuityEvidence: [],
49
- attribution: Object.freeze({
50
- actor: Object.freeze({
51
- actorId: "unknown",
52
- actorKind: "unknown",
53
- displayName: "Unknown",
54
- source: "persisted_local_history.fallback",
55
- authorityScope: "inferred",
56
- }),
57
- confidence: "unknown",
58
- basis: "unknown_fallback",
59
- evidence: [],
60
- }),
61
- latestReadEvent: null,
62
- latestStageEvent: null,
63
- latestTransitionEvent: null,
64
- preserves: Object.freeze([
65
- "continuity_operations",
66
- "read_events",
67
- "stage_events",
68
- "transition_events",
69
- "runtime_context_ids",
70
- "workspace_overlay_snapshots",
71
- ]),
72
- excludes: Object.freeze([
73
- "raw_chat_transcripts",
74
- "queue_bookkeeping",
75
- "canonical_provenance",
76
- "canonical_structural_truth",
77
- ]),
78
- nextAction: "bind_workspace_to_begin_local_history",
79
- } as PersistedLocalHistorySummary);
80
-
81
- export const UNBOUND_PERSISTED_LOCAL_ACTIVITY_WINDOW = Object.freeze({
82
- historyPath: null,
83
- totalMatchingItems: 0,
84
- truncated: false,
85
- items: Object.freeze([]),
86
- });
87
-
88
- // ---------------------------------------------------------------------------
89
- // History query functions
90
- // ---------------------------------------------------------------------------
91
-
92
- /**
93
- * Retrieve the persisted local history summary for a bound workspace,
94
- * including side-effect observations for semantic transitions and staged targets.
95
- */
96
- export async function queryPersistedLocalHistorySummary(input: {
97
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
98
- readonly binding: BoundWorkspace;
99
- readonly status: WorkspaceStatus;
100
- readonly buildCausalContext: (
101
- binding: BoundWorkspace,
102
- observation: { readonly checkoutEpoch: number },
103
- ) => RuntimeCausalContext;
104
- readonly buildHistoryContext: (
105
- binding: BoundWorkspace,
106
- observation: RepoObservation,
107
- ) => PersistedLocalHistoryContext;
108
- readonly buildGraphContext: (
109
- binding: BoundWorkspace,
110
- ) => Promise<PersistedLocalHistoryGraphContext | null>;
111
- }): Promise<PersistedLocalHistorySummary> {
112
- const { persistedLocalHistory, binding, status, buildCausalContext, buildHistoryContext, buildGraphContext } = input;
113
- const repoState = binding.slice.repoState;
114
- if (repoState === null) {
115
- return UNBOUND_PERSISTED_LOCAL_HISTORY_SUMMARY;
116
- }
117
- const observation = repoState.getState();
118
- const causalContext = buildCausalContext(binding, observation);
119
- const graph = await buildGraphContext(binding);
120
- let summary = await persistedLocalHistory.summarize(status, causalContext, graph);
121
-
122
- if (observation.semanticTransition !== null) {
123
- await persistedLocalHistory.noteSemanticTransitionObservation({
124
- current: buildHistoryContext(binding, observation),
125
- semanticTransition: observation.semanticTransition,
126
- transition: observation.lastTransition,
127
- attribution: summary.attribution,
128
- graph,
129
- });
130
- summary = await persistedLocalHistory.summarize(status, causalContext, graph);
131
- }
132
-
133
- const stagedTarget = buildRuntimeStagedTarget(status, causalContext, observation, summary.attribution);
134
-
135
- if (stagedTarget.availability === "full_file") {
136
- await persistedLocalHistory.noteStageObservation({
137
- current: buildHistoryContext(binding, observation),
138
- stagedTarget,
139
- attribution: summary.attribution,
140
- graph,
141
- });
142
- return persistedLocalHistory.summarize(status, causalContext, graph);
143
- }
144
-
145
- return summary;
146
- }
147
-
148
- /**
149
- * Retrieve the repo concurrency summary for a bound workspace.
150
- */
151
- export async function queryRepoConcurrencySummary(input: {
152
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
153
- readonly status: WorkspaceStatus;
154
- readonly buildGraphContext: (
155
- binding: BoundWorkspace,
156
- ) => Promise<PersistedLocalHistoryGraphContext | null>;
157
- readonly binding: BoundWorkspace;
158
- }): Promise<RepoConcurrencySummary | null> {
159
- return input.persistedLocalHistory.summarizeRepoConcurrency(
160
- input.status,
161
- await input.buildGraphContext(input.binding),
162
- );
163
- }
164
-
165
- /**
166
- * Retrieve the persisted local activity window for a bound workspace.
167
- */
168
- export async function queryPersistedLocalActivityWindow(input: {
169
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
170
- readonly binding: BoundWorkspace;
171
- readonly status: WorkspaceStatus;
172
- readonly limit: number;
173
- readonly buildCausalContext: (
174
- binding: BoundWorkspace,
175
- observation: { readonly checkoutEpoch: number },
176
- ) => RuntimeCausalContext;
177
- readonly buildGraphContext: (
178
- binding: BoundWorkspace,
179
- ) => Promise<PersistedLocalHistoryGraphContext | null>;
180
- readonly refreshSummary: () => Promise<void>;
181
- }): Promise<PersistedLocalActivityWindow> {
182
- const { persistedLocalHistory, binding, status, limit, buildCausalContext, buildGraphContext, refreshSummary } = input;
183
- const repoState = binding.slice.repoState;
184
- if (repoState === null) {
185
- return { ...UNBOUND_PERSISTED_LOCAL_ACTIVITY_WINDOW, limit } as PersistedLocalActivityWindow;
186
- }
187
- await refreshSummary();
188
- const observation = repoState.getState();
189
- const causalContext = buildCausalContext(binding, observation);
190
- const graph = await buildGraphContext(binding);
191
- return persistedLocalHistory.listRecentActivity(status, causalContext, limit, graph);
192
- }
193
-
194
- /**
195
- * Record a read observation against persisted local history.
196
- */
197
- export async function noteReadObservation(input: {
198
- readonly persistedLocalHistory: PersistedLocalHistoryStore;
199
- readonly execution: WorkspaceExecutionContext;
200
- readonly toolName: AttributedReadToolName;
201
- readonly args: JsonObject;
202
- readonly result: JsonObject;
203
- readonly buildHistoryContextFromExecution: (
204
- execution: WorkspaceExecutionContext,
205
- observation: RepoObservation,
206
- ) => PersistedLocalHistoryContext;
207
- readonly buildGraphContextFromExecution: (
208
- execution: WorkspaceExecutionContext,
209
- ) => Promise<PersistedLocalHistoryGraphContext | null>;
210
- }): Promise<void> {
211
- const {
212
- persistedLocalHistory, execution, toolName, args, result,
213
- buildHistoryContextFromExecution, buildGraphContextFromExecution,
214
- } = input;
215
-
216
- const readObservation = buildWorkspaceReadObservation(execution, toolName, args, result);
217
- if (readObservation === null) {
218
- return;
219
- }
220
-
221
- const summary = await persistedLocalHistory.summarize(
222
- execution.status,
223
- execution.getCausalContext(),
224
- await buildGraphContextFromExecution(execution),
225
- );
226
-
227
- await persistedLocalHistory.noteReadObservation({
228
- current: buildHistoryContextFromExecution(execution, execution.repoState.getState()),
229
- attribution: summary.attribution,
230
- graph: await buildGraphContextFromExecution(execution),
231
- ...readObservation,
232
- });
233
- }
@@ -1,131 +0,0 @@
1
- import type { ObservationCache } from "./cache.js";
2
- import type { Metrics } from "./metrics.js";
3
- import type { RepoStateTracker } from "./repo-state.js";
4
- import type { RuntimeCausalContext } from "./runtime-causal-context.js";
5
- import type { PersistedLocalHistorySummary } from "./persisted-local-history.js";
6
- import type { GovernorTracker } from "../session/tracker.js";
7
- import type { WarpContext } from "../warp/context.js";
8
-
9
- export type WorkspaceMode = "repo_local" | "daemon";
10
- export type WorkspaceBindState = "bound" | "unbound";
11
- export type WorkspaceBindAction = "bind" | "rebind";
12
-
13
- export interface WorkspaceCapabilityProfile {
14
- readonly boundedReads: boolean;
15
- readonly structuralTools: boolean;
16
- readonly precisionTools: boolean;
17
- readonly stateBookmarks: boolean;
18
- readonly runtimeLogs: "session_local_only";
19
- readonly runCapture: boolean;
20
- }
21
-
22
- export interface WorkspaceStatus {
23
- readonly sessionMode: WorkspaceMode;
24
- readonly bindState: WorkspaceBindState;
25
- readonly repoId: string | null;
26
- readonly worktreeId: string | null;
27
- readonly worktreeRoot: string | null;
28
- readonly gitCommonDir: string | null;
29
- readonly graftDir: string | null;
30
- readonly capabilityProfile: WorkspaceCapabilityProfile | null;
31
- }
32
-
33
- export interface WorkspaceActionResult extends WorkspaceStatus {
34
- readonly ok: boolean;
35
- readonly action: WorkspaceBindAction;
36
- readonly freshSessionSlice: boolean;
37
- readonly errorCode?: string;
38
- readonly error?: string;
39
- }
40
-
41
- export interface CausalAttachResult extends WorkspaceStatus {
42
- readonly ok: boolean;
43
- readonly action: "attach";
44
- readonly persistedLocalHistory: PersistedLocalHistorySummary;
45
- readonly errorCode?: string;
46
- readonly error?: string;
47
- }
48
-
49
- export interface WorkspaceBindRequest {
50
- readonly cwd: string;
51
- readonly worktreeRoot?: string | undefined;
52
- readonly gitCommonDir?: string | undefined;
53
- readonly repoId?: string | undefined;
54
- }
55
-
56
- export class WorkspaceBindingRequiredError extends Error {
57
- readonly code = "UNBOUND_WORKSPACE";
58
-
59
- constructor(toolName: string) {
60
- super(`Tool ${toolName} requires an active workspace binding. Call workspace_bind first.`);
61
- this.name = "WorkspaceBindingRequiredError";
62
- }
63
- }
64
-
65
- export class WorkspaceCapabilityDeniedError extends Error {
66
- readonly code = "CAPABILITY_DENIED";
67
-
68
- constructor(toolName: string) {
69
- super(`Tool ${toolName} is not enabled in the daemon default capability profile.`);
70
- this.name = "WorkspaceCapabilityDeniedError";
71
- }
72
- }
73
-
74
- export interface WorkspaceExecutionContext {
75
- readonly sliceId: string;
76
- readonly repoId: string;
77
- readonly worktreeId: string;
78
- readonly projectRoot: string;
79
- readonly worktreeRoot: string;
80
- readonly gitCommonDir: string;
81
- readonly graftignorePatterns: readonly string[];
82
- readonly resolvePath: (input: string) => string;
83
- readonly capabilityProfile: WorkspaceCapabilityProfile;
84
- readonly warpWriterId: string;
85
- getCausalContext(): RuntimeCausalContext;
86
- readonly status: WorkspaceStatus;
87
- readonly governor: GovernorTracker;
88
- readonly cache: ObservationCache;
89
- readonly metrics: Metrics;
90
- readonly graftDir: string;
91
- readonly repoState: RepoStateTracker;
92
- readonly getWarp: () => Promise<WarpContext>;
93
- }
94
-
95
- export interface ResolvedWorkspace {
96
- readonly repoId: string;
97
- readonly worktreeId: string;
98
- readonly worktreeRoot: string;
99
- readonly gitCommonDir: string;
100
- }
101
-
102
- export interface WorkspaceAuthorizationPolicy {
103
- getCapabilityProfile(resolved: ResolvedWorkspace): Promise<WorkspaceCapabilityProfile | null>;
104
- noteBound(resolved: ResolvedWorkspace): Promise<void>;
105
- }
106
-
107
- export interface WorkspaceSharedAttachPolicy {
108
- resolveSharedAttachSource(input: {
109
- readonly sessionId: string;
110
- readonly repoId: string;
111
- readonly worktreeId: string;
112
- }): import("./persisted-local-history.js").PersistedLocalHistorySharedAttachSource | null;
113
- }
114
-
115
- export const DEFAULT_DAEMON_CAPABILITY_PROFILE: WorkspaceCapabilityProfile = Object.freeze({
116
- boundedReads: true,
117
- structuralTools: true,
118
- precisionTools: true,
119
- stateBookmarks: true,
120
- runtimeLogs: "session_local_only",
121
- runCapture: false,
122
- });
123
-
124
- export const DEFAULT_REPO_LOCAL_CAPABILITY_PROFILE: WorkspaceCapabilityProfile = Object.freeze({
125
- boundedReads: true,
126
- structuralTools: true,
127
- precisionTools: true,
128
- stateBookmarks: true,
129
- runtimeLogs: "session_local_only",
130
- runCapture: true,
131
- });